2.3 API 调用与配置
认证方式
Claude Code 支持多种认证方式，按优先级依次为：
| 方式 | 适用场景 | 说明 |
|---|---|---|
| 云厂商凭据 | Bedrock / Vertex / Foundry | 通过环境变量配置，不需要浏览器登录 |
ANTHROPIC_AUTH_TOKEN | LLM 网关 | Bearer Token 认证，适合中转 API |
ANTHROPIC_API_KEY | 直接 Anthropic API | 标准 API Key，经典认证方式 |
apiKeyHelper | 动态/轮换凭据 | 运行自定义脚本返回 API Key |
| OAuth 浏览器登录 | Claude Pro/Max/Team/Enterprise | 订阅制用户，通过浏览器完成认证 |
CLAUDE_CODE_OAUTH_TOKEN | CI/CD 环境 | 长有效期 Token（1年），通过 claude setup-token 生成 |
环境变量配置
直接 API Key 认证
export ANTHROPIC_API_KEY=sk-ant-api03-xxxxx...适合国内用户配合 API 中转服务使用。
Bearer Token（LLM 网关）
export ANTHROPIC_AUTH_TOKEN=your-bearer-token当你使用第三方 LLM 网关时，网关可能要求 Bearer Token 而非直接 API Key。
云厂商认证
# Amazon Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
aws configure # 配置 AWS 凭据
# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
gcloud auth application-default login
# Azure Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
代理配置
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890Claude Code 本身没有内置代理配置，需要通过系统环境变量设置代理。
API Key Helper
对于需要动态获取或定期轮换 API Key 的场景，可以使用 apiKeyHelper 配置：
{
"apiKeyHelper": "/path/to/get-api-key.sh"
}
脚本输出纯文本的 API Key 即可，Claude Code 会每次调用前执行该脚本获取最新 Key。
长有效期 Token（CI/CD）
在 CI/CD 环境中，不适合使用浏览器登录，可以通过 CLI 生成长期 Token：
claude setup-token生成的 Token 有效期为 1 年，之后重新生成。将 Token 设置为 CI 环境变量：
export CLAUDE_CODE_OAUTH_TOKEN=your-long-lived-token费用管理
费用构成
Claude Code 的费用分为两部分：
- 订阅费用：Claude Pro/Max/Team/Enterprise 订阅包含一定额度的使用量
- API 超额费用：超出订阅额度后，按 API 用量计费
查看用量
/usage # 在 Claude Code 会话中查看当前会话的 Token 使用估算
Claude Code 会在本地估算 Token 用量。更精确的用量数据可以在 Claude Console 的工作区账单页面查看。
团队 TPM/RPM 限额建议
| 团队规模 | 每用户 TPM | 每用户 RPM |
|---|---|---|
| 1-5 人 | 200k - 300k | 5 - 7 |
| 5-20 人 | 100k - 150k | 2.5 - 3.5 |
| 20-50 人 | 50k - 75k | 1.25 - 1.75 |
| 50-100 人 | 25k - 35k | 0.62 - 0.87 |
| 100-500 人 | 15k - 20k | 0.37 - 0.47 |
| 500+ 人 | 10k - 15k | 0.25 - 0.35 |
费用参考
根据官方数据，企业用户平均费用约为：
- 每活跃日：约 $13/开发者/天
- 每月：约 $150-250/开发者/月
- 90% 的用户每日费用低于 $30
超时与重试配置
export API_TIMEOUT_MS=600000 # 单次请求超时（毫秒），默认 10 分钟
export CLAUDE_CODE_MAX_RETRIES=10 # 最大重试次数，默认 10Claude Code 会对 5xx 错误、529（过载）、超时、临时 429 使用指数退避策略自动重试。
Claude Console 工作区
Claude Code 会自动创建一个名为 "Claude Code" 的 API Console 工作区，用于计费和用量管理。在 Console 中可以：
- 设置工作区级别的消费限额
- 查看各开发者的用量明细
- 管理 API Key 和访问权限