CLAUDE_CODE_* 变量（A 到 E）

开关类变量的取值见总览：1/true/yes/on 打开，0/false/no/off 关闭（个别变量例外，在行内说明）。版本要求和默认值以官方为准。

A 到 C

变量	用途
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：全屏渲染时每帧重绘整个屏幕而不是增量更新；全屏模式出现陈旧或错位文字时使用
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT	1：每个请求都发送 effort 参数，即使 Claude Code 不认为该模型 ID 支持努力等级；通过 LLM 网关或第三方服务商路由时使用
CLAUDE_CODE_API_KEY_HELPER_TTL_MS	使用 apiKeyHelper 时刷新凭证的间隔（毫秒）
CLAUDE_CODE_ARTIFACT_AUTO_OPEN	0：发布新制品（artifact）时不自动打开浏览器
CLAUDE_CODE_ARTIFACT_COMMENTS	0：不让 Claude 读取和回复制品上的评论（CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 已关闭制品时无效）
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT	0：不让 Claude 自行回复发给它的评论
CLAUDE_CODE_ATTRIBUTION_HEADER	0：省略系统提示开头携带客户端版本和提示指纹的归属块（直连 Anthropic API 时会影响缓存，细节见官方）
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS	启用 CLAUDE_AUTO_BACKGROUND_TASKS 时，提醒 Claude 查看仍在运行的后台子智能体的间隔秒数，只接受 1 到 86400 的整数
CLAUDE_CODE_AUTO_COMPACT_WINDOW	自动压缩窗口，单位 token，100000 到 1000000，只接受纯整数（500k 会被读成 500 并被夹到下限 100K）
CLAUDE_CODE_AUTO_CONNECT_IDE	覆盖自动 IDE 连接：默认在支持的 IDE 集成终端里启动时自动连接；false 阻止，true 强制
CLAUDE_CODE_AUTO_MODE_SERVER	控制 Claude Code 是否请服务器评审 auto 模式的动作；0 改用 Claude Code 自己的分类器请求
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS	等待 AWS 默认凭证提供链产出凭证的毫秒数，超时请求失败并报 AWS default-chain credential resolve timed out
CLAUDE_CODE_BASH_EDIT_DIFF	0：关闭 Bash 命令运行期间改变的文件的 diff 记录；1：在所有权限模式下记录。优先于 bashEditDiffEnabled 设置
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING	0：让非交互会话在每个回合结束时向宿主报告空闲状态，即使后台工作仍在运行
CLAUDE_CODE_BRIDGE_SESSION_ID	Remote Control 连接活跃期间，在 Bash 工具和 Hook 命令子进程里自动设置，连接结束时移除；值是该会话的 ID
CLAUDE_CODE_BS_AS_CTRL_BACKSPACE	0：把 0x08（^H）读成普通 Backspace；1：读成 Ctrl+Backspace；覆盖平台默认
CLAUDE_CODE_CERT_STORE	TLS 连接的 CA 证书来源，逗号分隔：bundled（随 Claude Code 附带的 Mozilla CA 集）、system（操作系统信任库）
CLAUDE_CODE_CHILD_SESSION	在 Claude Code 通过 Bash、PowerShell、Monitor 工具、Hook 命令和状态栏命令派生的子进程里设为 1（不为 stdio MCP 服务器子进程设置）
CLAUDE_CODE_CLIENT_CERT / CLAUDE_CODE_CLIENT_KEY / CLAUDE_CODE_CLIENT_KEY_PASSPHRASE	mTLS 认证的客户端证书路径、私钥路径、加密私钥的口令（可选）
CLAUDE_CODE_CONNECT_TIMEOUT_MS	已在 v2.1.186 移除，现为空操作；请求总超时用 API_TIMEOUT_MS

D：调试与各类 DISABLE_*

