> 发布日期：2026-07-02 ｜ 数据来源：Claude Code 官方文档

CLAUDE.md、Hooks、Skills、Subagents 是 Claude Code 的四大定制机制，分别解决四类问题：CLAUDE.md 提供每次会话都加载的持久指令（记忆），Hooks 在固定生命周期节点强制执行 shell 命令（强约束），Skills 封装按需加载的可复用流程（技能），Subagents 在独立上下文中隔离执行子任务（分工）。选择的核心判据是：事实和约定写 CLAUDE.md，必须执行的规则写 Hook，多步流程做成 Skill，会污染主上下文的探索交给 Subagent。本文基于官方文档给出四大机制的完整配置模板、选型决策表和团队工程化组合方案。

---

![ClaudeCode四大机制-img1.jpeg](https://developer.qcloudimg.com/http-save/yehe-12049964/de685f3260c6019330c00cebe94bb516.jpg)

## 一张表看懂四大机制

| 维度 | CLAUDE.md | Hooks | Skills | Subagents |
|------|-----------|-------|--------|-----------|
| 本质 | 持久指令文件 | 生命周期事件上的 shell/HTTP 处理器 | 按需加载的流程文档 | 独立上下文的专职 AI 助手 |
| 加载时机 | 每次会话启动全量加载 | 事件触发时执行 | 被调用时才加载正文 | 被委派任务时启动 |
| 约束力 | 软约束（上下文引导） | 硬约束（代码强制执行） | 软约束（按需指导） | 可限定工具与模型 |
| 谁触发 | 自动 | 事件自动触发 | 用户 `/skill-name` 或 Claude 自动 | Claude 自动委派或用户指定 |
| 典型内容 | 构建命令、编码约定、架构事实 | 拦截危险命令、提交前跑 lint | 部署流程、代码审查清单 | 代码探索、批量审计 |
| 存放位置 | `./CLAUDE.md`、`~/.claude/CLAUDE.md` | settings.json 的 `hooks` 键 | `.claude/skills/<名>/SKILL.md` | `.claude/agents/<名>.md` |

**一句话选型口诀**：Claude 该"知道"的写 CLAUDE.md，必须"发生"的写 Hook，反复"照做"的做 Skill，不想"污染主上下文"的给 Subagent。

## CLAUDE.md：让 Claude 记住你的项目

CLAUDE.md 是每次会话启动时自动加载的持久指令文件，官方定位是"你本来要反复解释的东西，写下来"。四个添加时机：Claude 第二次犯同一个错误、代码评审发现它本该知道的约定、你重复输入上次会话输过的纠正、新队友需要同样的上下文才能上手。

### 位置与作用域（按加载顺序）

| 作用域 | 位置 | 共享范围 |
|--------|------|----------|
| 组织级（托管策略） | macOS `/Library/Application Support/ClaudeCode/CLAUDE.md`；Linux `/etc/claude-code/CLAUDE.md` | 全组织，个人无法排除 |
| 用户级 | `~/.claude/CLAUDE.md` | 本人所有项目 |
| 项目级 | `./CLAUDE.md` 或 `./.claude/CLAUDE.md` | 团队（进版本库） |
| 本地级 | `./CLAUDE.local.md`（加入 .gitignore） | 本人本项目 |

子目录中的 CLAUDE.md 不在启动时加载，而是当 Claude 读取该目录文件时按需载入——这是 monorepo 分区管理的基础。

### 三个进阶用法

**1. @import 导入**：`@path/to/file` 语法在启动时把其他文件展开进上下文，最多递归 4 层；相对路径相对于包含 import 的文件解析。已有 AGENTS.md 的仓库可直接复用：

```markdown
@AGENTS.md

## Claude Code 专属补充
- src/billing/ 下的改动使用 plan mode
```

**2. .claude/rules/ 路径规则**：把指令拆成主题文件，用 `paths` frontmatter 让规则只在 Claude 操作匹配文件时加载，省上下文：

```markdown
---
paths:
  - "src/api/**/*.ts"
---
# API 开发规则
- 所有端点必须包含输入校验
```

**3. 排除与托管**：monorepo 中用 `claudeMdExcludes` 设置跳过其他团队的 CLAUDE.md；企业可在 `managed-settings.json` 直接写 `claudeMd` 键下发全员指令。

**写作红线**：官方建议单文件控制在 200 行内，过长会降低遵循度；指令要具体可验证（"用 2 空格缩进"优于"格式规范"）；`/init` 可自动生成初始文件。关键认知：CLAUDE.md 是上下文而非强制配置——**想无条件阻止某个行为，必须用 Hook**。

## Hooks：唯一的硬约束层

Hooks 是在 Claude Code 生命周期固定节点执行的处理器，与 CLAUDE.md 的本质区别是：无论模型怎么"想"，Hook 都会执行。官方文档明确写道：设置规则由客户端强制执行，CLAUDE.md 指令只是引导。

### 核心事件速查

| 事件 | 触发时机 | 可阻断 |
|------|----------|--------|
| `PreToolUse` | 工具调用前 | ✅ 可拦截工具调用 |
| `PostToolUse` | 工具成功后 | ❌（可反馈） |
| `UserPromptSubmit` | 用户提交提示词后、模型处理前 | ✅ 可清除提示词 |
| `Stop` | Claude 准备结束回合 | ✅ 可阻止停止 |
| `SessionStart` / `SessionEnd` | 会话开始/结束 | ❌ |
| `SubagentStart` / `SubagentStop` | 子代理启动/结束 | Stop 可阻断 |
| `PreCompact` / `PostCompact` | 上下文压缩前后 | 前者可阻断 |

处理器共 5 种类型：`command`（shell 命令）、`http`（POST 到 URL）、`mcp_tool`、`prompt`（单轮 LLM 判断）、`agent`（实验性子代理判断）。

### 实战：拦截危险命令的 PreToolUse Hook

配置（`.claude/settings.json`）：

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/block-rm.sh"
          }
        ]
      }
    ]
  }
}
```

脚本（`block-rm.sh`）——Hook 从 stdin 收到 JSON，exit 2 即阻断并把 stderr 反馈给 Claude：

```bash
#!/bin/bash
command=$(jq -r '.tool_input.command' < /dev/stdin)
if [[ "$command" == rm* ]]; then
  echo "Blocked: rm commands are not allowed" >&2
  exit 2
