你不知道的 Claude Code：架构、治理与工程实践
AI 核心摘要
文章深入剖析了Claude Code的架构设计，从工具层、技能层、子代理层、控制层、上下文层和验证层六个层面进行分析。核心观点包括：Claude Code是循环代理过程而非问答系统；上下文工程最重要，需分层管理200K上下文；Skills设计要点、工具设计原则、Hooks用法、Subagents隔离价值、Prompt缓存机制和验证闭环等。
来源: https://x.com/hitw93/status/2032091246588518683?s=46&t=qva5jA89zzqR1mcsOO44ig
作者: @HiTw93
这篇文章源于最近半年深度使用 Claude Code、两个账号每月 40 刀氪金换来的一些踩坑经验。文章拆成六层来看：工具层、技能层、子代理层、控制层、上下文层和验证层。只强化其中一层，系统就会失衡。
核心内容摘要
1. 底层运作机制 Claude Code 的核心不是"回答"，而是一个反复循环的代理过程：收集上下文 → 采取行动 → 验证结果 → [完成 or 回到收集]。卡住的地方通常不是模型不够聪明，而是给了它错误的上下文。
2. 概念边界
- MCP/Plugin/Tools: 给 Claude 新动作能力
- Skills: 给它一套工作方法
- Subagents: 隔离执行环境
- Hooks: 强制约束和审计
- Plugin: 跨项目分发
3. 上下文工程（最重要的系统约束）
- 200K 上下文并非全部可用：固定开销 ~15-20K，MCP Server 工具定义是最大隐形杀手
- 推荐分层：CLAUDE.md 常驻 → rules 按路径加载 → Skills 按需加载 → Subagents 隔离加载 → Hooks 不进上下文
4. Skills 设计
- 描述要让模型知道"何时该用我"
- 有完整步骤、输入、输出和停止条件
- 支持 files 按需加载
5. 工具设计原则
- 名称前缀按系统或资源分层
- 错误响应要教模型如何修正
- 能合并成高层任务工具时，不要暴露过多底层碎片工具
6. Hooks 适合：阻断保护文件、Edit 后自动校验、SessionStart 注入动态上下文、任务完成后推送通知。
7. Subagents 核心价值是隔离，扫代码库、跑测试、做审查这类产生大量输出的事交给 Subagent，主线程只拿摘要。
8. Prompt Caching 整个架构围绕 Prompt 缓存构建，按前缀匹配工作。破坏缓存的常见陷阱：系统 Prompt 中放入带时间戳的内容、非确定性打乱工具定义顺序、会话中途增删工具。
9. 验证闭环 最低层：命令退出码、lint、typecheck、unit test；中间层：集成测试、截图对比；更高层：生产日志验证。
10. 高频命令
- /context: 查看 token 占用
- /clear: 清空会话
- /compact: 压缩但保留重点
- /mcp: 管理 MCP 连接
- /hooks: 管理 hooks
- /permissions: 查看权限白名单
11. 如何写好 CLAUDE.md 应该放：怎么 build/test/run、关键目录结构、代码风格和命名约束、环境坑、NEVER 列表。不该放：大段背景介绍、完整 API 文档、空泛原则。
12. 推荐工具 作者开源了 claude-health 项目，运行 /health 可自动检查配置状态。
收藏时间: 2026-03-14 21:14