Agent-Base：七大 Code Agent 源码深度解析

从“会用 Agent”到“懂 Agent 架构取舍”。

在线阅读：https://giraffe-tree.github.io/agent-base/

仓库定位

本仓库是对多套 Code Agent 的源码级拆解 + 横向对比，核心目标：

• 看懂 Agent Loop 如何驱动“推理 -> 工具调用 -> 反馈 -> 再推理”
• 看懂不同项目在 Safety、Memory、MCP、Checkpoint 等问题上的工程取舍
• 为你设计/改造自己的 Agent 系统提供可复用参考

7 个项目对比

💡 阅读建议: 从 Codex 开始（文档最完整），再根据兴趣选择。每个项目都有独特的架构亮点。

🔮 Claude Code (TypeScript)

适合研究: React TUI 与 AsyncGenerator 模式

• Ink 终端 React 组件化 UI
• 统一 query() AsyncGenerator 驱动

📄 概览 · Agent Loop · Memory

🦀 Codex (Rust)

适合研究: 企业级安全机制

• 完善的安全沙箱和权限分级
• 推荐入门首选

📄 概览 · 循环 · MCP

🔷 Gemini CLI (TypeScript)

适合研究: 内存管理和上下文策略

• 三层分层内存架构
• 状态机驱动的调度器

📄 概览 · 循环 · 内存

🌙 Kimi CLI (Python)

适合研究: 状态持久化和回滚

• Checkpoint 完整实现（时间旅行）
• 命令级撤销/重做

📄 概览 · 循环 · Checkpoint

⚡ OpenCode (TypeScript)

适合研究: 现代 Web 集成

• Vercel AI SDK 架构
• 流式响应处理

📄 概览 · 循环 · MCP

🔬 SWE-agent (Python)

适合研究: 学术研究/自动化修复

• 可配置 History Processors
• 专为软件工程任务设计

📄 概览 · 循环 · Prompt

🎯 Qwen Code (TypeScript)

适合研究: 工程化架构与循环检测

• 完善的循环检测服务
• 结构化 Agent 设计模式

📄 概览 · 循环 · MCP

📚 快速入口

不想纠结？从这里开始

• 快速开始指南
• Agent Loop 对比
• MCP 集成对比
• 高频问题索引

📄 总览 · 对比

覆盖范围（基于 docs/ 全量盘点）

截至 2026-03-31，docs/ 目录共 177 篇文档：

• 主线技术文档：118 篇
• Questions 专题文档：59 篇

统一分析框架（01~13 编号）

绝大多数项目都按以下主线组织，便于横向对读：

文档地图（按目录）

完整目录导航请看：_sidebar.md

高频 Questions 专题入口

三段学习路径

路线 A：30 分钟快速建立直觉

1. Code Agent 全局认知（comm）
2. Codex Agent Loop
3. 跨项目 Agent Loop 对比

路线 B：2 小时完成架构骨架

1. 跨项目概览
2. Tools 对比
3. MCP 对比
4. Memory 对比
5. Safety 对比
6. Plan & Execute 对比
7. ACP Integration 对比

路线 C：专题深入

1. Checkpoint：kimi-cli / opencode / swe-agent / cursor
2. 推理保留与上下文：gemini-cli / kimi-cli / opencode / swe-agent / claude
3. 未来趋势：从第一性原理看 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/ 下复用模板补齐尚未覆盖的分析维度