Skip to content

Claude Code 接入

Claude Code 使用 Anthropic Messages 协议。接入 QuotaAPI 时,Base URL 使用 https://quotarouter.ai,API Key 使用你在控制台创建的 Key。

环境变量方式

在终端中设置:

bash
export ANTHROPIC_BASE_URL="https://quotarouter.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_QUOTAAPI_KEY"

如果你的客户端版本使用 ANTHROPIC_API_KEY,可以改成:

bash
export ANTHROPIC_BASE_URL="https://quotarouter.ai"
export ANTHROPIC_API_KEY="YOUR_QUOTAAPI_KEY"

然后重新打开终端或重启 Claude Code,让环境变量生效。

cc-switch 导入

如果你使用 cc-switch 管理配置,核心字段保持一致:

字段
ProviderAnthropic compatible
Base URLhttps://quotarouter.ai
API KeyYOUR_QUOTAAPI_KEY
Modelclaude-opus-4.8 或控制台开放的 Claude 模型

导入后建议先运行一个短请求,确认 Claude Code 可以拿到响应,再切换到正式任务。

手动测试 Anthropic Messages

bash
curl https://quotarouter.ai/v1/messages \
  -H "x-api-key: YOUR_QUOTAAPI_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8",
    "max_tokens": 80,
    "messages": [
      { "role": "user", "content": "Reply with one sentence about QuotaAPI." }
    ]
  }'

模型名称

以控制台当前可用模型为准。常见 Claude 模型命名示例:

模型适合场景
claude-opus-4.8复杂推理、长上下文、代码任务
claude-sonnet-4.5日常开发、问答、较高性价比任务

如果客户端提示模型不存在,先检查 API Key 所属分组是否包含该模型,再确认模型名称没有拼写错误。

排查

  • Claude Code 报认证失败:检查 ANTHROPIC_AUTH_TOKENANTHROPIC_API_KEY 是否为 QuotaAPI Key。
  • 请求直接打到官方默认地址:说明 ANTHROPIC_BASE_URL 未生效,需要重启终端或检查配置文件。
  • 返回余额不足:进入控制台查看余额和 API Key 所属账号。
  • 返回模型不可用:检查当前 Key 的分组、模型权限和模型名称。

QuotaAPI 是面向开发者和团队的 AI API 中转服务。