变量	用途
CLAUDE_CODE_DEBUG_LOGS_DIR	覆盖调试日志文件路径（尽管名字叫 DIR）；需另用 --debug、/debug 或 DEBUG 开启调试模式
CLAUDE_CODE_DEBUG_LOG_LEVEL	写入调试日志的最低级别：verbose、debug（默认）、info、warn、error；verbose 包含完整状态栏命令等高流量诊断
CLAUDE_CODE_DISABLE_1M_CONTEXT	1：禁用 1M 上下文窗口支持，选择器里不再提供 1M 变体
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING	1：在 Opus 4.6 和 Sonnet 4.6 上禁用自适应推理，回退到由 MAX_THINKING_TOKENS 控制的固定思考预算（对 Fable 模型等无效）
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION	1：不再按键合并各管理员来源的托管设置 env 块，只应用最高优先级来源的整个 env 块（v2.1.223 之前的行为）
CLAUDE_CODE_DISABLE_ADVISOR_TOOL	1：禁用 advisor 工具，/advisor 不可用，已配置的 advisorModel 被忽略
CLAUDE_CODE_DISABLE_AGENT_VIEW	1：关闭后台智能体和智能体视图（claude agents、--bg、/background、按需监督进程）；等价于 disableAgentView 设置
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN	1：禁用全屏渲染，使用经典主屏渲染器，对话留在终端原生滚动缓冲区里，Cmd+f 和 tmux 复制模式照常工作
CLAUDE_CODE_DISABLE_ARTIFACT	1：关闭把会话输出发布为 claude.ai 私有网页的 Artifact 工具；设置后任何设置文件都无法再把它打开
CLAUDE_CODE_DISABLE_ATTACHMENTS	1：禁用附件处理，@ 文件提及按纯文本发送而不展开成文件内容
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK	1：让进程自己运行 gcpAuthRefresh/awsAuthRefresh 命令，而不是等另一个进程运行（v2.1.286+）
CLAUDE_CODE_DISABLE_AUTO_MEMORY	1：禁用自动记忆；0：即使 --bare 或 autoMemoryEnabled: false 也强制开启
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS	1：禁用所有后台任务功能，含 Bash 和子智能体工具的 run_in_background、自动转后台和 Ctrl+B
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT / …_GUARD	1：分别停止把缺失或为空 Content-Type 的 Bedrock 流式响应当作二进制事件流 / 跳过 Bedrock 流式响应必须是 application/vnd.amazon.eventstream 的检查
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF	1：监督进程停止、重启或更新时，不再停止后台会话正在运行的后台 shell 命令、动态工作流和后台子智能体
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP	1：不在内存压力下终止后台 shell 命令（macOS 和 Linux 默认会终止）
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS	1：禁用随 Claude Code 附带的 Skill 和工作流，/init 等内置命令仍可键入但被隐藏
CLAUDE_CODE_DISABLE_CFC_PROMPT	1：保留 Claude in Chrome 浏览器工具，但省略系统提示里的 Chrome 部分和 /claude-in-chrome 内置 Skill（面向嵌入 Claude Code 的宿主）
CLAUDE_CODE_DISABLE_CLAUDE_MDS	1：不把任何 CLAUDE.md 记忆文件（用户、项目、自动记忆）载入上下文
CLAUDE_CODE_DISABLE_CRON	1：禁用计划任务，/loop 和 cron 工具不可用，已安排的任务停止触发
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT	1：关闭对关键路径删除提示的时间限制；auto 模式下这些删除交给分类器
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS	1：从 API 请求里剥掉 Anthropic 特有的 anthropic-beta 头和 beta 工具 schema 字段（如 defer_loading、eager_input_streaming）；服务商拒绝这些时使用
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS	1：禁用内置 Explore 和 Plan 子智能体
CLAUDE_CODE_DISABLE_FAST_MODE	1：禁用 fast mode
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY	1：禁用「How is Claude doing?」会话质量调查（DISABLE_TELEMETRY、DO_NOT_TRACK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 也会禁用它）
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING	1：禁用文件检查点，/rewind 无法恢复代码改动；覆盖 fileCheckpointingEnabled 设置
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS	1：从 Claude 上下文里去掉内置提交与 PR 工作流指令和 git 状态快照，适合用自己的 git 工作流 Skill 时
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP	1：阻止把 Opus 4.0 和 4.1 自动重映射到当前 Opus 版本（想有意固定旧模型时）
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK	1：Bedrock 和 Agent Platform 上账号在会话中途失去所用模型的访问权限时，不切换到更旧的模型
CLAUDE_CODE_DISABLE_MOUSE / …_MOUSE_CLICKS	1：禁用全屏渲染里的鼠标跟踪（键盘 PgUp/PgDn 滚动仍可用）/ 禁用点击、拖拽和悬停处理但保留滚轮滚动
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION	1：API 请求因连接重置或 TLS 握手错误失败时，不再重新读取 mTLS 客户端证书和密钥
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	设为任意非空值禁用非必要网络流量：自动更新、遥测、错误报告、/feedback、Claude 起草的反馈、发行说明等；也会让依赖功能开关的功能不可用（见总览）
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK	1：流式请求中途失败时禁用非流式回退，流式错误直接交给重试层
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK	1：即使你正在终端里输入或终端有焦点，PushNotification 工具也发送桌面通知
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL	1：禁用官方插件市场的自动注册
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS	1：权限请求发给 Agent SDK canUseTool 回调的会话里，对未回答的权限请求不运行 Notification Hook
CLAUDE_CODE_DISABLE_POLICY_SKILLS	1：不加载系统级托管 Skill 目录里的 Skill（适合不该加载运维预置 Skill 的容器或 CI 会话）
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY	1：关闭 PowerShell 工具对 rd、rmdir、del、erase 作用于系统路径（驱动器根、主目录）的拒绝检查
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT	1：关闭对目标完全是命令替换输出的递归 rm（如 rm -rf "$(pwd)"）的关键路径检查
CLAUDE_CODE_DISABLE_TERMINAL_TITLE	1：禁用按对话上下文自动更新终端标题（同时跳过生成会话标题的后台小模型请求）
CLAUDE_CODE_DISABLE_THINKING	1：从 API 请求里完全省略 thinking 参数，是给拒绝该参数的代理和网关的兼容选项
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT	1：Claude Code 不认识模型 ID（如 LLM 网关别名）时跳过主动自动压缩
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL	1：禁用全屏渲染的虚拟滚动，渲染转录里的每条消息（滚动时出现空白区域时使用）
CLAUDE_CODE_DISABLE_WEB_FETCH	1：关闭 WebFetch 工具，WebSearch 仍可用（v2.1.285+）
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER	1：Windows 上直接启动 PowerShell 工具命令，而不经 cmd.exe 启动器
CLAUDE_CODE_DISABLE_WORKFLOWS	1：禁用工作流，等价于 disableWorkflows 设置

