跳到正文
FunCoding

搜索

搜索文档、智能体、博客、Skill 和 MCP

服务商、认证与模型别名

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_TOKENAuthorization 头的自定义值(你设的值前面会加 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_IDWorkload Identity Federation:前两者一起设置时 Claude Code 选用联合凭证,其优先级高于 /login 凭证;联合规则作用于多个工作区时,用 ANTHROPIC_WORKSPACE_ID 指明令牌交换的目标工作区
API_TIMEOUT_MSAPI 请求超时,毫秒(默认 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_BEDROCKAmazon Bedrock API Key 认证
ANTHROPIC_BEDROCK_BASE_URL覆盖 Bedrock 端点(自定义端点或经 LLM 网关路由)
ANTHROPIC_BEDROCK_MANTLE_BASE_URL覆盖 Bedrock Mantle 端点
ANTHROPIC_BEDROCK_REGION_PREFIXClaude Code 优先尝试的跨区域推理 profile 前缀(us、eu、apac、jp、au 或 global),取代从 AWS 区域推导出的前缀;AWS GovCloud 区域忽略
ANTHROPIC_BEDROCK_SERVICE_TIERBedrock 服务层级(default、flex、priority),以 X-Amzn-Bedrock-Service-Tier 头发送
ANTHROPIC_AWS_API_KEYClaude 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_IDClaude Platform on AWS 必填,作为 anthropic-workspace-id 头随每个请求发送
ANTHROPIC_FOUNDRY_API_KEYMicrosoft Foundry 的 API Key
ANTHROPIC_FOUNDRY_AUTH_TOKENFoundry 的 Bearer 令牌(如 Microsoft Entra 访问令牌),作为 Authorization: Bearer 发送,优先于 ANTHROPIC_FOUNDRY_API_KEY
ANTHROPIC_FOUNDRY_BASE_URLFoundry 资源的完整基础 URL,可替代 ANTHROPIC_FOUNDRY_RESOURCE
ANTHROPIC_FOUNDRY_RESOURCEFoundry 资源名;未设置 ANTHROPIC_FOUNDRY_BASE_URL 时必填
ANTHROPIC_VERTEX_BASE_URL覆盖 Google Cloud Agent Platform 端点
ANTHROPIC_VERTEX_PROJECT_IDAgent 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_MODELopus 别名解析到的模型 ID;opusplan 在计划模式下使用它
ANTHROPIC_DEFAULT_SONNET_MODELsonnet 别名解析到的模型 ID;opusplan 在非计划模式下使用它
ANTHROPIC_DEFAULT_HAIKU_MODELhaiku 别名解析到的模型 ID,也用于后台功能
ANTHROPIC_DEFAULT_FABLE_MODELfable 别名解析到的模型 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 区域