🚀 深入理解 Claude Code：从入门到精通的能力全景图🚀 深入理解 Claude Code：从入门到精通的能

🚀 深入理解 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 的全部能力。无论你是刚入门的新手，还是想深入探索的老手，相信都能有所收获。

先放一张能力全景图，让你有个整体印象：

┌─────────────────────────────────────────────────────────────────────────┐
│                        Claude Code 能力全景图                            │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   🧠 Claude 原生能力层                                                   │
│   ┌─────────────────────────────────────────────────────────────────┐   │
│   │  Vision (视觉)  │  Tool Use (工具)  │  Reasoning (推理)         │   │
│   └─────────────────────────────────────────────────────────────────┘   │
│                                  │                                      │
│                                  ▼                                      │
│   🔧 扩展能力层                                                          │
│   ┌─────────────────────────────────────────────────────────────────┐   │
│   │  Commands  │  Skills  │  Rules  │  Hooks  │  Memories  │  MCP   │   │
│   └─────────────────────────────────────────────────────────────────┘   │
│                                  │                                      │
│                                  ▼                                      │
│   🤖 高级能力层                                                          │
│   ┌─────────────────────────────────────────────────────────────────┐   │
│   │  Multi-Agent (多智能体)  │  Workflow (工作流)  │  Automation     │   │
│   └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

第一部分：能力发展历程

💡 为什么要先讲历史？ 了解能力的发展脉络，能帮你更好地理解每个能力的设计初衷和使用场景。

1.1 时间线总览

Claude Code 的能力不是一蹴而就的，而是经过了多个版本的迭代。下面这张时间线图展示了从 2024 年 3 月到 2025 年的完整演进过程：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                        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 从"聊天"走向"行动"的关键阶段：

                    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 可以统一地连接各种外部服务：

                    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 配置目录结构详解

所有扩展能力的配置，都放在项目根目录的 .claude/ 文件夹下（不同 IDE 可能是 .cursor/ 或 .claude/）：

项目根目录/
└── .claude/                    # 扩展能力配置根目录
    │
    ├── 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

推荐的学习顺序：

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 文件定义，放在 .claude/commands/ 目录下：

<!-- .claude/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 的完整结构

<!-- .claude/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 实战案例：安全编码规则

<!-- .claude/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 记忆类型

// .claude/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 自动注入示例

<!-- .claude/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 配置示例

// .claude/mcp.json
{
  "mcpServers": {
    "xxx": {
      "url": "https://mcp.oa.com/mcp"
    },
    "xxx1": {
      "url": "https://mcp.git.oa.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 的混合推理能力，可以展示思考过程。

第十二部分：完整工作流案例

1. /kills:launch "xx-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