Claude Code vs Opencode 综合对比总结

1. 对比范围

本组文档基于以下 canonical 模块进行比较：

• 01-query-loop.md
• 02-tool-runtime.md
• 03-permission.md
• 04-context-state.md
• 05-agent-system.md
• 06-extension-system.md
• 07-ui-repl.md

对比依据均以 claude-code-rev 与 opencode/packages/opencode/src 的实际源码路径为准，而不是只依据既有总结文档。

2. 总体架构取向

2.1 Claude Code

Claude Code 的总体风格是“高耦合但高治理”的统一运行时：

• Query loop、tool runtime、permissions、compaction、agent、plugin、MCP、REPL 都被拉进一个强主控系统。
• 很多能力最终汇聚到少数几个重量级入口，例如 query.ts、toolExecution.ts、AgentTool.tsx、REPL.tsx。
• 系统优先解决的是长会话续航、复杂权限治理、多代理协作、插件生态和富交互终端体验。

2.2 Opencode

Opencode 的总体风格是“分层清晰、通过组合完成能力集成”的运行时：

• Session、tool、permission、agent、plugin、MCP、TUI 都是相对独立的模块。
• session/llm.ts、session/processor.ts、tool/registry.ts、permission/index.ts、plugin/index.ts、cli/cmd/tui/app.tsx 等模块边界较明确。
• 系统优先解决的是配置可组合、扩展接入直接、状态模型清晰，以及 CLI/TUI 双路径并存。

3. 分模块结论

模块	Claude Code	Opencode
Query Loop	集中式大循环，恢复能力强	processor + llm + compaction/retry 分层
Tool Runtime	编排、权限、hook、MCP 深度耦合	注册表中心，协议统一，运行时更轻
Permission	多来源规则 + 模式 + classifier + hook	显式规则与 ask/allow/deny 审批流
Context / State	layered compaction + transcript 文件持久化	数据库/结构化状态 + 独立 compaction
Agent System	多形态代理调度平台	基于 session 的子代理机制
Extension System	分能力治理的扩展平台	最终统一回到 tool/plugin/session 接口
UI / REPL	REPL 是主产品形态	CLI 与 TUI 双路径并行

4. 关键设计取舍

4.1 Claude Code 的强项与代价

强项：

• 长对话、复杂工具、权限和代理协作的治理能力很强。
• 主交互层和运行时深度一体化，用户体验完整。
• 更像“终端里的完整代理操作系统”。

代价：

• 核心入口很厚，理解成本高。
• 模块间耦合度高，替换和裁剪成本大。
• 想只拿其中一层能力复用，难度较高。

4.2 Opencode 的强项与代价

强项：

• Session、tool、agent、plugin、TUI 各层职责相对清晰。
• 扩展最终都能落到统一接口，接入路径短。
• 更容易把某一层单独替换或演进。

代价：

• 复杂治理能力不如 Claude Code 那么集中和完整。
• 一些高级恢复、协作、权限自动化能力更多依赖外围模块配合。
• 在极复杂的代理协作和长会话治理上，系统厚度不如 Claude Code。

5. 适用场景判断

5.1 更适合把 Claude Code 当作参考样板的场景

• 想构建一个带强治理能力的 agentic coding 平台。
• 需要复杂权限、长会话压缩恢复、多代理协作、远程/隔离执行。
• 希望终端交互本身就是核心产品体验。

5.2 更适合把 Opencode 当作参考样板的场景

• 想构建一个边界清晰、易扩展、可逐层替换的 coding agent 系统。
• 需要同时支持脚本式 CLI 和交互式 TUI。
• 希望 plugin、skill、MCP 等扩展以统一接口快速接入。

6. 最终结论

Claude Code 和 Opencode 的差异，不是“一个复杂一个简单”这么粗糙，而是两种不同的系统哲学：

• Claude Code 选择把复杂能力集中到统一运行时中，以治理和续航为先。
• Opencode 选择用更清晰的模块边界把能力组合起来，以可扩展和可替换为先。

如果把两者抽象成一句话：

• Claude Code 更像“全栈代理工作台”。
• Opencode 更像“模块化代理框架”。

这也是两边在 Query Loop、Tool Runtime、Permission、Agent、Extension、UI/REPL 上反复出现的共同模式。