Claude Code 是 Anthropic 推出的命令行 AI 编程助手，直接在你的终端中运行，深度理解代码库并帮你完成开发任务。

ClaudeCode使用技巧.excalidraw

一、常用斜杠命令（80% 场景覆盖）

命令作用典型场景
/help查看帮助和命令列表忘了某个命令时，随时查阅
/clear清空对话历史切换任务前清理上下文，避免旧信息干扰
/clear 后 Esc×2 或 /resume恢复被 clear 的会话/clear 后后悔了？立刻找回上一个会话
/compact压缩上下文对话太长时释放 token 空间，保留关键摘要
/rewind回退对话&代码实验跑偏了？一键回滚到之前的状态
/effort调整思考强度简单任务降级省 token，复杂任务拉满思考力
/init初始化项目 CLAUDE.md新项目接入时，自动生成项目说明文件
/config打开配置面板切换模型、调整主题、管理设置
/review 或 /code-review代码审查PR 提交前自查，或审查他人的改动
/security-review安全审查发布前检查安全漏洞
/simplify简化/重构代码代码写完后去掉冗余、提升可读性
/doctor诊断安装问题Claude Code 行为异常时的首选排查命令
/status查看当前会话状态了解 token 用量、模型、项目信息
/cost查看费用消耗关心 API 花费时随时查看
/permissions管理权限查看/调整工具权限（如允许 bash、文件写入等）
/add-dir添加工作目录需要访问项目外的其他目录时
/memory管理持久化记忆设置全局偏好（如 “始终用 TypeScript”）
/context查看当前上下文了解 Claude Code 能看到哪些文件和内容
/terminal-setup终端设置首次使用或换终端时配置快捷键和行为
/bug提交 bug 报告遇到 Claude Code 自身问题时
/agents ❌查看/管理子代理已废弃，改为直接对话或编辑配置目录

二、键盘快捷键

2.1 输入与提交

快捷键作用说明
Enter提交消息普通模式换行用 Shift+Enter，提交用 Enter（可在配置中反转）
Shift+Enter换行多行输入时插入换行符
Esc退出当前模式关闭弹窗、取消操作、退出 Vim 插入模式
Esc × 2打开回退菜单输入框为空时，连按两次 Esc 等同于 /rewind
Ctrl+C中断当前操作Claude 正在生成/执行时立刻停止
Ctrl+D退出 Claude Code等同于输入 /exit
Ctrl+L清屏视觉上清屏（不影响对话历史）
Ctrl+O打开文件选择器快速浏览和选择项目文件
Ctrl+S暂存/恢复输入有文字时暂存并清空，空输入时恢复之前的文字和光标位置
Shift+Tab切换权限模式在 default → acceptEdits → plan → auto 等模式间循环切换
Option+T / Alt+T切换思考强度在思考强度层级间循环切换（low → medium → high → xhigh → max）

2.2 导航与历史

快捷键作用说明
↑ / ↓浏览历史命令复用之前输入过的指令
Ctrl+R搜索历史模糊搜索历史命令，比逐条翻更快
Tab自动补全补全文件路径、命令、@ 引用等

2.3 粘贴与编辑

快捷键作用说明
Ctrl+V粘贴粘贴剪贴板内容
Shift+Insert粘贴（备选）部分终端 Ctrl+V 不可用时的备选
Ctrl+W删除前一个单词快速编辑输入内容
Ctrl+U删除整行清空当前输入行
Ctrl+A / Ctrl+E跳到行首/行尾快速移动光标

2.4 特殊输入前缀

符号作用示例
@引用文件或文件夹@src/utils.ts → 将该文件加入上下文
#引用文件（备选）#README.md → 同上
!终端命令模式! npm test → 直接运行命令，输出回传给 Claude
?快捷键帮助输入框为空时输入 ? 显示快捷键面板
拖拽文件将文件拖入终端直接添加文件到上下文

好处：用 @ 引用文件可以精确控制 Claude Code “看到”什么内容。! 则让你直接执行命令而不经过 AI，适合需要交互式输入的场景（如 ! npm login）。

三、核心模式

3.1 Plan Mode（计划模式）

什么时候用：当任务涉及多文件修改、架构决策、或有多种可行方案时。

Text
# 手动进入
/plan 帮我实现用户认证功能

