Claude Code 进阶使用：Subagents、第三方插件、Hooks、记忆与工作流

小白快速学claude code～如果你已经会用 Claude Code 做基础编码，那么可以继续看这篇：

1. 用 /agents 配置专用 subagents
2. 安装第三方插件，比如 claude-hud
3. 用 /hooks 做自动化拦截和扩展
4. 用 /init 和 /memory 管理长期记忆

我会把自己实际踩过的坑和正确配置方式整理一下，方便小白上手，本系列持续更新！

---

1. /agents：给 Claude Code 配专用 subagents

Claude Code 内置的是 /agents。

它的作用是创建和管理专用 subagents。你可以把它理解成“给 Claude 预设几个不同分工的小助手”，比如：

• design-agent：负责方案设计、组件拆分、交互思路
• debugger：负责定位报错、分析调用链、排查异常
• bug-fixer：负责修复具体 bug 并验证结果

创建方式

终端打开claude后，进入需要生成代码的文件夹，然后输入claude激活claude，看到这个小

可爱图标就代表进入claude终端，可以开发了！

在 Claude Code 里输入：

/agents

然后按界面提示操作：

1. 选择 Create New Agent 写提示词
2. 选择存放范围
   • Project：当前项目可用，适合团队共享
   • User：全局可用，适合个人长期使用
3. 填写 agent 的用途描述
4. 配置它允许使用的工具权限：配置权限 enter选择 回到continue \
5. 保存
6. 使用errorAgent，bugAgent，designAgent，用@
   @“designAgent”
   @“errorAgent”
   @“bugAgent”

怎么调用

官方更推荐自然语言叫他名字调用，比如：

使用 debugger subagent 调试问题
使用  design-agent subagent 帮助设计
使用用 bug-fixer subagent 调试登录出现的问题

Claude Code 也可能根据任务内容自动委派给合适的 subagent，但如果你想明确控制，最好直接写清楚让哪个 subagent 来做，比把所有事情都塞给主线程更清晰，也更适合复杂项目。

---

2. 安装第三方插件：以 claude-hud 为例

claude-hud 默认官方市场里没有，所以要先添加第三方市场源，再安装插件。

方式一：用仓库短地址添加

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud

方式二：用 HTTPS 地址添加

可以直接用 HTTPS 地址：

/plugin marketplace add https://github.com/jarrodwatts/claude-hud.git
/plugin install claude-hud

这两种方式本质一样，公共仓库用 HTTPS 会更省事。

安装完成后，建议再执行一次：

/reload-plugins

---

3. /hooks：让 Claude 在特定时机自动执行规则

