本页译自英文文档。命令、标识符和示例保持原样。运行时 7.24.4 · SDK 2.6.7。 英文原文
为什么选择 AX Code
状态：生效 范围：当前状态 最近审阅：2026-08-25 负责人：AX Code 维护者
大多数编程代理优化的是写代码的那一刻。AX Code 优化的是之后的那一刻：决定是否保留代理产出的东西。
AX Code 优化什么
代理输出生成起来便宜，审阅起来昂贵。当代理跨三个模块触碰二十个文件时，审阅者的问题不是“这一行对不对”，而是“它实际上做了什么，它是否通过，以及如果我需要撤销会发生什么。”
AX Code 围绕这个问题构建：
- 证据。 每个会话都记录为带类型的事件日志 — 路由决定、模型活动、步骤、工具调用、工具结果 — 再加上运行期间拍摄的文件快照。
- 验证。 在门禁可以强制的地方，由你仓库自己的检查来决定。Arena 候选和受门禁的重构应用会在结果被接受之前运行类型检查、代码检查和测试。
- 可逆性。 快照点可以按步骤恢复，而不只是按会话，包括委托给同一工作目录中嵌套会话的变更。
- 你的决定。 AX Code 排名、打分和报告。它不会替你合并。
它面向谁
主要受众：
- 做有后果变更的高级和资深工程师
- 开源和内部平台维护者
- 运维中到大型 Git 仓库的团队
- 评估重构、迁移和跨模块修复的工程师
- 任何运行无人值守或计划代理工作、之后必须由人审计的人
不是主要受众：
- 想要行内自动完成的人
- 做一次快速、可丢弃编辑的用户
- 优先考虑完全托管的云端委托的团队
- 不愿意使用 Git 或运行仓库检查的人
对这些情况，更轻的编辑器助手确实是更好的工具，本页宁愿这样说，也不愿过度推销。
它有何不同
这里不是一份会过时的功能清单，而是每一类优化的是什么：
| 类别 | 优化的是 | AX Code 的不同之处 |
|---|---|---|
| 第一方模型代理 | 一个模型的端到端体验 | AX Code 与模型无关，并把记录留在本地 |
| 编辑器代理 | 交互式的 IDE 内流程 | AX Code 针对的是审阅和审计步骤，不是打字步骤 |
| 轻量终端代理 | 速度和简单 | AX Code 接受更多概念，以换取可检查的记录 |
| 云端代理 | 托管委托和自主 | AX Code 把执行和证据留在你的机器上，Apache-2.0 |
截至 2026 年，AX Code 所发布的若干能力在别处也已广泛可用：沙盒、检查点与恢复、MCP、钩子、技能、子代理、工作树隔离、计划、提供商选择，以及把一个提示跑在多个模型上。其中任何一项单独都不是选择 AX Code 的理由。
在别处更难组装起来的组合是：一份隔离的候选实现，以仓库自己的检查为门禁，按验证优先排名，完整的执行记录留在本地并可导出 — 并且没有自动合并。
我们不声称什么
定位只有在接触产品之后仍然成立才有用。明确地说：
replay重建；它不重新执行。 它重建并验证已记录的事件流。它不会重新运行模型、工具或外部世界。risk是确定性启发式，由搅动、验证状态、工具失败、被触碰的路径和安全敏感文件模式计算而来。它不是概率、校准过的置信度，或安全保证。branch分叉的是会话状态，不是 Git 分支或工作树。Arena 才是 Git 工作树的实现路径。compare比较的是运行，不是源代码。它报告风险、决策路径和事件计数 — 它不是代码差异查看器。- 验证门禁不是普遍的。 它们适用于 arena 候选和受门禁的重构应用。普通的交互式编辑不会被自动验证。
- AX Wiki 的文字是模型生成的，来自被引用的源。围绕它的规划、验证、增量更新和受保护区段框架是确定性的。
- CLI 桥接的可见性是部分的。 AX Code 完整记录自己的工具执行；发生在厂商 CLI 进程内部的工作，只能通过该桥接的输出来看见。
- 有些能力是选择加入的。
workflow运行时需要AX_CODE_WORKFLOW_RUNTIME=1。
出处，说清楚
AX Code 始于 MIT 许可的 OpenCode 代码库。这一点保存在 NOTICE 中，并写在 README 里，而不是被埋起来。
DEFAI 在该基础上构建的内容就是本页的主题：执行证据层、带影子工作树验证的确定性调试与重构引擎、代码智能图和影响分析、council 和 arena 执行模式、AX Wiki 编译器、操作系统级沙盒，以及 AX Code Desktop。
与一个项目集成并不是从它派生。 README 的出处部分和 NOTICE 的存在，是为了承担 Apache-2.0 第 4(d) 节下的许可义务 — 它们只列出 AX Code 实际复制并再分发其代码的上游。AX Code 仅仅与之对话的项目不会列在那里，无论构建桥接时对它们研究得多么仔细。CLI 提供商是最清楚的例子：Claude Code、Codex CLI、Grok Build CLI 和 Muse Code CLI 出现在提供商表中，是因为 AX Code 调用那些本地二进制并复用它们的登录会话，而不是因为它们的任何代码随这里发布。packages/ax-code/src/provider/ 中的模型 ID 模式、能力表和厂商专属解析是 AX Code 自己的互操作逻辑。真正是逐字派生的文件会带一行出处标头，点名上游，以便审计能够区分有意复用和遗漏的清理。