Claude Code 不只是一个代码补全工具，它是一个Agent Runtime。本文基于日常使用 Claude Code 的实践，介绍它的五个扩展维度——从连接外部工具到一人构建完整产品。

每个维度解决一个核心问题：

1. MCP — 连接外部世界

1.1 解决什么问题

AI 是一个"封闭大脑"——它能写代码、做推理，但无法直接访问你的数据库、API、项目管理工具。

每个工具各自对接 AI 太碎片化。MCP（Model Context Protocol） 就是统一的"USB-C 接口"：一个开源标准协议，让 AI 一次接入、处处可用。

1.2 在 Claude Code 中怎么用

1
2

# 接入远程服务（推荐 HTTP 方式）
claude mcp add --transport http notion https://mcp.notion.com/mcp

1.3 实际场景，你可以用自然语言驱动外部系统：

• GitHub：“在 GitHub 上创建 PR”
• 数据库：“根据 PostgreSQL 数据库，找到最近 90 天没有购买的客户”

优劣速览

2. Skills — 可复用的工作流

2.1 解决什么问题

你发现自己每次让 Claude 审查代码时，都要写一大段提示词：“检查错误处理、关注安全问题、按优先级输出……”

Skills 就是把这些重复的 AI 交互模式沉淀下来，变成一个可复用的模板。像团队的"SOP"一样，让 AI 每次都按规范执行。

2.2 在 Claude Code 中怎么用

创建 Skill —— 一个 Markdown 文件，放到指定目录：

1
2

~/.claude/skills/review/SKILL.md      # 个人 Skill，所有项目可用
.claude/skills/review/SKILL.md        # 项目 Skill，可提交到 Git 共享

SKILL.md 结构：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

---
name: review
description: 审查代码质量和安全问题。当审查代码、检查 PR 时使用。
---

审查代码时，检查以下方面：
1. 代码组织和结构
2. 错误处理是否完善
3. 安全隐患
4. 测试覆盖率

按优先级输出：
- 🔴 必须修复
- 🟡 建议修复
- 🟢 可以改进

两种调用方式：

支持参数传递：

1
2

/review src/auth/login.ts   # $ARGUMENTS = "src/auth/login.ts"
/fix-issue 123               # $ARGUMENTS = "123"

2.3 两类 Skill

任务类 Skill 通常设置 disable-model-invocation: true，防止 Claude 自动运行（比如你不希望 Claude 觉得代码看起来准备好了就自己部署）。

优劣速览

3. Hooks — 确定性的自动化

3.1 解决什么问题

有些操作必须每次都发生，不能依赖 AI “记得"去做：

• 编辑完文件 → 必须运行 Prettier 格式化
• 修改了 .env → 必须阻止
• Claude 完成任务 → 必须发桌面通知

这些是确定性规则，不是 AI 判断。Hooks 就是在 Claude Code 生命周期的特定节点上，系统级强制执行的 shell 命令。

3.2 与 Skills 的关键区别

容易混淆的两个概念：

3.3 在 Claude Code 中怎么用

通过 /hooks 菜单交互式配置，或直接编辑 settings.json。

生命周期事件（Hook 的触发点）：

退出码决定行为：

3.4 实际场景（PostToolUse）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
      }]
    }]
  }
}

阻止修改敏感文件（PreToolUse）：

1
2
3
4
5
6
7
8
9

#!/bin/bash
FILE_PATH=$(cat | jq -r '.tool_input.file_path // empty')
for pattern in ".env" "package-lock.json" ".git/"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blocked: $FILE_PATH matches protected pattern '$pattern'" >&2
    exit 2  # 阻止操作
  fi
done
exit 0

Claude 完成后桌面通知（Notification）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "hooks": {
    "Notification": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
      }]
    }]
  }
}

3.5 四种 Hook 类型

3.6 优劣速览

4. Subagents — 任务委派与隔离

4.1 解决什么问题

当你让 Claude 做一个复杂任务时：

• 跑测试的输出占满了上下文窗口，Claude “忘记"了之前的讨论
• 你想让 AI 只能读代码、不能改代码，但主对话没法这样限制
• 多个独立的调查任务只能串行执行，效率低

