Agent 快速接入
在 Claude Code CLI 中接入 Tokatlas
設定 Claude Code CLI 使用的 Tokatlas 金鑰、端點與已開通模型。
開始之前
依官方安裝指南安裝 Claude Code,再執行 claude --version。
準備 Tokatlas API Key 與帳戶已開通模型。替換全部 YOUR_... 佔位值,合併設定前先備份既有內容。
連線設定
| 設定 | 內容 |
|---|---|
| 提供方名稱 | Tokatlas |
| 協定 | Messages |
| 端點/Base URL | https://api.tokatlas.ai |
| API Key | YOUR_TOKATLAS_API_KEY |
| Model ID | YOUR_TOKATLAS_MODEL_ID |
設定步驟
- 在專案目錄開啟終端機。設定本次工作階段的變數,替換金鑰與模型佔位值。
- 在同一個終端機執行
claude,傳送簡單請求,再用/status確認閘道與憑證來源。
設定範例
bash
export ANTHROPIC_BASE_URL="https://api.tokatlas.ai"
export ANTHROPIC_API_KEY="YOUR_TOKATLAS_API_KEY"
export ANTHROPIC_MODEL="YOUR_TOKATLAS_CLAUDE_MODEL_ID"
claude相容性說明
以上為 Bash/Zsh 指令;PowerShell 使用 $env:NAME = "value"。Tokatlas Messages 文件採用 x-api-key,因此此處使用 ANTHROPIC_API_KEY。測試前先處理既有 ANTHROPIC_AUTH_TOKEN 的衝突。選擇帳戶已開通的 Claude 模型。終端機變數僅在本次工作階段有效。
驗證與排錯
- 開啟新對話,傳送「只回覆 OK」,確認收到文字回覆。
- 到 Tokatlas 用量記錄確認同一時間有成功請求,且模型符合設定。
- 需要工具時,再請客戶端列出測試目錄中的檔案;確認工具結果有回到對話。
- 若第一步失敗,先依 API 使用入門直接測試金鑰與模型。直接呼叫成功後,再依下表排查客戶端設定。
| 問題 | 檢查項目 |
|---|---|
401/403 | 重新貼上 Tokatlas 金鑰,移除引號與空白,核對驗證模式及模型權限。 |
404 | 對照上表檢查完整 URL,移除重複的 /v1 或端點後綴。 |
| 未知模型 | 從可用列表複製完整 ID,儲存後在新對話中選取該模型。 |
| 工具失敗 | 模型能力與客戶端協定支援。 |
| 變更未生效 | 切換至 Tokatlas 提供方/profile,完全退出客戶端後重新開啟。 |
