Reference: Env Var Categories¶

目的：速查 所有环境变量按类别分组关联：docs/ENV_VARS.md

1. 总览¶

已知 ENV: ~30+
类别: 5 (鉴权 / 行为 / 调试 / 性能 / 集成)

2 指标。

2. 5 个鉴权 ENV¶

ENV	用途	默认
`ANTHROPIC_API_KEY`	API key	-
`CLAUDE_CODE_USE_BEDROCK`	AWS Bedrock	false
`CLAUDE_CODE_SKIP_BEDROCK_AUTH`	跳过 Bedrock 预取	false
`CLAUDE_CODE_USE_VERTEX`	GCP Vertex	false
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	跳过 Vertex 预取	false

5 个。

3. 5 个行为 ENV¶

ENV	用途	默认
`CLAUDE_CODE_SIMPLE`	Bare 模式	false
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	禁改 title	false
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	禁虚拟滚动	false
`CLAUDE_CODE_DISABLE_MESSAGE_ACTIONS`	禁消息操作	false
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	禁附件	false

5 个。

4. 5 个调试 ENV¶

ENV	用途	默认
`CLAUDE_CODE_DEBUG`	类别过滤	-
`CLAUDE_CODE_DEBUG_FILE`	debug log 文件	-
`CLAUDE_CODE_DEBUG_TO_STDERR`	debug 到 stderr	false
`CLAUDE_CODE_VERBOSE`	verbose	false
`CLAUDE_CODE_ENTRYPOINT`	入口点	cli

5 个。

5. 5 个性能 ENV¶

ENV	用途	默认
`CLAUDE_CODE_EXIT_AFTER_FIRST_RENDER`	仅测 perf	false
`CLAUDE_CODE_DISABLE_TELEMETRY`	禁遥测	false
`CLAUDE_CODE_DISABLE_ERROR_REPORTING`	禁错误上报	false
`CLAUDE_CODE_MORERIGHT`	MORERIGHT (ANT-ONLY)	false
`CLAUDE_CODE_NO_FLICKER`	无闪烁	true

5 个。

6. 10+ 集成 ENV¶

ENV	用途	平台
`GITHUB_ACTIONS`	GitHub Actions	-
`NODE_EXTRA_CA_CERTS`	CA 证书	-
`CLAUDE_CODE_CLIENT_CERT`	客户端证书	-
`CLAUDE_CODE_SESSION_ACCESS_TOKEN`	远程 session	-
`CLAUDE_CODE_WEBSOCKET_AUTH_FILE_DESCRIPTOR`	WS auth	-
`CLAUDE_CODE_ENVIRONMENT_KIND`	环境种类	-
`CLAUDE_CODE_QUESTION_PREVIEW_FORMAT`	问题预览	-
`MCP_CLIENT_SECRET`	MCP OAuth	-
`OTEL_EXPORTER_OTLP_ENDPOINT`	OTEL	-
`OTEL_*`	OpenTelemetry	-
`LANG`	Locale	-
`LC_ALL`	Locale 备选	-
`TMUX`	tmux 检测	-
`PATH`	命令搜索	-
`HOME`	home 目录	-

15+。

7. 5 个 ANT-ONLY ENV¶

ENV	用途
`CLAUDE_CODE_TASK_LIST_ID`	Task list ID
`CLAUDE_CODE_CHANNELS`	Channels
`CLAUDE_CODE_DANGEROUSLY_LOAD_DEVELOPMENT_CHANNELS`	Dev channels
`CLAUDE_CODE_REMOTE_CONTROL`	Remote control
`CLAUDE_CODE_PROACTIVE`	Proactive

5 个。

8. 5 个 macOS 特有 ENV¶

ENV	用途
`__CFBundleIdentifier`	Bundle ID（URL handler）
`NoDefaultCurrentDirectoryInExePath`	PATH 防御（Windows）
`SSH_AUTH_SOCK`	SSH agent
`SSH_AGENT_PID`	SSH agent PID
`LANG`	macOS locale

5 个。

9. 5 个 Windows 特有 ENV¶

ENV	用途
`PATHEXT`	可执行扩展名
`USERPROFILE`	用户目录
`APPDATA`	App data
`LOCALAPPDATA`	Local app data
`SYSTEMROOT`	Windows 目录

5 个。

10. 5 个 Linux 特有 ENV¶

