服务商、认证与模型别名
ANTHROPIC_*、VERTEX_REGION_*、AWS_* 和 API_* 环境变量:API Key 与令牌、端点覆盖、Bedrock/Vertex/Foundry、Workload Identity Federation、模型别名与 /model 条目。
模型 ID、可用区域和版本要求随发布变化,以官方为准。
认证与端点
| 变量 | 用途 |
|---|---|
ANTHROPIC_API_KEY | 以 X-Api-Key 头发送的 API Key。设置后即使你已登录,也用它而不是 Claude Pro/Max/Team/Enterprise 订阅;非交互模式(-p)下总是使用该 Key |
ANTHROPIC_AUTH_TOKEN | Authorization 头的自定义值(你设的值前面会加 Bearer ) |
ANTHROPIC_BASE_URL | 覆盖 API 端点,通过代理或网关路由请求。设为非第一方主机时,MCP 工具搜索默认被禁用;代理转发 tool_reference 块时设置 ENABLE_TOOL_SEARCH=true |
ANTHROPIC_CUSTOM_HEADERS | 给请求添加自定义头,Name: Value 格式,多个头用换行分隔;名称或值含 HTTP 头不能携带的字符(弯引号、零宽空格等)时会被拒绝 |
ANTHROPIC_BETAS | 逗号分隔的额外 anthropic-beta 头值。Claude Code 已发送它需要的 beta 头,用它在 Claude Code 默认支持之前就用上某个 API beta |
ANTHROPIC_PROFILE | 用来认证的 Anthropic profile 名称(如由 ant auth login 或不带 API Key 登录 Console 账号创建的) |
ANTHROPIC_ORGANIZATION_ID、ANTHROPIC_FEDERATION_RULE_ID、ANTHROPIC_WORKSPACE_ID | Workload Identity Federation:前两者一起设置时 Claude Code 选用联合凭证,其优先级高于 /login 凭证;联合规则作用于多个工作区时,用 ANTHROPIC_WORKSPACE_ID 指明令牌交换的目标工作区 |
API_TIMEOUT_MS | API 请求超时,毫秒(默认 600000 即 10 分钟,最大 2147483647);慢网络或经代理路由时调大 |
API_FORCE_IDLE_TIMEOUT | 覆盖「流式模型响应 5 分钟内没有任何字节就中止」的空闲超时;设为 0 关闭(如慢网关或本地模型停顿超过 5 分钟) |
FALLBACK_FOR_ALL_PRIMARY_MODELS | 设为任何非空值(如 1),让 Claude Code 在没有配置回退模型时对每个模型在反复过载错误后停止重试;设为 0 或 false 仍然启用 |
BETA_TRACING_ENDPOINT | 详细 beta 追踪的 OTLP 端点:配合 ENABLE_BETA_TRACING_DETAILED=1,日志和追踪发往此处而不是已配置的导出器 |
Amazon Bedrock、Claude Platform on AWS、Foundry、Vertex
| 变量 | 用途 |
|---|---|
AWS_BEARER_TOKEN_BEDROCK | Amazon Bedrock API Key 认证 |
ANTHROPIC_BEDROCK_BASE_URL | 覆盖 Bedrock 端点(自定义端点或经 LLM 网关路由) |
ANTHROPIC_BEDROCK_MANTLE_BASE_URL | 覆盖 Bedrock Mantle 端点 |
ANTHROPIC_BEDROCK_REGION_PREFIX | Claude Code 优先尝试的跨区域推理 profile 前缀(us、eu、apac、jp、au 或 global),取代从 AWS 区域推导出的前缀;AWS GovCloud 区域忽略 |
ANTHROPIC_BEDROCK_SERVICE_TIER | Bedrock 服务层级(default、flex、priority),以 X-Amzn-Bedrock-Service-Tier 头发送 |
ANTHROPIC_AWS_API_KEY | Claude Platform on AWS 的工作区 API Key(在 AWS 控制台生成),作为 x-api-key 发送,优先于 AWS SigV4 |
ANTHROPIC_AWS_BASE_URL | 覆盖 Claude Platform on AWS 端点(自定义区域或经网关),默认 https://aws-external-anthropic.{region}.api.aws |
ANTHROPIC_AWS_WORKSPACE_ID | Claude Platform on AWS 必填,作为 anthropic-workspace-id 头随每个请求发送 |
ANTHROPIC_FOUNDRY_API_KEY | Microsoft Foundry 的 API Key |
ANTHROPIC_FOUNDRY_AUTH_TOKEN | Foundry 的 Bearer 令牌(如 Microsoft Entra 访问令牌),作为 Authorization: Bearer 发送,优先于 ANTHROPIC_FOUNDRY_API_KEY |
ANTHROPIC_FOUNDRY_BASE_URL | Foundry 资源的完整基础 URL,可替代 ANTHROPIC_FOUNDRY_RESOURCE |
ANTHROPIC_FOUNDRY_RESOURCE | Foundry 资源名;未设置 ANTHROPIC_FOUNDRY_BASE_URL 时必填 |
ANTHROPIC_VERTEX_BASE_URL | 覆盖 Google Cloud Agent Platform 端点 |
ANTHROPIC_VERTEX_PROJECT_ID | Agent Platform 请求所指向的 GCP 项目 ID |
VERTEX_REGION_CLAUDE_* | 按模型覆盖使用 Agent Platform 时的区域,每个模型一个变量:VERTEX_REGION_CLAUDE_3_5_HAIKU、…3_5_SONNET、…3_7_SONNET、…4_0_OPUS、…4_0_SONNET、…4_1_OPUS、…4_5_OPUS、…4_5_SONNET、…4_6_OPUS、…4_6_SONNET、…4_7_OPUS、…4_8_OPUS、…5_OPUS、…5_SONNET、…5_5_OPUS、…5_5_SONNET、…FABLE_5、…FABLE_5_1、…HAIKU_4_5(较新模型的变量在官方标注了引入版本) |
模型选择与别名
| 变量 | 用途 |
|---|---|
ANTHROPIC_MODEL | 要使用的模型设置的名称(见模型配置) |
ANTHROPIC_DEFAULT_MODEL | 新会话默认启动的模型(需要 v2.1.236 或更高) |
ANTHROPIC_DEFAULT_OPUS_MODEL | opus 别名解析到的模型 ID;opusplan 在计划模式下使用它 |
ANTHROPIC_DEFAULT_SONNET_MODEL | sonnet 别名解析到的模型 ID;opusplan 在非计划模式下使用它 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | haiku 别名解析到的模型 ID,也用于后台功能 |
ANTHROPIC_DEFAULT_FABLE_MODEL | fable 别名解析到的模型 ID,也是第三方服务商上自动模型回退所识别的 Fable 模型 ID |
ANTHROPIC_DEFAULT_<OPUS|SONNET|HAIKU|FABLE>_MODEL_NAME | 在 /model 选择器里为被固定的模型显示的名称(不设则在 Claude Code 认识该 ID 时显示模型名,否则显示 ID) |
ANTHROPIC_DEFAULT_<…>_MODEL_DESCRIPTION | 选择器里为被固定模型显示的描述(不设则显示以 Custom <系列> model 开头的默认描述) |
ANTHROPIC_DEFAULT_<…>_MODEL_SUPPORTED_CAPABILITIES | 被固定模型支持的能力,逗号分隔,如 effort,thinking |
ANTHROPIC_CUSTOM_MODEL_OPTION | 在 /model 选择器里额外加一个自定义条目的模型 ID,用于让非标准或网关特有的模型可选而不替换内置别名;另有 ANTHROPIC_CUSTOM_MODEL_OPTION_NAME、_DESCRIPTION、_SUPPORTED_CAPABILITIES 控制它的显示名、描述和能力 |
ANTHROPIC_SMALL_FAST_MODEL | 已弃用:后台任务使用的 Haiku 级模型名;改用 ANTHROPIC_DEFAULT_HAIKU_MODEL |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION | 使用 Bedrock 或 Bedrock Mantle 时覆盖 Haiku 级模型的 AWS 区域 |