Claude Code 常用命令、快捷键、功能与技巧全解析

Claude Code 完全指南：命令、快捷键、功能与技巧全解析

一站式掌握 Claude Code 的核心用法，涵盖键盘快捷键、斜杠命令、CLI 启动参数、扩展系统、钩子自动化、权限模式等，助你开发效率倍增。

1. 键盘快捷键：指尖下的效率

Claude Code 提供了丰富的快捷键，让你无需离开键盘即可完成大部分操作。

基础操作

快捷键	功能
Enter	发送消息 / 提交指令
Esc	中断当前生成过程
Ctrl + C	打开功能菜单（在对话或代码中）
Ctrl + R	运行外部编辑器（可预设提示词）
Ctrl + E	退出 Claude Code
Shift + Tab	在权限模式间循环切换（自动接受/计划/普通）

导航与信息

快捷键	功能
Ctrl + R	搜索历史命令
Ctrl + L	切换可用工具列表的显示
Ctrl + \	切换侧边面板的显示
Ctrl + J	粘贴图片（显示为文件名）
Ctrl + K	显示当前正在编辑的提示词
Shift 或 Shift + F	打开模型选择器
Shift + T 或 Shift + ↓	切换"扩展思考"模式

编辑模式

快捷键	功能
Ctrl + A / Ctrl + E	光标跳转到行首 / 行尾
Opt + F / Opt + B	光标跳转到下一个 / 上一个单词
Ctrl + K	删除光标后所有内容（不发送）
↑ / ↓	浏览历史输入记录

扩展操作

快捷键	功能
Ctrl + Tab	将当前运行任务置于后台

提示：随时按下 Ctrl + Shift + ? 即可查看完整的快捷键列表。在代码块中按下 Esc 可以退出编辑状态而不发送消息。

2. 斜杠命令（Slash Commands）：快捷指令中心

在对话中输入 / 即可调出命令菜单，快速执行特定操作。

会话控制

命令	功能
/clear	清空当前对话历史，可选填清空原因
/compact [说明]	压缩对话历史以节省Token，可附加说明
/resume	恢复上一次意外中断的对话
/reset [说明]	回退到上一个"锚点"（ANCHOR）代码节点
/cost	显示当前会话的Token消耗和费用估算
/rate-limits	查看API使用频率限制
/convert	可视化展示Token消耗情况

配置管理

命令	功能
/config	打开设置面板
/permissions	查看和更新工具权限设置
/keyboardshortcuts	查看或编辑快捷键配置文件
/vim	切换Vim键位模式的开关
/terminal-setup	配置终端，使 `Shift+Enter` 更符合IDE习惯

工具与集成

命令	功能
/init	为当前项目创建 `CLAUDE.md` 记忆文件（首次使用必备）
/memory	查看并编辑 `CLAUDE.md` 中的项目记忆
/review	对当前代码进行审查分析
/doctor	运行环境检测与健康检查
/bug	报告一个Bug（Claude会引导你完成）
/agents	管理子代理（Sub-agents）
/mcp	管理MCP（Model Context Protocol）服务器

其他实用命令

命令	功能
/insights	生成HTML格式的使用报告（较新功能）
/pr_comments	查看来自GitHub PR的反馈
/install-github-app	配置GitHub应用以实现自动化PR审查
/tasks	管理持久化的任务列表
/teleport	在Web界面和本地终端之间传输会话

3. CLI 启动参数：命令行启动的艺术

通过命令行参数，你可以精确控制 Claude Code 的启动方式和行为。

启动模式

参数	功能
`claude`	启动一个交互式会话
`claude "你的查询"`	以指定的初始提示词直接启动
`claude -c`	继续上一次的对话
`claude -r <会话ID>`	通过指定ID恢复一个特定的历史会话
`claude -t`	启动一个与Git工作树关联的窗口

模型与行为控制

参数	功能
`--model sonnet`	指定使用Sonnet模型（可选 `haiku`, `opus`）
`--model spec`	使用Spec格式自定义模型
`--agent my-agent`	启动时加载指定的子代理
`--permission-mode plan`	以"计划模式"启动
`--max-turns N`	限制本次会话的最大对话轮数
`--no-default-tab`	只显示最近的Git变更，忽略默认的上下文信息

调试与功能控制

