Claude Code 配置调优速查

2026-08-03约 7 分钟驭光者首发于微信公众号「羲和Lab」

特别企划 · 用好 Claude Code，这一篇够查半年阅读时长：约 8 分钟 · 难度：入门到进阶定位：系列配置枢纽——从任何篇过来都能查

开场：这篇是系列的配置枢纽

系列写了十几篇，你装也装了，命令也记了几个——但真到用的时候：模型选哪个？聊着聊着 AI "失忆"了怎么办？settings.json 那堆字段到底配啥？

配置散落各处。CLAUDE.md 在 02 篇讲，Skills 在 04 篇讲，Hooks 在 07 篇讲，国产渠道在第 00 篇讲……查一个配置翻三篇文章，谁有这耐心。

这篇把这些"装好之后"的常用配置一次讲透，按使用阶段组织，不是零散文档，是配置演进路径。

本文是《智能编码进化论》特别企划，承接全系列。无论你从哪篇过来，这篇都能帮你查到想要的配置。

一、模型级别与选择

不同任务该用哪个模型？用贵了心疼，用便宜了又怕不够聪明。

Claude Code 三个档位，对应不同能力和价格：

档位	当前模型	能力	适合场景
Opus	Claude Opus 5	最强推理，但慢且贵	架构设计、复杂重构
Sonnet	Claude Sonnet 5	能力与速度均衡	日常编码主力
Haiku	最新 Haiku	快且便宜	简单任务、批量检索、后台功能

另有 Claude Fable 5，是独立顶级模型，不映射到上述三档，普通用户暂不需要关注。

三个档位怎么选？日常编码用 Sonnet 档就够；遇到复杂重构或架构设计再切 Opus 档；快速补全和检索类任务交给 Haiku。

切换方式：终端里输入 /model 进入交互式选择；也可以直接 /model claude-sonnet-5 精确切换；想固定默认模型，在 settings.json 里设 "model": "sonnet"。

国产渠道的模型映射不同。以智谱 GLM 为例：

模型映射随厂商更新，以下为撰写时（2026 年 8 月）最新值，请以智谱官方文档为准。

三个档位默认映射的都是 GLM-4.7，但你手动配可以映射到最新模型：

Opus / Sonnet → glm-5.2[1m]（1M 上下文窗口）
Haiku → glm-4.7

其中 [1m] 是 1M 上下文窗口的标记。具体配置方式，第三章会给出完整的 settings.json 示例。

二、上下文与自动压缩

你有没有遇到过——AI 聊着聊着突然"失忆"了，前面说的项目架构全忘了？这就是 context 满了。

context 是什么：AI 单次能"看见"的对话历史长度，用 token 计量。标准模型有 200K token 窗口，Sonnet 5 拥有约 1M 窗口。无论哪个模型，窗口满了，AI 就记不住前面说的话了。

自动压缩（auto-compact）是 Claude Code 的续命机制。当上下文用量较高时，系统会自动触发压缩——阈值随版本演进，新版本倾向于更早触发（约占窗口 64-75%，以保护对话质量），旧版约 90-95%。触发时 AI 自己总结前文，保留摘要，清掉细节，腾出空间继续工作。你会看到提示 "compressing conversation..."。

你可以把 auto-compact 想象成写日记——本子快写满了，把前几页的详细记录缩成一句摘要，撕掉原文，只留摘要继续往后写。

智谱官方文档对上下文压缩的原理描述很精准：删掉旧的工具输出，总结历史对话。本质上就是"旧的详细记录丢掉，留着精炼摘要往前走"。

手动管理上下文，有三件套：

/clear——彻底清空当前上下文。换任务之前必用，旧上下文是干扰
/compact——手动压缩，保留摘要继续。长会话续命用的
/context——可视化查看当前 context 占用比例。不确定要不要清，先看一眼

三件套怎么配合？换一个完全不相关的任务，直接 /clear；同一个任务聊太长开始卡，/compact 保留任务脉络；不确定当前状态，先 /context 看占用。

自动压缩可以调。国产渠道尤其常用，因为默认 200K 窗口偏小，压缩频繁影响体验：

需求	配置项	值
撑大窗口，减少压缩频率	`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	`1000000`（智谱官方推荐）
提前触发压缩	`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	百分比，如 `80`
关闭自动压缩	`DISABLE_AUTO_COMPACT=1`（环境变量）/ `"autoCompactEnabled": false`（settings.json）	二选一

CLAUDE_CODE_AUTO_COMPACT_WINDOW 单位是 token 数（设 1000000 就是告诉 Claude Code 窗口有 1M，触发点按此窗口算）；CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 是百分比，只能提前触发、不能推迟。

长会话最佳实践：大任务拆成子代理（系列 06 篇专讲），主会话定期 /compact，别让单会话撑爆窗口。

Sonnet 5 有约 1M 窗口，大部分场景够用。国产渠道默认窗口较小，建议配置 CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000 把窗口撑到 1M，减少压缩频率。

三、settings.json 常用配置

别人 settings.json 里那一堆字段都是干啥的？照抄又怕踩坑。

先搞清楚文件位置——三级覆盖，优先级从高到低：

项目/.claude/settings.local.json——项目级本地（不入库，放凭据等）
项目/.claude/settings.json——项目级（入库，团队共享）
~/.claude/settings.json——全局（所有项目生效）

国产渠道完整配置示例（智谱官方推荐）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000"
  }
}

逐项说明：

