結論先說
- 推薦寫進
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 條評論
還沒有評論,來搶沙發~