Guide

Claude Code 如何配置 API 中转站

先确认服务是否支持 Anthropic 兼容接口，再用小额额度测试。不要把生产密钥、私有仓库和客户数据直接交给未经验证的中转服务。

配置前检查

  • 确认平台是否明确支持 Claude Code，而不是只支持 OpenAI Compatible。
  • 确认 API Base URL、模型名、鉴权 Header、流式输出是否与 Claude Code 兼容。
  • 确认价格单位，最好换算到每 1M input tokens 和每 1M output tokens。
  • 查看是否有隐私政策、日志保存说明、退款说明和客服渠道。

常见环境变量

不同中转站写法会有差异，下面只是结构示例。具体变量名请以平台文档和 Claude Code 当前版本为准。

ANTHROPIC_AUTH_TOKEN="your-relay-api-key"
ANTHROPIC_BASE_URL="https://example.com/anthropic"

官方 LLM Gateway 信号

Anthropic 的 Claude Code LLM gateway 文档把 gateway 描述为认证、用量追踪、预算、审计日志和模型路由的集中代理层。第三方中转如果要作为团队网关使用，应明确说明自己实际提供了哪些能力。

  • 确认 provider 暴露的是 Claude Code 可用的 Anthropic 格式端点，而不只是 OpenAI-compatible `/v1` 端点。
  • 确认 `ANTHROPIC_BASE_URL` 应该指向网关根路径，还是 `/anthropic` 这类 provider 专属路径；不要猜测或盲目追加 `/v1`。
  • 确认 provider 期望使用 `ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_API_KEY`，还是 Claude Code settings 里的 `apiKeyHelper`。
  • 如果使用 API key helper，注意它的优先级低于显式设置的 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`。
  • 团队使用前，要求 provider 说明用量追踪、成本控制、审计日志、模型路由和 fallback 行为如何实现、如何导出。

配置安全核对

Claude Code 会读取本地环境变量和 settings。任何设置 `ANTHROPIC_BASE_URL` 的仓库或复制来的片段都应当按敏感配置处理，因为它可以把代码和 Prompt 路由到不同端点。

  • 在克隆仓库里启动 Claude Code 前，先检查 `.claude/settings.json`、shell profile、CI 变量和项目脚本。
  • 测试新 provider 前，清理异常的 `ANTHROPIC_BASE_URL`、`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_API_KEY`、Bedrock 或 Vertex 变量。
  • 第一次测试优先用临时终端 session；只有在确认端点、模型名和扣费后，再持久化配置。
  • 不要在包含私有仓库或密钥的工作区里运行带有未知项目配置的 Claude Code。
  • 当 gateway 返回异常鉴权、模型或流式输出错误时，保留官方 Anthropic、Bedrock 或 Vertex 路径作为 fallback。

小额测试流程

  1. 充值最低金额或使用免费额度，不要一开始大额充值。
  2. 用无敏感信息的示例项目测试普通问答、代码阅读、代码修改和长上下文。
  3. 记录每次请求的延迟、错误码、扣费和模型输出质量。
  4. 用固定 prompt 检查模型是否疑似掉包。
  5. 确认稳定后，再考虑放入日常开发工作流。

模型验真思路

单次问答无法证明模型真实身份。更稳的做法是准备一组固定测试，包括长上下文召回、工具调用风格、代码推理、多语言细节和拒答边界，并记录同一平台多次输出的差异。

如果你的代码库包含商业秘密、客户数据、密钥、内部接口或未发布产品信息，优先使用官方 API、企业合规方案或自建 BYOK 网关。

常见问题

Claude Code 中转站和普通 OpenAI-compatible 中转站一样吗？

不完全一样。Claude Code 更依赖 Anthropic 兼容接口、模型名和流式输出行为。只支持 OpenAI-compatible 的平台未必能直接满足 Claude Code。

Claude Code 使用中转站最大的风险是什么？

主要风险是 Prompt 和代码日志泄露、模型掉包、长上下文不稳定、余额损失和上游来源不透明。敏感仓库应优先使用官方 API 或企业合规方案。

怎样判断 Claude Code 中转站是否值得长期用？

先看文档、价格、隐私和客服是否清楚，再用固定项目测试多轮代码阅读、修改、长上下文和失败重试，并持续记录扣费和错误率。

应该把 ANTHROPIC_BASE_URL 写进项目 settings 吗？

只应在可信项目和已复核端点里这样做。第一次测试先用临时终端 session。项目级配置如果改写 `ANTHROPIC_BASE_URL`，可能把 Prompt 和代码路由到不同服务。