Claude Code 环境变量参考 #

Claude Code 通过环境变量控制 API 认证、模型选择、Bash 执行、上下文压缩、云服务商路由等行为。可在 Shell 中临时设置（export），写入 profile 永久生效，或通过 settings.json 的 env 字段统一下发给团队。设置后修改需重新启动 claude。

环境变量可覆盖 Claude Code 行为，如模型选择、认证方式、请求路由和功能开关。很多相同的行为也可以通过 settings 文件、CLI 标志或 /model 等会话内命令配置。

本页内容：

• 设置环境变量：在 Shell 中或在 settings 文件中配置
• 优先级规则：当多个配置源同时存在时哪个生效
• 变量参考：所有环境变量分类列表

设置环境变量 #

Shell 中设置的变量仅对当前终端会话生效；settings 文件中的变量在每次 claude 运行时自动生效。

在 Shell 中设置 #

启动 claude 前导出变量：

Bash / Zsh （macOS/Linux）

export ANTHROPIC_API_KEY="your-key"
export API_TIMEOUT_MS="1200000"
claude

要每次会话都生效，将 export 行添加到 ~/.bashrc、~/.zshrc 或对应的 profile 文件。

PowerShell （Windows）

$env:ANTHROPIC_API_KEY = "your-key"
$env:API_TIMEOUT_MS = "1200000"
claude

要永久生效，运行 [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-key", "User") 并重启终端。

CMD （Windows）

set ANTHROPIC_API_KEY=your-key
set API_TIMEOUT_MS=1200000
claude

要永久生效，运行 setx ANTHROPIC_API_KEY "your-key" 并重启终端。

在 settings 文件中配置 #

在 settings.json 文件的 env 键下添加变量。Claude Code 启动时直接读取文件内容，无论通过何种方式启动都会生效。

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

文件位置决定作用范围：

详见 Settings 文件 和 Settings 优先级。

优先级规则 #

当同一行为既有环境变量又有 settings 字段时，环境变量优先。例如 ANTHROPIC_MODEL 会覆盖 model 设置，CLAUDE_CODE_AUTO_CONNECT_IDE 会覆盖 autoConnectIde。settings 字段仅当环境变量未设置时生效。

环境变量与 CLI 标志、会话内命令的交互因功能而异：--model 和 /model 会覆盖 ANTHROPIC_MODEL，而 CLAUDE_CODE_EFFORT_LEVEL 则会覆盖 /effort。当变量与其他配置源交互时，其表格行会说明优先级或链接到具体文档。

Claude Code 在启动时读取环境变量，修改后需要重启 claude 才能生效。

变量参考 #

表格中的 “用途” 字段简述变量功能，需要更详细说明的变量会链接到对应章节。

API 认证与端点 #

模型选择 #

Bash 执行控制 #

上下文窗口与压缩 #

代理与网络 #

AWS Bedrock #

Google Vertex AI #

Microsoft Foundry #

Claude Platform on AWS #

MCP 配置 #

子代理与后台任务 #

安全与凭证隔离 #

遥测、调试与日志 #

显示与终端 #

会话管理与自动退出 #

路径与目录 #

其他通用变量 #

标准 OpenTelemetry exporter 变量（OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER、OTEL_EXPORTER_OTLP_ENDPOINT 等）也受支持，详见监控。

常见问题 #

如何设置 Claude Code 的 API Key？ #

设置 ANTHROPIC_API_KEY 环境变量。临时使用 export ANTHROPIC_API_KEY="your-key"（Unix）或 $env:ANTHROPIC_API_KEY = "your-key"（PowerShell）；永久有效可添加到 profile 文件或使用 settings.json 的 env 字段。注意：设置后该 Key 会优先于订阅被使用，要恢复订阅请运行 unset ANTHROPIC_API_KEY。

Claude Code 如何切换模型？ #

设置 ANTHROPIC_MODEL 环境变量为目标模型名（如 claude-sonnet-4-6）。也可设置 ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL 分别覆盖三种基础别名。优先级：CLI 标志 --model 和会话内的 /model 命令会覆盖环境变量。

如何通过环境变量配置企业代理？ #

设置 HTTP_PROXY 和 HTTPS_PROXY 指向企业代理。如果不希望某些地址走代理，设置 NO_PROXY。如果代理和 Anthropic API 之间的 TLS 检查有特殊证书，还需通过 CLAUDE_CODE_CERT_STORE 或 NODE_EXTRA_CA_CERTS 指定 CA 证书来源。

相关资源 #

• Settings 参考：settings.json 完整配置，包括 env 键
• CLI 参考：启动时标志
• 网络配置：代理与 TLS 设置
• 监控：OpenTelemetry 配置