3. 本地 Agent：Claude Code / Codex / OpenCode¶
这一模块是全书主线。你不需要把 Claude Code、Codex 和 OpenCode 当成三个完全不同的世界。真正要学的是同一条 Agent Loop：读代码、建计划、改文件、跑验证、审 diff、沉淀规则。
先看工具，再跑同一条 loop¶
工具定位¶
| 子章节 | 目标 |
|---|---|
| 1-why-local-agents.md | 理解本地 Agent 的价值 |
| 2-codex-operating-model.md | 理解 Codex 的操作模型 |
| 3-claude-code-operating-model.md | 理解 Claude Code 的操作模型 |
| 4-opencode-operating-model.md | 理解 OpenCode 的操作模型 |
共通操作¶
| 子章节 | 目标 |
|---|---|
| 5-common-agent-loop.md | 掌握共通 Agent Loop |
| 6-prompt-templates.md | 复用任务模板 |
| 7-first-session-walkthrough.md | 跑通第一次真实任务会话 |
| 8-debugging-and-recovery.md | 处理 Agent 跑偏和失败恢复 |
编号 3.4 留给 OpenCode 的操作模型，所以共通操作从 3.5 开始。第一次上手可以按 3.5 -> 3.7 读；已经熟悉本地 Agent 的读者，可以直接拿 3.6 的任务模板做自己的工作入口。
选型¶
| 子章节 | 目标 |
|---|---|
| 9-cli-comparison-and-selection.md | 按约束选择 CLI Agent |
核心结论¶
Claude Code、Codex 和 OpenCode 的共同核心是：
flowchart LR
A[读代码] --> B[建计划]
B --> C[改文件]
C --> D[跑验证]
D --> E[看 diff]
E --> F[修复]
F --> G[记录经验]谁能把这个循环跑稳定，谁就真正会用本地 Agent。
三个主力 CLI 的分工¶
| 工具 | 适合放在什么位置 |
|---|---|
| Claude Code | 开箱体验、复杂代码库、skills / hooks / subagents / MCP 生态 |
| Codex | 严谨执行、测试修复、代码审查、OpenAI 生态 |
| OpenCode | 开源可控、多模型、本地模型、LSP 和自定义 agent |
| Gemini CLI | 辅助阅读、长上下文资料整理、低成本第二意见 |