Tokatlas

外觀

English
Agent 快速接入

在 Codex CLI 中接入 Tokatlas ​

設定 Codex CLI 使用的 Tokatlas 金鑰、端點與已開通模型。

開始之前 ​

依官方 CLI 指南安裝，再執行 codex --version。npm 安裝指令：npm install -g @openai/codex。

準備 Tokatlas API Key 與帳戶已開通模型。替換全部 YOUR_... 佔位值，合併設定前先備份既有內容。

連線設定 ​

設定內容
提供方名稱Tokatlas
協定Responses
端點／Base URLhttps://api.tokatlas.ai/v1
API KeyYOUR_TOKATLAS_API_KEY
Model IDYOUR_TOKATLAS_MODEL_ID

設定步驟 ​

  1. 備份並將下方設定合併至使用者層級的 ~/.codex/config.toml（Windows：%USERPROFILE%\.codex\config.toml），替換模型佔位值。
  2. 在啟動終端機設定 TOKATLAS_API_KEY：Bash／Zsh 使用 export TOKATLAS_API_KEY="YOUR_TOKATLAS_API_KEY"；PowerShell 使用 $env:TOKATLAS_API_KEY = "YOUR_TOKATLAS_API_KEY"。
  3. 在專案中執行 codex，用 /status 檢查。切換模型後建立新對話。

設定範例 ​

toml
model = "YOUR_TOKATLAS_MODEL_ID"
model_provider = "tokatlas"
web_search = "disabled"

[model_providers.tokatlas]
name = "Tokatlas"
base_url = "https://api.tokatlas.ai/v1"
wire_api = "responses"
env_key = "TOKATLAS_API_KEY"

相容性說明 ​

頂層設定須放在第一個表格之前，勿重複既有鍵值。模型須支援 Codex 的 Responses 與工具流程；自訂別名可能需要相符的模型目錄。桌面憑證設定請見 Codex 客戶端。

驗證與排錯 ​

  1. 開啟新對話，傳送「只回覆 OK」，確認收到文字回覆。
  2. 到 Tokatlas 用量記錄確認同一時間有成功請求，且模型符合設定。
  3. 需要工具時，再請客戶端列出測試目錄中的檔案；確認工具結果有回到對話。
  4. 若第一步失敗，先依 API 使用入門直接測試金鑰與模型。直接呼叫成功後，再依下表排查客戶端設定。
問題檢查項目
401／403重新貼上 Tokatlas 金鑰，移除引號與空白，核對驗證模式及模型權限。
404對照上表檢查完整 URL，移除重複的 /v1 或端點後綴。
未知模型從可用列表複製完整 ID，儲存後在新對話中選取該模型。
工具失敗模型能力與客戶端協定支援。
變更未生效切換至 Tokatlas 提供方／profile，完全退出客戶端後重新開啟。

參考文件 ​