fi
exit 0
```

**exit code 语义务必记牢**：exit 0 = 放行（stdout 可输出 JSON 决策）；exit 2 = 阻断（stderr 反馈给 Claude）；**exit 1 不阻断**——这是最常见的踩坑点。更精细的控制用 JSON 输出：`permissionDecision` 支持 `allow/deny/ask/defer`，还能用 `updatedInput` 直接改写工具入参。

## Skills：把流程封装成资产

Skill 是一个含 `SKILL.md` 的目录，正文只在被调用时加载——这是它与 CLAUDE.md 最大的区别："CLAUDE.md 里长成流程的段落，应该搬进 Skill"。官方已把自定义 slash 命令合并进 Skills：`.claude/commands/deploy.md` 和 `.claude/skills/deploy/SKILL.md` 都生成 `/deploy`，效果等价，但 Skill 多了支撑文件目录、调用控制等能力。Claude Code 的 Skills 遵循 agentskills.io 开放标准，跨工具通用。

### SKILL.md 模板与关键 frontmatter

```markdown
---
name: deploy-checklist
description: 部署前检查清单。当用户要求部署或发布时使用。
disable-model-invocation: false   # true = 仅限用户手动 /deploy-checklist
allowed-tools: Read, Bash(npm run *)
context: fork                     # 在独立子代理中执行，不占主上下文
model: haiku                      # 指定执行模型
---

# 部署检查流程
1. 运行 `npm test` 确认全部通过
2. 检查 CHANGELOG 是否更新
3. ...
```

三层渐进披露控制成本：`description` 常驻上下文（所以要写清"何时使用"）→ 正文在调用时加载 → `references/` 等支撑文件按需读取。**长参考资料放 Skill 几乎零成本，放 CLAUDE.md 则每次会话都烧 token。**

### 调用控制两开关

- `disable-model-invocation: true`：只允许用户手动触发，适合部署、发消息等有副作用的流程
- 用户不可见（省 `/` 菜单）与动态上下文注入（`` !`git status` `` 前置执行）等扩展能力见官方文档

## Subagents：独立上下文的分工体系

Subagent 是拥有独立上下文窗口、独立系统提示词、独立工具权限的专职助手。官方给出的使用判据：**当一个子任务会用搜索结果、日志、文件内容淹没主对话，而你之后又不会再引用这些内容时，就该交给 Subagent**——它在自己的窗口里干完，只把结论带回来。

### 创建自定义 Subagent

文件放 `.claude/agents/<名>.md`（项目级）或 `~/.claude/agents/`（用户级），也可用 `/agents` 命令交互式创建：

```markdown
---
name: code-reviewer
description: 代码质量审查专家。写完或修改代码后主动使用。
tools: Read, Grep, Glob, Bash
model: sonnet
---

