别把 Claude Code 用成高级补全,从装好到 Agent 体系的四阶段清单

别把 Claude Code 用成高级补全,从装好到 Agent 体系的四阶段清单

先说一个数字。Anthropic 的工程博客公开过 Claude Code 的权限弹窗批准率,93%。一个本意是保护你的机制,弹得多了,人就开始无脑点同意,防线被用户自己点穿了。

我把这个数字放在开头,是想说明一件事。Claude Code 这东西,装好只要十分钟,用明白要三个月。绝大多数人卡住的地方不是安装,也不是命令记不住,是停在「一个更强的自动补全」这个层面,再也没往前走。

这半年我们自己的团队每天用 Claude Code 超过八个小时,拿它管着三千多个文件的知识库,从安装报错、成本失控到多 Agent 编排,坑基本踩了个遍。这篇按交付的顺序把这些经验重排成一张清单,你可以对着它找自己卡在哪一关。

先算账,再安装

安装本身没有悬念,官方推荐原生安装器,一行命令,支持后台自动更新。

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

Windows 用 irm https://claude.ai/install.ps1 | iex。曾经的 npm 安装方式已被官方弃用,权限问题高发,老用户建议卸了重装。装完在终端敲 claude,浏览器完成登录就能开工。

高频报错就那么几个。command not found 是 ~/.local/bin 没进 PATH,加一行 export 再重启终端。EACCES 权限报错是 npm 全局目录的锅,换原生安装器就好。国内环境记得给终端单独挂代理,export https_proxy 指向本地代理端口,登录 403 就换非大陆节点,用 curl ipinfo.io 确认出口 IP。

真正的第一道坎是选套餐。Pro 每月 20 美元,额度大概够两小时中等强度使用。Max 5x 每月 100 美元,日常重度刚好,是社区公认的性价比甜点。Max 20x 每月 200 美元,留给全天挂 Agent 的玩家。API 按量付费无上限,适合自动化和 CI 这类机器流量。

为什么说 5x 是甜点,社区多方分析过,Anthropic 对 Max 订阅存在补贴,100 美元的月费可能对应 200 到 800 美元的算力成本。今天补你,等你留下。至于典型 Agent 循环里订阅比 API 便宜最多 36 倍的测算,来自 Reddit 社区,方向上我认。

老雷提醒一句,企业里推行之前最该拿来敲警钟的反例是 Uber。2025 年 12 月给 5000 名工程师开通 Claude Code,采用率从 32% 冲到 84%,结果四个月烧光了全年 AI 预算。他们的 CTO 原话,token 定价打破了传统订阅制的财务假设,用得多付得多,没有无限量。预算这道关不过,后面全白搭。

还有一件事值得说,命令不用背。Towards AI 统计过,大多数开发者只常用 5 个命令,而掌握 15 个以上的开发者效率能高三到四倍。差距不在数量在几个关键动作,/compact 管上下文,/resume 接续昨天的会话,/fork 派生后台子 Agent 去并行探路,/agents 管子 Agent 配置,/context 看上下文水位,/usage 看本次会话烧了多少,/doctor 排障首选。把这几个练熟,剩下的用到再查。

木刻风格终端窗口前用天平权衡硬币与账册,表达选套餐先算预算

CLAUDE.md 是按轮计费的税

很多人把 CLAUDE.md 当项目说明书写,塞几千字的公司介绍。这是在往每一轮对话里塞钱。

CLAUDE.md 按四级加载,全局的 ~/.claude/CLAUDE.md 所有项目共享,项目根目录的管当前项目,子目录的进目录才加载,CLAUDE.local.md 不进 Git。知道层级没用,关键在内容怎么设计。

一个很多人不知道的细节。2026 年 3 月的源码泄露分析里提到,系统提示词里有一条缓存分界线,分界线之前的指令和工具定义在所有用户之间全局缓存,分界线之后的 CLAUDE.md、git status 是会话专属内容。也就是说你的 CLAUDE.md 每一轮对话都要重新计费,它就是一笔 token 税。

所以老雷给的原则只有一条,极度精简。有开发者实测把 CLAUDE.md 砍到 500 token 以内,每天省下约 3 美元。写法上别写长篇描述,写触发词到路径的路由表,Agent 命中直达。每一行都自问一句,删掉会导致 Agent 犯错吗,不会就删。规范写短句,比如「函数只做一件事」,别写成「请尽量让函数职责单一以提高可维护性」这种正确的废话。频繁变动的信息下沉到目录级,稳定规范放项目级,每周修剪一次。

木刻风格把 CLAUDE.md 画成税关,每轮对话被切下一枚硬币

省钱五个动作,实测砍六成

成本这块我们踩出来的经验就五条,都是今天就能执行的动作。

  1. CLAUDE.md 瘦身,上面说过了,这是基线
  2. 模型分级,八成日常编码用 Sonnet,批量打标、分类、结构化这种活交给更便宜的模型,顶尖推理再上 Opus,这套组合比全用 Opus 省约 70%
  3. 用 /compact 别用 /clear。Anthropic 的缓存命中价格只有标准价的 10%,/compact 压缩上下文但保留缓存前缀,/clear 连缓存一起清空。有开发者实测从 /clear 切到 /compact,缓存命中率从 12% 拉到 61%。上下文用到六成就执行一次
  4. 大任务拆短会话,一个功能拆成规划、实现、测试三段,每段上下文保持精简
  5. 高频操作封装成 Skill 而不是写进 CLAUDE.md,Skill 只在被调用时才进上下文

