Codex / Claude Code · 小白

Claude Code 第一次跑起来要做什么

装好 Claude Code 后，先配 API、再认识对话与编辑两种模式，最后做一次小修改试水。

  • Claude Code
  • 入门
更新于 2026-05-17

一句话结论

装、登录、改一个小文件、提交一次 PR，一小时内能跑完整的工具回路。

适用场景

  • 刚装上 Claude Code 不知道先做什么
  • 想搞懂「对话」「编辑」两种模式各自干嘛
  • 想跑通最小修改 → 提交流程

常见现象

  • 面板打开了但不敢改东西
  • 登录之后不知道下一步
  • 改完没保存或者保存了不知道怎么回滚

原因解释

  • Claude Code 默认在沙箱里改代码，需要主动同意写入
  • 对话模式偏问答，编辑模式才会真正改文件
  • 没做版本控制时，回滚得靠 git

解决步骤

  1. 登录后先开一个测试仓库，避免改到正式项目
  2. 用对话模式让它解释一下当前目录，确认它能「看到」代码
  3. 切到编辑模式，让它改一处不重要的文案，观察 diff
  4. 确认没问题就 git add / commit，留下回滚锚点
  5. 第二次开始就可以让它做更大的改动

仍然不行怎么办

  • 改坏了就 git restore 或回滚到上一次 commit
  • Agent 总是改错文件就把目标缩到单文件 / 单函数

小白先准备什么

  1. 先复制一份项目或确认项目已经有 Git 记录，避免第一次练手改坏原文件。
  2. 准备项目的启动命令、构建命令和你能看懂的验收目标，例如“首页能打开、按钮能跳转”。
  3. 第一次打开 Claude Code 后先让它只读分析，不要马上让它大改。
  4. 把账号登录、网络代理、终端权限这些基础问题先解决，再进入项目。

验收标准

  • `claude --version` 能正常输出版本，项目目录里能启动 Claude Code。
  • Claude Code 能说清项目技术栈、入口文件、构建命令和主要页面。
  • 第一次修改只改 1-2 个文件，并且你能用浏览器看到变化。
  • 每次改完都跑 build 或项目自带检查，失败就先修失败原因。

可复制提示词

请先只读分析这个项目，不要修改文件。

我是不懂代码的小白，请用中文告诉我：
1. 这个项目是什么技术栈。
2. 首页、路由、数据分别在哪些文件。
3. 本地启动和构建命令是什么。
4. 如果我要改首页文案，最少需要改哪些地方。
5. 你建议先做哪一个最小改动来验证流程。

常见误区和不适合场景

  • 不要把 Codex 的长任务命令当成 Claude Code 命令；Claude Code 里把验收目标写进提示词或 CLAUDE.md，用 /help 查看可用命令。
  • 不要第一次就说“全面优化整个项目”，先让它分析，再分批改首页、文章、组件、样式。
  • 不要跳过构建。看起来能打开不代表线上能部署。
  • 不适合：没有任何备份、没有启动命令、也不知道最终要验收什么的项目。

相关问题

还卡着？

可以把截图、日志、需求单或当前页面链接发到 zhemuy@gmail.com。