本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 7.24.4 · SDK 2.6.7。 英文原文
為什麼選擇 AX Code
狀態：有效 範圍：現行狀態 上次審閱：2026-08-25 負責人：AX Code 維護者
多數程式開發 agent 優化的是寫程式的那一刻。AX Code 優化的是之後的那一刻：決定是否保留 agent 產出的結果。
AX Code 優化的是什麼
Agent 的輸出產生起來便宜，審閱起來昂貴。當一個 agent 在三個模組裡碰了二十個檔案，審閱者的問題不是「這一行對不對」，而是「它實際上做了什麼、有沒有通過，以及如果我需要復原會發生什麼」。
AX Code 就是圍繞這個問題建立的：
- 證據。 每個工作階段都會記錄成具型別的事件日誌——路由決策、模型活動、步驟、工具呼叫、工具結果——再加上執行期間取得的檔案快照。
- 驗證。 在閘門可以強制執行的地方，由你儲存庫自己的檢查決定。Arena 候選與受閘門控制的重構套用，會在結果被接受前執行型別檢查、lint 與測試。
- 可逆性。 快照點可以逐步復原，不只是整個工作階段，包含在同一工作目錄中委派給巢狀工作階段的變更。
- 由你決定。 AX Code 會排序、評分並回報。它不會替你合併。
它適合誰
主要對象：
- 進行影響重大變更的資深與 staff 工程師
- 開放原始碼與內部平台的維護者
- 操作中大型 Git 儲存庫的團隊
- 評估重構、遷移與跨模組修復的工程師
- 任何執行無人值守或排程 agent 工作、之後必須由人稽核的人
不是主要對象：
- 想要行內自動完成的人
- 只做一次快速、可拋棄編輯的使用者
- 優先事項是完全受管理的雲端委派的團隊
- 不願使用 Git 或執行儲存庫檢查的人
對那些情況，較輕量的編輯器助理確實是更好的工具，而這一頁寧可直接說明，也不誇大。
它有何不同
這裡不列一份會過時的功能清單，而是說明每一類在優化什麼：
| 類別 | 優化目標 | AX Code 的差異 |
|---|---|---|
| 第一方模型 agents | 單一模型從頭到尾的體驗 | AX Code 與模型無關，並把紀錄留在本機 |
| 編輯器 agents | 互動式 IDE 內流程 | AX Code 對準審閱與稽核步驟，而不是打字步驟 |
| 輕量終端機 agents | 速度與簡單 | AX Code 接受更多概念，以換取可檢查的紀錄 |
| 雲端 agents | 受管理的委派與自主 | AX Code 把執行與證據留在你的機器上，授權為 Apache-2.0 |
截至 2026 年，AX Code 提供的好幾項能力在別處也已廣泛可得：沙盒、檢查點與還原、MCP、hooks、技能、子 agent、worktree 隔離、排程、供應商選擇，以及把一個提示在多個模型上執行。其中任何一項單獨都不是選擇 AX Code 的理由。
在別處較難組裝起來的組合是：一份隔離的候選實作，以儲存庫自己的檢查為閘門，驗證優先地排序，完整執行紀錄留在本機並可匯出——而且沒有自動合併。
我們不宣稱的事
定位只有在對上產品時仍然成立才有用。明確地說：
replay會重建，不會重新執行。 它重建並驗證已記錄的事件串流。它不會重跑模型、工具或外部世界。risk是確定性的啟發式，由變動幅度、驗證狀態、工具失敗、碰過的路徑，以及安全敏感的檔案模式計算而來。它不是機率、校準過的信心，也不是安全保證。branch分叉的是工作階段狀態，不是 Git 分支或 worktree。Arena 才是 Git worktree 的實作路徑。compare比較的是執行，不是原始碼。它回報風險、決策路徑與事件數量——它不是程式碼差異檢視器。- 驗證閘門並非普遍適用。 它們套用在 arena 候選與受閘門控制的重構套用。一般的互動編輯不會自動驗證。
- AX Wiki 的散文是模型產生的，來源是被引用的資料。圍繞它的規劃、驗證、增量更新與受保護區段框架是確定性的。
- CLI 橋接的可見性是部分的。 AX Code 完整記錄自己的工具執行；發生在供應商 CLI 行程內部的工作，只能透過該橋接的輸出看見。
- 有些能力是選擇加入的。
workflow執行環境需要AX_CODE_WORKFLOW_RUNTIME=1。
來源，明白地說
AX Code 始於 MIT 授權的 OpenCode 程式庫。這一點保存在 NOTICE，並寫在 README 裡，而不是藏起來。
DEFAI 在那個基礎上建立的，就是這一頁的主題：執行證據層、帶有影子 worktree 驗證的確定性除錯與重構引擎、程式智慧圖與影響分析、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 自己的互通邏輯。真正屬於逐字衍生的檔案會帶一行來源標頭，指出上游，讓稽核能分辨刻意重用與遺漏的清理。