Claude Code 基础教程¶
完成安装配置后，本指南将带你学会如何高效使用 Claude Code。
一、工作模式¶
Claude Code 有四种工作模式，通过 Shift+Tab 快捷键循环切换：
| 模式 | 切换方式 | 状态栏显示 | 特点 | 适用场景 |
|---|---|---|---|---|
| Normal | 默认 | - | 每次操作需确认，安全可控 | 日常开发 |
| Auto-Accept | Shift+Tab 1 次 |
⏵⏵ accept edits on |
自动执行所有操作，按 Esc 停止 |
简单重复任务 |
| Plan | Shift+Tab 2 次 |
⏸ plan mode on |
只读模式，仅分析规划，阻止所有修改操作 | 复杂任务规划 |
| Bypass | 命令参数 | ⚠ bypass permissions on |
完全跳过所有权限确认，可直接删除文件 | ⚠️ 不推荐初学者 |
Bypass 模式：
claude --dangerously-skip-permissions⚠️ 危险：此模式无任何确认提示，仅适用于完全可控的环境或有版本控制保护的项目。
二、基础操作¶
文件引用：使用 @ 符号¶
@ 符号是引用文件的快捷方式，比自然语言描述更高效：
| 语法 | 功能 | 示例 |
|---|---|---|
@path/to/file.js |
引用文件，包含完整内容 | @src/utils/auth.js |
@path/to/directory/ |
引用目录，显示文件列表 | @src/components/ |
@file1.js @file2.js |
同时引用多个文件 | @config.json @.env |
优势：
无需等待搜索，支持 Tab 补全，可直接拖放文件
常见操作类型¶
| 操作类型 | 示例命令 |
|---|---|
| 读取文件 | @README.md / @src/main.py / @src/main.py 第 50-100 行 |
| 编辑文件 | @src/utils.js 把这里的 API_URL 改成 "https://api.example.com" |
| 创建文件 | 创建一个名为 config.json 的配置文件，包含数据库连接信息 |
| 解释代码 | 解释一下 src/core.py 的逻辑 / 第 45 行的 fetchData 函数是做什么的？ |
| 调试修复 | 用户注册时邮箱验证失败，怎么修复？ / [粘贴错误日志] 分析这个错误并修复 |
| 重构优化 | 重构 src/services/user.py，提高可读性 / 优化 data_processing.py 中的循环，减少计算时间 |
三、基础命令¶
重要提示
Claude Code 的核心是 自然语言对话，不需要记忆命令。直接用自然语言描述你的需求即可完成绝大多数任务。
初学者必备命令¶
| 命令 | 功能 |
|---|---|
/help |
查看所有可用命令和帮助信息 |
/clear |
清除当前对话历史，重新开始 |
/status |
查看当前状态（模型、版本、配置） |
其他内置命令（按需使用）¶
以下命令在特定场景下有用，但 初学者 不需要记忆：
| 类别 | 命令 | 功能 |
|---|---|---|
| IDE 集成 | /ide |
管理 IDE 集成并显示状态（如连接 VS Code） |
| 配置管理 | /config |
查看/修改配置 |
查看完整命令列表：
输入 /help 即可查看所有内置命令及其说明。
使用示例¶
# 获取帮助
/help
# 输出：所有可用命令列表
# 清除对话历史
/clear
# 作用：重新开始对话，清除上下文
# 查看当前状态
/status
# 输出：当前模型、API 配置、版本信息等
四、在 VS Code 中使用¶
Claude Code 提供两种方式在 VS Code 中使用：图形界面扩展 和 集成终端 CLI。
方式一：VS Code 扩展（图形界面）¶
安装扩展：
- 打开 VS Code，按
Cmd+Shift+X（Mac）或Ctrl+Shift+X（Windows/Linux） - 搜索 "Claude Code"
- 点击安装
特点：
- 原生图形界面，侧边栏显示对话
- 支持多标签页、多窗口同时对话
- 内联差异视图，直观显示代码修改
@引用文件时自动包含选中的行号
方式二：集成终端（CLI 模式，推荐）¶
在 VS Code 集成终端中运行：
优势：
- 完整的 CLI 功能（所有斜杠命令）
- 自动集成到 VS Code（diff 查看、诊断共享）
- 与扩展共享对话历史（可通过
claude --resume继续）
/ide 命令的用途¶
/ide 命令用于管理 IDE 集成：
| 场景 | 命令 | 说明 |
|---|---|---|
| 外部终端连接 VS Code | /ide |
将外部运行的 Claude Code 连接到 VS Code（用于 diff 显示） |
| 查看集成状态 | /ide |
显示当前 IDE 连接状态 |
如果在 VS Code 集成终端中运行
claude，会自动连接 IDE，无需手动执行/ide。
选择哪种方式？¶
| 需求 | 推荐方式 |
|---|---|
| 习惯图形界面，直观查看修改 | VS Code 扩展 |
| 需要完整 CLI 功能（如 MCP 配置） | 集成终端 |
五、实战指南¶
场景一：修复一个 Bug¶
问题：
用户报告登录功能返回 500 错误
你：@logs/error.log 查看最后 20 行
Claude：[显示错误日志]
你：这个错误指向哪个文件？
Claude：根据错误堆栈，问题在 @src/auth/login.py 第 42 行
你：修复这个问题
Claude：[分析问题并修复代码]
场景二：添加一个新功能¶
需求：
为 API 添加速率限制
你：当前项目使用什么框架？
Claude：[分析项目结构]
你：添加一个速率限制中间件，每分钟最多 100 个请求
Claude：[创建中间件文件并配置]
你：写一个测试来验证速率限制
Claude：[创建测试文件]
场景三：重构代码¶
目标：
改进代码质量
你：分析 @src/utils.py 的代码质量
Claude：[指出可改进的地方]
你：按照你提到的建议重构这个文件
Claude：[执行重构]
你：运行测试确保重构没有破坏功能
Claude：[执行测试并修复问题]
最佳实践要点¶
| 原则 | 说明 |
|---|---|
| 明确意图 | 与其说"看看这个"，不如说"分析这段代码的性能瓶颈" |
| 利用上下文 | Claude Code 记住对话内容，可基于之前的回答继续提问 |
| 分步处理 | 复杂任务拆分成小步骤，每步确认后再继续 |
| 验证结果 | 让 Claude 运行测试或检查结果，确保修改正确 |
| 使用 @ 引用 | 与其说"看看 src/auth.py"，不如直接输入 @src/auth.py |
| 学习建议 | Claude 常会提供最佳实践建议，留意这些提示 |
参考链接¶
| 名称 | 链接 |
|---|---|
| Claude Code 官方文档 | https://docs.anthropic.com/en/docs/claude-code/overview |
| Claude Code GitHub | https://github.com/anthropics/claude-code |