Claude Code CLI 2.1.235 环境变量参考：声明、读取和真实作用为什么不是一回事¶

读者问题¶

为什么同一个环境变量出现在 bundle 里，却可能完全不影响 Claude Code？为什么另一个变量不在 typed schema 中，客户端反而真的读取了它？

一句话心智模型¶

环境变量要经过 名称进入 schema -> 运行时被读取 -> 解析/默认值 -> 业务 consumer -> provider/policy/service 二次门 才能改变行为；任何一层缺失，都不能把一个字符串命中写成已启用功能。

flowchart LR
  A[进程环境] --> B{typed builder?}
  B -->|是| C[类型与 options 解析]
  B -->|否| D[直接或代理读取]
  C --> E{存在 named 或 finite dynamic callsite?}
  D --> E
  E -->|否| F[No static consumer / Boundary]
  E -->|是| G[consumer 解释与 fallback]
  G --> H[provider / policy / service gates]
  H --> I[用户可见行为]

贯穿场景¶

用户设置 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC。第一个变量既改变请求 endpoint，也改变 first-party host 判定；第二个变量进入 bearer header；第三个变量关闭一方 analytics 和在线 Feature Evaluation，却不关闭模型请求。三个变量都被读取，但它们拥有不同 consumer、优先级和失败边界。只看名称列表无法得到这些结论。

状态总表¶

Accessor 分布：environment-proxy.bracket=2；environment-proxy.property=1532；process.env.bracket=143；process.env.property=871。

typed 类型分布：bool=277；enum=4；int=97；str=423；triBool=41。

字段怎么读¶

|| 会在空字符串、0、false 时切 fallback；?? 只在 null/undefined 时切 fallback。inventory 记录的是表达式，不是一次真实运行的求值结果。

失败与服务端边界¶

1. typed 声明成功、值也可解析，不代表任何 consumer 读取它；原 named-only 口径有 80 项，扣除 0 个 finite dynamic consumer 后，真正无静态 consumer 的剩 80 项。
2. named read 存在，不代表当前 provider、entrypoint、policy、platform 或账户状态能到达该分支。
3. 动态读取的最终名称依赖局部变量、循环、依赖库或运行时输入；145 个调用点必须保留表达式而不是猜名称。
4. credential、endpoint、feature payload、cloud identity、proxy 和服务端 entitlement 的真实值不在 shipped bundle 中。
5. typed schema 混有 bundled dependency surface；本文的类别是导航 heuristic，不是 Anthropic 产品归属标签。

四个诊断场景¶

1. 变量写了但没有效果¶

先看本表是否有 direct named 或 finite dynamic consumer，再看 access mode、lexical role、fallback 和人工 consumer 专题。若只有 schema 声明，结论只能是 Boundary，不能继续猜布尔语义。

2. 自定义 endpoint 后部分能力消失¶

ANTHROPIC_BASE_URL 不只是 URL。它还参与 first-party host 判定，因此 Remote Control、部分上传、Feature Evaluation 或私有 beta 可能在 endpoint 请求前就被本地 gate 拒绝。

3. 关闭遥测后同版本功能不同¶

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、DISABLE_TELEMETRY 和 DO_NOT_TRACK 位于在线 Feature Evaluation 的外层。关闭流量可能保留 disk last-known-good，也可能让没有缓存的新进程只得到 fallback。

4. 设了并发或 turn 上限后仍有副作用¶

CLAUDE_CODE_MAX_TURNS 控制 Agent Loop iteration，不回滚已经完成的工具。并发上限也只限制调度；远端写入、shell 进程和文件修改仍需各自的 permission、checkpoint 与恢复策略。

842 个 typed 环境变量逐项参考¶

覆盖合同：842/842。每行都显示 name、type、options、heuristic category、accessor、read/write/delete、lexical owner/immediate consumer、fallback、全部位置、sensitivity 和 meaning/evidence。