跳转到内容
Claude Code 使用教程

配置决策指南

Claude Code 有七种配置机制——知道该用哪一种可以节省大量的试错时间。本指南帮助你建立快速判断的思维捷径。

七种机制的角色定位

Section titled “七种机制的角色定位”

CLAUDE.md + rules/*.md

Claude 始终知道的内容

永久上下文，每次会话自动加载。

Commands 命令

Claude 如何执行工作流

按需调用的标准操作流程。

Hooks 钩子

Claude 无法绕过的规则

自动化的防护栏，零 token 成本。

Agents 代理

Claude 委托出去的工作

隔离的并行工作者，有独立的上下文。

Skills 技能

共享的领域知识

可被多个 Agent 继承的可复用模块。

MCP 服务器

外部系统访问

通过协议连接 API、数据库和工具。

机制对比

Section titled “机制对比”
机制加载时机最适合Token 成本可靠性
CLAUDE.md每次会话核心规范、身份定义始终消耗100%
rules/*.md每次会话补充性常规规则始终消耗100%
Commands调用时可重复的多步骤工作流低（模板）100%（调用时）
Hooks事件触发时防护栏、自动化、规则执行零100%（Shell 脚本）
Agents生成时隔离/并行分析高（完整上下文）100%（生成时）
Skills调用时Agent 的领域知识中等~56% 自动调用率
MCP Servers会话启动时外部 API 和工具连接开销100%（连接后）

决策树：该用哪种机制？

Section titled “决策树：该用哪种机制？”

  1. 每次会话、每个任务都需要这条信息吗？

    • 是 → 使用 CLAUDE.md（核心）或 rules/*.md（补充）
    • 否 → 继续下一步

  2. 需要在无用户操作的情况下自动触发吗？

    • 是 → 使用 Hook（事件驱动，Shell 脚本）
    • 否 → 继续下一步

  3. 需要访问外部系统（API、数据库、工具）吗？

    • 是 → 使用 MCP Server
    • 否 → 继续下一步

  4. 是一个有固定步骤的可重复工作流吗？

    • 是 → 使用 Command（.claude/commands/）
    • 否 → 继续下一步

  5. 需要隔离的上下文或并行工作吗？

    • 是 → 使用 Agent（.claude/agents/）
    • 否 → 继续下一步

  6. 是多个 Agent 都需要的共享知识吗？

    • 是 → 使用 Skill（.claude/skills/）
    • 否 → 添加到 CLAUDE.md

决策树的文本表示：

每次会话都需要？
├─ 是 → CLAUDE.md 或 rules/*.md
│
└─ 否 → 需要自动触发？
         ├─ 是 → HOOK（事件驱动）
         │
         └─ 否 → 需要外部系统访问？
                  ├─ 是 → MCP SERVER
                  │
                  └─ 否 → 可重复的工作流？
                           ├─ 是 → COMMAND
                           │
                           └─ 否 → 需要隔离上下文？
                                    ├─ 是 → AGENT
                                    │
                                    └─ 否 → 多 Agent 共享？
                                             ├─ 是 → SKILL
                                             │
                                             └─ 否 → CLAUDE.md

56% 可靠性警告

Section titled “56% 可靠性警告”

实际影响：

  • 绝不要把关键指令只放在 Skills 中——它们可能被静默跳过
  • 安全模式： CLAUDE.md 说明做什么（始终加载），Skill 提供详细怎么做（按需加载）
  • 对于 Agent 工作流，优先在 Agent frontmatter 的 skills: 字段中显式指定 Skill

常见错误

Section titled “常见错误”
错误为什么有问题正确做法
关键规则只放在 Skills 中44% 的概率被跳过移到 CLAUDE.md 或 rules/*.md
所有内容都放 CLAUDE.md每次会话都撑满上下文窗口拆分：永久内容 → CLAUDE.md，工作流 → Commands
用 Hooks 处理复杂逻辑Hooks 是 Shell 脚本，不是 Claude用 Hooks 做执行，用 Commands 做多步骤工作流
用 MCP 做简单文件操作不必要的开销用内置文件工具；MCP 只用于外部系统

快速参考

Section titled “快速参考”
频率机制
每天使用CLAUDE.md、Commands
经常使用Hooks、MCP Servers
按需使用Agents、Skills