从“会用 Agent”到“懂 Agent 架构取舍”。
本仓库是对多套 Code Agent 的源码级拆解 + 横向对比，核心目标：
- 看懂 Agent Loop 如何驱动“推理 -> 工具调用 -> 反馈 -> 再推理”
- 看懂不同项目在 Safety、Memory、MCP、Checkpoint 等问题上的工程取舍
- 为你设计/改造自己的 Agent 系统提供可复用参考
💡 阅读建议: 从 Codex 开始（文档最完整），再根据兴趣选择。每个项目都有独特的架构亮点。
|
🔮 Claude Code (TypeScript)
📄 概览 · Agent Loop · Memory |
🦀 Codex (Rust)
|
🔷 Gemini CLI (TypeScript)
|
🌙 Kimi CLI (Python)
📄 概览 · 循环 · Checkpoint |
|
⚡ OpenCode (TypeScript)
|
🔬 SWE-agent (Python)
|
🎯 Qwen Code (TypeScript)
|
📚 快速入口
|
截至 2026-03-31，docs/ 目录共 177 篇文档：
- 主线技术文档：118 篇
- Questions 专题文档：59 篇
| 类别 | 目录 | 内容 |
|---|---|---|
| 核心项目（7） | codex / gemini-cli / kimi-cli / opencode / swe-agent / qwen-code / claude-code |
每个项目按统一编号体系拆解（01~13） |
| 跨项目对比 | comm |
共性抽象、架构对比、ACP、Plan & Execute、未来方向 |
| 补充专题 | cursor / claude |
Cursor Checkpoint 存储分析、Claude 消息上下文保留机制 |
绝大多数项目都按以下主线组织，便于横向对读：
| 编号 | 主题 | comm | codex | gemini-cli | kimi-cli | opencode | swe-agent | qwen-code | claude-code |
|---|---|---|---|---|---|---|---|---|---|
01 |
概览 | link | link | link | link | link | link | link | link |
02 |
CLI 入口 / Session 管理 | link | link | link | link | link | link | link | link |
03 |
Session 运行时 | link | link | link | link | link | link | link | link |
04 |
Agent Loop | link | link | link | link | link | link | link | link |
05 |
Tools 系统 | link | link | link | link | link | link | link | link |
06 |
MCP 集成 | link | link | link | link | link | link | link | link |
07 |
Memory Context | link | link | link | link | link | link | link | link |
08 |
UI 交互 | link | link | link | link | link | link | link | link |
09 |
Web Server | link | link | link | link | link | link | link | link |
10 |
Safety Control | link | link | link | link | link | link | link | link |
11 |
Prompt 组织 | - | link | link | link | link | link | link | link |
12 |
日志记录机制 | link | link | link | link | link | link | link | link |
13 |
ACP 集成 | link | link | link | link | link | link | link | link |
| 目录 | 主线文档 | Questions | 快速入口 |
|---|---|---|---|
| comm | 15 | 2 | 概览 / Agent Loop 对比 / ACP 是什么 / ACP 跨项目对比 / Plan and Execute 对比 |
| codex | 13 | 8 | 概览 / Loop / Safety |
| gemini-cli | 13 | 9 | 概览 / Loop / Memory |
| kimi-cli | 16 | 12 | 入门 / 概览 / Memory+Checkpoint |
| opencode | 14 | 10 | 概览 / Session 管理 / Loop |
| swe-agent | 12 | 11 | 概览 / Loop / Tools |
| qwen-code | 12 | 4 | 概览 / Loop / Safety |
| cursor | 1 | 2 | Checkpoint 映射 / state.vscdb 分析 |
| claude-code | 13 | 10 | 入门 / 概览 / Agent Loop / Memory |
完整目录导航请看：
_sidebar.md
| 主题 | 文档入口 |
|---|---|
| Tool 并发调用 | Codex / Gemini CLI / Kimi CLI / OpenCode / SWE-agent / Claude Code |
| 工具错误处理 | Codex / Gemini CLI / Kimi CLI / OpenCode / SWE-agent / Qwen Code / Claude Code |
| 防止无限循环 | Codex / Gemini CLI / Kimi CLI / OpenCode / SWE-agent / Qwen Code / Claude Code |
| 上下文压缩 | Codex / Gemini CLI / Kimi CLI / OpenCode / SWE-agent / Qwen Code / Claude Code |
| Plan and Execute | 跨项目总览 / Codex / Gemini CLI / Kimi CLI / OpenCode / SWE-agent / Claude Code |
| Checkpoint 与回滚 | Kimi 实现 / Kimi 权衡 / OpenCode 实现 / SWE-agent 实现 / SWE-agent 权衡 / Cursor 映射分析 |
| Subagent / 多代理 | Codex / Gemini CLI / Kimi CLI / OpenCode / SWE-agent / Qwen Code / Claude Code |
| Why keep reasoning | Gemini CLI / Kimi CLI / OpenCode / SWE-agent / Claude Code |
| ACP 协议实现 | 跨项目 ACP 对比 / 什么是 ACP |
- Checkpoint：
kimi-cli/opencode/swe-agent/cursor - 推理保留与上下文：
gemini-cli/kimi-cli/opencode/swe-agent/claude - 未来趋势：
从第一性原理看 Coding Agent 的未来突破
如需对照源码阅读：
git clone https://github.com/openai/codex.git
git clone https://github.com/google-gemini/gemini-cli.git
git clone https://github.com/MoonshotAI/kimi-cli.git
git clone https://github.com/SWE-agent/SWE-agent.git
git clone https://github.com/anomalyco/opencode.git
git clone https://github.com/QwenLM/qwen-code.git- 时间: 2026-02-22
- 来源: 各项目 GitHub 当时最新分支
- 方法: 源码阅读 + 关键流程图解 + 跨项目对比
欢迎提交 Issue / PR：
- 修正文档中的事实性错误或路径失效
- 增补新的 Questions 专题（建议沿用已有命名风格）
- 在
template/下复用模板补齐尚未覆盖的分析维度