AI 编程智能体装好之后愣住，是第一次用 Claude Code 的新手普遍状态：命令会敲了，但接下来进哪个目录、第一个任务怎么下、文件怎么喂给它、方向不对怎么叫停、做完之后怎么留档——没有一条完整的链路可循。这篇就补这条链路，六个步骤一步不跳，从进项目到落地提交，每步给出动作要点与易错处；还没安装的，先回安装篇把环境备好再回来。
第一步：进对项目目录再启动
Claude Code 默认在当前目录工作，目录切错、读错仓库，后面全乱。先在终端里 cd 到项目根目录，再敲 claude 启动会话。这个顺序别省：它打开会话后第一件事就是观察当前目录——README、配置文件、目录组织都会成为它理解项目的起点，起点错了，后面每个任务都要多花几轮纠正。
第二步：跑 /init 生成 CLAUDE.md
进对目录后先跑一次 /init：它会扫一遍项目，生成一份 CLAUDE.md 文件，把技术栈、目录约定、构建与测试命令这些背景写下来，此后每个任务都会先读它再动手。这份文件相当于给新同事做完入职介绍——写得越准，后面每个任务跑得越顺。它是普通文本文件，随时可以手动补充修改：团队的命名规范、哪些目录不要动、常用的命令，都可以往里写；项目结构大改之后重跑一次 /init 也值得。CLAUDE.md 里的内容如何被遵循、哪些时候会被忽略，见指令的层级一篇。
第三步：下第一个小任务
第一个任务挑小的、能验证的：一个明确的小 bug、一个说清输入输出的小函数。指令写具体——现象是什么、期望是什么、有什么约束，一句话能验收对错的最合适。信息给足，它的第一步定位就准；指令含糊，它只能猜，来回返工烧的是你的额度。练手阶段想让节奏更快，可以让豆包按你的项目类型出一份练手任务清单；指令写不具体时，让 DeepSeek 把含糊的描述改写成目标明确的版本；拿不准 /init 生成的 CLAUDE.md 准不准，让 Kimi 对照仓库实际结构挑出与事实不符的条目。
| 现象 | 多半是 | 先做哪一步 |
|---|---|---|
| 第一个任务就跑偏 | 指令不够具体，或缺文件上下文 | 把报错与期望重新喂回去 |
| 连续两三次都偏 | 任务切得太大 | 把任务拆得更小再试 |
| 它在仓库里翻找半天 | 没主动 @ 关键文件 | 用 @ 直接引用该文件 |
| 眼看它往错路上跑 | 没有及时拦 | 按 Esc 停下再纠正 |
第四步：用 @ 精准喂文件
任务涉及具体文件时，用 @ 加文件路径直接引用，比如 @src/utils/parser.py：被引用的文件会明确进入它的注意力范围，省去它自己大海捞针的过程。反过来也成立：无关的大文件别让它乱读，读得越多、上下文越大、额度消耗越快——@ 是双向阀门，既指路，也挡路。
第五步：Esc 随时叫停
它跑到一半发现方向不对，不用等它跑完：按 Esc 立即停止当前动作，把纠正的话说给它，接着刚才的状态继续。这一键是新手最该练熟的动作——很多人眼睁睁看它往错路上狂奔，其实第一秒就能拦下。拦下之后想退回更早的状态，检查点回退的用法见回退与检查点一篇。
第六步：每任务一 commit，/help 当控制台
每完成一个任务、验收通过，就让 Claude Code 做一次 git commit：提交信息写清这个任务干了什么。这是一道保险——哪天后续任务改坏了，git 能一步回到上一个好状态，回退成本几乎为零。最后记住 /help：所有斜杠命令的清单都在里面，忘了命令随手查，它是整个控制台的入口。Codex 那边也有一条同款的首次使用链路，见Codex 首次使用一篇，两个工具的工作流高度相似，读过一边再看另一边基本无缝切换。
首次上手六步速查
- cd 进项目根目录再启动 claude，目录错则全盘错
- 先跑 /init 生成 CLAUDE.md，给项目做完入职介绍
- 第一个任务挑小而可验证，指令写明现象与期望
- @ 引文件精准喂上下文，无关大文件别乱读
- Esc 随时叫停；每任务验收后 commit；/help 查全部命令
关于首次上手的三问三答
- /init 可以跳过吗？：可以，但不建议。没有 CLAUDE.md，它每次任务都要自己重新摸索项目约定，方向偏了要多轮纠正；花两分钟做初始化，后面每个任务都受益。
- 第一个任务失败了正常吗？：正常。多数是指令不够具体或缺少文件上下文，把报错与期望重新喂回去让它继续修；连续两三次都偏，先把任务拆得更小再试。
- 整个项目可以直接丢给它吗？：不建议。它会按需读取文件，你主动 @ 关键文件比让它全库翻找更快更省；项目级的背景信息写进 CLAUDE.md，一次生效、长期复用。
