SpyBara
Go Premium

env-vars.md 2026-10-02 22:59 UTC to 2026-10-03 08:58 UTC

This page contains 356 additions and 354 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 09:58

环境变量

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

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

本页面涵盖以下内容：

设置环境变量

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

在 shell 中

在启动 claude 之前设置变量：

export API_TIMEOUT_MS="1200000"
claude

要为每个会话设置它，请将 export 行添加到 ~/.bashrc、~/.zshrc 或您的 shell 配置文件中。

赋值行在成功时不会打印任何内容。要确认变量已设置，请在同一 shell 中打印它：

echo $API_TIMEOUT_MS

在设置文件中

在 settings.json 文件中的 env 键下添加变量，如果文件不存在则创建它。Claude Code 直接从文件中读取它们，因此无论如何启动 claude，它们都会生效。运行中的会话在您保存文件时会将新值和更改的值应用到其环境中，但在启动时读取其变量一次的功能（例如 OpenTelemetry 监控）会保持其启动值，直到您重新启动。从文件中删除变量不会在运行中的会话中取消设置它；删除在您下次启动 claude 时生效。

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

您选择的文件控制变量应用于谁：

文件 应用于
~/.claude/settings.json 您，在每个项目中
.claude/settings.json 在项目中工作的每个人，检入源代码控制
.claude/settings.local.json 您，仅在此项目中，当 Claude Code 将设置保存到它时被 gitignore；如果您手动创建它，请将其添加到您的 gitignore
托管设置 您组织中的每个人，由管理员部署

请参阅 设置文件 了解每个文件的位置，以及 设置优先级 了解当多个文件设置相同变量时它们如何组合。

优先级

某些行为同时具有环境变量和专用设置键，Claude Code 读取哪一个的顺序因键而异。对于 ANTHROPIC_MODEL 和 CLAUDE_CODE_AUTO_CONNECT_IDE，Claude Code 首先读取变量，仅当变量未设置时才使用 model 或 autoConnectIde 设置。对于您正在设置的对，请检查下面变量的行和 设置参考 上的键条目。

当同一变量在您的 shell 和设置文件 env 块中都设置时，在大多数会话中设置文件值适用。Claude Code 将每个 env 条目写入进程环境，替换从 shell 继承的值。env 值如何与您的 shell 交互 涵盖保留继承值的会话，以及 env 设置 说明何时应用它们。少数变量是特殊情况；env 设置 列出了例外。

在设置文件中，您可以设置变量，但不能删除变量。要覆盖无法取消设置的变量，例如由您无法控制的 shell 配置文件导出的过时 CLAUDE_CODE_USE_VERTEX，请在 env 块中将其设置为空字符串："CLAUDE_CODE_USE_VERTEX": ""。Claude Code 将空值视为未设置以进行提供程序选择。子进程仍然继承空值。

在设置文件之间，env 值遵循 设置优先级，因此托管设置条目覆盖用户或项目设置中的相同变量。项目和本地设置无法设置某些变量，例如 CLAUDE_CONFIG_DIR 和 OpenTelemetry 导出程序变量。Claude Code 在 env 中忽略的变量 列出了它们，以及仍然适用的 OpenTelemetry 关闭值。

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

Claude Code 在启动时读取 shell 环境变量，因此对它们的更改在您下次启动 claude 时生效。在设置文件中 env 键下设置的变量在文件更改时重新应用到运行中的会话，但 在设置文件中 描述的仅启动时例外除外。

变量

超时时间、token 预算和重试次数等数值变量除了接受普通数字外，还接受科学记数法和数字分隔符写法，除非某个变量所在行注明它仅接受普通数字。例如，Claude Code 将 2e3 读取为 2000，将 64_000 读取为 64000。在 v2.1.211 之前，这些写法可能会在没有任何提示的情况下设置一个小得多的值，例如 1e6 会将超时时间设置为 1。

