Claude Code 快捷键完全指南

2 阅读9分钟

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 Code
claude

# 恢复上次会话
/resume 继续处理昨天的登录功能

# 查看帮助
/help

方案 2:多文件协作开发

# 同时引用多个文件
重构 @AuthService.ts 并确保 @UserController.ts 使用新方法

# 添加文件到上下文
请分析 @utils.ts @config.ts @types.ts 之间的关系

方案 3:任务队列处理

# 队列多个任务,Claude 会自动依次执行
优化 @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:*)"

方案 5:记忆管理(CLAUDE.md

在项目根目录创建 CLAUDE.md 文件,存储项目规范:

# CLAUDE.md
- 始终使用 Tailwind CSS 进行样式编写
- 运行 `npm run lint` 后再提交更改
- 使用 Jest 进行测试
- 遵循 Airbnb ESLint 规则

使用 /init 命令可以快速创建此文件。

方案 6:无头模式(脚本自动化)

# JSON 输出用于脚本处理
claude -p "分析代码" --output-format json

# 流式 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

操作示例:

  1. 进入 Plan Mode:按 Shift + Tab 两次(从 Normal → Auto-Accept → Plan)
  2. 退出 Plan Mode:再按 Shift + Tab 回到其他模式
  3. 快速切换:在 Plan Mode 中按 Shift + Tab 选择 “auto-accept edits” 选项(v2.1.2+)
命令行启动时指定模式
# 以 Plan Mode 启动新会话
claude --permission-mode plan

# 无头模式(脚本)使用 Plan Mode
claude -p "分析代码架构" --permission-mode plan
斜杠命令切换
/plan    # 切换到 Plan Mode(v2.1.0+)

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. 滑动窗口 73. 不需要

Claude:生成 plan.md:
       ## 认证模块 JWT 重构计划
       
       ### 阶段 1: 依赖安装
       - 安装 jsonwebtoken 和 @types/jsonwebtoken
       
       ### 阶段 2: 核心实现
       - 创建 JwtService.ts
       - 重构 AuthService.ts 的 validateUser 方法
       - 更新 UserController.ts 的登录端点
       
       ### 阶段 3: 测试更新
       - 更新 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 + 提问

八、效率技巧总结

  1. 定期清理上下文:开始新任务前使用 /clear,避免上下文膨胀影响性能
  2. 善用 @ 引用:需要 Claude 查看特定文件时,使用 @文件名 快速引用
  3. 会话恢复:使用 /resume 跨天工作,无需重复说明背景
  4. 模型选择:日常开发用默认的 Sonnet,复杂任务手动切换到 Opus
  5. Vim 模式:习惯 Vim 的用户可以全程使用 Esc 进入 NORMAL 模式进行高效编辑
  6. 模式切换Shift + Tab 快速在 Plan/Normal/Auto-Accept 模式间切换
  7. Plan First:复杂任务务必先使用 Plan Mode 规划,避免意外修改
  8. 历史导航:使用 ↑/↓ 快速召回之前的命令,比重新输入更高效
  9. Opus Plan Mode:大型项目使用 /model 选择 Opus Plan Mode,发挥 1M 上下文优势
  10. 思考模式:按 Option/Alt + T 切换扩展思考模式,复杂问题更深推理

参考资源

本文使用 markdown.com.cn 排版