Claude Code官方文档环境变量env

Claude Code 环境变量完整参考 - 所有变量与使用方法

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

· 阅读约 32 分钟

Claude Code 支持以下环境变量来控制其行为。在启动 claude 之前在 shell 中设置它们，或在 settings.json 中的 env 键下配置它们，以将其应用于每个会话或在团队中推出。

变量目的
ANTHROPIC_API_KEY作为 X-Api-Key 标头发送的 API 密钥。设置后，即使您已登录，此密钥也会用于替代您的 Claude Pro、Max、Team 或 Enterprise 订阅。在非交互模式（-p）中，存在时始终使用该密钥。在交互模式中，系统会提示您在密钥覆盖订阅之前批准一次。要改用您的订阅，请运行 unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKENAuthorization 标头的自定义值（您在此处设置的值将以 Bearer 为前缀）
ANTHROPIC_BASE_URL覆盖 API 端点以通过代理或网关路由请求。设置为非第一方主机时，MCP 工具搜索默认禁用。如果您的代理转发 tool_reference 块，请设置 ENABLE_TOOL_SEARCH=true
ANTHROPIC_BEDROCK_BASE_URL覆盖 Bedrock 端点 URL。用于自定义 Bedrock 端点或通过 LLM 网关路由时
ANTHROPIC_BEDROCK_MANTLE_BASE_URL覆盖 Bedrock Mantle 端点 URL
ANTHROPIC_BEDROCK_SERVICE_TIERBedrock 服务层（default、flex 或 priority）。作为 X-Amzn-Bedrock-Service-Tier 标头发送
ANTHROPIC_BETAS逗号分隔的其他 anthropic-beta 标头值列表，以包含在 API 请求中。Claude Code 已发送其需要的 beta 标头；使用此选项可在 Claude Code 添加原生支持之前选择加入 Anthropic API beta
ANTHROPIC_CUSTOM_HEADERS要添加到请求的自定义标头（Name: Value 格式，多个标头用换行符分隔）
ANTHROPIC_CUSTOM_MODEL_OPTION要在 /model 选择器中添加为自定义条目的模型 ID。使用此选项可以使非标准或网关特定的模型可选择，而无需替换内置别名
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION/model 选择器中自定义模型条目的显示描述。未设置时默认为 Custom model (<model-id>)
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME/model 选择器中自定义模型条目的显示名称。未设置时默认为模型 ID
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES请参阅模型配置
ANTHROPIC_DEFAULT_HAIKU_MODEL请参阅模型配置
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION请参阅模型配置
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME请参阅模型配置
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES请参阅模型配置
ANTHROPIC_DEFAULT_OPUS_MODEL请参阅模型配置
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION请参阅模型配置
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME请参阅模型配置
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES请参阅模型配置
ANTHROPIC_DEFAULT_SONNET_MODEL请参阅模型配置
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION请参阅模型配置
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME请参阅模型配置
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES请参阅模型配置
ANTHROPIC_FOUNDRY_API_KEYMicrosoft Foundry 身份验证的 API 密钥
ANTHROPIC_FOUNDRY_BASE_URLFoundry 资源的完整基础 URL（例如，https://my-resource.services.ai.azure.com/anthropic）
ANTHROPIC_FOUNDRY_RESOURCEFoundry 资源名称（例如，my-resource）。如果未设置 ANTHROPIC_FOUNDRY_BASE_URL，则为必需
ANTHROPIC_MODEL要使用的模型设置的名称（请参阅模型配置）
ANTHROPIC_SMALL_FAST_MODEL[已弃用] 用于后台任务的 Haiku 级模型的名称
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION使用 Bedrock 或 Bedrock Mantle 时覆盖 Haiku 级模型的 AWS 区域
ANTHROPIC_VERTEX_BASE_URL覆盖 Vertex AI 端点 URL。用于自定义 Vertex 端点或通过 LLM 网关路由时
ANTHROPIC_VERTEX_PROJECT_IDVertex AI 请求的 GCP 项目 ID。被 GCLOUD_PROJECT、GOOGLE_CLOUD_PROJECT 或您的 GOOGLE_APPLICATION_CREDENTIALS 凭证文件中的项目覆盖
API_TIMEOUT_MSAPI 请求的超时时间（以毫秒为单位）（默认值：600000，或 10 分钟；最大值：2147483647）
AWS_BEARER_TOKEN_BEDROCK用于身份验证的 Bedrock API 密钥
BASH_DEFAULT_TIMEOUT_MS长时间运行的 bash 命令的默认超时（默认值：120000，或 2 分钟）
BASH_MAX_OUTPUT_LENGTHbash 输出中的最大字符数，超过此数字后将进行中间截断
BASH_MAX_TIMEOUT_MS模型可以为长时间运行的 bash 命令设置的最大超时（默认值：600000，或 10 分钟）
CCR_FORCE_BUNDLE设置为 1 以强制 claude --remote 捆绑并上传您的本地存储库
CLAUDECODE在 Claude Code 生成的 shell 环境中设置为 1（Bash 工具、tmux 会话）
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS设置为 1 以禁用所有内置 subagent 类型
CLAUDE_AGENT_SDK_MCP_NO_PREFIX设置为 1 以跳过 SDK 创建的 MCP 服务器中工具名称上的 mcp__<server>__ 前缀
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS后台 subagents 的停滞超时（以毫秒为单位）。默认 600000（10 分钟）
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE设置触发自动压缩的上下文容量百分比（1-100）。默认情况下，自动压缩在大约 95% 容量时触发
CLAUDE_AUTO_BACKGROUND_TASKS设置为 1 以强制启用长时间运行的代理任务的自动后台处理
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR在主会话中每个 Bash 或 PowerShell 命令后返回到原始工作目录
CLAUDE_CODE_ACCESSIBILITY设置为 1 以保持原生终端光标可见并禁用反向文本光标指示器
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD设置为 1 以从使用 --add-dir 指定的目录加载内存文件
CLAUDE_CODE_API_KEY_HELPER_TTL_MS应刷新凭证的间隔（以毫秒为单位）（使用 apiKeyHelper 时）
CLAUDE_CODE_ATTRIBUTION_HEADER设置为 0 以从系统提示的开头省略归属块（客户端版本和提示指纹）
CLAUDE_CODE_AUTO_COMPACT_WINDOW设置用于自动压缩计算的上下文容量（以令牌为单位）
CLAUDE_CODE_AUTO_CONNECT_IDE覆盖自动 IDE 连接
CLAUDE_CODE_CERT_STORETLS 连接的 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覆盖调试日志文件路径
CLAUDE_CODE_DEBUG_LOG_LEVEL写入调试日志文件的最小日志级别。值：verbose、debug（默认）、info、warn、error
CLAUDE_CODE_DISABLE_1M_CONTEXT设置为 1 以禁用 1M 上下文窗口支持
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING设置为 1 以禁用 Opus 4.6 和 Sonnet 4.6 的自适应推理并回退到由 MAX_THINKING_TOKENS 控制的固定思考预算
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN设置为 1 以禁用全屏渲染并使用经典主屏幕渲染器
CLAUDE_CODE_DISABLE_ATTACHMENTS设置为 1 以禁用附件处理
CLAUDE_CODE_DISABLE_AUTO_MEMORY设置为 1 以禁用自动内存
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS设置为 1 以禁用所有后台任务功能
CLAUDE_CODE_DISABLE_CLAUDE_MDS设置为 1 以防止将任何 CLAUDE.md 内存文件加载到上下文中
CLAUDE_CODE_DISABLE_CRON设置为 1 以禁用计划任务
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS设置为 1 以从 API 请求中删除 Anthropic 特定的 anthropic-beta 请求标头和 beta 工具架构字段
CLAUDE_CODE_DISABLE_FAST_MODE设置为 1 以禁用快速模式
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY设置为 1 以禁用”Claude 表现如何？“会话质量调查
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING设置为 1 以禁用文件 checkpointing
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS设置为 1 以从 Claude 的系统提示中删除内置的提交和 PR 工作流说明和 git 状态快照
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP设置为 1 以防止在 Anthropic API 上自动重新映射 Opus 4.0 和 4.1 到当前 Opus 版本
CLAUDE_CODE_DISABLE_MOUSE设置为 1 以禁用全屏渲染中的鼠标跟踪
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 以跳过从系统范围的托管 skills 目录加载 skills
CLAUDE_CODE_DISABLE_TERMINAL_TITLE设置为 1 以禁用基于对话上下文的自动终端标题更新
CLAUDE_CODE_DISABLE_THINKING设置为 1 以强制禁用扩展思考
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL设置为 1 以禁用全屏渲染中的虚拟滚动并渲染转录中的每条消息
CLAUDE_CODE_EFFORT_LEVEL为支持的模型设置努力级别。值：low、medium、high、xhigh、max 或 auto
CLAUDE_CODE_ENABLE_AWAY_SUMMARY覆盖会话回顾可用性
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH设置为 1 以在非交互模式中的转换边界处刷新插件状态
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING控制工具调用输入是否在 API 生成时从 API 流式传输
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY设置为 1 以在 ANTHROPIC_BASE_URL 指向 Anthropic 兼容网关时从网关的 /v1/models 端点填充 /model 选择器
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION设置为 false 以禁用提示建议
CLAUDE_CODE_ENABLE_TASKS设置为 1 以在非交互模式（-p 标志）中启用任务跟踪系统
CLAUDE_CODE_ENABLE_TELEMETRY设置为 1 以启用 OpenTelemetry 数据收集以获取指标和日志
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY查询循环变为空闲后自动退出前等待的时间（以毫秒为单位）
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS设置为 1 以启用代理团队
CLAUDE_CODE_EXTRA_BODYJSON 对象以合并到每个 API 请求体的顶级
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS覆盖文件读取的默认令牌限制
CLAUDE_CODE_FORCE_SYNC_OUTPUT设置为 1 以在您的终端支持但未自动检测到时强制启用 DEC 私有模式 2026 同步输出
CLAUDE_CODE_FORK_SUBAGENT设置为 1 以启用分叉 subagents
CLAUDE_CODE_GIT_BASH_PATH仅限 Windows：Git Bash 可执行文件 (bash.exe) 的路径
CLAUDE_CODE_GLOB_HIDDEN设置为 false 以在 Claude 调用 Glob 工具时从结果中排除点文件
CLAUDE_CODE_GLOB_NO_IGNORE设置为 false 以使 Glob 工具尊重 .gitignore 模式
CLAUDE_CODE_GLOB_TIMEOUT_SECONDSGlob 工具文件发现的超时时间（以秒为单位）。在大多数平台上默认为 20 秒，在 WSL 上默认为 60 秒
CLAUDE_CODE_HIDE_CWD设置为 1 以在启动徽标中隐藏工作目录
CLAUDE_CODE_IDE_HOST_OVERRIDE覆盖用于连接到 IDE 扩展的主机地址
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL跳过 IDE 扩展的自动安装
CLAUDE_CODE_IDE_SKIP_VALID_CHECK设置为 1 以跳过连接期间 IDE 锁定文件条目的验证
CLAUDE_CODE_MAX_CONTEXT_TOKENS覆盖 Claude Code 为活动模型假设的上下文窗口大小
CLAUDE_CODE_MAX_OUTPUT_TOKENS设置大多数请求的最大输出令牌数
CLAUDE_CODE_MAX_RETRIES覆盖重试失败 API 请求的次数（默认值：10）
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY可以并行执行的只读工具和 subagents 的最大数量（默认值：10）
CLAUDE_CODE_MCP_ALLOWLIST_ENV设置为 1 以使用仅安全基线环境加上服务器的配置 env 生成 stdio MCP 服务器
CLAUDE_CODE_NATIVE_CURSOR设置为 1 以在输入插入符处显示终端自己的光标，而不是绘制的块
CLAUDE_CODE_NEW_INIT设置为 1 以使 /init 运行交互式设置流程
CLAUDE_CODE_NO_FLICKER设置为 1 以启用全屏渲染
CLAUDE_CODE_OAUTH_REFRESH_TOKENClaude.ai 身份验证的 OAuth 刷新令牌
CLAUDE_CODE_OAUTH_SCOPES刷新令牌颁发时使用的空格分隔的 OAuth 作用域
CLAUDE_CODE_OAUTH_TOKENClaude.ai 身份验证的 OAuth 访问令牌
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS刷新待处理 OpenTelemetry spans 的超时时间（以毫秒为单位）（默认值：5000）
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS刷新动态 OpenTelemetry 标头的间隔（以毫秒为单位）（默认值：1740000 / 29 分钟）
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MSOpenTelemetry 导出器在关闭时完成的超时时间（以毫秒为单位）（默认值：2000）
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE设置为 1 以让 Claude Code 在新版本可用时在后台运行您的包管理器的升级命令
CLAUDE_CODE_PERFORCE_MODE设置为 1 以启用 Perforce 感知的写入保护
CLAUDE_CODE_PLUGIN_CACHE_DIR覆盖插件根目录。默认为 ~/.claude/plugins
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS安装或更新插件时 git 操作的超时（以毫秒为单位）（默认值：120000）
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE设置为 1 以在 git pull 失败时保留现有市场缓存
CLAUDE_CODE_PLUGIN_SEED_DIR一个或多个只读插件种子目录的路径
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST由嵌入 Claude Code 的主机平台设置，并代表其管理模型提供商路由
CLAUDE_CODE_PROXY_RESOLVES_HOSTS设置为 1 以允许代理执行 DNS 解析而不是调用者
CLAUDE_CODE_REMOTE当 Claude Code 作为云会话运行时自动设置为 true
CLAUDE_CODE_REMOTE_SESSION_ID在云会话中自动设置为当前会话的 ID
CLAUDE_CODE_RESUME_INTERRUPTED_TURN设置为 1 以在上一个会话在中途结束时自动恢复
CLAUDE_CODE_SCRIPT_CAPSJSON 对象，限制特定脚本在每个会话中可以调用的次数
CLAUDE_CODE_SCROLL_SPEED在全屏渲染中设置鼠标滚轮滚动倍数。接受 1 到 20 的值
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MSSessionEnd hooks 的时间预算（以毫秒为单位）
CLAUDE_CODE_SESSION_ID在 Bash 和 PowerShell 工具子进程中自动设置为当前会话 ID
CLAUDE_CODE_SHELL覆盖自动 shell 检测
CLAUDE_CODE_SHELL_PREFIX命令前缀以包装 Claude Code 生成的所有 bash 命令
CLAUDE_CODE_SIMPLE设置为 1 以使用最小系统提示和仅 Bash、文件读取和文件编辑工具运行
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT设置为 1 以在 Opus 4.7 上使用较短的系统提示和缩写的工具描述
CLAUDE_CODE_SKIP_BEDROCK_AUTH跳过 Bedrock 的 AWS 身份验证
CLAUDE_CODE_SKIP_FOUNDRY_AUTH跳过 Microsoft Foundry 的 Azure 身份验证
CLAUDE_CODE_SKIP_MANTLE_AUTH跳过 Bedrock Mantle 的 AWS 身份验证
CLAUDE_CODE_SKIP_PROMPT_HISTORY设置为 1 以跳过将提示历史和会话转录写入磁盘
CLAUDE_CODE_SKIP_VERTEX_AUTH跳过 Vertex 的 Google 身份验证
CLAUDE_CODE_SUBAGENT_MODEL请参阅模型配置
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB设置为 1 以从子进程环境（Bash 工具、hooks、MCP stdio 服务器）中删除 Anthropic 和云提供商凭证
CLAUDE_CODE_SYNC_PLUGIN_INSTALL设置为 1 在非交互模式（-p 标志）中等待插件安装完成后再进行第一个查询
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS同步插件安装的超时时间（以毫秒为单位）
CLAUDE_CODE_SYNTAX_HIGHLIGHT设置为 false 以禁用 diff 输出中的语法突出显示
CLAUDE_CODE_TASK_LIST_ID跨会话共享任务列表
CLAUDE_CODE_TEAM_NAME此队友所属的代理团队的名称
CLAUDE_CODE_TMPDIR覆盖用于内部临时文件的临时目录
CLAUDE_CODE_TMUX_TRUECOLOR设置为 1 以允许 tmux 内的 24 位真彩色输出
CLAUDE_CODE_USE_BEDROCK使用 Bedrock
CLAUDE_CODE_USE_FOUNDRY使用 Microsoft Foundry
CLAUDE_CODE_USE_MANTLE使用 Bedrock Mantle 端点
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH设置为 1 以使用 Node.js 文件 API 而不是 ripgrep 发现自定义命令、subagents 和输出样式
CLAUDE_CODE_USE_POWERSHELL_TOOL控制 PowerShell 工具
CLAUDE_CODE_USE_VERTEX使用 Vertex
CLAUDE_CONFIG_DIR覆盖配置目录（默认值：~/.claude）
CLAUDE_EFFORT在 Bash 工具子进程和 hook 命令中自动设置为该转换的活动努力级别：low、medium、high、xhigh 或 max
CLAUDE_ENABLE_BYTE_WATCHDOG设置为 1 以强制启用字节级流式空闲监视程序，或设置为 0 以强制禁用它
CLAUDE_ENABLE_STREAM_WATCHDOG设置为 1 以启用事件级流式空闲监视程序
CLAUDE_ENV_FILEClaude Code 在每个 Bash 命令之前在同一 shell 进程中运行的 shell 脚本的路径
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX当未提供显式名称时，自动生成的远程控制会话名称的前缀
CLAUDE_STREAM_IDLE_TIMEOUT_MS流式空闲监视程序关闭停滞连接前的超时（以毫秒为单位）。默认和最小 300000（5 分钟）
DISABLE_AUTOUPDATER设置为 1 以禁用自动后台更新
DISABLE_AUTO_COMPACT设置为 1 以禁用接近上下文限制时的自动压缩
DISABLE_COMPACT设置为 1 以禁用所有压缩：自动压缩和手动 /compact 命令
DISABLE_COST_WARNINGS设置为 1 以禁用成本警告消息
DISABLE_DOCTOR_COMMAND设置为 1 以隐藏 /doctor 命令
DISABLE_ERROR_REPORTING设置为 1 以选择退出 Sentry 错误报告
DISABLE_EXTRA_USAGE_COMMAND设置为 1 以隐藏 /extra-usage 命令
DISABLE_FEEDBACK_COMMAND设置为 1 以禁用 /feedback 命令。也接受较旧的名称 DISABLE_BUG_COMMAND
DISABLE_GROWTHBOOK设置为 1 以禁用 GrowthBook 功能标志获取并对每个标志使用代码默认值
DISABLE_INSTALLATION_CHECKS设置为 1 以禁用安装警告
DISABLE_INSTALL_GITHUB_APP_COMMAND设置为 1 以隐藏 /install-github-app 命令
DISABLE_INTERLEAVED_THINKING设置为 1 以防止发送交错思考 beta 标头
DISABLE_LOGIN_COMMAND设置为 1 以隐藏 /login 命令
DISABLE_LOGOUT_COMMAND设置为 1 以隐藏 /logout 命令
DISABLE_PROMPT_CACHING设置为 1 以禁用所有模型的 prompt caching
DISABLE_PROMPT_CACHING_HAIKU设置为 1 以禁用 Haiku 模型的 prompt caching
DISABLE_PROMPT_CACHING_OPUS设置为 1 以禁用 Opus 模型的 prompt caching
DISABLE_PROMPT_CACHING_SONNET设置为 1 以禁用 Sonnet 模型的 prompt caching
DISABLE_TELEMETRY设置为 1 以选择退出遥测。遥测事件不包括用户数据
DISABLE_UPDATES设置为 1 以阻止所有更新，包括手动 claude update 和 claude install
DISABLE_UPGRADE_COMMAND设置为 1 以隐藏 /upgrade 命令
DO_NOT_TRACK设置为 1 以选择退出遥测。等同于设置 DISABLE_TELEMETRY
ENABLE_CLAUDEAI_MCP_SERVERS设置为 false 以禁用 Claude Code 中的 claude.ai MCP servers
ENABLE_PROMPT_CACHING_1H设置为 1 以请求 1 小时的 prompt cache TTL 而不是默认的 5 分钟
ENABLE_PROMPT_CACHING_1H_BEDROCK已弃用。改用 ENABLE_PROMPT_CACHING_1H
ENABLE_TOOL_SEARCH控制 MCP 工具搜索。值：true、auto、auto:N、false
FALLBACK_FOR_ALL_PRIMARY_MODELS设置为任何非空值以在任何主模型上重复过载错误后触发回退到 --fallback-model
FORCE_AUTOUPDATE_PLUGINS设置为 1 以强制插件自动更新
FORCE_PROMPT_CACHING_5M设置为 1 以强制 5 分钟的 prompt cache TTL
HTTP_PROXY为网络连接指定 HTTP 代理服务器
HTTPS_PROXY为网络连接指定 HTTPS 代理服务器
IS_DEMO设置为 1 以启用演示模式：隐藏标头中的电子邮件和组织名称
MAX_MCP_OUTPUT_TOKENSMCP 工具响应中允许的最大令牌数（默认值：25000）
MAX_STRUCTURED_OUTPUT_RETRIES当模型的响应无法针对 --json-schema 进行验证时重试的次数。默认为 5
MAX_THINKING_TOKENS覆盖扩展思考令牌预算
MCP_CLIENT_SECRET需要预配置凭证的 MCP 服务器的 OAuth 客户端密钥
MCP_CONNECTION_NONBLOCKING设置为 true 在非交互模式（-p）中完全跳过 MCP 连接等待
MCP_CONNECT_TIMEOUT_MS第一个查询等待 MCP 连接批处理的时间（以毫秒为单位）（默认值：5000）
MCP_OAUTH_CALLBACK_PORTOAuth 重定向回调的固定端口
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE启动期间并行连接的远程 MCP 服务器（HTTP/SSE）的最大数量（默认值：20）
MCP_SERVER_CONNECTION_BATCH_SIZE启动期间并行连接的本地 MCP 服务器（stdio）的最大数量（默认值：3）
MCP_TIMEOUTMCP 服务器启动的超时（以毫秒为单位）（默认值：30000，或 30 秒）
MCP_TOOL_TIMEOUTMCP 工具执行的超时（以毫秒为单位）（默认值：100000000，约 28 小时）
NO_PROXY域和 IP 列表，对其的请求将直接发出，绕过代理
OTEL_LOG_RAW_API_BODIES设置为 1 以将完整的 Anthropic Messages API 请求和响应 JSON 作为 api_request_body / api_response_body 日志事件发出
OTEL_LOG_TOOL_CONTENT设置为 1 以在 OpenTelemetry span 事件中包含工具输入和输出内容
OTEL_LOG_TOOL_DETAILS设置为 1 以在 OpenTelemetry 跟踪和日志中包含工具输入参数
OTEL_LOG_USER_PROMPTS设置为 1 以在 OpenTelemetry 跟踪和日志中包含用户提示文本
OTEL_METRICS_INCLUDE_ACCOUNT_UUID设置为 false 以从指标属性中排除帐户 UUID（默认值：包含）
OTEL_METRICS_INCLUDE_SESSION_ID设置为 false 以从指标属性中排除会话 ID（默认值：包含）
OTEL_METRICS_INCLUDE_VERSION设置为 true 以在指标属性中包含 Claude Code 版本（默认值：排除）
SLASH_COMMAND_TOOL_CHAR_BUDGET覆盖显示给 Skill tool 的 skill 元数据的字符预算
TASK_MAX_OUTPUT_LENGTHsubagent 输出中的最大字符数（默认值：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使用 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 和信号特定变体）也受支持。

另请参阅

  • 设置：在 settings.json 中配置环境变量，使其应用于每个会话
  • CLI 参考：启动时标志
  • 网络配置：代理和 TLS 设置
  • 监控：OpenTelemetry 配置

本文翻译自 Anthropic Claude Code 官方文档，最近一次同步：2025-05-01。