# Claude Code 也会在复杂任务前主动提议进入计划模式

好处：

  • 先出方案再动手，避免方向性返工
  • 你可以审核方案后再批准执行
  • 对复杂重构、新功能开发特别有效

典型流程：提出需求 → Claude 设计方案 → 你审核修改 → 批准后执行

3.2 Vim Mode（Vim 模式）

什么时候用：习惯 Vim 键位的开发者。

Text
/config → 在配置面板中开启 Vim Mode

好处：

  • Normal 模式下用 h/j/k/l 导航
  • i 进入插入模式，Esc 退出
  • 用熟悉的 Vim 快捷键编辑输入，效率翻倍

3.3 Background Tasks（后台任务）

什么时候用：需要同时执行多个独立任务时。

Text
# Claude Code 会自动将独立任务放到后台
# 例如："同时修复这三个 bug，并重构 utils"

好处：

  • 多个任务并行执行，不等不拖
  • 你可以继续对话，后台任务完成后会有通知
  • 用 claude agents --json 或在对话中直接问”有哪些后台任务”

3.4 Permission Modes（权限模式切换）

什么时候用：需要切换 Claude Code 的操作权限级别时。

用 Shift+Tab 在以下模式间循环切换：

模式行为
default每次操作前询问（默认，最安全）
acceptEdits自动接受文件编辑，不询问
plan只做计划不执行，等同于 Plan Mode
auto自动接受所有操作（需要信任）

状态栏提示：当前模式会显示在界面底部，随时可见。

3.5 Effort Level（思考强度）

什么时候用：简单任务想省 token 提速，或者复杂任务想给 Claude 更多”脑力预算”。

三种调整方式：

方式操作
快捷键Option+T（macOS）/ Alt+T（Windows/Linux），在层级间循环切换
命令/effort 打开选择面板
配置~/.claude/settings.json 中设 "effortLevel": "medium"

五级强度及适用场景：

级别适用场景特点
low简单问答、分类型任务最快、最省 token
medium常规编码、日常任务很多场景下够用，token 消耗少
high默认级别，适合大多数智力密集型任务默认推荐
xhigh复杂编码、长时间 agentic 任务Claude Code 内部默认值，复杂重构首选
max极难问题、最严谨的输出最强但也最慢，可能过度思考

⚠️ 重要：建议在会话开始时设定好 effort，中途切换会使 prompt 缓存失效，下次请求会以全价重新处理整个对话历史。

实际感受：low/medium 会让 Claude 回复更简洁、工具调用更少；xhigh/max 会深度思考每一步，输出更长但质量更高。日常编码用 high，大重构用 xhigh，快速问答用 medium。

四、核心机制

4.1 CLAUDE.md — 项目级「说明书」

是什么：放在项目根目录的 Markdown 文件，告诉 Claude Code 关于项目的关键信息。

什么时候用：每个项目都应该有。用 /init 自动生成，然后手动补充。

Markdown
# CLAUDE.md 示例

## 项目概述
这是一个 Next.js 电商项目，使用 TypeScript + Tailwind CSS

## 技术约定
- 始终使用 TypeScript 严格模式
- CSS 优先使用 Tailwind 原子类，避免自定义 CSS
- API 路由放在 src/app/api/ 下

## 常用命令
- 开发：npm run dev
- 测试：npm run test
- 构建：npm run build

好处：

  • 新会话开始时 Claude Code 会自动读取
  • 不用每次对话都解释一遍项目背景
  • 团队共享同一份约定，保证一致性
  • 可以放 CI/CD 信息、代码风格、架构决策等

4.2 Memory（持久记忆）

是什么：跨会话的全局偏好设置。

什么时候用：设置你个人的编码偏好，一次设置，永久生效。

Text
# 打开记忆管理
/memory

# 或在对话中直接说
"以后我所有的项目都默认用 pnpm，记住这点"

好处：

  • 不用每个项目重复配置
  • 支持的语言、框架偏好、命名习惯等都能记住
  • 随时用 /memory 查看和编辑

4.3 Hooks（事件钩子）

是什么：在特定事件发生时自动触发的操作。

什么时候用：需要在某些操作前后自动执行脚本时。