变量 用途
ANTHROPIC_API_KEY 作为 X-Api-Key 标头发送的 API 密钥。设置后，即使您已登录，也会使用此密钥，而不是您的 Claude Pro、Max、Team 或 Enterprise 订阅。在非交互模式（-p）下，只要存在该密钥就始终会使用它。在交互模式下，系统会提示您批准该密钥一次，之后它才会覆盖您的订阅。要改用您的订阅，请运行 unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKEN Authorization 标头的自定义值（您在此处设置的值将以 Bearer 为前缀）
ANTHROPIC_AWS_API_KEY Claude Platform on AWS 的工作区 API 密钥，在 AWS 控制台中生成。作为 x-api-key 发送，优先于 AWS SigV4
ANTHROPIC_AWS_BASE_URL 覆盖 Claude Platform on AWS 端点 URL。用于自定义区域或通过 LLM 网关路由时。默认为 https://aws-external-anthropic.{region}.api.aws。Claude Code 按照与 Amazon Bedrock 相同的优先级解析区域
ANTHROPIC_AWS_WORKSPACE_ID Claude Platform on AWS 必需。在每个请求中作为 anthropic-workspace-id 标头发送
ANTHROPIC_BASE_URL 覆盖 API 端点，以通过代理或网关路由请求。当设置为非第一方主机时，MCP 工具搜索默认处于禁用状态。如果您的代理会转发 tool_reference 块，请设置 ENABLE_TOOL_SEARCH=true。从 v2.1.196 起，当此变量指向 api.anthropic.com 以外的主机时，Remote Control 会被禁用，与其在 Amazon Bedrock、Google Cloud's Agent Platform 和 Microsoft Foundry 上的行为一致
ANTHROPIC_BEDROCK_BASE_URL 覆盖 Amazon Bedrock 端点 URL。用于自定义 Amazon Bedrock 端点或通过 LLM 网关路由时。请参阅 Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URL 覆盖 Amazon Bedrock Mantle 端点 URL。请参阅 Mantle 端点
ANTHROPIC_BEDROCK_REGION_PREFIX Claude Code 优先尝试的跨区域推理配置文件前缀（us、eu、apac、jp、au 或 global），而不是从 AWS 区域推导出的前缀。在 AWS GovCloud 区域中会被忽略。需要 Claude Code v2.1.224 或更高版本。请参阅 Amazon Bedrock
ANTHROPIC_BEDROCK_SERVICE_TIER Amazon Bedrock 服务层级（default、flex 或 priority）。作为 X-Amzn-Bedrock-Service-Tier 标头发送。请参阅 Amazon Bedrock
ANTHROPIC_BETAS 以逗号分隔的附加 anthropic-beta 标头值列表，这些值将包含在 API 请求中。Claude Code 已会发送其所需的 beta 标头；在 Claude Code 添加原生支持之前，可使用此变量选择加入某个 Anthropic API beta。与需要 API 密钥身份验证的 --betas 标志不同，此变量适用于所有身份验证方式，包括 Claude.ai 订阅
ANTHROPIC_CUSTOM_HEADERS 要添加到请求中的自定义标头（Name: Value 格式，多个标头以换行分隔）。如果名称或值包含 HTTP 标头无法承载的字符，例如弯引号或零宽空格，请求将失败，并显示一条按位置标识该名称/值对的错误。需要 Claude Code v2.1.227 或更高版本。无效的请求标头值列出了确切的字符集以及该检查的运行位置。当由服务器托管设置下发时，设置凭据、组织或租户、路由或 API 行为标头（例如 Authorization 或 Host）的值会被视为需要批准的设置。在项目设置或本地设置中，此类值遵循何时应用 env 值的规则
ANTHROPIC_CUSTOM_MODEL_OPTION 要作为自定义条目添加到 /model 选择器中的模型 ID。使用它可以让非标准或特定于网关的模型变为可选，而无需替换内置别名。请参阅模型配置
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION /model 选择器中自定义模型条目的显示描述。未设置时默认为 Custom model (<model-id>)
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME /model 选择器中自定义模型条目的显示名称。未设置时，如果 Claude Code 能识别该 ID，条目将显示模型名称，否则显示模型 ID
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES 自定义模型所支持功能的逗号分隔列表，例如 effort,thinking。请参阅模型配置
ANTHROPIC_DEFAULT_FABLE_MODEL fable 别名解析到的模型 ID，也是 Claude Code 在第三方提供商上进行自动模型回退时识别为 Fable 模型的 ID。请参阅模型配置
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION /model 选择器中固定的 Fable 模型的显示描述。未设置时，该行显示以 Custom Fable model 开头的默认描述。请参阅模型配置
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME /model 选择器中固定的 Fable 模型的显示名称。未设置时，如果 Claude Code 能识别固定的 ID，该行显示模型名称，否则显示固定的 ID。请参阅模型配置
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES 固定的 Fable 模型所支持功能的逗号分隔列表，例如 effort,thinking。请参阅模型配置
ANTHROPIC_DEFAULT_HAIKU_MODEL haiku 别名解析到的模型 ID，也用于后台功能。请参阅模型配置
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION /model 选择器中固定的 Haiku 模型的显示描述。未设置时，该行显示以 Custom Haiku model 开头的默认描述。请参阅模型配置
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME /model 选择器中固定的 Haiku 模型的显示名称。未设置时，如果 Claude Code 能识别固定的 ID，该行显示模型名称，否则显示固定的 ID。请参阅模型配置
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES 固定的 Haiku 模型所支持功能的逗号分隔列表，例如 effort,thinking。请参阅模型配置
ANTHROPIC_DEFAULT_MODEL 新会话默认使用的模型。需要 Claude Code v2.1.236 或更高版本。请参阅为新会话设置默认模型
ANTHROPIC_DEFAULT_OPUS_MODEL opus 别名解析到的模型 ID，也是计划模式处于活动状态时 opusplan 使用的模型 ID。请参阅模型配置
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION /model 选择器中固定的 Opus 模型的显示描述。未设置时，该行显示以 Custom Opus model 开头的默认描述。请参阅模型配置
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME /model 选择器中固定的 Opus 模型的显示名称。未设置时，如果 Claude Code 能识别固定的 ID，该行显示模型名称，否则显示固定的 ID。请参阅模型配置
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES 固定的 Opus 模型所支持功能的逗号分隔列表，例如 effort,thinking。请参阅模型配置
ANTHROPIC_DEFAULT_SONNET_MODEL sonnet 别名解析到的模型 ID，也是计划模式未处于活动状态时 opusplan 使用的模型 ID。请参阅模型配置
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION /model 选择器中固定的 Sonnet 模型的显示描述。未设置时，该行显示以 Custom Sonnet model 开头的默认描述。请参阅模型配置
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME /model 选择器中固定的 Sonnet 模型的显示名称。未设置时，如果 Claude Code 能识别固定的 ID，该行显示模型名称，否则显示固定的 ID。请参阅模型配置
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES 固定的 Sonnet 模型所支持功能的逗号分隔列表，例如 effort,thinking。请参阅模型配置
ANTHROPIC_FEDERATION_RULE_ID Workload Identity Federation 的联合规则 ID。当您将其与 ANTHROPIC_ORGANIZATION_ID 一起设置时，Claude Code 会选择联合凭据，其优先级高于您的 /login 凭据。请参阅身份验证优先级
ANTHROPIC_FOUNDRY_API_KEY 用于 Microsoft Foundry 身份验证的 API 密钥（请参阅 Microsoft Foundry）
ANTHROPIC_FOUNDRY_AUTH_TOKEN 用于 Microsoft Foundry 身份验证的 Bearer 令牌，例如 Microsoft Entra 访问令牌。Claude Code 将其作为 Authorization: Bearer 标头发送。优先于 ANTHROPIC_FOUNDRY_API_KEY 和 Azure 默认凭据链。请参阅 Microsoft Foundry。需要 Claude Code v2.1.203 或更高版本
ANTHROPIC_FOUNDRY_BASE_URL Microsoft Foundry 资源的完整基础 URL（例如 https://my-resource.services.ai.azure.com/anthropic）。可替代 ANTHROPIC_FOUNDRY_RESOURCE（请参阅 Microsoft Foundry）
ANTHROPIC_FOUNDRY_RESOURCE Microsoft Foundry 资源名称（例如 my-resource）。Claude Code 会拒绝 URL 或主机名。如果未设置 ANTHROPIC_FOUNDRY_BASE_URL，则为必需（请参阅 Microsoft Foundry）
ANTHROPIC_MODEL 要使用的模型设置的名称（请参阅模型配置）
ANTHROPIC_ORGANIZATION_ID Workload Identity Federation 的组织 ID。请将其与 ANTHROPIC_FEDERATION_RULE_ID 一起设置。请参阅身份验证优先级
ANTHROPIC_PROFILE 用于身份验证的 Anthropic 配置文件名称，例如通过 ant auth login 或在没有 API 密钥的情况下登录 Console 账户创建的配置文件。请参阅身份验证优先级
ANTHROPIC_SMALL_FAST_MODEL [已弃用] 用于后台任务的 Haiku 级模型的名称
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION 在使用 Amazon Bedrock 或 Amazon Bedrock Mantle 时，覆盖 Haiku 级模型的 AWS 区域。在 Amazon Bedrock 上，仅当同时设置了 ANTHROPIC_DEFAULT_HAIKU_MODEL 或已弃用的 ANTHROPIC_SMALL_FAST_MODEL 时才会生效，因为否则 Amazon Bedrock 会在会话所在区域中使用默认 Sonnet 模型或主模型运行后台任务
ANTHROPIC_VERTEX_BASE_URL 覆盖 Google Cloud's Agent Platform 端点 URL。用于自定义 Google Cloud's Agent Platform 端点或通过 LLM 网关路由时。请参阅 Google Cloud's Agent Platform
ANTHROPIC_VERTEX_PROJECT_ID Google Cloud's Agent Platform 请求所指向的 GCP 项目 ID。请参阅配置 GCP 凭据
ANTHROPIC_WORKSPACE_ID 工作负载身份联合的工作区 ID。当您的联合规则作用于多个工作区时设置此变量，以便令牌交换知道要针对哪个工作区
API_FORCE_IDLE_TIMEOUT 覆盖 5 分钟的响应体空闲超时，该超时会在没有字节到达时中止流式模型响应。设置为 0 可关闭该超时，例如当速度较慢的网关或本地模型在数据块之间暂停超过 5 分钟时；设置为 1 则对所有提供商保持开启。未设置时，该超时在直接 Anthropic API、Claude Platform on AWS 以及设置了 CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 的 Amazon Bedrock 以外的提供商上生效。流式监视器独立于它运行，即使您在此处设置 0，它们也会中止长时间的静默暂停
API_TIMEOUT_MS API 请求的超时时间，以毫秒为单位（默认值：600000，即 10 分钟；最大值：2147483647）。当请求在慢速网络上超时或通过代理路由时，请增大此值。超过最大值的值会使底层计时器溢出，导致请求立即失败
AWS_BEARER_TOKEN_BEDROCK 用于身份验证的 Amazon Bedrock API 密钥（请参阅 Amazon Bedrock API 密钥）
BASH_DEFAULT_TIMEOUT_MS 前台 Bash 或 PowerShell 工具命令的默认超时时间，以毫秒为单位（默认值：120000，即 2 分钟）。超过 30 分钟的默认值也会成为无人值守会话中后台命令时间限制的默认值。后台时间限制需要 Claude Code v2.1.285 或更高版本
BASH_MAX_OUTPUT_LENGTH Claude Code 读回到命令结果中的 bash 输出的最大字符数（默认值：30000；最大值：150000）。如果您设置了 bashOutputMaxChars 设置，Claude Code 会忽略此变量。请参阅输出限制
BASH_MAX_TIMEOUT_MS 模型可以为前台 Bash 或 PowerShell 工具命令设置的最大超时时间，以毫秒为单位（默认值：600000，即 10 分钟）。有效上限为此值与 BASH_DEFAULT_TIMEOUT_MS 中的较大者。超过 2 小时的有效上限也会成为无人值守会话中后台命令时间限制的最大值。后台时间限制需要 Claude Code v2.1.285 或更高版本
BETA_TRACING_ENDPOINT 用于详细 beta 追踪的 OTLP 端点：设置 ENABLE_BETA_TRACING_DETAILED=1 后，日志和追踪数据会发送到该端点，而不是已配置的导出器。请在您的 shell、用户设置或托管设置中设置它。在项目设置和本地设置中会被忽略
CCR_FORCE_BUNDLE 设置为 1 可强制 claude --cloud 打包并上传您的本地仓库，而不是从其远程仓库克隆
CLAUDECODE 在 Claude Code 生成的子进程（Bash 和 PowerShell 工具、tmux 会话、hook 命令、状态栏命令、stdio MCP 服务器子进程）中设置为 1。IDE 扩展也会在其集成终端中设置此变量。用于检测脚本是否在 Claude Code 生成的子进程中运行。要检查当前进程是否由工具调用或 hook 直接生成，而不是在 Claude Code 启动的 stdio MCP 服务器内部运行，请改用 CLAUDE_CODE_CHILD_SESSION
CLAUDE_AFK_COUNTDOWN_MS 在未回答的 AskUserQuestion 对话框自动继续之前多少毫秒显示屏幕倒计时。默认 20000（20 秒），上限为自动继续超时时间。除非开启了自动继续，否则无效；请参阅 askUserQuestionTimeout 设置和 CLAUDE_AFK_TIMEOUT_MS。需要 Claude Code v2.1.198 或更高版本
CLAUDE_AFK_TIMEOUT_MS 空闲多少毫秒后，未回答的 AskUserQuestion 对话框会在没有您参与的情况下自动继续。自动继续默认关闭；可通过 askUserQuestionTimeout 设置选择启用。此变量是用于演示和自动化测试的覆盖项：设置后，它优先于该设置，即使该设置未设置或为 never，也会开启自动继续。设置 0 不会关闭超时，而是会立即关闭对话框。在 v2.1.198 和 v2.1.199 中，自动继续默认开启，超时时间为 60000（60 秒）。需要 Claude Code v2.1.198 或更高版本
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS 设置为 1 可禁用所有内置子代理类型，例如 Explore 和 Plan。仅适用于非交互模式（-p 标志）。适用于希望从空白状态开始的 SDK 用户。这也会移除 general-purpose，即当 Agent 工具调用省略 subagent_type 时 Claude Code 运行的子代理。此类调用随后会失败并显示 subagent_type is required
CLAUDE_AGENT_SDK_MCP_NO_PREFIX 设置为 1 可跳过 SDK 创建的 MCP 服务器中工具名称的 mcp__<server>__ 前缀。工具使用其原始名称。仅用于 SDK
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS 子代理的停滞超时时间，以毫秒为单位。默认 600000（10 分钟）；如果您在流式监视器开启时调高 CLAUDE_STREAM_IDLE_TIMEOUT_MS，默认值也会随之提高，如处理缓慢或停滞的 API 响应中所述。计时器在每个流式进度事件发生时重置；如果在该时间窗口内没有进度到达，Claude Code 会中止该子代理并向父级报告停滞
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 设置在自动压缩窗口的多少百分比（1-100）时触发自动压缩。使用较低的值（如 50）可更早压缩；该变量无法提高阈值，因此高于默认百分比的值会被忽略。它仅适用于在达到模型上下文限制之前压缩的会话。同时适用于主对话和子代理
CLAUDE_AUTO_BACKGROUND_TASKS 设置为 1 可强制启用长时间运行的 Agent 任务的自动后台化。启用后，子代理在运行约两分钟后会被移到后台。在 Claude Code v2.1.212 或更高版本上，还会在非交互模式下启用长时间 MCP 工具调用的自动后台化
CLAUDE_AX_PREPARK_MS 在屏幕阅读器模式下，Claude Code 在写入新行或已更改的行之前等待的毫秒数。默认 0，因此 Claude Code 不会等待。在 v2.1.287 之前，默认值为 50。Claude Code 将等待时间上限设为 5000。需要 Claude Code v2.1.233 或更高版本
CLAUDE_AX_SCREEN_READER 设置为 1 可渲染对屏幕阅读器友好的输出：不带装饰性边框或动画的纯文本。设置为 0 可强制关闭屏幕阅读器模式，即使 axScreenReader 为 true。--ax-screen-reader 标志优先。需要 Claude Code v2.1.181 或更高版本
CLAUDE_AX_STARTUP_QUIET_MS 在屏幕阅读器模式下，Claude Code 在启动确认行之后推迟首次界面渲染的毫秒数，以便您的屏幕阅读器能在新输出打断之前完整朗读该行。默认 3000。设置 0 可立即渲染。Claude Code 将推迟时间上限设为 600000（10 分钟）。您的第一次按键会提前结束推迟。需要 Claude Code v2.1.217 或更高版本
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR 在主会话中每次执行 Bash 或 PowerShell 命令后返回原始工作目录
CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS 字节级流式空闲监视器的超时时间，以毫秒为单位；设置后，对于该监视器，它优先于 CLAUDE_STREAM_IDLE_TIMEOUT_MS，且不改变事件级监视器。Claude Code 将此变量限制在 10 秒到 30 分钟之间。需要 Claude Code v2.1.210 或更高版本
CLAUDE_CLIENT_PRESENCE_FILE 一个文件的路径，该文件由外部工具（例如锁屏监听器）在您解锁屏幕时创建、在您锁定屏幕时删除。当该文件存在时，Claude Code 会跳过 Remote Control 移动推送通知，这样您在主动使用计算机时就不会再收到推送。当该文件不存在或不可读时，通知照常发送。Claude Code 在每个触发推送的事件发生时检查一次该文件，而不是轮询它。需要 Claude Code v2.1.181 或更高版本
CLAUDE_CODE_ACCESSIBILITY 设置为 1 可保持原生终端光标可见，并禁用反色文本光标指示器。使 macOS 缩放等屏幕放大器能够跟踪光标位置
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD 设置为 1 可从通过 --add-dir 指定的目录加载记忆文件。加载 CLAUDE.md、.claude/CLAUDE.md、.claude/rules/*.md 和 CLAUDE.local.md。默认情况下，附加目录不会加载记忆文件
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT 设置为 1 可在全屏渲染中每一帧都重绘整个屏幕，而不是发送增量更新。如果全屏模式显示过时或错位的文本片段，请使用此选项。Claude Code 会在 Windows 上为后台会话和 Agent 视图自动启用此选项
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT 设置为 1 可在每个请求中发送 effort 参数，即使 Claude Code 不认为该模型 ID 支持 effort。在通过 LLM 网关或以自定义标识符提供模型的第三方提供商路由时使用。在 API 层面拒绝 effort 参数的模型（包括 Claude 3 模型、Sonnet 4.0 和 4.5、Opus 4.0 和 4.1 以及 Haiku 4.5）仍会被排除，以免请求失败
CLAUDE_CODE_API_KEY_HELPER_TTL_MS 刷新凭据的时间间隔，以毫秒为单位（使用 apiKeyHelper 时）
CLAUDE_CODE_ARTIFACT_AUTO_OPEN 设置为 0 可阻止 Claude Code 在发布新的 Artifact 时自动打开浏览器
CLAUDE_CODE_ARTIFACT_COMMENTS 设置为 0 可阻止 Claude 读取和回复 Artifact 上的评论。当 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 已关闭 Artifact 时无效。需要 Claude Code v2.1.221 或更高版本
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT 设置为 0 可阻止 Claude 自行回复发送给它的评论。需要 Claude Code v2.1.228 或更高版本
CLAUDE_CODE_ATTRIBUTION_HEADER 设置为 0 可从系统提示词开头省略归属块，该块包含客户端版本和提示词指纹。无论哪种方式，直接连接到 Anthropic API 时的缓存都不受影响。在某些直接连接设置中，即使您设置了 0，Claude Code 也会在自动模式分类器请求中保留该块。请在系统提示词归属块中查看这涵盖了哪些连接和凭据。在 v2.1.181 之前，该块在自定义基础 URL 和 Microsoft Foundry 连接上包含每个请求各不相同的 token，因此在这些版本上，当您的 LLM 网关基于请求体进行缓存或将请求转发给第三方提供商时，或者当您直接连接到 Microsoft Foundry 时，请将其设置为 0
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS 当启用 CLAUDE_AUTO_BACKGROUND_TASKS 时，提醒 Claude 检查仍在运行的后台子代理的间隔秒数。仅接受 1 到 86400 之间的普通整数；任何其他值或写法都视为未设置。未设置时，不会发出检查提醒。需要 Claude Code v2.1.248 或更高版本
CLAUDE_CODE_AUTO_COMPACT_WINDOW 以 token 为单位设置自动压缩窗口，范围为 100000 到 1000000。仅接受普通整数，例如 500000：像 500k 这样的值会被读取为 500，并被限制到 100K 的最小值。有效窗口还受模型上下文窗口的限制。优先于 /autocompact 命令、--autocompact 标志和 autoCompactWindow 设置。状态栏的 used_percentage 始终以模型的完整上下文窗口为基准进行衡量，因此一旦设置了此变量，该百分比将不再指示何时运行压缩
CLAUDE_CODE_AUTO_CONNECT_IDE 覆盖自动 IDE 连接。默认情况下，在受支持 IDE 的集成终端中启动时，Claude Code 会自动连接。设置为 false 可阻止此行为。设置为 true 可在自动检测失败时（例如 tmux 遮蔽了父终端时）强制尝试连接。优先于 autoConnectIde 全局配置设置
CLAUDE_CODE_AUTO_MODE_SERVER 控制 Claude Code 是否请求服务器审查自动模式操作。设置为 0 可改用 Claude Code 自己的分类器请求。在直接连接到 Anthropic API 时，需要 v2.1.281 或更高版本。链接的章节列出了在未设置该变量时哪些会话会请求服务器，以及从哪个版本开始。需要 Claude Code v2.1.271 或更高版本
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS Claude Code 等待 AWS 默认凭据提供程序链生成凭据的时间，以毫秒为单位，超时后请求会失败并显示 AWS default-chain credential resolve timed out（默认值：60000）。当链中的某个步骤确实需要更长时间时（例如通过 aws-vault 等包装器进行的带 MFA 的基于浏览器的 SSO 登录），请调高此值。适用于 Claude Code 使用默认链签名的所有场景：Amazon Bedrock、Claude Platform on AWS 和 Mantle 端点。需要 Claude Code v2.1.207 或更高版本
CLAUDE_CODE_BASH_EDIT_DIFF 设置为 0 可关闭 Bash 命令运行期间所更改文件的 diff，设置为 1 可在每种权限模式下记录它。优先于 bashEditDiffEnabled 设置。需要 Claude Code v2.1.269 或更高版本
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING 设置为 0 可使非交互会话在每个轮次结束时向其宿主报告空闲状态，即使后台工作仍在运行。默认情况下，当后台 Agent 或工作流运行等后台工作仍处于活动状态时，会话在轮次结束后会继续报告运行状态。这可以防止监视该状态的宿主（例如远程会话列表）在工作进行中宣布 Claude 正在等待您的输入。后台 shell 命令（例如开发服务器）不会保持运行状态。运行状态默认行为和 0 选择退出需要 Claude Code v2.1.269 或更高版本；在更早的版本上，设置 1 可保持运行状态
CLAUDE_CODE_BRIDGE_SESSION_ID 当会话有活动的 Remote Control 连接时，在 Bash 工具和 hook 命令子进程中自动设置，并在连接结束时移除。该值是 session_ 形式的会话 ID，与会话的 claude.ai/code URL 中出现的标识符相同，因此脚本可以链接回运行它的会话。需要 Claude Code v2.1.199 或更高版本。在云端会话中，请改为读取 CLAUDE_CODE_REMOTE_SESSION_ID
CLAUDE_CODE_BS_AS_CTRL_BACKSPACE 设置为 0 可使 Claude Code 将 0x08 字节（也写作 ^H）读取为普通 Backspace，设置为 1 则将其读取为 Ctrl+Backspace。任一值都会替换平台默认值。默认情况下，Claude Code 在 Windows 上将其读取为 Ctrl+Backspace（TERM_PROGRAM 为 mintty 或 TERM 为 cygwin 时除外），在 macOS 和 Linux 上将其读取为普通 Backspace。在 Backspace 会删除整个单词的 Windows 终端中请设置 0
CLAUDE_CODE_CERT_STORE 用于 TLS 连接的 CA 证书来源的逗号分隔列表。bundled 是随 Claude Code 提供的 Mozilla CA 集。system 是操作系统信任存储，仅在具有 tls.getCACertificates 的运行时上读取：原生二进制文件，或 npm 安装时的 Node 22.15 或更高版本。请参阅 CA 证书存储。默认值为 bundled,system
CLAUDE_CODE_CHILD_SESSION 在 Claude Code 通过 Bash、PowerShell 和 Monitor 工具、hook 命令以及状态栏命令生成的子进程中设置为 1。不会为 stdio MCP 服务器子进程设置，因为它们是长期运行的，生命周期比生成它们的会话更长。与 CLAUDECODE 不同，此变量仅由 Claude Code 本身在启动子进程时设置，而不会由 IDE 扩展设置，因此它能可靠地区分嵌套会话与在 IDE 集成终端中启动的顶层 claude。以这种方式启动的嵌套交互式 claude TUI 会被自动排除在 --resume、--continue、上箭头历史记录和 claude agents 列表之外。非交互式 claude -p 会话仍会持久保存。设置 CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 可覆盖此排除。需要 Claude Code v2.1.172 或更高版本
CLAUDE_CODE_CLIENT_CERT 用于 mTLS 身份验证的客户端证书文件路径
CLAUDE_CODE_CLIENT_KEY 用于 mTLS 身份验证的客户端私钥文件路径
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE 加密的 CLAUDE_CODE_CLIENT_KEY 的密码（可选）
CLAUDE_CODE_CONNECT_TIMEOUT_MS 已在 v2.1.186 中移除，现在不起任何作用。之前用于为流式 API 请求的连接、TLS 和响应标头阶段设置单独的超时时间。请使用 API_TIMEOUT_MS 设置每个请求的超时时间。对于流式请求的响应标头阶段，请参阅 CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS
CLAUDE_CODE_DEBUG_LOGS_DIR 覆盖调试日志文件路径。尽管名称如此，但这是一个文件路径，而不是目录。需要通过 --debug、/debug 或 DEBUG 环境变量单独启用调试模式：仅设置此变量不会启用日志记录。--debug-file 标志可同时完成这两项。默认为 ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVEL 写入调试日志文件的最低日志级别。可选值：verbose、debug（默认）、info、warn、error。设置为 verbose 可包含大量诊断信息（例如完整的状态栏命令输出），或提高到 error 以减少干扰信息
CLAUDE_CODE_DISABLE_1M_CONTEXT 设置为 1 可禁用 1M 上下文窗口支持。设置后，1M 模型变体在模型选择器中不可用，并且Claude Code 会将使用原生 1M 窗口的模型（例如 Sonnet 5.5 和 Fable 模型）上的会话限制在 200K 窗口；有关如何强制执行此限制，请参阅扩展上下文。适用于有合规要求的企业环境。关于它在为无法识别的 [1m] 模型 ID 修正窗口方面的作用，请参阅为网关或自定义模型 ID 修正窗口
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 设置为 1 可在 Opus 4.6 和 Sonnet 4.6 上禁用自适应推理，并回退到由 MAX_THINKING_TOKENS 控制的固定思考预算。对 Fable 模型、Sonnet 5 及更高版本或 Opus 4.7 及更高版本无效，这些模型始终使用自适应推理
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION 设置为 1 可阻止 Claude Code 跨管理员来源按键合并托管设置的 env 块，从而仅应用最高优先级来源的整个 env 块，与 v2.1.223 之前相同。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略通过设置 env 块下发的副本。需要 Claude Code v2.1.223 或更高版本
CLAUDE_CODE_DISABLE_ADVISOR_TOOL 设置为 1 可禁用 advisor 工具。/advisor 命令将不可用，任何已配置的 advisorModel 都会被忽略，--advisor 标志会被接受但不起作用，因此传递该标志的现有脚本可以继续正常运行而不会出错
CLAUDE_CODE_DISABLE_AGENT_VIEW 设置为 1 可关闭后台 Agent 和 Agent 视图：claude agents、--bg、/background 以及按需启动的监管进程。等同于 disableAgentView 设置
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN 设置为 1 可禁用全屏渲染并使用经典的主屏幕渲染器。对话保留在终端的原生回滚缓冲区中，因此 Cmd+f 和 tmux 复制模式照常工作。优先于 CLAUDE_CODE_NO_FLICKER 和 tui 设置。您也可以使用 /tui default 切换。不适用于从 Agent 视图打开的后台会话，这些会话始终使用全屏渲染
CLAUDE_CODE_DISABLE_ARTIFACT 设置为 1 可关闭 Artifact 工具，该工具会将会话输出作为私有网页发布到 claude.ai 上。设置后，任何设置文件都无法重新开启该工具。要改为通过设置文件关闭该工具，请将 enableArtifact 设置为 false；已弃用的 disableArtifact 键也可以将其关闭
CLAUDE_CODE_DISABLE_ATTACHMENTS 设置为 1 可禁用附件处理。使用 @ 语法的文件提及将作为纯文本发送，而不会展开为文件内容
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK 设置为 1 可使 Claude Code 进程自行运行其 gcpAuthRefresh 或 awsAuthRefresh 命令，而不是在另一个进程运行该命令时等待。需要 Claude Code v2.1.286 或更高版本
CLAUDE_CODE_DISABLE_AUTO_MEMORY 设置为 1 可禁用自动记忆。设置为 0 可强制开启自动记忆，即使 --bare 模式或 autoMemoryEnabled: false 原本会将其禁用。禁用后，Claude 不会创建或加载自动记忆文件
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 设置为 1 可禁用所有后台任务功能，包括 Bash 和子代理工具上的 run_in_background 参数、自动后台化以及 Ctrl+B 快捷键
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT 设置为 1 可阻止 Claude Code 将缺少 Content-Type 标头或该标头为空的 Amazon Bedrock 流式响应视为 Amazon Bedrock 的二进制事件流。默认情况下，Claude Code 假定网关从原本未经修改的响应中删除了该标头，因此它会解码响应体，流式输出可继续正常工作。仅当网关还会将流重新以服务器发送事件的形式发出时才设置此变量；此时 Claude Code 会将不带该标头的响应体作为服务器发送事件读取。需要 Claude Code v2.1.239 或更高版本
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD 设置为 1 可跳过对 Amazon Bedrock 流式响应是否带有 application/vnd.amazon.eventstream content-type 的检查。如果未设置此变量，当响应带有不同的 content-type 时，Claude Code 会使请求失败，并显示指出该类型的错误，这意味着网关或代理正在转换响应。请将网关配置为原样转发 Content-Type 标头和响应体，而不是设置此变量。需要 Claude Code v2.1.208 或更高版本
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF 设置为 1 可在监管进程停止、重启或更新后台会话的进程时，停止该会话中正在运行的后台 shell 命令、动态工作流以及（从 v2.1.198 起）后台子代理，而不是将它们移交给该会话的下一个进程。仅影响该移交：使用 ← 或 /background 将会话转入后台时，仍会延续进行中的工作，而 CLAUDE_DISABLE_ADOPT 会同时关闭这两者。需要 Claude Code v2.1.196 或更高版本
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP 设置为 1 可阻止 Claude Code 在内存压力下终止后台 shell 命令。默认情况下，在 macOS 和 Linux 上，当操作系统报告严重内存压力，且会话已空闲 30 分钟、没有轮次或子代理在运行时，Claude Code 会终止后台 shell。Windows 没有内存压力信号，因此此变量在该平台上无效。需要 Claude Code v2.1.193 或更高版本
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS 设置为 1 可禁用 Claude Code 附带的 skill 和工作流：随附 skill 和工作流会被完全移除，而 /init 等内置命令仍可输入，但对模型隐藏。/doctor 与内置命令一样仍可输入；请改用 DISABLE_DOCTOR_COMMAND 将其隐藏。来自插件、.claude/skills/ 和 .claude/commands/ 的 skill 不受影响。等同于 disableBundledSkills 设置
CLAUDE_CODE_DISABLE_CFC_PROMPT 设置为 1 可保留 Claude in Chrome 浏览器工具，同时省略系统提示词中的 Chrome 部分和 /claude-in-chrome 随附 skill。适用于嵌入 Claude Code 并提供自己的浏览器指引的宿主。需要 Claude Code v2.1.257 或更高版本
CLAUDE_CODE_DISABLE_CLAUDE_MDS 设置为 1 可阻止将任何 CLAUDE.md 记忆文件加载到上下文中，包括用户、项目和自动记忆文件
CLAUDE_CODE_DISABLE_CRON 设置为 1 可禁用定时任务。/loop skill 和 cron 工具将不可用，所有已安排的任务都会停止触发，包括会话中途已在运行的任务
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT 设置为 1 可关闭关键路径删除提示的时间限制。此后在 auto 模式下，Claude Code 会改为将这些删除操作发送给分类器，而在 bypassPermissions 模式下，该提示会一直等待您的回答。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略通过设置 env 块下发的副本。需要 Claude Code v2.1.281 或更高版本
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 设置为 1 可从 API 请求中移除预发布的 anthropic-beta 请求标头、与之配对的请求体字段，以及 defer_loading 和 eager_input_streaming 等 beta 工具 schema 字段。当代理网关因 anthropic-beta 标头以 Unexpected value(s) 错误拒绝请求，或返回 Extra inputs are not permitted 错误时，请使用此变量。禁用预发布功能列出了该变量移除的内容（包括 MCP 工具搜索），以及 Claude Code 仍会发送的内容
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS 设置为 1 可禁用内置的 Explore 和 Plan 子代理。Claude 会改用其搜索工具或通用子代理进行探索，并且计划模式会直接读取文件，而不是启动 Explore 和 Plan Agent。名为 Explore 或 Plan 的自定义子代理不受影响。要在 Agent SDK 或非交互模式下移除所有内置子代理类型，请改用 CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS。需要 Claude Code v2.1.198 或更高版本
CLAUDE_CODE_DISABLE_FAST_MODE 设置为 1 可禁用快速模式
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY 设置为 1 可禁用“How is Claude doing?”会话质量调查。当设置了 DISABLE_TELEMETRY、DO_NOT_TRACK 或 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 时，调查也会被禁用，除非 CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL 重新选择加入。要设置采样率而不是直接禁用，请使用 feedbackSurveyRate 设置。请参阅会话质量调查
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING 设置为 1 可禁用文件检查点功能。/rewind 命令将无法恢复代码更改。覆盖 fileCheckpointingEnabled 设置
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 设置为 1 可从 Claude 的上下文中移除内置的提交和 PR 工作流指令以及 git 状态快照。在使用您自己的 git 工作流 skill 时很有用。设置后优先于 includeGitInstructions 设置
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP 设置为 1 可阻止在 Anthropic API 上将 Opus 4.0 和 4.1 自动重新映射到当前 Opus 版本。当您有意固定使用较旧的模型时使用。该重新映射不会在 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 上运行
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK 设置为 1 可阻止 Amazon Bedrock 和 Google Cloud's Agent Platform 上的 Claude Code 在您的账户于会话中途失去对会话模型的访问权限时切换到较旧的模型；被拒绝的请求会立即失败。您配置的备用模型链在遇到该拒绝时仍会切换，并且启动时的模型检查在启动时仍会回退。需要 Claude Code v2.1.285 或更高版本
CLAUDE_CODE_DISABLE_MOUSE 设置为 1 可在全屏渲染中禁用鼠标跟踪。使用 PgUp 和 PgDn 的键盘滚动仍然有效。使用此选项可保留终端原生的选中即复制行为
CLAUDE_CODE_DISABLE_MOUSE_CLICKS 设置为 1 可在全屏渲染中禁用点击、拖动和悬停处理，同时保留鼠标滚轮滚动。当您希望滚轮滚动在 Claude Code 中正常工作，但不希望点击定位光标、展开工具输出或打开链接时使用。两者都设置时，CLAUDE_CODE_DISABLE_MOUSE 优先。需要 Claude Code v2.1.195 或更高版本
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION 设置为 1 可阻止 Claude Code 在 API 请求因连接级错误（例如连接重置或 TLS 握手错误）失败时重新读取 mTLS 客户端证书和密钥。禁用重新加载后，Claude Code 仅在下次应用设置时或下次启动时加载轮换后的文件。需要 Claude Code v2.1.232 或更高版本
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 设置为任何非空值（例如 1）可禁用非必要的网络流量：自动更新、遥测、错误报告、/feedback 命令、Claude 起草的反馈、发行说明、PR 和 MR 状态徽章检查，以及诸如快速模式检查之类的可用性检查。它还会停止插件 command 来源的后台运行，这些是本地命令而非网络流量，但由于它们可能触发依赖安装，因此也会被停止。将其设置为 0 或 false 仍会禁用此流量，这与大多数开关变量不同；取消设置该变量才能重新允许此流量。还会禁用功能标志获取，这会使 Remote Control 和其他需要获取功能标志的功能不可用。官方插件市场自动安装不在此范围内；请使用 CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL 将其禁用。不影响网关模型发现，后者有自己的选择加入方式
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK 设置为 1 可在流式请求中途失败时禁用非流式回退。流式错误会改为传递到重试层。当代理或网关导致回退产生重复的工具执行时很有用
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK 设置为 1 可在您正在终端中输入或终端处于焦点时仍发送 PushNotification 工具的桌面通知。默认情况下，当该工具检测到近期的键盘活动或终端焦点时，会同时跳过桌面通知和移动推送。此变量仅禁用该本地检查，因此当服务器检测到您处于活动状态时，仍可能抑制移动推送。需要 Claude Code v2.1.193 或更高版本
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL 设置为 1 可禁用官方插件市场的自动注册。Claude Code 会在即将注册该市场时读取此变量，通常是在计算机首次交互式启动期间。如果此时已设置该变量，Claude Code 会永久跳过注册。之后取消设置该变量不会撤销该跳过。随时运行 claude plugin marketplace add anthropics/claude-plugins-official 即可注册该市场
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS 设置为 1 可在 Claude Code 将权限请求发送给 Agent SDK 的 canUseTool 回调的会话中（Claude Desktop 和 VS Code 扩展正是以这种方式托管 Claude Code），阻止 Claude Code 运行您的针对未回答权限请求的 Notification hook。在终端会话中无效。需要 Claude Code v2.1.233 或更高版本
CLAUDE_CODE_DISABLE_POLICY_SKILLS 设置为 1 可跳过从系统范围的托管 skill 目录加载 skill。适用于不应加载运维人员预置 skill 的容器或 CI 会话
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY 设置为 1 可关闭 PowerShell 工具的一项检查，该检查会拒绝在系统路径（例如驱动器根目录或您的主目录）上使用 cmd 内置命令 rd、rmdir、del 和 erase。Claude Code 会忽略设置文件 env 块中的此变量。需要 Claude Code v2.1.283 或更高版本
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS 设置为 1 可阻止 Claude Code 发送结构化输出的 output_config.format 字段以及与之配对的 anthropic-beta 值，适用于上游会拒绝它们的 LLM 网关。这会保留 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 会关闭的其他预发布功能。需要 Claude Code v2.1.288 或更高版本
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT 设置为 1 可关闭针对目标完全由命令替换输出构成的递归 rm（例如 rm -rf "$(pwd)"）的关键路径检查。其他关键路径检查仍会运行。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略通过设置 env 块下发的副本。需要 Claude Code v2.1.281 或更高版本
CLAUDE_CODE_DISABLE_TERMINAL_TITLE 设置为 1 可禁用基于对话上下文的自动终端标题更新。这也会跳过用于生成会话标题的后台小型/快速模型请求
CLAUDE_CODE_DISABLE_THINKING 设置为 1 可从 API 请求中完全省略 thinking 参数。这是针对会拒绝该参数的代理和网关的兼容性选项。在默认进行思考的模型上，省略该参数意味着模型仍可能进行思考。要在 Anthropic API 上显式禁用扩展思考，请改用 MAX_THINKING_TOKENS=0。这两个变量都无法在 Opus 5.5、Sonnet 5.5 或 Fable 模型上关闭思考，因为这些模型的思考无法关闭。在第三方提供商上，MAX_THINKING_TOKENS=0 同样会省略该参数，因此这两个变量在那里的行为相同
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT 设置为 1 可在 Claude Code 无法识别模型 ID（例如 LLM 网关别名）时跳过主动自动压缩。如果未设置此变量，Claude Code 会在其为该 ID 假定的上下文窗口处进行压缩。CLAUDE_CODE_MAX_CONTEXT_TOKENS 可以改为修正假定的窗口；有关各变量的适用情况，请参阅为网关或自定义模型 ID 修正窗口。需要 Claude Code v2.1.223 或更高版本
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL 设置为 1 可在全屏渲染中禁用虚拟滚动并渲染会话记录中的每条消息。如果在全屏模式下滚动时，本应显示消息的位置出现空白区域，请使用此选项
CLAUDE_CODE_DISABLE_WEB_FETCH 设置为 1 可关闭 WebFetch 工具。WebSearch 工具仍然可用。需要 Claude Code v2.1.285 或更高版本
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER 设置为 1 可在 Windows 上直接启动 PowerShell 工具命令，而不是通过 cmd.exe 启动器。默认情况下，该启动器允许在后台运行的 PowerShell 命令延续到会话的下一个进程，例如当您将会话转入后台时。如果设置了该变量，后台 PowerShell 命令会在会话进程退出时停止。Bash 命令不受影响。需要 Claude Code v2.1.269 或更高版本
CLAUDE_CODE_DISABLE_WORKFLOWS 设置为 1 可禁用工作流。等同于 disableWorkflows 设置
CLAUDE_CODE_EFFORT_LEVEL 为受支持的模型设置 effort 级别。可选值：low、medium、high、xhigh、max，或 auto 以使用模型默认值。可用级别取决于模型。优先于 --effort、/effort 以及 modelSettings 和 effortLevel 设置。maxEffortLevel 上限仍然适用。请参阅调整 effort 级别
CLAUDE_CODE_ENABLE_AUTO_MODE 为兼容旧版本而接受，不起任何作用。自动模式默认在所有提供商上可用，包括 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry 以及已登录的 Claude apps gateway 会话。在 v2.1.158 到 v2.1.206 中，需要将其设置为 1 才能在这些提供商上使用自动模式
CLAUDE_CODE_ENABLE_AWAY_SUMMARY 覆盖会话回顾的可用性。设置为 0 可强制关闭回顾，无论 /config 开关如何设置。设置为 1 可在 awaySummaryEnabled 为 false 时强制开启回顾。优先于该设置和 /config 开关
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH 设置为 1 可在非交互模式下，于后台安装完成后在轮次边界刷新插件状态。默认关闭，因为刷新会在会话中途更改系统提示词，从而使该轮次的提示缓存失效
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL 设置为 1 可在发往 Anthropic 的非必要流量被阻止时，将“How is Claude doing?”会话质量调查路由到您自己的 OpenTelemetry 收集器。调查评分仅作为 OTEL 事件发送到您配置的收集器。在此模式下，不会向 Anthropic 发送任何调查数据。在设置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、DISABLE_TELEMETRY 或 DO_NOT_TRACK 时适用，否则无效。CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY 和组织产品反馈策略优先
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING 控制工具调用输入是否在 Claude 生成时从 API 流式传输。关闭此项时，大型工具输入（例如长文件写入）只有在 Claude 完成生成后才会到达，看起来可能像是卡住了。在 Anthropic API 上默认启用。在 Amazon Bedrock 和 Google Cloud's Agent Platform 上，在所部署的容器支持时按模型启用。设置为 0 可选择退出。通过 ANTHROPIC_BASE_URL、ANTHROPIC_VERTEX_BASE_URL 或 ANTHROPIC_BEDROCK_BASE_URL 经由代理路由时，设置为 1 可强制启用。在 Microsoft Foundry 和网关连接上默认关闭
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 设置为 1 可在 ANTHROPIC_BASE_URL 指向与 Anthropic 兼容的网关（例如 LiteLLM、Kong 或内部代理）时，从网关的 /v1/models 端点填充 /model 选择器。默认关闭，因为否则由共享 API 密钥支持的网关会向每个用户显示该密钥可访问的所有模型。发现的模型仍会按会话收到的 availableModels 允许列表进行过滤；请通过 MDM 或托管设置文件下发该列表，因为服务器托管的下发方式在网关配置上不可用
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE 已在 v2.1.142 中移除，当时快速模式的默认模型从 Opus 4.6 改为 Opus 4.7
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION 设置为 false 可关闭提示词建议，即出现在输入框中的灰色预测内容。优先于 promptSuggestionEnabled 设置，/config 中的 Prompt suggestions 开关写入的正是该设置。当您的账户接近或达到用量限制时，Claude Code 还会暂停建议。设置为 true 可使建议保持开启，直到您达到限制。需要 Claude Code v2.1.238 或更高版本。请参阅提示词建议
CLAUDE_CODE_ENABLE_TASKS 选择 Claude Code 在具备任务跟踪工具的会话中提供哪些任务跟踪工具。默认情况下，Claude Code 提供 Task 工具 TaskCreate、TaskUpdate、TaskGet 和 TaskList。设置为 0 可改为使用旧版 TodoWrite 工具。请参阅任务列表
CLAUDE_CODE_ENABLE_TELEMETRY 设置为 1 可为指标和日志启用 OpenTelemetry 数据收集。配置 OTel 导出器之前必须设置。请在 shell、用户设置或托管设置中设置。在项目设置和本地设置中会被忽略。请参阅监控
CLAUDE_CODE_ENABLE_TODO_TOOLS 设置为 1 可在所有模型上获得任务跟踪工具。未设置时，Claude Code 默认仅在 Task 工具可用性下列出的模型上提供这些工具。CLAUDE_CODE_ENABLE_TASKS 仍决定使用 Task 工具还是 TodoWrite。需要 Claude Code v2.1.233 或更高版本
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY 查询循环变为空闲后，自动退出前等待的时间（毫秒）。适用于使用 SDK 模式的自动化工作流和脚本
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 设置为 1 可启用 agent team。agent team 为实验性功能，默认禁用
CLAUDE_CODE_EXTRA_BODY 要合并到每个 API 请求体顶层的 JSON 对象。适用于传递 Claude Code 未直接公开的特定于提供商的参数。在 shell 中导出的值也适用于您通过 claude agents 或 --bg 派发的后台会话。在 v2.1.206 之前，后台会话会忽略 shell 导出的值，而使用后台监管进程所继承的任意副本
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS 覆盖文件读取的默认 token 限制。当您需要完整读取较大文件时很有用
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE 设置为 1 可强制启用会话记录持久化、提示词历史记录和 claude agents 注册，即使此 claude 是从另一个 Claude Code 会话内部启动的。当继承的 CLAUDE_CODE_CHILD_SESSION 值（例如来自 screen 会话，或最初由 Claude Code 的 Bash 工具启动的后台启动器）导致真正的顶层会话被误判为嵌套会话时使用。从 v2.1.178 起，Claude Code 会自动检测 tmux 的情况并忽略继承的标记，因此 tmux 不再需要此变量。在 v2.1.169 及更早版本中同样有效；在 v2.1.170 和 v2.1.171 中无效，因为这两个版本移除了它所覆盖的嵌套会话检测
CLAUDE_CODE_FORCE_STRIKETHROUGH 设置为 1 可在终端支持删除线但未被自动检测到时（例如通过 SSH 且未转发 TERM_PROGRAM），强制将 Claude 回复中的 ~~text~~ 渲染为删除线。否则，未被检测到的终端会显示字面的 ~~ 标记，而不是将文本渲染为删除线。需要 Claude Code v2.1.186 或更高版本
CLAUDE_CODE_FORCE_SYNC_OUTPUT 设置为 1 可在终端支持但未被自动检测到时，强制启用 DEC 私有模式 2026 同步输出。适用于实现了 BSU/ESU 但不响应能力探测的模拟器，例如 Emacs eat。在 tmux 下无效。与切换到全屏渲染的 CLAUDE_CODE_NO_FLICKER 不同，此变量不会更改渲染器
CLAUDE_CODE_FORK_SUBAGENT 控制分叉模式，该模式允许 Claude 自行生成分叉子代理，默认仅在交互式会话中开启。设置为 1 可在 claude -p 和 Agent SDK 中也开启，设置为 0 可在所有类型的会话中关闭。无论分叉模式是否开启，您都可以运行 /subtask。交互式会话中的默认开启需要 Claude Code v2.1.232 或更高版本；在更早的版本中，请将该变量设置为 1 以开启分叉模式
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT 设置为 1 可在 claude -p --output-format stream-json 输出中输出子代理的文本和思考块，行为与 --forward-subagent-text 标志相同。当某个 harness 调用 claude 且无法自行传递该标志时，请使用此变量。该标志在使用 stream-json 输出的非交互模式之外会报错退出，而此变量在这些场景下会被忽略，因此在进程范围内设置该变量时，嵌套调用仍能正常工作。需要 Claude Code v2.1.211 或更高版本
CLAUDE_CODE_GATEWAY_HINT_HEADERS 设置为 1 可在自定义代理或第三方提供商（例如 Amazon Bedrock 或 Claude Platform on AWS）上发送网关提示标头，例如 x-claude-code-request-class 和 x-claude-code-compaction。设置为 0 可在所有连接上停止发送，包括直接连接到 Anthropic API 的情况（Claude Code 默认在这种情况下发送）。需要 Claude Code v2.1.273 或更高版本
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS 由 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 启用的网关模型发现请求的超时时间（毫秒）（默认：3000）。当您的网关在启动时需要超过三秒才能响应 /v1/models 时，请调高此值。仅接受纯数字；0、负值及其他写法都会保留默认值。需要 Claude Code v2.1.269 或更高版本
CLAUDE_CODE_GIT_BASH_PATH 仅限 Windows：Git Bash 可执行文件（bash.exe）的路径。在已安装 Git Bash 但其不在 PATH 中时使用。如果该路径不存在，或文件名不是 bash.exe、sh.exe、bash 或 sh，Claude Code 会忽略该变量，像未设置一样自动检测 Git Bash，并记录一条可通过 --debug 查看的警告。在 v2.1.219 之前，路径不存在时 Claude Code 会在启动时退出，并且会将任何现有文件用作 shell，而不检查它是否为 bash 或 sh。请参阅在 Windows 上设置
CLAUDE_CODE_GLOB_HIDDEN 设置为 false 可在 Claude 调用 Glob 工具时从结果中排除点文件。默认包含。不影响 @ 文件自动补全、ls、Grep 或 Read
CLAUDE_CODE_GLOB_NO_IGNORE 设置为 false 可使 Glob 工具遵循 .gitignore 模式。默认情况下，Glob 会返回所有匹配的文件，包括被 gitignore 忽略的文件。不影响 @ 文件自动补全，后者有其自己的 respectGitignore 设置
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS Glob 工具文件发现的超时时间（秒）。在大多数平台上默认为 20 秒，在 WSL 上默认为 60 秒
CLAUDE_CODE_GOAL_CHECKIN_MINUTES 后台工作可使活动目标保持等待的分钟数，超过后 Claude Code 会请 Claude 检查该目标。默认 30。设置为 0 可关闭检查。请以纯数字给出整分钟数，最大为 10080，即一周。Claude Code 会将任何其他值视为未设置并使用默认值。需要 Claude Code v2.1.234 或更高版本
CLAUDE_CODE_HIDE_CWD 设置为 1 可在启动徽标中隐藏工作目录。适用于屏幕共享或录屏等路径会暴露您操作系统用户名的场景
CLAUDE_CODE_IDE_HOST_OVERRIDE 覆盖用于连接 IDE 扩展的主机地址。默认情况下，Claude Code 会自动检测正确的地址，包括 WSL 到 Windows 的路由
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL 设置为 1 可跳过 IDE 扩展的自动安装。等同于将 autoInstallIdeExtension 设置为 false
CLAUDE_CODE_IDE_SKIP_VALID_CHECK 设置为 1 可在连接期间跳过对 IDE 锁文件条目的验证。当 IDE 正在运行但自动连接仍找不到它时使用
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS 一个会话中可同时运行的子代理数量，达到后 Agent 工具将拒绝再生成新的子代理（默认：20）。接受以纯数字表示的正整数；其他任何值都会被忽略，因此该变量可以调整上限，但无法禁用上限。需要 Claude Code v2.1.217 或更高版本
CLAUDE_CODE_MAX_CONTEXT_TOKENS 覆盖 Claude Code 为当前模型假定的上下文窗口大小。从 v2.1.193 起，其应用方式取决于 Claude Code 如何解析模型 ID；请参阅为网关或自定义模型 ID 更正窗口。当通过 ANTHROPIC_BASE_URL 路由到某个模型，而该模型的上下文窗口与其名称对应的内置大小不一致时使用
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH Claude Code 发送给模型的每个 MCP 工具描述和每个 MCP 服务器指令的最大长度（字符数）（默认：2048）。Claude Code 会截断更长的文本。接受以纯数字表示的正整数。其他任何值都会被忽略并使用默认值。需要 Claude Code v2.1.280 或更高版本
CLAUDE_CODE_MAX_OUTPUT_TOKENS 设置大多数请求的最大输出 token 数。默认值和上限因模型而异；请参阅最大输出 token。Claude Code 会将超过模型上限的值降至该上限。对于 Claude Code 无法解析为已知模型的模型 ID，默认值为 32000，上限为 128000。增大此值会减少触发自动压缩之前可用的有效上下文窗口
CLAUDE_CODE_MAX_RETRIES 覆盖失败 API 请求的重试次数（默认：10）。从 v2.1.186 起上限为 15；从 v2.1.199 起，CLAUDE_CODE_RETRY_WATCHDOG 会提高默认值并移除上限。对于需要在较长中断期间持续等待的无人值守会话，请改为设置 CLAUDE_CODE_RETRY_WATCHDOG
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION 已在 v2.1.224 中移除，现在不起作用。此前用于限制 Claude 在一个会话中可通过 Agent 工具生成的子代理总数（默认：200）；超出上限时生成会失败并显示 Subagent spawn limit reached。并发子代理限制和深度限制仍然适用
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 主对话之下允许的子代理层数（默认：3）。在默认值下，子代理可以生成自己的子代理，而位于第三层的子代理无法继续生成；设置为 1 可关闭嵌套。在 v2.1.217 至 v2.1.218 中，默认值为 1，因此除非您提高该限制，否则子代理无法生成自己的子代理；v2.1.219 将默认值提高到 3。接受以纯数字表示的正整数；其他任何值都会被忽略，因此该限制可以调整但无法移除。需要 Claude Code v2.1.217 或更高版本
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY 可并行执行的只读工具和子代理的最大数量（默认：10）。较高的值会提高并行度，但会消耗更多资源
CLAUDE_CODE_MAX_TURNS 在未传递显式限制时限制 agentic 轮次数。等同于传递 --max-turns，两者都设置时后者优先。非正整数的值会在启动时被拒绝并报错，而不会被视为无上限
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION 一个会话可进行的 WebSearch 调用总数上限（默认：200）。当 Claude 达到上限时，后续 WebSearch 调用会返回一条通知，告诉它使用已收集的信息继续。接受没有上界的正整数。其他任何值都会被忽略并使用默认值，因此该上限可以提高但无法关闭。需要 Claude Code v2.1.212 或更高版本
CLAUDE_CODE_MCP_ALLOWLIST_ENV 设置为 1 可使用仅包含安全基线环境加上服务器所配置 env 的环境来启动 stdio MCP 服务器，而不是继承您的 shell 环境
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS 仍在运行的 MCP 工具调用转为后台任务之前经过的时间（毫秒）（默认：120000，即 2 分钟）。设置为 0 可关闭自动转入后台。需要 Claude Code v2.1.212 或更高版本
CLAUDE_CODE_MCP_STARTUP_WAIT_MS 非交互会话的第一轮等待仍在连接中的 MCP 服务器的时长（毫秒），用于替代默认的第一轮等待。设置后，该等待涵盖所有待连接的服务器。设置为 0 可跳过等待。无论该值如何，--permission-prompt-tool 服务器都会保留其自身的 MCP_TIMEOUT 等待。需要 Claude Code v2.1.274 或更高版本
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT MCP 工具调用的空闲超时时间（毫秒）。当 stdio、HTTP、SSE、WebSocket 或 claude.ai 连接器 MCP 服务器在这段时间内既未发送响应也未发送进度通知时，工具调用会报错中止，而不是等待整体的 MCP_TOOL_TIMEOUT。覆盖各传输方式的默认值：网络服务器为 300000（5 分钟），stdio 服务器为 1800000（30 分钟）。设置为 0 可禁用空闲检查。低于 1000 的值会被提高到一秒，且该值上限为实际生效的 MCP_TOOL_TIMEOUT。.mcp.json 中按服务器设置的 timeout 若至少为 1000，会将该服务器的空闲窗口提高到至少为该 timeout 值。不适用于 IDE 服务器或 SDK 进程内服务器。需要 Claude Code v2.1.187 或更高版本。在 v2.1.203 之前，stdio 服务器不受空闲超时限制
CLAUDE_CODE_MESSAGING_SOCKET 由 Claude Code 设置，而非由您设置：在绑定了收件箱套接字的会话中，Claude Code 在绑定套接字时会将该套接字的路径导出给 hook 和 Bash 命令。在启动时已开启消息功能的会话中，Claude Code 会在任何 hook 运行之前绑定套接字。本机上的其他会话会将消息投递到此路径。每个会话都会导出自己的套接字，而不是从父会话继承的套接字，到达该套接字的消息会经过该会话的入站控制。设置中的 env 块无法设置它。需要 Claude Code v2.1.224 或更高版本
CLAUDE_CODE_MESSAGING_TOKEN 由 Claude Code 设置，而非由您设置：在绑定了收件箱套接字的会话中，Claude Code 会将此会话级令牌与 CLAUDE_CODE_MESSAGING_SOCKET 一起导出给 hook 和 Bash 命令。向该套接字发送内容的脚本可以将 {"type":"auth","token":"<token>"} 作为第一行发送，以证明其属于该会话。在原生 Windows 上，Claude Code 要求必须发送这一行，并会关闭任何未以有效认证行开头的连接。自有子进程规则说明了 Claude Code 何时会检查该令牌。每个会话都会导出自己的令牌，绝不会使用从父会话继承的令牌。设置中的 env 块无法设置它。需要 Claude Code v2.1.228 或更高版本
CLAUDE_CODE_NATIVE_CURSOR 设置为 1 可在输入插入点显示终端自身的光标，而不是绘制的方块。该光标会遵循终端的闪烁、形状和焦点设置
CLAUDE_CODE_NEW_INIT 设置为 1 可让 /init 运行交互式设置流程。该流程会在探索代码库并写入文件之前，询问要生成哪些文件，包括 CLAUDE.md、skill 和 hook。未设置此变量时，/init 会自动生成 CLAUDE.md，而不进行询问
CLAUDE_CODE_NONBLOCKING_STDOUT 设置为 1 可通过第二个非阻塞文件描述符写入终端输出，这样停止读取的终端（例如已暂停的 tmux 控制模式窗格或卡住的 SSH 连接）就无法在会话中途冻结 Claude Code。在 stdout 为终端时，适用于 macOS、Linux 和 WSL。需要 Claude Code v2.1.261 或更高版本
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES 限制 Claude Code 重新发送超时的非流式请求的次数。设置为 0 时，请求在第一次超时时即失败。默认未设置，因此由 CLAUDE_CODE_MAX_RETRIES 限制这些重新发送。有关超时时间，请参阅调整重试行为。需要 Claude Code v2.1.285 或更高版本
CLAUDE_CODE_NO_FLICKER 设置为 1 可启用全屏渲染，这是一项研究预览功能，可减少闪烁并在长对话中保持内存占用平稳。覆盖 tui 设置；您也可以使用 /tui fullscreen 进行切换
CLAUDE_CODE_OAUTH_REFRESH_TOKEN 用于 Claude.ai 身份验证的 OAuth 刷新令牌。设置后，claude auth login 会直接交换此令牌，而不是打开浏览器。需要 CLAUDE_CODE_OAUTH_SCOPES。适用于在自动化环境中预配身份验证
CLAUDE_CODE_OAUTH_SCOPES 签发刷新令牌时使用的 OAuth 作用域，以空格分隔，例如 "user:profile user:inference user:sessions:claude_code"。设置 CLAUDE_CODE_OAUTH_REFRESH_TOKEN 时必需
CLAUDE_CODE_OAUTH_TOKEN 用于 claude.ai 身份验证的 OAuth 访问令牌。是 SDK 和自动化环境中 /login 的替代方案。优先于存储在钥匙串中的凭据。可使用 claude setup-token 生成。除非您运行 /login，否则 Claude Code 会在整个会话中使用您设置的令牌。要替换过期的令牌，请生成新令牌并重新启动
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 已在 v2.1.160 中移除，现在不起作用。此前用于将快速模式固定到 Claude Opus 4.6，而不是当前默认模型。Opus 4.6 不再支持快速模式
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH 承载内容的 OpenTelemetry 属性（模型响应、工具内容、系统提示词、原始 API 正文）的最大长度，包含截断标记，以 UTF-16 代码单元计（默认：61440，即 60 KB）。仅当您的遥测后端接受大于 64 KB 的属性值时才调高此值，或调低此值以减少遥测数据量。需要 Claude Code v2.1.214 或更高版本。请参阅监控
CLAUDE_CODE_OTEL_DIAG_STDERR 设置为 1 可将 OpenTelemetry 导出器诊断错误写入 stderr。默认情况下，这些错误仅在使用 --debug 时显示，因此配置错误的导出器（例如 Prometheus 端口冲突）否则会静默失败。需要 Claude Code v2.1.179 或更高版本。请参阅监控
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS 刷新待处理 OpenTelemetry span 的超时时间（毫秒）（默认：5000）。请参阅监控
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS 刷新动态 OpenTelemetry 标头的间隔（毫秒）（默认：1740000 / 29 分钟）。请参阅动态标头
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS OpenTelemetry 导出器在关闭时完成工作的超时时间（毫秒）（默认：2000）。如果退出时指标丢失，请调高此值。请参阅监控
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 设置为 1 可让 Claude Code 在有新版本可用时在后台运行您的包管理器的升级命令。适用于 Homebrew 和 WinGet 安装。其他包管理器仍会显示升级命令而不运行它。请参阅自动更新
CLAUDE_CODE_PERFORCE_MODE 设置为 1 可启用感知 Perforce 的写保护。设置后，如果目标文件缺少所有者写入位，Edit、Write 和 NotebookEdit 会失败并给出 p4 edit <file> 提示；Perforce 会清除已同步文件的该位，直到 p4 edit 打开这些文件。这可防止 Claude Code 绕过 Perforce 变更跟踪
CLAUDE_CODE_PLUGIN_CACHE_DIR 覆盖插件根目录。尽管名称如此，此变量设置的是父目录，而不是缓存本身：市场和插件缓存位于此路径下的子目录中。默认为 ~/.claude/plugins
CLAUDE_CODE_PLUGIN_DIRS 要为会话加载的插件目录，每个目录的加载方式与 --plugin-dir 标志相同。在 Unix 上用 : 分隔多个路径，在 Windows 上用 ; 分隔。每个路径请使用绝对路径或以 ~ 开头，因为 Claude Code 会跳过相对路径。需要 Claude Code v2.1.280 或更高版本。请参阅为单个会话加载插件
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS 克隆或刷新插件市场的超时时间（毫秒）（默认：120000）。对于大型仓库或较慢的网络连接，请调高此值。请参阅 Git clone timed out
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE 设置为 1 可在市场刷新无法访问远程仓库或无法通过其身份验证时，跳过重新克隆尝试并继续使用现有的市场检出。适用于离线或气隙环境，在这些环境中重新克隆也会以相同方式失败。请参阅市场更新在离线环境中失败
CLAUDE_CODE_PLUGIN_PREFER_HTTPS 设置为 1 可通过 HTTPS 而非 SSH 克隆 GitHub owner/repo 简写来源。适用于插件安装和更新，以及 /plugin marketplace add 和 update。适用于 CI 运行器、容器或任何未为 github.com 配置 SSH 密钥的环境
CLAUDE_CODE_PLUGIN_SEED_DIR 一个或多个只读插件种子目录的路径，在 Unix 上以 : 分隔，在 Windows 上以 ; 分隔。可用于将预填充的插件目录打包到容器镜像中。Claude Code 会在启动时从这些目录注册市场，并使用预缓存的插件而无需重新克隆。请参阅为容器预填充插件
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY 设置为 1 可阻止 Claude Code 在为工具调用、hook 和状态栏命令启动 PowerShell 时传递 -ExecutionPolicy Bypass，转而遵循计算机的有效执行策略。默认情况下，Claude Code 会在进程作用域绕过执行策略，以便 .ps1 脚本和模块导入能够在默认策略为 Restricted 的 Windows 安装上正常工作。无论此设置如何，进程作用域的绕过都绝不会覆盖组策略 MachinePolicy 或 UserPolicy
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS 在使用 -p 标志的非交互模式下，最后一轮结束后空闲等待后台子代理和工作流的上限时间（毫秒）。每当 Claude 为处理后台结果而进行一轮时，空闲等待会重新计时。默认：600000，即 10 分钟。当空闲等待达到上限时，Claude Code 会停止等待剩余的后台任务并退出。设置为 0 可无限期等待。此上限与适用于普通后台 shell 的五秒宽限期相互独立。需要 Claude Code v2.1.182 或更高版本
CLAUDE_CODE_PROCESS_WRAPPER 通过以 argv 前缀形式给出的企业启动器（例如 /opt/corp/launcher）来启动 Claude Code 从其自身二进制文件启动的进程，例如托管 agent view 会话的后台服务。请在用户设置或托管设置的 env 块中设置，而不是作为 shell 导出，以便分离的后台服务能够继承它；项目设置和本地设置无法设置它。等同于 processWrapper 设置，该设置需要 Claude Code v2.1.210 或更高版本；两者都设置时此变量优先。VS Code 扩展通过其 claudeProcessWrapper 设置单独配置自己的启动器。在 Windows 上会被忽略。有关值的格式、启动器涵盖的范围以及启动器必须满足的约定，请参阅在企业启动器后运行 Claude Code。需要 Claude Code v2.1.208 或更高版本
CLAUDE_CODE_PROJECT_DIR_NAME 与 CLAUDE_CONFIG_DIR 一起设置，用于选择 Claude Code 存储该会话的会话记录和自动记忆所用的 projects/ 目录名称，以替代根据工作目录路径派生的名称。例如，使用 CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude 启动 Claude Code 会将它们存储在 /srv/tenant-a/projects/work/ 下。未设置 CLAUDE_CONFIG_DIR 时，Claude Code 会忽略此变量，并且仅从您启动 claude 的环境中读取它，绝不会从设置文件的 env 块中读取。请参阅自行命名项目目录。需要 Claude Code v2.1.234 或更高版本
CLAUDE_CODE_PROMPT_CACHE_TTL 设置为 5m 或 1h（Claude Code 仅接受这两个值），以选择主对话的提示缓存 TTL：包括您的交互式、-p 和 SDK 轮次，以及与它们内联运行的辅助程序。优先于 promptCacheTtl 设置和 ENABLE_PROMPT_CACHING_1H，而 FORCE_PROMPT_CACHING_5M 会覆盖它。API 对 1 小时缓存写入按更高的费率计费。需要 Claude Code v2.1.242 或更高版本
CLAUDE_CODE_PROPAGATE_TRACEPARENT 设置为 1 可在 ANTHROPIC_BASE_URL 指向自定义代理时传播 W3C 追踪上下文。传播范围包括模型请求和 HTTP MCP 请求上的 traceparent 标头，以及 Bash、PowerShell 和 hook 子进程的 TRACEPARENT 环境变量。默认情况下，仅在直接连接到 Anthropic API 时启用传播。在 v2.1.152 中添加。请参阅追踪（beta）
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST 由嵌入 Claude Code 并代其管理模型提供商路由的宿主平台设置。设置后，Claude Code 会忽略设置文件中的提供商选择、端点和身份验证变量，例如 CLAUDE_CODE_USE_BEDROCK、ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY，因此用户设置无法覆盖宿主的路由。Claude Code 还会忽略托管设置中的模型选择键，例如 model、fallbackModel 和 modelOverrides，无论由哪个托管来源下发，因此宿主的模型配置优先于过时的托管模型固定设置。Claude Code 还会忽略托管 env 块中的模型选择变量，例如 ANTHROPIC_MODEL 和 ANTHROPIC_DEFAULT_*_MODEL 系列；托管设置中的 availableModels 允许列表仍然适用，除非宿主提供了自己的允许列表。Claude Code 还会跳过其在第三方提供商（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform 和 Microsoft Foundry）上原本会应用的自动遥测退出，因此遥测遵循标准的 DISABLE_TELEMETRY 退出机制。请参阅各 API 提供商的默认行为
CLAUDE_CODE_PROXY_RESOLVES_HOSTS 设置为 1 可允许由代理而非调用方执行 DNS 解析。适用于应由代理处理主机名解析的环境，需主动启用
CLAUDE_CODE_REMOTE 当 Claude Code 作为云端会话运行时自动设置为 true。可在 hook 或设置脚本中读取此变量，以检测您是否处于云端会话中
CLAUDE_CODE_REMOTE_SESSION_ID 在云端会话中自动设置为当前会话的 ID。读取此变量可构建返回会话记录的链接。请参阅将输出链接回会话
CLAUDE_CODE_RESTRICTED 设置为 1 可在受限模式下启动会话，与传递 --restricted 相同。Claude Code 会忽略设置文件 env 块中的此变量。需要 Claude Code v2.1.248 或更高版本
CLAUDE_CODE_RESUME_INTERRUPTED_TURN 设置为 1 可在上一个会话于轮次中途结束时自动恢复。在 SDK 模式下使用，使模型无需 SDK 重新发送提示词即可继续。要关闭此功能，请取消设置该变量或将其设置为 0。有关 VS Code 聊天面板，请参阅重新加载后继续对话
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS 对于在轮次中途结束的会话，允许在恢复时自动继续的最后一条会话记录消息的最大时长（毫秒）。当最后一条消息早于此界限时，Claude Code 会跳过 CLAUDE_CODE_RESUME_INTERRUPTED_TURN 自动恢复及其 CLAUDE_CODE_RESUME_PROMPT 继续消息，会话将以空闲状态启动，由您显式继续。未设置或为 0 表示没有界限，但最后一个请求因 API 错误而失败的轮次，仅在该错误发生不到六小时时才会恢复。正值会对每个轮次（包括上述轮次）施加界限；负值或非数字值会施加一小时的界限。长时间运行的 Agent 的启动脚本可以设置此变量，以免针对旧会话记录重启时重新运行过时的提示词。当 Claude Code 重启一个从交互式会话继承对话的已崩溃 agent view 会话时，它会自行设置一小时的界限。需要 Claude Code v2.1.211 或更高版本
CLAUDE_CODE_RESUME_PROMPT 覆盖 Claude Code 发送给 Claude 的继续消息，适用于 CLAUDE_CODE_RESUME_INTERRUPTED_TURN 继续被中断的轮次（而不是重新发送其提示词）时，或您使用 -p 恢复延迟的工具调用时。默认为 Continue from where you left off.。空字符串会使用默认值
CLAUDE_CODE_RETRY_WATCHDOG 对于无人值守的会话（例如评估 harness、CI 作业或远程 worker），请设置为 1。无限期重试 429 和 529 容量错误，而不是在 CLAUDE_CODE_MAX_RETRIES 次尝试后失败。当标准速度请求收到报告支出限制或使用额度耗尽的 429 时，即使它来自按计划重置的网关支出上限，Claude Code 也会立即失败。在 v2.1.239 之前，watchdog 会无限期重试这些错误。有关快速模式请求，请参阅处理速率限制。watchdog 在两次尝试之间最多退避 5 分钟，或者在响应携带速率限制重置时间时一直等到限制重置，因此遇到用量限制的会话会等待剩余的时间窗口结束。在 v2.1.199 或更高版本中，它还会将其他暂时性错误（例如服务器错误、超时和连接断开）的默认重试次数提高到 300 次，约合三小时的退避时间，并在您显式设置 CLAUDE_CODE_MAX_RETRIES 时移除其 15 次的上限。需要 Claude Code v2.1.186 或更高版本
CLAUDE_CODE_SAFE_MODE 设置为 1 可以安全模式启动：CLAUDE.md、skill、插件、hook、MCP 服务器、自定义命令和 Agent、输出样式、工作流、自定义主题、自定义快捷键、状态栏和文件建议命令、LSP 服务器以及自动记忆都不会加载，用于对损坏的配置进行故障排除。托管设置策略仍然适用，包括策略配置的 hook、状态栏和文件建议命令；托管插件、托管 skill、托管 CLAUDE.md 和策略配置的 MCP 服务器则不会加载。等同于传递 --safe-mode。直接生成的子进程会继承该变量
CLAUDE_CODE_SCRIPT_CAPS 在设置了 CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 时，用于限制特定脚本在每个会话中可被调用次数的 JSON 对象。键是与命令文本进行匹配的子字符串；值是整数调用次数限制。例如，{"deploy.sh": 2} 允许 deploy.sh 最多被调用两次。匹配基于子字符串，因此像 ./scripts/deploy.sh $(evil) 这样的 shell 展开技巧仍会计入上限。不会检测通过 xargs 或 find -exec 进行的运行时扇出；这是一项纵深防御控制
CLAUDE_CODE_SCROLL_SPEED 设置全屏渲染中的鼠标滚轮滚动倍数。接受不超过 20 的任何正值，包括低于 1 的小数值（例如 0.5），用于在已经放大滚轮事件的终端中减慢加速的触控板和滚轮滚动。如果您的终端每个刻度只发送一个滚轮事件且不做放大，设置为 3 可与 vim 保持一致。在 JetBrains IDE 终端中会被忽略，因为 Claude Code 在该终端中使用自己的滚动处理
CLAUDE_CODE_SEND_FEEDBACK 设置为 0 可为会话关闭 Claude 起草的反馈。设置为 1 可在您的账户已有访问权限的情况下开启该功能；该变量本身无法授予访问权限，其他关闭反馈的开关（例如 DISABLE_FEEDBACK_COMMAND 以及 feedbackDrafts 设置的 off 值）仍然适用
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS 覆盖 SessionEnd hook 的时间预算（毫秒）。该值也是每个未设置自身 timeout 的 hook 的超时时间。适用于会话退出、/clear 以及通过交互式 /resume 切换会话。默认情况下预算为 1.5 秒，并会自动提高到设置文件中配置的单个 hook 最高 timeout，最多 60 秒。插件提供的 hook 上的超时时间不会提高预算
CLAUDE_CODE_SESSION_ID 在 Bash 和 PowerShell 工具子进程、hook 命令子进程以及 stdio MCP 服务器子进程中自动设置为当前会话 ID。对于 Bash、PowerShell 和 hook，该值与 hook JSON 输入中的 session_id 字段一致，并会在 /clear 时更新。MCP 服务器子进程会保留其启动时的 ID。使用 --resume <session-id> 时，它会收到恢复后的 ID，与 hook 和 Bash 一致。使用 --continue 或不带显式 ID 的 --resume 时，它可能会改为收到初始启动 ID。用于将脚本和外部工具与启动它们的 Claude Code 会话关联起来
CLAUDE_CODE_SHELL 设置 Claude Code 用于运行 Bash 工具命令的 shell。接受指向 bash 或 zsh 二进制文件的路径，例如 /opt/homebrew/bin/bash。不支持 fish 等其他 shell。如果该值不是可用的 bash 或 zsh 路径，Claude Code 会忽略它并回退到自动检测。自动检测会在您的 $SHELL 指向 bash 或 zsh 时使用它，否则会在您的 PATH 和标准安装位置中先查找第一个可用的 zsh，然后是 bash
CLAUDE_CODE_SHELL_PREFIX 包装 Claude Code 所生成 shell 命令的命令前缀：Bash 工具调用、hook 命令、状态栏命令以及 stdio MCP 服务器启动命令。PowerShell hook 和 exec 形式的 hook 运行时不带前缀。适用于日志记录或审计。设置裸可执行文件路径（例如 /path/to/logger.sh）会将每个命令作为 /path/to/logger.sh '<command>' 运行。包装器会在 $1 中以单个经过 shell 引用的参数接收命令行，因此包装器必须使用 shell 重新求值 $1，例如 exec bash -c "$1"。将 $1 视为裸可执行文件路径会导致传递 npx -y <package> 等参数的 stdio MCP 服务器无法正常工作。对于 Bash 工具调用，$1 包含 Claude Code 组装的完整 shell 调用（包括环境设置），而不仅仅是 Claude 运行的命令
CLAUDE_CODE_SIMPLE 设置为 1 可使用最小系统提示词运行，且仅提供 Bash、文件读取和文件编辑工具。来自 --mcp-config 的 MCP 工具仍然可用。禁用对 hook、skill、自定义命令、子代理、已安装插件、MCP 服务器、自动记忆和 CLAUDE.md 的自动发现。通过 --add-dir 传递的目录中的 skill 仍会加载。不会读取 OAuth 令牌和钥匙串凭据，因此 Anthropic 身份验证必须来自 ANTHROPIC_API_KEY 或 --settings 中的 apiKeyHelper。等同于传递 --bare
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT 设置为 1 可在任何模型上使用更短的系统提示词和简化的工具描述。设置为 0、false、no 或 off 可选择退出，即使在实验或服务器配置原本会启用它的模型上也是如此。完整的工具集、hook、MCP 服务器和 CLAUDE.md 发现仍保持启用
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH 跳过 Claude Platform on AWS 的客户端身份验证，适用于自行对请求签名的网关
CLAUDE_CODE_SKIP_AWS_CRED_CACHE 设置为 1 可关闭对从 AWS 默认凭据提供程序链解析出的凭据的进程内缓存，使 Claude Code 在每个 API 请求时都解析该链。缓存关闭后，基于 SSO 的配置文件会在每个请求时向 IAM Identity Center 请求凭据。请参阅凭据缓存和解析超时。需要 Claude Code v2.1.207 或更高版本
CLAUDE_CODE_SKIP_BEDROCK_AUTH 跳过 Amazon Bedrock 的 AWS 身份验证（例如使用 LLM 网关时）
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS 设置为 1 可将失败的快速模式可用性检查视为可用，适用于会阻止该检查直接向 api.anthropic.com 发出请求的网络。Claude Code 仍会遵从“disabled by your organization”响应
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK 设置为 1 可跳过客户端快速模式可用性检查，适用于会拦截而非拒绝该检查请求的代理。当您的组织禁用了快速模式时，API 仍会拒绝快速模式请求
CLAUDE_CODE_SKIP_FOUNDRY_AUTH 跳过 Microsoft Foundry 的 Azure 身份验证，适用于会注入自己的 Authorization 标头的代理或网关。Claude Code 发送请求时不带 Azure 凭据，并保留您提供的 Authorization 标头（例如通过 ANTHROPIC_CUSTOM_HEADERS 提供）。设置了 ANTHROPIC_FOUNDRY_API_KEY 或 ANTHROPIC_FOUNDRY_AUTH_TOKEN 时会被忽略。在 v2.1.203 之前，除非同时设置了 API 密钥，否则此变量会导致 Microsoft Foundry 客户端无法发送请求
CLAUDE_CODE_SKIP_MANTLE_AUTH 跳过 Amazon Bedrock Mantle 的 AWS 身份验证（例如使用 LLM 网关时）
CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY Amazon Bedrock 和 Google Cloud's Agent Platform 上的启动模型检查会在本机上记住它们发现您的账户无法调用的模型，最长保留一天。设置为 1 可关闭这一记忆。需要 Claude Code v2.1.285 或更高版本
CLAUDE_CODE_SKIP_PROMPT_HISTORY 设置为 1 可跳过将提示词历史记录和会话记录写入磁盘。设置此变量后启动的会话不会出现在 --resume、--continue 或向上箭头历史记录中。适用于临时的脚本化会话
CLAUDE_CODE_SKIP_VERTEX_AUTH 跳过 Google Cloud's Agent Platform 的 Google 身份验证（例如使用 LLM 网关时）
CLAUDE_CODE_STARTUP_FAILURE_RESULTS 设置为 1 可让使用 --output-format stream-json 启动的会话，在那些原本仅以 stderr 输出结束的启动失败情况下，写入一条说明 Claude Code 拒绝启动原因的结果消息。需要 Claude Code v2.1.274 或更高版本
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Stop 或 SubagentStop hook 可连续阻止轮次结束的最大次数，超过后 Claude Code 会覆盖它并强制结束该轮次（默认：8）。设置为 0 可禁用此上限。如果您的 hook 确实需要更多次迭代才能完成，请调高此值
CLAUDE_CODE_SUBAGENT_MODEL 未通过其他方式指定模型的子代理、agent team 队友和工作流 Agent 的默认模型。接受别名（例如 haiku）或完整的模型名称。有两个来源优先于它：Claude 生成 Agent 时传递的模型，以及 Agent 定义中的 model 字段（包括 inherit）。要改变这一点，请设置 CLAUDE_CODE_SUBAGENT_MODEL_FORCE。有关完整顺序，请参阅选择模型。将其设置为 inherit 与不设置相同。在 v2.1.251 之前，此变量会覆盖每次调用指定的模型和定义中的 model 字段
CLAUDE_CODE_SUBAGENT_MODEL_FORCE 设置为 1 可将同一个模型强制应用于子代理、队友和工作流 Agent。在同一模型上运行所有子代理说明了具体是哪个模型。需要 Claude Code v2.1.257 或更高版本
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL 设置为 5m 或 1h（Claude Code 仅接受这两个值），以选择主对话之外的请求（例如子代理、工作流和后台工作）的提示缓存 TTL。优先于 subagentPromptCacheTtl 设置和 ENABLE_PROMPT_CACHING_1H，而 FORCE_PROMPT_CACHING_5M 会覆盖它。API 对 1 小时缓存写入按更高的费率计费。需要 Claude Code v2.1.242 或更高版本
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 设置为 1 可从子进程环境（Bash 工具、hook、MCP stdio 服务器）中移除凭据：Anthropic 和云提供商凭据、Claude Code 识别为凭据的任何其他变量，以及嵌入在包注册表 URL 中的凭据。父 Claude 进程会保留这些凭据用于 API 调用，但子进程无法读取它们，从而降低遭受试图通过 shell 展开窃取机密的提示词注入攻击的风险。在 v2.1.251 或更高版本中，该清除操作还会移除 Claude Code 自身的配置存储指针变量（例如 CLAUDE_CONFIG_DIR），使子进程无法定位已迁移的配置目录。如果子进程需要这些变量，请不要设置此清除选项。在 Linux 上，这还会在隔离的 PID 命名空间中运行 Bash 子进程，使其无法通过 /proc 读取宿主进程环境；副作用是 ps、pgrep 和 kill 无法看到宿主进程或向其发送信号。配置了 allowed_non_write_users 时，claude-code-action 会自动设置此变量
CLAUDE_CODE_SYNC_PLUGIN_INSTALL 在非交互模式（-p 标志）下设置为 1，可在第一次查询之前等待插件安装完成。否则，插件会在后台安装，可能在第一轮中不可用。可与 CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS 结合使用以限制等待时间
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS 同步插件安装的超时时间（毫秒）。超出后，Claude Code 会在不加载插件的情况下继续运行并记录错误。无默认值：未设置此变量时，同步安装会一直等待直到完成
CLAUDE_CODE_SYNC_SKILLS 在使用 -p 标志的非交互模式下设置为 1，可让 Claude Code 在该次运行中下载为您的 claude.ai 账户启用的 skill，并在运行第一次查询之前等待获取它们的列表，最长等待 CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS。下载本身会在后台完成，Claude 在调用某个 skill 时会等待该 skill 下载完成。需要 claude.ai 身份验证。使用 claude.ai 账户登录的终端会话无需此变量即可将这些 skill 下载到 ~/.claude/skills/synced/，并大约每 10 分钟重新同步一次，因此仅当某次 -p 运行需要在第一次查询时就使用您当前的 skill 时才设置此变量。在 v2.1.273 之前，终端会话仅在设置了此变量的 -p 运行中才会下载它们。synced 文件夹名称为此下载所保留。在 v2.1.227 之前，skill 会直接下载到 ~/.claude/skills/。Claude Code 会对下载的 skill 应用额外规则，例如不在您的机器上运行它们的 ! 命令
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS 当基于 Agent SDK 构建的应用重新加载 skill 时，会话中途运行的 skill 重新同步的超时时间（毫秒）（默认：30000）。超出后，重新加载会使用已到达的 skill 继续，其余下载在后台完成
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS 设置了 CLAUDE_CODE_SYNC_SKILLS 时，第一次查询等待初始 skill 列表的超时时间（毫秒）（默认：5000）。超出后，第一次查询会使用已到达的 skill 运行。无论哪种情况，下载都会在后台完成，Claude 在调用某个 skill 时会等待该 skill 下载完成
CLAUDE_CODE_SYNTAX_HIGHLIGHT 设置为 false 可禁用 diff 输出中的语法高亮。当颜色干扰您的终端设置时很有用。要同时禁用代码块和文件预览中的高亮，请使用 syntaxHighlightingDisabled 设置
CLAUDE_CODE_TASK_LIST_ID 在会话之间共享任务列表。在具有 Task 工具的会话中，在多个 Claude Code 实例中设置相同的 ID，即可协同使用共享的任务列表。请参阅任务列表
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS 覆盖非交互式会话在退出时等待其 agent team 完成拆除的时长（毫秒）。接受 1000 到 60000；超出范围的值会被忽略，并使用默认值 10000。需要 Claude Code v2.1.206 或更高版本
CLAUDE_CODE_TMPDIR 覆盖用于内部临时文件的临时目录。Claude Code 在 Unix 上会将 /claude-{uid}/ 追加到此路径，在 Windows 上追加 /claude/。默认：macOS 上为 /tmp，Linux 和 Windows 上为 os.tmpdir()。在 macOS 和 Linux 上，当您的覆盖值是较长路径时，沙箱隔离的 Bash 子进程会在系统默认目录下获得一个较短的备用 $TMPDIR，因为某些工具在临时路径过长时会失败。未经沙箱隔离的 Bash 命令会在您的 shell 设置了 $TMPDIR 时继承它。在原生 Windows 上，当您的 shell 未设置 $TMPDIR 时，引用 $TMPDIR 的 Bash 命令会收到您的覆盖值，如果您未设置覆盖值则收到 %TEMP%。Claude Code 自身的临时文件始终使用您的覆盖值。请在 shell、用户设置或托管设置中设置。在项目设置和本地设置中会被忽略
CLAUDE_CODE_TMUX_TRUECOLOR 设置为任意非空值（例如 1）可允许在 tmux 中输出 24 位真彩色。将其设置为 0 或 false 仍会允许真彩色，这与大多数开/关变量不同；取消设置该变量可恢复 256 色限制。默认情况下，设置了 $TMUX 时 Claude Code 会限制为 256 色，因为除非经过配置，否则 tmux 不会透传真彩色转义序列。请在将 set -ga terminal-overrides ',*:Tc' 添加到您的 ~/.tmux.conf 之后设置此变量。有关其他 tmux 设置，请参阅终端配置
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE 在 Linux 和 WSL 上，设置为以逗号分隔的进程类型列表，Claude Code 会将这些类型的进程排除在工具内存上限之外，例如 mcp 或 lsp。设置为 none 可对所有类型施加上限，设置为 all-new 则仅对 Bash、PowerShell 和 Monitor 工具命令施加上限。无论您列出什么，Claude Code 都会将 Bash、PowerShell 和 Monitor 工具命令保持在上限约束之下。需要 Claude Code v2.1.246 或更高版本
CLAUDE_CODE_TOOL_MEMORY_LIMIT 在 Linux 和 WSL 上，设置为诸如 4G 的大小，以限制 Bash 和 PowerShell 工具命令可使用的内存，在 v2.1.246 或更高版本中还包括 Monitor 工具命令。请以纯数字写入大小，单独使用表示字节数，或加上 K、M、G 或 T 后缀。设置为 0 或 off 可关闭上限。一旦 Claude Code 启动的第一个进程已开启或关闭上限，更改后的值将在您下次启动 claude 时生效。需要 Claude Code v2.1.233 或更高版本
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS Claude Code 取消其转发给远程客户端（例如 Remote Control 或 SDK 宿主）的对话框，或被搁置的跨会话消息的批准对话框之前的截止时间（毫秒）；权限提示和 AskUserQuestion 问题使用各自的流程，不受其约束。在 Claude Code v2.1.236 或更高版本中，它还会限制可能处于无人值守运行状态的会话中，会话中途出现的 Fable 使用额度同意提示。控制入站消息和非交互式会话涵盖了完整的搁置消息过期规则，包括截止时间不适用的情况。覆盖 dialogExpiry 设置。0 或负值会禁用截止时间
CLAUDE_CODE_USE_ANTHROPIC_AWS 使用 Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCK 使用 Amazon Bedrock
CLAUDE_CODE_USE_FOUNDRY 使用 Microsoft Foundry
CLAUDE_CODE_USE_MANTLE 使用 Amazon Bedrock Mantle 端点
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH 设置为 1 可使用 Node.js 文件 API 而非 ripgrep 来发现自定义命令、子代理和输出样式。如果捆绑的 ripgrep 二进制文件在您的环境中不可用或被阻止，请设置此变量。不影响 Grep 或文件搜索工具
CLAUDE_CODE_USE_POWERSHELL_TOOL 控制 PowerShell 工具。在未安装 Git Bash 的 Windows 上，该工具会自动启用；设置为 0 可禁用它。在安装了 Git Bash 的 Windows 上，该工具对 claude.ai 和 Console 账户默认开启；设置为 1 可在 Amazon Bedrock、Google Cloud's Agent Platform 和 Microsoft Foundry 会话中启用它，或设置为 0 将其关闭。在 Linux、macOS 和 WSL 上，设置为 1 可启用它，这需要 pwsh 位于您的 PATH 中。在 Windows 上启用后，Claude 可以原生运行 PowerShell 命令，而不必通过 Git Bash 路由。请参阅 PowerShell 工具
CLAUDE_CODE_USE_VERTEX 使用 Google Cloud's Agent Platform
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS 设置为 WebFetch 缓存每个已获取 URL 的响应的毫秒数。默认值为 900000，即 15 分钟。仅接受纯数字；0、小数或任何其他写法都会保留默认值。Claude Code 每次启动只读取一次该值，因此设置 env 块中的更改会在您下次启动 claude 时生效。需要 Claude Code v2.1.233 或更高版本
CLAUDE_CODE_WEBFETCH_DEADLINE_MS WebFetch 等待页面下载（包括其跟随的任何重定向）的时长上限（毫秒）。到那时仍未完成的下载会因截止时间错误而失败。默认值为 300000，即五分钟。设置为 0 可移除该限制。仅接受纯数字；小数或任何其他写法都会保留默认值。需要 Claude Code v2.1.268 或更高版本
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS 单次工作流运行同时执行的 Agent 数量，范围为 1 到 256。默认情况下，一次运行最多同时执行 16 个 Agent；当 Claude Code 可用的 CPU 较少时，数量会相应减少；排队中的 agent() 调用会等待空闲槽位。每个正在运行的 Agent 的会话记录都保存在 Claude Code 的内存中，因此数值越大，内存占用越高。仅接受纯数字；超出范围的值和其他写法会保留默认值。需要 Claude Code v2.1.269 或更高版本
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS 工作流 Agent 在发送自己的首个请求之前，等待具有相同前缀的同级 Agent 开始返回首个响应的最长时间（毫秒）。当一次扇出启动多个共享提示缓存前缀的 Agent 时，Claude Code 会让除第一个以外的所有 Agent 最多等待这么长时间，以便其余 Agent 读取已缓存的前缀，而不是各自在未缓存的情况下处理它。默认值为 5000。设置为 0 可禁用等待。设置了 DISABLE_PROMPT_CACHING 时，Agent 从不等待。需要 Claude Code v2.1.229 或更高版本
CLAUDE_CONFIG_DIR 覆盖配置目录（默认：~/.claude）。所有设置、会话历史和插件都存储在此路径下。关于凭据，请参阅 Claude Code 存储凭据的位置。适用于并行运行多个账户：例如 alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'。请在 shell、用户设置或托管设置中设置。在项目设置和本地设置中会被忽略
CLAUDE_DISABLE_ADOPT 设置为 1 后，当您按 ← 或使用 /background 将会话转入后台时，会停止正在进行的后台工作，而不是将其延续。Claude Code 会在转入后台之前请您确认，然后停止原本会延续的任务。需要 Claude Code v2.1.195 或更高版本
CLAUDE_EFFORT 在 Bash 工具子进程和 hook 命令中自动设置为子进程启动时生效的 effort 级别：low、medium、high、xhigh 或 max。与传递给 hook 的 effort.level 字段一致。仅在当前模型支持 effort 参数时设置
CLAUDE_ENABLE_BYTE_WATCHDOG 设置为 1 可强制启用字节级流式空闲看门狗，设置为 0 可强制禁用。0 还会关闭运行该截止时间的连接上的首字节截止时间。未设置时，该看门狗默认在直连 Anthropic API 和 Claude Platform on AWS 的连接上启用，并在通过 ANTHROPIC_BASE_URL 或 ANTHROPIC_AWS_BASE_URL 访问的网关连接的流式响应上启用；在 v2.1.222 之前，它不会在这些网关连接上运行，因此即使 keep-alive ping 仍在到达，事件级看门狗也可能在那里报告停滞。关于超时时间以及各计时器之间的相互作用，请参阅流式空闲看门狗
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK 设置为 1 可在 Amazon Bedrock vnd.amazon.eventstream 响应上启用字节级流式空闲看门狗，这同时会在 Bedrock 流式请求上启用首字节截止时间。默认关闭。使用 CLAUDE_STREAM_IDLE_TIMEOUT_MS 配置超时时间
CLAUDE_ENABLE_STREAM_WATCHDOG 设置为 0 可强制禁用事件级流式空闲看门狗，设置为 1 可强制启用。未设置时，该看门狗默认对所有提供商开启。在 v2.1.196 之前，未设置时的默认值在直连 Anthropic API 上由服务器控制，在其他提供商上为关闭。使用 CLAUDE_STREAM_IDLE_TIMEOUT_MS 配置超时时间；关于与其并行运行的其他停滞计时器，请参阅流式空闲看门狗
CLAUDE_ENV_FILE 一个 shell 脚本的路径，Claude Code 会在同一 shell 进程中于每条 Bash 命令之前运行其内容，因此文件中的导出对该命令可见。可用于在多条命令之间保持 virtualenv 或 conda 的激活状态。也会由 SessionStart、Setup、CwdChanged 和 FileChanged hook 动态填充
CLAUDE_JOB_DIR 由 Claude Code 在每个后台会话中设置为该会话的 ~/.claude/jobs/<id> 目录。会话运行的 shell 命令会继承该变量。请将临时文件写入 $CLAUDE_JOB_DIR/tmp。Claude 在该位置的 Write 和 Edit 调用不会请求权限，并且该目录会在会话被删除时移除
CLAUDE_PID Claude Code 会在其生成的子进程中将此变量设置为自己的进程 ID，这些子进程包括 Bash 和 PowerShell 工具命令以及 hook 命令。在 Linux 上，Bash 工具的 shell 集成使用它来拒绝会匹配 Claude Code 进程自身的 pkill 模式；请参阅错误参考。您可以在自己的脚本中读取它，以有意地识别父 Claude Code 进程或向其发送信号。需要 Claude Code v2.1.214 或更高版本
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX 未显式提供名称时，自动生成的 Remote Control 会话名称的前缀。默认为您机器的主机名，生成类似 myhost-graceful-unicorn 的名称。--remote-control-session-name-prefix CLI 标志可为单次调用设置相同的值
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS 在运行首字节截止时间的连接上，流式请求首个响应字节的截止时间（毫秒）。关于 Claude Code 如何限制该值、为大型请求体额外增加的时间，以及未设置此变量时如何选择截止时间，请参阅 No response from API。需要 Claude Code v2.1.242 或更高版本
CLAUDE_STREAM_IDLE_TIMEOUT_MS 事件级和字节级流式空闲看门狗关闭停滞连接之前的超时时间（毫秒）。显式设置此变量时，最小值为 300000（5 分钟）；较低的值会被静默提升，以容纳扩展思考暂停和代理缓冲，并且字节级看门狗将该值上限设为 30 分钟。对于字节级看门狗，CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS 优先于此变量。关于各看门狗在未设置时的默认值，请参阅流式空闲看门狗
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS 已在 v2.1.260 中移除，现在不起作用。之前用于限制子代理启动的后台 shell 命令可运行的时长（毫秒），默认值为 60 分钟。请参阅后台命令生命周期规则
DEBUG 设置为 1 可启用调试模式，等同于使用 --debug 启动。调试日志会写入 ~/.claude/debug/<session-id>.txt，或写入 CLAUDE_CODE_DEBUG_LOGS_DIR 设置的路径。只有真值 1、true、yes 和 on 会启用调试模式，因此为其他工具设置的 DEBUG=express:* 之类的命名空间模式不会触发它
DISABLE_AUTOUPDATER 设置为 1 可禁用自动后台更新。手动执行 claude update 仍然有效。使用 DISABLE_UPDATES 可同时阻止两者
DISABLE_AUTO_COMPACT 设置为 1 可禁用接近上下文限制时的自动压缩。手动 /compact 命令仍然可用。适用于您希望明确控制何时进行压缩的情况。覆盖 autoCompactEnabled 设置
DISABLE_COMPACT 设置为 1 可禁用所有压缩：包括自动压缩和手动 /compact 命令
DISABLE_COST_WARNINGS 设置为 1 可禁用成本警告消息
DISABLE_DOCTOR_COMMAND 设置为 1 可隐藏 /doctor 设置检查 skill 及其 /checkup 别名。适用于不应让用户在会话中运行设置诊断的托管部署。不影响 claude doctor 终端命令。在 v2.1.205 之前，此变量会隐藏 /doctor 诊断界面命令
DISABLE_ERROR_REPORTING 设置为任意非空值（例如 1）可选择退出错误报告。设置为 0 或 false 仍会选择退出，这与大多数开关变量不同；取消设置该变量可重新开启错误报告
DISABLE_EXTRA_USAGE_COMMAND 设置为 1 可隐藏 /usage-credits 命令，该命令允许用户购买超出速率限制的额外用量
DISABLE_FEEDBACK_COMMAND 设置为 1 可禁用 /feedback 命令和 Claude 起草的反馈。同时禁用通过同一路径报告的 /bug 和 /share；在 v2.1.212 之前，它们是 /feedback 的别名，因此该命令在所有名称下都会被禁用。也接受旧名称 DISABLE_BUG_COMMAND
DISABLE_GROWTHBOOK 设置为 1 或 true 可禁用 GrowthBook 功能标志获取，并对每个标志使用代码默认值。这会使 Remote Control 以及其他需要获取功能标志的功能不可用。设置为 0 或 false 会保持获取开启。除非同时设置了 DISABLE_TELEMETRY，否则遥测事件日志记录保持开启
DISABLE_INSTALLATION_CHECKS 设置为 1 可禁用安装警告。仅在手动管理安装位置时使用，因为这可能会掩盖标准安装中的问题
DISABLE_INSTALL_GITHUB_APP_COMMAND 设置为 1 可隐藏 /install-github-app 命令。使用第三方提供商（Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry）时已默认隐藏
DISABLE_INTERLEAVED_THINKING 设置为 1 可阻止发送交错思考 beta 标头。适用于您的 LLM 网关或提供商不支持交错思考的情况
DISABLE_LOGIN_COMMAND 设置为 1 可隐藏 /login 命令。适用于通过 API 密钥或 apiKeyHelper 在外部处理身份验证的情况
DISABLE_LOGOUT_COMMAND 设置为 1 可隐藏 /logout 命令
DISABLE_PROMPT_CACHING 设置为 1 可为所有模型禁用提示缓存（优先于按模型的设置）
DISABLE_PROMPT_CACHING_FABLE 设置为 1 可为 Fable 模型禁用提示缓存
DISABLE_PROMPT_CACHING_HAIKU 设置为 1 可为默认 Haiku 模型禁用提示缓存，无论其在何处运行
DISABLE_PROMPT_CACHING_OPUS 设置为 1 可为默认 Opus 模型禁用提示缓存
DISABLE_PROMPT_CACHING_SONNET 设置为 1 可为默认 Sonnet 模型禁用提示缓存
DISABLE_TELEMETRY 设置为任意非空值（例如 1）可选择退出遥测。设置为 0 或 false 仍会选择退出，这与大多数开关变量不同；取消设置该变量可重新开启遥测。遥测事件不包含代码、文件路径或 Bash 命令等用户数据。同时会禁用功能标志获取。请参阅为您的组织关闭遥测
DISABLE_UPDATES 设置为 1 可阻止所有更新，包括手动执行 claude update 和 claude install。比 DISABLE_AUTOUPDATER 更严格。适用于通过您自己的渠道分发 Claude Code 且用户不应自行更新的情况
DISABLE_UPGRADE_COMMAND 设置为 1 可隐藏 /upgrade 命令
DO_NOT_TRACK 设置为 1 可选择退出遥测，效果与 DISABLE_TELEMETRY 相同，包括对功能标志获取的影响。Claude Code 将此变量作为标准布尔值读取，因此 0 会保持遥测开启；Claude Code 遵循它，是因为它是许多开发者 CLI 所认可的跨工具约定
ENABLE_BETA_TRACING_DETAILED 与 BETA_TRACING_ENDPOINT 一起设置为 1，可开启详细 beta 追踪，这会添加包含内容的 span 属性以及 claude_code.hook span。交互式 CLI 会话还要求您的组织已被列入该 beta 的允许名单。这两个变量在项目设置和本地设置中都会被忽略
ENABLE_CLAUDEAI_MCP_SERVERS 设置为 false 可阻止 Claude Code 获取 claude.ai MCP 服务器。对已登录用户默认启用。若要按项目或按组织禁用，请改为在设置中设置 disableClaudeAiConnectors
ENABLE_PROMPT_CACHING_1H 设置为 1 可请求 1 小时的提示缓存 TTL，而不是默认的 5 分钟。适用于 API 密钥、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry 和 Claude Platform on AWS 用户。在包含用量范围内的订阅用户会在主对话上自动获得 1 小时 TTL。使用使用额度的订阅用户可以设置此变量以保留 1 小时 TTL。1 小时缓存写入按更高费率计费。若要改为按请求类别选择 TTL，请使用 CLAUDE_CODE_PROMPT_CACHE_TTL 和 CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL，它们优先于此变量
ENABLE_PROMPT_CACHING_1H_BEDROCK 已弃用。请改用 ENABLE_PROMPT_CACHING_1H
ENABLE_TOOL_SEARCH 控制 MCP 工具搜索。未设置时，Claude Code 默认延迟加载所有 MCP 工具。但在 Claude 4.5 代之前的 Google Cloud's Agent Platform 模型上、在托管于 Azure 的 Microsoft Foundry 部署上，以及当 ANTHROPIC_BASE_URL 指向非第一方主机时，仍会预先加载它们。true 始终延迟加载并发送 beta 标头，但上述 Agent Platform 模型和 Microsoft Foundry 部署除外；在不支持 tool_reference 的代理上，请求会失败。auto 在工具定义能容纳在上下文的 10% 以内时预先加载。auto:N 设置自定义阈值，例如 auto:5 表示 5%。false 预先加载所有工具。设置了 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 时，您自行设置的值会被忽略。在 v2.1.221 之前，除非您将此变量设置为 true，否则 Claude Code 会在 Google Cloud's Agent Platform 上为所有模型禁用工具搜索
FALLBACK_FOR_ALL_PRIMARY_MODELS 设置为任意非空值（例如 1），可在未配置备用模型时，让 Claude Code 对所有模型在反复出现过载错误时停止重试。设置为 0 或 false 仍会启用此行为，这与大多数开关变量不同；取消设置该变量可恢复默认重试行为。如果不设置，当您使用 API 密钥或第三方提供商而非 Claude 订阅进行身份验证时，Claude Code 仅对其识别为 Opus、Fable 或 Mythos 的模型以这种方式停止重试。在 Claude Code v2.1.160 或更高版本中，Claude Code 会在任意主模型反复出现过载错误时切换到您配置的备用模型链，因此此变量不影响切换到备用模型
FORCE_AUTOUPDATE_PLUGINS 设置为 1 可在主自动更新程序已通过 DISABLE_AUTOUPDATER 禁用时，仍强制插件自动更新
FORCE_HYPERLINK 当您的终端支持可点击的 OSC 8 超链接但未被自动检测到时，设置为 1 可启用它们；设置为 0 可禁用。未设置时，Claude Code 仅在检测到终端支持时启用超链接。Claude Code 将此值解析为数字而非布尔值，因此 false、no 或 off 之类的值会启用超链接，而不是禁用。页脚的 PR 或合并请求徽章即使在 Claude Code 无法检测终端支持时（例如通过 SSH）也会渲染为超链接。设置为 0 可将徽章渲染为纯文本
FORCE_PROMPT_CACHING_5M 设置为 1 可强制使用 5 分钟提示缓存 TTL，即使原本会应用 1 小时 TTL。覆盖 CLAUDE_CODE_PROMPT_CACHE_TTL、CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL、ENABLE_PROMPT_CACHING_1H 以及 promptCacheTtl 和 subagentPromptCacheTtl 设置
HTTP_PROXY 为网络连接指定 HTTP 代理服务器
HTTPS_PROXY 为网络连接指定 HTTPS 代理服务器
IS_DEMO 设置为任意非空值（例如 1）可启用演示模式：在标题栏和 /status 输出中隐藏您的电子邮件和组织名称，并跳过引导流程。设置为 0 或 false 仍会启用演示模式，这与大多数开关变量不同；取消设置该变量可将其关闭。适用于直播或录制会话
MAX_MCP_OUTPUT_TOKENS MCP 工具响应中允许的最大 token 数。当输出超过 10,000 个 token 时，Claude Code 会显示警告。声明了 anthropic/maxResultSizeChars 的工具改为对文本内容使用该字符限制，但这些工具的图像内容仍受此变量约束（默认：25000）
MAX_STRUCTURED_OUTPUT_RETRIES 在使用 -p 标志的非交互模式下，当模型的响应未能通过 --json-schema 验证时，Claude Code 允许的尝试次数；在达到该次数的失败尝试且没有有效输出后，运行将失败。当工作流子代理的结构化输出未通过验证时，也适用相同的上限。默认为 5，即首次尝试加四次重试
MAX_THINKING_TOKENS 扩展思考的固定 token 预算。Claude Code 将其上限设为比请求的最大输出 token 数少一个 token，且不低于 1,024。关于该限制的设置方式，请参阅 CLAUDE_CODE_MAX_OUTPUT_TOKENS。未设置且启用思考时，具有自适应推理的模型会自行选择思考深度，其他模型则使用该上限。设置为 0 可在 Anthropic API 上禁用思考，但 Opus 5.5、Sonnet 5.5 和 Fable 模型除外，这些模型无法关闭思考。在第三方提供商上，0 会改为省略 thinking 参数。在 Anthropic API 上关闭思考时，对于已知不接受该组合的模型（例如 Opus 5），Claude Code 会发送 effort high 而非更高级别。Claude Code 会忽略自适应推理模型上的非零值，但 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 可关闭自适应推理的模型除外
MCP_CLIENT_SECRET 需要预配置凭据的 MCP 服务器的 OAuth 客户端密钥。使用 --client-secret 添加服务器时可避免交互式提示
MCP_CONNECTION_NONBLOCKING 控制启动时是否在首次查询之前等待 MCP 服务器连接。MCP 启动默认为非阻塞：服务器在后台连接，其工具在完成后即可使用。设置为 0 可让 Claude Code 在首次查询之前等待服务器连接。配置了 alwaysLoad: true 的服务器无论如何仍会让启动等待，除非从发现缓存提供，因为构建首个提示词时必须具备它们的工具。在未使用 --input-format stream-json 的非交互模式（-p）下，无论此变量如何设置，Claude Code 也会在第一轮之前等待仍处于待定状态的服务器。当您显式传入 --mcp-config 时，等待的截止时间更长；关于已缓存服务器的例外情况，请参阅该标志的条目
MCP_CONNECT_TIMEOUT_MS 阻塞式 MCP 启动在对工具列表进行快照之前等待连接批次的时长（毫秒）（默认：5000）。适用于 MCP_CONNECTION_NONBLOCKING=0 时，或标记为 alwaysLoad: true 的服务器。截止时间到达时仍处于待定状态的服务器会继续在后台连接。与 MCP_TIMEOUT 不同，后者限制单个服务器的连接尝试
MCP_DISCOVERY_CACHE 开启或关闭 MCP 发现缓存。缓存开启时，您之前使用过的远程 HTTP 或 SSE 服务器可以显示 cached 状态，并且 Claude Code 会在其首次工具调用时而不是在启动时连接它。除非逐步推出已为您的账户启用缓存，否则缓存默认关闭。设置为 1 可将其开启，设置为 0 可在推出已启用时仍保持关闭。在 v2.1.238 之前，缓存默认开启。cached 状态需要 Claude Code v2.1.221 或更高版本
MCP_DISCOVERY_CACHE_MAX_STALE_S 发现缓存条目的最长保留时间（秒）（默认：14400，即 4 小时）。在启动时，如果条目早于该时长，Claude Code 会丢弃它并在启动时连接服务器，与缓存关闭时的行为相同。Claude Code 将该值上限设为 7 天。在 v2.1.238 之前，默认值为 86400，即 24 小时，且 Claude Code 不限制该值
MCP_DISCOVERY_CACHE_STRIKES 在启动时，如果发现缓存条目早于 MCP_DISCOVERY_CACHE_TTL_S，Claude Code 会在后台刷新它。此变量设置在 Claude Code 丢弃该条目并改为在下次启动时连接服务器之前，允许连续失败的刷新次数（默认：1）。如果您的网络连接偶尔中断，可调高此值，以免一次刷新失败就丢弃条目。需要 Claude Code v2.1.238 或更高版本
MCP_DISCOVERY_CACHE_TTL_S Claude Code 在不刷新的情况下使用发现缓存条目的秒数（默认：900）。在启动时，如果条目早于该时长，Claude Code 仍会使用它，但会在后台刷新。一旦条目早于 MCP_DISCOVERY_CACHE_MAX_STALE_S，Claude Code 会改为丢弃它。Claude Code 将该值上限设为 MCP_DISCOVERY_CACHE_MAX_STALE_S，默认为 4 小时。在 v2.1.238 之前，Claude Code 不限制该值
MCP_OAUTH_CALLBACK_PORT OAuth 重定向回调的固定端口，可在使用预配置凭据添加 MCP 服务器时替代 --callback-port
MCP_PROTOCOL_NEGOTIATION 仅在 v2 MCP 客户端运行时上生效，控制 Claude Code 是否探测服务器对 MCP 协议修订版 2026-07-28 的支持。设置为 auto 可探测 HTTP、claude.ai 连接器和 stdio 服务器，设置为 legacy 则不探测任何服务器。未设置该变量时，Claude Code 会探测 MCP 客户端运行时中所述的服务器。任何其他值都会被忽略，并在调试日志中记录警告。需要 Claude Code v2.1.221 或更高版本
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE 启动期间并行连接的远程 MCP 服务器（HTTP/SSE）的最大数量（默认：20）
MCP_SDK_GENERATION 固定此进程连接 MCP 服务器所用的 MCP 客户端运行时：v1 基于 MCP TypeScript SDK 1.x 构建，v2 基于 MCP TypeScript SDK 2.0 构建。未设置此变量时，Claude Code 从该部分列出的版本开始使用 v2。在 Claude Code v2.1.221 或更高版本中，v2 运行时会检查 MCP OAuth 服务器在其授权响应中返回的签发者，如果不匹配，则以 Issuer mismatch in authorization response 开头的错误使登录失败。v1 运行时不执行此检查。如果您设置了无法识别的值，Claude Code 会忽略它并向调试日志写入警告。Claude Code 每个进程只读取一次该值。需要 Claude Code v2.1.218 或更高版本
MCP_SERVER_CONNECTION_BATCH_SIZE 启动期间并行连接的本地 MCP 服务器（stdio）的最大数量（默认：3）
MCP_TIMEOUT MCP 服务器启动的超时时间（毫秒）（默认：30000，即 30 秒）
MCP_TOOL_TIMEOUT MCP 工具执行的超时时间（毫秒）（默认：100000000，约 28 小时）。对于 HTTP、SSE 或 claude.ai 连接器服务器，每个请求默认还会在 60 秒后超时；将此变量或按服务器的 timeout 设置为高于 60000 可提高该单请求限制。较低的值仍会缩短整体工具执行超时时间，但单请求限制保持为 60 秒。Stdio 和 WebSocket 服务器没有单请求计时器。.mcp.json 中按服务器的 timeout 字段会为该服务器覆盖此值。按服务器的 timeout 至少为 1000 时，也会为该服务器的工具调用设置最小空闲窗口，因此 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT 永远不会更早中止它们；此下限需要 Claude Code v2.1.203 或更高版本。对于环境变量，低于 1000 的值会被提升至一秒；对于按服务器的字段，低于 1000 的值会被忽略
NO_PROXY 请求将绕过代理直接发往的域名和 IP 列表
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT 标准 OpenTelemetry SDK 属性值长度限制。Claude Code 将包含内容的遥测属性限制为此值与 CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH 中的较小者，以使截断标记保持在 SDK 限制之内。Claude Code 以相同方式读取 OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT 和 OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT 变体，并将已设置值中的最小值应用于所有信号。需要 Claude Code v2.1.214 或更高版本。请参阅监控
OTEL_LOG_ASSISTANT_RESPONSES 设置为 1 可在 assistant_response OpenTelemetry 日志事件中包含模型的回复文本。未设置时，Claude Code 会改用 OTEL_LOG_USER_PROMPTS 的值。设置为 0 可在设置了 OTEL_LOG_USER_PROMPTS 时仍保持回复被遮盖。请在 shell、用户设置或托管设置中设置。在项目设置和本地设置中会被忽略。需要 Claude Code v2.1.193 或更高版本。请参阅监控
OTEL_LOG_MANAGED_SETTINGS 设置为 1 可将遮盖后的托管设置以及遮盖前设置的 SHA-256 摘要添加到 managed_settings_resolved OpenTelemetry 日志事件中。默认禁用。请在 shell、用户设置或托管设置中设置；项目设置或本地设置中的值不会将其开启。需要 Claude Code v2.1.274 或更高版本。请参阅监控
OTEL_LOG_RAW_API_BODIES 将 Anthropic Messages API 请求和响应 JSON 作为 api_request_body / api_response_body 日志事件发出。设置为 1 可发出按内容限制截断的内联正文，设置为 file:<dir> 可将未截断的正文写入磁盘并改为发出 body_ref 路径。CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH 配置内容限制，默认为 60 KB。默认禁用；正文包含完整的对话历史。请在 shell、用户设置或托管设置中设置。在项目设置和本地设置中会被忽略。请参阅监控
OTEL_LOG_TOOL_CONTENT 设置为 1 可在 tool.output OpenTelemetry span 事件中包含工具内容。span 属性在各自的开关下携带工具内容。需要追踪。默认禁用以保护敏感数据。请在 shell、用户设置或托管设置中设置。在项目设置和本地设置中会被忽略，但该部分描述的关闭值除外。请参阅监控
OTEL_LOG_TOOL_DETAILS 设置为 1 可在 OpenTelemetry 指标、追踪和日志中包含工具输入参数；MCP 服务器名称；用户编写的工作流名称；工具失败时的原始错误字符串；api_refusal 事件上的拒绝 category；成本和 token 指标上真实的 Agent、skill、插件和 MCP 服务器名称；以及其他工具详细信息。默认禁用以保护 PII。请在 shell、用户设置或托管设置中设置。在项目设置和本地设置中会被忽略，但该部分描述的关闭值除外。请参阅监控
OTEL_LOG_USER_PROMPTS 设置为 1 可在 OpenTelemetry 追踪和日志中包含用户提示词文本。默认禁用（提示词会被遮盖）。请在 shell、用户设置或托管设置中设置。在项目设置和本地设置中会被忽略，但该部分描述的关闭值除外。请参阅监控
OTEL_METRICS_INCLUDE_ACCOUNT_UUID 设置为 false 可从指标属性中排除账户 UUID（默认：包含）。请参阅监控
OTEL_METRICS_INCLUDE_ENTRYPOINT 设置为 true 可在指标属性中包含会话入口点（默认：排除）。在 v2.1.152 中添加。请参阅监控
OTEL_METRICS_INCLUDE_REPOSITORY 设置为 true 可为 OpenTelemetry 指标和事件添加标识会话所在仓库的 vcs.* 属性（默认：排除）。需要 Claude Code v2.1.269 或更高版本。请参阅仓库属性
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES 从 v2.1.161 起，Claude Code 会将 OTEL_RESOURCE_ATTRIBUTES 键附加到指标数据点标签上。设置为 false 可将其排除（默认：包含）。请参阅监控
OTEL_METRICS_INCLUDE_SESSION_ID 设置为 false 可从指标属性中排除会话 ID（默认：包含）。请参阅监控
OTEL_METRICS_INCLUDE_VERSION 设置为 true 可在指标属性中包含 Claude Code 版本（默认：排除）。请参阅监控
SLASH_COMMAND_TOOL_CHAR_BUDGET 覆盖向 Skill 工具显示的 skill 元数据的字符预算。该预算按上下文窗口的 1% 动态缩放，回退值为 8,000 个字符。保留旧名称以实现向后兼容
TASK_MAX_OUTPUT_LENGTH 已在 v2.1.277 中移除，现在不起作用，其所限定大小的 TaskOutput 工具也一并移除。之前用于设置 TaskOutput 工具保留的后台任务输出的最大字符数。Claude 现在改用 Read 读取后台任务的输出文件
USE_BUILTIN_RIPGREP 设置为 0 可使用系统安装的 rg，而不是 Claude Code 自带的 rg
VERTEX_REGION_CLAUDE_3_5_HAIKU 使用 Google Cloud's Agent Platform 时覆盖 Claude 3.5 Haiku 的区域
VERTEX_REGION_CLAUDE_3_5_SONNET 使用 Google Cloud's Agent Platform 时覆盖 Claude 3.5 Sonnet 的区域
VERTEX_REGION_CLAUDE_3_7_SONNET 使用 Google Cloud's Agent Platform 时覆盖 Claude 3.7 Sonnet 的区域
VERTEX_REGION_CLAUDE_4_0_OPUS 使用 Google Cloud's Agent Platform 时覆盖 Claude 4.0 Opus 的区域
VERTEX_REGION_CLAUDE_4_0_SONNET 使用 Google Cloud's Agent Platform 时覆盖 Claude 4.0 Sonnet 的区域
VERTEX_REGION_CLAUDE_4_1_OPUS 使用 Google Cloud's Agent Platform 时覆盖 Claude 4.1 Opus 的区域
VERTEX_REGION_CLAUDE_4_5_OPUS 使用 Google Cloud's Agent Platform 时覆盖 Claude Opus 4.5 的区域
VERTEX_REGION_CLAUDE_4_5_SONNET 使用 Google Cloud's Agent Platform 时覆盖 Claude Sonnet 4.5 的区域
VERTEX_REGION_CLAUDE_4_6_OPUS 使用 Google Cloud's Agent Platform 时覆盖 Claude Opus 4.6 的区域
VERTEX_REGION_CLAUDE_4_6_SONNET 使用 Google Cloud's Agent Platform 时覆盖 Claude Sonnet 4.6 的区域
VERTEX_REGION_CLAUDE_4_7_OPUS 使用 Google Cloud's Agent Platform 时覆盖 Claude Opus 4.7 的区域
VERTEX_REGION_CLAUDE_4_8_OPUS 使用 Google Cloud's Agent Platform 时覆盖 Claude Opus 4.8 的区域
VERTEX_REGION_CLAUDE_5_5_OPUS 使用 Google Cloud's Agent Platform 时覆盖 Claude Opus 5.5 的区域。在 v2.1.280 中添加
VERTEX_REGION_CLAUDE_5_5_SONNET 使用 Google Cloud's Agent Platform 时覆盖 Claude Sonnet 5.5 的区域。在 v2.1.284 中添加
VERTEX_REGION_CLAUDE_5_OPUS 使用 Google Cloud's Agent Platform 时覆盖 Claude Opus 5 的区域。在 v2.1.219 中添加
VERTEX_REGION_CLAUDE_5_SONNET 使用 Google Cloud's Agent Platform 时覆盖 Claude Sonnet 5 的区域。在 v2.1.197 中添加
VERTEX_REGION_CLAUDE_FABLE_5 使用 Google Cloud's Agent Platform 时覆盖 Claude Fable 5 的区域。在 v2.1.170 中添加
VERTEX_REGION_CLAUDE_FABLE_5_1 使用 Google Cloud's Agent Platform 时覆盖 Claude Fable 5.1 的区域。在 v2.1.257 中添加
VERTEX_REGION_CLAUDE_HAIKU_4_5 使用 Google Cloud's Agent Platform 时覆盖 Claude Haiku 4.5 的区域

同样支持标准 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 以及特定于信号的变体）。有关配置详情，请参阅监控。

请在 shell、用户设置或托管设置中设置 CLAUDE_CODE_ENABLE_TELEMETRY，以及用于开启导出、选择导出目标或捕获内容的 OpenTelemetry 变量。Claude Code 会在项目设置和本地设置中忽略它们，但该部分描述的关闭值除外。OTEL_RESOURCE_ATTRIBUTES 以及导出间隔、超时和压缩相关变量（例如 OTEL_METRIC_EXPORT_INTERVAL）在项目设置和本地设置中仍然生效。

需要特性标志获取的功能

Claude Code 通过从 Anthropic 获取的特性标志来启用某些功能。Claude Code 在以下会话中跳过该获取：

  • 一个会话中，你设置了 DISABLE_GROWTHBOOK、DISABLE_TELEMETRY、DO_NOT_TRACK 或 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC；变量表中每个变量的行说明了哪些值会关闭获取
  • 一个第三方提供商上的会话，例如 Amazon Bedrock、AWS 上的 Claude Platform、Google Cloud 的 Agent Platform 或 Microsoft Foundry，除非嵌入 Claude Code 的主机平台设置了 CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
  • 一个 Claude apps gateway 会话

关闭获取后，你无法：

安装或升级后的第一个会话

在你安装 Claude Code 后的第一个会话中，或升级到添加功能的版本后，特性标志门控功能可能会丢失。该会话也可能以不同的权限模式启动，而不是你后来的会话所做的那样。Claude Code 在该会话期间获取标志，所以你的下一个会话具有该功能和通常的起始权限模式。

在全新安装后，在非交互式会话中（例如 claude -p、Agent SDK 或 VS Code 扩展），Claude Code 仍然可以在选择起始权限模式之前获取标志。

另请参阅