企业官网建设流程全解析

1. 这次“焚诀”到底更新了什么

Claude Opus 5.5 这个版本号一出来，我第一反应是：又来了，版本号跳得比我的血压还快。但仔细看完更新日志和实际跑了几轮之后，我发现这次确实有点东西，不是那种“改个数字重新发一遍”的敷衍更新。圈子里管这次更新叫“焚诀”，意思就是烧掉旧套路、逼你重新学一遍的狠招。我个人的感受是，如果你之前已经习惯了 Claude Code 那套工作流，这次更新会让你既兴奋又头疼——兴奋的是能力上限确实拉高了，头疼的是很多旧配置得推倒重来。

先把话说清楚：这篇东西不是官方文档的翻译，也不是那种“一图流”的速览。我会从实际使用者的角度，把这次更新里最值得关注的几个点拆开讲——effort 参数到底怎么影响输出质量、Sub-agent机制为什么会让你的 token 消耗翻倍、CLAUDE.md的写法需要做什么调整、以及 Claude Code 在 VS Code 和 Ubuntu 下的配置有哪些坑。如果你刚开始接触 Claude Code，这篇也能当入门参考，因为我会把基础概念顺带讲清楚。

适合谁看？三类人：一是已经在用 Claude Code 做日常开发的，想搞清楚这次更新值不值得升级；二是刚听说 Claude Code 想入门的，想知道从哪下手；三是用第三方 API 接入其他模型的，想了解 harness 层的变化会不会影响自己的方案。不管你是哪类，我都会尽量说人话，不堆术语。

提示：本文所有操作基于我本机 macOS 和一台 Ubuntu 22.04 测试机实测，VS Code 版本 1.89。不同环境可能有差异，遇到问题先看文末的排查表。

2. 核心机制拆解：effort、Sub-agent 与 CLAUDE.md 的三角关系

2.1 effort 参数：不是越高越好，而是越准越好

这次更新里最容易被误解的就是effort参数。很多人一看名字以为是“努力程度”，直接拉到最高，结果发现响应变慢、token 烧得飞快，输出质量却没提升多少。我一开始也踩了这个坑。

effort 的本质是控制模型在生成回复前的“思考预算”。你可以把它理解成考试时的草稿纸数量——草稿纸给多了，简单题反而浪费时间；给少了，难题又算不清楚。Claude Opus 5.5 把 effort 分成了几个档位，我实测下来的感受是：

关键结论：medium 是甜点区。我拿同一个重构任务分别用 medium 和 max 跑了一遍，max 多花了将近三倍 token，但代码质量差距肉眼可见地小。除非你遇到那种“怎么改都不对”的疑难杂症，否则没必要上 max。

还有一个细节：effort 和 prompt 长度是相互影响的。如果你的 prompt 本身已经写得很详细，effort 可以适当调低；如果 prompt 很简短，effort 调高一点能让模型自己补全上下文。这个平衡点需要你自己试几次才能找到。

2.2 Sub-agent：能力很强，但别滥用

Sub-agent是这次更新里我最喜欢也最警惕的功能。简单说，它允许主 agent 把任务拆给多个子 agent 并行处理。比如你让它重构一个模块，它可以派一个子 agent 去读代码、一个去查文档、一个去写测试，最后汇总。

听起来很美好对吧？但我实测发现两个问题。第一，token 消耗是线性增长的。三个子 agent 并行，token 消耗差不多是单 agent 的三倍。第二，子 agent 之间的上下文同步有延迟。如果任务拆得不好，子 agent 会重复劳动，甚至给出互相矛盾的结论。

我的建议是：只在任务可以真正并行且互不依赖的时候用 Sub-agent。比如“同时给五个文件加注释”这种就适合；“先设计接口再实现”这种有严格顺序的就不适合。另外，子 agent 的数量控制在 2 到 3 个比较稳妥，超过 4 个协调成本就盖过收益了。

2.3 CLAUDE.md：从“说明书”变成“契约”

CLAUDE.md这个文件的作用，相当于你给 Claude Code 的一份项目说明书。以前大家写得比较随意，列一下项目结构、技术栈就完事了。但 Opus 5.5 对这份文件的解读方式变了——它不再只是“参考”，而是当成一种“契约”来执行。

什么意思？如果你在 CLAUDE.md 里写了“所有函数必须写 JSDoc 注释”，它就会严格执行，哪怕你某次对话里说“这次先不写注释”，它也会提醒你违反了约定。这个变化有好有坏：好处是规范性强了，坏处是灵活性降低了。

我现在的写法是分三层：第一层是硬约束（必须遵守的，比如代码风格、目录结构），第二层是软建议（希望尽量做到的，比如注释密度），第三层是上下文（项目背景、业务逻辑）。这样模型能分清哪些是不能碰的红线，哪些是可以商量的。