事件类型触发时机典型用途
PreToolUse工具调用前安全检查、二次确认
PostToolUse工具调用后自动格式化代码、记录日志
Notification任务完成通知发送桌面通知
Stop对话结束时自动运行测试、清理临时文件
UserPromptSubmit用户提交消息时注入额外上下文
SessionStart会话开始时加载环境变量、检查依赖

好处：

  • 自动化重复性操作（如每次写文件后自动 Prettier）
  • 安全检查（如阻止删除关键文件）
  • 保持编码规范的一致性

4.4 MCP（Model Context Protocol）

是什么：让 Claude Code 接入外部工具和数据源的标准协议。

什么时候用：需要对接数据库、API、第三方服务时。

Text
# 在配置中添加 MCP 服务器
# 例如：接入 GitHub、数据库、设计工具等

好处：

  • 突破 Claude Code 内置工具的限制
  • 直接操作数据库、调用 API、读写外部系统
  • 社区有大量现成的 MCP 服务器可用

4.5 Sub-agents（子代理）

是什么：Claude Code 可以派生子代理去并行处理子任务。

什么时候用：Claude Code 会自动判断，无需手动干预。典型场景：

  • 同时搜索多个不同目录
  • 并行审查多个文件
  • 一个代理写代码，另一个代理同时写测试

好处：

  • 显著加快复杂任务的处理速度
  • 每个代理专注一个子任务，质量更高
  • 用 claude agents --json 或在对话中管理

4.6 Permissions（权限系统）

是什么：控制 Claude Code 可以执行哪些操作的安全机制。

什么时候用：首次使用时配置，之后按需调整。

Text
# 三种权限模式（在 /config 中选择）

1. 每次询问 — 最安全，每个操作都要你确认
2. 按项目授权 — 每个项目首次操作时确认
3. 完全信任 — 不询问（仅限完全信任的场景）

好处：

  • 防止 AI 误操作（如删除文件、执行危险命令）
  • 可以在项目 .claude/settings.json 中精确配置
  • 用 /permissions 随时查看和调整

4.7 Context Management（上下文管理）

是什么：管理 Claude Code 能”看到”的内容范围。

关键概念：

概念说明
Token Budget一次对话能处理的 token 上限（由模型决定）
Auto-Compact对话过长时自动压缩，保留关键信息
/compact手动触发压缩，可以加描述说明保留重点
@file 引用精确控制 Claude 能看到哪些文件

什么时候用 /compact：

  • 对话很长，响应开始变慢时
  • 要切换话题，不想被之前的对话影响时
  • 想释放 token 空间来加载新的文件时

好处：

  • 避免 token 浪费在无关历史上
  • 手动 compact 可以加一句描述告诉 Claude 重点保留什么
  • 比 /clear 更智能（会保留关键摘要而非完全丢弃）

4.8 Worktrees（Git 工作树隔离）

是什么：在独立的 Git 工作树中执行任务，不影响当前工作区。

什么时候用：Claude Code 在做大规模修改时会自动使用，也可以手动触发。

好处：

  • 实验性改动不会污染主工作区
  • 多个任务可以在独立分支上并行
  • 失败后可以轻松丢弃，不影响当前进度

4.9 Skills（技能系统）

是什么：可插拔的专业化能力模块，针对特定任务类型优化。

什么时候用：Claude Code 会自动匹配；你也可以手动调用。

Text
# 例如
/excalidraw-diagram 画架构图
/review              审查 PR
/simplify            简化代码

好处：

  • 不同任务类型有专门的”专家”处理
  • 社区可以贡献自定义 skill
  • 保持核心系统的简洁

4.10 Checkpoint & Rewind（检查点与回退）

是什么：Claude Code 自动在每个用户 prompt 之前创建代码快照，允许你随时「时光倒流」到之前的某个状态。

什么时候用：

  • 实验跑偏了，想回到没改坏之前的状态
  • 试了 A 方案发现不行，想回到分叉点试 B 方案
  • 对话太长，想保留前半段、压缩后半段释放 token

触发方式：

  • 命令行输入 /rewind
  • 或按两次 Esc（输入框为空时；有文字时会先清空文字）

回退菜单的 5 个选项：

选项作用
Restore code and conversation代码和对话都回退到选中点
Restore conversation只回退对话，保留当前代码
Restore code只回退代码，保留对话
Summarize from here选中点之前的对话保留，之后的内容压缩为摘要（释放 token）
Summarize up to here选中点之前的内容压缩为摘要，后面的对话保留

