Claude Code 扩展体系

有多种机制可扩展和定制 Claude 的行为：

• CLAUDE.md — 告诉 Claude 规则，每次会话自动加载
• Memory — 让 Claude 记住偏好，跨会话持久化，自动关联上下文
• Hooks — 基于 Claude 事件驱动，由框架自动执行，大模型无感知
• Skill — 教 Claude 方法，定义触发条件和执行流程
• Plugin — 给 Claude 装技能包，一个 Plugin 可包含多个 Skill
• MCP — 给 Claude 装工具，连接外部服务，提供可调用的工具函数
• Agent — 给 Claude 分身，并行处理独立任务，独立子会话

CLAUDE.md — 项目规则

每次会话自动加载的指令文件，告诉 Claude 项目约定、架构规范、禁止操作等。

• /init 扫描项目，自动生成 CLAUDE.md
• /memory 可手动编辑 CLAUDE.md
• 项目根目录的 CLAUDE.md 团队共享，提交 git
• 用户目录的 ~/.claude/CLAUDE.md 是个人全局共享，不提交 git

Memory — 项目持久记忆

跨会话记住用户偏好、项目上下文和反馈经验，下次会话自动关联。

• 存储在 ~/.claude/projects/<项目>/memory/ 下
• 四种类型：
  • user：用户画像（角色、偏好、知识背景）
  • feedback：行为反馈（用户纠正或确认的做法）
  • project：项目上下文（进行中的工作、决策、deadline）
  • reference：外部引用（外部系统的资源指针）
• 记忆会过时，重要决策以当前代码和 git 为准

Hooks — 生命周期钩子

事件驱动的自动化，在特定事件自动执行命令，Claude 本身不参与。

配置在 settings.json 的 hooks 中：

{
	"hooks": {
		"PostToolUse": [
			{
				// matcher 含非字母字符时自动按正则匹配，| 表示匹配多个工具
				"matcher": "Edit|Write",
				"command": "dart format $FILE_PATH"
			}
		]
	}
}

常用事件：

• SessionStart：会话开始
• UserPromptSubmit：用户提交输入
• PreToolUse、PostToolUse：工具调用前后
• PreCompact / PostCompact：上下文压缩前后
• SubagentStart / SubagentStop：子代理启动、停止
• Notification：通知时
• Stop：Claude 停止时

Skill — 技能

为 Claude 添加专业领域知识和自定义工具，定义触发条件、执行流程和输出格式。

Skill 来源有三种：自定义创建、内置自带、通过 Plugin 安装。

自定义 Skill：在对应目录创建 SKILL.md 文件即可，无需命令

• 用户级：~/.claude/skills/<名称>/SKILL.md
• 项目级：.claude/skills/<名称>/SKILL.md

启用/禁用：运行 /skills，选中技能后按 Space 切换状态。也可在 settings.json 中配置 skillOverrides：

{
	"skillOverrides": {
		"my-skill": "off"
	}
}

四种状态：

• on：启用
• off：完全禁用
• name-only：Claude 仅可见名称，省上下文，不会主动调用
• user-invocable-only：对 Claude 完全隐藏，仅用户手动 / 调用

Plugin — 插件

Plugin 是 Skill 的打包分发方式，通过市场（Marketplace）安装和管理。一个 Plugin 可包含多个 Skill。

# 市场管理
/plugin marketplace add xxx      # 添加市场源
/plugin marketplace remove xxx   # 移除市场源（会卸载其下所有插件）

# 插件管理
/plugin install xxx@yyy      # 安装，--scope project 为项目级
/plugin uninstall xxx@yyy    # 卸载，--prune 清理依赖，--keep-data 保留数据
/plugin disable xxx@yyy      # 禁用（不删除）
/plugin enable xxx@yyy       # 启用
/plugin        # 可视化管理，Discover/Installed/Marketplaces/Errors
/reload-plugins              # 变更后刷新，无需重启

配置写在 settings.json 的 enabledPlugins 和 extraKnownMarketplaces 中。

MCP — 外部工具

MCP（Model Context Protocol）让 Claude Code 通过标准协议连接外部工具和服务，扩展可调用的工具函数（查询数据库、调用 API、操作文件系统等）。

claude mcp list       # 列出已配置的 MCP 服务器
claude mcp add xxx    # 在当前项目添加，全局添加 --scope user
claude mcp remove xxx # 移除
claude mcp reset xxx  # 重置
/mcp                  # 查看和管理 view/Reconnect/Disable

MCP 配置写在项目级 .mcp.json 或全局 ~/.claude.json 的 mcpServers 中。

Agent — 子代理

从主会话中派生出独立的子代理，并行处理不相关的任务，互不干扰。

• 通过 Agent 工具创建，支持多种类型
• 适合并行执行独立任务，如同时查两个模块的代码、同时跑测试和分析
• 子代理结果返回主会话，不会污染主上下文

对比总结

2026-5-20