{/* TRANSLATED — 已翻译为中文 */} > ## 文档索引 > 在此获取完整文档索引：https://code.claude.com/docs/llms.txt > 使用此文件发现所有可用页面，然后再进行进一步探索。 # 环境变量 > 控制 Claude Code 行为的环境变量参考。 环境变量可以控制 Claude Code 的行为，例如模型选择、身份验证、请求路由和功能开关。许多相同的行为也可以通过[设置文件](/en/settings)字段、[CLI 标志](/en/cli-reference)或会话内命令（如 `/model`）来配置。 本页介绍如何： * [设置环境变量](#set-environment-variables)（在 shell 中或在设置文件中） * [检查哪个值生效](#precedence)（当一个行为可以通过多种方式设置时） * [查阅 Claude Code 读取的变量](#variables) ## 设置环境变量 在 shell 中设置的变量仅在该终端会话期间有效，而设置文件中的变量则在每次运行 `claude` 时都会生效。 ### 在 shell 中 在启动 `claude` 之前设置变量： ```bash theme={null} export API_TIMEOUT_MS="1200000" claude ``` 要在每个会话中设置，请将 `export` 行添加到 `~/.bashrc`、`~/.zshrc` 或 shell 的配置文件中。 ```powershell theme={null} $env:API_TIMEOUT_MS = "1200000" claude ``` 要在每个会话中设置，请运行 `[Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User")` 并打开新终端。 ```batch theme={null} set API_TIMEOUT_MS=1200000 claude ``` 要在每个会话中设置，请运行 `setx API_TIMEOUT_MS "1200000"` 并打开新终端。 ### 在设置文件中 在 `settings.json` 文件的 `env` 键下添加变量。Claude Code 在启动时直接从文件中读取它们，因此无论 `claude` 是如何启动的，它们都会生效。 ```json ~/.claude/settings.json theme={null} { "env": { "API_TIMEOUT_MS": "1200000", "BASH_DEFAULT_TIMEOUT_MS": "300000" } } ``` 你选择的文件决定了变量适用于谁： | 文件 | 适用对象 | | :---------------------------- | :----------------------------------------------------------- | | `~/.claude/settings.json` | 你在所有项目中的设置 | | `.claude/settings.json` | 项目中所有协作者的设置，已纳入版本控制 | | `.claude/settings.local.json` | 仅你在本项目中的设置，不纳入版本控制 | | 托管设置 | 组织中所有人的设置，由管理员部署 | 参阅[设置文件](/en/settings#settings-files)了解每个文件的位置，参阅[设置优先级](/en/settings#settings-precedence)了解当多个文件设置相同变量时如何合并。 ## 优先级 当同一行为同时存在环境变量和设置字段时，环境变量优先。例如，`ANTHROPIC_MODEL` 覆盖 `model` 设置，`CLAUDE_CODE_AUTO_CONNECT_IDE` 覆盖 `autoConnectIde`。当环境变量未设置时，设置字段生效。 环境变量与 CLI 标志和会话内命令的交互方式因功能而异：`--model` 和 `/model` 覆盖 `ANTHROPIC_MODEL`，而 `CLAUDE_CODE_EFFORT_LEVEL` 覆盖 `/effort`。当变量与其他配置源交互时，其在[变量](#variables)列表中的行会说明优先级或链接到相关文档页面。 Claude Code 在启动时读取环境变量，因此更改在下次启动 `claude` 时生效。 ## 变量 | 变量 | 用途 | | :------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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` | [AWS 上的 Claude 平台](/en/claude-platform-on-aws)的工作区 API 密钥，在 AWS 控制台中生成。作为 `x-api-key` 发送，优先于 AWS SigV4 | | `ANTHROPIC_AWS_BASE_URL` | 覆盖 [AWS 上的 Claude 平台](/en/claude-platform-on-aws)的端点 URL。用于自定义区域或通过 [LLM 网关](/en/llm-gateway)路由。默认为 `https://aws-external-anthropic.{AWS_REGION}.api.aws` | | `ANTHROPIC_AWS_WORKSPACE_ID` | [AWS 上的 Claude 平台](/en/claude-platform-on-aws)的必需项。在每个请求中作为 `anthropic-workspace-id` 头发送 | | `ANTHROPIC_BASE_URL` | 覆盖 API 端点以通过代理或网关路由请求。当设置为非第一方主机时，[MCP 工具搜索](/en/mcp#scale-with-mcp-tool-search)默认禁用。如果你的代理转发 `tool_reference` 块，请设置 `ENABLE_TOOL_SEARCH=true` | | `ANTHROPIC_BEDROCK_BASE_URL` | 覆盖 Bedrock 端点 URL。用于自定义 Bedrock 端点或通过 [LLM 网关](/en/llm-gateway)路由。参阅 [Amazon Bedrock](/en/amazon-bedrock) | | `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | 覆盖 Bedrock Mantle 端点 URL。参阅 [Mantle 端点](/en/amazon-bedrock#use-the-mantle-endpoint) | | `ANTHROPIC_BEDROCK_SERVICE_TIER` | Bedrock [服务层级](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)（`default`、`flex` 或 `priority`）。作为 `X-Amzn-Bedrock-Service-Tier` 头发送。参阅 [Amazon Bedrock](/en/amazon-bedrock#service-tiers) | | `ANTHROPIC_BETAS` | 逗号分隔的附加 `anthropic-beta` 头值列表，包含在 API 请求中。Claude Code 已发送所需的 beta 头；在 Claude Code 添加原生支持之前，使用此选项加入 [Anthropic API beta](https://platform.claude.com/docs/en/api/beta-headers)。与需要 API 密钥认证的 [`--betas` 标志](/en/cli-reference#cli-flags)不同，此变量适用于所有身份验证方法，包括 Claude.ai 订阅 | | `ANTHROPIC_CUSTOM_HEADERS` | 添加到请求的自定义头（`Name: Value` 格式，多个头用换行符分隔） | | `ANTHROPIC_CUSTOM_MODEL_OPTION` | 作为自定义条目添加到 `/model` 选择器的模型 ID。用于使非标准或网关特定的模型可选择，而不替换内置别名。参阅[模型配置](/en/model-config#add-a-custom-model-option) | | `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 选择器中自定义模型条目的显示描述。未设置时默认为 `Custom model ()` | | `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 选择器中自定义模型条目的显示名称。未设置时默认为模型 ID | | `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | 参阅[模型配置](/en/model-config#environment-variables) | | `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_OPUS_MODEL` | 参阅[模型配置](/en/model-config#environment-variables) | | `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_SONNET_MODEL` | 参阅[模型配置](/en/model-config#environment-variables) | | `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 参阅[模型配置](/en/model-config#customize-pinned-model-display-and-capabilities) | | `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 身份验证的 API 密钥（参阅 [Microsoft Foundry](/en/microsoft-foundry)） | | `ANTHROPIC_FOUNDRY_BASE_URL` | Foundry 资源的完整基础 URL（例如 `https://my-resource.services.ai.azure.com/anthropic`）。`ANTHROPIC_FOUNDRY_RESOURCE` 的替代方案（参阅 [Microsoft Foundry](/en/microsoft-foundry)） | | `ANTHROPIC_FOUNDRY_RESOURCE` | Foundry 资源名称（例如 `my-resource`）。如果未设置 `ANTHROPIC_FOUNDRY_BASE_URL` 则为必需（参阅 [Microsoft Foundry](/en/microsoft-foundry)） | | `ANTHROPIC_MODEL` | 要使用的模型设置名称（参阅[模型配置](/en/model-config#environment-variables)） | | `ANTHROPIC_SMALL_FAST_MODEL` | \[已弃用] [用于后台任务的 Haiku 级模型](/en/costs)的名称 | | `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | 使用 Bedrock 或 Bedrock Mantle 时覆盖 Haiku 级模型的 AWS 区域。在 Bedrock 上，仅当同时设置了 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 或已弃用的 `ANTHROPIC_SMALL_FAST_MODEL` 时才生效，因为 Bedrock 默认使用主模型执行后台任务 | | `ANTHROPIC_VERTEX_BASE_URL` | 覆盖 Vertex AI 端点 URL。用于自定义 Vertex 端点或通过 [LLM 网关](/en/llm-gateway)路由。参阅 [Google Vertex AI](/en/google-vertex-ai) | | `ANTHROPIC_VERTEX_PROJECT_ID` | Vertex AI 请求的 GCP 项目 ID。会被 `GCLOUD_PROJECT`、`GOOGLE_CLOUD_PROJECT` 或 `GOOGLE_APPLICATION_CREDENTIALS` 凭据文件中的项目覆盖。参阅 [Google Vertex AI](/en/google-vertex-ai) | | `ANTHROPIC_WORKSPACE_ID` | [工作负载身份联合](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)的工作区 ID。当你的联合规则限定到多个工作区时设置此项，以便令牌交换知道要定向哪个工作区 | | `API_TIMEOUT_MS` | API 请求超时时间（毫秒）（默认：600000，即 10 分钟；最大值：2147483647）。当请求在慢速网络或通过代理路由时超时，请增大此值。超过最大值会使底层计时器溢出，导致请求立即失败 | | `AWS_BEARER_TOKEN_BEDROCK` | 用于身份验证的 Bedrock API 密钥（参阅 [Bedrock API 密钥](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)） | | `BASH_DEFAULT_TIMEOUT_MS` | 长时间运行的 bash 命令的默认超时时间（默认：120000，即 2 分钟） | | `BASH_MAX_OUTPUT_LENGTH` | bash 输出中保存到文件之前的最大字符数，Claude 将收到文件路径和简短预览。参阅 [Bash 工具行为](/en/tools-reference#bash-tool-behavior) | | `BASH_MAX_TIMEOUT_MS` | 模型为长时间运行的 bash 命令设置的最大超时时间（默认：600000，即 10 分钟） | | `CCR_FORCE_BUNDLE` | 设置为 `1` 以强制 [`claude --remote`](/en/claude-code-on-the-web#send-local-repositories-without-github) 捆绑并上传本地仓库，即使 GitHub 访问可用 | | `CLAUDECODE` | 在 Claude Code 生成的子进程（Bash 和 PowerShell 工具、tmux 会话、[钩子](/en/hooks)命令、[状态行](/en/statusline)命令）中设置为 `1`。用于检测脚本是否在 Claude Code 生成的子进程中运行 | | `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 设置为 `1` 以禁用所有内置的[子代理](/en/sub-agents)类型，如 Explore 和 Plan。仅适用于非交互模式（`-p` 标志）。适合希望从零开始的 SDK 用户 | | `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | 设置为 `1` 以跳过 SDK 创建的 MCP 服务器上工具名称的 `mcp____` 前缀。工具使用其原始名称。仅限 SDK 使用 | | `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | 后台子代理的停顿超时（毫秒）。默认 `600000`（10 分钟）。计时器在每个流式进度事件时重置；如果在窗口内没有进度到达，子代理将被中止，任务标记为失败，并将任何部分结果返回给父代理 | | `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 设置自动压缩触发时的上下文容量百分比（1-100）。默认情况下，自动压缩在约 95% 容量时触发。使用较低的值（如 `50`）可以更早压缩。高于默认阈值的值无效。适用于主对话和子代理。此百分比与[状态行](/en/statusline)中可用的 `context_window.used_percentage` 字段对齐 | | `CLAUDE_AUTO_BACKGROUND_TASKS` | 设置为 `1` 以强制启用长时间运行的代理任务自动后台化。启用后，子代理在运行约两分钟后移至后台 | | `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 在主会话中每次 Bash 或 PowerShell 命令后返回原始工作目录 | | `CLAUDE_CODE_ACCESSIBILITY` | 设置为 `1` 以保持原生终端光标可见并禁用反色文本光标指示器。允许 macOS Zoom 等屏幕放大器跟踪光标位置 | | `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` 以在[全屏渲染](/en/fullscreen)中每帧重绘整个屏幕，而不是发送增量更新。如果全屏模式显示过时或错位的文本片段，请使用此选项。Claude Code 在后台会话和 Windows 上的[代理视图](/en/agent-view)中自动启用此功能 | | `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 刷新凭据的时间间隔（毫秒）（使用 [`apiKeyHelper`](/en/settings#available-settings) 时） | | `CLAUDE_CODE_ATTRIBUTION_HEADER` | 设置为 `0` 以从系统提示开头省略归因块（客户端版本和提示指纹）。禁用后可提高通过 [LLM 网关](/en/llm-gateway)路由时的提示缓存命中率。Anthropic API 缓存不受影响 | | `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 设置用于自动压缩计算的上下文容量（令牌数）。默认为模型的上下文窗口：标准模型为 200K，[扩展上下文](/en/model-config#extended-context)模型为 1M。在 1M 模型上使用较低的值（如 `500000`）可将窗口视为 500K 用于压缩。该值以模型实际上下文窗口为上限。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` 作为此值的百分比应用。设置此变量会将压缩阈值与状态行的 `used_percentage`（始终使用模型的完整上下文窗口）解耦 | | `CLAUDE_CODE_AUTO_CONNECT_IDE` | 覆盖自动 [IDE 连接](/en/vs-code)。默认情况下，Claude Code 在受支持 IDE 的集成终端内启动时自动连接。设置为 `false` 可阻止此行为。设置为 `true` 可在自动检测失败时（如 tmux 遮挡父终端时）强制尝试连接。优先于 [`autoConnectIde`](/en/settings#global-config-settings) 全局配置设置 | | `CLAUDE_CODE_CERT_STORE` | TLS 连接的 CA 证书源逗号分隔列表。`bundled` 是 Claude Code 附带的 Mozilla CA 集。`system` 是操作系统信任存储。默认为 `bundled,system` | | `CLAUDE_CODE_CLIENT_CERT` | mTLS 身份验证的客户端证书文件路径 | | `CLAUDE_CODE_CLIENT_KEY` | mTLS 身份验证的客户端私钥文件路径 | | `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 加密的 CLAUDE\_CODE\_CLIENT\_KEY 的密码短语（可选） | | `CLAUDE_CODE_DEBUG_LOGS_DIR` | 覆盖调试日志文件路径。尽管名称如此，这是一个文件路径，而非目录。需要通过 `--debug`、`/debug` 或 `DEBUG` 环境变量单独启用调试模式：仅设置此变量不会启用日志记录。[`--debug-file`](/en/cli-reference#cli-flags) 标志可同时完成两项操作。默认为 `~/.claude/debug/.txt` | | `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 写入调试日志文件的最低日志级别。值：`verbose`、`debug`（默认）、`info`、`warn`、`error`。设置为 `verbose` 可包含高容量诊断信息（如完整状态行命令输出），或提高到 `error` 以减少噪音 | | `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 设置为 `1` 以禁用 [1M 上下文窗口](/en/model-config#extended-context)支持。设置后，1M 模型变体在模型选择器中不可用。适合有合规要求的企业环境 | | `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | 设置为 `1` 以在 Opus 4.6 和 Sonnet 4.6 上禁用[自适应推理](/en/model-config#adjust-effort-level)，回退到由 `MAX_THINKING_TOKENS` 控制的固定思维预算。{/* min-version: 2.1.111 */}对 Opus 4.7 无效，它始终使用自适应推理 | | `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 设置为 `1` 以关闭[后台代理和代理视图](/en/agent-view)：`claude agents`、`--bg`、`/background` 和按需监督器。等同于 [`disableAgentView`](/en/settings#available-settings) 设置 | | `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 设置为 `1` 以禁用[全屏渲染](/en/fullscreen)并使用经典主屏幕渲染器。对话留在终端的原生回滚中，因此 `Cmd+f` 和 tmux 复制模式照常工作。优先于 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/en/settings#available-settings) 设置。你也可以使用 `/tui default` 切换 | | `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 设置为 `1` 以禁用附件处理。使用 `@` 语法的文件提及将作为纯文本发送，而不是展开为文件内容 | | `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 设置为 `1` 以禁用[自动记忆](/en/memory#auto-memory)。设置为 `0` 可强制启用自动记忆，即使 `--bare` 模式或 [`autoMemoryEnabled: false`](/en/settings#available-settings) 会禁用它。禁用后，Claude 不会创建或加载自动记忆文件 | | `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 设置为 `1` 以禁用所有后台任务功能，包括 Bash 和子代理工具上的 `run_in_background` 参数、自动后台化和 Ctrl+B 快捷键 | | `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 设置为 `1` 以阻止将任何 CLAUDE.md 记忆文件加载到上下文中，包括用户、项目和自动记忆文件 | | `CLAUDE_CODE_DISABLE_CRON` | 设置为 `1` 以禁用[定时任务](/en/scheduled-tasks)。`/loop` 技能和 cron 工具变得不可用，任何已调度的任务停止触发，包括已在会话中运行的任务 | | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 设置为 `1` 以从 API 请求中剥离 Anthropic 特定的 `anthropic-beta` 请求头和 beta 工具模式字段（如 `defer_loading` 和 `eager_input_streaming`）。当代理网关拒绝请求并报错如 "Unexpected value(s) for the `anthropic-beta` header" 或 "Extra inputs are not permitted" 时使用。标准字段（`name`、`description`、`input_schema`、`cache_control`）会被保留。 | | `CLAUDE_CODE_DISABLE_FAST_MODE` | 设置为 `1` 以禁用[快速模式](/en/fast-mode) | | `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 设置为 `1` 以禁用 "Claude 表现如何？" 会话质量调查。当设置了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 时，调查也会被禁用，除非 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` 重新启用。要设置采样率而不是完全禁用，请使用 [`feedbackSurveyRate`](/en/settings#available-settings) 设置。参阅[会话质量调查](/en/data-usage#session-quality-surveys) | | `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 设置为 `1` 以禁用文件[检查点](/en/checkpointing)。`/rewind` 命令将无法恢复代码更改 | | `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 设置为 `1` 以从 Claude 的系统提示中移除内置的提交和 PR 工作流指令以及 git 状态快照。在使用你自己的 git 工作流技能时很有用。设置后优先于 [`includeGitInstructions`](/en/settings#available-settings) 设置 | | `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | 设置为 `1` 以阻止在 Anthropic API 上自动将 Opus 4.0 和 4.1 重映射到当前 Opus 版本。当你有意要固定使用旧模型时使用。在 Bedrock、Vertex 或 Foundry 上不会运行重映射 | | `CLAUDE_CODE_DISABLE_MOUSE` | 设置为 `1` 以禁用[全屏渲染](/en/fullscreen)中的鼠标跟踪。键盘滚动（`PgUp` 和 `PgDn`）仍然有效。使用此选项可保留终端的原生选择即复制行为 | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 等同于同时设置 `DISABLE_AUTOUPDATER`、`DISABLE_FEEDBACK_COMMAND`、`DISABLE_ERROR_REPORTING` 和 `DISABLE_TELEMETRY` | | `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | 设置为 `1` 以在流式请求中途失败时禁用非流式回退。流式错误会传播到重试层。当代理或网关导致回退产生重复工具执行时很有用 | | `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 设置为 `1` 以跳过首次运行时自动添加官方插件市场 | | `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | 设置为 `1` 以跳过从系统范围的托管技能目录加载技能。适合不应加载操作员提供的技能的容器或 CI 会话 | | `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 设置为 `1` 以禁用基于对话上下文的自动终端标题更新 | | `CLAUDE_CODE_DISABLE_THINKING` | 设置为 `1` 以强制禁用[扩展思维](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)，无论模型支持或其他设置如何。比 `MAX_THINKING_TOKENS=0` 更直接 | | `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | 设置为 `1` 以禁用[全屏渲染](/en/fullscreen)中的虚拟滚动，并在记录中渲染每条消息。如果全屏模式滚动时出现消息应该出现的空白区域，请使用此选项 | | `CLAUDE_CODE_EFFORT_LEVEL` | 设置受支持模型的努力级别。值：`low`、`medium`、`high`、`xhigh`、`max` 或 `auto`（使用模型默认值）。可用级别取决于模型。优先于 `/effort` 和 `effortLevel` 设置。参阅[调整努力级别](/en/model-config#adjust-effort-level) | | `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 覆盖[会话回顾](/en/interactive-mode#session-recap)可用性。设置为 `0` 可强制关闭回顾，无论 `/config` 开关如何。设置为 `1` 可在 [`awaySummaryEnabled`](/en/settings#available-settings) 为 `false` 时强制开启回顾。优先于设置和 `/config` 开关 | | `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 设置为 `1` 以在[非交互模式](/en/headless)中后台安装完成后在轮次边界刷新插件状态。默认关闭，因为刷新会在会话中途更改系统提示，使该轮次的[提示缓存](/en/prompt-caching)失效 | | `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | 设置为 `1` 以在指向 Anthropic 的非必要流量被阻止时，将 "Claude 表现如何？" 会话质量调查路由到你自己的 [OpenTelemetry 收集器](/en/monitoring-usage)。调查评分仅作为 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 上默认启用。在 Bedrock 和 Vertex 上，按模型启用，前提是部署的容器支持。设置为 `0` 可选择退出。设置为 `1` 可在通过 `ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL` 或 `ANTHROPIC_BEDROCK_BASE_URL` 经由代理路由时强制启用。在 Foundry 和[网关](/en/llm-gateway)连接上默认关闭 | | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 设置为 `1` 以在 `ANTHROPIC_BASE_URL` 指向 LiteLLM、Kong 或内部代理等 Anthropic 兼容网关时，从网关的 `/v1/models` 端点填充 `/model` 选择器。默认关闭，因为共享 API 密钥支持的网关会向每个用户显示密钥可访问的所有模型。发现的模型仍受 [`availableModels`](/en/settings#available-settings) 允许列表过滤 | | `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}在 v2.1.142 中移除。[快速模式](/en/fast-mode)默认使用 Opus 4.7。设置 `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` 可继续使用 Opus 4.6 | | `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 设置为 `false` 以禁用提示建议（`/config` 中的 "提示建议" 开关）。这些是 Claude 响应后出现在提示输入中的灰色预测。参阅[提示建议](/en/interactive-mode#prompt-suggestions) | | `CLAUDE_CODE_ENABLE_TASKS` | 控制会话使用结构化任务工具（`TaskCreate`、`TaskUpdate`、`TaskGet`、`TaskList`）还是旧版 `TodoWrite` 工具。{/* min-version: 2.1.142 */}从 Claude Code v2.1.142 起，任务工具在所有模式下都是默认的。设置为 `0` 可回退到 `TodoWrite`。参阅[任务列表](/en/interactive-mode#task-list)和[迁移到任务工具](/en/agent-sdk/todo-tracking#migrate-to-task-tools) | | `CLAUDE_CODE_ENABLE_TELEMETRY` | 设置为 `1` 以启用 OpenTelemetry 数据收集（指标和日志）。配置 OTel 导出器之前必须先启用。参阅[监控](/en/monitoring-usage) | | `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | 查询循环变为空闲后自动退出前等待的时间（毫秒）。适合使用 SDK 模式的自动化工作流和脚本 | | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | 设置为 `1` 以启用[代理团队](/en/agent-teams)。代理团队是实验性的，默认禁用 | | `CLAUDE_CODE_EXTRA_BODY` | 合并到每个 API 请求体顶层的 JSON 对象。适合传递 Claude Code 未直接暴露的提供商特定参数 | | `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 覆盖文件读取的默认令牌限制。在需要完整读取较大文件时很有用 | | `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 设置为 `1` 以在终端支持但未自动检测到时强制启用 DEC 私有模式 2026 [同步输出](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)。适合实现了 BSU/ESU 但不回复能力探测的模拟器（如 Emacs `eat`）。在 tmux 下无效 | | `CLAUDE_CODE_FORK_SUBAGENT` | 设置为 `1` 以启用[分叉子代理](/en/sub-agents#fork-the-current-conversation)。分叉子代理从主会话继承完整的对话上下文，而不是从头开始。启用后，`/fork` 生成分叉子代理而不是作为 [`/branch`](/en/commands) 的别名，所有子代理生成都在后台运行。在交互模式和通过 SDK 或 `claude -p` 时工作 | | `CLAUDE_CODE_GIT_BASH_PATH` | 仅 Windows：Git Bash 可执行文件路径（`bash.exe`）。当 Git Bash 已安装但不在 PATH 中时使用。参阅 [Windows 设置](/en/setup#set-up-on-windows) | | `CLAUDE_CODE_GLOB_HIDDEN` | 设置为 `false` 以在 Claude 调用 [Glob 工具](/en/tools-reference#glob-tool-behavior)时从结果中排除点文件。默认包含。不影响 `@` 文件自动补全、`ls`、Grep 或 Read | | `CLAUDE_CODE_GLOB_NO_IGNORE` | 设置为 `false` 以使 [Glob 工具](/en/tools-reference#glob-tool-behavior)遵守 `.gitignore` 模式。默认情况下，Glob 返回所有匹配文件，包括被 gitignore 的文件。不影响 `@` 文件自动补全，它有自己的 [`respectGitignore` 设置](/en/settings#available-settings) | | `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Glob 工具文件发现的超时时间（秒）。大多数平台默认为 20 秒，WSL 上为 60 秒 | | `CLAUDE_CODE_HIDE_CWD` | 设置为 `1` 以在启动标志中隐藏工作目录。在屏幕共享或录制中路径暴露操作系统用户名时很有用 | | `CLAUDE_CODE_IDE_HOST_OVERRIDE` | 覆盖用于连接 IDE 扩展的主机地址。默认情况下 Claude Code 自动检测正确的地址，包括 WSL 到 Windows 的路由 | | `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | 跳过 IDE 扩展的自动安装。等同于将 [`autoInstallIdeExtension`](/en/settings#global-config-settings) 设置为 `false` | | `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 设置为 `1` 以在连接期间跳过 IDE lockfile 条目验证。当自动连接无法找到正在运行的 IDE 时使用 | | `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆盖 Claude Code 为活动模型假定的上下文窗口大小。仅在同时设置 `DISABLE_COMPACT` 时生效。当通过 `ANTHROPIC_BASE_URL` 路由到名称与内置大小不匹配的模型时使用 | | `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 设置大多数请求的最大输出令牌数。默认值和上限因模型而异；参阅[最大输出令牌数](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。增大此值会减少[自动压缩](/en/costs#reduce-token-usage)触发前可用的有效上下文窗口。 | | `CLAUDE_CODE_MAX_RETRIES` | 覆盖失败 API 请求的重试次数（默认：10） | | `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 可以并行执行的只读工具和子代理的最大数量（默认：10）。更高的值增加并行度但消耗更多资源 | | `CLAUDE_CODE_MAX_TURNS` | 在未传递显式限制时限制代理轮次的数量。等同于传递 [`--max-turns`](/en/cli-reference#cli-flags)，当两者都设置时后者优先。非正整数值在启动时会被拒绝并报错，而不是被视为无上限 | | `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | 设置为 `1` 以仅使用安全基线环境加上服务器配置的 `env` 来生成 stdio MCP 服务器，而不是继承你的 shell 环境 | | `CLAUDE_CODE_NATIVE_CURSOR` | 设置为 `1` 以在输入光标处显示终端自身的光标，而不是绘制的块。光标遵循终端的闪烁、形状和焦点设置 | | `CLAUDE_CODE_NEW_INIT` | 设置为 `1` 以使 `/init` 运行交互式设置流程。该流程询问要生成哪些文件，包括 CLAUDE.md、技能和钩子，然后探索代码库并编写它们。不设置此变量时，`/init` 会自动生成 CLAUDE.md 而不提示。 | | `CLAUDE_CODE_NO_FLICKER` | 设置为 `1` 以启用[全屏渲染](/en/fullscreen)，这是一个研究预览功能，可减少闪烁并在长对话中保持内存平稳。等同于 [`tui`](/en/settings#available-settings) 设置；你也可以使用 `/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`](/en/authentication#generate-a-long-lived-token) 生成 | | `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | 设置为 `1` 以将[快速模式](/en/fast-mode)固定为 Claude Opus 4.6 而不是默认的 Opus 4.7。设置后，`/fast` 在 Opus 4.6 上运行。不设置时，`/fast` 在 Opus 4.7 上运行 | | `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待处理 OpenTelemetry span 的超时时间（毫秒）（默认：5000）。参阅[监控](/en/monitoring-usage) | | `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新动态 OpenTelemetry 头的时间间隔（毫秒）（默认：1740000 / 29 分钟）。参阅[动态头](/en/monitoring-usage#dynamic-headers) | | `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 导出器在关闭时完成的超时时间（毫秒）（默认：2000）。如果指标在退出时被丢弃，请增大此值。参阅[监控](/en/monitoring-usage) | | `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 设置为 `1` 以允许 Claude Code 在有新版本可用时在后台运行包管理器的升级命令。适用于 Homebrew 和 WinGet 安装。其他包管理器继续显示升级命令但不运行。参阅[自动更新](/en/setup#auto-updates) | | `CLAUDE_CODE_PERFORCE_MODE` | 设置为 `1` 以启用 Perforce 感知的写保护。设置后，如果目标文件缺少所有者写入位（Perforce 在同步文件上清除该位，直到 `p4 edit` 打开它们），Edit、Write 和 NotebookEdit 会失败并提示 `p4 edit `。这阻止 Claude Code 绕过 Perforce 变更跟踪 | | `CLAUDE_CODE_PLUGIN_CACHE_DIR` | 覆盖插件根目录。尽管名称如此，这设置的是父目录，而非缓存本身：市场和插件缓存位于此路径下的子目录中。默认为 `~/.claude/plugins` | | `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | 安装或更新插件时 git 操作的超时时间（毫秒）（默认：120000）。对于大型仓库或慢速网络连接，请增大此值。参阅 [Git 操作超时](/en/plugin-marketplaces#git-operations-time-out) | | `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | 设置为 `1` 以在 `git pull` 失败时保留现有市场缓存，而不是清除并重新克隆。在离线或隔离环境中很有用，重新克隆会以相同方式失败。参阅[离线环境中市场更新失败](/en/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) | | `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 在启动时从这些目录注册市场，并使用预缓存的插件而无需重新克隆。参阅[为容器预填充插件](/en/plugin-marketplaces#pre-populate-plugins-for-containers) | | `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 设置为 `1` 以阻止 Claude Code 在为工具调用、钩子和状态行命令生成 PowerShell 时传递 `-ExecutionPolicy Bypass`，并改为遵守机器的有效执行策略。默认情况下 Claude Code 在进程范围绕过执行策略，以便 `.ps1` 脚本和模块导入在默认 Restricted 的 Windows 安装上工作。无论此设置如何，进程范围绕从不覆盖组策略 `MachinePolicy` 或 `UserPolicy` | | `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由嵌入 Claude Code 并代表其管理模型提供商路由的宿主平台设置。设置后，设置文件中的提供商选择、端点和身份验证变量（如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY`）将被忽略，因此用户设置无法覆盖宿主的路由。Bedrock、Vertex 和 Foundry 的自动遥测选择退出也会被跳过，因此遥测遵循标准的 `DISABLE_TELEMETRY` 选择退出。参阅[按 API 提供商的默认行为](/en/data-usage#default-behaviors-by-api-provider) | | `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 设置为 `1` 以允许代理执行 DNS 解析而不是调用方。适合代理应处理主机名解析的环境 | | `CLAUDE_CODE_REMOTE` | 当 Claude Code 作为[云会话](/en/claude-code-on-the-web)运行时自动设置为 `true`。从钩子或设置脚本中读取此项以检测是否在云环境中 | | `CLAUDE_CODE_REMOTE_SESSION_ID` | 在[云会话](/en/claude-code-on-the-web)中自动设置为当前会话的 ID。读取此项以构建指向会话记录的链接。参阅[将工件链接回会话](/en/claude-code-on-the-web#link-artifacts-back-to-the-session) | | `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 设置为 `1` 以在上一个会话在轮次中途结束时自动恢复。用于 SDK 模式，以便模型继续而无需 SDK 重新发送提示 | | `CLAUDE_CODE_RESUME_PROMPT` | 覆盖恢复在轮次中途结束的会话时注入的继续消息。默认为 `Continue from where you left off.`。长时间运行代理的生成脚本可以将其设置为更具指令性的启动消息。空字符串使用默认值 | | `CLAUDE_CODE_SCRIPT_CAPS` | 当设置了 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 时，限制特定脚本在每个会话中可被调用次数的 JSON 对象。键是与命令文本匹配的子字符串；值是整数调用限制。例如 `{"deploy.sh": 2}` 允许 `deploy.sh` 最多被调用两次。匹配基于子字符串，因此 shell 展开技巧如 `./scripts/deploy.sh $(evil)` 仍计入上限。通过 `xargs` 或 `find -exec` 的运行时扇出不会被检测到；这是一层纵深防御控制 | | `CLAUDE_CODE_SCROLL_SPEED` | 设置[全屏渲染](/en/fullscreen#mouse-wheel-scrolling)中的鼠标滚轮滚动倍数。接受 1 到 20 的值。如果你的终端在没有放大情况下每个刻度发送一个滚轮事件，设置为 `3` 可匹配 `vim`。在 JetBrains IDE 终端中被忽略，Claude Code 在其中使用自己的滚动处理 | | `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | 覆盖 [SessionEnd](/en/hooks#sessionend) 钩子的时间预算（毫秒）。适用于会话退出、`/clear` 和通过交互式 `/resume` 切换会话。默认预算为 1.5 秒，自动提高到设置文件中配置的最高单钩子 `timeout`，最高 60 秒。插件提供的钩子上的超时不会提高预算 | | `CLAUDE_CODE_SESSION_ID` | 在 Bash 和 PowerShell 工具子进程以及[钩子命令](/en/hooks)子进程中自动设置为当前会话 ID。与钩子 JSON 输入中的 `session_id` 字段匹配。在 `/clear` 时更新。用于将脚本和外部工具与启动它们的 Claude Code 会话关联 | | `CLAUDE_CODE_SHELL` | 覆盖自动 shell 检测。当你的登录 shell 与首选工作 shell 不同时很有用（例如 `bash` vs `zsh`） | | `CLAUDE_CODE_SHELL_PREFIX` | 包装 Claude Code 生成的 shell 命令的命令前缀：Bash 工具调用、[钩子](/en/hooks)命令和 stdio [MCP 服务器](/en/mcp)启动命令。适合日志记录或审计。示例：设置 `/path/to/logger.sh` 会将每个命令运行为 `/path/to/logger.sh ` | | `CLAUDE_CODE_SIMPLE` | 设置为 `1` 以使用最小系统提示和仅 Bash、文件读取和文件编辑工具运行。`--mcp-config` 的 MCP 工具仍然可用。禁用钩子、技能、插件、MCP 服务器、自动记忆和 CLAUDE.md 的自动发现。不读取 OAuth 令牌和钥匙串凭据，因此 Anthropic 身份验证必须来自 `ANTHROPIC_API_KEY` 或 `--settings` 中的 `apiKeyHelper`。等同于传递 [`--bare`](/en/headless#start-faster-with-bare-mode) | | `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 设置为 `1` 以在任何模型上使用更短的系统提示和缩写的工具描述。设置为 `0`、`false`、`no` 或 `off` 可选择退出，即使实验或服务器配置会在其他情况下启用它。完整的工具集、钩子、MCP 服务器和 CLAUDE.md 发现仍然启用 | | `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | 跳过 [AWS 上的 Claude 平台](/en/claude-platform-on-aws)的客户端身份验证，适用于自行签名请求的网关 | | `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | 跳过 Bedrock 的 AWS 身份验证（例如使用 LLM 网关时） | | `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | 跳过 Microsoft Foundry 的 Azure 身份验证（例如使用 LLM 网关时） | | `CLAUDE_CODE_SKIP_MANTLE_AUTH` | 跳过 Bedrock Mantle 的 AWS 身份验证（例如使用 LLM 网关时） | | `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 设置为 `1` 以跳过将提示历史和会话记录写入磁盘。使用此变量启动的会话不会出现在 `--resume`、`--continue` 或上箭头历史中。适合临时脚本会话 | | `CLAUDE_CODE_SKIP_VERTEX_AUTH` | 跳过 Vertex 的 Google 身份验证（例如使用 LLM 网关时） | | `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/en/hooks#stop) 或 [SubagentStop](/en/hooks#subagentstop) 钩子在 Claude Code 覆盖它并强制结束轮次之前，可连续阻止轮次结束的最大次数（默认：8）。设置为 `0` 可禁用上限。如果你的钩子合法需要更多迭代来解决，请提高此值 | | `CLAUDE_CODE_SUBAGENT_MODEL` | 参阅[模型配置](/en/model-config) | | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 设置为 `1` 以从子进程环境（Bash 工具、钩子、MCP stdio 服务器）中剥离 Anthropic 和云提供商凭据。父 Claude 进程保留这些凭据用于 API 调用，但子进程无法读取它们，减少通过 shell 展开泄露密钥的提示注入攻击暴露面。在 Linux 上，这还会在隔离的 PID 命名空间中运行 Bash 子进程，因此它们无法通过 `/proc` 读取主机进程环境；副作用是 `ps`、`pgrep` 和 `kill` 无法看到或向主机进程发信号。`claude-code-action` 在配置了 `allowed_non_write_users` 时自动设置此项 | | `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.ai 技能下载到 `~/.claude/skills/`，并每 10 分钟重新同步。仅适用于带有 `-p` 标志的非交互模式。在 [Web 上的 Claude Code](/en/claude-code-on-the-web) 会话中自动设置。需要 claude.ai 身份验证 | | `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | 设置 `CLAUDE_CODE_SYNC_SKILLS` 时首次查询等待初始技能同步的超时时间（毫秒）（默认：5000）。超时后，查询继续，剩余技能下载在后台进行 | | `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | 设置为 `false` 以禁用 diff 输出中的语法高亮。当颜色干扰终端设置时很有用。要同时禁用代码块和文件预览中的高亮，请使用 [`syntaxHighlightingDisabled`](/en/settings) 设置 | | `CLAUDE_CODE_TASK_LIST_ID` | 跨会话共享任务列表。在多个 Claude Code 实例中设置相同的 ID 以协调共享任务列表。参阅[任务列表](/en/interactive-mode#task-list) | | `CLAUDE_CODE_TEAM_NAME` | 此队友所属的代理团队名称。在[代理团队](/en/agent-teams)成员上自动设置 | | `CLAUDE_CODE_TMPDIR` | 覆盖用于内部临时文件的临时目录。Claude Code 在此路径后追加 `/claude-{uid}/`（Unix）或 `/claude/`（Windows）。默认：macOS 上为 `/tmp`，Linux/Windows 上为 `os.tmpdir()` | | `CLAUDE_CODE_TMUX_TRUECOLOR` | 设置为 `1` 以允许 tmux 内的 24 位真彩色输出。默认情况下，当设置了 `$TMUX` 时 Claude Code 限制为 256 色，因为 tmux 默认不传递真彩色转义序列，除非配置了。在 `~/.tmux.conf` 中添加 `set -ga terminal-overrides ',*:Tc'` 后设置此项。参阅[终端配置](/en/terminal-config)了解其他 tmux 设置 | | `CLAUDE_CODE_USE_ANTHROPIC_AWS` | 使用 [AWS 上的 Claude 平台](/en/claude-platform-on-aws) | | `CLAUDE_CODE_USE_BEDROCK` | 使用 [Bedrock](/en/amazon-bedrock) | | `CLAUDE_CODE_USE_FOUNDRY` | 使用 [Microsoft Foundry](/en/microsoft-foundry) | | `CLAUDE_CODE_USE_MANTLE` | 使用 Bedrock [Mantle 端点](/en/amazon-bedrock#use-the-mantle-endpoint) | | `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | 设置为 `1` 以使用 Node.js 文件 API 而不是 ripgrep 来发现自定义命令、子代理和输出样式。当捆绑的 ripgrep 二进制文件在你的环境中不可用或被阻止时设置此项。不影响 Grep 或文件搜索工具 | | `CLAUDE_CODE_USE_POWERSHELL_TOOL` | 控制 PowerShell 工具。在没有 Git Bash 的 Windows 上，该工具自动启用；设置为 `0` 可禁用。在安装了 Git Bash 的 Windows 上，该工具正在逐步推出：设置为 `1` 可选择加入，`0` 可选择退出。在 Linux、macOS 和 WSL 上，设置为 `1` 可启用，这需要 `pwsh` 在你的 `PATH` 上。在 Windows 上启用后，Claude 可以原生运行 PowerShell 命令而不是通过 Git Bash 路由。参阅 [PowerShell 工具](/en/tools-reference#powershell-tool) | | `CLAUDE_CODE_USE_VERTEX` | 使用 [Vertex](/en/google-vertex-ai) | | `CLAUDE_CONFIG_DIR` | 覆盖配置目录（默认：`~/.claude`）。所有设置、凭据、会话历史和插件都存储在此路径下。适合并行运行多个帐户：例如 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` | | `CLAUDE_EFFORT` | 在 Bash 工具子进程和钩子命令中自动设置为当前轮次的[努力级别](/en/model-config#adjust-effort-level)：`low`、`medium`、`high`、`xhigh` 或 `max`。与传递给[钩子](/en/hooks)的 `effort.level` 字段匹配。仅在当前模型支持 effort 参数时设置 | | `CLAUDE_ENABLE_BYTE_WATCHDOG` | 设置为 `1` 以强制启用字节级流式空闲看门狗，或设置为 `0` 以强制禁用。未设置时，看门狗在 Anthropic API 连接上默认启用。字节看门狗在 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 设置的时间内没有字节到达时中止连接，最少 5 分钟，独立于事件级看门狗 | | `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | 设置为 `1` 以在 Amazon Bedrock `vnd.amazon.eventstream` 响应上启用字节级流式空闲看门狗。默认关闭。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 配置超时 | | `CLAUDE_ENABLE_STREAM_WATCHDOG` | 设置为 `1` 以启用事件级流式空闲看门狗。默认关闭。适用于所有提供商，包括 Bedrock。对于 Vertex 和 Foundry，这是唯一可用的空闲看门狗。在 Bedrock 上，你还可以使用 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` 启用独立的字节级看门狗；两者同时设置时一起运行。使用 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 配置超时 | | `CLAUDE_ENV_FILE` | shell 脚本路径，Claude Code 在同一 shell 进程中每次 Bash 命令前运行其内容，因此文件中的 export 对命令可见。用于跨命令持久化 virtualenv 或 conda 激活。也由 [SessionStart](/en/hooks#persist-environment-variables)、[Setup](/en/hooks#setup)、[CwdChanged](/en/hooks#cwdchanged) 和 [FileChanged](/en/hooks#filechanged) 钩子动态填充 | | `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 未提供显式名称时自动生成的[远程控制](/en/remote-control)会话名称前缀。默认为你的机器主机名，生成类似 `myhost-graceful-unicorn` 的名称。`--remote-control-session-name-prefix` CLI 标志为单次调用设置相同的值 | | `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | 流式空闲看门狗关闭停滞连接前的超时时间（毫秒）。字节级和事件级看门狗的默认值和最小值均为 `300000`（5 分钟）；较低的值会被静默限制以吸收扩展思维暂停和代理缓冲。对于第三方提供商，需要 `CLAUDE_ENABLE_STREAM_WATCHDOG=1`。在 Bedrock 上，当 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` 时也适用 | | `DEBUG` | 设置为 `1` 以启用调试模式，等同于使用 [`--debug`](/en/cli-reference#cli-flags) 启动。调试日志写入 `~/.claude/debug/.txt` 或 `CLAUDE_CODE_DEBUG_LOGS_DIR` 设置的路径。只有真值 `1`、`true`、`yes` 和 `on` 启用调试模式，因此为其他工具设置的命名空间模式如 `DEBUG=express:*` 不会触发它 | | `DISABLE_AUTOUPDATER` | 设置为 `1` 以禁用自动后台更新。手动 `claude update` 仍然有效。使用 `DISABLE_UPDATES` 可同时阻止两者 | | `DISABLE_AUTO_COMPACT` | 设置为 `1` 以在接近上下文限制时禁用自动压缩。手动 `/compact` 命令仍然可用。当你希望明确控制压缩时机时使用 | | `DISABLE_COMPACT` | 设置为 `1` 以禁用所有压缩：包括自动压缩和手动 `/compact` 命令 | | `DISABLE_COST_WARNINGS` | 设置为 `1` 以禁用费用警告消息 | | `DISABLE_DOCTOR_COMMAND` | 设置为 `1` 以隐藏 `/doctor` 命令。适合不应运行安装诊断的托管部署 | | `DISABLE_ERROR_REPORTING` | 设置为 `1` 以选择退出 Sentry 错误报告 | | `DISABLE_EXTRA_USAGE_COMMAND` | 设置为 `1` 以隐藏 `/usage-credits` 命令（允许用户在速率限制之外购买额外使用量） | | `DISABLE_FEEDBACK_COMMAND` | 设置为 `1` 以禁用 `/feedback` 命令。旧名称 `DISABLE_BUG_COMMAND` 也可接受 | | `DISABLE_GROWTHBOOK` | 设置为 `1` 以禁用 GrowthBook 功能标志获取并使用每个标志的代码默认值。除非同时设置 `DISABLE_TELEMETRY`，否则遥测事件日志记录保持开启 | | `DISABLE_INSTALLATION_CHECKS` | 设置为 `1` 以禁用安装警告。仅在手动管理安装位置时使用，因为这可能掩盖标准安装的问题 | | `DISABLE_INSTALL_GITHUB_APP_COMMAND` | 设置为 `1` 以隐藏 `/install-github-app` 命令。使用第三方提供商（Bedrock、Vertex 或 Foundry）时已隐藏 | | `DISABLE_INTERLEAVED_THINKING` | 设置为 `1` 以阻止发送交错思维 beta 头。当你的 LLM 网关或提供商不支持[交错思维](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)时很有用 | | `DISABLE_LOGIN_COMMAND` | 设置为 `1` 以隐藏 `/login` 命令。当通过 API 密钥或 `apiKeyHelper` 在外部处理身份验证时很有用 | | `DISABLE_LOGOUT_COMMAND` | 设置为 `1` 以隐藏 `/logout` 命令 | | `DISABLE_PROMPT_CACHING` | 设置为 `1` 以禁用所有模型的[提示缓存](/en/prompt-caching#disable-prompt-caching)（优先于每个模型的设置） | | `DISABLE_PROMPT_CACHING_HAIKU` | 设置为 `1` 以禁用 Haiku 模型的提示缓存 | | `DISABLE_PROMPT_CACHING_OPUS` | 设置为 `1` 以禁用 Opus 模型的提示缓存 | | `DISABLE_PROMPT_CACHING_SONNET` | 设置为 `1` 以禁用 Sonnet 模型的提示缓存 | | `DISABLE_TELEMETRY` | 设置为 `1` 以选择退出遥测。遥测事件不包含用户数据，如代码、文件路径或 bash 命令。也禁用功能标志获取，效果与 `DISABLE_GROWTHBOOK` 相同，因此某些标志功能可能不可用 | | `DISABLE_UPDATES` | 设置为 `1` 以阻止所有更新，包括手动 `claude update` 和 `claude install`。比 `DISABLE_AUTOUPDATER` 更严格。在通过你自己的渠道分发 Claude Code 且用户不应自行更新时使用 | | `DISABLE_UPGRADE_COMMAND` | 设置为 `1` 以隐藏 `/upgrade` 命令 | | `DO_NOT_TRACK` | 设置为 `1` 以选择退出遥测。等同于设置 `DISABLE_TELEMETRY`。作为[标准跨工具约定](https://consoledonottrack.com/)遵守 | | `ENABLE_CLAUDEAI_MCP_SERVERS` | 设置为 `false` 以在 Claude Code 中禁用 [claude.ai MCP 服务器](/en/mcp#use-mcp-servers-from-claude-ai)。对已登录用户默认启用 | | `ENABLE_PROMPT_CACHING_1H` | 设置为 `1` 以请求 1 小时的[提示缓存 TTL](/en/prompt-caching#cache-lifetime)，而不是默认的 5 分钟。适用于 API 密钥、[Bedrock](/en/amazon-bedrock)、[Vertex](/en/google-vertex-ai)、[Foundry](/en/microsoft-foundry) 和 [AWS 上的 Claude 平台](/en/claude-platform-on-aws) 用户。包含使用量内的订阅用户自动获得 1 小时 TTL。1 小时缓存写入按更高费率计费 | | `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 已弃用。请改用 `ENABLE_PROMPT_CACHING_1H` | | `ENABLE_TOOL_SEARCH` | 控制 [MCP 工具搜索](/en/mcp#scale-with-mcp-tool-search)。未设置：所有 MCP 工具默认延迟加载，但在 Vertex AI 上或 `ANTHROPIC_BASE_URL` 指向非第一方主机时预先加载。值：`true`（始终延迟加载并发送 beta 头，请求在早于 Sonnet 4.5 或 Opus 4.5 的 Vertex AI 模型上，或在不支持 `tool_reference` 的代理上失败）、`auto`（阈值模式：如果工具在上下文的 10% 以内则预先加载）、`auto:N`（自定义阈值，例如 `auto:5` 为 5%）、`false`（全部预先加载） | | `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 设置为任意非空值以在任何主模型上反复出现过载错误后触发回退到 [`--fallback-model`](/en/cli-reference#cli-flags)。默认情况下，只有 Opus 模型触发回退 | | `FORCE_AUTOUPDATE_PLUGINS` | 设置为 `1` 以在通过 `DISABLE_AUTOUPDATER` 禁用主自动更新器时强制插件自动更新 | | `FORCE_PROMPT_CACHING_5M` | 设置为 `1` 以在 1 小时 TTL 适用时强制使用 5 分钟提示缓存 TTL。覆盖 `ENABLE_PROMPT_CACHING_1H` | | `HTTP_PROXY` | 指定网络连接的 HTTP 代理服务器 | | `HTTPS_PROXY` | 指定网络连接的 HTTPS 代理服务器 | | `IS_DEMO` | 设置为 `1` 以启用演示模式：从头部和 `/status` 输出中隐藏你的电子邮件和组织名称，并跳过引导。适合流式传输或录制会话时使用 | | `MAX_MCP_OUTPUT_TOKENS` | MCP 工具响应中允许的最大令牌数。输出超过 10,000 个令牌时 Claude Code 会显示警告。声明了 [`anthropic/maxResultSizeChars`](/en/mcp#raise-the-limit-for-a-specific-tool) 的工具对文本内容使用该字符限制，但这些工具的图像内容仍受此变量约束（默认：25000） | | `MAX_STRUCTURED_OUTPUT_RETRIES` | 在非交互模式（`-p` 标志）中模型响应对 [`--json-schema`](/en/cli-reference#cli-flags) 验证失败时的重试次数。默认为 5 | | `MAX_THINKING_TOKENS` | 覆盖[扩展思维](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)令牌预算。上限是模型的[最大输出令牌数](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)减一。设置为 `0` 可完全禁用思维。在具有[自适应推理](/en/model-config#adjust-effort-level)的模型上，除非通过 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 禁用自适应推理，否则预算被忽略 | | `MCP_CLIENT_SECRET` | 需要[预配置凭据](/en/mcp#use-pre-configured-oauth-credentials)的 MCP 服务器的 OAuth 客户端密钥。避免在使用 `--client-secret` 添加服务器时的交互式提示 | | `MCP_CONNECTION_NONBLOCKING` | 控制启动时是否等待 MCP 服务器连接后再进行首次查询。{/* min-version: 2.1.142 */}从 Claude Code v2.1.142 起，MCP 启动默认非阻塞：服务器在后台连接，其工具在完成后可用。设置为 `0` 可恢复阻塞式 5 秒连接等待。配置了 [`alwaysLoad: true`](/en/mcp#exempt-a-server-from-deferral) 的服务器无论此设置如何仍会阻塞启动，因为它们的工具必须在首个提示构建时存在 | | `MCP_CONNECT_TIMEOUT_MS` | 阻塞式 MCP 启动在快照工具列表前等待连接批次的时间（毫秒）（默认：5000）。在 `MCP_CONNECTION_NONBLOCKING=0` 或标记为 [`alwaysLoad: true`](/en/mcp#exempt-a-server-from-deferral) 的服务器时适用。截止时仍在等待的服务器继续在后台连接，但在下次查询前不会出现。与 `MCP_TIMEOUT` 不同，后者限制单个服务器的连接尝试 | | `MCP_OAUTH_CALLBACK_PORT` | OAuth 重定向回调的固定端口，作为使用[预配置凭据](/en/mcp#use-pre-configured-oauth-credentials)添加 MCP 服务器时 `--callback-port` 的替代方案 | | `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 启动期间可并行连接的远程 MCP 服务器（HTTP/SSE）最大数量（默认：20） | | `MCP_SERVER_CONNECTION_BATCH_SIZE` | 启动期间可并行连接的本地 MCP 服务器（stdio）最大数量（默认：3） | | `MCP_TIMEOUT` | MCP 服务器启动的超时时间（毫秒）（默认：30000，即 30 秒） | | `MCP_TOOL_TIMEOUT` | MCP 工具执行的超时时间（毫秒）（默认：100000000，约 28 小时）。`.mcp.json` 中的每个服务器 `timeout` 字段覆盖该服务器的此值。低于 1000 的值会被限制为一秒 | | `NO_PROXY` | 请求将直接发送的域名和 IP 列表，绕过代理 | | `OTEL_LOG_RAW_API_BODIES` | 将 Anthropic Messages API 请求和响应 JSON 作为 `api_request_body` / `api_response_body` 日志事件发出。设置为 `1` 可包含截断到 60 KB 的内联请求体，或设置 `file:` 可将未截断的请求体写入磁盘并改为发出 `body_ref` 路径。默认禁用；请求体包含整个对话历史。参阅[监控](/en/monitoring-usage#api-request-body-event) | | `OTEL_LOG_TOOL_CONTENT` | 设置为 `1` 以在 OpenTelemetry span 事件中包含工具输入和输出内容。默认禁用以保护敏感数据。参阅[监控](/en/monitoring-usage) | | `OTEL_LOG_TOOL_DETAILS` | 设置为 `1` 以在 OpenTelemetry 追踪和日志中包含工具输入参数、MCP 服务器名称、工具失败时的原始错误字符串和其他工具详情。默认禁用以保护个人身份信息。参阅[监控](/en/monitoring-usage) | | `OTEL_LOG_USER_PROMPTS` | 设置为 `1` 以在 OpenTelemetry 追踪和日志中包含用户提示文本。默认禁用（提示被编辑）。参阅[监控](/en/monitoring-usage) | | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 设置为 `false` 以从指标属性中排除帐户 UUID（默认：包含）。参阅[监控](/en/monitoring-usage) | | `OTEL_METRICS_INCLUDE_SESSION_ID` | 设置为 `false` 以从指标属性中排除会话 ID（默认：包含）。参阅[监控](/en/monitoring-usage) | | `OTEL_METRICS_INCLUDE_VERSION` | 设置为 `true` 以在指标属性中包含 Claude Code 版本（默认：排除）。参阅[监控](/en/monitoring-usage) | | `SLASH_COMMAND_TOOL_CHAR_BUDGET` | 覆盖显示给[技能工具](/en/skills#control-who-invokes-a-skill)的技能元数据字符预算。预算以上下文窗口的 1% 动态缩放，回退值为 8,000 字符。保留旧名称以向后兼容 | | `TASK_MAX_OUTPUT_LENGTH` | [子代理](/en/sub-agents)输出在截断前的最大字符数（默认：32000，最大：160000）。截断时，完整输出保存到磁盘，路径包含在截断的响应中 | | `USE_BUILTIN_RIPGREP` | 设置为 `0` 以使用系统安装的 `rg` 而不是 Claude Code 附带的 `rg` | | `VERTEX_REGION_CLAUDE_3_5_HAIKU` | 使用 Vertex AI 时覆盖 Claude 3.5 Haiku 的区域 | | `VERTEX_REGION_CLAUDE_3_5_SONNET` | 使用 Vertex AI 时覆盖 Claude 3.5 Sonnet 的区域 | | `VERTEX_REGION_CLAUDE_3_7_SONNET` | 使用 Vertex AI 时覆盖 Claude 3.7 Sonnet 的区域 | | `VERTEX_REGION_CLAUDE_4_0_OPUS` | 使用 Vertex AI 时覆盖 Claude 4.0 Opus 的区域 | | `VERTEX_REGION_CLAUDE_4_0_SONNET` | 使用 Vertex AI 时覆盖 Claude 4.0 Sonnet 的区域 | | `VERTEX_REGION_CLAUDE_4_1_OPUS` | 使用 Vertex AI 时覆盖 Claude 4.1 Opus 的区域 | | `VERTEX_REGION_CLAUDE_4_5_OPUS` | 使用 Vertex AI 时覆盖 Claude Opus 4.5 的区域 | | `VERTEX_REGION_CLAUDE_4_5_SONNET` | 使用 Vertex AI 时覆盖 Claude Sonnet 4.5 的区域 | | `VERTEX_REGION_CLAUDE_4_6_OPUS` | 使用 Vertex AI 时覆盖 Claude Opus 4.6 的区域 | | `VERTEX_REGION_CLAUDE_4_6_SONNET` | 使用 Vertex AI 时覆盖 Claude Sonnet 4.6 的区域 | | `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}使用 Vertex AI 时覆盖 Claude Opus 4.7 的区域 | | `VERTEX_REGION_CLAUDE_HAIKU_4_5` | 使用 Vertex AI 时覆盖 Claude Haiku 4.5 的区域 | 还支持标准 OpenTelemetry 导出器变量（`OTEL_METRICS_EXPORTER`、`OTEL_LOGS_EXPORTER`、`OTEL_EXPORTER_OTLP_ENDPOINT`、`OTEL_EXPORTER_OTLP_PROTOCOL`、`OTEL_EXPORTER_OTLP_HEADERS`、`OTEL_METRIC_EXPORT_INTERVAL`、`OTEL_RESOURCE_ATTRIBUTES` 和信号特定变体）。参阅[监控](/en/monitoring-usage)了解配置详情。 ## 另请参阅 * [设置](/en/settings)：所有 `settings.json` 配置，包括 `env` 键 * [CLI 参考](/en/cli-reference)：启动时标志 * [网络配置](/en/network-config)：代理和 TLS 设置 * [监控](/en/monitoring-usage)：OpenTelemetry 配置