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 上。