目标：掌握 Claude Code 的核心命令，提高使用效率
预计时间：20 分钟
对应官方文档：Commands、CLI Reference
命令使用流程图
以下是在一次开发任务中你可能使用命令的完整流程：
命令格式
Claude Code 的命令以 / 开头：
> /command [参数]
按 Tab 可以自动补全命令。
会话管理
| 命令 | 作用 | 示例 |
|---|---|---|
/exit | 退出当前会话 | /exit |
/new | 开启新会话 | /new |
/clear | 清空当前对话历史 | /clear |
/compact | 压缩对话历史（节省 token） | /compact |
/rename | 重命名会话 | /rename 修复登录bug |
/resume | 恢复之前的会话 | /resume |
会话恢复技巧
# 继续上次的会话
claude --continue
# 继续特定会话（通过名称或 ID）
claude --continue "修复登录bug"
# 查看所有会话
claude --list-sessions文件操作
| 命令 | 作用 | 示例 |
|---|---|---|
/add | 将文件添加到上下文 | /add src/utils.py |
/drop | 从上下文中移除文件 | /drop src/temp.py |
/read | 读取文件内容 | /read README.md |
/edit | 编辑指定文件 | /edit config.json |
通配符支持
> /add src/**/*.py # 添加所有 Python 文件
> /add tests/test_*.py # 添加测试文件
代码分析
| 命令 | 作用 | 示例 |
|---|---|---|
/search | 搜索代码 | /search "TODO" |
/grep | 正则搜索 | /grep "class.*View" |
/find | 查找文件 | /find "*.config.js" |
/explain | 解释代码 | /explain src/auth.py |
执行与测试
| 命令 | 作用 | 示例 |
|---|---|---|
/test | 运行测试 | /test 或 /test tests/unit |
/lint | 运行代码检查 | /lint |
/build | 构建项目 | /build |
/run | 运行指定命令 | /run python manage.py migrate |
信息与诊断
| 命令 | 作用 | 示例 |
|---|---|---|
/help | 查看帮助 | /help |
/context | 查看当前上下文 | /context |
/cost | 查看 token 消耗 | /cost |
/doctor | 诊断配置问题 | /doctor |
/version | 显示版本 | /version |
模式切换
| 命令 | 作用 |
|---|---|
/mode | 查看当前模式 |
/mode ask | 切换到询问模式 |
/mode auto-edits | 切换到自动编辑模式 |
/mode auto | 切换到全自动模式 |
Git 集成
| 命令 | 作用 | 示例 |
|---|---|---|
/git | 运行 git 命令 | /git status |
/git diff | 查看修改 | /git diff |
/git commit | 提交更改 | /git commit -m "修复bug" |
快捷操作
键盘快捷键
| 快捷键 | 作用 |
|---|---|
Ctrl+C | 中断当前操作 |
Ctrl+D | 退出会话 |
Shift+Enter | 输入多行文本 |
Tab | 命令补全 |
↑ / ↓ | 浏览历史输入 |
Ctrl+R | 搜索历史命令 |
特殊输入
> !ls -la # 直接运行 shell 命令
> @src/main.py # 快速引用文件
> # 这是注释 # 被忽略，不发送给 AI
实用技巧
1. 多行输入
按 Shift+Enter 换行：
> 请帮我完成以下任务：
> 1. 读取 config.py
> 2. 添加数据库连接池配置
> 3. 更新对应的测试
2. 粘贴代码块
直接粘贴，Claude 会自动识别：
> 这个函数有bug，请修复：
> def divide(a, b):
> return a / b
3. 引用文件
用 @ 快速引用文件：
> 请解释 @src/utils.py 中的 helper 函数
4. 撤销操作
如果 Claude 的修改不满意：
# 终端中运行
git checkout -- . # 撤销所有修改
git reset HEAD~1 # 撤销最后一次提交或使用 Claude 的 checkpoint 功能：
> /checkpoint list # 查看检查点
> /checkpoint restore 3 # 恢复到检查点 3
更多代码示例
示例 1：使用 /add 构建精确的代码审查上下文
> /add src/api.py
> /add src/auth.py
> /add tests/test_api.py
> /context
/context 会显示当前已加载的文件列表，确保你只审查相关代码：
Current context (3 files):
- src/api.py (120 lines)
- src/auth.py (85 lines)
- tests/test_api.py (200 lines)
然后你可以精确提问：
> 请审查 src/api.py 中的 login 端点，重点关注 SQL 注入风险
示例 2：使用 /search 和 /grep 组合定位问题
> /search "TODO"
Found 5 matches in 3 files:
src/app.py:42 # TODO: add rate limiting
src/utils.py:18 # TODO: handle timeout
...
> /grep "class.*View.*API"
Found 3 matches:
src/views.py:10 class UserAPIView(View):
src/views.py:45 class OrderAPIView(View):
src/views.py:90 class ProductAPIView(View):
示例 3：使用 /run 执行自定义构建脚本
> /run python -m pytest tests/unit -v --tb=short
> /run mypy src/ --ignore-missing-imports
> /run black --check src/ tests/
Claude 会将这些命令的输出纳入上下文，如果报错会主动帮你分析修复。
实战场景
场景 1：快速定位并修复一个跨文件的配置不一致问题
背景：项目中有 3 个环境配置文件（config/dev.py、config/staging.py、config/prod.py），你发现 DATABASE_TIMEOUT 在 dev 和 staging 中是 30，但在 prod 中是 10，需要统一为 30 并确认没有遗漏。
操作步骤：
- 在 Claude Code 中搜索相关配置：
输出：
> /grep "DATABASE_TIMEOUT" config/config/dev.py: DATABASE_TIMEOUT = 30 config/staging.py: DATABASE_TIMEOUT = 30 config/prod.py: DATABASE_TIMEOUT = 10 - 读取 prod 配置文件确认上下文：
> /read config/prod.py - 让 Claude 修复并确认一致性：
> 把 config/prod.py 中的 DATABASE_TIMEOUT 从 10 改为 30， > 然后搜索整个项目是否还有其他地方不一致。 - Claude 修改
config/prod.py并自动执行：确认所有出现的位置都一致为 30。> /grep "DATABASE_TIMEOUT" .
预期结果：3 个环境配置文件中的 DATABASE_TIMEOUT 统一为 30，零遗漏，无需手动打开每个文件。
场景 2：会话管理实战——从崩溃中恢复工作
背景：你正在一个复杂重构会话中，Claude Code 因网络中断意外退出，你担心之前的上下文和修改丢失。
操作步骤：
- 重新打开终端，进入项目目录：
cd ~/my-project - 查看可用的历史会话：
claude --list-sessionsSessions: 1. 重构用户模块 (2 hours ago) 2. 修复支付bug (yesterday) 3. 添加日志功能 (3 days ago) - 恢复之前的会话：
claude --continue "重构用户模块"> /resume - 检查之前的上下文是否保留：
确认之前
> /context/add的文件仍然在上下文中。 - 查看之前的修改状态：
确认之前的文件修改都已保存。
> /git diff - 继续工作：
> 刚才我们在重构 UserService，请继续把 validate_email 方法提取出去
预期结果：会话完整恢复，上下文、文件修改、对话历史全部保留，可以从断点继续工作，无需重新解释需求。
命令速查卡
保存这个，贴在显示器旁边：
会话: /exit /new /clear /compact /resume
文件: /add /drop /read /edit
搜索: /search /grep /find /explain
执行: /test /lint /build /run
信息: /help /context /cost /doctor
模式: /mode ask|auto-edits|auto
Git: /git status /git diff /git commit
快捷: Ctrl+C(中断) Shift+Enter(换行) ↑(历史)