ANTHROPIC_AUTH_TOKEN——认证 token，走 Bearer 方式。也可用 ANTHROPIC_API_KEY（走 X-Api-Key），二者择一。智谱官方推荐用 ANTHROPIC_AUTH_TOKEN。

ANTHROPIC_BASE_URL——国产渠道的网关端点。智谱、通义、DeepSeek 各不同，只换这个值：

渠道	BASE_URL
智谱 GLM	`https://open.bigmodel.cn/api/anthropic`
通义千问（百炼）	`https://coding.dashscope.aliyuncs.com/apps/anthropic`
DeepSeek	`https://api.deepseek.com`

ANTHROPIC_DEFAULT_*_MODEL——三档模型别名映射到国产模型。默认都是 GLM-4.7，手动配才能用上最新的 glm-5.2[1m]。

CLAUDE_CODE_AUTO_COMPACT_WINDOW——压缩窗口 token 数。配 1000000 把窗口撑到 100 万，减少压缩频率。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC——关遥测。设 1 即可。

API_TIMEOUT_MS——请求超时毫秒数。国产渠道建议 3000000（3000 秒），避免长任务中断。

其他常用字段：

model：默认模型，可用别名 sonnet / opus / haiku，也可写全名
autoUpdatesChannel：latest 默认即时更新；stable 延后一周更稳
permissions：权限模式，allow / ask / deny 规则（系列 07 篇 Hooks 详讲）
theme：终端主题，dark / light 等
outputStyle：输出风格（第四章详讲）

优先级：项目 settings.local.json > 项目 settings.json > 全局 settings.json > shell 环境变量。

四、其他高频配置

发个消息想让 AI 简洁点，它回你 800 字——对，就是缺了个 output style。

启动参数：

claude --resume（或 -r）：恢复上次会话，接着聊
claude --continue（或 -c）：继续最近一次对话

output style 输出风格：

通过 settings.json 的 outputStyle 字段或 /config 命令设置。可选 concise（简洁）、verbose（详细）等。比如问"解释一下这个函数"——verbose 可能回 800 字带代码注释；concise 可能就一句"接收用户 ID，查数据库，返回订单列表，核心逻辑在 line 45-67"。

注意：没有 /output-style 这个斜杠命令。要改输出风格，用 /config 进入设置，或直接编辑 settings.json。

CLAUDE_CODE_MAX_OUTPUT_TOKENS：限制 AI 单次回复的最大 token 数。设小一点可以让回答更紧凑，适合只想拿关键信息的场景。

CLAUDE_CODE_DISABLE_THINKING：给代理请求省略 thinking 参数。国产模型不兼容 thinking 时用，第 00 篇的坑就是这个。

注意：它只让请求不带 thinking 参数，不关模型默认思考。要真正关闭模型思考，用 MAX_THINKING_TOKENS=0。

statusline 自定义状态栏：在终端底部显示当前模型、工作目录、token 用量等信息，帮你随时掌握会话状态。

五、配置最佳实践：新手到进阶的演进

网上配置大全一上来列 30 项，看着就劝退——其实按阶段加就行。

阶段 1：刚装好（第 00 篇级）

只设两样：国产渠道 BASE_URL + key（或订阅登录），默认 Sonnet 档。这就够了，先跑起来。

阶段 2：用顺了

加上习惯和体验优化：养成 /clear / /compact 的习惯；写一份 CLAUDE.md（02 篇教你怎么写）；配 output style 和 statusline。

阶段 3：团队或进阶

进入权限工程阶段：permissions 权限规则（07 篇）、Hooks 自动化（07 篇）；项目级 settings.json 入库共享，settings.local.json 放凭据不入库；子代理并行（06 篇）。

配置随用法长，别一上来全配，按阶段加。

系列配置索引

一张表，查系列各篇涉及的配置都在哪里：

配置项	在哪篇讲	解决什么
CLAUDE.md	02 篇	AI 的岗位说明书，写一次永久生效
Skills	04 篇	封装常用工作流，一条命令执行
MCP	05 篇	连接外部服务（数据库、API、TAPD）
Subagent	06 篇	并行处理子任务，效率翻倍
Hooks / 权限	07 篇	自动化检查 + 安全护栏
国产渠道	00 篇 · 姿势 C	国内直连 + 成本约为 1/20
后台子代理 / session 上限	特别企划 · 三周进化	并行不阻塞 + 失控有上限
模型 / 压缩 / settings.json	本文	配置总览，系列配置枢纽

配置不是一次到位，是随你的用法一起长出来的。

延伸阅读：配置背后的 Agent 原理

如果你读完这篇还想知道这些配置背后的 Agent 工作原理——为什么会有 context 限制、自动压缩到底做了什么——推荐智谱 GLM Coding Plan 官方学习资源《Coding Agent 工作原理》。

这份文档讲透了：Agent 循环机制（代码理解、Bug 修复、大型重构三个 Case）、上下文压缩的底层原理、扩展组件（Skills / MCP / Hooks / Subagents）的协作方式，以及高效使用的 4 条实践。读完你会更懂本文每项配置在解决什么问题。

本文内容仅供学习交流，所述方法需结合实际场景灵活运用。 AI 工具输出结果仅供参考，关键业务决策请结合人工判断。本文由AI辅助创作，经人工审核编辑后发布。

《智能编码进化论》特别企划 · 比干撰写 · 2026-08

本文首发于微信公众号「羲和Lab」，公众号内可留言交流

阅读公众号原文