Codex CLI 学习教程
20 天 · 每天约 30 分钟 · 基于开源仓库 openai/codex（Rust codex-rs）
学会怎么用终端编码 Agent，并对照源码看清从回车到工具执行的全链路。
桌面 GUI 不在本仓——见 桌面端教程。
开篇 · 这是什么
codex exec，
核心是 Rust，npm 只是发射器。
| 你将学会 | 对应周 |
|---|---|
| 安装登录、沙箱审批、子命令、TUI slash | 第 1 周 |
| 启动链、Op/app-server、run_turn、配置认证 | 第 2 周 |
| 工具/沙箱/MCP/Skills/Plan | 第 3 周 |
| 会话、exec/CI、SDK、IDE 桥、收官 | 第 4 周 |
Agent 循环总图
灵魂是一个圈：输入 → app-server → core turn → 模型 → 工具（沙箱）→ 回填 → … 直到完成。
Turnrun_turn
怎么用这份教程
openai/codex 为准；行号会随 upstream 漂移，以符号搜索（rg）为准。项目全景与目录地图
Codex CLI 是什么、和桌面端/IDE 的边界、仓库顶层与 codex-rs 关键 crate。
安装、登录与第一次对话
安装方式、ChatGPT / API Key 登录、交互模式发第一条任务、doctor 自检。
沙箱与审批（必读）
SandboxMode / AskForApproval 两层防护、常用 flag、源码枚举对照。
CLI 子命令全家桶
MultitoolCli：exec / login / mcp / resume / review / features … 用法地图。
TUI 交互与 Slash 命令
终端界面结构、高频 /model /permissions /plan /skills、!shell 捷径。
启动链：从 npm 到 TUI
codex.js 选平台二进制 → cli/main.rs 分发 → tui 挂载 in-process app-server。
Op 协议与 app-server
protocol::Op、JSON-RPC v2、TUI/exec/IDE 共用同一条控制面。
Agent Turn 主循环
UserInput → run_turn → 流式模型 → 工具调用 → 回填，核心引擎纵切。
配置分层与 config.toml
~/.codex/config.toml、profile、-c 覆盖、features 开关、schema。
认证与模型 Provider
login 流程、API Key、OSS/Ollama、model_provider 配置。
工具系统总览
spec_plan / router / handlers：shell、patch、MCP、web_search…
Shell、apply_patch 与沙箱执行
命令怎么进 Seatbelt/bwrap、补丁语言、execpolicy 规则。
MCP、Plugins 与扩展工具
codex mcp add、/mcp、Codex 自身当 MCP server、插件安装。
Skills 与 AGENTS.md
项目指令如何注入上下文、SKILL.md 发现与 /skills、/init。
Plan 模式与协作模式
Default vs Plan、/plan /goal /agent、多 agent 工具入口。
会话：resume / fork / rollout
会话如何落盘、恢复与分叉、compact 压缩上下文。
codex exec：非交互与 CI
--json / -o / schema、CI 安全默认、review 子命令。
TypeScript SDK 嵌入
sdk/typescript 如何包一层 CLI JSONL，脚本化控制 Agent。
app-server 与 IDE/桌面桥
富客户端共用协议、daemon / remote-control、和桌面端的关系。
收官串讲与学习路线
全链路回顾、必读文件清单、和 Claude Code / 桌面端对照、下一步。