本节目标

完成本节后，你将能够：

1. 掌握启动 Claude Code 的三种方式及其适用场景

2. 理解"描述-审查-确认"的核心对话流程

3. 熟练使用 5 个最重要的斜杠命令

4. 记住常用键盘快捷键

5. 理解权限模式并知道何时切换

---

核心知识点

Claude Code 的三种启动方式

方式 1：交互模式（Interactive Mode）——日常开发首选

claude

直接输入 claude 进入交互模式。你会看到一个终端内的对话界面（TUI），可以逐条发送消息、查看回复、批准或拒绝文件操作。这是 90% 的使用场景。

方式 2：单次模式（Single-Shot Mode）——快速问答和脚本化

claude -p "这个项目用什么构建工具？"

-p（print）参数让 Claude Code 执行一次问答后直接输出结果并退出。适合快速查询、脚本集成、CI/CD 流水线中的自动化检查。

方式 3：管道模式（Pipe Mode）——与其他命令行工具配合

cat error.log | claude -p "分析这个日志文件中的错误模式"
git diff HEAD~1 | claude -p "审查这次代码变更，找出潜在问题"

通过管道将标准输入传给 Claude Code，让它分析任意文本内容。这是 Claude Code 区别于其他 AI 编程工具的核心能力之一——它真正融入了 Unix 的"管道哲学"。

"描述-审查-确认"核心对话流程

Claude Code 的每一次交互遵循一个标准的三段式流程：

1. 你描述（Describe）：用自然语言告诉 Claude Code 你想要什么。"把这个文件中所有的 var 替换为 const"、"给这个函数写单元测试"、"分析为什么构建失败了"。

2. AI 执行并展示（Execute & Present）：Claude Code 会搜索文件、读取代码、运行命令，然后将它要做的事情以"计划 + 操作"的形式展示给你。你可能看到它说："我将读取 3 个文件，然后修改 src/utils.ts 中的以下函数..."

3. 你审查并确认（Review & Confirm）：对于文件修改和命令执行，Claude Code 会弹出权限请求。你需要选择 Approve（批准）、Deny（拒绝）、或查看 Diff 后决定。

这个流程的关键在于：你永远是最终决策者。Claude Code 不会越过你的授权去修改任何文件。

五个核心斜杠命令

在交互模式中，以 / 开头的命令控制 Claude Code 本身的行为。以下是 5 个最重要的：

命令	功能	使用时机
/init	为当前项目生成或更新 CLAUDE.md	新项目初始化、规则变更
/clear	清空当前会话的对话历史	话题切换、上下文混乱时
/compact	压缩上下文窗口，为长会话腾空间	上下文接近上限时（会有提示）
/cost	查看当前会话的 token 消耗和费用	随时查看，了解花费
/doctor	运行系统诊断	遇到异常行为时排查问题

键盘快捷键速查表

快捷键	功能	说明
Ctrl+C	中断当前 AI 响应	如果 AI 方向跑偏，直接打断
Ctrl+D	退出 Claude Code	结束交互模式
Ctrl+O	查看 AI 的完整思考过程	查看 extended thinking 输出
Ctrl+R	搜索对话历史	在当前会话中快速定位
↑ / ↓	浏览历史命令	和普通终端一样
Tab	自动补全文件路径	在输入 @ 引用文件时有效

权限模式切换

Claude Code 启动时默认使用"安全模式"——所有文件修改和命令执行都需要你手动确认。但在信任的项目中，你可以调整：

# 在交互模式中输入，临时切换权限模式
/security

你会看到四个选项：

• Strict（严格）：所有操作都需确认

• Normal（正常，默认）：文件读写和命令执行需要确认

• Relaxed（宽松）：同目录下的操作自动批准

• 自定义：通过 .claude/settings.json 精确控制

新手强烈建议保持在 Strict 或 Normal 模式，直到你完全理解权限模型的含义。

---

实操步骤

步骤 1：启动你的第一次交互会话

找一个你熟悉的小项目目录，或者创建一个新的测试目录：

mkdir ~/claude-playground
cd ~/claude-playground
echo '{"name": "playground", "version": "1.0.0"}' > package.json
echo 'console.log("Hello, Claude Code!");' > index.js
echo '# Playground' > README.md