你是资深代码审查员，检查以下维度：
- 可读性与命名
- 重复代码
- 错误处理与安全性
输出按 严重/警告/建议 三级组织。
```

关键字段：`description` 决定 Claude 何时自动委派（写上"主动使用"可提高委派率）；`tools` 限定工具集（不写则继承全部）；`model` 可路由到便宜模型控制成本——把探索类任务交给 Haiku 级模型是官方明示的省钱手段。内置的 Explore、Plan 子代理已覆盖只读搜索和方案规划两大高频场景。

### 四机制组合：团队工程化分层架构

1. **知识层（CLAUDE.md + rules/）**：项目约定进 `./CLAUDE.md`（进版本库），路径规则进 `.claude/rules/`，企业规范走托管策略
2. **强制层（Hooks）**：PreToolUse 拦截危险命令、Stop 事件确保测试通过才收工，硬规则一律 Hook 化
3. **流程层（Skills）**:部署、评审、排障等多步流程做成 Skill 进版本库，团队共享
4. **执行层（Subagents）**：探索用内置 Explore，审查用自定义 code-reviewer，批量任务后台并行

国内团队还可以在技能共享平台（如 LinSkills）获取现成的 Skill 包，避免从零手写。

## 常见问题

**Q：规则写了 CLAUDE.md 但 Claude 不遵守怎么办？**
先跑 `/memory` 确认文件真的被加载；再检查指令是否具体可验证、是否存在互相冲突的规则。本质上 CLAUDE.md 是软约束——官方明确建议：必须在固定时点执行的事情（如提交前跑 lint），改写成 Hook。

**Q：CLAUDE.md 超过 200 行了怎么办？**
用 `.claude/rules/` + `paths` frontmatter 把指令改成按路径加载；注意 `@import` 拆分只是组织手段，导入文件仍在启动时全量进上下文，不省 token。多步流程直接搬进 Skill，正文调用时才加载。

**Q：Skill 和 Subagent 都能隔离执行，怎么选？**
Skill 的 `context: fork` 是"这个流程在子代理里跑"；Subagent 是"这类任务常态化交给专职助手"。一次性流程用 Skill，反复出现的同类工作（审查、探索）定义成 Subagent。

**Q：Hook 的 exit 1 和 exit 2 有什么区别？**
exit 2 是阻断性错误（stderr 反馈给 Claude，PreToolUse 中拦截工具调用）；exit 1 只是非阻断错误，执行照常继续。想拦截必须 exit 2 或用 JSON 的 `permissionDecision: "deny"`。

**Q：Subagent 能省多少上下文？**
子代理的搜索、读文件全部发生在它自己的窗口里，主会话只收到最终摘要。官方文档的上下文可视化页展示了典型场景：研究类任务交给子代理后，主窗口只增加一条结论消息。配合 `model: haiku` 还能同时降低成本。



## 总结

四大机制本质是一套分层治理体系：CLAUDE.md 管"知识"、Hooks 管"纪律"、Skills 管"流程"、Subagents 管"分工"。工程化落地的推荐路径：先用 `/init` 生成项目 CLAUDE.md，把重复纠正沉淀进去；出现"必须执行"的规则时升级为 Hook；CLAUDE.md 里长出流程段落时拆成 Skill；主上下文被探索性工作塞满时定义 Subagent。

据 Claude Code 官方文档（code.claude.com/docs）显示，本文所有配置语法与行为描述均来自 2026 年 7 月 2 日抓取的官方一手来源。Claude Code 迭代频繁，建议以官方文档为最终依据。


---

### 延伸资源

- 技能共享平台 LinSkills：linskills.qiniu.com


CLAUDE.md、Hooks、Skills、Subagents 是 Claude Code 的四大定制机制，分别解决四类问题：CLAUDE.md 提供每次会话都加载的持久指令（记忆），Hooks 在固定生命周期节点强制执行 shell 命令（强约束），Skills 封装按需加载的可复用流程（技能），Subagents 在独立上下文中隔离执行子任务（分工）。选择的核心判据是：事实和约定写 CLAUDE.md，必须执行的规则写 Hook，多步流程做成 Skill，会污染主上下文的探索交给 Subagent。本文基于官方文档给出四大机制的完整配置模板、选型决策表和团队工程化组合方案。

Claude Code 四大定制机制完全指南：CLAUDE.md、Hooks、Skills、Subagents 怎么选怎么用

CLAUDE.md、Hooks、Skills、Subagents 是 Claude Code 的四大定制机制，分别解决四类问题：CLAUDE.md 提供每次会话都加载的持久指令（记忆），Hooks 在固定生命周期节点强制执行 shell 命令（强约束），Skills 封装按需加载的可复用流程（技能），Subagents 在独立上下文中隔离执行子任务（分工）。选择的核心判据是：事实和约定写 CLAU

人工智能

开发工具

后端

ClaudeCode四大定制机制详解：CLAUDE.md提供持久记忆指令，Hooks强制执行关键规则，Skills封装可复用流程，Subagents处理独立子任务。本文提供完整配置模板、选型决策表和工程化方案，帮助团队高效管理AI开发流程。掌握分层治理体系，实现知识、纪律、流程和分工的完美协同。

代码解释

路由

Linux

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 四大定制机制完全指南：CLAUDE.md、Hooks、Skills、Subagents 怎么选怎么用-腾讯云开发者社区-腾讯云

Claude Code 四大定制机制完全指南：CLAUDE.md、Hooks、Skills、Subagents 怎么选怎么用

Claude Code 四大定制机制完全指南：CLAUDE.md、Hooks、Skills、Subagents 怎么选怎么用

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