文档索引

在此获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进行进一步探索。

环境变量

控制 Claude Code 行为的环境变量参考。

环境变量可以控制 Claude Code 的行为，例如模型选择、身份验证、请求路由和功能开关。许多相同的行为也可以通过设置文件字段、CLI 标志或会话内命令（如 /model）来配置。

本页介绍如何：

• 设置环境变量（在 shell 中或在设置文件中）
• 检查哪个值生效（当一个行为可以通过多种方式设置时）
• 查阅 Claude Code 读取的变量

设置环境变量

在 shell 中设置的变量仅在该终端会话期间有效，而设置文件中的变量则在每次运行 claude 时都会生效。

在 shell 中

在启动 claude 之前设置变量：

export API_TIMEOUT_MS="1200000"
claude

$env:API_TIMEOUT_MS = "1200000"
claude

set API_TIMEOUT_MS=1200000
claude

在设置文件中

在 settings.json 文件的 env 键下添加变量。Claude Code 在启动时直接从文件中读取它们，因此无论 claude 是如何启动的，它们都会生效。

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

你选择的文件决定了变量适用于谁：

参阅设置文件了解每个文件的位置，参阅设置优先级了解当多个文件设置相同变量时如何合并。

优先级

当同一行为同时存在环境变量和设置字段时，环境变量优先。例如，ANTHROPIC_MODEL 覆盖 model 设置，CLAUDE_CODE_AUTO_CONNECT_IDE 覆盖 autoConnectIde。当环境变量未设置时，设置字段生效。

环境变量与 CLI 标志和会话内命令的交互方式因功能而异：--model 和 /model 覆盖 ANTHROPIC_MODEL，而 CLAUDE_CODE_EFFORT_LEVEL 覆盖 /effort。当变量与其他配置源交互时，其在变量列表中的行会说明优先级或链接到相关文档页面。

Claude Code 在启动时读取环境变量，因此更改在下次启动 claude 时生效。

变量

还支持标准 OpenTelemetry 导出器变量（OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER、OTEL_EXPORTER_OTLP_ENDPOINT、OTEL_EXPORTER_OTLP_PROTOCOL、OTEL_EXPORTER_OTLP_HEADERS、OTEL_METRIC_EXPORT_INTERVAL、OTEL_RESOURCE_ATTRIBUTES 和信号特定变体）。参阅监控了解配置详情。

另请参阅

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