企业官网建设流程全解析

1. 这次“焚诀”到底更新了什么：从标题到真实能力边界

先把话说在前头，标题里那个“焚诀”是圈内人的戏称，指的是模型在长链路推理、代码生成和工具调用上的一次集中能力释放。我拿到 Claude Opus 5.5 的第一时间没有急着跑分，而是把它丢进我手头三个真实项目里：一个中型 Node 服务的重构、一个数据清洗脚本的批量生成、还有一个多步骤的自动化工作流编排。跑完之后我的判断是，这次提升最明显的不是单点问答质量，而是在 Claude Code 这类代理式工作流里的稳定性和“少废话”程度。

很多人对 Claude Opus 系列的印象还停留在“写代码挺强但话多”，5.5 这一版在指令遵循上明显收紧了。我让它改一个函数，它不再顺手把整个文件重写一遍，而是精准定位到那几行。这个变化看起来小，但在 Claude Code 这种会真实读写文件的场景里，直接决定了你敢不敢让它碰你的生产代码。它解决的核心问题就是：从“能聊”变成“能干活且不添乱”。

这篇文章适合谁看？如果你已经在用 Claude Code，或者正准备从零上手，想搞清楚 Opus 5.5 配合 Sub-agent、CLAUDE.md、effort 这些机制到底怎么用才不踩坑，那这篇就是写给你的。如果你只是想找个聊天机器人，那可能用不上这么多细节。我会把安装、配置、模型接入、常见报错排查全部走一遍，都是我实际踩过的路径，不是照抄文档。

需要提前说明的是，下面涉及的具体参数和配置，一部分来自官方文档，一部分是我基于常见实践补全的合理方案，我会在关键处标注清楚哪些是实测、哪些是推断。这样你复现的时候心里有数。

2. 核心机制拆解：Sub-agent、CLAUDE.md 与 effort 到底怎么配合

2.1 Sub-agent：把大任务拆成能并行的小角色

Sub-agent 是这次最值得聊的机制。传统用法里，你给一个代理下指令，它从头干到尾，中间任何一步跑偏，后面全歪。Sub-agent 的思路是主代理负责调度，子代理负责执行，每个子代理有独立的上下文和职责边界。

我举个实际例子。我有个任务是“扫描项目里所有 API 路由，找出没有做参数校验的接口，并生成修复补丁”。如果让单个代理干，它得先遍历文件、再分析、再改代码，上下文很快就爆了。用 Sub-agent 我是这么拆的：

• 子代理 A：只负责扫描路由文件，输出一份“文件路径 + 行号 + 疑似问题”的清单
• 子代理 B：接收清单，逐个分析参数校验逻辑，输出修复建议
• 主代理：汇总建议，决定哪些直接改、哪些需要我确认

这么拆的好处是每个子代理的上下文都很干净，不会互相污染。实测下来，任务成功率比单代理模式高出一大截，尤其是文件数量超过 20 个的时候。

注意：Sub-agent 不是越多越好。我试过拆成 6 个子代理，结果主代理的调度开销反而拖慢了整体速度。经验值是 2 到 4 个比较合适，超过 5 个就要重新想想任务拆分是否合理。

2.2 CLAUDE.md：给代理立规矩的那份文件

CLAUDE.md 是放在项目根目录的配置文件，代理每次启动会先读它。很多人忽略这个文件，结果代理每次都按自己的理解来，风格飘忽不定。我的做法是把 CLAUDE.md 当成“团队新人入职手册”来写。

一份好用的 CLAUDE.md 至少包含这几块：

• 项目结构说明：哪些目录是源码、哪些是生成物、哪些不要动
• 代码规范：缩进、命名、注释语言、是否允许引入新依赖
• 禁区清单：比如“不要修改 migrations 目录”“不要动 .env 文件”
• 常用命令：构建、测试、lint 的命令，让代理知道怎么自检

