Claude Code: Claude Code 第一次使用

最后更新:2026-08-31

第一次使用 Claude Code,就像第一次雇了一个超强助手——你需要知道怎么下达指令、怎么确认操作、怎么修正方向。

💡 提示:首次使用建议在简单项目上练习,避免直接在重要生产项目中操作。Claude Code 会修改文件,虽然可以回退,但养成安全习惯很重要。

📋 前置知识:第三章 API 配置与模型选择

1. 你将学到


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

已完成:


---

## 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 指令越具体越好。写清楚要做什么、不要做什么、约束条件。模糊指令导致模糊结果。

📖 小节


📝 作业

  1. 基础题(难度⭐):创建一个空项目,用 Claude Code 生成一个 Hello World 应用,确认运行成功。
  2. 进阶题(难度⭐⭐):让 Claude Code 添加一个功能,然后用 /diff 查看变更,再手动回退其中一个文件的修改。
  3. 挑战题(难度⭐⭐⭐):给 Claude Code 一个模糊指令和一个精确指令,对比两者结果的差异,总结任务描述的最佳实践。
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