参数	功能
`--allowedTools`	允许Claude使用特定的工具列表
`--disallowedTools`	禁用特定的工具列表
`--disableTelemetry`	禁用遥测数据收集
`--no-browser`	禁用浏览器集成功能
`--verbose`	显示详细的运行日志

管道模式输出格式

参数	功能
`--output-format text`	纯文本输出（默认）
`--output-format json`	结构化的JSON格式输出
`--output-format stream-json`	实时流式JSON输出，适合写入日志

提示：在非交互式管道中使用，例如 echo "修复这个bug" | claude -p --output-format stream-json，可以将输出流式写入日志文件。

4. 核心扩展系统：五大自定义支柱

Claude Code 的强大之处在于其高度可扩展的架构，核心由以下五部分组成：

记忆（Memory）：项目的"大脑"。Claude会在每次会话中读取记忆文件，以了解项目的代码风格、架构规范、命名约定和依赖关系。
- ./CLAUDE.md：项目主记忆文件（推荐纳入版本控制）。
- ~/.claude/CLAUDE.md：个人全局记忆，适用于所有项目。
斜杠命令（Slash Commands）：你可以创建自定义的斜杠命令，将复杂的提示词或工作流固化。
- 项目级 ：.claude/commands/ 目录（建议纳入Git追踪）。
- 全局级 ：~/.claude/commands/ 目录。
工具（Tools）：Claude能够自动调用的一组内置能力，无需在提示词中显式要求。
- Bash：运行Shell命令和脚本。
- Read：读取文件和代码内容。
- Write：写入或编辑代码文件。
钩子（Hooks）：允许你在特定事件发生时自动执行脚本或命令，实现自动化工作流（详见下节）。
MCP 服务器：通过模型上下文协议（MCP）连接外部服务和数据源。
- 配置：~/.mcp-config.json 或启动时指定。
- 安装社区扩展 ：--plugin <plugin-name>。

5. 钩子（Hooks）：事件驱动自动化

钩子让你可以在Claude生命周期的特定节点自动执行任务，实现流程自动化。

钩子名	触发时机
PreToolUse	Claude即将使用任何工具之前，可用于进行校验、自动格式化或运行Lint检查。
PostToolUse	工具调用完成后，可用于清理、自动格式化、或自动执行Git提交。
Stop	Claude停止响应前执行。
SessionStart	每次会话开始时执行。
SessionEnd	会话正常结束时执行。
PreCompact	在执行 `/compact` 压缩对话历史前执行。
Notification	Claude发送通知时触发。

示例：可以配置一个 PostToolUse 钩子，在每次文件编辑后自动运行代码格式化工具，并执行 git add。所有钩子均在 settings.json 中配置。

6. 输入超能力（Input Superpowers）

向 Claude 传递信息有多种高效方式，远超单纯的打字。

功能	说明
# 前缀	直接在输入中通过 `#文件名` 或 `#文件夹名` 引用，Claude会自动读取其内容。
粘贴图片	截图、原型图或示意图可直接粘贴到输入框，Claude可以"理解"图像内容。
拖拽文件	将CSV、代码、JSON等文件直接拖入终端，其原始数据会被粘贴。
多行输入	使用 `claude --add-dir {路径}` 可以将整个项目根目录添加到上下文。
Markdown	直接粘贴格式化的Markdown内容，Claude会原样读取。

注意：在粘贴大量内容时，一个高效的工作流是：先告知 Claude 你要提供什么材料，然后粘贴内容，最后提出你的问题。

7. 权限模式（Permission Modes）

Claude Code 提供了三种权限模式，让你在安全与速度之间找到平衡。

模式	说明
普通模式（Normal）	最安全。Claude在执行任何操作（如运行命令、编辑文件）前，都会请求你的确认。
自动接受模式（Auto-Accept）	最快速。Claude可以直接运行工具而无需询问，适合你完全信任其操作的场景。
计划模式（Plan Mode）	零风险。Claude只进行规划和推演，不会执行任何实际操作，非常适合分析和设计阶段。
Shift+Tab	这是一个快捷键，可以在这三种模式之间快速循环切换。

最佳实践 ：首先进入计划模式 ，让 Claude 分析问题并提出包含具体操作步骤的计划。待你审阅并认可计划后，再通过 Shift+Tab 切换到普通模式 或自动接受模式来执行。这正是 AI 辅助编程的理想工作流。

