Claude Code 是 Anthropic 推出的 AI 编程助手，深度理解代码库并帮你完成开发任务。它运行在终端、IDE、桌面应用和浏览器等多个「surface」上，但共享同一套引擎（CLAUDE.md、设置、MCP 服务器到处通用）。

📋 摘要
  • 内置斜杠命令 90+，常用约 40 个；命令参考见 commands
  • 权限模式已扩展为 6 种，Pro/Max/Team 内置默认即 auto 模式（分类器审查）
  • 「自定义命令」已并入 Skills（SKILL.md）；子代理、动态工作流、云端 Routine 是新增长点
  • 官方文档已迁移至 code.claude.com/docs，全文末尾附精选导航

ClaudeCode使用技巧.excalidraw

一、常用斜杠命令

内置命令共 90+（含 bundled skills 与插件贡献的命令），输入 / 可过滤。完整列表见 commands 参考。

1.1 会话与上下文

命令作用典型场景
/help查看帮助和命令列表忘了某个命令时随时查阅
/clear [name]开启新会话（别名 /reset /new）切换任务前清理上下文
/compact [说明]压缩上下文，保留关键摘要对话太长时释放 token 空间
/autocompact [N|auto]设置自动压缩窗口想更早触发自动压缩时
/rewind回退对话/代码到检查点实验跑偏了，一键回滚
/context可视化上下文占用（彩色网格）了解 Claude 能看到什么
/export [文件]导出对话为纯文本归档或分享会话
/copy [N]复制上一条回复到剪贴板快速取走结果
/recap生成一句话会话摘要离开终端回来想快速跟上
/branch [name]从当前对话分出一个分支想试另一种思路又不丢现状
/btw [问题]旁路提问，不进对话历史随口问一句「那个配置文件名是啥」

1.2 模式 / 模型 / 思考强度

命令作用典型场景
/plan [描述]进入计划模式复杂任务先出方案再动手
/model [alias|name]切换模型opus 推理、sonnet 日常、haiku 简单
/effort [level|auto]设置思考强度简单任务降级省 token，复杂任务拉满
/fast开关 fast mode想要 Opus 更快响应（价格更高）
/config [key=value]打开设置面板（别名 /settings）切主题、开 Vim、选 Output style

1.3 审查 / 质量 / 诊断

命令作用典型场景
/review / /code-review代码审查（skill）PR 提交前自查或审他人改动
/security-review安全审查（skill）发布前检查安全漏洞
/simplify简化/重构代码去掉冗余、提升可读性
/doctor运行检查并诊断（别名 /checkup）行为异常时的首选排查
/debug启用调试日志并排障（skill）深挖疑难问题
/diff打开交互式 diff 查看器逐条审改动

1.4 代理 / 并行 / 自动化

命令作用典型场景
/agents子代理入口（打印提示，旧版打开面板）了解子代理文件位置
/list-agents列出子代理/团队/会话（别名 /peers）看看有哪些 agent 可用
/background把当前会话转入后台（别名 /bg）长任务扔后台继续干活
/tasks查看后台任务与子代理检查/attach/停止后台任务
/fork复制会话到新的后台会话保留现状、开副本继续
/batch大规模并行改动（worktree 隔离，skill）一个大改动拆成多个 PR
/workflows查看动态工作流运行状态监控 /deep-research 等运行
/schedule创建云端例行任务（别名 /routines）「每天早上 9 点审 PR」
/loop按间隔循环运行提示（skill）轮询状态、定时检查
/goal给 Claude 设定一个长期目标让它持续朝目标推进

1.5 扩展 / 配置 / 账户

命令作用典型场景
/init生成/改进项目 CLAUDE.md新项目接入时自动生成说明文件
/memory管理 CLAUDE.md 与自动记忆查看/编辑记忆文件
/skills列出可用技能看看有哪些 skill
/plugin管理插件装/卸插件、加 marketplace
/mcp管理 MCP 服务器与 OAuth接入外部工具
/hooks查看 hook 配置检查自动化触发
/keybindings打开快捷键配置文件自定义快捷键
/ide管理 IDE 集成配置 VS Code/JetBrains
/import从其他 agent 导入配置从 Codex/Gemini 迁移
/add-dir添加工作目录访问项目外的目录
/permissions管理 allow/ask/deny 规则精调工具权限
/status查看会话状态看 token 用量、模型、登录方式
/cost查看费用（别名 /usage）关心 API 花费
/login / /logout登录/登出切换账号
/bug反馈 bug（别名 /share）遇到 Claude Code 自身问题

