2.3 第一个会话：5 步上手

用一个真实项目来演示

空口讲不直观，我们用一个真实项目来走一遍完整流程。

这里用的是 expressjs/express——Node.js 最流行的 Web 框架之一，代码结构清晰，非常适合练手。你不需要懂它的每行代码，我们只是用它来演示 Claude Code 的基本操作。

先把项目克隆下来：

git clone https://github.com/expressjs/express.git
cd express

---

第一步：启动 Claude Code

进入项目目录后，直接运行：

claude

你会看到一个欢迎界面，显示当前会话信息、最近的对话历史和版本更新。

然后就是一个输入框，等你说话。

---

第二步：让它介绍这个项目

第一件事，让 Claude Code 读懂这个项目。输入：

这个项目是做什么的？有哪些主要模块？

Claude Code 会开始读取文件——你能看到它在扫描目录结构、打开 package.json、读 README.md、浏览 lib/ 目录……

几秒钟后，它会给你一个概述，大概像这样：

Express 是一个轻量的 Node.js Web 框架。主要模块包括：路由系统（lib/router/）、中间件管理（lib/middleware/）、请求/响应扩展（lib/request.js / lib/response.js）……

这就是 Agentic Loop 的第一阶段：收集上下文。它不需要你解释项目，自己去读。

💡 试试这几个问题，都很有用：

这个项目用了什么测试框架？怎么运行测试？
入口文件在哪里？
有 TypeScript 类型定义吗？

---

第三步：让它改一行代码

光聊不过瘾，让它动手改点东西。我们让它给 lib/application.js 加一行注释：

在 lib/application.js 的文件开头加一段注释，说明这个文件的主要职责，用中文写

Claude Code 会：

1. 读取 lib/application.js
2. 在开头生成一段注释
3. 在修改文件之前，给你看 diff，问你确不确认

你会看到类似这样的提示：

Edit lib/application.js? [y/n]

这是 Claude Code 的权限机制——它不会悄悄改你的代码，改之前一定会问你。

按 y 确认，文件就改了。

💡 如果你在这个会话里要做很多改动，可以输入 /acceptedits 或按 Shift+Tab 切换到自动接受模式，省掉每次确认的步骤。

---

第四步：提交这次改动

改完了，让它提交：

把这次改动提交到 git，写一个合适的 commit message

Claude Code 会：

1. 运行 git diff 看看改了什么
2. 运行 git add 暂存文件
3. 写一条 commit message
4. 运行 git commit
5. 告诉你提交成功，附上 commit hash

整个过程就是它自己在终端里敲命令，你只是看着。

---

第五步：退出会话

任务做完了，退出方式有两种：

exit        # 输入 exit
# 或者
Ctrl+C      # 键盘快捷键

---

常用命令速查

你在 Claude Code 会话里能用的命令不多，但这些必须记住：

命令	干什么
/help	显示所有可用命令
/clear	清空当前对话历史（省 token 用）
/model	切换 AI 模型（Sonnet / Opus）
/login	重新登录 / 切换账号
/acceptedits	本会话内自动接受所有文件改动
/permissions	查看和管理权限规则
/init	生成 CLAUDE.md
exit	退出

---

非交互模式：不进对话，直接出结果

有时候你不想开一个对话，只想快速完成一个任务。用 -p 参数：

# 直接运行，打印结果，退出
claude -p "这个项目用什么测试框架？"

# 继续上一个会话
claude -p "继续分析刚才的问题" --continue

这个模式在写脚本、接 CI/CD 的时候特别有用，后面章节会详细讲。

---

键盘快捷键

快捷键	作用
↑ / ↓	翻历史命令
Shift+Tab	切换权限模式（普通 → 自动接受 → 规划模式）
Ctrl+G	在编辑器里打开当前计划
Ctrl+C	打断当前操作
?	显示所有快捷键

---

走完这五步，你已经完成了一次完整的 Claude Code 使用流程：理解项目 → 修改代码 → 提交 git。

下一节，我们来解决一个让很多人觉得麻烦的问题：每次开新会话，都要重新介绍一遍项目吗？