Skip to main content
Claude Code 使用 Anthropic Messages API。我们在 POST /v1/messages 运行该 API,因此一个基础 URL 和一个密钥即可完成整个集成。 Claude Code 没有设置 start_within 的地方,因此截止日期会附加到密钥上。请先创建一个密钥(参见代理密钥)。 在托管密钥上,不进行流式传输的情况下,持续时间在三到十分钟的窗口内与 Claude 的更便宜层级竞争。交互式会话会进行流式传输,因此请在此处选择一个层级。密钥持续时间在这两种情况下都有效,因为它会回退到某个层级而不是失败。参见Claude 持续时间需要更长的窗口 在开始之前,您的组织必须能够运行 Anthropic。对于您自己的密钥,这意味着在提供商密钥选项卡上有一个 Anthropic 提供商密钥,因为我们不转售推理服务。对于托管密钥,这意味着 Anthropic 已启用并获得资金。

使用代理进行设置

打开下面的代码块并将其复制到任何编码代理中。该提示永远不会要求您的 API 密钥:代理会配置所有其他内容,然后打印一行 export 命令供您自行运行。

配置 Claude Code

  1. 创建或打开 ~/.claude/settings.json。项目文件 .claude/settings.json 的工作方式相同。
  2. 添加一个 env 块,指定路由器、您的密钥和两个模型。
  1. 启动 Claude Code。
或者,在您的 shell 中导出相同的变量,以避免将密钥写入文件。
以下四条规则可确保其正常工作。 省略 /v1 后缀。 Claude Code 会自行将 /v1/messages 附加到基础 URL。 使用 ANTHROPIC_AUTH_TOKEN,而不是 ANTHROPIC_API_KEY 前者发送 Authorization: Bearer,这是我们要求的。后者发送 x-api-key,我们拒绝接收。 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 设置为 1 否则,Claude Code 会发送实验性 beta 字段,例如 context_management。我们不会转发这些字段所需的 anthropic-beta 标头,因此每个请求都会失败。 设置两个模型变量。 Claude Code 使用一个密钥运行一个大型主循环模型和一个小型后台模型。两者都必须是 claude-* slug。

确认密钥已应用

每个响应都带有 x-flexinference-defaults-applied。Claude Code 不显示响应标头,因此请改为在仪表板的日志下查看请求。

故障排除

400 context_management: Extra inputs are not permitted Claude Code 发送了一个实验性 beta 字段,但我们没有转发其所需的 anthropic-beta 标头。请设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 并启动新会话。此标志也会清除任何其他命名 beta 字段的 Extra inputs are not permitted 拒绝。 401 missing_api_key 您设置了 ANTHROPIC_API_KEY,因此客户端发送了 x-api-key,我们不读取此项。请改为设置 ANTHROPIC_AUTH_TOKEN 并取消设置 ANTHROPIC_API_KEY 400 unsupported_parameter 命名 output_config 模型变量指向非 Claude slug,并且 Claude Code 发送了我们拒绝错误翻译的 Anthropic 原生字段。请将两个模型变量都设置为 claude-* slug。 404 unknown_url 命名 /v1/messages/count_tokens 我们不路由该路径。claude -p 运行从不调用它,尽管交互式会话可能会。 每个请求都会耗尽完整的重试预算。 Claude Code 会自行重试,而密钥的 retry 策略会与其叠加。请在使用此客户端的密钥上不设置 retry 有关我们返回的所有拒绝,请参见错误;有关非 Claude Code 特有的拒绝,请参见代理密钥