Subagents 就是专业化的子代理——每个在自己的上下文窗口中运行，有独立的工具权限、模型选择和系统提示。完成后只把摘要返回主对话。

4.2 在 Claude Code 中怎么用

自定义 Subagent——一个 Markdown 文件：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

<!-- 文件：.claude/agents/code-reviewer.md -->
---
name: code-reviewer
description: 代码审查专家。代码修改后主动审查。
tools: Read, Grep, Glob, Bash
model: sonnet
memory: user
---

你是一个高级代码审查专家。被调用时：
1. 运行 git diff 查看最近修改
2. 聚焦修改的文件
3. 按优先级输出反馈：🔴 必须修复 / 🟡 建议修复 / 🟢 可改进

存储位置决定作用域：

4.3 核心能力

独立上下文：Subagent 在自己的上下文窗口中运行，不污染主对话。跑测试输出 10000 行？Subagent 消化后只返回"3 个测试失败，原因是……”

工具限制：

1
2

tools: Read, Grep, Glob      # 只允许只读工具
disallowedTools: Write, Edit  # 明确禁止写入

前台 vs 后台：

按 Ctrl+B 可以把正在运行的前台任务放到后台。

持久记忆：设置 memory: user 后，Subagent 会在 ~/.claude/agent-memory/ 中积累知识，跨会话保留。

4.4 使用模式

4.5 优劣速览

5. Plugins — 打包与分发

5.1 解决什么问题

你精心打造了一套 Skills、配置了 Hooks、定义了 Subagents——但它们都是零散的文件，团队共享靠手动拷贝目录。

Plugin 不是新能力，是已有能力的容器。它把 Skills + Agents + Hooks + MCP Servers 打包成一个可安装、可版本化、可分发的扩展包。

类比：Plugin 之于 Skills/Hooks/Agents，就像 npm package 之于 .js 文件。

5.2 在 Claude Code 中怎么用

Plugin 目录结构

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # 清单文件（名称、版本、描述）
├── skills/                  # Skills
│   └── review/
│       └── SKILL.md
├── agents/                  # Subagents
│   └── code-reviewer.md
├── hooks/                   # Hooks
│   └── hooks.json
├── .mcp.json                # MCP Server 配置
└── settings.json            # 默认设置

plugin.json 清单：

1
2
3
4
5
6

{
  "name": "my-team-toolkit",
  "description": "团队开发工具包：代码审查、提交规范、自动格式化",
  "version": "1.0.0",
  "author": { "name": "Your Team" }
}

开发测试：

1
2

claude --plugin-dir ./my-plugin           # 本地加载测试
claude --plugin-dir ./p1 --plugin-dir ./p2  # 同时加载多个

命名空间隔离：Plugin 内的 Skill 自动加前缀，避免冲突：

1
2

/review                    # 独立 Skill
/my-team-toolkit:review    # Plugin 内的 Skill

5.3 独立配置 vs Plugin

建议：从 .claude/ 中的独立配置开始快速迭代，准备好共享时再转换为 Plugin。

5.4 优劣速览

6. Solopreneur — 一人军团

6.1 为什么成为可能

上述五层能力叠加，让一个人拥有了完整的研发工作流：

一个人 + Claude Code = 前端 + 后端 + 测试 + 运维 + 产品。

6.2 适用边界

Solopreneur 不是取代团队，而是放大个体能力。适合从 0 到 1，规模化后仍需要团队。

7. 总结：如何选择

核心原则：Skills 管"应该怎么做"，Hooks 管"必须怎么做"，Subagents 管"谁来做"，MCP 管"用什么做"，Plugins 管"怎么分享"。

8. 最后，两个问题

8.1 Have you prepared for AlphaGo?

2016 年，AlphaGo 击败李世乭。围棋界没有消亡，但围棋的训练方式、竞技格局、甚至对弈的意义，都被永久改变了。

今天的 Agent，仿佛也正处在类似的拐点。你准备好了吗？

8.2 Enthusiasm, or just a job?

当 AI 写代码比你快、比你不知疲倦、甚至在某些场景下比你准确——一个问题浮出水面：

编程，是你热爱的事，还是只是一份工作？

参考

• Claude Code 官方文档