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

連接第一個模型提供方

選擇連線方式

提供方是通往模型服務的連線；模型則是透過該連線選用的特定模型。連接提供方不代表選用了所有模型，也不會自動取得帳戶存取權。

在終端機介面輸入 /connect，再選擇下列方式。Desktop 使用自己的提供方設定與內建執行環境；這些斜線指令適用於終端機介面。

雲端 API：選擇 API Cloud Provider，選取服務並依提示提供憑證。聊天訂閱不一定包含 API 存取權或 API 額度。
程式開發 CLI：先安裝支援的 CLI 並登入，再選擇 CLI Provider。AX Code 會沿用該本機登入；可用功能取決於介接器。
本機模型：啟動 Ollama 或 LM Studio，載入支援工具呼叫的模型，再選擇 Local LLM runtime 並確認端點。支援的 Mac 可透過 AX-Engine runtime 使用專屬的設定及模型下載流程。
閘道：AX Trust 端點選擇 AX Trust，其他閘道選擇 API Cloud Provider → Custom API provider，專用相容部署則選擇 Private GPU cloud。輸入服務網址、權杖及服務實際公布的模型 ID。

在互動式終端機執行以下指令。登入指令會提示選擇提供方及輸入憑證；請勿將真實金鑰貼入共用指令或儲存庫檔案。

ax-code providers login
ax-code providers list
ax-code models

應可看到提供方與可用模型 ID。儲存憑證或成功列出模型，本身都不能證明具有推論權限。接著閱讀模型選擇，並送出小型測試請求。

使用 /providers 管理連線，使用 /connect 更換金鑰。停用會保留已存憑證；中斷連線會刪除已存憑證。環境變數及設定中的金鑰仍可能提供存取權。

專案 ax-code.json 適合共用的非機密設定，全域 ~/.config/ax-code/ax-code.json 則適合個人預設值。不要將機密納入版本控制；請使用提供方的憑證提示，或閘道指南中的環境變數參照。手動修改設定後請重新啟動。

驗證失敗：確認金鑰屬於所選服務、端點及 API 方案。程式開發 CLI 請先檢查其本身的登入狀態。
模型清單空白或連線遭拒：確認本機伺服器已啟動、已載入模型，且網址與連接埠正確。Ollama 通常使用 http://localhost:11434/v1；LM Studio 使用 http://localhost:1234/v1。
模型遭拒：使用端點回傳的確切 ID 並檢查帳戶權限。閘道的顯示名稱可能與上游請求 ID 不同。
找不到提供方：檢查 enabled_providers 與 disabled_providers。安裝診斷可執行 ax-code doctor；此指令不會驗證提供方帳戶。