顺带提醒 Dynamic Workflows。Ultracode 模式下 Claude 自己拆任务派 Agent,一个复杂任务可能烧掉半个 200 美元计划的额度。日常用手动 Subagent 加 Skills 编排,探索性的、不知道怎么拆的任务再交给它。

分工别搞混,深水区提前防

Cursor、Codex、Claude Code 的分工,2026 年的主流共识已经很清楚,大多数专业开发者同时用两个工具。改一行 CSS、看一段逻辑、内联 diff,用 Cursor,开发者八成时间在 IDE 里,这类活派 Agent 太重。丢一百个任务过夜跑、批量迁移,用 Codex,云端沙箱加异步队列天然适合。要搭 Agent 工作流体系,Claude Code 没有对手,CLAUDE.md 分层配置、Skills 复用模块、Hooks 确定性自动化、MCP 外部集成、Subagent 并行,这套组合拳是它独有的。预算参考,日常够用是 Max 5x 加 Cursor Pro 每月 120 美元,全火力是 Max 20x 加 Codex API 加 Cursor Pro,320 到 420 美元每月。

真正的坑都在高强度使用之后才浮出来。

Hook 脚本执行失败时 Claude Code 静默跳过,不报错继续跑。你的格式化 Hook、安全检查 Hook 可能早就失效了,而你毫不知情。每个 Hook 必须带 exit code 检查和失败通知。

多个 MCP Server 并发时连接超时和资源竞争高发,我们的经验是调用之间保持至少 2 秒间隔,本地工具优先,超时自动降级。上下文溢出靠分层 CLAUDE.md、激进压缩加 Subagent 分流。磁盘被缓存吃满、macOS 升级后 TCC 权限漂移、多窗口文件锁冲突,发生率不低但都有解,遇到再查。

安全这条要单独说。真实发生的事故已经有一串,有 Agent 误解指令删了远程 git 分支,有 Agent 把工程师的 GitHub 认证 token 传到了内部计算集群,还有 Agent 尝试对生产数据库执行迁移。更吓人的是 Anthropic 内部红队实验,研究人员钓鱼一名员工运行恶意提示词,Claude 在 25 次重试里 24 次成功拿到了 ~/.aws/credentials。再叠上前面的 93% 批准率,Auto Mode 官方数据里危险操作漏报率 17%,每六个危险操作漏过一个,你会明白手动审批靠不住,机器防线也靠不住。所以生产环境别裸奔,PreToolUse Hook 拦 rm -rf,保护 .env,git push 加人工确认,权限规则写进 settings.json 而不是靠每次手点。这几行配置值得你今天就写上。

木刻风格三个工位各司其职,地面暗处标出深水区警示

四个阶段,九成的人停在第二关

阶段一,安装上手,一天。里程碑是跑通第一个编码任务,理解 default、acceptEdits、plan、auto 四种权限模式。卡点基本是网络和 Node 版本。

阶段二,日常编码,一周。用 /init 生成第一份 CLAUDE.md 然后狠心精简,掌握写代码、修 Bug、测试、Git 这几个核心工作流,养成大任务拆小会话的习惯。达标标志是效率提升三成以上。

阶段三,体系化,一个月。设计多级 CLAUDE.md,建第一批 Skills,配 Hooks,接 MCP Server。达标标志是 Claude Code 能按你的规范干活,不用每次重复解释。

阶段四,Agent 编排,持续进化。Subagent 并行加 Git Worktree 隔离加 tmux 管理,Plugin 打包分发。到这一步,你的角色从执行者变成架构师。

社区观察是 95% 的用户停在阶段二,把 Claude Code 当更强的 Copilot 用。突破点其实在认知,Claude Code 的价值不在替你写一个工具,在构建一个让 Agent 越来越快写工具的系统。规范、Skill、架构,每一层沉淀都是未来效率的杠杆。

我们自己走过一遍这条曲线。最早的 CLI 工具全手动,一个工具两到四小时。后来把规范沉淀进 CLAUDE.md,一到两小时。再后来做了脚手架 Skill,半小时到一小时。最后统一入口架构,新功能只是加个子命令,十五到三十分钟。四阶段下来,效率十倍不止。

Shopify 的实践是同一个方向的验证。近 20 年历史的主应用、约 5000 个仓库、每年约 50 万个 PR,Claude Code 日活 500 人。他们的 ROAST 框架有个词叫熵累积,Agent 自主执行多步工作流时错误会一步步复合,早期的小偏差让后续全部跑偏,解法是确定性步骤和 Agent 步骤交替执行。跟我们的路径殊途同归,规范和架构提供确定性骨架,Agent 在骨架里发挥。

工具的红利期只有一段,体系的优势才一直在。

这份清单没法替你走完四个阶段,但能让你在每一关少踩两个坑。老雷的建议是从今天的第一步开始,装好,建一份 500 token 以内的 CLAUDE.md,把 /compact 练成肌肉记忆。三周后你再回头看这篇,大概率已经在第三关了。