Claude Code 怎么用？官方上手 7 步走完整教程

30 秒了解：Claude Code 怎么用，到底要按什么节奏

Claude Code 怎么用这件事，新手最容易犯的错是「装好就乱说一通」。 正确的节奏是 7 步：装 → 登 → 进项目 → 第一句 prompt 让它看 → 批准它的动作 → 写一份 CLAUDE.md 让它记住 → 学会用 Shift+Tab 切模式。这套节奏跟着走，你第一天就能干出真活。

这篇是官方 first-day 教程的中文实操版。如果你还没装，先按 Claude Code 安装教程走一遍；如果你完全不知道 Claude Code 是什么、跟 Cursor / Copilot 的区别，先看 Claude Code 是什么再回来。

准备工作：3 个前置条件

Claude Code 已经装好：终端跑 claude --version 能看到版本号
有一个真实项目：哪怕是个 hello world 的小仓库都行，纯净空目录练不出感觉
能稳定连 anthropic.com：国内用户配好代理

下面 7 步全部在终端里完成。

第 1 步：登录你的账号

打开终端，跑：

claude

第一次启动会让你认证。在 CLI 里输入：

/login

按回车，浏览器自动弹一个 Anthropic 登录页。登完点「Authorize」回到终端，看到 Authenticated as 你的邮箱 就 OK。

几种特殊登录方式

如果你不是用订阅，而是想用 API key、AWS Bedrock 或 GCP Vertex 走云厂商：

# 用 API key（按 token 计费）
export ANTHROPIC_API_KEY=sk-ant-...
claude

# 走 AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
claude

# 走 GCP Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
claude

公司给你发的是企业账号（Claude Enterprise / Team），用法跟个人账号一样：/login 走浏览器登录，权限和用量按公司套餐走。

第 2 步：进入项目目录

退出 CLI（按 Ctrl+C 两次或者 /exit），切到你的项目根：

cd ~/projects/my-app
claude

重要：永远在项目根目录启动。 Claude Code 启动那一刻读的是当前目录，子目录、上级目录的代码它默认不看（除非你显式 @ 引用或者 /add-dir 加进来）。

进去后你会看到一个简单的提示符，等你输入。

第 3 步：先让它看，别让它写

最关键的一步——第一句话千万别是「帮我加个 xxx 功能」。先让它认识项目，再让它干活。

复制下面这段当作万能开场：

📋 Prompt 模板

你好。这是我们这个项目的第一次 Claude Code 会话。

在动手改任何文件之前，请先：

列出项目根目录的结构（前两层就行）
找 README.md / package.json / pyproject.toml / go.mod / Cargo.toml，告诉我这是什么项目、用什么语言和框架
找 CLAUDE.md，如果有读一遍并用一句话总结你接收到的约定
跑项目的测试命令（如果你能找到 npm test / pytest / go test），告诉我现在是不是绿的

完成上面 4 件事，等我下一步指令再改任何文件。

它会按这 4 步走一遍，输出结构、技术栈摘要、测试状态。这一步的价值是：你跟 Claude Code 建立了「共同上下文」，后面任何任务它都知道这个项目的脾气。

第 4 步：批准（或拒绝）它的动作

Claude Code 想改文件、跑命令之前，默认会先弹一个确认让你 y/n。

举个例子，你说「帮我修 utils.ts 里那个 typo」，它会显示：

