Claude Code: Claude Code 第一次使用
最后更新:2026-08-31
第一次使用 Claude Code,就像第一次雇了一个超强助手——你需要知道怎么下达指令、怎么确认操作、怎么修正方向。
💡 提示:首次使用建议在简单项目上练习,避免直接在重要生产项目中操作。Claude Code 会修改文件,虽然可以回退,但养成安全习惯很重要。
📋 前置知识:第三章 API 配置与模型选择
1. 你将学到
- 在项目中启动 Claude Code
- 下达任务指令的方式
- 操作确认与权限审批
- 查看与回退修改
- 首次使用的最佳实践
2. 启动你的第一次会话
(1) 准备工作
BASH
# 1. 创建一个练习项目
mkdir my-first-claude && cd my-first-claude
git init
# 2. 创建一个简单的文件
echo 'function hello() { return "Hello"; }' > index.js
# 3. 启动 Claude Code
claude
(2) 交互界面
TEXT
📖 仅展示
╭─────────────────────────────────────────╮
│ Claude Code │
│ Model: claude-sonnet-4-20250514 │
│ Project: my-first-claude │
╰─────────────────────────────────────────╯
> █ (输入你的指令)
▶ 示例 1: 第一次对话
TEXT
📖 仅展示
> 你好,请帮我看看这个项目
Claude: 让我查看项目结构和文件内容...
📁 项目结构:
- index.js
📄 index.js:
```javascript
function hello() { return "Hello"; }
这是一个简单的 JavaScript 项目,目前只有一个 hello 函数。
帮我添加一个 goodbye 函数,并添加单元测试
Claude: 我将为你添加 goodbye 函数和测试文件。
→ Reading index.js → Modifying index.js (adding goodbye function) → Creating index.test.js → Running: npm test ✅ 2 tests passed
已完成:
- 在 index.js 中添加了 goodbye() 函数
- 创建了 index.test.js 包含 2 个测试用例
- 所有测试通过
---
## 3. 操作确认机制
### (1) 权限审批流程
Claude Code 在执行敏感操作时会请求确认:
| 操作类型 | 默认行为 | 示例 |
|:---------|:---------|:-----|
| **读取文件** | 自动执行 | 读取 index.js |
| **创建文件** | 请求确认 | 创建新文件 test.js |
| **修改文件** | 请求确认 | 修改现有文件 |
| **运行命令** | 请求确认 | 执行 npm test |
| **删除文件** | 请求确认 | 删除旧文件 |
### (2) 确认选项
```text
Claude wants to edit index.js:
- Add goodbye() function after hello()
- Add module.exports
Allow? (y/n/a/e)
y = yes (this time)
n = no
a = always allow edits to this file
e = edit the change before applying
▶ 示例 2: 处理权限确认
TEXT
📖 仅展示
> 重构项目为 TypeScript
Claude: 我将进行以下操作:
1. 创建 tsconfig.json
2. 将 index.js 转为 index.ts
3. 添加类型定义
4. 更新 package.json
Allow creating tsconfig.json? [y/n/a/e] y
✅ Created tsconfig.json
Allow editing index.js → index.ts? [y/n/a/e] a
✅ Always allowing edits to index.ts
Allow running: npm install typescript --save-dev? [y/n/a/e] y
✅ Installed typescript
All changes applied successfully!
4. 查看与回退修改
(1) 查看变更
BASH
# 查看当前会话的文件变更
claude /diff
# 查看 git diff
git diff
# 查看具体文件变更
git diff index.js
(2) 回退操作
BASH
# 回退所有修改(基于 git)
git checkout .
git clean -fd
# 回退单个文件
git checkout -- index.js
# 查看修改历史
git log --oneline -5
▶ 示例 3: 回退错误操作
TEXT
📖 仅展示
> 帮我把所有函数重命名
Claude: Renaming functions...
→ hello → greet
→ goodbye → farewell
→ Modified 3 files
# Alice 发现重命名不符合预期
# 使用 git 回退
$ git diff --stat
index.js | 6 +++---
index.test.js | 8 ++++----
utils.js | 4 ++--
$ git checkout .
# 所有修改已回退 ✓
5. 首次使用的最佳实践
(1) 安全习惯清单
| 习惯 | 原因 | 做法 |
|---|---|---|
| 先 git init | 方便回退 | 每个项目都用 git 管理 |
| 小步提交 | 减少回退损失 | 每完成一个功能就 commit |
| 看清确认 | 避免误操作 | 不要无脑按 y |
| 用 /diff 检查 | 了解变更 | 每次大操作后检查 |
| 避免生产项目 | 降低风险 | 先在测试项目练习 |
(2) 任务描述技巧
TEXT
📖 仅展示
# 差的描述
> 帮我改改代码
# 好的描述
> 在 src/auth/jwt.ts 中添加 token 刷新逻辑,
> 过期时间设为 7 天,需要写对应的单元测试
# 更好的描述(带约束)
> 重构 UserService 的查询方法:
> 1. 使用 Repository 模式替代直接 SQL
> 2. 添加分页支持(默认每页 20 条)
> 3. 写集成测试
> 4. 不要修改接口签名
6. 综合示例:完整首次体验
BASH
# Alice 的首次 Claude Code 体验
# 1. 准备项目
mkdir todo-app && cd todo-app
git init
npm init -y
# 2. 启动 Claude Code
claude "创建一个简单的 Node.js TODO 应用:
1. 支持添加、删除、列出任务
2. 数据存储在 JSON 文件中
3. 包含完整的单元测试
4. 使用 ES Module 语法"
# Claude Code 工作过程:
# → Reading package.json
# → Creating src/todo.js (TODO 核心逻辑)
# → Creating src/storage.js (JSON 文件存储)
# → Creating src/index.js (CLI 入口)
# → Creating tests/todo.test.js (单元测试)
# → Running: npm test → 8/8 passed ✓
# → Creating README.md
# 3. 检查结果
git add -A && git commit -m "feat: initial todo app by Claude Code"
# 4. 追加需求
claude "添加任务优先级功能(high/medium/low),更新测试"
# Claude Code 继续迭代...
❓ 常见问题
Q 首次启动很慢怎么办?
A 首次启动会加载项目上下文,大项目可能需要 10-30 秒。后续交互会快很多。
Q 按错确认了怎么办?
A 立即用
git checkout . 回退,或在 Claude Code 中说"回退上一步修改"。Q Claude Code 改坏了代码怎么办?
A 这是 git 存在的意义。
git diff 查看变更,git checkout . 回退。始终在 git 管理下使用。Q 每次都要确认很烦,能自动吗?
A 可以。选择
a (always allow) 让特定文件自动通过,或在 CLAUDE.md 中配置权限策略。Q 能撤销一整个会话的修改吗?
A 可以。如果会话开始前有 git commit,
git reset --soft HEAD~1 可回退到会话前状态。Q 如何让 Claude Code 更听话?
A 指令越具体越好。写清楚要做什么、不要做什么、约束条件。模糊指令导致模糊结果。
📖 小节
- 在项目目录下运行
claude启动,建议用 git 管理项目 - 文件修改和命令执行需要确认,选择
a可自动放行 - 用
/diff和git diff查看变更,git checkout .回退 - 任务描述要具体:做什么 + 约束 + 预期结果
- 首次使用在简单项目上练习,养成安全习惯
📝 作业
- 基础题(难度⭐):创建一个空项目,用 Claude Code 生成一个 Hello World 应用,确认运行成功。
- 进阶题(难度⭐⭐):让 Claude Code 添加一个功能,然后用
/diff查看变更,再手动回退其中一个文件的修改。 - 挑战题(难度⭐⭐⭐):给 Claude Code 一个模糊指令和一个精确指令,对比两者结果的差异,总结任务描述的最佳实践。