注意：CLAUDE.md 里的规则不要写太多，超过 20 条之后模型会开始“选择性遗忘”。我试过写 40 多条，结果它只记住了前 15 条左右。精简比全面重要。

3. 实操环境搭建：从零把 Claude Code 跑起来

3.1 安装与版本确认

不管你用 macOS 还是 Ubuntu，安装 Claude Code 的流程大同小异。我先把最干净的安装方式列出来，避免你被网上那些过时的教程带偏。

macOS 下我推荐用官方安装脚本：

curl -fsSL https://claude.ai/install.sh | sh

Ubuntu 下如果脚本执行有问题，可以用 npm 方式：

npm install -g @anthropic-ai/claude-code

装完之后第一件事是确认版本：

claude --version

如果显示的不是 5.5 相关版本，说明你装的是旧版。这时候需要在线升级：

claude update

我遇到过升级卡住的情况，一般是网络问题。可以加--verbose看详细日志。另外提醒一句，Ubuntu 下如果用 snap 装的 node，npm 全局安装可能会权限报错，建议用 nvm 管理 node 版本。

3.2 VS Code 插件配置详解

VS Code 接入 Claude Code有两种方式：一种是装官方插件，一种是在终端里直接用。我两种都用过，插件的好处是能直接在编辑器里看到 diff，坏处是偶尔会和终端版本冲突。

插件安装步骤：

1. 在 VS Code 扩展市场搜索 “Claude Code”
2. 安装后重启 VS Code
3. 打开命令面板（Cmd+Shift+P 或 Ctrl+Shift+P）
4. 输入 “Claude Code: Configure” 进行配置

配置项里最关键的是API endpoint和model。如果你用的是官方服务，endpoint 保持默认就行；如果用第三方 API，需要改成对应的地址。model 这里要填claude-opus-5.5或者对应的模型标识。

我踩过的一个坑：插件配置和终端配置是分开的。你在终端里改了 model，插件里不会自动同步。所以两边都要改一遍，否则会出现“终端里是 5.5，插件里还是旧版”的诡异情况。

3.3 Ubuntu 下的特殊处理

Ubuntu 下装 Claude Code 最大的问题是依赖缺失。我在一台干净的 22.04 上装的时候，报了一堆 node-gyp 相关的错。解决办法是先装编译工具链：

sudo apt update sudo apt install -y build-essential python3 make g++

然后再装 Claude Code。如果还是报错，检查 node 版本，建议用 18 或 20，太新的版本反而有兼容问题。

还有一个 Ubuntu 特有的问题：终端命令执行权限。Claude Code 默认会问你要不要执行某条命令，如果你希望它直接执行，需要在配置里开启autoApprove。但这个开关有风险，建议只对特定命令开启，比如ls、cat这种只读操作。

提示：Ubuntu 下如果遇到 “command not found”，先检查 PATH。npm 全局安装的包一般在~/.npm-global/bin或者/usr/local/bin，确认这个路径在 PATH 里。

4. 第三方 API 接入与模型切换实战

4.1 用 cc switch 接入其他模型

cc switch是我最近用得比较多的一个工具，它能在不同模型之间快速切换。比如你平时用 Claude Opus 5.5，但某些任务想用 DeepSeek V4 或者 Qwen 来跑，cc switch 可以帮你管理这些配置。

安装 cc switch：

npm install -g cc-switch

配置示例（以接入 DeepSeek V4 为例）：

cc-switch add deepseek \ --endpoint https://api.deepseek.com/v1 \ --model deepseek-v4 \ --api-key YOUR_KEY

切换的时候：

cc-switch use deepseek

这里有个关键点：不同模型的 prompt 格式不一样。Claude 系列对 system prompt 的处理方式和其他模型有差异，直接切换可能会导致输出质量下降。我的做法是在 CLAUDE.md 里针对不同模型写不同的指令块，切换时手动调整。

4.2 harness 层能不能不登录用其他模型

这个问题我被问过很多次。答案是：可以，但有条件。Claude Code 的 harness 层本身是支持自定义 endpoint 的，你可以在配置文件里把 endpoint 指向其他兼容 OpenAI 格式的服务。

配置文件一般在~/.claude/config.json，关键字段：

{ "endpoint": "https://your-custom-endpoint/v1", "model": "your-model-name", "apiKey": "your-key" }

但要注意，不是所有模型都兼容 Claude Code 的 tool calling 格式。我试过几个开源模型，有些能跑但工具调用经常出错，有些干脆不识别。建议先用简单的问答测试，确认基础功能正常再上复杂任务。

4.3 注册与不注册的区别

不注册账号能不能用？技术上可以，但功能会受限。不注册的情况下，你只能用本地模型或者自己配的第三方 API，官方的云端能力用不了。另外，不注册的话 Sub-agent 功能会受限，因为并行调度需要服务端支持。

我的建议是：如果你只是轻度使用，不注册也行；如果要正经做项目，还是注册一个账号，省心。

