Claude Code 九大高级功能实战：子代理、技能、钩子与无头模式全解析

Claude Code 的多数用户停留在基础对话和代码生成层面，但它真正区别于普通 AI 编程工具的能力，藏在一些不太为人所知的高级功能里。一位 B 站 UP 主通过九个实操演示，系统展示了从自定义子代理到无头模式、从工作树并行到会话分支管理的完整进阶路径。这些功能组合起来，本质上是在把 Claude Code 从一个「会写代码的聊天窗口」改造成可编排、可隔离、可回滚的工程化开发环境。

子代理：让主线程保持精简

Claude 本身就能自动派生子代理并行处理任务，但自定义子代理的价值在于「可控」。在项目根目录创建 .claude/agents/ 文件夹，放入若干 Markdown 文件，即可定义专属代理。每个代理可指定名称、描述、允许使用的工具集，以及可选的模型——后者在大量调用子代理时能显著降低成本。

实际使用时，运行 /context 命令可确认自定义代理是否被正确加载。当发出「请审查这个 PR」之类的请求时，Claude 会自动调用 reviewer 子代理，在其独立线程中执行任务，只把最终结论带回主线程。这种隔离机制带来的收益很直接：每个子代理拥有独立的上下文窗口，只需了解自己负责的那部分信息，精度通常高于把所有内容塞进一个庞大线程——后者在接近上下文上限时表现会明显退化。

技能：可复用工作流与手动锁

技能（Skills）本质是一个描述固定流程的 Markdown 文件，存放在 .claude/skills/ 下。模型在需要时会自动发现并调用，你也可以用斜杠命令手动触发。演示中出现了两个项目级技能：deploy 和 rollback。

一个少有人知的配置项是 disable model invocation。加上这个标记后，技能不会进入模型上下文，也就不会被自动调用，只能由用户手动执行。演示中的 rollback 技能就处于这种「锁定」状态，适合那些不希望 AI 擅自触发的敏感操作。技能还支持带参数调用，例如 /deploy staging，模型会据此理解目标环境并走完整个流程。

斜杠命令（slash command）是 Claude Code 中以 / 开头的内置指令，如 /context、/rewind、/branch，由客户端直接解析执行，而非发送给模型。技能与斜杠命令的区别在于触发主体：技能是模型可自主发现的 Markdown 流程描述，斜杠调用只是手动入口；而内置命令完全由程序处理。disable model invocation 的作用正是切断模型侧的自动发现通道，使技能退化为纯手动命令。这种设计让同一套技能库可以混合「可自动执行」与「仅人工触发」两类流程，无需维护两套机制。

钩子：在代理循环的关键节点插入脚本

钩子（Hooks）是这批功能中门槛最高的一个。Claude 的代理循环会产生一系列事件——会话开始、用户提交提示、工具调用前、工具调用后等。钩子允许你绑定 Bash 命令到这些事件上，实现自动化干预。

配置方式是创建 .claude/hooks/settings.json，在其中声明事件与脚本的映射。演示中配置了两个钩子：post tool use 匹配 edit 和 write 操作，触发 Prettier 自动格式化；pre tool use 运行危险命令拦截脚本，若返回退出码 2 则阻止该工具调用。实际测试中，让 Claude 向一个格式混乱的 JS 文件添加函数，编辑完成后钩子自动运行，整个文件被重新格式化，全程无需人工介入。这种机制把代码规范和操作安全从「靠提示词约束」变成了「靠脚本强制执行」。

退出码语义是理解钩子拦截机制的关键。在 Unix 惯例中，退出码 0 表示成功，非 0 表示失败；钩子协议在此基础上做了约定：退出码 2 被特殊解释为「阻止本次操作」，脚本的 stderr 内容会作为反馈回传给模型，使其知道操作被拒绝及原因，从而调整后续行为；其他非 0 退出码通常只记录错误但不阻断。因此危险命令拦截脚本需要在命中规则时显式 exit 2。同理，post tool use 钩子若返回非 0，可让模型感知到格式化失败并尝试修复。理解这套约定，才能写出既能拦截又能给模型有效反馈的钩子。

MCP 服务器：接入外部工具生态

MCP（Model Context Protocol）服务器让 Claude 连接外部服务。演示以 Granola 的官方 MCP 服务器为例——这是一款 AI 会议笔记工具，自动转录电脑音频而无需机器人加入通话。连接后，可以直接向 Claude 提问「我最近一次印尼语课学了什么」，它会调取转录记录并给出答案。对开发者而言，MCP 的意义在于把 Claude Code 的上下文边界从本地文件扩展到任意可接入的外部数据源。

