Claude Code
Anthropic 官方的終端編碼代理。它使用 Anthropic Messages 協定，因此只要透過兩個環境變數將其指向 Synthorai，你工作空間中的每個 Claude 模型即可使用 —— 你設定中的其他內容均無需變更。
對於希望在終端機中使用 Claude 的團隊來說，這是最受歡迎的整合方式 和 在閘道上集中管理的計費 + 速率限制。
開始之前
在以下位置建立 API key： Console → API Keys. 完整的 key 僅會顯示 一次 —— 請在關閉對話框前複製它。
第 1 步 —— 設定環境變數
Claude Code 會讀取 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 。將它們加入你的 shell 設定檔 (~/.zshrc, ~/.bashrc, 或 ~/.config/fish/config.fish) ，讓每個新終端機都能讀取它們。
# ~/.zshrc (or equivalent)
export ANTHROPIC_BASE_URL="https://synthorai.io"
export ANTHROPIC_API_KEY="sk-..." # your Synthorai key該 base URL 不包含 /v1 — Anthropic SDK 會附加 /v1/messages （內部處理）。如果你貼上了 https://synthorai.io/v1，請求將命中 /v1/v1/messages 並回傳 404。
第 2 步 —— 傳送你的第一個請求
# Reload env, then:
claude --model claude-sonnet-4-6 "explain this diff" < <(git diff HEAD~1)
# Or start an interactive coding session:
claude code --model claude-opus-4-6成功的回應會將模型輸出列印到 stdout。如果你收到 401 ，則表示 key 錯誤或已被停用；如果你收到 404 ，則表示該模型名稱在你的工作空間中無法路由 —— 請檢查 /console/pricing.
推薦模型
| 參數 | 類型 | 說明 |
|---|---|---|
claude-opus-4-6 | reasoning | 旗艦級品質。適用於深度重構和模糊不清的問題。 |
claude-sonnet-4-6 | balanced | 日常編碼和長時間代理工作階段的最佳性價比。 |
claude-haiku-4-5 | fast | 最便宜、最快。適合閒聊式的臨時問題和簡短編輯。 |
疑難排解
401 Unauthorized — 金鑰錯誤、已停用或已被撤銷。請在以下位置重新產生 /console/keys.
404 / "model not found" — 你傳給 --model 的模型不在你工作空間的通道目錄中。執行 curl $ANTHROPIC_BASE_URL/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" 以查看可用的模型。
"仍然命中 api.anthropic.com" — 你的 shell 沒有讀取到新的環境變數。請開啟一個新終端機，或 source ~/.zshrc.
我可以透過 claude-code 使用非 Claude 模型嗎？ — 不行。該 CLI 只支援 Anthropic Messages API，而 Synthorai 的 /v1/messages 端點只路由到 Claude 模型。如需使用 OpenAI / Gemini / Qwen 模型，請直接使用 Codex、Aider 或 OpenAI SDK。
這三個等級的最新按 token 價格都在 Claude model price comparison 上。