`/hooks`` 是 Claude Code 很实用的一块。

它的作用是：在 Claude 调用工具的不同阶段，自动执行你定义的命令或脚本。常见用途包括：

• 拦截危险 Bash 命令
• 记录日志
• 自动格式化文件
• 弹出通知
• 在子代理结束后做额外处理

比如：

• PreToolUse：工具执行前触发
• PostToolUse：工具执行后触发
• UserPromptSubmit：你发送消息前触发
• Stop：Claude 回答结束后触发
• SubagentStop：subagent 结束后触发

打开 hooks 配置

在 Claude Code 里输入：

/hooks

当前claude项目init后会生成隐藏.claude文件夹 （command+shift+G显示隐藏文件） .claude/settings.json如下，添加hooks 也可以直接看配置文件，常见位置有：

• 用户级：~/.claude/settings.json
• 项目级：.claude/settings.json
• 本地项目级：.claude/settings.local.json

如果是 macOS也可以在终端里打开配置目录：

open ~/.claude

注意：open 是 macOS 命令，Windows 和 Linux 不是这个写法。

hooks 的正确配置格式

它需要按事件名组织。

正确格式示例：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "echo tool finished"
          }
        ]
      }
    ]
  }
}

其中：

• PostToolUse：表示在工具执行完成后触发
• matcher：匹配哪些工具，* 表示全部
• hooks：实际执行的命令列表
• type：目前常见是 command
• command：要执行的 shell 命令

例子：拦截删除文件

如果你想在 Claude 即将执行删除命令时提醒，可以用 PreToolUse + Bash：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.command' | grep -E '(^|[[:space:]])(rm|unlink)([[:space:]]|$)|\\bdelete\\b' >/dev/null && { echo '危险操作：正在删除文件，可能不可恢复，请确认是否继续'; exit 2; } || exit 0"
          }
        ]
      }
    ]
  }
}

这个例子的思路是：

• 如果检测到 rm、unlink、delete 等删除行为
• 就返回阻断信息
• 让 Claude 感知到这是危险操作

在claude里面输入/hooks 终端打开 open ~/.claude

在当前项目打开。claude里面的setting。json文件，添加hooks函数

Tip:

hooks 改完以后，不一定会在当前会话立刻生效。

Claude Code 会在启动时对 hooks 做快照。如果你是手改配置文件，通常需要回到 /hooks 里确认，或者重开会话。

hooks具体架构图如下：

官网链接：code.claude.com/docs/en/hoo…

---

4. claude-hud 插件怎么正确生效

这里很容易被网上一些帖子误导。

claude-hud 的核心不是“你手动写一段 hooks 它才活”，而是它走 Claude Code 的 statusline 能力。

正确步骤

安装完插件后，在 Claude Code 里执行：

/claude-hud:setup

然后按提示完成配置。

最后，完整重启 Claude Code，让新的状态栏配置生效。

常见误区

很多人会以为必须在 settings.json 里手写这种内容：

{
  "type": "PostToolUse",
  "command": "claude-hud update",
  "description": "Update HUD after every tool execution",
  "condition": "true"
}

这段写法本身就不是官方 hooks 的正确 schema，而且 claude-hud 官方安装流程里重点是 /claude-hud:setup，不是让你手搓这段配置。

所以更稳妥的结论是：

• claude-hud 安装后先运行 /claude-hud:setup
• 然后重启 Claude Code
• 如果 HUD 没出来，再排查插件安装、Node 运行时、状态栏配置是否写入成功

---

5. Superpowers：给 Claude Code 装一套工作流能力

如果你想把 Claude Code 从“能聊天写代码”，升级到“有方法论地做规划、调试、执行”，那 superpowers 很值得装。

仓库地址：

obra/superpowers

安装方式

先添加 marketplace：

/plugin marketplace add obra/superpowers-marketplace

再安装插件：

/plugin install superpowers@superpowers-marketplace

安装后你会多出一套面向开发流程的能力，比如：

• 规划
• 调试
• 执行分步任务
• 结构化工作流
• 更明确的协作模式

如果你经常做复杂工程而不是一次性问答，这类插件会明显提高上限。

---

6. Claude Code 的记忆系统

Claude Code 的“记忆”不是玄学，它是有文件载体的。

1）静态记忆：/init

在项目里执行：

/init

它会帮你初始化项目记忆文件 CLAUDE.md。

这个文件适合写：

• 项目结构
• 常用命令
• 团队约定
• 编码规范
• 特殊注意事项

2）动态维护记忆：/memory

执行：

/memory

可以直接管理 Claude Code 当前加载的记忆文件。

适合记一些长期偏好，比如：

• 我更偏好什么代码风格
• 这个项目常用什么命令
• 某些依赖安装习惯
• 哪些目录不要乱动

比如你个人习惯是“安装插件优先试 cnpm 而不是 npm”，这可以写进你自己的记忆里。但要注意，这属于个人偏好，不是 Claude Code 的官方要求。

3）项目辅助记忆工具

这一块社区里也有一些配套项目，用来更方便地查看 Claude 本地历史或会话记录。

不过这类第三方工具更新很快，仓库名也可能变更。发文章前，建议你自己再打开一次仓库确认：

• 仓库是否还存在
• README 是否还能跑通
• 启动命令是否还是原来的 ./start.sh

如果你想写一个“已验证可用”的替代参考，我更建议先看这个项目：

raine/claude-history

它是一个查看 Claude Code 本地对话历史的工具，功能和定位都比较清晰。

7. 我自己总结的几个实用建议

1）项目共享配置和个人配置分开

• .claude/settings.json：项目共享
• .claude/settings.local.json：个人本地实验，不提交
• ~/.claude/settings.json：全局用户级配置

这样最不容易污染团队仓库。

2）Hooks 很强，但也很危险

因为 hooks 本质上是在自动执行 shell 命令。

它确实很爽，但也意味着：

• 写错了可能误删文件
• 写复杂了可能难排查
• 引入陌生脚本有安全风险

所以建议先从简单的日志、提醒、校验做起。

3）Subagents 适合复杂任务，不适合一切都拆

subagents 的优势是分工明确、上下文隔离，但不是所有任务都需要拆成 3 个 agent。

更适合：

• 一个任务里有明确的设计、调试、修复分工
• 你希望某类任务有固定处理方式
• 你想把某些经验沉淀成长期可复用的 agent

---

结语

Claude Code 真正强的地方 已经开始具备：

• 可配置的 subagents
• 可扩展的插件系统
• 可自动化的 hooks
• 可积累的记忆系统

最后我想说，现在很多 AI 教程的问题太容易把效果说满。
动辄就是“接管开发”“一键自动化”“零基础也能做产品”，这类表达确实抓眼球，也会把大家对工具的预期抬得很高。真把这些东西放进项目里，体感往往会更复杂一些。提效是真的，省事也是真的，但前提是配置、边界和使用方式都得一起跟上。

比如，好工具可以省掉很多重复劳动，可配置没理顺，新的麻烦也会跟着出现；
自动化确实方便，hook 这类能力一旦写得草率，后面的排查成本反而更高；
多 agent 听起来很强，可一旦分工失焦，上下文只会更乱。
记忆、插件、工作流这些能力也差不多，关键在有没有结合自己的项目习惯慢慢调顺。

以我的角度，Claude Code 看成一种工程放大器。
让原本就比较清楚的习惯、流程和判断，它会帮你放大；
让零散、重复、机械的开发动作接过去，让协作顺一点、切换成本低一点。
实际用下来也更容易看见它真正值钱的地方。

---

参考：

• Anthropic 官方 /agents / slash commands / settings / memory / hooks 文档
  Slash commands
  Subagents
  Settings
  Memory
  Hooks reference
  Hooks guide

• 插件仓库
  claude-hud
  superpowers
  superpowers marketplace
  claude-history