把模型参数塞进环境变量,听起来是个“偷懒”做法,但实际用起来要分清楚哪些参数适合这样传。Claude Code 的环境变量体系里,模型标识和连接凭据通常是最常见的配置项,至于温度和 top_p 这类采样参数,一般不会通过环境变量来调。先给出大方向:环境变量适合做“统一入口”,不适合做“频繁调试台”。
在 Claude Code 中,适合用环境变量管理的通常是模型标识与连接凭据,例如 ANTHROPIC_MODEL 指定主模型,ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY 提供身份验证。而温度、top_p 这类采样参数并不常见于环境变量配置,Claude Code 更倾向于通过配置文件 .claude/settings.json 里的 model 段落或交互式指令来控制。如果项目要求所有成员使用同一模型,环境变量能提供统一入口;如果只是个人调试不同参数,建议优先修改配置文件,避免污染全局 Shell 环境。
设置单个模型:ANTHROPIC_MODEL
单模型场景下,最直接的做法是设置 ANTHROPIC_MODEL。
以 Bash 为例,在终端运行 export ANTHROPIC_MODEL=claude-sonnet-4 即可让当前会话中的 Claude Code 使用该模型。若希望长期生效,可将这行写入 ~/.bashrc 或 ~/.zshrc。注意等号两边不能有空格,模型名必须与官方 API 接受的标识完全一致,大小写敏感。设置后启动 claude 命令,它会自动读取该环境变量;你也可以在同一 Shell 中运行 claude --model 参数来确认命令行默认值。
这里有一个容易忽略的点:如果你所在的项目根目录有 .env 文件,Claude Code 会优先读取项目级 .env 里的同名变量,Shell 里 export 的值反而可能被覆盖。所以设置完记得先确认当前终端是否加载了项目 .env。另外,ANTHROPIC_MODEL 只是指定默认模型,并不阻止你在交互式会话中用 /model 切换。
多个参数合并:ANTHROPIC_DEFAULT_OPTS
需要同时控制模型和最大轮数等选项时,环境变量 ANTHROPIC_DEFAULT_OPTS 提供了一种合并方式。它的值是 JSON 字符串,例如:
export ANTHROPIC_DEFAULT_OPTS='{"model": "claude-sonnet-4", "max_turns": 8}'注意这里必须用单引号包裹,否则 Shell 会展开花括号或双引号,导致 JSON 结构被破坏。这个变量会合并进 Claude Code 的默认选项,但 JSON 里不能有注释或尾逗号。环境变量是进程级的,会影响你所有 claude 项目,所以要么在项目目录的 .env 文件中定义,配合不同项目使用不同配置;要么用完后立刻 unset,避免影响下一个终端会话。
检查与确认
设置完不要急着开对话,先确认环境变量真的被读取了。简单做法是运行 echo $ANTHROPIC_MODEL 看输出;如果要看所有相关变量,用 env | grep ANTHROPIC。更可靠的验证方式是启动 claude 后输入 /models 或 /status,观察界面显示的实际模型名。如果环境变量拼写正确但没生效,优先检查项目根目录的 .env 文件,因为项目级 .env 中的同名变量会覆盖 Shell 里 export 的值。另外,注意检查是否在 .bashrc 和当前 Shell 里重复赋值,后一次 export 会覆盖前一次。
优先级和常见坑
环境变量的优先级通常高于用户级配置文件,但低于命令行参数。例如,如果在 .claude/settings.json 中写了 model: "claude-opus-4",同时设置了 ANTHROPIC_MODEL="claude-sonnet-4",实际生效的是环境变量指定的模型。仍然,当你在执行 claude 时显式传入 --model claude-haiku-4,它会覆盖环境变量。因此,团队协作时若使用环境变量统一模型,要避免个人在命令行中临时指定,否则可能导致结果不一致。
另一个常见坑是模型名写错。比如把 claude-sonnet-4 写成 claude-sonner-4,Claude Code 启动时可能直接报模型不可用,或悄悄回退到默认模型。遇到这种情况,先检查环境变量值是不是官方 API 接受的标识,再检查是不是有特殊字符被 Shell 转义了。如果有工具脚本在动态拼模型名,记得用引号包住变量,避免空格或分号被解释成新命令。
最后回到判断逻辑:如果你的团队在 CI 或共享服务器上需要固定模型,环境变量是低成本方案;如果你是个人在本地反复试不同参数,配置文件更干净。先确定你的使用场景,再决定要不要动全局环境。