我实测过一个对比：同一个重构任务，没有 CLAUDE.md 时代理改了 7 个文件，其中 2 个是它不该碰的配置；写了 CLAUDE.md 之后，它只改了 3 个目标文件，一次到位。这个差距在真实项目里就是“敢不敢用”的区别。

2.3 effort：控制代理“想多深”的旋钮

effort 这个参数控制的是代理在推理上投入的算力。低 effort 适合简单任务，响应快；高 effort 适合复杂推理，但慢且贵。我的经验是不要全局设一个值，而是按任务类型动态调。

我踩过的坑是：一开始图省事全设成高 effort，结果一个简单的格式化任务等了快一分钟。后来改成按任务调，整体效率提升明显。这个旋钮的价值在于让你为真正需要思考的任务付费，而不是为所有任务买单。

3. 从零上手 Claude Code：安装、配置与模型接入

3.1 安装前的环境准备

Claude Code 本质是个命令行工具，跑在 Node 环境里。所以第一步是确认你的 Node 版本。我实测下来 Node 18 以上比较稳，16 会有一些依赖报错。检查命令：

node -v npm -v

如果版本太低，建议用 nvm 管理多版本，别直接升级系统 Node，容易把其他项目搞崩。Windows 用户我强烈建议走 WSL，原生 Windows 下路径和权限问题会让你怀疑人生。WSL 里装个 Ubuntu，后面所有操作都在里面做，省心。

提示：安装前先确认 npm 的全局目录有写权限。我见过最常见的报错就是no write permission to npm prefix，这个后面会专门讲怎么修。

3.2 安装与首次启动

安装本身一条命令：

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

装完之后在项目目录里执行claude就能启动。首次启动会让你登录，按提示走就行。这里有个细节：登录凭证是存在本地的，换项目目录不用重新登录，但换机器要重新来一遍。

启动后你会看到一个交互界面，可以直接对话，也可以用斜杠命令。我建议第一件事是执行/init，它会帮你生成一份初始的 CLAUDE.md，然后你再根据项目实际情况改。这比从空白文件开始写快得多。

3.3 接入其他模型的思路

热词里有人问“能不能不登录用其他模型”，这个问题的本质是 Claude Code 的模型层是否可替换。我的理解是，Claude Code 作为一个代理框架，它的核心价值在于工具调用和文件操作那套 harness，模型层理论上是可以对接兼容接口的。实际操作上，你需要一个兼容的 API 端点，然后在配置里指向它。

我试过把模型指向一个本地部署的兼容服务，流程是：先确认那个服务暴露的是兼容格式的接口，再在 Claude Code 的配置里改 base URL 和模型名。跑通之后，文件读写、命令执行这些 harness 能力都还在，只是推理换了个后端。但要注意，不同模型对工具调用的支持程度不一样，有些模型在 Sub-agent 调度上会明显吃力，这个得自己测。

注意：接入第三方模型时，务必确认数据流向，不要把敏感项目代码发到你不可控的端点。这是底线。

3.4 VSCode 里的配置

如果你习惯在 VSCode 里干活，可以装对应的扩展，把 Claude Code 集成到编辑器里。配置的关键是让扩展能找到你的 CLI 路径。我遇到过一次扩展启动失败，排查发现是 PATH 里没有全局 npm 目录，加上就好了。

集成之后的好处是，代理改的文件会直接在编辑器里高亮出来，你能一眼看到它动了哪里，确认无误再保存。这个“人在回路”的确认步骤，在改生产代码时特别重要。

4. 实操全流程：一个真实重构任务的完整记录

4.1 任务设定与 CLAUDE.md 准备

我拿一个真实的小项目来演示：一个 Express 服务，有 12 个路由文件，其中几个接口缺少输入校验。目标是让代理找出问题并生成修复。

第一步，写 CLAUDE.md。我重点写了两条：一是“只修改 routes 目录下的文件”，二是“修复时必须保留原有错误处理逻辑”。这两条直接决定了代理的行为边界。

第二步，确认 effort 设为高，因为跨文件分析需要推理。

