🚀 深入理解 Claude Code：从入门到精通的能力全景图
🔥 本文目标：帮助开发者全面了解 Claude Code 的各项能力，从基础到高级，从原理到实战
📅 创建时间：2025-12-03 🎯 适用范围：CodeBuddy、Cursor、Claude for Desktop、VS Code 插件等 AI 编程助手 ⏱️ 阅读时长：约 30 分钟
写在前面
如果你正在使用 Claude Code 或者准备开始使用，你可能会有这些疑问：
- 🤔 Claude Code 到底能做什么？
- 🤔 那些 Commands、Skills、Rules、Hooks 都是什么？
- 🤔 MCP 协议是什么？怎么用？
- 🤔 这些能力是怎么一步步发展起来的？
别急，这篇文章会带你从头到尾 、由浅入深地了解 Claude Code 的全部能力。无论你是刚入门的新手，还是想深入探索的老手，相信都能有所收获。
先放一张能力全景图，让你有个整体印象：
scss
┌─────────────────────────────────────────────────────────────────────────┐
│ Claude Code 能力全景图 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 🧠 Claude 原生能力层 │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Vision (视觉) │ Tool Use (工具) │ Reasoning (推理) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ 🔧 扩展能力层 │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Commands │ Skills │ Rules │ Hooks │ Memories │ MCP │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ 🤖 高级能力层 │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Multi-Agent (多智能体) │ Workflow (工作流) │ Automation │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘📚 目录
- 第一部分：能力发展历程
- 第二部分：基础概念与配置
- [第三部分：Commands 命令系统](#第三部分：Commands 命令系统 "#%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86commands-%E5%91%BD%E4%BB%A4%E7%B3%BB%E7%BB%9F")
- [第四部分：Skills 技能系统](#第四部分：Skills 技能系统 "#%E7%AC%AC%E5%9B%9B%E9%83%A8%E5%88%86skills-%E6%8A%80%E8%83%BD%E7%B3%BB%E7%BB%9F")
- [第五部分：Rules 规则系统](#第五部分：Rules 规则系统 "#%E7%AC%AC%E4%BA%94%E9%83%A8%E5%88%86rules-%E8%A7%84%E5%88%99%E7%B3%BB%E7%BB%9F")
- [第六部分：Hooks 钩子系统](#第六部分：Hooks 钩子系统 "#%E7%AC%AC%E5%85%AD%E9%83%A8%E5%88%86hooks-%E9%92%A9%E5%AD%90%E7%B3%BB%E7%BB%9F")
- [第七部分：Memories 记忆系统](#第七部分：Memories 记忆系统 "#%E7%AC%AC%E4%B8%83%E9%83%A8%E5%88%86memories-%E8%AE%B0%E5%BF%86%E7%B3%BB%E7%BB%9F")
- [第八部分：Context Providers 上下文提供器](#第八部分：Context Providers 上下文提供器 "#%E7%AC%AC%E5%85%AB%E9%83%A8%E5%88%86context-providers-%E4%B8%8A%E4%B8%8B%E6%96%87%E6%8F%90%E4%BE%9B%E5%99%A8")
- [第九部分：MCP 模型上下文协议](#第九部分：MCP 模型上下文协议 "#%E7%AC%AC%E4%B9%9D%E9%83%A8%E5%88%86mcp-%E6%A8%A1%E5%9E%8B%E4%B8%8A%E4%B8%8B%E6%96%87%E5%8D%8F%E8%AE%AE")
- [第十部分：Multi-Agent 多智能体](#第十部分：Multi-Agent 多智能体 "#%E7%AC%AC%E5%8D%81%E9%83%A8%E5%88%86multi-agent-%E5%A4%9A%E6%99%BA%E8%83%BD%E4%BD%93")
- [第十一部分：Claude 原生能力](#第十一部分：Claude 原生能力 "#%E7%AC%AC%E5%8D%81%E4%B8%80%E9%83%A8%E5%88%86claude-%E5%8E%9F%E7%94%9F%E8%83%BD%E5%8A%9B")
- 第十二部分：完整工作流案例
- 第十三部分：最佳实践与踩坑指南
- 第十四部分：能力矩阵与学习路径
第一部分：能力发展历程
💡 为什么要先讲历史？ 了解能力的发展脉络，能帮你更好地理解每个能力的设计初衷和使用场景。
1.1 时间线总览
Claude Code 的能力不是一蹴而就的，而是经过了多个版本的迭代。下面这张时间线图展示了从 2024 年 3 月到 2025 年的完整演进过程：
yaml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Claude Code 能力发展时间线
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2024.03.04 ┃ 🎉 Claude 3 系列发布
┃ ├─ Opus / Sonnet / Haiku 三个版本
┃ ├─ 首次支持 Vision（图像理解）
┃ └─ 200K 上下文窗口
┃
2024.05 ┃ 🔧 Tool Use (Beta) 发布
┃ ├─ 函数调用能力
┃ ├─ 外部工具集成基础
┃ └─ 为后续 MCP 奠定基础
┃
2024.06.20 ┃ ⚡ Claude 3.5 Sonnet 发布
┃ ├─ Artifacts 功能（代码预览）
┃ ├─ 代码生成能力大幅提升
┃ └─ 性能超越 Claude 3 Opus
┃
2024.10.22 ┃ 🖥️ Computer Use 发布
┃ ├─ Claude 3.5 Sonnet 升级版
┃ ├─ AI 可以操作计算机界面
┃ └─ 模拟鼠标、键盘操作
┃
2024.11.25 ┃ 🔌 MCP (Model Context Protocol) 开源
┃ ├─ 标准化 AI 与外部服务的连接
┃ ├─ Claude for Desktop 首先支持
┃ └─ 开启 AI 工具生态时代
┃
2025.02.25 ┃ 🚀 Claude 3.7 Sonnet + Claude Code 发布
┃ ├─ 首个混合推理模型（Extended Thinking）
┃ ├─ Claude Code 终端 AI 代理
┃ ├─ 代码库理解、Git 集成、命令执行
┃ └─ 开发者效率革命性提升
┃
2025.03 ┃ 🧩 扩展生态成熟
┃ ├─ Commands（命令系统）
┃ ├─ Skills（技能系统）
┃ ├─ Rules（规则系统：Always/Requested/Manual）
┃ ├─ Hooks（钩子系统）
┃ ├─ Memories（记忆系统）
┃ ├─ Context Providers（上下文提供器）
┃ └─ 各 IDE 插件全面支持
┃
2025.05 ┃ 🤖 Code w/ Claude 大会
┃ ├─ Multi-Agent 协作模式
┃ ├─ 高级工作流最佳实践
┃ └─ 企业级应用案例分享
┃
2025.Q3+ ┃ 🔮 持续演进中...
┃ ├─ 更多 MCP 服务接入
┃ ├─ Agent 编排能力增强
┃ └─ 更智能的自动化工作流
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━1.2 各阶段详解
让我们把这个发展历程分成 六个阶段，每个阶段都有其核心突破：
🌱 第一阶段：基础对话（2024.03）
这是 Claude 3 系列的起点。在这个阶段，Claude 具备了：
| 能力 | 说明 |
|---|---|
| 文本理解与生成 | 强大的自然语言处理能力 |
| Vision 图像理解 | 可以"看懂"图片，分析设计稿 |
| 多语言支持 | 中英文等多语言流畅对话 |
| 200K 上下文 | 可以处理超长文档 |
这个阶段的 Claude 更像是一个"聊天助手"，虽然能力很强，但还不能直接操作外部世界。
🔧 第二阶段：工具集成（2024.05-10）
这是 Claude 从"聊天"走向"行动"的关键阶段：
markdown
Tool Use 架构
┌─────────────────────────────────────────────┐
│ Claude │
│ │ │
│ ▼ │
│ ┌────────────────────────────────┐ │
│ │ Tool Use API │ │
│ │ ┌──────┐ ┌──────┐ ┌──────┐ │ │
│ │ │ 函数1 │ │ 函数2 │ │ 函数3 │ │ │
│ │ └──────┘ └──────┘ └──────┘ │ │
│ └────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────┐ │
│ │ 外部服务/API │ │
│ └────────────────────────────────┘ │
└─────────────────────────────────────────────┘关键突破：
- Tool Use (2024.05)：Claude 可以调用预定义的函数
- Computer Use (2024.10)：Claude 可以像人一样操作电脑界面
🔌 第三阶段：协议标准化（2024.11）
MCP (Model Context Protocol) 的发布是一个里程碑事件。MCP 定义了一套标准协议，让 AI 可以统一地连接各种外部服务：
arduino
MCP 协议架构
┌─────────────────────────────────────────────────────┐
│ │
│ ┌─────────┐ MCP 协议 ┌─────────────┐ │
│ │ Claude │ ◄──────────────► │ MCP Server │ │
│ └─────────┘ └─────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ 外部服务 │ │
│ │ ├─ TAPD │ │
│ │ ├─ Git │ │
│ │ ├─ 数据库 │ │
│ │ └─ ... │ │
│ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────┘🚀 第四阶段：代理化编程（2025.02）
Claude Code 的发布，标志着 AI 编程助手进入了"代理"时代。
| 传统 AI 助手 | Claude Code（代理） |
|---|---|
| "你应该这样写代码..." | 直接帮你写好代码并保存 |
| "你可以运行这个命令..." | 直接帮你执行命令 |
| "建议你创建这个文件..." | 直接帮你创建文件 |
🧩 第五阶段：扩展生态（2025.03）
有了 Claude Code 这个"代理"，下一步就是让它更懂你的项目 、更符合你的习惯。这就是 Commands、Skills、Rules、Hooks、Memories、Context Providers 要解决的问题。
🤖 第六阶段：智能体协作（2025.05+）
单个 AI 代理已经很强了，但有些复杂任务需要多个专业化的 AI 协作完成。这就是 Multi-Agent 的思路。
1.3 各能力发布详情速查表
| 能力 | 首次发布 | 关键版本 | 说明 |
|---|---|---|---|
| Vision | 2024.03 | Claude 3 | 图像理解、设计稿分析 |
| Tool Use | 2024.05 | Claude 3 Beta | 函数调用、外部工具集成 |
| Artifacts | 2024.06 | Claude 3.5 Sonnet | 代码预览、可视化输出 |
| Computer Use | 2024.10 | Claude 3.5 升级版 | 模拟人类操作计算机 |
| MCP Protocol | 2024.11.25 | 开源协议 | 标准化外部服务连接 |
| Claude Code | 2025.02.25 | 与 3.7 Sonnet 同发 | 终端 AI 编程代理 |
| Commands | 2025.03 | Claude Code 扩展 | 快捷命令入口 |
| Skills | 2025.03 | Claude Code 扩展 | 复杂任务执行模块 |
| Rules | 2025.03 | Claude Code 扩展 | 行为约束规则 |
| Hooks | 2025.03 | Claude Code 扩展 | 事件驱动自动化 |
| Memories | 2025.03 | Claude Code 扩展 | 持久化上下文存储 |
| Context Providers | 2025.03 | Claude Code 扩展 | 自动上下文注入 |
| Multi-Agent | 2025.05 | 大会发布 | 多智能体协作 |
第二部分：基础概念与配置
2.1 什么是 Claude Code 扩展能力
扩展能力 ，简单说就是让 AI 更懂你的项目、更符合你的习惯的一系列配置。
打个比方：
- 原生的 Claude Code 就像一个刚入职的新员工，能力很强，但不了解公司的规范和流程
- 配置了扩展能力后，就像这个员工经过了入职培训，知道了公司的编码规范、项目结构、常用工具
扩展能力能帮你做什么？
| 痛点 | 扩展能力解决方案 |
|---|---|
| 每次都要重复说明项目背景 | Context Providers 自动注入项目信息 |
| AI 生成的代码不符合团队规范 | Rules 约束代码风格和安全规范 |
| 常用操作需要输入很长的指令 | Commands 定义快捷命令 |
| 复杂任务需要多个步骤 | Skills 封装完整的任务流程 |
| 希望某些操作自动执行 | Hooks 在特定事件时自动触发 |
| AI 记不住之前的决定 | Memories 持久化存储项目信息 |
| 需要获取 TAPD/Git 等外部数据 | MCP 连接外部服务 |
2.2 配置目录结构详解
所有扩展能力的配置，都放在项目根目录的 .codebuddy/ 文件夹下（不同 IDE 可能是 .cursor/ 或 .claude/）：
bash
项目根目录/
└── .codebuddy/ # 扩展能力配置根目录
│
├── commands/ # 📋 命令定义
│ ├── create-component.md # 创建组件命令
│ └── create-api.md # 创建 API 命令
│
├── skills/ # 🎯 技能定义
│ └── code-review/ # 每个技能一个文件夹
│ └── SKILL.md
│
├── rules/ # 📏 规则定义
│ ├── always/ # 始终生效的规则
│ │ └── security.md
│ ├── requested/ # AI 按需引用的规则
│ │ └── i18n.md
│ └── manual/ # 手动 @引用的规则
│ └── performance.md
│
├── hooks/ # 🪝 钩子定义
│ └── pre-commit.md
│
├── memories/ # 🧠 记忆存储
│ └── project-facts.json
│
├── context/ # 📄 上下文提供器
│ └── auto-inject.md
│
└── mcp.json # 🔌 MCP 服务配置2.3 各能力类型对比
| 能力类型 | 触发方式 | 主要用途 | 复杂度 | 推荐优先级 |
|---|---|---|---|---|
| Commands | /command 显式调用 |
快捷入口 | ⭐ | P0 |
| Skills | 被 Command 或 AI 调用 | 复杂任务执行 | ⭐⭐⭐ | P0 |
| Rules | 自动/按需/手动 | 约束 AI 行为 | ⭐⭐ | P0 |
| Hooks | 事件自动触发 | 自动化流程 | ⭐⭐ | P1 |
| Memories | AI 自动读取 | 持久化上下文 | ⭐ | P1 |
| Context | 自动注入 | 上下文增强 | ⭐ | P1 |
| MCP | AI 调用 | 外部服务集成 | ⭐⭐⭐ | P1 |
| Multi-Agent | 任务分发 | 复杂协作 | ⭐⭐⭐ | P2 |
推荐的学习顺序：
scss
Commands (最简单) → Rules → Skills → Hooks → Memories → Context → MCP → Multi-Agent (最复杂)第三部分：Commands 命令系统
3.1 Commands 是什么
Commands 是用户与 AI 交互的快捷入口 ，通过 /command 格式触发。
自定义 Commands 让你可以定义自己的快捷命令，比如：
/create-component UserList- 创建一个 React 组件/create-api users- 创建用户 API 模块/analyze-pr 123- 分析某个 PR
3.2 如何定义一个 Command
Command 使用 Markdown 文件定义，放在 .codebuddy/commands/ 目录下：
markdown
<!-- .codebuddy/commands/create-component.md -->
---
name: create-component
description: 🧩 创建 React 组件
---
# 创建 React 组件
## 使用方式
/create-component <组件名称> [--with-test]
## 参数说明
- `组件名称`：必填，PascalCase 格式
- `--with-test`：可选，同时生成测试文件
## 执行逻辑
1. 验证组件名称格式
2. 生成组件文件到 src/components/
3. 如果指定 --with-test，生成测试文件第四部分：Skills 技能系统
4.1 Skills 是什么
Skills 是 AI 的能力模块，定义了执行复杂任务的详细逻辑。
Skills 与 Commands 的区别：
- Commands 是"入口"，告诉 AI 要做什么
- Skills 是"执行者"，定义具体怎么做
4.2 Skill 的完整结构
markdown
<!-- .codebuddy/skills/code-review/SKILL.md -->
---
name: code-review
description: 自动代码审查
version: 1.0.0
---
# 代码审查技能
## 输入
- files: 要审查的文件列表
- checkTypes: 检查类型（security/performance/style）
## 输出
- summary: 问题汇总
- issues: 问题详情列表
## 执行逻辑
### Step 1: 读取文件
### Step 2: 执行检查
### Step 3: 生成报告第五部分：Rules 规则系统
5.1 Rules 是什么
Rules 是约束 AI 行为的声明式规则，确保生成的代码符合项目规范。
5.2 三种规则类型
| 类型 | 触发方式 | 适用场景 |
|---|---|---|
| Always | 始终生效 | 安全规则、核心编码规范 |
| Requested | AI 根据任务自动引用 | 特定领域规则（如 i18n） |
| Manual | 用户手动 @引用 | 可选的高级规则 |
5.3 实战案例：安全编码规则
markdown
<!-- .codebuddy/rules/always/security.md -->
---
name: security-rules
type: always
description: 🔒 安全编码规则
---
# 安全编码规则
## 1. 禁止硬编码敏感信息
❌ const API_KEY = 'sk-xxx';
✅ const API_KEY = process.env.API_KEY;
## 2. SQL 注入防护
❌ `SELECT * FROM users WHERE id = '${userId}'`
✅ db.query('SELECT * FROM users WHERE id = ?', [userId])第六部分：Hooks 钩子系统
6.1 Hooks 是什么
Hooks 是事件驱动的自动化机制。当特定事件发生时，Hooks 会自动执行预定义的操作。
6.2 支持的事件类型
| 事件 | 触发时机 | 典型用途 |
|---|---|---|
pre-commit |
提交前 | 代码检查、格式化 |
post-save |
保存后 | 自动格式化 |
on-file-create |
创建文件时 | 添加头部注释 |
after-skill |
技能执行后 | 验证结果 |
第七部分：Memories 记忆系统
7.1 Memories 是什么
Memories 是 AI 的持久化存储，用于保存项目事实、用户偏好和学习记录。
7.2 记忆类型
json
// .codebuddy/memories/project-facts.json
{
"techStack": {
"framework": "React 18",
"ui": "TDesign",
"state": "Redux Toolkit"
},
"conventions": {
"componentNaming": "PascalCase",
"fileNaming": "kebab-case"
}
}第八部分：Context Providers 上下文提供器
8.1 Context Providers 是什么
Context Providers 自动为 AI 注入相关上下文，减少重复说明项目背景。
8.2 自动注入示例
markdown
<!-- .codebuddy/context/auto-inject.md -->
---
name: project-context
inject: always
---
# 项目上下文
- 框架：React 18 + TypeScript
- UI 库：TDesign
- 构建工具：Vite第九部分：MCP 模型上下文协议
9.1 MCP 是什么
MCP (Model Context Protocol) 是 AI 与外部服务交互的标准协议，由 Anthropic 于 2024 年 11 月开源。
9.2 配置示例
json
// .codebuddy/mcp.json
{
"mcpServers": {
"tapd": {
"url": "https://mcp-oa.tapd.woa.com/mcp"
},
"gongfeng": {
"url": "https://mcp.git.woa.com/mcp"
}
}
}9.3 常用 MCP 服务
| 服务 | 用途 |
|---|---|
| TAPD | 获取需求、更新状态 |
| 工蜂 Git | 分支管理、MR 创建 |
| TDesign | 组件文档查询 |
第十部分：Multi-Agent 多智能体
10.1 Multi-Agent 是什么
Multi-Agent 是将复杂任务分解给多个专业智能体协作完成的机制。
10.2 智能体类型
| 智能体 | 职责 |
|---|---|
| Reviewer | 代码审查 |
| Tester | 测试生成 |
| Documenter | 文档编写 |
第十一部分：Claude 原生能力
11.1 Vision 视觉能力
可以分析 UI 设计稿、理解截图中的需求。
11.2 Tool Use 工具调用
支持文件读写、命令执行、外部服务调用。
11.3 Extended Thinking 深度推理
Claude 3.7 Sonnet 的混合推理能力，可以展示思考过程。
第十二部分：完整工作流案例
markdown
1. /specskills:launch "TAPD-123456789"
↓
2. AI 调用 TAPD MCP 获取需求详情
↓
3. analyze-requirements 技能分析需求
↓
4. 用户审核确认
↓
5. AI 按任务逐项实施
↓
6. post-apply Hook 自动验证第十三部分：最佳实践与踩坑指南
13.1 扩展组织原则
- 单一职责：每个 Skill 只做一件事
- 可组合性：Skills 可以相互调用
- 可测试性：定义清晰的输入输出
13.2 常见问题
| 问题 | 解决方案 |
|---|---|
| Rules 不生效 | 检查 type 是否正确（always/requested/manual） |
| MCP 连接失败 | 检查 token 配置和网络 |
| Skill 执行超时 | 拆分为更小的步骤 |
第十四部分：能力矩阵与学习路径
14.1 能力矩阵
| 能力 | 复杂度 | 价值 | 推荐优先级 |
|---|---|---|---|
| Commands | ⭐ | 高 | P0 |
| Rules (Always) | ⭐⭐ | 高 | P0 |
| Skills | ⭐⭐⭐ | 高 | P0 |
| Hooks | ⭐⭐ | 高 | P1 |
| MCP | ⭐⭐⭐ | 高 | P1 |
| Memories | ⭐ | 中 | P1 |
| Context | ⭐ | 中 | P1 |
| Multi-Agent | ⭐⭐⭐ | 中 | P2 |
14.2 推荐学习路径
入门：Commands → Rules
进阶：Skills → Hooks → Memories
高级：MCP → Multi-Agent写在最后
Claude Code 的能力体系是一个持续演进的生态。本文介绍的内容是截至 2025 年 12 月的状态，随着 Anthropic 的持续更新，会有更多强大的能力加入。
一句话总结：Claude Code 的能力体系，是从"对话"到"行动"，从"单一"到"协作"的演进过程。掌握这些能力，能让你的开发效率提升数倍。
📅 最后更新：2025-12-03