Edit utils.ts
   42:  export function formart(date: Date) {
   42:  export function format(date: Date) {

[1] Accept   [2] Accept all in this session   [3] Reject

3 个选项：

[1] 单次接受：只接受这一处改动，下次还是会问
[2] 接受这次会话剩下的所有改动：开「auto-accept」模式，相当于全权委托，跑完才停
[3] 拒绝：让你写理由，Claude Code 看到理由会调整方案

用 Shift+Tab 切换 3 个权限模式

按 Shift+Tab 在 3 个模式之间循环：

模式	行为	适合
default	每个动作都问你	第一次干这事、不放心
acceptEdits	改文件自动批准，跑命令还问	已经看过 plan，让它跑
plan	只看不写，只输出方案	探索阶段，先想清楚

新手强烈建议从 default 模式 起步——每个改动都看一眼，培养对 AI 输出的判断力。等你跑了几十次熟了，再开 acceptEdits 加速。

第 5 步：跑你的第一条真活 prompt

热完身，开始干第一件真事。官方推荐的 5 个新手任务：

让它总结整个 codebase
找某个功能在哪儿实现
给某个函数加文档注释
修一个失败的测试
帮你写 commit message 并 stage 改动

挑一个跟你项目相关的试。比如：

📋 Prompt 模板

帮我找一下：项目里处理用户登录的代码在哪里？

要求：

列出所有跟登录相关的文件路径
用 2-3 句话总结当前登录流程是怎么走的
指出你看到的 1-2 个可能改进的点（不用改，只指出）

不要动任何文件，只回答。

它会读相关文件、给你答案。整个过程你能看到它在读哪些文件、调用了哪些工具——这是 Claude Code 跟网页版 Claude 最大的区别。

第 6 步：跑 `/init` 生成 CLAUDE.md

试完一两个任务后，趁热打铁让 Claude Code 给项目写一份「持久记忆」：

/init

它会再次扫描项目、识别约定（命名、目录结构、构建命令、测试方式），输出一份草稿 CLAUDE.md 让你审。

你做的事：

通读一遍它写的草稿
删掉它猜错的、加上它不知道的——比如团队内部不成文的规矩、protected directory、commit message 格式
保存，commit 到 git（这是个团队文件，应该入版本控制）

下次任何人在这个项目里启动 Claude Code，它都会自动读这份文件，行为立刻跟项目对齐。详细写法看 CLAUDE.md 怎么写。

第 7 步：会话尾声 — 学会善后

跑完一段活，养成 3 个收尾习惯：

1. `/cost` 看花了多少

/cost

输出当前会话用了多少 token、估算了多少钱。Pro 套餐有用量上限，Max 套餐宽松些。养成「每次干完事看一眼」的习惯，对自己的消耗有数。

2. `/clear` 重置上下文

/clear

清空当前对话历史，但保留 CLAUDE.md。长会话里 Claude Code 上下文越积越多容易跑偏，跑完一段活就清一次，相当于「重启对话」。

3. git commit 落盘

Claude Code 帮你写完代码，它不会自动 commit。要么手动 git add . && git commit -m "..."，要么让它帮你写 commit message：

📋 Prompt 模板

帮我看一下当前所有未 commit 的改动，按 Conventional Commits 格式写一条合适的 commit message，然后帮我 git add 并 commit。

如果改动太杂（涉及超过 3 个独立主题），先拆成多个 commit。

5 个高频玩法，第一周就该上手

玩法 1：让它先 `/plan` 再动手

复杂任务别直接让它干。先按 Shift+Tab 切到 plan 模式，让它输出方案：

我想把当前 REST API 改成 GraphQL。你先给我一个分步骤的 plan，不要动任何文件。

它会列 5-15 步给你看。你 OK 才切回 default / acceptEdits 让它执行——避免「跑了半小时发现方向错了」。

玩法 2：用 `@` 精准喂上下文

输入 @ 触发文件引用：

帮我看 @src/components/Button.tsx 里的样式逻辑，搬到 @src/components/Card.tsx

比让它「自己找」更准、更省 token。

玩法 3：`/rewind` 回滚

发现 Claude Code 干歪了，按 Esc 两次或者 /rewind，能回到对话里某个 checkpoint，连同代码一起回滚。比 git reset 更细——它记得每个动作前的状态。

玩法 4：`/model` 切大小模型

跑常规任务用 Sonnet（快、便宜），跑大重构用 Opus（聪明、贵）：

/model

会列出当前账号能用的模型让你选。养成「干活前先选合适模型」的习惯，每月省一大笔。

玩法 5：`/context` 看脑容量

/context

显示当前上下文窗口用了多少 token、还剩多少。看到快满了就 /compact 压缩，或者 /clear 重置。

常见的 4 个坑

现象	原因	解决
Claude Code 一直问你 y/n 烦死	还在 default 模式	`Shift+Tab` 切到 acceptEdits
改完代码跑测试，结果没跑	它默认不会自动跑测试	prompt 里明确说「改完跑 npm test 验证」
中文输出夹杂英文	上下文里有英文文档	在 prompt 里加一句「全部用中文回答」
跑大任务跑一半断了	上下文超了 / 网络波动	跑前先 `/compact`，或者拆成小步骤

一个完整实战：让 Claude Code 帮你写一个 README

假设你接手一个老项目，README 缺失。用这个完整流程让 Claude Code 给你写一份：

📋 Prompt 模板

任务：给当前项目写一份高质量 README.md

要求：

先看 package.json / pyproject.toml 等元数据，识别项目用途
看 src/ 下的目录结构，识别架构
看测试目录和 CI 配置，识别开发流程
看 examples/ 或 demo/，识别使用示例
然后写 README，包含：
- 一句话定位
- 安装步骤（写真实可跑的命令，不要占位符）
- 最小可用示例（5 行能跑通的代码）
- 完整 API 概览（列主要的导出函数 / 命令）
- 贡献指南简短一段
用中文写
写完前先输出 outline，等我说 OK 再写完整版

不要动 src/ 任何文件，只生成 README.md

跑一遍你会发现：它先按步骤探索、输出 outline、等你确认、再写完整 README、最后让你批准创建文件——整个过程节奏分明、可控。这就是 Claude Code 比「让 ChatGPT 写代码再复制粘贴」强的地方。

进阶 / 下一步

命令速查表 → Claude Code 命令速查表
写持久记忆 → CLAUDE.md 怎么写
进阶 10 技巧 → Claude Code 进阶 10 技巧
装出问题 → Claude Code 安装教程
跟其他工具比 → AI 写代码完全指南
想用国产替代 → Kimi Code CLI 怎么用

常见问题

Q：Claude Code 跟 Cursor 比，谁更适合新手？ A：纯新手（没用过 terminal）选 Cursor，图形界面友好。有一点命令行基础（会 cd、ls、git）的人选 Claude Code，长任务能力更猛。两者不冲突，很多人两个都用。

Q：第一次用就让它改大项目可以吗？ A：可以，但务必：1) 项目是干净的 git 状态（所有改动都 commit），2) 在 plan 模式先让它输出方案、你审过，3) acceptEdits 模式让它执行。万一出问题 git reset 一下就回来了。