5. 常见问题与排查技巧实录

5.1 安装类问题速查

5.2 使用类问题排查

问题一：响应特别慢。先检查 effort 是不是设太高了。我一开始默认用 high，后来改成 medium，速度提升明显。另外 Sub-agent 数量也会影响速度，超过 3 个就会明显变慢。

问题二：输出质量不稳定。大概率是 CLAUDE.md 写得太模糊。模型不知道你的偏好，只能猜。把关键约束写清楚，比如“用 TypeScript 不用 JavaScript”“缩进用 2 空格不用 4 空格”，质量会稳定很多。

问题三：token 消耗异常高。检查是不是开了 Sub-agent 但任务本身不适合并行。另外，长对话会累积上下文，建议定期开新会话。我一般一个任务一个会话，不混着用。

问题四：第三方 API 调用报错。先确认 endpoint 格式对不对，很多服务需要/v1后缀。再确认 API key 有没有过期。最后看模型名拼写，有些服务对大小写敏感。

5.3 几个我踩过的坑

第一个坑：在 CLAUDE.md 里写了太多“不要”。比如“不要用 any”“不要写 console.log”，结果模型变得畏手畏脚，该用 any 的地方也不敢用。后来我改成正面表述，“优先用具体类型”“用 logger 替代 console.log”，效果好很多。

第二个坑：Sub-agent 的任务边界没划清。有一次我让它同时重构两个模块，结果两个子 agent 都改了同一个工具函数，合并的时候冲突了。后来我学乖了，并行任务之间不能有共享依赖。

第三个坑：升级之后没清缓存。Opus 5.5 升级后，旧的会话缓存可能导致行为异常。建议升级后删掉~/.claude/cache目录，重新开始。

注意：如果你在 Ubuntu 服务器上跑 Claude Code，记得检查防火墙设置。有些端口默认是关的，会导致 API 调用超时。具体端口看你的 endpoint 配置。

6. 一些实战心得与配置建议

6.1 我的日常配置模板

经过几轮调整，我现在稳定用的配置是这样的：

{ "effort": "medium", "maxSubAgents": 2, "autoApprove": ["ls", "cat", "grep"], "model": "claude-opus-5.5", "contextWindow": "auto" }

这个配置在速度和质量之间平衡得比较好。autoApprove 只开了只读命令，写操作还是手动确认，避免误删文件。

6.2 CLAUDE.md 的推荐结构

我现在的 CLAUDE.md 大概长这样：

# 项目约束 - 语言：TypeScript strict mode - 缩进：2 空格 - 注释：公开函数必须有 JSDoc # 项目背景 这是一个电商后台管理系统，主要模块有订单、库存、用户。 # 偏好 - 优先用函数式写法 - 错误处理用 Result 类型，不用 try-catch

控制在 15 条以内，分三个区块。实测下来模型执行得很到位。

6.3 关于模型切换的建议

如果你同时用多个模型，建议给每个模型单独建一个项目目录，配置分开管理。混在一起容易出问题，尤其是 CLAUDE.md 的规则，不同模型的理解方式不一样。

另外，切换模型后第一次对话，建议先跑一个简单任务测试，确认工具调用正常再上正式任务。我吃过亏，切到新模型直接跑重构，结果工具调用格式不对，改了半天代码全白费。

6.4 性能优化的几个小技巧

第一，把大任务拆成小任务。一次让模型改 10 个文件，不如分 5 次每次改 2 个。质量更高，也更容易排查问题。

第二，善用会话隔离。不同任务开不同会话，避免上下文污染。Claude Code 支持--new-session参数，我一般每个功能模块一个会话。

第三，定期清理缓存。~/.claude/cache目录会越来越大，建议每周清一次。清理后第一次响应会慢一点，但之后会恢复正常。

第四，关注 token 用量。Claude Code 有--stats参数可以看当前会话的 token 消耗。如果发现异常增长，及时检查是不是 Sub-agent 开多了。

6.5 关于“焚诀”这个名字

最后说点轻松的。圈子里管这次更新叫“焚诀”，我觉得挺贴切。因为它确实逼着你重新审视自己的工作流——旧的配置要改，旧的习惯要调，旧的经验有些不管用了。但换个角度想，这种“烧掉重来”的过程，也是把工作流打磨得更精细的机会。

我个人的体会是，Opus 5.5 最大的价值不在于它比上一代聪明了多少，而在于它对“约束”的理解更深了。你给它越清晰的边界，它表现得越好。这其实反过来要求我们这些使用者，先把需求想清楚，再把规则写明白。工具越强，对使用者的要求反而越高。

如果你刚开始用，别急着上复杂任务。先拿一个小项目练手，把 effort、Sub-agent、CLAUDE.md 这三个东西摸熟，再逐步扩大使用范围。踩几个坑是正常的，我到现在还在踩，关键是每次踩完知道为什么踩、下次怎么绕过去。