二、键盘快捷键

📚 官方文档：interactive-mode · keybindings

2.1 通用控制

快捷键作用说明
Enter提交消息换行用 Shift+Enter（可配置反转）
Shift+Enter换行多行输入
Esc中断 / 关闭弹窗停止当前回复或工具调用；权限弹窗中=拒绝
Esc × 2清空草稿 / 打开回退菜单有文字先清空，空输入时等同于 /rewind
Ctrl+C中断 / 清空输入有任务在跑时中断；无任务时首次清空输入
Ctrl+D退出首次按下显示确认提示，800ms 内再按退出
Ctrl+L重绘屏幕显示错乱时恢复
Ctrl+O切换 transcript viewer查看工具调用详情、展开 MCP 调用
Ctrl+G用外部编辑器打开编辑提示词或 plan
Ctrl+B转入后台运行后台化 Bash 命令/代理（tmux 用户按两次）
Ctrl+T切换任务清单显示/隐藏 Claude 的 to-do 列表
Ctrl+V粘贴图片插入 [Image #N] 占位
Ctrl+S暂存/恢复输入有文字暂存清空，空输入恢复
Ctrl+Z挂起（Unix）挂起到 shell，fg 恢复
Shift+Tab循环切换权限模式default → acceptEdits → plan → [bypass] → auto
Option+T / Alt+T切换扩展思考开/关 thinking（不是循环 effort）
Option+O / Alt+O开关 fast mode—
Option+P / Alt+P切换模型不清空输入直接换模型

2.2 文本编辑

快捷键作用
Ctrl+A / Ctrl+E跳到行首/行尾
Ctrl+K删除到行尾（可 Ctrl+Y 粘贴）
Ctrl+U删除到行首（可粘贴）
Ctrl+W删除前一个单词
Ctrl+Y粘贴删除的文本
Alt+B / Alt+F按词后退/前进（macOS 需 Option as Meta）
Alt+D删除下一个词
Ctrl+_撤销上次输入

2.3 历史与补全

快捷键作用
↑ / ↓（或 Ctrl+P/Ctrl+N）浏览历史命令（跨会话、按项目存储）
Ctrl+R反向搜索历史
Tab接受自动补全

2.4 特殊输入前缀

符号作用示例
/命令或 skill/help、/deploy
!Shell 模式! npm test → 直接运行命令，输出回传
@文件路径/会话提及@src/utils.ts 精确引入上下文
:Emoji 短码:heart: → ❤️
?空输入时显示快捷键面板—

好处：@ 精确控制 Claude「看到」什么；! 不经 AI 直接执行（适合 ! npm login 这类交互式命令）。# 前缀引用文件已移除。

2.5 Vim 模式

/config → Editor mode 开启，支持 Normal/Insert/Visual 全键位与 vimInsertModeRemaps（如 jj 映射 Esc）。详见 interactive-mode。

三、核心模式

3.1 Plan Mode（计划模式）

什么时候用：多文件修改、架构决策、多种可行方案时。

Text
/plan 帮我实现用户认证功能

好处：先出方案再动手；方案可审核、可用 Ctrl+G 在编辑器里改；批准后进入对应权限模式执行。

📚 permission-modes

3.2 权限模式（Permission Modes）

Shift+Tab 循环切换。现有 6 种模式：

模式无需询问即可执行适用
default（界面标 Manual）仅读取敏感工作、逐条审核
acceptEdits读取 + 文件编辑 + 常见文件命令边改边审
plan读取 +（auto 可用时）分类器批准的命令先探索再动手
auto几乎全部，由分类器模型后台审查长任务、减少打断
dontAsk仅预批准的工具CI/受限环境
bypassPermissions全部（跳过检查）仅隔离容器/VM

关键点：

  • auto 模式：Pro/Max/Team 内置起始模式。一个独立的 classifier 模型审查每次操作，默认拦截 curl | bash、生产部署、危险 rm -rf /、git reset --hard 等；对话里说的「别 push」也会被当作拦截信号。
  • 受保护路径：.git、.claude、.zshrc、.npmrc 等写入永不自动批准（除 bypassPermissions）。
  • bypassPermissions 与 --dangerously-skip-permissions 等价，root 下拒绝启动。

📚 permission-modes · permissions

3.3 思考强度（Effort Level）与扩展思考

Effort（自适应推理强度）由 /effort、--effort、effortLevel 设置或 /model 里的滑块调节：

级别适用特点
low简短、对延迟敏感的任务最快最省
medium成本敏感、可牺牲部分智能token 消耗少
high默认（多数模型）均衡
xhigh复杂编码、长时间 agentic 任务Opus 4.7 的默认值
max极难问题最强但易过度思考
ultracode重大任务自动编排工作流Claude Code 设置：xhigh + 自动 workflows

扩展思考（extended thinking）：Option+T/Alt+T 开/关 thinking，与 effort 是两回事（effort 决定「想多少」，thinking 是「是否想」）。在提示词里写 ultrathink 可对单次请求请求更深推理。

⚠️ 会话开始时设好 effort/thinking，中途切换会使 prompt 缓存失效。

📚 model-config

3.4 Fast Mode（快速模式）

/fast 或 Option+O 开关。Opus 5 / 4.8 提速至约 2.5×，但单价更高（$10/$50 每 MTok）——质量不变、只是更快。

  • 不是新模型，而是 Opus 的高速配置
  • 与 effort 的区别：fast 换时延，低 effort 换思考量；两者可叠加
  • 会话开始时开启更省（中途开要按全价重算上下文）

📚 fast-mode

3.5 Output Styles（输出风格）

改变 Claude 的响应方式（角色/语气/格式），不改变它知道什么。/config → Output style，或设置 outputStyle。

内置：Default、Proactive（立即执行少打断）、Concise（先给结果少废话）、Explanatory（附带讲解）、Learning（带你动手，留 TODO(human)）。也可自定义（~/.claude/output-styles 或 .claude/output-styles）。

📚 output-styles

四、核心机制

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

CLAUDE.md 按作用域分 4 层（加载顺序从宽到窄）：

作用域位置用途
组织策略系统级 managed 路径全公司规范
用户~/.claude/CLAUDE.md你的全局偏好
项目./CLAUDE.md 或 ./.claude/CLAUDE.md团队共享约定
本地./CLAUDE.local.md（建议 gitignore）个人项目级偏好

进阶：@path 导入其他文件（如 @AGENTS.md 兼容其他 agent）；大项目拆 .claude/rules/*.md 并可用 paths: 让规则只对匹配文件生效；单文件建议 200 行以内。

📚 memory

4.2 Memory（记忆：CLAUDE.md + 自动记忆）

  • CLAUDE.md：你写的持久指令。
  • Auto Memory（自动记忆）：Claude 自己记的笔记，存于 ~/.claude/projects/<项目>/memory/（MEMORY.md 索引 + 主题文件），分 4 类：user/feedback/project/reference。默认开启，/memory 可开关、浏览、编辑。

📚 memory

4.3 Hooks（事件钩子）

在特定事件触发 shell 命令。常见事件：PreToolUse / PostToolUse / Notification / Stop / UserPromptSubmit / SessionStart / PreCompact / PermissionRequest。

用途：自动格式化、安全检查、注入上下文。

📚 hooks · hooks-guide

4.4 MCP（Model Context Protocol）

接入外部工具和数据源的标准协议。/mcp 管理连接，claude mcp add 添加本地服务器，项目级 .mcp.json，claude.ai 上还有「connectors」连接 Slack/Linear 等。

📚 mcp · mcp-quickstart

4.5 Sub-agents（子代理）

自带独立上下文/系统提示/工具权限的「专员」，避免搜索结果刷屏主对话（只回摘要）。

  • 位置：.claude/agents/*.md（项目）、~/.claude/agents/（用户）
  • frontmatter：name/description（必填）、tools、model、permissionMode、skills、background 等
  • 内置类型：Explore（只读搜索）、Plan（只读规划）、general-purpose（全工具）、claude（兜底）
  • 调用：自然语言、@子代理名、claude --agent xxx

📚 sub-agents

4.6 Skills（技能系统）

用 SKILL.md 封装可复用的流程；自定义命令已并入 skills（.claude/commands/deploy.md 与 .claude/skills/deploy/SKILL.md 等价）。

YAML
---
name: deploy
description: Deploy the application to production
disable-model-invocation: true
allowed-tools: Bash(git push *)
---
  • 位置：~/.claude/skills/（个人）、.claude/skills/（项目）、插件
  • bundled skills：/doctor /code-review /batch /debug /loop /claude-api 等
  • 关键 frontmatter：description（决定何时触发）、disable-model-invocation（仅手动）、context: fork（跑在子代理里）、allowed-tools（临时授权）
  • 动态注入：!`git diff` 先跑命令再注入结果

📚 skills

4.7 Plugins（插件与市场）

/plugin install <name>@<marketplace> 安装；插件可打包 skills、agents、hooks、MCP、output-styles、workflows；/reload-plugins 热生效。

📚 plugins · discover-plugins

4.8 Permissions（权限系统）

allow / ask / deny 三态规则，精确到 Bash(npm run lint) 粒度；/permissions 管理，项目 .claude/settings.json 配置。

📚 permissions

4.9 Context 管理 / Prompt 缓存 / 会话

  • Token Budget 由模型决定；Auto-Compact 自动压缩；/compact 手动压缩；/autocompact 调阈值
  • Prompt caching：Claude Code 自动缓存前缀以省钱提速——切换模型/effort/thinking/output style 会让缓存失效
  • Sessions：--resume / --continue 恢复会话，/clear 只是开新会话（旧会话可恢复）

📚 context-window · prompt-caching · sessions

4.10 Worktrees（Git 工作树隔离）

独立 git worktree 中执行任务，实验性改动不污染主工作区。子代理/agent view 会自动各开一个。

📚 worktrees

4.11 Sandboxing（Bash 沙箱）

/sandbox 或 sandbox.enabled 开启文件系统+网络隔离，可设 auto-allow 减少询问。与权限模式正交。

📚 sandboxing

4.12 安全检查点 & 回退（Checkpoint）

每个用户 prompt 前自动创建代码快照。/rewind 或 Esc×2 打开回退菜单：

选项作用
Restore code and conversation代码+对话都回退
Restore conversation只回退对话，保留代码
Restore code只回退代码，保留对话
Summarize from here保留之前、压缩之后
Summarize up to here压缩之前、保留之后

限制：Bash 命令改的文件、子代理改动、外部手动修改不可回退。检查点是会话级快速恢复，Git 仍是权威。

📚 checkpointing

4.13 Security（安全）

  • /security-review：单次审 diff 找安全漏洞
  • /claude-security（Claude Security 插件）：多代理深度漏洞扫描并生成补丁
  • auto 模式分类器：默认拦截危险操作（见 3.2）

📚 security-guidance · claude-security

五、进阶：多代理与自动化

5.1 四种并行方式对比

方式说明适用
Subagents会话内委派，独立上下文返回摘要防止搜索/日志刷屏
Agent Viewclaude agents 一屏调度后台会话多个独立任务分头跑
Agent Teams多会话协作 + 共享任务列表，lead 协调（实验性）拆项目分块
Workflows脚本编排几十上百子代理并交叉验证审计/大迁移/交叉研究

📚 agents

5.2 Agent View（后台会话）

/background（/bg）把当前会话转后台；/tasks 查看/attach/停止；claude agents 打开总览屏；/fork 复制会话到后台。

📚 agent-view

5.3 Agent Teams / 跨会话消息

多个会话组成团队，lead 分配任务、teammates 直接互发消息。跨会话消息让不同会话（本机/其他机器/云端）互相传状态。

📚 agent-teams · cross-session-messaging

5.4 动态工作流（Dynamic Workflows）

在提示词里说「use a workflow」或加关键词 ultracode，Claude 会写脚本编排大量子代理；/effort ultracode 让每个重大任务都自动走工作流。/workflows 查看进度、可暂停/恢复/保存为命令。内置 /deep-research。

📚 workflows

5.5 Routines 与定时任务

  • Routines（云端）：/schedule 或 claude.ai/code/routines 创建，支持 定时/API/GitHub 事件 触发，笔记本关机也在云端跑
  • /loop：当前会话内按间隔重复运行
  • 桌面定时任务：本机定时运行

📚 routines · scheduled-tasks · desktop-scheduled-tasks

5.6 Remote Control / Channels / Artifacts

  • Remote Control：/remote-control 或 claude --remote-control，用手机/浏览器（claude.ai/code、Claude App）继续本机会话——代码仍在你机器上跑。
  • Channels：向运行中的会话推送事件（如外部系统通知、状态更新）。
  • Artifacts：把会话输出分享为可渲染的产物。

📚 remote-control · channels · artifacts

5.7 Headless 与 Agent SDK

claude -p "prompt" 非交互执行（可 --output-format stream-json），适合脚本/CI；Agent SDK 用于构建自定义 agent。

📚 headless · agent-sdk/overview

六、实战 Tips

6.1 提问题的技巧

✅ 好的提问❌ 差的提问
帮我给 /api/users 路由加上分页和错误处理加个分页
重构 src/utils/format.ts，拆成更小的函数重构 utils
@src/api/users.ts 给这个文件写单元测试写测试

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

6.2 善用 @ 引用

Text
帮我解释 @src/utils/auth.ts 的逻辑
帮我审查 @src/api/ 下的所有路由
比较 @src/old/billing.ts 和 @src/new/billing.ts 的差异

6.3 CLAUDE.md 最佳实践

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

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

超过 200 行考虑拆到 .claude/rules/ 或 skill；一次性流程写进 skill 而不是 CLAUDE.md。

6.4 处理大任务

  1. 先 Plan：复杂任务先 /plan 确认方案再动手
  2. 拆任务：一个大任务拆成小步骤推进
  3. 及时 Compact：上下文太多就 /compact（可加说明保留重点）
  4. 并行加速：独立子任务用子代理；更大规模用 workflow（ultracode）
  5. 设目标：长时间任务用 /goal 让它持续朝目标推进

6.5 中断与恢复

  • Ctrl+C 中断后可继续对话调整方向；已完成的工作会保留
  • 危险操作被中断时，直接说「别继续了，换个方案」

📚 官方文档：常见工作流 · 最佳实践 · Prompt 库 · 大代码库

七、速查卡片

Text
┌─────────────────────────────────────────────────────┐
│                  Claude Code 速查                    │
├────────────┬────────────────────────────────────────┤
│ /init      │ 初始化 CLAUDE.md                        │
│ /clear     │ 开新会话                                 │
│ /compact   │ 压缩上下文                               │
│ /rewind    │ 回退对话&代码（Esc×2）                   │
│ /plan      │ 计划模式                                 │
│ /model     │ 切换模型                                 │
│ /effort    │ 思考强度                                 │
│ /fast      │ 快速模式（Option+O）                     │
│ /review    │ 代码审查                                 │
│ /security-review │ 安全审查                        │
│ /doctor    │ 诊断                                     │
│ /cost      │ 费用/用量                                │
│ /memory    │ 记忆管理                                 │
│ /permissions│ 权限规则                                │
│ /status    │ 会话状态                                 │
│ /background│ 转后台（/tasks 查看）                    │
│ /goal      │ 设定长期目标                             │
│ /workflows │ 工作流进度                               │
│ /schedule  │ 云端例行任务                             │
│ /plugin    │ 插件管理                                 │
│ /mcp       │ MCP 管理                                │
├────────────┼────────────────────────────────────────┤
│ Ctrl+C     │ 中断/清空输入                            │
│ Ctrl+D     │ 退出                                     │
│ Ctrl+O     │ transcript viewer                        │
│ Ctrl+B     │ 转入后台                                 │
│ Ctrl+R     │ 搜索历史                                 │
│ Shift+Tab  │ 切换权限模式                             │
│ Option+T   │ 扩展思考开关                             │
│ ↑↓         │ 历史命令                                 │
│ @file      │ 引用文件进上下文                         │
│ !cmd       │ 直接执行 shell                           │
├────────────┼────────────────────────────────────────┤
│ CLAUDE.md  │ 项目说明书（4 层 + @import + rules/）    │
│ Auto Memory│ 自动记忆                                 │
│ Skills     │ SKILL.md 技能（含自定义命令）            │
│ Sub-agents │ .claude/agents/ 子代理                   │
│ Workflows  │ 动态工作流（ultracode）                  │
│ Routines   │ 云端例行任务（/schedule）                │
│ Hooks/MCP  │ 自动化 / 外部工具                        │
└────────────┴────────────────────────────────────────┘

八、官方文档导航

官方文档地址（已迁移）：https://code.claude.com/docs，全站索引见 llms.txt。

入门：概览 · 快速开始 · 工作原理 · 扩展概览

命令与交互：命令参考 · 交互模式 · CLI 参考 · 快捷键 · 终端配置 · 状态栏

配置与权限：设置 · 设置参考 · 模型配置 · 权限模式 · 权限规则 · Bash 沙箱 · auto 模式配置

记忆与上下文：记忆 · Prompt 缓存 · 上下文窗口 · 会话 · .claude 目录

代理与并行：子代理 · 并行对比 · Agent View · Agent Teams · 动态工作流 · Worktrees · 跨会话消息

扩展：Skills · 插件 · 发现插件 · MCP · Hooks · 输出风格 · Artifacts

工作流与自动化：Routines · 会话内调度 · 桌面定时任务 · 远程控制 · Headless · Agent SDK

最佳实践与排障：常见工作流 · Prompt 库 · 最佳实践 · 大代码库 · 成本 · 检查点 · 排障 · 调试配置

安全：安全 · 漏洞扫描 · 代码审查

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