Q：能不能离线用？ A：不能。Claude Code 每个动作都要请求 Anthropic API，没网络它一句话都说不了。

Q：跟 Claude 网页版可以共享会话吗？ A：不能。两个产品是分开的，记忆不互通。但 CLAUDE.md 你可以同时复制一份到 Claude 网页版的 Project 里，作为持久 context 用。

Q：会不会改坏我代码？ A：会，但风险可控。3 道防线：1) 默认每个动作都问你 y/n，2) git 让你能 reset 回去，3) /rewind 能回滚到某个 checkpoint。养成「干活前 commit、干完 review、有问题 rewind」的习惯。

30 秒了解：Claude Code 怎么用，到底要按什么节奏

准备工作：3 个前置条件

第 1 步：登录你的账号

几种特殊登录方式

第 2 步：进入项目目录

第 3 步：先让它看，别让它写

第 4 步：批准（或拒绝）它的动作

用 Shift+Tab 切换 3 个权限模式

第 5 步：跑你的第一条真活 prompt

第 6 步：跑 /init 生成 CLAUDE.md

第 7 步：会话尾声 — 学会善后

1. /cost 看花了多少

2. /clear 重置上下文

3. git commit 落盘

5 个高频玩法，第一周就该上手

玩法 1：让它先 /plan 再动手

玩法 2：用 @ 精准喂上下文

玩法 3：/rewind 回滚

玩法 4：/model 切大小模型

玩法 5：/context 看脑容量

常见的 4 个坑

一个完整实战：让 Claude Code 帮你写一个 README

进阶 / 下一步

常见问题

第 6 步：跑 `/init` 生成 CLAUDE.md

1. `/cost` 看花了多少

2. `/clear` 重置上下文

玩法 1：让它先 `/plan` 再动手

玩法 2：用 `@` 精准喂上下文

玩法 3：`/rewind` 回滚

玩法 4：`/model` 切大小模型

玩法 5：`/context` 看脑容量