Claude Code 快捷键完全指南
Claude Code 是 Anthropic 推出的终端 AI 编程助手,掌握其快捷键能显著提升开发效率。本文档整理了常用快捷键、模式切换方法以及实用使用方案。
一、基础快捷键
会话控制
| 快捷键 | 功能描述 |
|---|
Ctrl + C | 取消当前输入或生成 |
Ctrl + D | 退出 Claude Code 会话 |
Ctrl + L | 清屏(保留对话历史) |
Ctrl + O | 切换详细输出模式(显示工具使用详情) |
Ctrl + B | 将后台运行的 Bash 命令和 Agent 置于后台 |
Esc | 停止 Claude 当前操作 |
Esc 双击 | 回退代码/对话(恢复到之前的状态点) |
输入编辑
Claude Code 支持标准的 Bash 编辑快捷键:
| 快捷键 | 功能描述 |
|---|
↑ / ↓ | 浏览命令历史(召回之前的输入) |
Ctrl + R | 反向搜索命令历史 |
Ctrl + A | 光标跳到行首 |
Ctrl + E | 光标跳到行尾 |
Alt + B / Option + B | 光标后退一个单词 |
Alt + F / Option + F | 光标前进一个单词 |
Ctrl + W | 删除光标前的单词 |
Ctrl + K | 删除光标到行尾的内容(可粘贴) |
Ctrl + U | 删除整行(可粘贴) |
Ctrl + Y | 粘贴删除的内容 |
Alt + Y | 循环粘贴历史 |
多行输入
| 快捷键 | 功能描述 |
|---|
Shift + Enter | 换行(不发送命令) |
Option + Enter (macOS) | 换行 |
\ + Enter | 快速换行转义 |
Ctrl + J | 插入换行符 |
粘贴图片
| 快捷键 | 功能描述 |
|---|
Ctrl + V / Cmd + V (iTerm2) / Alt + V (Windows) | 从剪贴板粘贴图片 |
二、模式切换快捷键
权限模式切换
| 快捷键 | 功能描述 |
|---|
Shift + Tab / Alt + M | 切换权限模式(自动接受 / 计划模式 / 正常模式) |
模型切换
| 快捷键 | 功能描述 |
|---|
Option + P (macOS) / Alt + P (Windows/Linux) | 不清空提示词切换模型 |
Option + T (macOS) / Alt + T (Windows/Linux) | 切换扩展思考模式 |
其他模式
| 快捷键 | 功能描述 |
|---|
Ctrl + T | 切换代码块语法高亮(在 /theme 菜单中有效) |
Esc | 从插入模式进入普通模式(Vim 模式) |
← / → | 在权限对话框和菜单中循环切换选项卡 |
三、Vim 模式快捷键
Claude Code 支持完整的 Vim 编辑模式,按 Esc 进入 NORMAL 模式。
光标移动
| 快捷键 | 功能描述 |
|---|
H | 向左移动 |
J | 向下移动 |
K | 向上移动 |
L | 向右移动 |
W | 下一个单词 |
E | 单词末尾 |
B | 上一个单词 |
0 | 行首 |
$ | 行尾 |
^ | 第一个非空字符 |
G G | 输入开头 |
Shift + G | 输入末尾 |
插入模式
| 快捷键 | 功能描述 |
|---|
I | 在光标前插入 |
Shift + I | 在行首插入 |
A | 在光标后插入 |
Shift + A | 在行尾插入 |
O | 在下方新建行 |
Shift + O | 在上方新建行 |
删除操作
| 快捷键 | 功能描述 |
|---|
X | 删除字符 |
D D | 删除整行 |
Shift + D | 删除到行尾 |
D W | 删除单词 |
D E | 删除到单词末尾 |
D B | 向后删除单词 |
修改操作
| 快捷键 | 功能描述 |
|---|
C C | 修改整行 |
Shift + C | 修改到行尾 |
C W | 修改单词 |
C E | 修改到单词末尾 |
C B | 向后修改单词 |
复制粘贴
| 快捷键 | 功能描述 |
|---|
Y Y | 复制(Yank)整行 |
Y W | 复制单词 |
P | 在光标后粘贴 |
Shift + P | 在光标前粘贴 |
其他操作
| 快捷键 | 功能描述 |
|---|
> > | 缩进行 |
< < | 取消缩进行 |
Shift + J | 合并行 |
. | 重复上次修改 |
四、斜杠命令(Slash Commands)
在 Claude Code 中输入 / 可触发斜杠命令,以下是常用命令:
会话管理
| 命令 | 功能描述 |
|---|
/clear | 清除对话历史和上下文 |
/exit | 退出 REPL |
/resume | 恢复之前的会话 |
/compact 【说明】 | 压缩对话历史(可选说明) |
配置与帮助
| 命令 | 功能描述 |
|---|
/help | 显示可用命令 |
/config | 打开配置面板 |
/doctor | 检查 Claude Code 安装状态 |
/init | 初始化项目(创建 CLAUDE.md) |
模型切换
| 命令 | 功能描述 |
|---|
/model opus | 切换到 Claude 3 Opus(最强推理) |
/model sonnet | 切换到 Claude 3.5 Sonnet(性价比) |
IDE 集成
| 命令 | 功能描述 |
|---|
/ide vscode | 配置 VS Code 集成 |
/ide configure | 设置 IDE 配置 |
五、特殊输入语法
| 符号 | 用法 | 示例 |
|---|
/ | 斜杠命令 | /clear |
! | Bash 模式(直接运行命令) | ! git status |
@ | 文件路径提及(触发自动补全) | @src/utils.ts |
六、常用使用方案
方案 1:快速启动与恢复
claude
/resume 继续处理昨天的登录功能
/help
方案 2:多文件协作开发
重构 @AuthService.ts 并确保 @UserController.ts 使用新方法
请分析 @utils.ts @config.ts @types.ts 之间的关系
方案 3:任务队列处理
优化 @Checkout.tsx 的状态管理
同时为 @Checkout.test.tsx 添加集成测试
然后更新文档说明
方案 4:权限管理
# 启动时跳过所有权限确认(谨慎使用)
claude --dangerously-skip-permissions
# 允许特定工具无需确认
claude --allowedTools "Bash(git log:*)" "Bash(git diff:*)" "Write"
# 禁止特定工具
claude --disallowedTools "Bash(rm:*)" "Bash(sudo:*)"
在项目根目录创建 CLAUDE.md 文件,存储项目规范:
# CLAUDE.md
- 始终使用 Tailwind CSS 进行样式编写
- 运行 `npm run lint` 后再提交更改
- 使用 Jest 进行测试
- 遵循 Airbnb ESLint 规则
使用 /init 命令可以快速创建此文件。
方案 6:无头模式(脚本自动化)
claude -p "分析代码" --output-format json
claude -p "大任务" --output-format stream-json
claude -p --max-turns 1 "快速查询"
方案 7:自定义命令
在 .claude/commands/ 目录创建自定义命令文件:
# .claude/commands/tests/add-unit.md
为给定文件生成 Jest 单元测试,覆盖成功和失败场景。
然后在 Claude Code 中使用:
/tests add-unit @CartService.ts
七、Plan / Act / Review 工作模式详解
Claude Code 提供了三种权限模式,支持 Plan(规划)→ Act(执行)→ Review(审查) 的完整工作流程:
7.1 三种模式介绍
| 模式 | 底部指示器 | 功能特点 | 适用场景 |
|---|
| **Plan Mode ** 规划模式 | ⏸ plan mode on | 只读分析,不修改文件 生成结构化计划 | 探索代码库 规划复杂任务 安全审查代码 |
| **Normal Mode ** 正常模式 | 无特殊指示 | 每次编辑/执行都需确认 | 精细控制每一步 审查后执行 |
| **Auto-Accept Mode ** 自动接受模式 (执行模式) | ⏵⏵ accept edits on | 自动接受文件编辑 无需逐次确认 | 快速执行已知任务 批量修改 |
7.2 模式切换方法
快捷键切换(Shift + Tab 循环)
Normal Mode → Shift+Tab → Auto-Accept Mode → Shift+Tab → Plan Mode
↓
(有 Agent 团队时)
Delegate Mode
操作示例:
- 进入 Plan Mode:按
Shift + Tab 两次(从 Normal → Auto-Accept → Plan)
- 退出 Plan Mode:再按
Shift + Tab 回到其他模式
- 快速切换:在 Plan Mode 中按
Shift + Tab 选择 “auto-accept edits” 选项(v2.1.2+)
命令行启动时指定模式
claude --permission-mode plan
claude -p "分析代码架构" --permission-mode plan
斜杠命令切换
/plan
7.3 Plan Mode(规划模式)详解
Plan Mode 是 Claude Code 最强大的功能之一,它强制 Claude 先思考分析,后执行操作。
Plan Mode 的工作流程
用户描述任务
↓
Claude 分析代码库(只读操作)
↓
Claude 提出澄清问题(AskUserQuestion)
↓
Claude 生成结构化计划(plan.md)
↓
用户审查和编辑计划
↓
切换到 Act Mode 执行
Plan Mode 可用工具
✅ 可用工具(只读):
Read - 读取文件
Search - 搜索代码
GrepSearch - 正则搜索
List - 列出目录
GitLog - 查看 Git 历史
AskUserQuestion - 询问用户
❌ 禁用工具(防止误操作):
Write / Edit - 文件写入/编辑
Bash - 执行命令
NotebookEdit - 笔记本编辑
Plan Mode 使用示例
场景 1:复杂重构的规划
[Plan Mode 开启]
我:重构认证模块以支持 JWT
Claude:我来分析当前认证实现...
(读取 @AuthService.ts, @UserController.ts 等文件)
Claude:我有几个问题:
1. 您希望使用同步还是异步 JWT 验证?
2. 刷新令牌策略是什么?
3. 是否需要向后兼容旧会话?
我:1. 异步 2. 滑动窗口 7 天 3. 不需要
Claude:生成 plan.md:
- 安装 jsonwebtoken 和 @types/jsonwebtoken
- 创建 JwtService.ts
- 重构 AuthService.ts 的 validateUser 方法
- 更新 UserController.ts 的登录端点
- 更新 auth.service.spec.ts
- 添加 jwt.service.spec.ts
- JwtService ← AuthService ← UserController
我:(审查计划,确认或修改)
Shift+Tab 切换到 Auto-Accept Mode 执行
场景 2:代码审查
[Plan Mode 开启]
我:审查 @PaymentGateway.ts 的安全性
Claude:(分析代码,生成审查报告)
1. [高危] 第 45 行:API 密钥硬编码
2. [中危] 第 78 行:未验证回调签名
3. [低危] 第 120 行:缺少超时设置
1. 使用环境变量存储 API 密钥
2. 添加 HMAC 签名验证
3. 设置 30 秒请求超时
我:(审查报告,决定哪些需要修复)
7.4 Opus Plan Mode(增强版规划)
Claude Code v2.1+ 提供了 Opus Plan Mode,结合 Opus 4.6 的 1M 上下文,适合大规模代码库的规划。
特点:
- 使用 Opus 4.6 进行规划和分析
- 执行时使用 Sonnet 4.5(更快更便宜)
- 支持 1M token 上下文(分析整个大型代码库)
激活方式:
/model
选择选项 4: "Use Opus in plan mode, Sonnet 4.5 otherwise"
7.5 完整工作流:Plan → Act → Review
┌─────────────────────────────────────────────────────────────┐
│ PLAN 规划阶段 │
│ 1. Shift+Tab 进入 Plan Mode │
│ 2. 描述任务:"实现用户角色权限系统" │
│ 3. Claude 分析代码库并生成 plan.md │
│ 4. 审查计划,回答澄清问题 │
│ 5. 确认计划 │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ ACT 执行阶段 │
│ 1. Shift+Tab 切换到 Auto-Accept Mode │
│ 2. 说:"执行刚才的计划" │
│ 3. Claude 自动完成所有文件修改 │
│ 4. 必要时暂停切换回 Normal Mode 精细控制 │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ REVIEW 审查阶段 │
│ 1. Shift+Tab 回到 Plan Mode │
│ 2. 说:"审查刚才的修改,检查是否有 Bug" │
│ 3. Claude 只读分析修改内容 │
│ 4. 生成审查报告 │
│ 5. 如有问题,在 Normal Mode 中修复 │
└─────────────────────────────────────────────────────────────┘
7.6 模式组合使用技巧
| 工作场景 | 推荐模式组合 |
|---|
| 探索陌生代码库 | Plan Mode 全程 |
| 规划大型功能 | Plan → Auto-Accept → Plan(审查) |
| 快速 Bug 修复 | Normal Mode 或 Auto-Accept |
| 代码审查 | Plan Mode |
| 重构 | Plan → Auto-Accept → Plan(验证) |
| 学习代码 | Plan Mode + 提问 |
八、效率技巧总结
- 定期清理上下文:开始新任务前使用
/clear,避免上下文膨胀影响性能
- 善用 @ 引用:需要 Claude 查看特定文件时,使用
@文件名 快速引用
- 会话恢复:使用
/resume 跨天工作,无需重复说明背景
- 模型选择:日常开发用默认的 Sonnet,复杂任务手动切换到 Opus
- Vim 模式:习惯 Vim 的用户可以全程使用
Esc 进入 NORMAL 模式进行高效编辑
- 模式切换:
Shift + Tab 快速在 Plan/Normal/Auto-Accept 模式间切换
- Plan First:复杂任务务必先使用 Plan Mode 规划,避免意外修改
- 历史导航:使用
↑/↓ 快速召回之前的命令,比重新输入更高效
- Opus Plan Mode:大型项目使用
/model 选择 Opus Plan Mode,发挥 1M 上下文优势
- 思考模式:按
Option/Alt + T 切换扩展思考模式,复杂问题更深推理
参考资源
本文使用 markdown.com.cn 排版