取得 AX Code · 免費文件

深入開發工作流程

檢視每次執行。
決定保留什麼。

AX Code 是一個 agent harness:它將模型連接到專案工具、工作階段紀錄與檢閱流程。真正的價值,在於 agent 修改你的程式碼之後,你仍能檢視、驗證與還原。

一個 bug,一次可檢閱的修改

本導覽使用任務示意。下方的指令描述真實的 AX Code 介面;請將範例工作階段 ID 替換成你自己的。本頁面不會執行任何模型。

01 · 連接模型並設定邊界 +

在儲存庫中開啟 AX Code,使用 /connect 選擇支援的本機執行環境、雲端 API、程式開發 CLI 或私有 GPU 端點。在授予不熟悉的程式碼存取權之前,先設定沙盒與權限。一般工作階段不會自動強制執行你專案的測試套件。

ax-code --sandbox read-only
02 · 先檢視問題,再授權修改 +

請 agent 找出哪裡會接受空白輸入,並指出相關的測試。檢閱它的發現,開啟你打算允許的寫入範圍,然後要求一項聚焦的修正。可重複使用的技能可以提供團隊的調查或檢閱指引。

找出為什麼只含空白的輸入會被接受。在進行修改之前,先顯示相關的程式碼與測試。
03 · 驗證修改並檢視執行過程 +

執行儲存庫檢查並檢視差異。使用工作階段圖譜查看已記錄的步驟與工具呼叫。已記錄的檢查失敗仍然是失敗;agent 的完成訊息並不能證明修補是正確的。

git diff
ax-code graph <session-id>
04 · 比較不同嘗試,或檢視還原點 +

比較兩個工作階段,檢閱執行與風險信號的變化。在選擇還原步驟之前,先列出可用的還原點。還原取決於保留的快照,無法撤銷已傳送的訊息或遠端部署等外部副作用。

ax-code compare <session-a> <session-b>
ax-code rollback <session-id> --list

連接你現有的 CLI

安裝支援的 CLI 並登入,再使用下方的供應商 ID 將它連接至 AX Code。介接器會沿用 CLI 的本機登入狀態與工作階段。

程式開發 CLI供應商 ID本機指令
Claude Codeclaude-codeclaude
Codex CLIcodex-clicodex
Grok Build CLIgrok-build-cligrok
Muse Code CLImuse-climuse

每個 CLI 供應商都沿用該供應商 CLI 自己的登入狀態。請先安裝並登入該 CLI,再使用上表中的供應商 ID 將其連接到 AX Code:

ax-code providers login <provider-id>

使用 AX Code 的技能與儲存庫檢查組織任務,然後檢閱已記錄的工作階段與產生的差異。能力與可見度取決於轉接器與 CLI;僅有整合並不代表更高的開發準確度,也不會讓每個巢狀操作都可見。

CLI 供應商設定與需求 ↗

取得第二個觀點

選擇 Claude Code、Codex CLI、Muse Code CLI 或 Grok Build CLI 作為供應商,再搭配支援的雲端 API、本機模型與私有 GPU 端點。使用 Council 從多個已連接的供應商收集獨立審查意見,或用 Arena 比較候選方案。可用的成員取決於你的連線與模型能力。Council 僅供參考;由你檢閱結果並決定保留哪些成果。

多模型工作流程指南 ↗

你的模型,跑在你的 GPU 基礎設施上

透過 OpenAI 相容端點連接私有 GPU 雲端或你自己的 GPU 伺服器。在 /connect 中選擇 Private GPU cloud → Custom provider,輸入端點 URL 與 API 金鑰,然後選擇一個已探索到的模型。伺服器必須提供模型探索功能,並支援開發任務所需的模型能力。

私有 GPU 連線指南 ↗

WebMCP:讓你的 agent 連接瀏覽器

WebMCP 是一項提議中的網頁標準,讓網站向 agent 提供結構化工具。AX Code 可探索並呼叫這些工具、讀取網頁快照與螢幕截圖、查看主控台訊息與請求中繼資料,以及操作網頁控制項。

了解 WebMCP 與瀏覽器操作

超越單次嘗試

Arena implement 模式在隔離的 Git worktree 中執行候選方案,並以儲存庫檢查評估。通過驗證的候選會排在驗證失敗者之前。由你檢閱證據並選擇保留內容;AX Code 不會自動合併任何勝出方案。

閱讀文件化的執行與 Arena 能力 ↗

編譯器級的精確度:即時 LSP 與程式碼智慧

AX Code 以雙層語意智慧架構取代盲目的程式碼編輯:

即時 Language Server Protocol(LSP)

直接整合 TypeScript、Rust、Go、Python 與 Ruby 的即時語言伺服器。lsp 工具提供定義跳轉、參照查找、呼叫階層(incomingCalls / outgoingCalls)與彙總的編譯器診斷(diagnosticsAggregated)。當 agent 編輯程式碼時,即時的型別檢查與編譯器錯誤會直接回饋到執行迴圈,立即自我修正。

確定性的 SQLite 程式碼圖譜

透過 ax-code index 建立的持久化程式碼圖譜,提供整個儲存庫的結構智慧,而不耗用 LLM 的脈絡視窗。查詢呼叫者與被呼叫者,在修改前計算確切的影響範圍(impact_analyze),掃描非同步競態條件(race_scan),並捕捉資源生命週期洩漏(lifecycle_scan)。

閱讀 LSP 工具文件 ↗

AX Wiki:原生的儲存庫架構知識

大型程式碼庫需要架構根基,而不只是 grep。AX Code 內建原生的儲存庫 wiki 編譯器(@automatosx/ax-wiki),透過 ax-code wiki 存取:

有原始碼依據的文件

將儲存庫架構、模組職責、慣例與資料流程編譯為 ax-wiki/ 下乾淨的 Markdown 知識庫,並直接連結到已驗證的原始碼符號。

增量同步

ax-code wiki update 會比對原始碼雜湊與 wiki 清單,僅重新生成受近期 git 提交影響的頁面,讓文件保持同步,而無需耗費昂貴的完整重建。

受保護的維護者區塊

使用 <!-- AX-WIKI:PROTECTED:START --> 標記保存人類的知識。架構決策、生產環境注意事項與安全不變式都能在自動化更新中保留下來。

為 agent 建立架構根基

編譯精簡的 wiki 卡片(.ax-code/wiki-cards.md),並將知識指標注入 AGENTS.md,確保 agent 在提出修改前先理解模組邊界與限制。

探索 AX Wiki 指南 ↗

模型、harness 與技能

模型

產生回覆與工具使用決策,例如 Qwen 與 DeepSeek 等模型。其速度與品質取決於確切的模型、服務設定與任務。

Agent harness(代理執行框架)

將模型連接到工具並管理執行迴圈。AX Code、Codex、DeepSeek Harness 與 Hermes Agent 都屬於這個類別。DeepSeek Harness 與 DeepSeek 的模型 API 是兩個獨立的專案。

技能

可重複使用的任務指令與可選的輔助資源。技能用於引導 agent,但不會取代執行環境,也不保證輸出正確。AX Code 支援以 SKILL.md 定義的專案技能。

探索 AX Code 技能 ↗

比較 harness,而不只是模型

用同一個任務評估工具邊界、工作階段證據、還原、客製化與驗證。技能或本機模型等共同功能,並不能證明某款工具更勝一籌。

開始使用 ↗