# Claude Code Architecture

## Docs

- [协调者与蜂群模式 - 多 Agent 高级编排](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/agent/coordinator-and-swarm.md): 从源码角度解析 Claude Code 多 Agent 协作：Coordinator Mode 的 System Prompt 设计、Worker 生命周期、Task 通信协议和 Swarm 蜂群的任务分配机制。
- [子 Agent 机制 - 权限、流程、同步/异步与 Fork](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/agent/sub-agents.md): 从源码角度解析 Claude Code 子 Agent：AgentTool 的执行链路、权限模式、同步与异步生命周期、任务通知队列、AgentTool fork、slash command fork 与 runForkedAgent 的边界。
- [Worktree 隔离 - Git Worktree 实现文件级隔离](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/agent/worktree-isolation.md): 揭秘 Claude Code 的 git worktree 隔离机制：子 Agent 如何获得独立工作空间，worktree 创建/销毁生命周期、路径命名规则和安全防护。
- [Auto updater](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/auto-updater.md)
- [上下文压缩 - Compaction 三层策略与边界机制](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/context/compaction.md): 深度解析 Claude Code 上下文压缩的完整实现：Session Memory 压缩、传统 API 摘要压缩、MicroCompact 局部压缩三层策略，以及 CompactBoundary 消息、工具对保持、PTL 紧急降级等关键机制。
- [项目记忆系统 - 文件级跨对话记忆架构](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/context/project-memory.md): 深度解析 Claude Code 记忆系统：基于文件的持久化存储、MEMORY.md 索引结构、四类型分类法、Sonnet 智能召回、Session Memory 压缩集成。
- [System Prompt 动态组装 - AI 工作记忆构建](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/context/system-prompt.md): 深入解析 Claude Code 的 System Prompt 动态组装过程：缓存策略、分界标记、Section 注册表、CLAUDE.md 多级合并，以及如何将零散上下文拼装为 API 可消费的缓存友好结构。
- [Token 预算管理 - 上下文窗口动态计算](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/context/token-budget.md): 从源码角度揭示 Claude Code token 预算管理：200K 上下文窗口的动态计算、截断机制、缓存优化和自动压缩的完整链路。
- [多轮对话管理 - QueryEngine 会话编排与持久化](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/conversation/multi-turn.md): 从源码角度解析 Claude Code 多轮对话管理：QueryEngine 的会话状态机、JSONL transcript 持久化、成本追踪模型和模型热切换机制。
- [流式响应机制 - Claude Code 打字机效果原理](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/conversation/streaming.md): 解析 Claude Code 流式响应实现：如何通过 SSE 逐 token 接收 AI 输出，实现实时打字机效果，提升用户等待体验。
- [Agentic Loop：AI 自主循环的核心机制](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/conversation/the-loop.md): 深入解析 Claude Code 的 query() 异步生成器循环——从流式 API 调用、工具并行执行、上下文压缩、错误恢复到终止条件的完整状态机，基于 src/query.ts 的源码级分析。
- [自定义 Agent - 从 Markdown 到运行时的完整链路](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/extensibility/custom-agents.md): 揭秘 Claude Code 自定义 Agent 完整链路：Agent 定义的 Markdown 数据模型、三种加载来源、工具过滤策略和与 AgentTool 的联动机制。
- [Hooks 生命周期钩子 - 执行引擎与拦截协议](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/extensibility/hooks.md): 从源码角度解析 Claude Code Hooks 系统：27 种 Hook 事件、6 种 Hook 类型、同步/异步执行协议、JSON 输出 schema、if 条件匹配、以及 Hook 如何注入上下文和拦截工具调用。
- [MCP 协议 - 连接管理、工具发现与执行链路](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/extensibility/mcp-protocol.md): 从源码角度解析 Claude Code 的 MCP 集成：内置 MCP 与外部 MCP 的区别、7 种传输层实现、connectToServer 的 memoize 缓存、工具发现的 LRU 策略、认证状态机、以及 MCP 工具如何进入权限检查链路。
- [Skills 技能系统 - Prompt 即能力的架构哲学](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/extensibility/skills.md): 深入剖析 Claude Code Skills 系统的完整实现：从磁盘加载、Frontmatter 解析、预算感知描述截断、双模式执行（inline/fork）、权限白名单、条件激活、动态发现到远程技能加载，揭示一条完整的 Skill 生命周期链路。
- [External dependencies](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/external-dependencies.md)
- [Auto dream](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/auto-dream.md)
- [Bash classifier](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/bash-classifier.md)
- [Bridge mode](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/bridge-mode.md)
- [Buddy 宠物系统](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/buddy.md): Buddy 是 CLI 中的虚拟宠物伴侣，通过 /buddy 命令孵化、互动，会出现在输入框旁边陪伴你写代码。
- [Context collapse](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/context-collapse.md)
- [Coordinator mode](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/coordinator-mode.md)
- [Daemon](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/daemon.md)
- [Debug 模式](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/debug-mode.md): 通过 VS Code attach 模式调试 CLI 运行时，支持断点、单步执行和变量查看。
- [Experimental skill search](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/experimental-skill-search.md)
- [Fork subagent](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/fork-subagent.md)
- [Kairos](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/kairos.md)
- [Mcp skills](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/mcp-skills.md)
- [Proactive](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/proactive.md)
- [Remote control self hosting](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/remote-control-self-hosting.md)
- [Teammem](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/teammem.md)
- [Tier3 stubs](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/tier3-stubs.md)
- [Token budget](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/token-budget.md)
- [Tree sitter bash](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/tree-sitter-bash.md)
- [Ultraplan](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/ultraplan.md)
- [Voice mode](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/voice-mode.md)
- [Web browser tool](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/web-browser-tool.md)
- [Workflow scripts](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/features/workflow-scripts.md)
- [Ant 特权世界 - Anthropic 员工专属功能](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/internals/ant-only-world.md): 完整记录 Claude Code 身份门控层：USER_TYPE === 'ant' 时解锁的专属工具、命令、API 和代号体系，揭示内外部构建的差异。
- [88 个 Feature Flags - 构建时特性门控全解](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/internals/feature-flags.md): 深入剖析 Claude Code 的 88+ 个构建时 feature flags：bun:bundle 编译时门控机制，揭示被编译器删除的隐藏功能模块。
- [GrowthBook A/B 测试体系 - 运行时功能发布](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/internals/growthbook-ab-testing.md): 揭秘 Claude Code 如何通过 GrowthBook 实现运行时 A/B 测试：用户定向、tengu 命名文化和渐进式功能发布策略。
- [GrowthBook 适配器 - 自定义 Feature Flag 服务器接入](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/internals/growthbook-adapter.md): 通过环境变量连接自定义 GrowthBook 服务器，实现远程 feature flag 控制。无配置时自动回退到代码默认值。
- [未公开功能巡礼 - 8 个隐藏功能深度解析](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/internals/hidden-features.md): 深度解析 Claude Code 中 8 个最令人兴奋的隐藏功能：从永不下线的 AI 助手到 AI 吉祥物，揭示 88+ flags 中最具代表性的未公开特性。
- [自定义 Sentry 错误上报配置](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/internals/sentry-setup.md): 通过环境变量连接自托管或 Cloud Sentry，实现 CLI 运行时的错误捕获与上报。不配置则完全静默。
- [三层门禁系统 - 功能可见性控制架构](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/internals/three-tier-gating.md): 详解 Claude Code 三层门禁系统：构建时 feature()、运行时 GrowthBook 和身份层 USER_TYPE，如何控制功能的可见性和灰度发布。
- [架构全景 - Claude Code 五层架构详解](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/introduction/architecture-overview.md): 从交互层到基础设施层，详解 Claude Code 的五层架构设计。基于 src/main.tsx、src/QueryEngine.ts、src/query.ts、src/tools.ts、src/services/api/claude.ts 的源码级数据流分析。
- [什么是 Claude Code - Terminal Native Agentic Coding System](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/introduction/what-is-claude-code.md): Claude Code 是运行在终端中的 agentic coding system，直接在你的项目目录中读代码、改文件、跑命令、调试程序。了解它的技术定位、架构差异和核心能力。
- [为什么写这份白皮书 - Claude Code 逆向工程分析](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/introduction/why-this-whitepaper.md): 对 Anthropic 官方 Claude Code CLI 的逆向工程分析白皮书。通过反编译 TypeScript 单文件 bundle，深入解析运行时行为与源码结构。
- [Lsp integration](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/lsp-integration.md)
- [Auto Mode - AI 分类器驱动的自主执行模式](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/safety/auto-mode.md): 详解 Claude Code 的 auto mode：基于 transcript classifier 的自动权限决策、两阶段分类流水线、危险权限剥离机制、模式切换状态管理、以及与 plan mode 的协作方式。
- [权限模型 - Allow/Ask/Deny 三级权限体系](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/safety/permission-model.md): 详解 Claude Code 的三级权限模型实现：基于 src/utils/permissions/permissions.ts 的规则匹配引擎、五层规则来源优先级、工具名/命令/路径三维度匹配、Denial Tracking 死循环防护、权限模式切换机制。
- [计划模式 - Plan Mode 先看后做的安全机制](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/safety/plan-mode.md): 基于源码解析 Claude Code Plan Mode 的完整实现：EnterPlanModeTool/ExitPlanModeV2Tool 的工具设计、权限上下文切换机制、Prompt-based 权限请求、计划文件持久化、Teammate 审批流程。
- [沙箱机制 - 权限系统之外的第二道防线](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/safety/sandbox.md): 系统性梳理 Claude Code 的沙箱设计：什么时候会进沙箱、什么时候不会、如何与权限系统联动、默认限制了什么、不同平台下行为有什么差异，以及用户在被拦截时会看到什么。
- [AI 安全至关重要 - Claude Code 安全设计哲学](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/safety/why-safety-matters.md): 当 AI 能操作你的真实项目文件和命令，安全的边界在哪里？分析 Claude Code 的安全挑战、威胁模型和纵深防御策略。
- [Telemetry remote config audit](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/telemetry-remote-config-audit.md)
- [文件操作工具 - 三大工具的源码级解剖](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/tools/file-operations.md): 逆向分析 FileRead、FileEdit、FileWrite 三大工具的完整执行链路：去重缓存、AST 安全编辑、原子性读写、文件历史快照的实现细节。
- [搜索与导航工具 - 代码库精准定位](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/tools/search-and-navigation.md): 解析 Claude Code 的搜索导航工具：Glob 文件匹配、Grep 内容搜索，基于 ripgrep 的高性能代码检索，帮助 AI 在百万行代码中精准定位。
- [命令执行工具 - BashTool 安全设计与实现](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/tools/shell-execution.md): 从源码角度解析 Claude Code BashTool：只读命令判定、AST 安全解析、自动后台化、输出截断和专用工具 vs shell 命令的设计权衡。
- [任务管理系统 - TodoWrite 与 Tasks 双轨架构](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/tools/task-management.md): 揭秘 Claude Code 任务管理系统的双轨架构：V1 内存 TodoWrite 与 V2 文件系统 Tasks，包含依赖管理、认领竞争和验证推动机制。
- [工具系统设计 - AI 如何从说到做](https://ccb-863780bf-feat-local-memory-vault-wiring.mintlify.app/docs/tools/what-are-tools.md): 深入理解 Claude Code 的 Tool 抽象设计：从类型定义、注册机制、调用链路到渲染系统，揭示 50+ 内置工具如何通过统一的 Tool 接口协同工作。