Claude Code 使用指南：Agent、MCP、Hook 核心功能详解

一篇文章带你掌握 Claude Code 的所有核心功能

📚 目录

快速开始
基础操作与快捷键
核心概念详解
[Agent 与 SubAgent](#Agent 与 SubAgent)
[Agent Skill 使用](#Agent Skill 使用)
[MCP Server](#MCP Server)
[Hook 系统](#Hook 系统)
[Plugin 插件](#Plugin 插件)
上下文管理
实战技巧

快速开始

安装与启动

bash 复制代码

# 普通启动
claude

# 跳过权限询问启动（谨慎使用）
claude --dangerously-skip-permissions

# 恢复上次对话
claude -c

第一次使用

启动后会进入交互式命令行界面
直接输入问题或任务描述
Claude 会自动调用工具完成任务
使用 /help 查看所有可用命令

基础操作与快捷键

🎮 核心快捷键

快捷键	功能	说明
`Shift + Tab`	切换模式	在不同工作模式间切换
`Ctrl + B`	后台执行	将当前任务放到后台，可同时处理新任务
`Ctrl + O`	文件列表	显示项目所有文件
`Ctrl + V`	粘贴图片	直接粘贴截图给 Claude 分析
`ESC` (双击)	回滚界面	进入历史记录回滚页面
`K`	关闭任务	在任务列表中关闭选中任务
`ESC`	退出界面	返回上一级界面

📝 常用命令

bash 复制代码

# 任务管理
/task              # 查看所有后台任务
/resume            # 回到之前的对话

# 上下文管理
/compact           # 压缩上下文（可指定压缩要求）
/clear             # 清空上下文内容
/rewind            # 回滚到之前的状态

# 项目配置
/init              # 自动生成 claude.md 配置文件
/memory            # 选择要打开的 Claude.md 文件

# 扩展功能
/mcp               # 查看所有 MCP Server
/hooks             # 管理 Hook 事件
/agents            # 管理 Agent
/plugin            # 进入插件管理器

💡 特殊输入方式

bash 复制代码

# Bash 命令
!ls                # 输入感叹号执行 bash 命令
!git status

# 图片输入
# 方式1：拖动图片到输入框
# 方式2：Ctrl+V 粘贴截图
# 方式3：直接输入图片路径

核心概念详解

🎯 三大核心组件对比

Claude Code 有三个容易混淆的概念，理解它们的区别很重要：

特性	Agent	SubAgent	Agent Skill
上下文共享	✅ 共享主对话上下文	❌ 完全独立上下文	✅ 共享主对话上下文
对主上下文影响	较小	较大	最小
执行方式	异步执行	独立进程	同步调用
资源消耗	中等	较高	较低
适用场景	代码审查、文档生成	独立功能开发、大规模重构	快速工具调用、辅助功能

📊 选择决策树

复制代码

需要处理任务？
├─ 是否需要大量修改代码？
│  ├─ 是 → 使用 SubAgent（独立上下文，避免污染）
│  └─ 否 → 继续判断
│     ├─ 是否需要分析当前对话内容？
│     │  ├─ 是 → 使用 Agent（共享上下文）
│     │  └─ 否 → 使用 Agent Skill（轻量快速）

💡 实际例子

场景 1：生成今日开发总结

✅ 使用 Agent Skill
原因：需要读取当前对话，但不修改代码，影响小

场景 2：重构整个认证系统

✅ 使用 SubAgent
原因：大量代码修改，需要独立思考空间

场景 3：代码审查当前修改

✅ 使用 Agent
原因：需要理解上下文，但只做分析不大改

Agent 与 SubAgent

🤖 什么是 Agent

Agent 是 Claude Code 中的智能助手，可以帮你完成特定任务。

特点：

共享主对话的上下文
可以理解当前对话内容
适合分析、审查、总结类任务
对主上下文影响较小

创建 Agent：

bash 复制代码

# 方式1：通过命令创建
/agents

# 方式2：选择 'Create new agent'
# 然后填写：
# - Agent 名称
# - Agent 描述
# - Agent 提示词

Agent 配置文件位置：

复制代码

~/.claude/agents/your-agent-name.md

Agent 示例配置：

markdown 复制代码

# Code Reviewer Agent

你是一个专业的代码审查专家。

## 职责
- 检查代码质量
- 发现潜在 bug
- 提供改进建议
- 检查安全问题

## 审查标准
1. 代码可读性
2. 性能优化
3. 安全漏洞
4. 最佳实践

🔄 什么是 SubAgent

SubAgent 是拥有完全独立上下文的执行单元。

特点：

❌ 不共享主对话上下文
✅ 拥有独立的思考空间
✅ 适合大规模代码修改
✅ 避免污染主上下文

使用场景：

开发新功能模块
大规模代码重构
独立的功能实现
需要专注思考的复杂任务

调用 SubAgent：

bash 复制代码

# 在对话中直接请求
"请使用 SubAgent 重构认证系统"

# Claude 会自动创建 SubAgent 并执行

SubAgent vs Agent 对比：

维度	Agent	SubAgent
上下文	共享	独立
适合任务	分析、审查	开发、重构
资源消耗	中等	较高
执行速度	快	较慢

Agent Skill 使用

⚡ 什么是 Agent Skill

Agent Skill 是轻量级的工具函数，共享主对话上下文，对上下文影响最小。

特点：

✅ 共享主对话上下文
✅ 执行速度快
✅ 资源消耗低
✅ 适合快速辅助任务

与 Agent 的区别：

特性	Agent Skill	Agent
复杂度	简单工具函数	完整的智能助手
配置	轻量配置	详细提示词
执行方式	同步快速	异步执行
适用场景	工具调用	复杂任务

使用示例：

bash 复制代码

# 场景1：根据今日开发生成总结
"请使用 Agent Skill 生成今日开发总结"

# 场景2：快速格式化代码
"使用 Agent Skill 格式化当前文件"

# 场景3：生成文档
"用 Agent Skill 为这个函数生成文档"

MCP Server

🌐 什么是 MCP (Model Context Protocol)

MCP 是 Claude Code 的扩展协议，允许连接外部服务和工具。

核心概念：

MCP Server：提供特定功能的服务
可以连接数据库、API、文件系统等
扩展 Claude 的能力边界

查看已安装的 MCP：

bash 复制代码

/mcp

常见 MCP Server：

MCP Server	功能	使用场景
Figma	设计稿访问	读取 Figma 设计
GitHub	仓库操作	管理 Issues、PR
Database	数据库连接	查询数据库
Filesystem	文件系统	高级文件操作

📋 Figma MCP 使用实例

Step 1: 安装 Figma MCP Server

bash 复制代码

# 查看可用的 MCP
/mcp

# 如果没有 Figma MCP，需要先安装
# 通常通过 npm 安装
npm install -g @modelcontextprotocol/server-figma

Step 2: 配置 Figma Access Token

登录 Figma 账号
进入 Settings → Account → Personal Access Tokens
点击 "Generate new token"
复制生成的 Token

Step 3: 配置 Claude Code

在 ~/.claude/settings.json 中添加配置：

json 复制代码

{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-figma"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "你的_Figma_Token"
      }
    }
  }
}

Step 4: 使用 Figma MCP

bash 复制代码

# 重启 Claude Code 使配置生效
# 然后就可以直接使用啦

# 示例1：读取 Figma 设计稿
"请帮我读取这个 Figma 文件的设计：
https://www.figma.com/file/xxxxx"

# 示例2：提取设计规范
"从这个 Figma 文件中提取颜色和字体规范"

# 示例3：设计稿转代码
"根据这个 Figma 组件生成 React 代码"

实际使用场景：

bash 复制代码

# 场景：UI 设计稿转 React 组件

用户："请读取这个 Figma 按钮组件并生成 React 代码
https://www.figma.com/file/abc123/Button-Component"

Claude 会自动：
1. 通过 Figma MCP 读取设计稿
2. 分析组件的样式、尺寸、颜色
3. 生成对应的 React + Tailwind CSS 代码
4. 包含 hover、active 等交互状态

Hook 系统

🪝 什么是 Hook

Hook 是事件触发机制，可以在特定事件前后执行自定义操作。

Hook 类型：

PreToolUse - 工具使用前触发
PostToolUse - 工具使用后触发
Stop - 会话结束时触发

管理 Hook：

bash 复制代码

/hooks

Hook 配置示例：

json 复制代码

{
  "hooks": {
    "preToolUse": [
      {
        "name": "git-push-review",
        "description": "推送前打开编辑器审查",
        "trigger": "git push",
        "action": "open-editor"
      }
    ],
    "postToolUse": [
      {
        "name": "auto-format",
        "description": "编辑后自动格式化",
        "trigger": "edit",
        "action": "prettier"
      }
    ]
  }
}

常见 Hook 场景：

Hook 时机	场景	示例
PreToolUse	代码提交前检查	运行 lint
PostToolUse	文件编辑后格式化	Prettier
Stop	会话结束前检查	查找 console.log

Plugin 插件

🔌 什么是 Plugin

Plugin 是功能全家桶，一次性安装多个相关功能。

特点：

📦 打包多个相关功能
🚀 一键安装配置
🎯 针对特定领域优化

管理插件：

bash 复制代码

/plugin

推荐插件：

插件名称	功能	适用场景
frontend-design	前端设计工具集	前端开发
backend-toolkit	后端开发工具	后端开发
testing-suite	测试工具集	测试驱动开发

安装插件示例：

bash 复制代码

# 进入插件管理器
/plugin

# 选择要安装的插件
# 例如：frontend-design

# 插件会自动安装相关的：
# - Agent
# - Skill
# - MCP Server
# - Hook

上下文管理

📊 为什么需要管理上下文

Claude Code 有上下文窗口限制，合理管理可以：

提高响应速度
降低 Token 消耗
保持对话连贯性

🔧 上下文管理命令

1. 压缩上下文

bash 复制代码

# 基础压缩
/compact

# 指定压缩要求
/compact 保留最近的代码修改记录

# 查看压缩后的内容
Ctrl + O

2. 清空上下文

bash 复制代码

# 完全清空
/clear

# 注意：清空后无法恢复

3. 回滚到之前状态

bash 复制代码

# 命令方式
/rewind

# 快捷键方式
ESC ESC (双击)

💡 上下文管理最佳实践

定期压缩 - 长对话时每隔一段时间压缩一次
分段任务 - 大任务拆分成多个小任务
使用 SubAgent - 独立任务用 SubAgent 避免污染主上下文
及时清理 - 完成阶段性任务后清理无用上下文

实战技巧

🎯 图片处理能力

Claude Code 支持多种图片输入方式：

输入方式：

bash 复制代码

# 方式1：拖拽图片到输入框
# 直接拖动图片文件

# 方式2：粘贴截图
Ctrl + V

# 方式3：输入图片路径
请分析这张图片：D:\screenshots\ui-design.png

应用场景：

🎨 UI 设计稿转代码
🐛 错误截图分析
📊 图表数据提取
🖼️ 界面布局分析

⚙️ 后台任务执行

启动后台任务：

bash 复制代码

# 在执行任务时按 Ctrl + B
# 当前任务会转到后台执行
# 你可以继续提交新任务

管理后台任务：

bash 复制代码

# 查看所有后台任务
/task

# 在任务列表中：
# - K 键：关闭选中任务
# - ESC：返回主界面

使用场景：

长时间运行的测试
大规模代码重构
批量文件处理
同时处理多个独立任务

📝 项目配置文件

claude.md 配置文件：

bash 复制代码

# 自动生成配置文件
/init

# 选择要使用的配置文件
/memory

配置文件示例：

markdown 复制代码

# 项目：我的 Web 应用

## 技术栈
- React 18
- TypeScript
- Tailwind CSS
- Vite

## 代码规范
- 使用函数式组件
- 优先使用 TypeScript
- 遵循 Airbnb 代码规范

## 项目结构
src/
├── components/  # 组件
├── hooks/       # 自定义 Hooks
├── utils/       # 工具函数
└── pages/       # 页面

配置文件作用：

📋 记录项目信息
🎯 统一代码风格
🔧 自定义工作流
📚 团队协作规范

🎓 工作流最佳实践

1. 任务规划流程

复制代码

1. 理解需求 → 2. 选择工具 → 3. 执行任务 → 4. 验证结果
   ↓              ↓              ↓              ↓
 明确目标      Agent/Skill    后台执行      代码审查

2. 代码开发流程

bash 复制代码

# Step 1: 规划（使用 planner agent）
"请帮我规划实现用户认证功能"

# Step 2: 开发（使用 SubAgent）
"使用 SubAgent 实现用户认证"

# Step 3: 审查（使用 code-reviewer agent）
"审查刚才的代码"

# Step 4: 测试（使用 tdd-guide agent）
"为认证功能编写测试"

3. 调试流程

bash 复制代码

# 提供错误截图
Ctrl + V (粘贴错误截图)

# 描述问题
"运行时出现这个错误，请帮我分析"

# Claude 会自动：
# 1. 分析错误信息
# 2. 定位问题代码
# 3. 提供修复方案
# 4. 验证修复结果

最佳实践与注意事项

⚠️ 重要注意事项

1. 权限管理

bash 复制代码

# ❌ 不推荐：跳过权限检查
claude --dangerously-skip-permissions

# ✅ 推荐：正常启动，手动确认
claude

2. 上下文污染

❌ 避免：在主对话中进行大规模重构
✅ 推荐：使用 SubAgent 处理独立任务

3. 资源消耗

合理使用后台任务
及时关闭不需要的任务
定期压缩上下文

❓ 常见问题 FAQ

Q1: Agent、SubAgent、Agent Skill 该怎么选？

需要分析当前对话 → Agent
需要大量修改代码 → SubAgent
快速工具调用 → Agent Skill

Q2: 上下文满了怎么办？

bash 复制代码

# 方案1：压缩上下文
/compact

# 方案2：清空重新开始
/clear

# 方案3：使用 SubAgent
"使用 SubAgent 处理这个任务"

Q3: 如何恢复之前的对话？

bash 复制代码

# 方式1：启动时恢复
claude -c

# 方式2：命令恢复
/resume

Q4: 后台任务如何管理？

bash 复制代码

# 查看任务
/task

# 关闭任务
按 K 键

# 切换到后台
Ctrl + B

🚀 实战案例

案例 1：开发新功能

bash 复制代码

# 场景：为博客系统添加评论功能

# Step 1: 规划
"请帮我规划实现评论功能"

# Step 2: 使用 SubAgent 开发
"使用 SubAgent 实现评论功能，包括：
- 评论数据模型
- API 接口
- 前端组件
- 单元测试"

# Step 3: 代码审查
"使用 code-reviewer agent 审查评论功能代码"

# Step 4: 提交
"帮我提交代码并创建 PR"

案例 2：UI 设计稿转代码

bash 复制代码

# Step 1: 上传设计稿
Ctrl + V (粘贴设计稿截图)

# Step 2: 转换
"请根据这个设计稿实现 React 组件，使用 Tailwind CSS"

# Step 3: 调整
"调整间距，让布局更接近设计稿"

案例 3：Bug 修复

bash 复制代码

# Step 1: 提供错误信息
Ctrl + V (粘贴错误截图)
"登录时出现这个错误"

# Step 2: 分析
Claude 会自动：
- 分析错误堆栈
- 定位问题代码
- 提供修复方案

# Step 3: 修复
"请修复这个问题"

# Step 4: 测试
"运行测试验证修复"

快速参考卡片

🎯 核心命令速查

命令	功能	使用场景
`/task`	查看后台任务	管理多任务
`/compact`	压缩上下文	上下文过大
`/clear`	清空上下文	重新开始
`/rewind`	回滚状态	撤销操作
`/agents`	管理 Agent	创建/编辑 Agent
`/mcp`	查看 MCP	管理扩展
`/hooks`	管理 Hook	自动化流程
`/plugin`	插件管理	安装功能包

⌨️ 快捷键速查

快捷键	功能
`Shift + Tab`	切换模式
`Ctrl + B`	后台执行
`Ctrl + O`	文件列表
`Ctrl + V`	粘贴图片
`ESC ESC`	回滚界面
`!`	Bash 命令

进阶技巧

🎨 组合使用技巧

技巧 1：多 Agent 协作

bash 复制代码

# 场景：完整的功能开发流程

# 1. 规划阶段
"使用 planner agent 规划用户认证功能"

# 2. 开发阶段（后台执行）
"使用 SubAgent 实现认证功能" 
Ctrl + B (放到后台)

# 3. 同时进行文档编写
"使用 doc-updater agent 编写 API 文档"

# 4. 开发完成后审查
"使用 code-reviewer 审查认证代码"

# 5. 安全检查
"使用 security-reviewer 检查安全问题"

技巧 2：MCP + Hook 自动化

bash 复制代码

# 配置 Hook 实现自动化流程
# 例如：代码提交前自动检查

# 1. 配置 PreToolUse Hook
# 触发条件：git commit
# 执行动作：运行 lint + 测试

# 2. 配置 PostToolUse Hook  
# 触发条件：代码编辑
# 执行动作：自动格式化

# 3. 配置 Stop Hook
# 触发条件：会话结束
# 执行动作：检查 console.log

总结

🎯 核心要点回顾

1. 三大核心组件

Agent - 共享上下文，适合分析审查
SubAgent - 独立上下文，适合开发重构
Agent Skill - 轻量工具，适合快速调用

2. 上下文管理

定期使用 /compact 压缩
大任务使用 SubAgent 避免污染
善用 /rewind 回滚

3. 工作流优化

使用 Hook 实现自动化
利用后台任务并行处理
配置 claude.md 统一规范

4. 扩展能力

MCP Server 连接外部服务
Plugin 一键安装功能包
自定义 Agent 满足特定需求

📚 相关资源

官方文档：https://docs.anthropic.com/claude-code
GitHub 仓库：https://github.com/anthropics/claude-code
社区讨论：https://github.com/anthropics/claude-code/discussions

祝你使用 Claude Code 愉快！🚀

如果有任何问题，随时问我哦～ 🐟🐟

最后更新：2026-02-24