8. 配置（Configuration）

Claude Code 的设置具有优先级，确保项目级设置可以覆盖用户默认设置，企业级设置拥有最高权限。

配置优先级

级别	路径	说明
企业级	`/etc/claude-code/managed-settings.json`	由管理员统一管理，优先级最高。
项目级	`.claude/settings.json`	应纳入Git追踪，用于团队共享项目特定设置。
用户全局	`~/.claude/settings.json`	当前用户的默认设置。

常用配置命令

命令	功能
`config list`	显示所有当前生效的配置项。
`config get <key>`	读取某个配置项的值。
`config set <key> <value>`	修改某个配置项的值。
`config add <key> <value>`	向一个列表类型的配置项追加值。
`config remove <key> <value>`	从列表类型的配置项中删除一个值。

权限示例 ：在 settings.json 中设置 "allowedTools": ["Bash(git:*)"]，可以允许所有Git命令自动执行，无需每次确认。

9. 文件结构映射

了解 Claude Code 的配置目录结构，能让你更好地组织和管理自定义内容。

项目级（.claude/）

文件/目录	说明
`CLAUDE.md`	项目记忆文件，包含规范、架构、依赖等核心信息。
`settings.json`	项目级别的共享设置。
`commands/`	存放项目自定义的斜杠命令（例如 `Files.md`, `test.md`）。
`agents/`	存放项目特定的子代理配置。

全局级（~/.claude/）

文件/目录	说明
`CLAUDE.md`	适用于所有项目的全局记忆。
`settings.json`	用户全局设置。
`commands/`	存放用户个人的全局斜杠命令。
`agents/`	存放用户个人的全局子代理。
`keystroke.json`	自定义的键盘快捷键映射。

10. 回溯与检查点（Rewind & Checkpoints）

Claude Code 提供了强大的回溯功能，让你可以安全地探索不同的解决方案。

命令	功能
`Esc` `Esc`	在任意位置连续按两次 `Esc` 键，即可打开回溯菜单。
`/reset`	直接回退到最后一次命令执行前的状态。

回溯选项：

仅对话（Conversation Only）：仅回退对话历史，所有代码修改保持不变。
代码（Code）：撤销Claude对文件的所有修改，但保留对话历史。
完全回溯（Full Rewind）：同时还原对话历史和代码修改。

重要：回溯会影响文件的修改、API调用和数据库操作。检查点只能追踪Claude的写入操作，对于重要的代码版本管理，请务必依赖Git。

11. Pro 工作流：充分发挥 Claude Code 的潜力

项目启动三部曲

bash 复制代码

# 第一步：初始化项目
cd your-project && claude
# 第二步：在Claude中运行 /init 命令
/init
# 第三步：编辑生成的 CLAUDE.md 文件，然后输入 "A" (Accept) 确认

高效提示词技巧

技巧	说明
粘贴错误信息	直接复制完整的编译或运行时错误信息，Claude能准确定位到问题所在。
粘贴堆栈跟踪	完整的Stack Trace能帮助Claude更好地理解Bug的上下文。
管道传递日志	`cat error.log
使用观察者	如果某个功能频繁出错，可以让Claude持续关注它。
善用Markdown	在提示词中使用Markdown格式，可以让Claude更清晰地理解你的需求。
后台任务	使用 `Ctrl+Tab` 将长时间运行的任务放到后台，可以同时进行多个对话。
代理任务	创建多个子代理并发处理不同的子任务，用于迭代式改进。

12. 创建自定义命令

你可以将常用的复杂提示词或工作流封装成简单的斜杠命令。

步骤说明：

创建文件 ：在 .claude/commands/ 目录下创建一个新的 .md 文件（例如 review.md）。
编写提示词：在该文件中写入Claude执行此命令时会看到的提示词内容。
使用变量 ：
- 使用 ${input} 来引用用户在命令后输入的任何文本。
- 使用 $ARGUMENTS 来接收传递给命令的参数，空格会被替换为参数值。
高级配置 ：你可以在文件头通过YAML格式的Front Matter进行配置。
- allowed-tools: 列出此命令允许使用的工具。
- model: 为此命令指定专用的模型。

示例：在 commands/write-story.md 文件中，你可以定义提示词 请根据以下要求编写一个故事：${input}。当用户输入 /write-story 一个关于AI的童话 时，${input} 就会被替换为"一个关于AI的童话"。

13. 快速参考：最常用场景组合

场景	命令/操作
启动项目	`cd project && claude`
继续上次工作	`claude -c` 或选择数字1
从头开始修复	`claude -p "修复这个bug..."`
审查代码变更	`git diff
修复测试失败	`npm test
结合Git状态	`git status` 后，再运行 `claude` 并说明你要做什么。
并行会话	Claude支持同时运行多个实例，开启多个终端窗口即可。
脚本自动化	`echo "自动化这个任务"

