一个面向研究者与工程读者的
claude-code文档化源码解析仓库。目标不是复刻官方开发仓库，而是把当前可见源码快照整理成有主线、有层次、可直接研究的中文说明体系。
这个仓库的定位很明确：帮助读者不必先读源码，也能先理解 Claude Code 是怎么工作的，以及 Anthropic 在 agent 设计上到底在做什么。
它主要服务三种阅读目标：
- 先建立 Claude Code 的整体图景，再决定深入哪个子系统。
- 直接研究热点问题，比如 prompt、上下文管理、记忆、工具调用和多 agent 协作。
- 带着文档回到
src/做源码验证，而不是在代码里盲目搜索。
这是一套基于当前可见源码快照整理出的文档化解析，不是官方 Anthropic 仓库，也不假设存在完整可运行的官方开发环境。
- 主体研究对象是
src/中可见实现。 - 涉及真实账号、远程服务、OAuth、IDE 集成、MCP 外部系统的行为，仍应视为“需真实环境验证”。
- 文档中的方法论归纳是基于源码做的研究性解释，不等于 Anthropic 官方表述。
可以把它理解成一套围绕工程工作流设计的 agentic CLI 系统：
main.tsx负责启动与总装配。commands.ts和tools.ts负责把“用户命令”和“模型可执行动作”分开建模。QueryEngine负责把 prompt、上下文、工具调用、状态持久化和恢复串成长期工作会话。permissions、plan mode、managed settings把安全与约束直接嵌进 agent 工作流。AgentTool、tasks、swarm、coordinator进一步把单 agent 工作扩展成多角色协作。
flowchart TD
A["入口层\nmain.tsx"] --> B["交互层\nApp / REPL / AppState"]
A --> C["命令层\ncommands.ts"]
A --> D["工具层\ntools.ts"]
B --> E["执行层\nQueryEngine"]
C --> E
D --> E
E --> F["上下文与记忆\ncontext / compact / session memory"]
E --> G["权限与策略\npermissions / settings / policy"]
D --> H["协作层\nAgentTool / tasks / swarm"]
A --> I["扩展层\nplugins / skills / MCP / LSP"]
A --> J["远程层\nbridge / remote / IDE"]
I --> C
I --> D
J --> B
J --> E
H --> E
先建立整体认知，再进入核心机制：
适合想直接看热点研究问题的读者：
- Prompt 编排：系统提示词与模型决策
- 上下文治理：QueryEngine 与上下文
- 长会话压缩：上下文压缩与历史治理
- 记忆系统：记忆系统：CLAUDE.md、Session Memory 与 Agent Memory
- 工具调用：工具系统
- 方法论总览：Agent 设计理念研究
适合已经读过主干文档，想继续扫清运行协议、灰度控制和特殊运行形态缺口的读者：
- 协议与 transport：22. CLI Structured IO、Control Protocol 与 Transports
- API 接入层：23. API Client、鉴权与 Provider 路由
- 灰度与实验控制：24. GrowthBook、Analytics 与 Feature Control
- Runtime hooks：25. Hooks 与 Runtime Extensibility
- 输入系统：26. Keybindings 与 Vim 输入状态机
- 输出风格：27. Output Styles 与 Response Shaping
- 远程基础设施：28. Direct Connect、Server 与 Upstream Proxy
- 团队记忆：29. Team Memory Sync 与 Shared Repo Memory
- 特殊运行形态：30. Assistant、Voice 与 Runtime Modes
- 工作流观察层：31. Buddy、Git 状态与 Workflow Observability
如果你已经有问题，想直接定位实现：
- 启动入口：src/main.tsx
- 命令装配：src/commands.ts
- 工具装配：src/tools.ts
- 会话核心：src/QueryEngine.ts
- 上下文装配：src/context.ts
- 权限系统：src/utils/permissions/permissionSetup.ts
- Agent 执行：src/tools/AgentTool/AgentTool.tsx
这部分只负责导流，不在首页把所有链接铺开。
| 研究问题 | 先读 | 继续深入 |
|---|---|---|
| Anthropic 如何设计 prompt | 17. 系统提示词与模型决策 | 15. Agent 设计理念研究 |
| Anthropic 如何管理上下文 | 07. QueryEngine 与上下文 | 19. 上下文压缩与历史治理 |
| Anthropic 如何做记忆 | 21. 记忆系统 | 19. 上下文压缩与历史治理 |
| Anthropic 如何做工具调用 | 05. 工具系统 | 08. 权限与安全控制 |
| Anthropic 如何做多 agent 协作 | 20. Coordinator、Swarm 与 Teammate 协作 | 11. 子代理与任务系统 |
| Claude Code 如何被外部宿主接管 | 22. CLI Structured IO、Control Protocol 与 Transports | 28. Direct Connect、Server 与 Upstream Proxy |
| 为什么源码里的功能不一定可见 | 24. GrowthBook、Analytics 与 Feature Control | 18. Settings、Policy 与托管配置 |
首页只给方向，不展开全部章节。完整结构、分层目录和推荐主线在这里：
如果你只想从一个最稳妥的入口开始，建议先读：