取得 AX Code · 免費文件

文件快照 · CLI 7.30.1 · SDK 2.6.53。Desktop 使用各自發行版隨附的執行環境。指令與範例保留英文原文。 英文原文

選擇與切換模型

尋找可用模型

先連接提供方。在終端機介面輸入 /models,搜尋已連線提供方中的模型並選取。我的最愛與最近使用記錄能幫助你再次找到模型。

選擇器依提供方分組。缺少必要文字輸出或工具呼叫能力的模型可能被隱藏或停用。受管理的本機模型可能在權重下載前就出現;使用前請完成準備。

要取得目前安裝的 CLI 可用的 ID,請執行:

ax-code models
ax-code models --json --verbose

複製完整的 provider/model ID。不同提供方下相同的顯示名稱,可能具有不同的憑證、能力與限制。

為單次執行指定模型

將範例值換成你安裝的版本列出的 ID。第一個指令開啟終端機介面;第二個指令執行一則提示。提示內容應放在 -- 之後。

MODEL='provider/model'
ax-code --model "$MODEL"
ax-code run --model "$MODEL" -- "Explain the project entry point without changing files."

模型家族別名 deepseek、glm 與 qwen 會透過可用連線選擇支援的 Flash 模型。對應目標可能隨版本變更。若要指定特定模型或等級,請使用完整 ID;單獨的型號並非完整 ID。

儲存預設值

將下列欄位合併至現有專案或全域 ax-code.json,替換佔位值,不要覆蓋整份檔案:

{
  "model": "provider/model"
}

修改設定後請重新啟動。未明確指定模型時,既有 agent、工作階段或最近選項都可能影響選擇;送出任務前請確認目前模型。Desktop 維護自己的設定。

依任務選擇

先從小型儲存庫問題開始。修改程式碼時,確認支援工具呼叫並執行專案檢查。使用圖片時,確認支援圖片輸入。長任務應檢查上下文與輸出限制,不要只依模型名稱判斷。

使用相同任務、輸入與驗收檢查比較候選模型。考量延遲、提供方使用條款、資料處理方式與本機記憶體需求。任何模型都無法保證修改正確。

推理強度與自動路由是不同控制項。先使用一個明確指定的模型,再啟用路由。Wiki 產生可使用自己的 wiki.model,不受前景工作階段影響。

模型無法執行時

  • 未列出:確認提供方已連線並啟用,再檢查能力篩選及閘道探索結果。不要從行銷名稱猜測 ID。

  • 未授權或禁止存取:檢查請求中確切的模型 ID,以及帳戶與金鑰的存取權。登入或列出模型成功,不代表有執行權限。

  • 本機準備或記憶體錯誤:完成模型下載及載入,並檢查硬體需求。降低工作量,或選擇支援的較小模型。

後續步驟

提供方與模型參考 · 模型復原 · AX Engine 模型選擇 · Wiki 快速入門 · 文件首頁