CLAUDE_CODE_* 变量（F 到 O）
以 CLAUDE_CODE_F 到 CLAUDE_CODE_O 开头的环境变量：文件读取、终端渲染、fork 子智能体、网关提示头、IDE 连接、各类上限与并发、MCP 超时、OAuth 与 OpenTelemetry。
取值约定与总览一致；默认值、上限和版本要求以官方为准。
| 变量 | 用途 |
|---|---|
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS | 覆盖文件读取的默认 token 上限，需要完整读取较大文件时使用 |
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE | 1：即使这个 claude 是从另一个 Claude Code 会话里启动的，也强制持久化转录、提示历史和 claude agents 注册 |
CLAUDE_CODE_FORCE_STRIKETHROUGH | 1：终端支持但未被自动检测到时（如没有转发 TERM_PROGRAM 的 SSH），强制渲染 ~~text~~ 删除线 |
CLAUDE_CODE_FORCE_SYNC_OUTPUT | 1：终端支持但未被自动检测到时，强制启用 DEC 私有模式 2026 同步输出（如 Emacs eat） |
CLAUDE_CODE_FORK_SUBAGENT | 控制 fork 模式（让 Claude 自己派生分叉子智能体），默认仅交互会话开启；1 让 claude -p 和 Agent SDK 也开启 |
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT | 1：在 claude -p --output-format stream-json 输出里输出子智能体的文本和思考块，等价于 --forward-subagent-text 标志 |
CLAUDE_CODE_GATEWAY_HINT_HEADERS | 1：在自定义代理或第三方服务商（如 Bedrock）上发送网关提示头，如 x-claude-code-request-class、x-claude-code-compaction |
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS | CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 触发的网关模型发现请求的超时（毫秒，默认 3000） |
CLAUDE_CODE_GIT_BASH_PATH | 仅 Windows：Git Bash 可执行文件（bash.exe）路径，Git Bash 已装但不在 PATH 里时使用 |
CLAUDE_CODE_GLOB_HIDDEN | false：Glob 工具结果排除点文件（默认包含；不影响 @ 补全、ls、Grep、Read） |
CLAUDE_CODE_GLOB_NO_IGNORE | false：让 Glob 工具遵循 .gitignore（默认返回所有匹配文件包括被忽略的） |
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS | Glob 工具文件发现的超时秒数（多数平台默认 20，WSL 60） |
CLAUDE_CODE_GOAL_CHECKIN_MINUTES | 后台工作让活跃目标等待多少分钟后，Claude Code 请 Claude 去查看（默认 30，0 关闭，只接受整数分钟） |
CLAUDE_CODE_HIDE_CWD | 1：在启动 logo 里隐藏工作目录（共享屏幕或录制时路径会暴露你的系统用户名） |
CLAUDE_CODE_IDE_HOST_OVERRIDE | 覆盖连接 IDE 扩展用的主机地址（默认自动检测，含 WSL 到 Windows 的路由） |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL | 1：跳过 IDE 扩展自动安装，等价于 autoInstallIdeExtension: false |
CLAUDE_CODE_IDE_SKIP_VALID_CHECK | 1：连接时跳过 IDE lockfile 条目的校验（IDE 明明在运行却自动连接找不到时使用） |
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS | 一个会话里同时运行多少子智能体，之后 Agent 工具拒绝再派生（默认 20，只接受纯数字正整数） |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | 覆盖 Claude Code 对当前模型假定的上下文窗口大小；自 v2.1.193 起具体如何生效取决于模型 ID 的解析方式 |
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH | 每个 MCP 工具描述和每个 MCP 服务器说明发给模型的最大字符数（默认 2048，超出截断） |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | 多数请求的最大输出 token 数；默认值和上限因模型而异，高于模型上限的值会被降到上限 |
CLAUDE_CODE_MAX_RETRIES | 失败的 API 请求重试次数（默认 10；自 v2.1.186 上限 15，自 v2.1.199 CLAUDE_CODE_RETRY_WATCHDOG 提高默认并去掉上限） |
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION | 已在 v2.1.224 移除，现为空操作 |
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH | 主对话之下允许的子智能体层数（默认 3，默认下子智能体可再派生子智能体，第三层不能再往下派生） |
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY | 可并行执行的只读工具和子智能体的最大数量（默认 10，值越高并行度越高、资源消耗越多） |
CLAUDE_CODE_MAX_TURNS | 没有显式上限时的智能体回合数上限，等价于 --max-turns（两者都设时以标志为准；非正整数的值被忽略） |
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION | 一个会话可发起的 WebSearch 调用总数上限（默认 200，达到后再调用返回提示让它用已有信息继续） |
CLAUDE_CODE_MCP_ALLOWLIST_ENV | 1：stdio MCP 服务器只用安全的基线环境加服务器自己配置的 env 启动，而不继承你的 shell 环境 |
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS | 仍在运行的 MCP 工具调用多久后转为后台任务（毫秒，默认 120000，0 关闭自动转后台） |
CLAUDE_CODE_MCP_STARTUP_WAIT_MS | 非交互会话的第一个回合等待仍在连接的 MCP 服务器多久（毫秒），取代默认的首轮等待 |
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT | MCP 工具调用的空闲超时（毫秒）：stdio、HTTP、SSE、WebSocket 或 claude.ai 连接器服务器在这段时间里既不响应也无进度通知就中止调用 |
CLAUDE_CODE_MESSAGING_SOCKET / CLAUDE_CODE_MESSAGING_TOKEN | 由 Claude Code 设置，不是你设置：绑定收件箱套接字的会话里，导出该套接字路径和每会话令牌给 Hook 与 Bash 命令（用于会话间消息） |
CLAUDE_CODE_NATIVE_CURSOR | 1：在输入插入点显示终端自己的光标而不是绘制的块，光标遵循终端的闪烁、形状和焦点设置 |
CLAUDE_CODE_NEW_INIT | 1：让 /init 运行交互式设置流程，先询问要生成哪些文件（CLAUDE.md、Skill、Hook），再探索代码库并写入 |
CLAUDE_CODE_NONBLOCKING_STDOUT | 1：通过第二个非阻塞文件描述符写终端输出，使停止读取的终端（暂停的 tmux 控制模式窗格、卡住的 SSH 连接）不会让 Claude Code 卡住 |
CLAUDE_CODE_NO_FLICKER | 1：启用全屏渲染（研究预览，减少闪烁并让长对话内存保持平稳），覆盖 tui 设置，也可用 /tui 切换 |
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_CODE_OPUS_4_6_FAST_MODE_OVERRIDE | 已在 v2.1.160 移除，现为空操作 |
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH | 含内容的 OpenTelemetry 属性（模型响应、工具内容、系统提示、原始 API 请求体）的最大长度（UTF-16 码元，含截断标记） |
CLAUDE_CODE_OTEL_DIAG_STDERR | 1：把 OpenTelemetry 导出器的诊断错误写到 stderr（默认只在 --debug 下可见，配置错误的导出器如 Prometheus 端口冲突会悄悄失败） |
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 毫秒），退出时指标丢失就调大 |