适用读者已经在用或准备上手Claude Code 的开发者。本篇是关键功能地图 速查手册slash 命令、项目记忆 CLAUDE.md、Hooks、Subagents、自定义 Skills、交互快捷键六大板块。阅读建议第一遍通读建立全景认知之后当速查手册用。所有内容基于官方文档2026-09 版本v2.1.x参考链接见文末。一、先建立全景Claude Code 的能力分层Claude Code 是运行在终端里的 AI 编程 Agent。初学者往往只用它对话写代码但它真正的提效来自这套分层机制层机制一句话理解交互层Slash 命令 / 快捷键 / Shell 模式直接操控工具本身记忆层CLAUDE.md / Auto Memory让 AI 每次会话都记得项目规矩扩展层自定义 Skills原自定义命令把重复流程固化成/命令自动化层Hooks在关键事件点上自动执行你的脚本分身层Subagents派出独立上下文的分身干活保护主对话下面逐层展开。二、会话基础启动与恢复claude# 在当前目录进入交互会话claude修复这个bug# 带初始任务进入会话claude-p总结这个项目# 非交互模式print mode输出后退出适合脚本/CIclaude-c# 继续最近一次会话--continueclaude--resume# 打开会话选择器恢复历史会话claude--agentcode-reviewer# 以某个 subagent 的角色启动整个会话会话中的第一件事如果项目还没有CLAUDE.md先跑/init见第四章。三、内置 Slash 命令速查在输入框敲/会弹出全部可用命令输入字母过滤。命令必须写在消息开头后面的文字作为参数。以下按使用场景精选官方全部命令中的高频子集。3.1 会话与上下文管理最常用命令作用/clear [名称]清空上下文开始新对话。每换一个新任务就应 clear避免无关上下文拖累质量/compact [指示]把当前对话压缩成摘要以释放上下文可传侧重指示如保留接口设计细节/context彩色网格可视化当前上下文占用给出优化建议/resume [会话]按 ID/名称恢复历史会话/branch [名称]从当前位置分叉出对话分支试一条不同思路而不污染主线/rewind把代码和/或对话回滚到之前的检查点快捷键Esc Esc也可触发/rename [名称]给当前会话命名方便日后/resume/export [文件名]把当前对话导出为纯文本/recap一句话总结当前会话进展3.2 项目初始化与记忆命令作用/init新项目第一步扫描代码库并生成初始CLAUDE.md/memory编辑各层级CLAUDE.md或开关 Auto Memory详见第四章/add-dir path给当前会话增加额外可访问目录/cd path会话切换工作目录保持对话不中断3.3 模型与行为配置命令作用/model [模型]切换模型并设为默认/effort [级别]调节推理力度low到xhigh越高思考越深、耗时越长/config打开设置界面主题、输出样式、编辑行为等/permissions管理工具权限的 allow / ask / deny 规则/sandbox开关沙箱模式受支持的平台/statusline配置状态栏显示内容用自然语言描述即可3.4 代码工作流命令作用/plan [描述]直接进入计划模式先探索和给方案批准后再动代码/diff查看工作区变更含 AI 本轮做的修改/code-review [力度] [--fix] [--comment] [pr#]内置 Skill审查当前 diff 或指定 PR可自动修复/留评/security-review对当前分支变更做安全漏洞分析/verify内置 Skill验证刚才的改动是否真的达成了目标跑应用验证非空谈/simplify内置 Skill审查改动代码清理不必要的复杂度/install-github-app为仓库安装 Claude GitHub AppPR 自动响应3.5 代理、任务与自动化命令作用/agentsSubagent 管理入口详见第六章/tasks查看当前会话的后台任务与 subagent 运行状态/subtask 任务派生一个后台分身 subagent 去执行任务/hooks查看已配置的 hooks详见第五章/mcp管理 MCP 服务器连接与 OAuth 认证/skills列出可用 skills/reload-skills热重载/goal [条件]设定目标Claude 会跨回合持续工作直到条件达成/schedule [描述]创建定时例行任务routines/deep-research 问题Workflow并行铺开多路网络搜索做深度调研3.6 诊断与帮助命令作用/doctor体检诊断安装、配置、网络等常见问题/status查看版本、模型、账号、连接状态/usage查看费用、套餐用量与统计/cost是别名/bug//feedback反馈问题/release-notes查看版本更新日志/insights生成 HTML 报告分析你最近的会话使用情况/powerup交互式功能课程适合新手系统学习/help帮助与命令列表版本提示命令列表随版本演进很快如/vim已并入/config/pr-comments已移除/agents从交互向导改为提示直接编辑文件。以你本机/help和官方文档为准。四、项目记忆CLAUDE.md 体系4.1 两种记忆机制CLAUDE.mdAuto Memory谁来写你Claude 自己内容规矩与指令编码规范、构建命令它学到的偏好与教训你的纠正、项目背景加载每次会话全文加载每次会话加载前 200 行 / 25KB适用每次都必须遵守的规则免手动维护的隐性知识积累4.2 CLAUDE.md 的四个层级加载顺序从宽到窄内容是拼接而非覆盖层级位置用途组织策略/Library/Application Support/ClaudeCode/CLAUDE.mdmacOS等公司统一管控用户级~/.claude/CLAUDE.md你的个人偏好跨所有项目项目级./CLAUDE.md或./.claude/CLAUDE.md项目规矩提交到 git 供团队共享本地级./CLAUDE.local.md个人临时规则加入 .gitignore加载规则启动时加载当前目录及所有祖先目录的 CLAUDE.md子目录里的文件在 Claude 读到该目录文件时按需加载。大型项目可用.claude/rules/*.md按主题拆分规则并支持用 glob 限定生效范围如只对*.ts生效。4.3 写好 CLAUDE.md 的经验法则什么时候写进去同一个错误 Claude 犯第二次时你在聊天里重复解释同一件事时新同事入职需要知道的背景。写什么构建/测试命令、代码规范、项目结构、永远/绝不类规则。怎么写# 项目约定 ## 构建与测试 - 运行测试pnpm test不要用 npm - 提交前必须跑 pnpm lint pnpm test ## 代码规范 - 组件用函数式写法禁止 class 组件 - API 错误统一抛 AppError不要裸 throw ## 项目结构 - src/server/ 后端src/web/ 前端不要混放反面做法写成多步骤操作手册、塞入只跟单个文件相关的细节——这些应该做成 Skill下一章。五、自定义命令与 Skills旧版的自定义 slash 命令.claude/commands/目录已并入 Skills 体系每个 skill 就是一个带 frontmatter 的 Markdown 文件既可以被你用/名字手动触发也可以让 Claude 按描述自动调用。5.1 创建一个 Skill位置项目级.claude/skills/名字/SKILL.md随 git 共享个人级~/.claude/skills/名字/SKILL.md。也可以直接对 Claude 说帮我创建一个做 X 的 skill。--- name: fix-issue description: 根据议题编号修复 GitHub issue disable-model-invocation: true allowed-tools: Bash(gh issue view *) Bash(gh issue edit *) --- 修复 GitHub issue$ARGUMENTS 步骤 1. 用 gh issue view $0 读取议题内容 2. 定位相关代码并修复 3. 运行测试验证通过后提交5.2 关键 frontmatter 字段字段说明name/description必填。description 同时是 Claude 判断何时自动调用的依据disable-model-invocation: true只允许人工触发。适合/deploy、/commit这类有副作用的操作——不能让 Claude 自作主张allowed-tools该 skill 运行期间预批准的工具免权限弹窗下一轮消息自动失效$ARGUMENTS/$0$1参数占位符/fix-issue 123中$ARGUMENTS “123”$0 第一个参数context: fork在独立 subagent 上下文中运行不污染主对话5.3 管理/skills列出全部可用 skills/reload-skills热加载新改动的文件/skill-doctor查看每个 skill 的上下文成本与使用频率经验多步骤、有固定流程、要复用的事情做成 skill一次性的事直接对话即可。六、Hooks在关键事件点自动执行脚本6.1 是什么Hooks 是你定义的自动化处理器特定事件发生时如每次要执行 Bash 前、“每次编辑文件后”Claude Code 自动运行你的 shell 命令。它把AI 自觉遵守规矩升级为机制上强制执行。6.2 常用事件速查官方支持 30 事件最常用事件触发时机典型用途PreToolUse工具执行前拦截危险命令rm -rf、force pushPostToolUse工具执行后自动格式化 / lint 刚改的文件UserPromptSubmit用户提交提示词后注入上下文、敏感词过滤Notification发通知时转发到钉钉/Slack/系统通知StopClaude 完成响应时播放提示音、统计消耗SessionStart/SessionEnd会话开始/结束加载环境、清理临时文件PreCompact/PostCompact上下文压缩前后保留关键信息其余还有SubagentStart/Stop、PermissionRequest、PostToolBatch、FileChanged、CwdChanged、InstructionsLoaded等完整清单见官方 hooks 文档。6.3 配置结构三层嵌套事件 → matcher 组 → 处理器在~/.claude/settings.json全局或.claude/settings.json项目可提交共享中{hooks:{PreToolUse:[{matcher:Bash,hooks:[{type:command,command:${CLAUDE_PROJECT_DIR}/.claude/hooks/check-dangerous.sh}]}],PostToolUse:[{matcher:Write|Edit,hooks:[{type:command,command:${CLAUDE_PROJECT_DIR}/.claude/hooks/format.sh}]}]}}matcher匹配工具名Bash、Write|Edit、正则mcp__.*省略则匹配所有处理器类型以commandshell 命令为主输入 JSON 从 stdin 传入文件路径从 JSON 的tool_input.file_path读取${CLAUDE_PROJECT_DIR}指向项目根目录保证脚本无论从哪个目录启动都能被找到修改 hooks 后需重启会话或用/hooks菜单确认生效。6.4 输入与退出码脚本怎么说话Hook 脚本从 stdin 收到 JSON例如PreToolUse{session_id:abc123,hook_event_name:PreToolUse,tool_name:Bash,tool_input:{command:npm test,description:Run test suite}}退出码含义0成功。stdout 若是{...}会被解析为 JSON 决策如permissionDecision: deny部分事件的纯文本会注入为 Claude 可见上下文2阻断性错误PreToolUse阻止该工具调用、UserPromptSubmit拒绝该提示词、Stop阻止停止继续对话。stderr 会反馈给 Claude其他非阻断错误记录后动作继续⚠️ 要做强制策略就用exit 2不要依赖其他退出码。6.5 三个实用示例拦截危险命令PreToolUse matcherBash脚本检测tool_input.command含rm -rf /或git push --force则exit 2保存即格式化PostToolUse matcherWrite|Edit运行 prettier / gofmt完成提醒Stop事件调用系统通知或企业微信/钉钉 webhookAI 干完活自动喊人。七、Subagents独立上下文的分身7.1 是什么、为什么Subagent 是处理特定任务类型的专用 AI 助手核心特征是运行在独立的上下文窗口派出 → 独立完成 → 只把摘要带回主对话。最大价值保护主对话上下文。比如跑一遍测试套件会产生海量日志输出直接在主对话跑会把上下文塞满派给 subagent主对话只收到3 个失败用例这样的结论。7.2 创建方式文件位置与优先级同名取高优先级项目级.claude/agents/*.md可提交共享 用户级~/.claude/agents/*.md跨项目复用 插件提供。文件格式Markdown frontmatter正文即系统提示词--- name: code-reviewer description: 代码审查专家。在写完或修改代码后主动使用use proactively tools: Read, Glob, Grep --- 你是一名资深代码审查者。收到代码后按以下维度审查 1. 可读性与命名 2. 潜在 bug 与边界条件 3. 与项目规范的符合度 只报告问题按严重程度排序不要自己修改代码。常用 frontmatter 字段字段说明name/description必填。description 决定 Claude 何时自动委派tools工具白名单省略则继承全部。如审查型 agent 只给 Read/Grep防手滑改代码modelsonnet/haiku/opus/inherit等别名或完整模型 ID——可把简单任务路由给更快更省的模型memory持久记忆范围project可版本控制共享permissionMode权限模式default/plan/acceptEdits等7.3 怎么调用自动委派任务描述匹配 subagent 的 description 时 Claude 自动派出在 description 里写use proactively鼓励主动使用自然语言点名“让 code-reviewer 审一下这次改动” 引用保证执行输入从候选选择或直接agent-code-reviewer会话级claude --agent code-reviewer启动整个会话都用该分身的人设与工具限制。7.4 管理与限制/tasks查看运行中的 subagentCtrlB可把当前任务转入后台默认最多 20 个并发、最多 3 层嵌套派生均有环境变量可调内置 subagentExplore只读代码搜索、Plan规划研究、General-purpose复杂多步任务。7.5 什么时候用主对话什么时候用 subagent用主对话用 Subagent需要频繁往返迭代会产生大量中间输出跑测试、全库搜索多步骤间共享大量上下文任务自包含、只需返回结论快速小改动需要强制工具限制只读审查延迟敏感可并行的独立调研多个模块同时探索八、交互技巧与快捷键8.1 输入框里的四个魔法前缀前缀功能/Slash 命令或 Skill!Shell 模式直接执行终端命令输出进入会话上下文如!git status文件路径引用与自动补全精确把文件喂给 Claude?空输入时切换快捷键帮助面板8.2 高频快捷键快捷键功能Esc打断 Claude / 关闭对话框Esc Esc清空输入草稿或打开 rewind 回滚ShiftTab循环切换权限模式default逐个询问→ acceptEdits自动接受编辑→ plan计划模式CtrlR反向搜索历史输入CtrlO打开/关闭完整输出查看器CtrlB把运行中的任务转入后台CtrlT开关任务清单task checklistCtrlV粘贴剪贴板图片截图直接喂给 Claude 排 UI 问题OptionT/AltT开关扩展思考Extended ThinkingCtrlJ或\Enter多行输入任何终端通用ShiftEnter需终端支持8.3 两个提效细节消息排队Claude 正在干活时你也可以继续输入消息会排队依次处理不必干等/btw 问题就当前对话内容问个顺便一提的小问题不把主对话带偏——比派 subagent 更轻量。九、上手路径建议结合前面的分层推荐按这个顺序内化第 1 天/init生成 CLAUDE.md → 养成换任务先/clear的习惯 → 用!和第 1 周把团队规范写进 CLAUDE.md学会/plan计划模式和/compact//context上下文管理用 ShiftTab 切换权限模式第 2~3 周把重复流程固化为自定义 Skillsdisable-model-invocation: true控制手动触发配置 2~3 个高频 Hooks格式化、危险命令拦截进阶为代码审查、测试执行、独立调研创建 Subagents体验上下文隔离 并行分身的威力。十、参考资料Slash 命令全表官方Hooks 指南官方Subagents 指南官方Memory / CLAUDE.md官方Skills自定义命令官方Interactive Mode 快捷键官方 注Claude Code 迭代很快本文基于 v2.1.x 文档具体命令以本机/help与官方文档最新版为准。