然后启动 Claude Code：

claude

你会看到欢迎界面。注意它自动识别了你的项目——它读取了 package.json、index.js 和 README.md。

步骤 2：体验"描述-审查-确认"流程

在 Claude Code 中输入以下消息：

请分析三个文件，然后帮我在 index.js 中添加一个简单的 add 函数，接收两个参数返回它们的和。

观察 Claude Code 的行为：

1. 它可能会先读取 index.js、package.json 来理解项目上下文

2. 它会展示一个计划——"我将在 index.js 中添加..."

3. 在它要写入文件时，终端会弹出确认提示

4. 你可以选择 A（Approve）来批准

步骤 3：练习斜杠命令

在同一个会话中，依次尝试：

/cost

观察当前会话消耗了多少 token 和费用。第一次对话通常只有几分钱。

/clear

清空对话历史。然后输入一个新问题测试——你会发现它"忘记"了之前的对话。

/doctor

在不退出会话的情况下运行系统诊断。

步骤 4：体验单次模式和管道模式

退出交互模式（Ctrl+D），然后尝试：

# 单次模式
claude -p "这个目录里有哪些文件？每个文件的作用是什么？"

# 管道模式
cat index.js | claude -p "审查这段代码，指出可以改进的地方"

步骤 5：学习用 @ 引用文件

在交互模式中，你可以用 @ 符号引用文件，让 Claude Code 精确知道你在说哪个文件：

请比较 @index.js 和 @package.json，告诉我这个项目是做什么的。

这是提高沟通效率的关键技巧——避免模糊的"那个文件"。

---

避坑指南

坑 1：描述不够具体

错误示例："帮我改一下这个项目" 正确示例："把 src/utils/format.ts 中的 formatDate 函数改为支持 ISO 8601 格式输出"

Claude Code 虽然智能，但它不是你肚子里的蛔虫。描述越具体，结果越符合预期。如果你不确定具体要做什么，可以先描述问题："我觉得这个函数的命名不太清晰，你有什么建议？"

坑 2：一次要求做太多事

错误示例："帮我重构整个项目、加单元测试、写文档、部署到生产环境"

一个对话回合最好聚焦于一个明确的任务。如果你有复杂需求，分解成多个回合逐步推进。这样每一步你都可以审查、确认，避免方向跑偏后需要大量回滚。

坑 3：不看 Diff 就批准

每次 Claude Code 要修改文件时，你可以选择查看 Diff（差异对比）。这是你最重要的质量控制环节。很多新手图省事直接点 Approve，结果发现代码被改得不对劲。

铁律：涉及超过 10 行的修改，一定要看 Diff。

坑 4：忘记 /clear 导致上下文混乱

当你多次修改同一个文件后，Claude Code 可能"记住"了过时的文件内容。如果你发现 AI 引用了一个已经不存在的函数或变量，用 /clear 清空历史，重新开始。

---

课后作业

1. 建立肌肉记忆：在三个不同的项目目录下各启动一次 claude 交互模式，观察 Claude Code 对每个项目的理解差异。

2. 命令练习：在一个会话中完成以下操作序列：/cost → 提一个问题 → /cost（对比前后消耗）→ /clear → 提一个新问题（验证它忘记了之前的对话）。

3. 权限体验：尝试让 Claude Code 修改一个文件，然后在权限提示时选择 Deny。观察它如何响应拒绝。

4. 管道挑战：找一个你熟悉的 Git 仓库，运行 git log --oneline -10 | claude -p "总结最近 10 次提交的主要内容"。体验管道模式的实际价值。

---

总结

第一次对话的目标不是做出什么惊天动地的事，而是建立对工作流的直观理解。记住这个核心循环：

你描述目标 → Claude Code 探索并计划 → 你审查并确认 → 重复

五种最重要的操作工具：@ 引用文件、/init 初始化项目规则、/cost 查看消耗、/clear 重置上下文、/compact 压缩上下文。

下一节我们将深入 CLAUDE.md——它是你与 Claude Code 之间最重要的"沟通契约"，决定了 AI 在项目中的行为边界和质量标准。