SpyBara
Go Premium

env-vars.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

This page contains 303 additions and 300 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 23:58 Mon 5 23:58 Tue 6 23:59 Wed 7 23:59 Thu 8 22:58 Fri 9 23:02 Sat 10 23:01 Sun 11 23:57 Tue 13 23:57 Wed 14 22:58 Thu 15 23:58 Sat 17 23:57 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Mon 26 22:57 Tue 27 22:59 Wed 28 23:57 Thu 29 23:57 Fri 30 23:01

环境变量

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

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

本页面涵盖以下内容：

设置环境变量

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

在 shell 中设置变量

在启动 claude 之前设置变量：

macOS, Linux, WSL

export API_TIMEOUT_MS="1200000"
claude

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

Windows PowerShell

$env:API_TIMEOUT_MS = "1200000"
claude

要为每个会话设置它，请运行 [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") 并打开一个新终端。

Windows CMD

set API_TIMEOUT_MS=1200000
claude

要为每个会话设置它，请运行 setx API_TIMEOUT_MS "1200000" 并打开一个新终端。

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

macOS, Linux, WSL

echo $API_TIMEOUT_MS

Windows PowerShell

echo $env:API_TIMEOUT_MS

Windows CMD

echo %API_TIMEOUT_MS%

在设置文件中设置变量

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

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

Claude Code 会按原样将这些值复制到其环境中。这些值不经过任何 shell 处理，因此 ~ 或 $HOME 等简写会保持输入时的原样。对于接受路径的变量（例如 CLAUDE_CONFIG_DIR），请写入绝对路径："CLAUDE_CONFIG_DIR": "/home/you/.claude-work"。

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

文件 应用于
~/.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。

[!NOTE]

对于启用或关闭某项行为的变量，设置为 1、true、yes 或 on 即可启用，设置为 0、false、no 或 off 即可关闭，不区分大小写。

某些变量只读取您是否设置了它们，因此任何非空值（包括 0）都会启用该行为；要关闭该行为，请取消设置该变量或将其设置为空值。以下变量按这种方式工作：

  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
  • DISABLE_TELEMETRY
  • DISABLE_ERROR_REPORTING
  • CLAUDE_CODE_TMUX_TRUECOLOR
  • IS_DEMO

另有一个变量有其自己的规则：FORCE_HYPERLINK 读取一个数字，因此只有 0 会将其关闭。每个变量所在行也会说明其自身的规则。

变量 用途
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 Console 中生成。作为 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 工具搜索时会发生什么，请参阅通过 LLM 网关进行工具搜索。自 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 要包含在 API 请求中的额外 anthropic-beta 标头值的逗号分隔列表。Claude Code 已经会发送其所需的 beta 标头；使用此变量可在 Claude Code 添加原生支持之前选择启用某个 Anthropic API beta。与需要 API 密钥身份验证的 --betas 标志不同，此变量适用于所有身份验证方式，包括 Claude.ai 订阅
ANTHROPIC_CUSTOM_HEADERS 要添加到请求中的自定义标头（Name: Value 格式，多个标头以换行分隔）。如果名称或值包含 HTTP 标头无法承载的字符（例如弯引号或零宽空格），请求将失败，并返回按位置标识该名称/值对的错误。需要 Claude Code v2.1.227 或更高版本。Invalid request header value 列出了确切的字符集以及检查的运行位置。当服务器托管设置下发时，设置凭据、组织或租户、路由或 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。当您设置正值时，每次非流式请求尝试都必须在此时间内完成。当请求在慢速网络上或通过代理路由时超时，请增大此值。设置为 0 可移除此限制，这需要 Claude Code v2.1.305 或更高版本。设置为 0 时，在本地会话中非流式尝试仍会在 300 秒后超时
AWS_BEARER_TOKEN_BEDROCK 用于身份验证的 Amazon Bedrock API 密钥（请参阅 Amazon Bedrock API 密钥）
BASH_DEFAULT_TIMEOUT_MS 前台 Bash 或 PowerShell 工具命令的默认超时时间，以毫秒为单位（默认值：120000，即 2 分钟）。高于后台命令默认时间限制的值会在无人值守会话中替换该默认值。后台时间限制需要 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/HTTP 端点：设置 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_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 子代理的停滞超时时间，以毫秒为单位。在 Claude Code v2.1.286 或更高版本上也涵盖工作流 Agent。默认 600000（10 分钟）；如果您在流式看门狗开启时提高 CLAUDE_STREAM_IDLE_TIMEOUT_MS，默认值会随之提高，如处理缓慢或停滞的 API 响应所述
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 设置触发自动压缩时自动压缩窗口的百分比（1-100）。使用较低的值（如 50）可更早压缩；该变量无法提高阈值，因此高于默认百分比的值会被忽略。它仅适用于在达到模型上下文限制之前进行压缩的会话。同时适用于主对话和子代理
CLAUDE_AUTO_BACKGROUND_TASKS 设置为 1 可强制启用长时间运行的 Agent 任务的自动后台化。启用后，子代理在运行约两分钟后会转入后台。如果 Claude 在该子代理之后排队了文件编辑等工具调用，该子代理会先在前台完成，然后该调用才开始。在 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 可在全屏渲染中每帧重绘整个屏幕，而不是发送增量更新。如果全屏模式显示过时或错位的文本片段，请使用此变量。在 Windows 上，Claude Code 会为后台会话和 Agent 视图自动启用此功能
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT 设为 1 可在每个请求中发送 effort 参数，即使 Claude Code 未将该模型 ID 识别为支持 effort。通过 LLM 网关或以自定义标识符提供模型的第三方提供商路由时使用。在 API 层拒绝 effort 参数的模型（包括 Claude Opus 4.1、Claude Sonnet 4.5、Claude 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_ARTIFACT_PUBLISH_EDITS 设置为 0 可阻止 Claude 在发布 Artifact 时对其文件应用小的更改。Claude 随后会使用其文件编辑工具编辑文件，并作为单独的步骤发布。需要 Claude Code v2.1.300 或更高版本
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 已在 v2.1.283 中移除。请改用 CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE
CLAUDE_CODE_AUTO_COMPACT_WINDOW 设置自动压缩窗口，即上下文填充到多满时进行压缩，范围为 100000 到 1000000 个 token。带后缀的值（如 200k）需要 v2.1.304 或更高版本。关于它与设置该窗口的其他方式之间的优先级，以及它对状态栏 used_percentage 的影响，请参阅设置自动压缩窗口
CLAUDE_CODE_AUTO_CONNECT_IDE 覆盖自动 IDE 连接。默认情况下，在受支持 IDE 的集成终端中启动时，Claude Code 会自动连接。设置为 false 可阻止此行为。设置为 true 可在自动检测失败时强制尝试连接，例如当 tmux 遮蔽了父终端时。优先于 autoConnectIde 全局配置设置
CLAUDE_CODE_AUTO_MODE_MODEL 设置 Claude Code 在自动模式下发送的分类器请求所使用的模型。请使用完整的模型 ID，例如 claude-sonnet-4-6。有关 Claude Code 会忽略它的情况，请参阅选择分类器模型。需要 Claude Code v2.1.302 或更高版本
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 登录），请提高此值。适用于 Amazon Bedrock、Claude Platform on AWS 和 Mantle 端点。请参阅凭据缓存和解析超时。需要 Claude Code v2.1.207 或更高版本
CLAUDE_CODE_BASH_EDIT_DIFF 设置为 0 可关闭 Bash 命令运行期间更改的文件的 diff，设置为 1 可在每种权限模式下记录该 diff。优先于 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 上下文窗口支持。Claude Code 会从模型选择器中移除 [1m] 模型变体，并将默认使用 1M 窗口运行的模型限制为 200K 窗口。请参阅关闭 1M 上下文。适用于有合规要求的企业环境。有关其在纠正无法识别的 [1m] 模型 ID 的窗口方面的作用，请参阅纠正网关或自定义模型 ID 的窗口
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 设置为 1 可在 Opus 4.6 和 Sonnet 4.6 上禁用自适应推理，并回退到由 MAX_THINKING_TOKENS 控制的固定思考预算。对 Fable 模型、Sonnet 5 及更高版本、Haiku 5.5 或 Opus 4.7 及更高版本不起作用，这些模型始终使用自适应推理
CLAUDE_CODE_DISABLE_ADVISOR_TOOL 设置为 1 可禁用 advisor 工具。/advisor 命令将不可用，任何已配置的 advisorModel 都会被忽略，--advisor 标志会被接受但不起作用，因此传递该标志的现有脚本可以继续运行而不会出错
CLAUDE_CODE_DISABLE_AGENT_VIEW 设置为 1 可关闭后台 Agent 和 Agent 视图：claude agents、--bg、/background 以及按需启动的 supervisor。等同于 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 Code v2.1.196 或更高版本
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP 设置为 1 可阻止 Claude Code 在内存压力下终止后台 shell 命令。默认情况下，在 macOS 和 Linux 上，当操作系统报告严重内存压力，且会话已空闲 30 分钟、没有轮次或子代理在运行时，Claude Code 会终止后台 shell。Windows 没有内存压力信号，因此此变量在 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 工具架构字段。当代理网关因 anthropic-beta 标头返回 Unexpected value(s) 错误或返回 Extra inputs are not permitted 错误而拒绝请求时使用。禁用预发布功能列出了该变量移除的内容（包括 MCP 工具搜索）以及 Claude Code 仍会发送的内容
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS 设置为 1 可禁用内置的 Explore 和 Plan 子代理。Claude 会改用其搜索工具或 general-purpose 子代理进行探索，计划模式会直接读取文件，而不是启动 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_FILE_MENTIONS 设置为 1 可阻止 Claude Code 展开文件和目录的 @ 提及。Claude 会改为获得所提及的路径，并附带一条让其使用文件工具读取这些路径的说明。在项目和本地设置中会被忽略。需要 Claude Code v2.1.299 或更高版本
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 设置为 1 可从 Claude 的上下文中移除内置的提交和 PR 工作流说明以及 git 状态快照。在使用您自己的 git 工作流 skill 时很有用。设置后优先于 includeGitInstructions 设置
CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT 设置为 1 可阻止 Claude Code 读取通过 -c 传递给 shell 的脚本（例如 bash -c 'rm -rf ~'）以检查关键路径删除。Claude Code 仍会检查这些脚本中的 shell 变量和位置参数目标，其他关键路径检查也会继续运行。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略通过设置 env 块传递的副本。需要 Claude Code v2.1.288 或更高版本
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP 设为 1 可阻止在 Anthropic API 上将 Opus 4 和 Opus 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_MOUNTED_DRIVE_RM_PROMPT 设置为 1 可关闭针对 /Volumes/USB 等路径的已挂载驱动器提示。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略设置 env 块中的该变量。需要 Claude Code v2.1.304 或更高版本
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 运行您的针对未回答权限请求的 Notification hook，适用于 Claude Code 将这些请求发送到 Agent SDK 的 canUseTool 回调的会话，Claude Desktop 和 VS Code 扩展正是以这种方式托管 Claude Code。在终端会话中不起作用。需要 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_REFUSAL_FALLBACK 设置为 1 可关闭安全分类器标记请求时的自动模型切换，即由 switchModelsOnFlag 设置控制的行为
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、Haiku 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_EMIT_SESSION_STATE_EVENTS 设置为 1 可在消息流中添加携带会话状态的 session_state_changed 消息。需要使用 Agent SDK，或同时使用 --print、--output-format stream-json 和 --verbose
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_CFC 设置为 1 可在启动 CLI 会话时开启 Chrome 集成，设置为 0 则在启动时关闭。优先于 claudeInChromeDefaultEnabled 设置。--chrome 和 --no-chrome 标志优先于两者。Claude Code 会忽略项目设置和本地设置中的 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 当 ANTHROPIC_BASE_URL 指向与 Anthropic 兼容的网关（例如 LiteLLM、Kong 或内部代理）时，设置为 1 可从网关的 /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_SHARE_BUNDLE 设置为 1 可使 /share 将其报告和整个会话记录保存到 ~/.claude/feedback-bundles/ 下的本地归档，而不是将报告发送给 Anthropic。如果您组织的策略关闭了 /share，则无法通过此变量重新开启。需要 Claude Code v2.1.299 或更高版本
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 限制，默认值为 25,000 个 token。适用于需要完整读取较大文件的情况。当上下文窗口有余量时，Claude 使用 allow_large 参数进行的读取可以超过此限制
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 当终端支持删除线但未被自动检测到时（例如通过 SSH 连接且未转发 TERM_PROGRAM），设置为 1 可强制将 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_FORCE_TERMINAL_IMAGES 当您的终端使用 Unicode 占位符绘制 kitty 图形协议图像，但您仍看到 Image 的灰显 alt 文本时，设置为 1 可将 mod Image 元素绘制为图片。请参阅哪些终端会绘制 Image，以及为什么此变量在 tmux 或 screen 中无效
CLAUDE_CODE_FORK_SUBAGENT 控制 fork 模式，该模式默认开启，允许 Claude 自行启动 fork。在 fork 模式开启时，Claude 在您机器上的交互式终端、VS Code 或桌面会话中也无法等待子代理。设置为 0 可关闭 fork 模式。有关版本信息，请参阅关闭 fork 模式
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT 设置为 1 可在 claude -p --output-format stream-json 输出中发出子代理的文本和思考块，行为与 --forward-subagent-text 标志相同。当调用 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_GZIP_REQUEST_BODIES 设置为 0 可关闭对发送到 api.anthropic.com 的 Claude API、遥测和 Artifact 发布请求体的 gzip 压缩。默认情况下，Claude Code 会在直接连接时压缩较大的请求体，而在您通过代理发送请求、配置客户端证书或设置 NODE_EXTRA_CA_CERTS 时跳过压缩。如果 Claude Code 无法检测到的 TLS 检查代理无法正确处理压缩请求，请使用 0
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_IDLE_COMPACT_MIN_TOKENS 对对话应用空闲压缩的上下文大小（以 token 计）（默认值：200000）。接受正整数，其他值会被忽略。低于 100000 的值会被提高到最低阈值 100000。对于满足条件的对话，空闲压缩默认开启。要关闭它，请将 idleCompaction 设置为 false。需要 Claude Code v2.1.290 或更高版本
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 服务器说明的最大长度（字符）。您设置的值会替换两个默认限制：4096，以及 Claude 通过工具搜索加载的工具描述的 16384。接受纯数字形式的正整数。其他任何值都会被忽略并应用默认值。需要 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）。遇到 529 过载错误时，重试可能会更早停止。例如，在 Opus 模型上使用 API 密钥时，会在第三次 529 时停止并显示 Repeated 529 Overloaded errors。如果您设置了备用模型，Claude Code 会切换到该模型，而不是显示错误。从 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_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 可在启动 stdio MCP 服务器时仅提供安全的基线环境加上服务器配置的 env，而不是继承您的 shell 环境
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS 仍在运行的 MCP 工具调用在经过多长时间（毫秒）后转为后台任务（默认：120000，即 2 分钟）。设置为 0 可关闭自动转入后台。需要 Claude Code v2.1.212 或更高版本
CLAUDE_CODE_MCP_STARTUP_WAIT_MS 非交互会话的第一个轮次等待仍在连接中的 MCP 服务器的时长（毫秒），用以替代默认的首轮等待。在自托管环境中，它只改变等待持续的时长。某些服务器无论该值如何都会保留自己的等待；连接时机列出了这些服务器。设置为 0 可跳过对其他所有服务器的等待。需要 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 中至少为 1000 的单服务器 timeout 会将该服务器的空闲窗口提高到至少等于 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 可在输入插入点显示终端自身的光标，而不是绘制的方块。该光标会遵循终端的闪烁、形状和焦点设置。设置为 0 与不设置该变量效果相同，因此在终端自身光标已开启的会话中，它不会恢复绘制的方块
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 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_OVERLOADED_RETRY_BASE_DELAY_MS 对于被 API 以 529 过载错误拒绝的请求，自动重试之间指数退避的起始延迟（毫秒），用于替代默认的 500。当 API 达到容量上限时，调高此值可将重试分散到更长的时间窗口内。请以纯数字给出 500 到 32000 之间的整数毫秒数；Claude Code 会将其他任何值视为未设置。当 CLAUDE_CODE_RETRY_WATCHDOG 设置为 1 时，或被拒绝的请求是在快速模式下发送的时，此变量不起作用。需要 Claude Code v2.1.292 或更高版本
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS 对于 API 以 529 过载错误拒绝的请求，自动重试之间指数退避的上限（毫秒），用于替代默认的 32000。提高此值可使后续重试在 API 容量已满时继续拉开间隔。以纯数字给出 32000 到 64000 之间的整数毫秒数；Claude Code 会将任何其他值视为未设置。当 CLAUDE_CODE_RETRY_WATCHDOG 设置为 1 时，或被拒绝的请求是在快速模式下发送时，此变量无效。需要 Claude Code v2.1.296 或更高版本
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_DIR_WATCH 控制 Claude Code 是否在 mod 的文件发生变化时重新加载该 mod。重新加载适用于您通过 --plugin-dir 从目录加载的 mod，在交互式会话中默认开启。设置为 1 可同时在非交互式会话中开启，设置为 0 则在所有会话中关闭。需要 Claude Code v2.1.287 或更高版本。请参阅 mod 设置和环境变量
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 可无限期等待。需要 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 对于评估测试框架、CI 作业或远程工作进程等无人值守会话，请设置为 1。会无限期重试 429 和 529 容量错误，而不是在尝试 CLAUDE_CODE_MAX_RETRIES 次后失败。当标准速度请求收到报告支出限额或使用额度耗尽的 429 时，Claude Code 会立即失败，即使该错误来自按计划重置的网关支出上限也是如此。在 v2.1.239 之前，看门狗会无限期重试这些错误。对于快速模式请求，请参阅处理速率限制。看门狗在两次尝试之间最多退避 5 分钟；当响应带有速率限制重置时间时，则会一直等到限制重置，因此达到用量限制的会话会等待剩余的时间窗口结束。在 v2.1.199 或更高版本中，它还会将其他临时性错误（例如服务器错误、超时和连接中断）的默认重试次数提高到 300（大约三小时的退避），并且如果您显式设置了 CLAUDE_CODE_MAX_RETRIES，还会取消该变量 15 次的上限。需要 Claude Code v2.1.186 或更高版本
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS 设置 CLAUDE_CODE_RETRY_WATCHDOG 时，每个 API 请求在等待 429 和 529 错误上所花费的最长时间（毫秒）。这段时间用完后，下一个此类错误将结束该请求。请以纯数字给出正整数，例如 1800000 表示 30 分钟。未设置时，等待没有限制。需要 Claude Code v2.1.295 或更高版本
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS 在设置了 CLAUDE_CODE_RETRY_WATCHDOG 且请求正在等待用量限制重置期间，检查该限制是否已提前解除的最小间隔（毫秒）。当检查发现限制已解除时，请求会立即发出。以纯数字给出从 60000（一分钟）到 10800000（三小时）之间的整数。仅在未使用使用额度时针对 claude.ai 订阅的会话限制或每周限制进行检查，并且在设置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 时不进行检查。当此变量未设置或其值超出该范围时，不进行任何检查。需要 Claude Code v2.1.305 或更高版本
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 在 Claude Code 的完整系统提示词和带有简略工具描述的较短系统提示词之间进行选择。未设置时，Haiku 4.5、Sonnet 5、Opus 4.7 以及这些系列中更早的模型默认使用完整提示词，更新的模型则使用较短的提示词。设置为 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 可从 Claude Code 启动的子进程（例如 Bash 命令、hook 和 stdio MCP 服务器）的环境中剥离凭据。清理会根据变量名或变量值识别凭据，并保留 GitHub 令牌和代理设置。请参阅子进程环境清理会移除哪些内容。配置 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.ai 身份验证。使用 claude.ai 账户登录的终端会话无需此变量即可同步这些 skill，因此仅当某次 -p 运行需要在第一次查询时就使用您当前的 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_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 不会透传真彩色转义序列。请在 ~/.tmux.conf 中添加 set -ga terminal-overrides ',*:Tc' 之后再设置此变量。有关其他 tmux 设置，请参阅终端配置
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE 在 Linux 和 WSL 上，设置为以逗号分隔的进程类型列表，例如 mcp 或 lsp，Claude Code 会将这些类型的进程排除在工具内存上限之外。设置为 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_TRANSCRIPT_LOCAL_GC 设置为 1 可限制长时间运行的 -p 或 Agent SDK 会话的会话记录文件的增长大小。每次压缩后，一旦文件大于 5 MB，Claude Code 会删除该次压缩之前的历史记录。在 v2.1.296 或更高版本中，如果删除这些历史记录只能让文件缩小不到 10%，则文件保持不变。无论文件是否被裁剪，恢复会话都会还原相同的对话。请在启动 Claude Code 的环境中设置此变量，因为设置中的 env 块无法启用它。需要 Claude Code v2.1.287 或更高版本
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_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 可启用它，这要求 PATH 中有 pwsh。在 Windows 上启用后，Claude 可以原生运行 PowerShell 命令，而无需通过 Git Bash 转发。请参阅 PowerShell 工具
CLAUDE_CODE_USE_VERTEX 使用 Google Cloud's Agent Platform
CLAUDE_CODE_WARN_DISK_FREE_GIB 设置为 GiB 整数（例如 10），当工作目录所在文件系统的可用空间低于该值时，Claude Code 会警告 Claude。该警告是一条说明剩余可用空间的系统提醒。当变量未设置、为 0 或不是纯数字时，该提醒处于关闭状态。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略通过设置中的 env 块传入的副本。需要 Claude Code v2.1.304 或更高版本
CLAUDE_CODE_WARN_MEMORY_FREE_GIB 在 Linux 和 WSL 上，设置为 GiB 整数（例如 4），当可用内存低于该值时，Claude Code 会警告 Claude。该警告是一条说明可用内存量的系统提醒。当变量未设置、为 0 或不是纯数字时，该提醒处于关闭状态。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略通过设置中的 env 块传入的副本。需要 Claude Code v2.1.304 或更高版本
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_WEB_SEARCH_REFILLS_PER_HOUR 会话的 WebSearch 限制的补充速率，单位为每小时调用次数。在交互式终端会话中默认值为 100。在非交互会话中默认值为 0，即关闭补充。仅接受纯数字；任何其他写法都视为未设置。需要 Claude Code v2.1.290 或更高版本
CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE 当 CLAUDE_AUTO_BACKGROUND_TASKS 设置为 1 时，Claude Code 每次提醒 Claude 检查仍在运行的后台子代理之前等待的时长。接受一个或多个以逗号分隔的等待时间，单位为整秒，范围为 1 到 86400，例如 600 或 600,1800,3600。每个值是下一次提醒之前的等待时间，最后一个值会重复使用。仅接受纯数字；任何其他值或写法都视为未设置。未设置时不会有提醒。需要 Claude Code v2.1.283 或更高版本
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 最多等待这么长时间，以便其余 Agent 读取已缓存的前缀，而不是各自在未缓存的情况下处理它。默认值为 5000。设置为 0 可禁用等待。设置了 DISABLE_PROMPT_CACHING 时，Agent 从不等待。需要 Claude Code v2.1.229 或更高版本
CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG 设置为 1 可在输入框上方为 You should know mod 在本会话中进行的最近三次检查各显示一行。用于在没有出现任何备注时确认该 mod 正在进行检查。需要 Claude Code v2.1.287 或更高版本
CLAUDE_CONFIG_DIR 覆盖配置目录（默认：~/.claude）。所有设置、会话历史和插件都存储在此路径下。关于凭据，请参阅 Claude Code 存储凭据的位置。适用于同时运行多个账户：例如 alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'。请在 shell、用户设置或托管设置中设置它。在设置文件中，请写入绝对路径。在项目和本地设置中被忽略
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 会在每个 Bash 命令之前于同一 shell 进程中运行其内容，因此文件中的 export 对该命令可见。用于在命令之间保持 virtualenv 或 conda 的激活状态。在 v2.1.296 或更高版本中，PowerShell 命令也会在 PowerShell 命令中的持久化变量所述的条件下接收其变量。也会由 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 会在其生成的子进程（Bash 和 PowerShell 工具命令以及 hook 命令）中将此变量设置为自身的进程 ID。在 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 可禁用功能标志获取，并对每个标志使用代码中的默认值。这会使 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 可阻止发送 interleaved-thinking 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 设置为 1，并将 BETA_TRACING_ENDPOINT 设置为您的 OTLP/HTTP 收集器端点，即可开启详细 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 用户。对于在所含用量范围内的订阅用户，Claude Code 会在主对话上自动请求 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。对 Claude apps gateway 会话无效，即使网关路由到 Amazon Bedrock 也是如此
ENABLE_TOOL_SEARCH 控制 MCP 工具搜索。未设置或为 true 时会延迟加载 MCP 工具，但保持工具搜索关闭的情况除外。auto 会在工具定义达到上下文窗口的 10% 时开启工具搜索。auto:N 设置自定义阈值，例如 auto:5 表示 5%。false 会预先加载所有工具。如果网关拒绝工具搜索，请参阅通过 LLM 网关使用工具搜索
FORCE_AUTOUPDATE_PLUGINS 设置为 1 可在主自动更新程序已通过 DISABLE_AUTOUPDATER 禁用时仍强制插件自动更新
FORCE_HYPERLINK 设置为 1 可在您的终端支持可点击的 OSC 8 超链接但未被自动检测到时启用它们，设置为 0 可禁用它们。未设置时，Claude Code 仅在检测到终端支持时启用超链接。Claude Code 将此值解析为数字而非布尔值，因此 false、no 或 off 之类的值会启用超链接，而不是禁用它们。即使 Claude Code 无法检测到终端支持（例如通过 SSH 时），页脚的 PR 或合并请求徽章也会渲染为超链接。设置为 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 数（默认：25000）。当输出超过 10,000 个 token 时，Claude Code 会显示警告。声明了 anthropic/maxResultSizeChars 的工具会改为对文本内容使用该字符限制，但这些工具返回的图像内容仍受此变量约束。对于没有该注解的工具，超过 50,000 个字符的成功文本结果无论此变量如何设置都会被保存到文件
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。未设置且思考已启用时，支持自适应推理的模型会自行选择思考深度，其他模型则使用该上限。在 Anthropic API 上设置为 0 可禁用思考，但 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 模型除外，这些模型无法关闭思考。在第三方提供商上，0 会改为省略 thinking 参数。在 Anthropic API 上关闭思考时，对于 Claude Code 已知不接受该组合的模型（例如 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 的支持。设置为 legacy 可跳过探测，使每个服务器都使用该修订版之前的握手方式连接。设置为 auto 可探测支持探测的服务器类型：HTTP 和 stdio 服务器、claude.ai 连接器，以及云端会话和 Remote Control 会话的连接器。变量未设置时，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 字段会为该服务器覆盖此值。至少为 1000 的按服务器 timeout 还会为该服务器的工具调用设置最小空闲窗口，因此 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 Opus 4 的区域
VERTEX_REGION_CLAUDE_4_0_SONNET 使用 Google Cloud's Agent Platform 时覆盖 Claude Sonnet 4 的区域
VERTEX_REGION_CLAUDE_4_1_OPUS 使用 Google Cloud's Agent Platform 时覆盖 Claude Opus 4.1 的区域
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 的区域
VERTEX_REGION_CLAUDE_HAIKU_5_5 使用 Google Cloud's Agent Platform 时覆盖 Claude Haiku 5.5 的区域。在 v2.1.293 中添加

同样支持标准 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_SUBPROCESS_ENV_SCRUB 设置为 1 时，Claude Code 会从其启动的子进程（例如 Bash 命令、hook 和 stdio MCP 服务器）的环境中移除凭据。这可以减少提示词注入攻击所能读取的内容。Claude Code 进程本身会保留这些凭据，用于其自身的 API 调用。

清理功能通过变量名或变量值的形态来识别凭据，因此应将其作为与精细的权限规则配合使用的一层防护，而不是唯一的控制手段。

下表展示了清理功能对示例变量的处理方式：

示例变量 清理功能的处理方式
ANTHROPIC_API_KEY、AWS_SECRET_ACCESS_KEY 移除
NPM_TOKEN、DB_PASSWORD 移除，因为其名称看起来像凭据
包含密码的 DATABASE_URL 移除，因为其值看起来像凭据
包含密码的 PIP_INDEX_URL 或 NPM_CONFIG_REGISTRY 保留 URL，但从中删去用户名和密码
CLAUDE_CONFIG_DIR 移除
GITHUB_TOKEN、GH_TOKEN、GH_ENTERPRISE_TOKEN、GITHUB_ENTERPRISE_TOKEN 保留，以便 gh 和调用 GitHub API 的脚本能够继续正常工作
HTTP_PROXY、HTTPS_PROXY 保留，包括 URL 中的用户名和密码。沙箱可以自行为沙箱化的命令设置这些变量
GIT_CONFIG_COUNT、GIT_CONFIG_KEY_<n>、GIT_CONFIG_VALUE_<n> 保留，无论其内容为何
变量名和值都不像凭据的密钥 保留

由于清理功能会保留 GITHUB_TOKEN，请为 GitHub Actions 作业授予其所需的最小 permissions。要从沙箱化的 Bash 命令中移除 GitHub 令牌，请在 sandbox.credentials 下添加一个 deny 条目。

如果某个子进程需要用到被移除的变量之一，请不要设置清理功能。

在 Linux 上，清理功能还会在隔离的 PID 命名空间中运行 Bash 子进程，使其无法通过 /proc 读取主机进程的环境。这带来的一个副作用是，ps、pgrep 和 kill 无法看到主机进程，也无法向其发送信号。

在 v2.1.251 之前，清理功能会移除 ANTHROPIC_API_KEY 和 AWS_SECRET_ACCESS_KEY，而表中的其他示例变量保持不变。

需要获取功能标志的功能

Claude Code 通过从 Anthropic 获取的功能标志来启用部分功能。在以下会话中，Claude Code 会跳过该获取操作：

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

关闭获取后，您将无法：

安装或升级后的首个会话

在您安装 Claude Code 后，或升级到新增某项功能的版本后，首个会话中可能缺少受标志控制的功能。Claude Code 在该会话期间获取功能标志后，会将其保存在本机上，因此您在该机器上的下一个会话将具备该功能。

在以下这类设置中，首个会话之后的会话同样会在没有新获取标志的情况下启动：

  • 每次运行都是全新环境：如果每次运行都在 CI 容器中启动，或在任何没有先前会话所保存标志的其他环境中启动，那么每次运行都是首个会话
  • 使用网关令牌且没有 API 密钥：如果您使用 ANTHROPIC_AUTH_TOKEN 进行身份验证且没有 API 密钥，并且 ANTHROPIC_BASE_URL 指向 Anthropic 以外的主机（例如 LLM 网关），Claude Code 将没有可用于获取标志的凭据

另请参阅