ENV	用途
`XDG_RUNTIME_DIR`	用户 runtime
`XDG_CONFIG_HOME`	配置目录
`XDG_DATA_HOME`	数据目录
`XDG_CACHE_HOME`	缓存目录
`DBUS_SESSION_BUS_ADDRESS`	D-Bus session

5 个。

11. 4 个 Node/Bun 进程 ENV¶

ENV	用途
`NODE_ENV`	'production' / 'development'
`NODE_OPTIONS`	Node 启动参数
`BUN_CONFIG_*`	Bun 配置
`process.argv`	命令行参数（不是 env 但类似）

4 个。

12. 5 个 truthy 判断¶

isEnvTruthy('1')   // true
isEnvTruthy('true') // true
isEnvTruthy('yes')  // true
isEnvTruthy('on')   // true
isEnvTruthy('0')   // false

4 truthy + 1 false。

13. 5 个 ENV 优先级¶

1. CLI flag         最高
2. env var
3. settings.json
4. default         最低

4 级。

14. 5 个常见 ENV 组合¶

14.1 CI 跑 Claude Code¶

ANTHROPIC_API_KEY=... \
CLAUDE_CODE_DISABLE_TELEMETRY=1 \
claude -p "Review this PR"

CI。

14.2 Bare 模式（最轻）¶

CLAUDE_CODE_SIMPLE=1 \
claude

Bare。

14.3 Debug 模式¶

CLAUDE_CODE_DEBUG=api,hooks \
claude

Debug。

14.4 AWS Bedrock¶

CLAUDE_CODE_USE_BEDROCK=1 \
AWS_ACCESS_KEY_ID=... \
AWS_SECRET_ACCESS_KEY=... \
claude

Bedrock。

14.5 ANT-ONLY 内部¶

CLAUDE_CODE_TASK_LIST_ID=my-tasks \
CLAUDE_CODE_MORERIGHT=1 \
claude

ANT。

15. 5 个 ENV 调试¶

# 1. 看 env
env | grep CLAUDE_

# 2. 看 process.env
claude --debug api

# 3. 测试 isEnvTruthy
echo $CLAUDE_CODE_SIMPLE
# 实际判断 isEnvTruthy

3 调试。

15.1 验证 env 生效¶

claude --debug api 2>&1 | grep "ANTHROPIC_API_KEY"

grep。

15.2 unset env¶

unset ANTHROPIC_API_KEY
claude  # 失败 / 用 keychain

unset。

16. 速查：30+ ENV 一览¶

鉴权 (5):
  ANTHROPIC_API_KEY
  CLAUDE_CODE_USE_BEDROCK / _SKIP_BEDROCK_AUTH
  CLAUDE_CODE_USE_VERTEX / _SKIP_VERTEX_AUTH

行为 (5):
  CLAUDE_CODE_SIMPLE
  DISABLE_TERMINAL_TITLE / _VIRTUAL_SCROLL
  DISABLE_MESSAGE_ACTIONS / _ATTACHMENTS

调试 (5):
  CLAUDE_CODE_DEBUG / _FILE / _TO_STDERR
  _VERBOSE / _ENTRYPOINT

性能 (5):
  EXIT_AFTER_FIRST_RENDER
  DISABLE_TELEMETRY / _ERROR_REPORTING
  _MORERIGHT / _NO_FLICKER

集成 (15+):
  GITHUB_ACTIONS / NODE_EXTRA_CA_CERTS
  _CLIENT_CERT / _SESSION_ACCESS_TOKEN
  _WEBSOCKET_AUTH_FILE_DESCRIPTOR
  _ENVIRONMENT_KIND / _QUESTION_PREVIEW_FORMAT
  MCP_CLIENT_SECRET / OTEL_*
  LANG / LC_ALL / TMUX / PATH / HOME

ANT-ONLY (5):
  _TASK_LIST_ID / _CHANNELS
  _DANGEROUSLY_LOAD_DEVELOPMENT_CHANNELS
  _REMOTE_CONTROL / _PROACTIVE

6 类。

17. 总结¶

ENV 分类 = 5+ 类 ~30+ 变量。

核心： - 5 鉴权 - 5 行为 - 5 调试 - 5 性能 - 15+ 集成 - 5 ANT-ONLY

下一步： - 看 ENV_VARS.md - 配置你的 .env - 测试