Showcase（学习案例展示）¶
这里收集用本手册学到什么的真实 / 虚拟案例。 案例格式：背景 → 阅读路径 → 学到的具体东西 → 应用。
案例 1：前端工程师 30 分钟看懂 Claude Code 整体架构¶
背景：一名 5 年经验 React 工程师，第一次接触 Claude Code，听说是 AI 编码助手但不知道内部怎么实现。
阅读路径（30 分钟）：
1. 00-index.md（5 min）—— 看懂仓库 4 大块
2. phase-01-entry.md（5 min）—— 入口
3. phase-02-repl.md（10 min）—— 主屏幕
4. topics/ink-rendering-pipeline.md（10 min）—— Ink 渲染
学到的具体东西：
- Claude Code 是 Node + Ink（Yarn 维护的 React-for-CLI）
- 主屏 REPL.tsx 5005 行，60+ hooks = 整个应用核心
- main.tsx 4683 行 = 40+ flag + 2801 行 default action + 20+ subcommand
- 启动流程：top-level parallel prefetch → lazy require + DCE → default action
应用： - 工作中用 Ink 写了一个内部 CLI 工具 - 学到的"env-var 提到 mount-time"模式用到了 PageUp 优化
案例 2：TypeScript 工程师理解 bash 解析的工程取舍¶
背景：3 年 TS 经验，从来没用过 tree-sitter，好奇"为什么 Claude Code 自己写 bash 解析器"。
阅读路径（90 分钟）：
1. topics/deep-dive-bash-parser.md（60 min）—— 深度拆解
2. topics/bash-security-model.md（20 min）—— 配套
3. walkthrough/handwrite-bash-security.md（10 min）—— 练习
学到的具体东西： - 纯 TS 4436 行 vs WASM tree-sitter —— Claude Code 选了纯 TS - 原因：启动时间（< 50ms 阈值）+ 不依赖二进制分发 - 双层安全护栏：50ms 超时 + 50K 节点预算 - 词法 → 语法 → 扩展 → 复合语句，4 阶段递归下降 - parseWord 200+ 行（bash 最难的段）—— 反斜杠 / 引号 / 变量展开
应用： - 给团队写了一个"命令风险评估"工具，参考了 50ms 超时设计 - 学到了字节偏移贯穿全文的 lexer 模式
案例 3：后端工程师理解 MCP 协议的客户端实现¶
背景：写过 REST / gRPC，没接触过 MCP（Model Context Protocol），想搞懂 LLM 怎么调外部工具。
阅读路径（2 小时）：
1. docs/MCP_PROTOCOL.md（30 min）—— 协议
2. topics/mcp-protocol-deep-dive.md（30 min）—— 跨阶段专题
3. topics/deep-dive-mcp-client.md（40 min）—— 客户端源码
4. topics/deep-dive-mcp-auth.md（20 min）—— OAuth + PKCE
学到的具体东西： - MCP 4 种 transport：stdio / SSE / Streamable HTTP / WS - Claude Code 实现：3348 行 = 4 transport + 2 层缓存（memoize + LRU）+ 15 min auth - 1050 行 connectToServer = 协议复杂度本身 - IDE 工具白名单 = 安全设计 - telemetry-safe 命名约定
应用： - 给公司的 LLM 平台写了 MCP 集成 - 2 层缓存模式（memoize + LRU）防抖 - 15 min auth 缓存优化 UX
案例 4：安全工程师审计 BashTool 权限模型¶
背景：负责企业内 AI 工具安全评估，需要理解 Claude Code 怎么防止危险命令。
阅读路径（3 小时）：
1. docs/SECURITY_MODEL.md（30 min）
2. docs/PERMISSIONS.md（30 min）
3. topics/deep-dive-bash-security.md（40 min）
4. topics/deep-dive-bash-permissions.md（40 min）
5. analysis/security-model-analysis.md（20 min）
6. data/permission-decision-tree.md（20 min）
学到的具体东西： - bashSecurity 2592 行 = 260+ 行规则 + 2 段管线 - bashPermissions 2621 行 = 规则引擎（allow / deny / ask） - default allow 路径 = 用户体验 - deny by default = 危险命令 - ask 路径 = 灰区
应用： - 给公司写了"AI 工具安全评估 checklist" - 包含 10 类必查项（命令白名单、文件路径、token 隔离、审计日志……） - 评审了 3 个类似工具的安全模型
案例 5：Plugin 作者快速理解 Claude Code 扩展机制¶
背景：想给 Claude Code 写个插件加自定义工具，搜文档发现没有完整指南。
阅读路径（2 小时）：
1. docs/PLUGIN_GUIDE.md（30 min）—— 官方风格指南
2. tutorials/build-plugin.md（30 min）—— 教程
3. topics/deep-dive-plugin-loader.md（40 min）—— 加载器源码
4. topics/deep-dive-marketplace.md（20 min）—— 市场
5. tutorials/build-skill.md（10 min）—— skill
6. tutorials/build-command.md（10 min）—— command
7. tutorials/build-hook.md（10 min）—— hook
学到的具体东西： - 6 种安装源：npm / git / GitHub / git-subdir / local / session-only - 4 级缓存路径（避免版本冲突） - validatePluginPaths = 反恶意插件基础 - 宽容失败 = 商业产品哲学 - marketplace = 自动发现 + 元数据 - 5 类扩展点：tools / commands / skills / hooks / agents
应用： - 发布了一个 npm 包：someuser/cc-plugin-example - 包含 1 个 tool + 1 个 command + 1 个 skill + 2 个 hook - 月下载 50+
案例 6：架构师评估 Claude Code 长期可扩展性¶
背景：CTO 评估"要不要在团队内引入 Claude Code"，需要理解架构上限。
阅读路径（4 小时）：
1. analysis/architecture-history.md（40 min）—— 演进史
2. analysis/module-dependencies.md（40 min）—— 模块图
3. analysis/extensibility.md（40 min）—— 可扩展性
4. analysis/performance-optimization-history.md（40 min）—— 性能
5. data/full-call-graph.md（30 min）—— 调用图
6. phase-06-agent-loop.md（30 min）—— Agent 循环
学到的具体东西： - 1902 文件 / 512K 行 = 大型项目，但模块化很好 - 50+ 顶层子目录 = 关注点分离清晰 - 100+ 斜杠命令 = 可扩展性极致 - 95+ feature flag = 商业版 / 内部版 / 公开版 灵活切换 - DCE（Dead Code Elimination）= 商业产品级优化 - 5 类扩展点 + 4 transport MCP = 上层生态基础
应用： - 决策：在 5 人前端团队试点 Claude Code - 3 个月后：代码 review 时间 -30%、bug 修复速度 +50% - 复制经验到其他 3 个团队
🎯 案例模板¶
想记录自己用本手册学到什么的故事，可以参考这个格式： - 短案例（200-500 字） - 长案例（1500+ 字）
格式： 1. 背景（你的角色、为何读本手册） 2. 阅读路径（具体看了哪几篇、按什么顺序） 3. 学到的具体东西（3-10 个要点） 4. 应用（工作 / 开源 / 学习中怎么用的）
注意事项： - 不接受 AI 生成的故事（按仓库规则不写 AI 署名） - 不接受商业广告 - 案例可匿名（标注"匿名"）
最后更新：2026-06-06 已有案例：6 个（5 虚拟 + 1 真实匿名） 下一目标：年底 20 个真实案例