MCP（Model Context Protocol）是 Anthropic 于 2024 年底开源的开放协议，用于标准化 AI 应用与外部数据源、工具之间的连接。它采用客户端-服务器架构：Claude Code 作为客户端，MCP 服务器则封装某一类能力，通过 JSON-RPC 暴露 resources（可读取的数据）、tools（可调用的函数）和 prompts（预设提示模板）三类原语。服务器可由第三方提供，也可自行编写，传输方式支持本地 stdio 和远程 HTTP/SSE。相比为每个服务单独写集成代码，MCP 让同一份服务器实现能被任意兼容客户端复用，这也是它被称为「AI 应用的 USB-C 接口」的原因。

工作树：并行代理的隔离底座

同时跑多个代理时，最大的风险是它们互相覆盖改动。Git worktree（工作树）提供了隔离副本，效果类似分支但更适合代理场景。启动时加上 --worktree 参数并命名，例如 claude --worktree fix-delete-bug，Claude 就会在这个独立副本中工作。

演示中开了两个工作树，一个修删除 bug，一个加暗色模式，两边互不干扰。完成后在普通会话中让 Claude 找出所有工作树的改动，确认隔离性后将变更合并回主仓库。对于需要多线并行的项目，这个功能几乎是必备的。

Git worktree 是 Git 2.5 引入的功能，允许同一个仓库同时检出多个工作目录，每个目录对应不同的分支或提交，而共享同一份 .git 对象库。与克隆多个副本相比，worktree 不重复存储历史，磁盘占用小、创建速度快。它的典型用途是紧急修复：主目录正在开发新功能时，另开一个 worktree 检出 hotfix 分支，修完即可合并，无需 stash 或切换分支。对代理场景而言，关键在于每个 worktree 是物理隔离的目录，不同代理的读写互不干扰，也不会因并发切换分支而产生竞态。需要注意的是，同一分支不能在多个 worktree 中同时检出，合并时仍需处理常规的 Git 冲突。

无头模式：把 Claude 嵌入脚本

claude -p 让 Claude 脱离交互式终端运行，直接返回结果。演示中用 cat build_log.txt | claude -p "为什么构建失败" 把日志作为上下文注入，得到失败原因。加上 --output-format json 可以拿到结构化输出，包含结果、成本、轮次数和耗时，便于用 jq 解析。还可以用 --allowedTools read 限制工具权限，只允许读取操作。这意味着 Claude 可以被嵌入 CI 流水线、triage 脚本或任何需要一次性智能调用的场景。

检查点与回滚

Claude 会为不同构建自动创建检查点。演示中故意让 Claude 重命名所有函数导致应用崩溃，随后执行 /rewind，在对话历史中选择「rewrite」节点并恢复代码与对话，应用立即回到可用状态。对于频繁让 AI 大幅改动的开发者，这是比 Git 提交更轻量的安全网。

会话管理：继续、命名与分支

claude --continue 可直接回到当前目录的上一次会话。会话 ID 保存在本地，也可以跨目录手动指定。更有用的是 -n 参数为会话命名，例如 claude -n auth-refactor，之后用 --resume auth-refactor 精确恢复。界面右下角会显示当前会话名，避免在多个并行任务中迷失。

/branch 则从当前对话拉出一个分支，原会话不受影响。演示中在主会话基础上开分支，让 Claude 尝试把整个模块重写为静态方法类这种高风险改动，确认不满意后用 /resume 切回原会话，分支中的改动完全不生效。命名、分支、恢复三者组合，可以支撑起一套相当精细的多任务并行工作流。

把这九个功能放在一起看，Claude Code 的设计意图就很清楚了：子代理和技能解决「做什么、怎么做」的复用问题，钩子解决「什么时候必须做什么」的强制约束，工作树和会话分支解决「并行时如何不打架」，无头模式解决「如何被别的系统调用」，检查点和回滚解决「搞砸了怎么办」。单看每个功能都不复杂，但组合起来，它已经具备了一个可编排开发环境的基本骨架。对每天与 Claude Code 打交道的开发者来说，值得优先尝试的是工作树隔离和钩子自动化——前者在并行场景下能立刻避免混乱，后者能把重复性的规范检查彻底从提示词中解放出来。