环境变量 - Claude Code Docs

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

在 shell 或设置文件中设置环境变量
当行为可以通过多种方式设置时，检查哪个值适用
查找 Claude Code 读取的变量
查看当变量关闭功能标志获取时，哪些功能停止工作

设置环境变量

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

在 shell 中设置变量

在启动 claude 之前设置变量：

macOS, Linux, WSL
Windows PowerShell
Windows CMD

export API_TIMEOUT_MS="1200000"
claude

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

$env:API_TIMEOUT_MS = "1200000"
claude

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

set API_TIMEOUT_MS=1200000
claude

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

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

macOS, Linux, WSL
Windows PowerShell
Windows CMD

echo $API_TIMEOUT_MS

echo $env:API_TIMEOUT_MS

echo %API_TIMEOUT_MS%

在设置文件中设置变量

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

~/.claude/settings.json

{
  "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。

对于启用或关闭某项行为的变量，设置为 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

每个变量所在行也会说明其自身的规则。

变量	用途
`ANTHROPIC_API_KEY`	作为 `X-Api-Key` 标头发送的 API 密钥。设置后，即使您已登录，也会使用此密钥，而不是您的 Claude Pro、Max、Ultra、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`）。请参阅 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_AUTOMOUNT_ROOTS`	Claude Code 在您工作目录上方的文件夹中查找 `CLAUDE.md`、skill 和 `.mcp.json` 等文件时要跳过的自动挂载根文件夹。当这些查找需要等待您的自动挂载程序时，请设置此项。在 Unix 上用 `:` 分隔多个路径，在 Windows 上用 `;` 分隔，并以不含符号链接的绝对路径给出每个路径。需要 Claude Code v2.1.323 或更高版本
`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_CONFIG_LOCK_WAIT_MS`	添加或删除 `user` 或 `local` 作用域 MCP 服务器的命令（例如 `claude mcp add`）在失败之前持续尝试获取 `~/.claude.json` 锁的毫秒数。未设置时，该命令会等待约 10 到 20 秒，设置更短的值不会产生任何改变。需要 Claude Code v2.1.318 或更高版本
`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、PowerShell 和子代理工具中移除 `run_in_background` 参数，并关闭 Ctrl+B 快捷键以及分叉 skill 的后台运行。Claude Code 随后也会停止自动将子代理、长时间 MCP 工具调用和超时的 shell 命令移至后台。MCP 任务和 Monitor 工具仍会在后台运行。若要同时关闭后台会话，请将 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 设置为 `1`
`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_BG_STABLE_PATH`	在使用原生安装程序的 macOS 上，设置为 `1` 可从已安装的二进制文件运行每个后台会话的宿主进程，而不是从 `~/.local/share/claude/ClaudeCode.app` 运行。macOS 随后可能会再次请求文件夹访问等权限，包括在每次更新之后。请在用户设置、托管设置文件或 MDM 策略的 `env` 块中设置它，而不是在 shell 中设置。要移除 `ClaudeCode.app`，请自行删除。需要 Claude Code v2.1.295 或更高版本
`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`	适用于嵌入 Claude Code 并提供自己的浏览器指导的宿主。设置为 `1` 可在保留 Claude in Chrome 浏览器工具可用的同时，省略系统提示词中的 Chrome 部分以及 `/claude-in-chrome` 随附 skill。在 VS Code 中，v2.1.314 或更高版本的扩展还会将 Claude in Chrome 指令排除在会话消息之外。需要 Claude Code v2.1.257 或更高版本
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	设置为 `1` 可阻止将任何 CLAUDE.md 记忆文件加载到上下文中，包括用户、项目和自动记忆文件
`CLAUDE_CODE_DISABLE_CRON`	设置为 `1` 可禁用会话作用域的定时任务。`/loop` skill 和 `CronCreate` 将不可用，任何已安排的任务都会停止触发，包括会话中途已在运行的任务
`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`	设为 `1` 可关闭 `auto` 和 `bypassPermissions` 模式下针对关键路径删除操作的时间限制和拒绝。这些删除操作随后在 `auto` 模式下交由分类器处理，在 `bypassPermissions` 模式下，只要 Claude Code 能够显示提示，就会显示不限时的提示。请在启动 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_FEATURE_FLAGS`	设置为 `1` 可关闭功能标志获取。需要 Claude Code v2.1.319 或更高版本。设置此变量后，Remote Control 和其他需要获取功能标志的功能将不可用。除非同时设置了 `DISABLE_TELEMETRY`，否则遥测事件日志记录保持开启。旧名称 `DISABLE_GROWTHBOOK` 仍然有效，并且它是 v2.1.124 至 v2.1.318 唯一读取的名称
`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_MCP_TASK_BACKGROUND`	设置为 `1` 可让 Claude 在交互会话中等待 MCP 任务的结果。当自动后台化开启时，默认情况下它仍会在两分钟后将该调用移至后台。需要 Claude Code v2.1.304 或更高版本
`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_ULTRAREVIEW_TRUST_CHECK`	设置为 `1` 后，当 `claude ultrareview` 在您尚未信任的文件夹中无法询问您是否信任该文件夹时（例如在 CI 中），它不会以 `Error: Workspace not trusted` 退出。请在启动 Claude Code 的环境中设置它，而不是在设置 `env` 块中设置，并且仅在每次此类运行都从您信任的文件夹开始的环境中设置。能够询问的运行仍会询问。需要 Claude Code v2.1.309 或更高版本
`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_DROP_UNAVAILABLE_DEFERRED_TOOL`	设置为 `1`，在使用 `-p` 恢复时，丢弃其工具不可用的延迟工具调用。未设置此变量时，该调用会保持挂起状态，您发送的提示词不会到达 Claude。需要 Claude Code v2.1.319 或更高版本
`CLAUDE_CODE_EFFORT_LEVEL`	为支持的模型设置 effort 级别。取值：`low`、`medium`、`high`、`xhigh` 或 `max`。可用级别取决于模型。优先于 `--effort`、`/effort` 以及 `modelSettings` 和 `effortLevel` 设置。`maxEffortLevel` 上限仍然适用。设置为 `auto` 或 `unset` 可让 Claude Code 不发送 effort 级别，从而由 API 为该模型应用其自身的默认值。请参阅调整 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_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS`	设置为 `1` 可在 `bypassPermissions` 模式下无提示地运行危险的 `rm` 命令，这会移除针对破坏性删除的安全提示。链接的章节列出了该变量不生效的情况。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略设置 `env` 块中的该变量。需要 Claude Code v2.1.311 或更高版本
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	查询循环进入空闲状态后、自动退出前等待的时间（毫秒）。适用于使用 SDK 模式的自动化工作流和脚本
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	设置为 `1` 可启用 agent team。agent team 为实验性功能，默认禁用
`CLAUDE_CODE_EXPERIMENTAL_CODE_MODE`	设置为 `1` 可在 Code Mode（一项实验性功能）中启动会话。设置为 `0` 可保持关闭，或在托管设置中设置以为组织阻止它。该变量并非在每个设置文件中都有效。请参阅版本和账户要求
`CLAUDE_CODE_EXTRA_BODY`	要合并到模型请求体顶层的 JSON 对象，但对话之外的某些请求（例如 `/model` 检查）除外。适用于传递 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` 以及在哪些情况下不应设置此变量
`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 和 Grep 工具搜索的超时时间（秒）。在大多数平台上默认为 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` 安装 IDE 扩展。等同于将 `autoInstallIdeExtension` 设置为 `false`。v2.1.318 之前的 Claude Code 版本在您于 VS Code、Cursor 或 Devin Desktop 终端中启动 `claude` 时也会安装或更新该扩展。此变量也会阻止这一行为
`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 等待 MCP 任务。需要 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 v2.1.292 或更高版本
`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`	对被 API 以 `529` 过载错误拒绝的请求进行重试时，退避的上限（毫秒，默认值：32000）。调高此值可使后续重试的间隔持续拉大。请以纯数字给出 32000 到 300000 之间的整数毫秒数；Claude Code 会将其他任何值视为未设置。大于 64000 的值需要 v2.1.323 或更高版本。请参阅它何时不起作用。需要 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`	控制 mod 在其文件更改时是否重新加载。默认情况下，skill 目录中的 mod 会在任何包含多个提示词的会话中重新加载，包括非交互会话。`--plugin-dir` 目录中的 mod 仅在交互式终端会话中重新加载。设置为 `1` 可使它们像 skill 目录中的 mod 一样重新加载，设置为 `0` 则在所有地方关闭重新加载。需要 Claude Code v2.1.287 或更高版本
`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_PROVIDER_MANAGED_BY_HOST` 时，请在启动 Claude Code 的进程的环境中设置此变量
`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_HINT_COMMAND`	在启动 Claude Code 的包装脚本中，将此变量设置为您运行该包装脚本时输入的名称，例如 `mytool`。这样，本地会话在退出时会打印 `mytool --resume <session-id>`，而不是 `claude --resume <session-id>`。Claude Code 会忽略不匹配 `^\w[\w-]*$` 的名称。它还会在设置文件的 `env` 块中忽略此变量。需要 Claude Code v2.1.323 或更高版本
`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_RESUME_SHOWS_CUT_OFF_CALLS`	设置为 `1` 可在 `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 继续的轮次中保留被中断的工具调用，并将其标记为已截断。未设置时，这些调用会在轮次继续之前被丢弃。某些调用仍会被丢弃，例如对子代理、skill、工作流以及等待人工操作的工具的调用。对于 VS Code 聊天面板，请参阅重新加载后继续对话。需要 Claude Code v2.1.309 或更高版本
`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`	设置为 `1` 可让 Claude Code 下载为您的 claude.ai 账户启用的 skill。在使用 `-p` 标志的非交互模式下，Claude Code 还会在运行第一次查询之前最多等待 `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` 以获取 skill 列表。需要 claude.ai 身份验证。使用 claude.ai 账户登录的终端会话无需此变量即可同步这些 skill。在交互式会话中，此变量需要 v2.1.323 或更高版本
`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` 可关闭功能标志获取。需要 Claude Code v2.1.124 或更高版本。已被 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 取代，后者需要 v2.1.319 或更高版本：请使用该名称，除非有运行 v2.1.318 或更早版本的机器读取该配置。此名称仍然有效
`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 超链接。未设置时，Claude Code 仅在检测到终端支持时才启用大多数超链接。底部栏中的 PR 或合并请求徽章和较长的登录 URL 无论如何都是链接。设置为 `0`、`false`、`no` 或 `off` 可将它们全部渲染为纯文本。在 v2.1.314 之前，`false`、`no` 和 `off` 反而会启用超链接
`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` 可探测支持该修订版的服务器类型。未设置时，Claude Code 会探测它们，但可能会跳过某些服务器。任何其他值都会被忽略，并在调试日志中记录警告。需要 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_FABLE_5_2`	使用 Google Cloud’s Agent Platform 时覆盖 Claude Fable 5.2 的区域。在 v2.1.321 中添加
`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 会跳过该获取操作：

设置了 CLAUDE_CODE_DISABLE_FEATURE_FLAGS、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_DISABLE_NONESSENTIAL_TRAFFIC 或 CLAUDE_CODE_DISABLE_FEATURE_FLAGS 的情况下使用 Remote Control。关于 DISABLE_TELEMETRY 和 DO_NOT_TRACK，请参阅 Remote Control 要求
在 Remote Control 不可用时向本机以外的会话发送消息。关闭获取后，本机上会话之间的消息传递仍可正常工作
运行 claude import 或 /import 命令
运行 /skill-doctor 或在 /plugin 的 Stats 选项卡中打开其报告
在 Pro、Max 和 Ultra 计划中运行 /restart
将您的 claude.ai 账户中启用的 skill 和插件同步到终端会话中
启用 You should know mod
使用 advisor 工具，但在 Claude Platform on AWS 上使用 Claude Code v2.1.300 或更高版本时除外
使用 MCP 任务
启用 Code Mode
阅读或回复 Artifact 上的评论
让 Claude 读取其他组织的公开 Artifact
在安装了 Git Bash 的 Windows 上，为 claude.ai 和 Console 账户默认获得 PowerShell 工具；除非您设置了 CLAUDE_CODE_USE_POWERSHELL_TOOL=1，否则 Claude Code 会通过 Git Bash 执行 shell 命令。在未安装 Git Bash 的 Windows 上，该工具保持启用
获得 Claude 起草的反馈，该功能由 Claude Code 通过获取的标志启用
让 Claude 将大段粘贴内容视为粘贴而非键入的文本；[Pasted text #N] 占位符背后的内容将以无标记形式传给 Claude
让 Claude Code 排除其输入 schema 会被 API 拒绝的 MCP 工具

安装或升级后的首个会话

在您安装 Claude Code 后，或升级到新增某项功能的版本后，首个会话中可能缺少受标志控制的功能。Claude Code 在该会话期间获取功能标志后，会将其保存在本机上，因此您在该机器上的下一个会话将具备该功能。在以下这类设置中，首个会话之后的会话同样会在没有新获取标志的情况下启动：

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

另请参阅

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