Claude Code 教程

第一次对话

启动 Claude Code

安装并完成认证后，使用 Claude Code 非常简单。打开终端，进入你想要工作的项目目录，然后输入：

Terminal window
cd ~/my-project
claude

Claude Code 会启动交互式界面，你会看到类似如下的欢迎信息：

╭────────────────────────────────────────╮
│ ✻ Welcome to Claude Code!              │
│                                        │
│   /help for available commands         │
╰────────────────────────────────────────╯

此时，你已经进入了一个与 Claude 的实时对话会话。

💡

提示

建议在项目根目录下启动 Claude Code。它会自动识别当前目录结构，从而更好地理解你的项目上下文。

理解交互界面

Claude Code 的交互界面是一个基于终端的对话环境。它的核心特点包括：

  • 对话式交互：你用自然语言描述需求，Claude 会理解并执行
  • 项目感知：Claude 能够读取当前目录下的文件，理解代码结构
  • 工具调用：Claude 可以读取文件、编辑代码、执行命令等
  • 上下文保持：在同一个会话中，Claude 会记住之前的对话内容

界面底部会显示输入提示符，你可以直接输入问题或指令。

提出你的第一个问题

让我们从一些简单的问题开始。在提示符中输入：

这个项目是做什么的？

Claude 会自动扫描项目目录中的关键文件（如 README.md、package.json、主要源代码文件等），然后给你一个项目概述。

再尝试一些其他问题：

项目的目录结构是怎样的？
帮我找到主入口文件在哪里
这个项目用了哪些主要的依赖？
ℹ️

信息

你不需要使用任何特殊语法或命令格式。像和同事聊天一样，用自然语言描述你想了解或想做的事情就可以了。

Claude Code 如何读取文件

当你提问时，Claude Code 会根据需要自动读取相关文件。例如，当你问”解释一下 src/index.ts 的逻辑”时，Claude 会：

  1. 使用文件读取工具打开 src/index.ts
  2. 阅读文件内容
  3. 结合上下文给出解释

你可以在终端中看到 Claude 正在执行的操作，例如：

⏺ Reading file: src/index.ts

Claude 也可以搜索文件。例如你可以说：

找到所有使用了 useState 的组件

Claude 会使用搜索工具在项目中查找匹配的文件和代码片段。

Claude Code 如何修改文件

除了读取，Claude Code 还可以帮你修改代码。试试看：

在 src/utils.ts 中添加一个计算两个数之和的函数

Claude 会生成修改方案，并在终端中展示具体的修改内容（diff 格式），例如：

export function add(a: number, b: number): number {
  return a + b;
}

权限系统

Claude Code 内置了一套权限保护机制。当它需要执行可能影响你项目的操作时，会先征求你的许可。

文件编辑权限

当 Claude 要修改文件时，你会看到类似的提示：

Claude wants to edit src/utils.ts
Allow? (y/n/always)

你有以下选择：

  • y（是）：允许本次操作
  • n（否）：拒绝本次操作
  • always（总是允许）：允许当前会话中所有同类操作

命令执行权限

当 Claude 需要在终端中执行命令（如安装依赖、运行测试等）时，同样会请求许可：

Claude wants to run: npm install lodash
Allow? (y/n/always)
⚠️

注意

在允许 Claude 执行命令之前，请仔细查看命令内容。虽然 Claude 通常会生成安全的命令，但了解将要执行的操作始终是一个好习惯。

权限模式

Claude Code 提供了不同的权限模式来适应不同场景：

  • 默认模式：每次文件修改和命令执行都需要确认
  • 宽松模式：可以通过 --dangerously-skip-permissions 标志跳过权限确认（仅建议在安全的沙盒环境中使用）

使用 /help 查看可用命令

在交互界面中，输入 /help 可以查看所有可用的斜杠命令：

/help

你会看到一个命令列表，包括：

命令说明
/help显示帮助信息
/clear清除当前对话历史
/compact压缩对话上下文
/cost显示当前会话的 token 使用量
/status显示当前状态
/memory编辑记忆文件

我们将在下一节详细介绍所有命令。

退出会话

当你完成工作后，有几种方式可以退出 Claude Code：

  • 输入 /exit 命令
  • 按 Ctrl + C 两次
  • 按 Ctrl + D（发送 EOF 信号）
/exit

退出后，你会回到普通的终端界面。

ℹ️

信息

退出会话后，当前的对话历史默认不会保留。下次启动 Claude Code 时会开始新的对话。如果需要恢复上一次的对话，可以使用 claude --continue 或 claude -c 来继续上次的会话。

实战练习

为了巩固所学内容，建议你完成以下练习：

  1. 启动并提问：进入一个现有项目，启动 Claude Code，让它解释项目结构
  2. 文件查询：让 Claude 找到某个特定的函数或配置
  3. 简单修改：让 Claude 在代码中添加一条注释，体验权限确认流程
  4. 查看帮助：输入 /help 浏览所有可用命令
  5. 退出：使用 /exit 退出会话

下一步

现在你已经掌握了 Claude Code 的基本交互方式。下一节我们将深入了解各种命令和参数，让你能够更高效地使用 Claude Code。

评论与讨论