3 Claude Code 第一次上手：让它读仓库、改文件、跑测试

查看大图

装好 Claude Code 后，最容易犯的错是第一句话就说：“帮我把这个项目优化一下。”这句话听起来很自然，但对代码助手来说太大了。它不知道你要优化性能、UI、接口、SEO、构建速度，还是代码结构。

第一次上手，我建议按“读、问、改、验、看”的节奏来。

我更信任会说明依据的 Claude Code。它改文件前应该能说出为什么改这里，改完后应该能说明检查结果，而不是只给一个看似完整的答案。

查看大图

这一节适合加入一个最小练习：只改一处低风险文案，然后要求它列出 touched files、测试命令和剩余风险。这样读者学到的是工作方式，不只是命令。

第一步：只读仓库，不改文件

进入项目根目录后启动：

查看大图

第一次让 Claude Code 处理仓库时，适合选择范围小、能验证的任务。先读结构，再改一个明确点，最后用命令和 diff 复查。

claude

第一条消息可以这样写：

先不要修改任何文件。请阅读当前项目，告诉我：
1. 这个项目的技术栈
2. 主要入口文件
3. 本地开发和构建命令
4. 你认为最重要的 5 个目录
5. 哪些文件改动风险比较高

这一步是在给 Claude Code 建立地图。你也可以顺便判断它有没有瞎说。如果它把 Next.js 项目说成 Vue，或者把后端入口说错，那就不要急着让它改。

第二步：让它找一个具体入口

比如你想改首页按钮，不要直接说“优化首页”。可以这样问：

查看大图

开始读《Claude Code 第一次上手：让它读仓库、改文件、跑测试》前，可以先看图中从问题到结果的路径。读完后再对照正文，确认自己能不能照着复现。

我想调整首页第一屏的按钮文案。请先定位相关组件和样式文件，不要修改。
列出你会查看的文件，以及每个文件的作用。

这类问题特别适合 Claude Code，因为它可以搜索文件、看引用、顺着路由找组件。你要做的是确认它找的文件是不是靠谱。

第三步：只改一个小点

确认位置后，再给一个低风险任务：

只修改首页主按钮文案，把“开始体验”改成“查看今日 AI”。
不要改布局，不要改路由，不要改其它文案。
改完后请展示变更摘要。

这里的关键是范围要窄。第一次不要让它同时改 UI、接口、状态管理和数据结构。小改动更容易建立信任，也更容易回滚。

第四步：跑项目已有验证

改完以后，让它运行项目里已有的验证命令：

请查看 package.json 或项目说明，选择合适的验证命令。
优先运行类型检查、lint 或 build。不要新增依赖。

如果项目是 Python，就让它找 pytest；如果是前端，就看 pnpm build、npm run build、npm run lint；如果是后端服务，就看有没有定向测试。

我不建议一开始就让它自己“补一套测试框架”。先复用项目已有命令，风险最低。

第五步：看 diff，而不是只看回答

Claude Code 改完后，你一定要看 Git diff：

git diff

或者在 Claude Code 会话里让它说明：

请按文件列出这次改动，并解释为什么需要改这些文件。
如果有任何无关改动，请标出来。

好用的 Claude Code 工作流不是“我完全不看代码”，而是“我把找代码和重复劳动交给它，把判断权留在自己手里”。

第一次上手的检查清单

第一次改动完成前，至少检查这几项：

查看大图

回看《Claude Code 第一次上手：让它读仓库、改文件、跑测试》时，不必一次做大项目，先用一条简单样例确认主线是否清楚。

查看大图

如果《Claude Code 第一次上手：让它读仓库、改文件、跑测试》还没完全消化，可以从这张卡片的四个动作重新走一遍。

• 它有没有改到你没要求的文件。
• 它有没有新增依赖。
• 它有没有碰 .env、密钥、部署脚本。
• 构建或测试是否通过。
• 你自己能不能解释这次改动。

如果这五项都没问题，再考虑让它做第二个任务。

下一篇我们写 CLAUDE.md。这相当于给每个项目准备一张“工作说明书”，让 Claude Code 每次进来都少走弯路。

参考资料：

• Claude Code Quickstart
• Claude Code Commands