14. `/loop` 命令：内置定时任务调度

Claude Code 自 2.1.71 版本起引入了强大的 /loop 命令，它允许你在当前会话中创建轻量级的定时任务，无需编写复杂的 cron 表达式，用自然语言即可完成。

子命令/语法	功能与说明
`/loop {时间间隔} {任务描述}`	创建定时任务。时间间隔支持 `s`（秒）、`m`（分）、`h`（时）、`d`（天），例如 `/loop 5m check the build status`。秒级间隔会被自动向上取整到分钟。
`/loop {任务描述} every {时间间隔}`	另一种自然语言语法，例如 `/loop check deployment every 2h` 。
`/loop list`	列出当前会话中所有活跃的定时任务及对应的 Job ID 。
`/loop cancel {Job ID}`	取消指定的定时任务。你也可以直接用自然语言说 "cancel the build monitor job" 。
`CronDelete {Job ID}`	底层工具命令，用于删除定时任务，效果同 `/loop cancel` 。

调度机制与限制

会话绑定 ：所有 loop 任务与当前 Claude Code 终端会话绑定，会话关闭则任务终止。

3天过期 ：为防止任务被遗忘，所有周期性任务在创建后最长持续3天，过期前会执行最后一次并自动删除。

非侵入执行：调度器每秒检查一次，任务执行会"插队"在你两次对话之间，不会打断你当前的操作。

抖动机制（Jitter）：为避免所有任务同时触发，系统会对执行时间增加一个基于任务 ID 的确定性偏移（周期性任务最多延迟其周期的10%，上限15分钟）。

完全禁用 ：设置环境变量 export CLAUDE_CODE_DISABLE_CRON=1 可禁用所有定时任务。

15、语音模式（Voice Mode）：开启免提编程

Anthropic 正在逐步推送语音模式，让开发者可以通过语音指令与 Claude Code 交互，实现更自然的对话式编程。该功能目前处于内测阶段，约 5% 的用户可用。

命令/操作	功能与说明
`/voice`	在终端中输入此命令以启用语音模式。
长按空格键	（内测功能）启用语音模式后，长按空格键开始录音说话，松开按键即自动完成语音转录并发送指令。
语音指令示例	直接说出如 "重构认证中间件" 或 "给这个函数添加错误处理" 等指令，Claude 将自动执行。

功能亮点与注意事项

无缝衔接 ：语音转文字的结果会实时流入当前光标位置，你可以手打与语音混合输入，遇到复杂逻辑用嘴说，精确代码用手打，互不干扰。

完全免费 ：Anthropic 已明确表示，语音转录所消耗的 Token 完全免费，不计入用户的 API 额度。

适用场景：特别适合快速描述复杂 Bug、进行架构思路的口述，或在手部不便（如腱鞘炎）时作为刚需输入方式。但对于变量名、URL 和特定代码片段，目前仍建议手动输入以确保准确。

总结

Claude Code 不仅仅是一个 AI 助手，更是一个深度集成到开发者工作流中的强大伙伴。通过掌握本文介绍的命令、快捷键、配置和扩展机制，你可以：

初始化项目 ：使用 /init 为项目建立"记忆"。
善用计划模式：先规划、后执行，将风险降至最低。
配置钩子：自动化 Lint、格式化、Git提交等重复性工作。
建立自定义命令：将复杂工作流固化为简单的斜杠命令。
利用检查点：在重要操作前，随时准备回溯。

希望这份指南能帮助你全面掌握 Claude Code，并将其真正融入你的日常开发，体验 AI 赋能编程的极致效率。