42 · 环境变量完整参考

常用环境变量的作用、配置位置、优先级与排错方式，覆盖认证、模型、网络、日志和运行行为等关键开关。

Claude Code 的很多行为，靠环境变量来控制。这一篇是一份「环境变量参考」。

「作用」：环境变量能开关很多关键行为——认证方式、用哪个模型、走不走代理、日志级别、运行行为等。

「配置位置」：环境变量可以在系统里设、在 shell 配置里设、或在项目里设。不同位置，作用范围不同。

「优先级」：和 settings 类似，更具体的覆盖更通用的。搞清优先级，才知道「设哪」最有效。

flowchart TB
  A[Claude Code 读取配置] --> B[系统环境变量]
  A --> C[shell 配置文件<br>bashrc zshrc]
  A --> D[本地 .env 文件]
  A --> E[项目 settings]
  B -->|低| F[合并生效]
  C --> F
  D -->|中| F
  E -->|高| F
  style A fill:#5eead4,color:#050a0f
  style B fill:#0f1a24,color:#e6f1f5
  style C fill:#0f1a24,color:#e6f1f5
  style D fill:#0f1a24,color:#e6f1f5
  style E fill:#a78bfa,color:#050a0f

「认证相关」：控制登录方式、API Key 等。

「模型相关」：指定默认模型、切换模型。

「网络相关」：代理设置，国内用户尤其常用。

「日志相关」：日志级别，排查问题时调高日志。

「排错方式」：很多「奇怪的问题」追到底，是某个环境变量设错了。遇到问题时，先想想「是不是哪个环境变量在捣乱」。

使用建议：环境变量别乱设，用到哪个、搞清楚再设。设多了、设错了，反而难排查。

这一篇和第 31 篇（settings）、第 34 篇（CLI 参考）合起来，构成了「配置」的完整拼图。

一个自查清单：当你读完这一篇时，可以问自己三个问题——它解决的是什么具体问题？我当前的工作/学习里有没有这个场景？下一步我该学哪一篇？把这三个问题答清楚，你就知道自己有没有真正吃透。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

与其他篇的关系：这一篇是本组的基础。如果你跳过了前面几篇，建议先回去看，否则这里有些概念可能看着突兀。如果都看过了，那你可以直接进入更后面的实战环节，把这里学到的东西用上。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。