第三步，启动代理，用自然语言描述任务，而不是写死步骤。我写的是：“扫描 routes 目录，找出所有没有对请求体做校验的 POST 接口，为每个接口生成校验逻辑，风格参考已有的 validateUser 函数。”

4.2 代理执行过程与关键节点

代理启动后，先读了 CLAUDE.md，然后开始扫描。它没有一次性读所有文件，而是先列了个文件清单，然后逐个分析。这个行为我很满意，因为一次性读 12 个文件会撑爆上下文。

分析到第 5 个文件时，它停下来问我：“这个接口的校验规则不明确，是必填还是可选？”这就是 Sub-agent 机制在起作用——它把不确定的点抛回给我，而不是自己瞎猜。我回复之后它继续。

整个过程中它改了 4 个文件，每个改动都很小，就是加了几行校验。我逐个 review，没有发现误伤。这里的关键是代理的改动粒度足够小，review 成本才低。如果它一次改 200 行，我根本没法快速确认。

4.3 参数选择背后的计算逻辑

有人可能好奇 effort 高到底高在哪。我的理解是，高 effort 会让模型在生成每个动作前做更多的“内部推演”，比如它会先想“这个文件可能有哪些校验模式”“我改这里会不会影响调用方”。这些推演不体现在输出里，但体现在动作的准确性上。

从成本角度看，高 effort 的 token 消耗大概是低 effort 的 3 到 5 倍。所以我的策略是：探索阶段用高 effort 摸清项目结构，执行阶段用中 effort 批量处理。这样既保证了理解准确，又控制了成本。

5. 常见报错与排查技巧实录

5.1 权限类报错

auto-update failed: no write permission to npm prefix这个报错我遇到不止一次。根因是 npm 全局目录归 root 所有，普通用户没写权限。解决办法有两个：一是改 npm 的全局目录到一个你有权限的路径，二是用 sudo 装（不推荐，会引入更多权限问题）。

我推荐第一种：

npm config set prefix ~/.npm-global export PATH=~/.npm-global/bin:$PATH

把这两行加到你的 shell 配置里，一劳永逸。

5.2 启动与登录类问题

有人反馈“找不到 start in cowork”之类的入口，这通常是版本不一致导致的。CLI 和扩展的版本要匹配，升级的时候两个一起升。在线升级用：

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

升级完重启终端再试。如果还是不行，检查一下是不是有多个版本共存，which claude看看指向哪个。

5.3 模型接入类问题

接入第三方模型时最常见的报错是“工具调用格式不兼容”。表现是代理能对话，但一让它改文件就失败。这时候要检查你的模型端点是否支持 function calling 那套协议。不支持的话，Sub-agent 和文件操作基本用不了，只能当聊天用。

5.4 问题速查表

6. 我踩过的坑和几条实在建议

第一个坑是过度信任代理的自我判断。早期我让它自己决定改哪些文件，结果它把一个测试文件也改了，理由是“顺手优化”。后来我在 CLAUDE.md 里明确写了“不要修改 test 目录”，问题就没了。代理很聪明，但它不知道你的边界在哪，你得告诉它。

第二个坑是上下文管理。长任务跑到后面，代理会“忘记”前面的约定。我的做法是把关键约束写进 CLAUDE.md，而不是只在对话里说一遍。文件是持久的，对话是易失的。

第三个坑是effort 和成本的平衡。我有个月跑了一堆高 effort 任务，账单出来吓了一跳。后来我养成了习惯：先想清楚这个任务值不值得高 effort，不值得就用中低档。

最后分享一个我常用的小技巧：让代理先输出计划再执行。我在指令里加一句“先列出你打算改哪些文件、每个文件改什么，等我确认后再动手”。这一步能拦下大部分误操作，而且计划本身也是很好的 review 材料。等你和代理配合久了，信任建立起来，再逐步放开这个确认步骤。

这套东西说到底就是个工具，用顺手了确实能省不少重复劳动，但它替代不了你对项目的理解。代理帮你干活，判断还得你自己来。