结论先说
- 推荐写进
settings.json的env对象:相比改系统.zshrc或 Windows 环境变量面板,写在~/.claude/settings.json(全局)或.claude/settings.json(项目级)的"env"块里既跨终端持久化,又方便团队对齐。 - 订阅用户切勿残留
ANTHROPIC_API_KEY:本机一旦存在该环境变量,Claude Code 可能优先走 API 按量扣费或覆盖你的 Pro / Max 会员状态;用订阅号前先检查/status。 - 企业内网降噪首选
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:开启后自动打包禁用遥测、错误上报与自动更新检查,适合严格审计网络。 - 关闭开关请直接删键而不是填
"0":部分开关变量按「变量是否存在」判定,不再需要时应从env对象里删掉整行或在 Shell 执行unset。 - 开通与高配额升级入口:调高思考预算与超时上限会提升单轮配额消耗;国内无外币卡用户可在 Claude Code 订阅专页 或免密兑换的 Claude Pro iOS 卡密 开通,高频跑大项目建议选 5 倍额度的 Claude Max 升级服务。

图:本站根据 Claude Code 官方文档:Claude Code settings 整理的示意图
本文根据 Claude Code 官方文档《Claude Code settings》与《Model configuration》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 跑耗时构建或慢速 MCP 工具总是触发默认 2 分钟超时中断,想放宽阈值的开发者;
- 在企业内网环境需要一次性关掉自动更新、遥测上报与错误回传的运维管理员;
- 想把环境变量固化进
settings.json随项目生效,避免每次重开终端重新export的人。
一、四类高频环境变量速查总表
官方文档列出了数十个运行期变量,日常开发最常改的集中在以下四组(注:settings.json 的 "env" 对象里所有值都必须写成字符串):
| 变量名 | 所属分类 | 常用取值与作用说明 |
|---|---|---|
CLAUDE_CONFIG_DIR | 目录与账号 | 改写默认 ~/.claude 配置与历史目录,常用于迁往 D 盘或双号隔离 |
ANTHROPIC_MODEL | 模型与思考 | 固定会话默认主模型(如设为 sonnet 或 opus) |
CLAUDE_CODE_SUBAGENT_MODEL | 模型与思考 | 单独指定后台子代理调用的模型,降低并行检索开销 |
MAX_THINKING_TOKENS | 模型与思考 | 限制单轮扩展思考预算上限,设为 "0" 可关闭扩展思考 |
BASH_DEFAULT_TIMEOUT_MS | 超时与输出 | 修改默认前台命令超时毫秒数(默认约 120000 即 2 分钟) |
BASH_MAX_TIMEOUT_MS | 超时与输出 | 限制模型单次允许申请的最大 Bash 超时上限 |
MCP_TOOL_TIMEOUT | 超时与输出 | 放宽慢速外部 MCP 工具(如大表查询)的返回等待毫秒数 |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 隐私与流量 | 设为 "1" 一键关闭自动更新、遥测上报与崩溃反馈等非核心流量 |
若需要把软件与缓存目录整体挪出系统盘,可结合 Claude Code 迁移 D 盘与系统要求指南;若接入云厂商托管模型还涉及平台专属变量,详见 Claude Code 接入 Bedrock 与 Vertex 说明。
二、写进 settings.json 的标准配置模板
把个人常用调优项一次性写入 ~/.claude/settings.json,所有终端启动时都会自动注入:
json
{
"env": {
"BASH_DEFAULT_TIMEOUT_MS": "300000",
"MCP_TOOL_TIMEOUT": "180000",
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
配置优先级规则很清晰:命令行临时传入的变量(如 ANTHROPIC_MODEL=opus claude)高于本地与项目级 settings.json,后者又高于用户全局 ~/.claude/settings.json。配置文件完整语法见 Claude Code settings.json 配置详解。
环境变量与订阅扣费避坑提示:不少开发者早年测试 SDK 时在系统环境变量里配过ANTHROPIC_API_KEY,后来买了 Pro 会员却发现终端报错余额不足或没走会员额度。排查与切换登录态见 Claude Code 登录退出与切换账号;若需续订会员或升级大配额,可通过 Claude Pro 自助充值 或 Claude Max 会员升级 办理。
三、常见配置踩坑与排错判断

图:本站根据 Claude Code 官方文档:Claude Code settings 整理的示意图
- 填了数字类型导致解析报错:JSON 里的
"env"要求键值均为字符串,写"BASH_DEFAULT_TIMEOUT_MS": 300000(不加引号)会导致配置校验告警,务必加上双引号写成"300000"; - 改完系统变量没重启终端:在 macOS
.zshrc或 Windows 系统属性里改完变量后,已打开的旧终端和新拉起的 IDE 子终端不会热更新,必须彻底重开窗口; - 禁用了自动更新后记得定期手升:开启
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC会连带关掉后台自动更新,后续想升新功能需手动执行claude update。
常见问题
问:把 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 改成 "0" 为什么还是没恢复自动更新?
答:官方说明部分流量开关按变量是否存在判定,只要变量非空即视为开启限制。想恢复默认行为,请直接把这行从 settings.json 删除并在终端 unset 该变量。
问:项目 .claude/settings.json 里的 env 能放数据库密码或 API 密钥吗?
答:严禁在纳入 Git 版本控制的项目 settings.json 里放任何密钥。个人本机私密变量应放在被 .gitignore 忽略的 .claude/settings.local.json 中。
问:怎么确认当前会话到底吃到了哪套环境变量?
答:可在交互模式输 /status 核对当前认证模式、配置路径与模型状态,或运行 claude doctor 检查配置告警。
问:国内没有外币信用卡,怎么开通订阅并申请企业报销发票?
答:可通过本站 Claude Code 订阅专页 或 AI 会员充值总览 选购,支持支付宝、微信支付与 AlipayHK,提供免交密码的卡密自助兑换,企业采购可开具国内增值税发票。实时价格与售后细则以页面为准:订阅期内非违规掉订阅按剩余天数折退,风控封号不在质保范围。
相关教程
- Claude Code settings.json 配置文件详解
- Claude Code 提示未登录、怎么切换账号与 CLAUDE_CONFIG_DIR
- Claude Code 能不能装到 D 盘与配置迁移方法
- Claude Code 可以使用其他模型吗:Bedrock 与 Vertex 配置
参考资料
- Claude Code 官方文档:Claude Code settings — https://code.claude.com/docs/en/settings
- Claude Code 官方文档:Model configuration — https://code.claude.com/docs/en/model-config
0 条评论
还没有评论,来抢沙发~