装完 Claude Code 的第一天：把一个真实项目跑通的七步

装完之后大部分人干的第一件事，是打开一个空目录让它写个贪吃蛇。跑出来了，很开心，然后第二天就不知道该干嘛了。

命令行编程工具真正的价值不在「能写代码」，在「能在你已有的那个乱摊子里干活」。下面这七步是按「在一个已有仓库里干一件真活」排的顺序——每一步都给了验收动作，做完看不到那个结果就别往下走，往下走只会把问题带到更深的地方。

一、先确认版本和模型，别拿一个半年前的壳子试新功能

Claude Code 的迭代频率高到一周能出五六个版本。写这篇时最新版是 2.1.281，2026 年 9 月 23 日发的。装完先跑：

两个跟第一天直接相关的变化，版本不够就享受不到：

• →2.1.280（9 月 22 日） 把 Opus 5.5 设成了默认的 Opus 模型，100 万上下文，API 挂牌价每百万 token 输入 4 美元、输出 20 美元，缓存读取 0.20 美元。
• →2.1.277（9 月 18 日） 新增了一条：项目里没有 CLAUDE.md 时，它会读 AGENTS.md。这一条对已经在用别家工具的人很实用——两边的项目说明可以合成一份。

验收：claude --version 的数字大于等于 2.1.277。小于这个数，先升级再往下。

二、挑一个「你看得懂、但改起来烦」的真实任务

第一天别挑两种活：一种是全新项目从零开始（没有上下文，模型只能猜，你也没有判断基准），另一种是核心链路的重构（改错了你赔不起）。

挑这种：你知道该改哪儿、也知道改完什么样算对，只是手工改一遍要一两个小时。比如把某个页面里散落的十几处硬编码文案抽成常量、给一个没有校验的接口补上入参校验、把一份 CSV 导入脚本从同步改成分批。

这类任务的好处是：你有验收标准。第一天最重要的不是让它干成一件事，是你建立起「它说完成了，我怎么确认」的那套动作。

三、在仓库根目录跑，第一句话先问它「你看到了什么」

第一句别下任务，先问一句结构性的问题：

最后半句是关键。让它说出依据的文件路径，你一眼就能看出它是真读了还是在编。它要是回答「根据常见的 Next.js 项目结构」，那就是在编，说明你的仓库里缺一份说明——第四步就是补这个。

验收：它报出来的构建命令，你复制到终端里能跑通。

四、把「每次都得交代一遍」的话写进仓库

这一步是第一天投入产出比最高的一步，很多人跳过了，然后每天在对话里重复交代同样的事。

在仓库根目录建 CLAUDE.md（或者 AGENTS.md，2.1.277 之后两个都认），写四类东西：

• 1怎么跑起来：装依赖、起开发服务、跑测试各是哪条命令，端口是多少。
• 2哪些地方不许动：生产配置、迁移文件、别人正在改的模块。写清楚「不许动」，比事后发现它动了要便宜得多。
• 3本项目的约定：命名、目录分工、提交信息格式、日志该往哪写。
• 4踩过的坑：那些「看起来该这么写、但在这个项目里会炸」的事。这一类内容价值最高，因为模型的通用知识里没有。

写多长？第一天写 30 到 60 行就够了。不要一次写成两百行的规章——你自己都记不住的规则，它执行起来也会打折。后面每次你发现「我又解释了一遍同一件事」，就往里加一条。

验收：新开一个会话，重复第三步那个问题，看它的回答是不是直接引用了你写的内容。

五、先让它读、让它出方案，确认了再让它动手

这是第一天最容易出事的地方：直接说「把 X 改成 Y」，然后它改了十七个文件，你看不过来，只好全盘接受或者全盘回滚。

正确的顺序是两段：

第一段，只读不写。 用计划模式（plan mode），它会先探索、再给方案，不碰文件。你要看三件事：它找到的文件对不对、它打算改的范围有没有超出你的预期、它有没有漏掉你知道但它没提的地方。

第二段，确认后执行。 方案对了再放行。方案不对，在方案阶段改，比在代码阶段回滚便宜十倍。

六、每一段改完立刻提交，别攒着

这条是纪律，不是技巧。

它一次改完，你 review 完觉得对，立刻 git commit。下一段任务重新开始。不要连着让它改三四件事，改到一半发现第二件事做错了，前后混在一个工作区里，你只能整个丢掉重来。

一次会话里做完一件事、提交一次，好处是出问题时 git diff 的范围永远只有一件事那么大。这也是为什么第二步要挑「一两个小时的活」——它正好能装进一个提交。

验收：git log --oneline 里，今天的提交每一条都能用一句话说清改了什么。

七、拿到第一天的账：它到底帮你省了多少

第一天结束前做一件事：把你今天的实际耗时和「全手工做要多久」并排写下来。

不要只记时间，记三个数：

第三个数最重要。「看不懂但先合了」的改动，是这类工具唯一真正的风险。它不会立刻出事，会在两周后以一个你完全想不到的形式出事。第一天就把这个数盯住，后面才敢把它放到更重要的链路上。

关于账单：第一天不用急着买最贵的档

第一天用订阅制就够了。Claude 官方定价页上，Pro 是每月 20 美元（年付折到每月 17 美元），Max 从每月 100 美元起，团队标准席位年付每席每月 20 美元、月付 25 美元。

有一件事得提前知道：付费档是双重计量——每 5 小时一个滚动会话上限，外加一个跨全部模型的周上限。而且 Claude Code 和网页端、桌面端、手机端共用同一个额度池。所以「白天在网页上聊了一下午，晚上发现命令行里额度不够了」是正常现象，不是故障。

Anthropic 官方没有公布精确的 token 配额，只给了倍数关系（Pro 1 倍、Max 5 倍、Max 20 倍）。网上那些「Pro 每 5 小时大约 45 条」的数字全部来自第三方实测，参考可以，别当合同。

第一天的正确做法是：用 Pro 跑一天，看你自己撞没撞上限。撞了再升，没撞就先不升。先有用量数据，再做采购决策，顺序反了你会为一个用不满的档位付一年钱。

第一天之后

七步做完，你手上会有三样东西：一个能跑起来的工作流、一份写进仓库的项目说明、一个今天的真实账。

第二天开始，重复第五、六步就行。第四步的那份说明，每周回头补一次——补的依据是这一周你重复解释过的话。那份文件长到一百行的时候，你会发现新会话的第一轮回答质量，和第一天完全不是一个东西。