本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 7.24.4 · SDK 2.6.7。 英文原文

從這裡開始

狀態：有效 範圍：現行狀態 上次審閱：2026-09-16 負責人：ax-code runtime

若根目錄 README 是安裝 AX Code 最快的方式，這一頁就是理解它最快的方式。

版本與可用性

先從 AX Code Standard 開始。這是開放原始碼版本，個人與商業使用皆免費。你可以使用本機或雲端模型；在受支援的 Apple Silicon Mac 上，AX Engine 提供原生本機推論路徑。既有的權限、變更審閱與本機執行證據仍是核心能力。

Business 是規劃中的專有方案，透過 AX Trust 提供組織治理，並透過 AutomatosX 提供商務工作流程。在工作中使用 Standard，本身並不需要 Business 授權。詳情見 Standard 與 Business。

已簽署的安裝程式與執行環境封存可匿名取得，來源是 download.ax-code.com。請閱讀 安裝指南 與 升級與復原指南。公開技術文件託管於 ax-code.app/zh-TW/docs/，與原始碼存取相互獨立。 已經安裝了嗎？在專案中開啟終端機，執行 ax-code，然後在 TUI 內使用 /connect 選擇供應商。先問一個關於專案的問題，再要求一項小變更，並在提交前審閱 diff 與專案檢查。若已安裝的執行環境需要診斷，使用 ax-code doctor。

AX Code 是什麼

AX Code 是一套 AI 程式開發執行環境。它結合：

• 針對不同程式任務的 agents
• 明確的工具執行
• 模型與供應商選擇
• 持久的工作階段狀態
• 可設定的隔離與權限
• 整合介面，例如 TUI、SDK、伺服器模式與 MCP

這很重要，因為在真實儲存庫裡，AI 程式開發只有在你能控制 agent 被允許做的事、跨工作階段保留上下文，並在單一聊天視窗外重用同一套工作流程時，才真正有用。

價值從哪裡來

AX Code 優化的是 agent 完成之後的那一刻：決定是否保留它產出的結果。

• 證據。 每個工作階段都會記錄成具型別的事件日誌，加上檔案快照，因此 ax-code graph、compare、replay、risk 與 audit 能在對話結束後重建發生過的事。
• 驗證。 在閘門可以強制執行的地方——arena 候選、受閘門控制的重構套用——由你儲存庫自己的型別檢查、lint 與測試指令決定結果是否被接受。
• 可逆性。 快照可以逐步復原，不只是整個工作階段，來源是存放在儲存庫之外的 Git 物件庫。
• 由你決定。 AX Code 會排序、評分並回報。它不會替你合併。

支撐這些能力的是：帶有權限規則與隔離模式的明確工具、持久工作階段、用於儲存庫慣例的 AGENTS.md、供應商可攜性，以及 TUI、CLI、VS Code 擴充功能、SDK、無頭伺服器與 MCP 整合背後的同一套執行環境。這些是基礎，而不是選擇 AX Code 的理由——見 為什麼選擇 AX Code。

指令本身見 執行證據。

心智模型

把 AX Code 想成五個層：

1. 供應商層：選擇你要對其執行的模型後端。
2. Agent 層：為任務挑選合適的 agent，或讓路由協助。
3. 工具層：agent 透過明確工具行動，而不是隱藏能力。
4. 工作階段層：對話、決策與狀態會持續保存。
5. 控制層：隔離、權限與稽核行為定義邊界。

其餘文件都對應到這些層。

選擇下一條路徑

我想快速試用

• 從 根目錄 README 開始，取得安裝與首次啟動說明。
• 受支援的安裝路徑使用已編譯的執行環境：
  • 適用於 macOS Apple Silicon 與 Linux 的 Bash 發行安裝程式：curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • macOS CLI 的 Homebrew 替代方案： brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • Windows PowerShell 的 GitHub 發行安裝程式：powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• Bash 安裝程式不是 Windows 的標準安裝路徑。
• npm 套件不再是受支援的安裝或升級通道。平台政策、執行環境標籤與本機啟動器矩陣見 安裝與執行環境通道。
• 使用 /connect 或 ax-code providers login 設定模型。雲端 API 供應商、CLI 供應商、AX Engine 與模型 ID 見 支援的供應商與模型。若要零成本評估路徑，使用 免費方案 API 快速開始。
• 開啟真實專案後執行 ax-code init，讓 AGENTS.md 擷取本機慣例。
• 若你想要更緊的安全邊界，在進行更廣泛的編輯前先啟用 沙盒模式。

我想在團隊或公司儲存庫中安全使用

• AX Code 啟動時自主模式開啟、沙盒模式關閉：full-access，檔案系統與網路存取不受限制。
• 對於團隊、公司、不受信任或無人值守的工作，在開始任務前啟用 --sandbox workspace-write（或 read-only）。
• 執行邊界請閱讀 沙盒模式。
• 若 agent 將無人值守執行，請閱讀 自主模式。
• 威脅模型與憑證儲存細節請閱讀 安全性原則。
• 若你的工作流程需要來源追溯與重播，請閱讀 語意層。

我想嵌入或自動化

• 使用 @defai-digital/ax-code-sdk 的無頭或 gRPC 進入點，整合 TypeScript 應用程式。
• 使用 HTTP 與 OpenAPI 相容性 作為服務邊界、產生用戶端，以及權威的 OpenAPI 契約。
• 當 agent 需要外部工具或服務時，使用 ax-code mcp add。

我想理解儲存庫或提供回饋

• 閱讀 文件中心，查看其餘公開文件。
• 閱讀 CONTRIBUTING.md，了解目前的外部貢獻政策。

AX Code 可能不適合的情況

AX Code 刻意不只是自動完成或託管聊天框。在下列情況它可能過重：

• 你只需要行內程式建議，不想讓 agents 執行工具。
• 你需要純託管 SaaS 體驗，沒有本機執行環境。
• 你不需要工作階段持久化、重播、SDK／伺服器整合，或儲存庫層級的指示。
• 你所在的環境不允許任何本機 CLI 行程。

在這些情況下，較輕量的編輯器助理可能更簡單。當 agent 需要在真實開發工作流程中運作，並具備控制、連續性與整合邊界時，AX Code 最強。

常見的第一批指令

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok 只透過 Grok Build CLI 執行。選擇 grok-build-cli，位置在 /connect；AX Code 會呼叫本機 grok 指令，並重用其 CLI 登入與工作階段。先前的直接 xai 雲端 API 供應商已不再支援。

文件地圖