一份面向深度用户的实用指南覆盖官网文档没写清楚的那些配置项。目录[1M]后缀 —— 上下文窗口大小的唯一信号CLAUDE_CODE_EFFORT_LEVEL—— 推理深度控制DISABLE_AUTOUPDATER—— 关闭后台自动更新ENABLE_TOOL_SEARCH—— 按需加载工具CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS—— 多实例协作attribution—— 隐藏 AI 署名1.[1M]后缀 —— 上下文窗口大小的唯一信号配置示例ANTHROPIC_DEFAULT_FABLE_MODEL: DeepSeek-V4-pro[1M]它是什么[1M]是一个纯客户端标记大小写不敏感匹配模式/\[1m\]$/i告诉 Claude Code「这个模型支持 100 万 token 的上下文窗口」。它不会被发送到 API——Claude Code 在发起请求前会自动剥离它上游 Provider 永远看不到这个后缀。有[1M]vs 没有维度加[1M]不加上下文窗口1,000,000 tokens200,000 tokens硬编码默认值自动压缩触发点~987K~187K/context显示1M 刻度200K 刻度API 收到的内容DeepSeek-V4-pro-DSpark后缀已剥离完全一致不加[1M]的后果对话在 ~187K token 时就被压缩而不是 ~987K——长对话能力被阉割了五倍。上下文窗口的解析优先级Claude Code 按以下顺序确定上下文窗口大小模型 ID 中包含[1m]后缀→ 直接返回 1,000,000优先级最高Provider 元数据中的max_input_tokensBeta headercontext-1m-2025-08-07仅限 Anthropic / Bedrock兜底默认值 200,000如果你用的是第三方 Provider如 DeepSeek路径 2 和 3 都不适用[1M]是唯一能获得正确 1M 上下文的方式。注意事项如果使用代理如 CC Switch 的本地路由模式不要加[1M]——代理可能把带后缀的模型名原样转发给上游 API导致上游不认识。直接连接 API 端点如https://api.deepseek.com/anthropic则完全没问题。2.CLAUDE_CODE_EFFORT_LEVEL—— 推理深度控制配置示例CLAUDE_CODE_EFFORT_LEVEL: max它是什么控制模型在给出回答之前的推理深度thinking budget。值越高模型花越多时间「思考」答案越全面但响应越慢、token 消耗越大。可选值级别推理深度适用场景low最少推理修 typo、跑命令等机械任务medium标准推理日常编程high较深推理复杂调试、多文件重构xhigh深度推理有预算上限Opus 4.7 的默认值大多数编程任务的推荐选择max无上限推理仅最难的问题仅 Opus 4.6 原生支持关键限制max不能在settings.json中设置只能通过环境变量或/effort max命令会话级。非 Anthropic 模型大概率不支持max。以 DeepSeek 为例其/anthropic兼容端点对output_config.effort的支持程度未知max很可能是被静默降级为high且没有任何提示。配置优先级环境变量 /effort命令 模型默认值 settings.json实际建议如果你用的是 DeepSeek 或其他第三方模型或许可能都无法处理这个参数3.DISABLE_AUTOUPDATER—— 关闭后台自动更新配置示例DISABLE_AUTOUPDATER: 1它是什么禁止 Claude Code 在后台自动检查、下载、安装新版本。正常更新流程后台定期检查是否有新版本有的话下载到~/.cache/claude/staging/下次启动时自动切换不会中断当前会话开启后后台自动更新被完全禁止但以下操作不受影响claude update—— 手动更新claude install 版本号—— 安装特定版本相关配置对比配置效果DISABLE_AUTOUPDATER1只禁用后台自动更新DISABLE_UPDATES1禁用所有更新路径包括手动claude updateCLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE1允许 Homebrew/WinGet 自动升级CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1伞式开关自动关闭自动更新 反馈上报 遥测 错误报告什么时候该开CI/CD 环境版本固定是刚需使用自定义 API 端点如 DeepSeek不想被自动升级打乱配置网络受限环境偏好手动控制更新节奏4.ENABLE_TOOL_SEARCH—— 按需加载工具配置示例ENABLE_TOOL_SEARCH: true它是什么工具延迟发现机制。正常情况下Claude Code 每轮对话都会把所有 MCP 工具的定义schema、参数、描述一股脑塞进上下文。当 MCP 工具多到几十上百个时光是工具定义就能吃掉上万个 token。开启 Tool Search 后Agent 只拿到一份工具摘要需要用某个工具时通过ToolSearch搜索并按需加载最匹配的 3-5 个。Token 节省效果工具数量不开开了节省10 个~2,000 tokens~600 tokens~70%50 个~10,000 tokens~600 tokens~94%200 个~40,000 tokens~600 tokens~99%配置值含义值行为不设默认开启但在非官方ANTHROPIC_BASE_URL上可能自动回退到全量加载true强制开启无论什么平台auto工具定义超过上下文 10% 时才激活auto:N自定义百分比阈值如auto:5false完全关闭每轮全量加载为什么设为true使用第三方 API如 DeepSeek时系统可能因为检测到非官方 BASE_URL 而退回全量预加载模式。显式设true锁定行为确保上下文不被工具定义白占。什么时候可以考虑关闭工具总数不到 10 个搜索往返反而多一层延迟使用 Haiku 模型不支持 Tool Search极端重视响应速度且工具很少5.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS—— 多实例协作配置示例CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1它是什么实验性的多实例协作功能。一个「队长」会话 spawn 多个独立的 Claude Code 实例「队员」各自拥有独立上下文窗口通过共享任务列表和直连邮箱互相通信。核心能力并行执行多个队员同时处理不同任务共享任务列表队长创建任务 依赖关系空闲队员自动认领直连通信队员之间可以直接发消息不需要经过队长Plan 审批模式队员先提方案队长审核通过后再执行三种显示模式同终端Shift↑↓切换/ tmux 分屏 / iTerm2 分屏仅 macOS与普通 Subagent 的区别普通 SubagentAgent Teams上下文返回结果给主 agent共享上下文预算每个队员独立上下文窗口通信只向主 agent 汇报队员之间可以直接发消息协调主 agent 集中管理共享任务列表队员自助认领工具~25 个~20 个部分被剥离Token 消耗较低3-4 倍于串行执行不建议使用 并且这种方向我个人不太看好6.attribution—— 隐藏 AI 署名配置示例{ attribution: { commit: , pr: } }它是什么Claude Code 在帮你做 git commit 或提 PR 时会自动附带 AI 署名commit 信息末尾加Co-Authored-By: Claude noreplyanthropic.comPR 描述末尾加Generated with [Claude Code]页脚设为空字符串就是「不加署名」。⚠️ 配置经常不生效多个 GitHub issue#11135, #14241, #19463, #45137均报告设了空字符串Claude Code 照样往里塞署名。根因是系统 prompt 里有硬编码指令覆盖了配置值。真正管用的办法Git Hook#!/bin/sh # .git/hooks/commit-msg sed -i /^Co-Authored-By:.*noreplyanthropic.com/d $1 sed -i /^Generated with \[Claude Code\]/d $1commit 写完后自动删除署名行简单粗暴但管用。附录完整配置参考将以上所有配置整合到一个完整的settings.json示例中{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_API_KEY: sk-xxx, ANTHROPIC_DEFAULT_SONNET_MODEL: DeepSeek-V4-pro[1M], ANTHROPIC_DEFAULT_OPUS_MODEL: DeepSeek-V4-pro[1M], ANTHROPIC_DEFAULT_HAIKU_MODEL: DeepSeek-V4-pro[1M], ANTHROPIC_DEFAULT_FABLE_MODEL: DeepSeek-V4-pro[1M], CLAUDE_CODE_EFFORT_LEVEL: xhigh, DISABLE_AUTOUPDATER: 1, ENABLE_TOOL_SEARCH: true, CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1 }, attribution: { commit: , pr: }, includeCoAuthoredBy: false }最后更新2026-07-01本文基于 Claude Code 截至 2026 年中的行为编写。部分配置的行为可能随版本更新而变化尤其是标记为EXPERIMENTAL的功能。