5. 第一次使用

准备一个项目目录

Claude Code 需要在项目目录里运行，这样才能读你的代码、改你的文件。如果你手头没有现成项目，建一个练习用的就行：

mkdir my-first-project
cd my-first-project

随便创建一个文件，让 Claude 有东西可以看：

# 创建一个简单的 Python 文件
cat > main.py << 'EOF'
def add(a, b):
    return a + b

def multiply(a, b):
    return a * b
EOF

启动 Claude Code

在项目目录里输入：

claude

你会看到 Claude Code 的提示符，上面显示了版本号、当前模型和工作目录。大致长这样：

╭─────────────────────────────────────╮
│ ✅ Claude Code          v2.1.220    │
│    Model: Opus 5                    │
│    Workspace: /path/to/project      │
╰─────────────────────────────────────╯
>

发送第一条消息

先问一个简单的问题，让 Claude 熟悉一下你的项目：

what does this project do?

或者用中文也行：

这个项目是做什么的？

Claude 会自动读取当前目录下的文件，分析后给你一个摘要。你不需要手动告诉它去读哪个文件——它自己会找。

几个好的开场问题

刚接手一个新项目时，这些问题很实用：

# 了解项目结构
explain the folder structure

# 了解技术栈
what technologies does this project use?

# 找入口点
where is the main entry point?

# 了解架构
explain the main architecture patterns used here

经验之谈：从宽泛的问题开始，再逐步缩小到具体细节。先问「整体做什么」，再问「这个模块怎么实现的」，最后问「帮我改这一行」。

查看 Claude 的分析结果

Claude 的回答会直接显示在终端里。如果它读了文件，你会看到类似这样的过程提示：

● Read(main.py)
  ⎿  Read 5 lines

● 这个项目包含两个简单的数学函数：
  - add(a, b)：返回两个数的和
  - multiply(a, b)：返回两个数的乘积

你看到的只是摘要。文件的具体内容进了 Claude 的上下文窗口（Context Window），但不会全部打印到终端。

让 Claude 改代码

光看不动手没意思，试试让 Claude 直接改代码：

给 add 函数增加类型注解，并补充基本的错误处理

Claude 会走这样的流程：

1. 找到目标文件（这里是 main.py）
2. 分析现有代码
3. 生成修改建议
4. 请求你的批准
5. 你确认后，执行编辑

你会看到一个差异对比（Diff），展示改了什么：

● Edit(main.py)
  ⎿ 旧代码：
      def add(a, b):
          return a + b

    新代码：
      def add(a: int, b: int) -> int:
          if not isinstance(a, int) or not isinstance(b, int):
              raise TypeError("参数必须是整数")
          return a + b

  接受这个修改？(y/n)

输入 y 确认，修改就写入了文件。

三种指令类型

你给 Claude 的指令大致分三类：

解释型——只看不改：

解释 main.py 这个文件在做什么
这段代码为什么在高并发下可能出问题？

修改型——动手改代码：

帮我把这个函数拆分成多个小函数
把登录接口的响应码从 200 改为 201

生成型——创建新内容：

补一个测试用例
增加日志输出
给这个函数写 JSDoc 注释

用 Git 做检查点回滚

Claude Code 有一个很实用的安全网：每次你发送消息时，它都会自动创建一个 Git 检查点（Checkpoint）。如果 Claude 改错了，你可以回退到之前的状态。

回退操作

按两次 Esc 键（即 Esc + Esc），会弹出回退菜单：

┌─ Rewind ───────────────────────────────┐
│ ○ 回退到上一条消息之前                   │
│ ○ 回退到更早的某个检查点                 │
│ ○ 总结当前对话并重新开始                 │
└────────────────────────────────────────┘

选择回退后，Claude 会把文件恢复到那个时间点的状态，对话也会截断到那里。

Git 对话式操作

Claude Code 让 Git 操作变得像聊天一样：

# 查看改了什么
我更改了哪些文件？

# 提交
用描述性消息提交我的更改

# 创建分支
创建一个名为 feature/auth 的新分支

# 查看历史
显示我最后的 5 次提交

# 解决冲突
帮我解决合并冲突

你不用记 Git 命令的语法，用自然语言描述你想做什么就行。

一次完整的流程示范

把前面的步骤串起来，一次典型的使用流程是这样的：

第一步：探索

解释 main.py 这个文件在做什么，用新手能理解的方式说明

Claude 读取文件，给出解释。

第二步：规划

我想给这个函数增加类型注解和错误处理，你打算怎么做？

Claude 给出修改方案，但不动手。

第三步：执行

按计划执行吧

Claude 修改文件，展示 Diff 供你确认。

第四步：验证

帮我跑一下测试

Claude 执行测试命令，报告结果。

第五步：提交

提交这些更改

Claude 生成 commit message 并提交。

常见的新手问题

权限报错

Mac 或 Linux 上可能遇到权限问题：

Error: EACCES: permission denied, open ~/.claude/...

修复方法：

# 修复 .claude 目录的所有权和权限
sudo chown -R $(whoami) ~/.claude
chmod -R 755 ~/.claude

输入多行文本

在终端里想输入多行内容，有几种方法：

方法	快捷键	适用场景
反斜杠转义	\ + Enter	所有终端通用
Shift+Enter	Shift+Enter	iTerm2、Windows Terminal 等
Ctrl+J	Ctrl+J	所有终端通用，无需配置
粘贴	直接粘贴	适合贴代码块或日志

想中途打断 Claude

按 Esc 键可以中断 Claude 正在进行的操作。Claude 会保留已经完成的工作，不会丢失已有结果。

基本命令速查

日常使用中最常用的命令：

Shell 命令（在终端里输入）：

命令	功能	示例
claude	启动交互模式	claude
claude "任务"	运行一次性任务	claude "fix the build error"
claude -p "查询"	打印模式，输出后退出	claude -p "explain this function"
claude -c	继续最近的对话	claude -c
claude -r	恢复之前的对话	claude -r

会话命令（在 Claude Code 里面输入）：

命令	功能
/help	显示可用命令
/clear	清除对话历史
/exit 或 Ctrl+D	退出 Claude Code

小结

跑完这一章的流程，你应该能：

• 启动 Claude Code 并发送消息
• 让 Claude 分析你的代码
• 让 Claude 修改代码并确认 Diff
• 用 Esc + Esc 回退到检查点
• 用自然语言操作 Git

下一章我们会深入交互模式，看看有哪些快捷键和输入技巧能让你用得更顺手。