E：努力等级、启用类与实验功能

变量	用途
CLAUDE_CODE_EFFORT_LEVEL	设置支持的模型的努力等级：low、medium、high、xhigh、max，或 auto 用模型默认；可用级别取决于模型；优先于 /effort 等
CLAUDE_CODE_ENABLE_AUTO_MODE	为兼容旧版本而接受，没有效果：auto 模式在所有服务商上默认可用
CLAUDE_CODE_ENABLE_AWAY_SUMMARY	覆盖会话回顾（离开摘要）的可用性：0 强制关闭，1 在 awaySummaryEnabled 为 false 时强制开启
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH	1：非交互模式里后台安装完成后在回合边界刷新插件状态（默认关闭，因为刷新会在会话中途改变系统提示）
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL	1：发往 Anthropic 的非必要流量被屏蔽时，把质量调查路由到你自己的 OpenTelemetry 收集器
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING	控制工具调用输入是否在 Claude 生成时就从 API 流式到达；关闭时大的工具输入（如长文件写入）要等生成完才到
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY	1：ANTHROPIC_BASE_URL 指向 Anthropic 兼容网关（LiteLLM、Kong 等）时，用网关的 /v1/models 端点填充 /model 选择器
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE	已在 v2.1.142 移除（fast mode 默认从 Opus 4.6 换成 Opus 4.7）
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION	false：关闭提示建议（输入框里灰色的预测）；优先于 promptSuggestionEnabled 设置
CLAUDE_CODE_ENABLE_TASKS	选择会话里提供哪些任务跟踪工具；默认提供 TaskCreate、TaskUpdate、TaskGet、TaskList
CLAUDE_CODE_ENABLE_TELEMETRY	1：启用 OpenTelemetry 指标和日志收集，配置 OTel 导出器之前必需；在 shell、用户设置或托管设置里设置
CLAUDE_CODE_ENABLE_TODO_TOOLS	1：让所有模型都有任务跟踪工具（否则只在「任务工具可用性」列出的模型上默认提供）
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY	查询循环变空闲后自动退出前等待的毫秒数，适合 SDK 模式的自动化和脚本
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS	1：启用智能体团队（实验性，默认禁用）
CLAUDE_CODE_EXTRA_BODY	合并进每个 API 请求体顶层的 JSON 对象，用来传递 Claude Code 未直接暴露的服务商特有参数