Opencode 平台层
Effect-TS 运行时、7 Agent、19 工具、Provider 系统、插件接口
主题
Opencode + OmO + Claude Code技术架构深度解析
基于三个源代码仓库的逐文件分析 · 面向希望深入理解 AI Agent 编程工具内部运作机制的工程师
本报告按主题拆分为 18 个章节 + 1 个附录，建议按顺序阅读或按需跳转：
| 章节 | 主题 | 说明 |
|---|---|---|
| 01 - 概述 | 三个项目的关系 | Opencode、OmO、Claude Code 的定位、架构哲学 |
| 章节 | 主题 | 说明 |
|---|---|---|
| 02 - Opencode 核心架构 | 平台基础设施 | Effect-TS 运行时、Provider 系统、插件接口、事件总线、配置系统、TUI 架构等 |
| 03 - Opencode Agent 系统 | 内置 Agent | 7 个 Agent 定义、Task 调度、LLM 交互循环 |
| 04 - Opencode 工具链与会话模型 | 工具/MCP/LSP/会话 | 19 个内置工具、MCP 协议、LSP 管理、Skill 系统、SQLite 会话模型 |
| 章节 | 主题 | 说明 |
|---|---|---|
| 05 - OmO 插件架构 | 架构 + Hook + Features | 插件初始化、48 个 Hook 五层架构、19 个 Feature 模块 |
| 06 - OmO Agent 体系 | 12 人 Agent 团队 | 五个梯队、模型选择策略、分工与协作 |
| 07 - OmO 后台任务系统 | 异步并行调度 | BackgroundManager、FIFO 队列、通知机制、轮询与空闲检测 |
| 08 - OmO 扩展与权限 | 工具/MCP/Skill/Category + 权限 | 扩展对比、Category 系统、三层权限模型 |
| 章节 | 主题 | 说明 |
|---|---|---|
| 13 - Claude Code 概述与定位 | 项目概览 | 架构总览、技术栈、入口流程、构建系统 |
| 14 - Claude Code Agent 与编排系统 | Agent/Task/Coordinator | 统一 Task 接口、Coordinator 模式、子 Agent 架构 |
| 15 - Claude Code 工具系统 | 50+ 工具深度解析 | Tool 泛型接口、buildTool 工厂、权限矩阵、ToolSearch |
| 16 - Claude Code 状态管理与 UI | 二层状态 + 144 组件 | 全局 STATE、React Store、REPL.tsx、React Compiler |
| 17 - Claude Code 独特设计与服务架构 | 创新特性 | 推测执行、Hooks、Skills、Memory、Companion 等 |
| 章节 | 主题 | 说明 |
|---|---|---|
| 09 - 上下文工程 | Context Engineering | 系统提示构建、Agent 间通信、压缩策略、持久化知识 |
| 10 - 工具系统完整解析 | 工具架构对比 | 架构概览、工具清单、执行管线、权限与安全 |
| 11 - 自动化与开发者体验 | 容错/循环/DX 工具 | 运行时容错、自动化迭代、DX 特性对比 |
| 12 - 实战案例与设计评价 | 工作流 + 评价 | 三系统实战对比、设计亮点与不足 |
| 18 - 三系统架构总评 | 最终总评 | 架构哲学、技术选型、适用场景、演进展望 |
| 章节 | 主题 | 说明 |
|---|---|---|
| 附录 - 关键文件索引 | 源码文件速查 | 三个项目 70+ 个关键文件路径及其作用 |
"我想了解整体架构" → 01-overview.md → 18-comparison.md
"我想了解 Opencode 是怎么工作的" → 02 → 03 → 04
"我想了解 OmO 做了什么增强" → 05 → 06 → 07 → 08
"我想了解 Claude Code 的设计" → 13 → 14 → 15 → 16 → 17
"我想看三系统对比" → 09 → 10 → 11 → 12 → 18
"我想看实际怎么用" → 12-workflows-evaluation.md
"我想查某个文件的作用" → appendix.md
本文档基于 2026 年 4 月 1 日的代码仓库状态生成。随着三个项目的持续演进，部分实现细节可能发生变化。