核心场景：Restore 系列 = “我要回到过去”；Summarize 系列 = “我只要保留精华”。

提示：Restore 或 Summarize 之后，选中点的那个原始 prompt 会自动恢复到输入框，方便你修改后重新发送。

与 /compact 的区别：

  • /compact：全局压缩整个对话
  • /rewind → Summarize：选择性压缩，可以只压缩中间某段调试过程，保留开头和结尾的完整细节

限制：

不适用的情况说明
Bash 命令修改的文件rm、mv、cp 等命令行操作无法回退
子代理的编辑后台子代理的改动不会一起回退（需用 git）
外部手动修改你在编辑器里手动改的文件不受检查点管理
软链接/硬链接文件回退时会自动跳过，不会报错

不是 Git 的替代品：检查点是会话级的快速恢复，Git 才是版本历史的最终权威。

五、实战 Tips

5.1 提问题的技巧

✅ 好的提问❌ 差的提问
帮我给 /api/users 路由加上分页和错误处理加个分页
重构 src/utils/format.ts，拆成更小的函数重构 utils
帮我用 React Query 替换掉 Profile 组件里的手动 fetch优化 Profile 组件
@src/api/users.ts 给这个文件写单元测试写测试

原则：说清楚「做什么」「在哪里」「怎么做的」，用 @ 引用具体文件。

5.2 善用 @ 引用

Text
# 引用单个文件
帮我解释 @src/utils/auth.ts 的逻辑

# 引用整个目录
帮我审查 @src/api/ 下的所有路由

# 一次引用多个
比较 @src/old/billing.ts 和 @src/new/billing.ts 的差异

5.3 CLAUDE.md 最佳实践

Markdown
# 必放内容
- 项目一句话描述 + 技术栈
- 常用命令（启动、测试、构建、部署）
- 代码风格约定
- 目录结构简介

# 选放内容
- CI/CD 流程说明
- 重要约定（如：不要修改 /generated/ 目录）
- 测试策略
- 环境变量说明

5.4 处理大任务

  1. 先 Plan：复杂任务先 /plan，确认方案再动手
  2. 拆任务：一个大任务拆成 3-5 个小步骤，逐个推进
  3. 及时 Compact：做了一半发现上下文太多，/compact 压缩后再继续
  4. 用代理加速：有独立子任务时，直接在对话中说”同时做 X 和 Y”

5.5 中断与恢复

  • Ctrl+C 中断后，可以继续对话要求调整方向
  • 每次中断都会保留已完成的工作
  • 如果中断的是危险操作，直接说”别继续了，换个方案”

六、速查卡片

Text
┌─────────────────────────────────────────────────────┐
│                   Claude Code 速查                    │
├────────────┬────────────────────────────────────────┤
│ /init      │ 初始化项目说明文件                        │
│ /clear     │ 清空对话                                  │
│ /compact   │ 压缩上下文                                │
│ /rewind    │ 回退对话&代码                              │
│ /effort    │ 调整思考强度                              │
│ /review    │ 代码审查                                  │
│ /config    │ 打开配置                                  │
│ /doctor    │ 诊断问题                                  │
│ /cost      │ 查看花费                                  │
│ /memory    │ 管理偏好                                  │
│ /plan      │ 进入计划模式                              │
│ /status    │ 会话状态                                  │
├────────────┼────────────────────────────────────────┤
│ Ctrl+C     │ 中断操作                                  │
│ Ctrl+D     │ 退出                                      │
│ Ctrl+O     │ 文件选择器                                │
│ Ctrl+R     │ 搜索历史                                  │
│ ↑↓         │ 历史命令                                  │
│ Tab        │ 自动补全                                  │
│ @file      │ 引用文件进入上下文                         │
├────────────┼────────────────────────────────────────┤
│ CLAUDE.md  │ 项目级说明书                              │
│ Memory     │ 全局偏好记忆                              │
│ Hooks      │ 自动化触发                                │
│ MCP        │ 外部工具协议                              │
│ Plan Mode  │ 先规划后执行                              │
└────────────┴────────────────────────────────────────┘

最后一条建议：Claude Code 是搭档，不是工具。像和同事沟通一样描述你的需求 — 说背景、说目标、说约束，它就能给你惊喜。