Esta página todavía solo está disponible en chino. La navegación y los menús ya aparecen en español.

配置 Claude Code

Claude Code 可以通过 Anthropic Messages 兼容协议接入 InOneAPI。InOneAPI 负责鉴权、协议处理、计量和路由；Claude Code 的文件访问、命令执行与授权仍由本机客户端控制。

准备工作

创建一个专用于 Claude Code 的项目 Key，并从模型详情页复制支持 Anthropic Messages、流式输出和工具调用的模型 ID。不同协议的能力不能仅凭模型名称推断，应以模型详情为准。

写入配置

Windows 路径为 %USERPROFILE%\.claude\settings.json；设置了 CLAUDE_CONFIG_DIR 时使用该目录。创建或打开 ~/.claude/settings.json，将 env 字段合并到现有 JSON：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.inoneapi.com",
    "ANTHROPIC_AUTH_TOKEN": "ioa_sk_...",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID"
  }
}

ANTHROPIC_BASE_URL 不要追加 /v1，Claude Code 会自行请求 Messages 路径。四个模型变量使用同一个 ID，可以避免 Claude Code 在不同任务阶段切回未配置的默认模型。

如果不希望把 Key 保存在 JSON 中，可在 shell 中设置 ANTHROPIC_AUTH_TOKEN，并从 settings.json 删除该字段：

export ANTHROPIC_AUTH_TOKEN="ioa_sk_..."

启动与验证

claude

先让 Claude Code 执行只读任务，再查看控制台 Trace。应确认：请求模型与配置一致、接口为 Anthropic Messages、流式输出正常、工具调用没有协议转换错误。

常见问题

  • 登录提示反复出现：确认设置的是 ANTHROPIC_AUTH_TOKEN，并完全退出后重新启动 Claude Code。
  • 401：检查 Key、项目状态以及环境变量是否被旧值覆盖。
  • 404：通常是 Base URL 错误或模型 ID 不存在；这里的 Base URL 不带 /v1。
  • 工具调用失败：换用模型详情中明确支持工具调用和 Anthropic Messages 的模型。
  • 成本异常：Claude Code 可能并行读取文件或重试，为专用 Key 设置预算与告警。

不要把包含真实 Key 的 settings.json 同步到团队仓库。团队成员应分别使用可追踪的个人或团队子 Key。

可选：通过 CC Switch 导入

在模型详情页选择本工具和 API Key，点击「打开 CC Switch 并导入」。使用 CC Switch 官方版本，导入链接已包含当前模型 ID，无需重新填写。确认导入后，按本工具的供应商启用与默认模型设置完成接入。若提示不支持该 app，请升级 CC Switch 或按本文手动接入。

导入链接只添加 Provider，不代表已设为默认模型或已成功请求。链接包含 API Key，请勿分享。手动接入与 CC Switch 接入二选一即可。

CC Switch 链接同时传入 model、haikuModel、sonnetModel、opusModel，均使用当前模型 ID，与手动配置一致。

官方参考：Claude Code LLM Gateway。

Claude Code · Documentación · InOneAPI