~/ai-manual/codex ❯ ls codex

Codex

先完成第一次真实修改，再沿着会话控制、日常任务、项目规则、扩展与自动化一路进阶。

持续更新 · 保持最新官方内容核验至 2026 年 9 月 · 当前基线 Codex CLI 0.151.0 查看官方更新日志

❯

01

选对入口并完成第一次可回退的修改

先获得一次真实成果，再解释背后的机制。

01Codex 是能直接操作项目的编程代理区分编程代理与聊天助手，并看懂 App、CLI、IDE 和云端入口。约 17 分钟主线最近更新❯02按平台装好 Codex 并确认登录可用按平台安装 App 或 CLI，完成登录、版本验证和常见故障排查。约 26 分钟主线最近更新❯03用一次真实修改跑通 Codex 最小闭环在玩具项目里完成读代码、改代码、审 Diff 与 Git 回退闭环。约 26 分钟主线会员❯

02

能控制会话、看懂限制并安全放权

有过第一次修改经验后，再理解会话控制、沙箱和审批。

04掌握 Codex CLI 的日常交互与启动方式掌握交互界面、启动参数和 Shell 快捷操作，并分清 exec 模式。约 24 分钟主线最近更新❯05按当前入口的真实命令集控制会话不同入口拥有不同命令集，应以当前界面的真实菜单控制会话。约 29 分钟主线最近更新❯06从实际行为理解沙箱、审批和项目规则沙箱决定能动多大，审批决定是否询问，项目规则负责持续约束。约 20 分钟主线会员❯07分别调节可操作范围和审批频率分别配置沙箱范围和审批策略，再按场景决定最小必要放权。约 29 分钟主线最近更新会员❯08用默认断网、系统沙箱和人工审批守住风险默认断网、系统沙箱和人工审批共同防范注入与凭据外泄。约 32 分钟主线最近更新会员❯

03

选定最合适的界面、平台与运行位置

根据是否要本地交互、异步委派或跨平台工作选择入口。

09用桌面 App 分配本地、Worktree 和云端任务桌面端用 Local、Worktree 和 Cloud 分配任务，并集中审阅改动。约 30 分钟选读最近更新会员❯10在 IDE 里精准给上下文并审阅改动IDE 通过文件选区、审批档位和云端委派缩短编码协作链路。约 25 分钟选读会员❯11把适合异步运行的任务交给隔离云环境云端任务在隔离容器运行，设置脚本、Secrets 和网络决定边界。约 27 分钟选读最近更新会员❯12在原生 Windows 与 WSL 间选对运行方式Windows 要在原生与 WSL 间取舍，并处理路径、换行和沙箱差异。约 20 分钟选读会员❯

04

按预算和任务难度选对模型

确认工具适合自己以后，再决定付费方式、模型和第三方兼容。

13分清 ChatGPT 订阅、API 和积分三套成本ChatGPT 订阅与 API 分属两套账，额度受模型和任务规模影响。约 24 分钟主线会员❯14用模型与推理强度匹配任务难度先按任务选模型，再用推理强度平衡质量、速度和费用。约 16 分钟主线会员❯15先确认协议兼容，再接第三方模型第三方模型能否接入首先取决于 Responses API 等协议兼容性。约 23 分钟进阶会员❯

05

能稳定完成日常任务并自行验证结果

把提示、工作流、提速和完整交付连成一条主线。

16用目标、范围、约束和验收减少返工用目标、范围、约束和验收四件套减少 Codex 猜测与返工。约 22 分钟主线会员❯17用固定流程完成探索、修复、重构和测试探索、修复、重构和测试各有固定流程，均须保留验证出口。约 22 分钟主线会员❯18用准确上下文、自验证和合理并行提速准确上下文、任务降档、合理并行和自验证比单纯换快模型有效。约 17 分钟主线会员❯19从项目说明书到提交跑通一次完整开发按说明书、派活、权限、自测和提交完成一个可复现小项目。约 17 分钟主线会员❯

06

让项目规则、配置和记忆长期稳定生效

重复要求不再靠口头提醒，而是进入项目规则和配置。

20用目录链上的 AGENTS.md 管住项目规则AGENTS.md 沿目录链拼接，越接近工作目录的规则越具体。约 22 分钟主线会员❯21用配置层级、信任和 Profile 控制实际行为config.toml 的层级、信任限制和 Profile 决定实际运行配置。约 33 分钟主线最近更新会员❯22让硬规则与概率性记忆各归其位硬规则写 AGENTS.md，Memories 与 Chronicle 只作概率性补充。约 32 分钟主线最近更新会员❯

07

把外部工具、网页和重复流程变成可控能力

先控制外部访问，再把重复流程打包成可复用能力。

23接入外部工具后继续收口权限和超时MCP 接入外部工具后，还要限制工具集合、批准方式和超时。约 26 分钟进阶最近更新会员❯24按最小权限选择浏览器或全桌面操控按内置浏览器、登录态 Chrome、全桌面操控逐级选择最小权限。约 31 分钟进阶最近更新会员❯25把可重复流程封成按需触发的 SkillSkill 用描述触发按需流程，并支持创建、安装与按配置禁用。约 28 分钟进阶会员❯26用插件分发整套能力并逐项处理授权插件将 Skill、App、MCP 和 Hook 打包分发，各组件另有授权门槛。约 27 分钟进阶最近更新会员❯27用 Rules 管命令出圈，用 Hooks 自动执行Rules 控制命令出圈，Hooks 在生命周期事件自动执行或阻断。约 41 分钟进阶最近更新会员❯

08

让并行、Git 协作和自动化稳定运行

从隔离并行开始，逐步进入审查、脚本、定时任务和产品集成。

28明确分工后再让子代理并行工作先明确分工、模型和汇总方式，再把独立任务交给子代理。约 29 分钟进阶最近更新会员❯29用 Worktree 隔离任务并复现环境Worktree 隔离并行任务，Handoff 与 setup 负责流转和环境复现。约 24 分钟进阶会员❯30分清本地审查、云端 Review 和最终放行本地 Review 与 GitHub 云审查是两条链，合并和强推仍由人批准。约 33 分钟进阶最近更新会员❯31用 `codex exec` 把代理接入脚本与 CIcodex exec 用输出分流、JSONL、文件结果和续跑进入脚本与 CI。约 28 分钟进阶会员❯32按事件或时间选择两条自动化路径GitHub Action 处理事件触发，桌面 Automations 处理本机定时任务。约 42 分钟进阶最近更新会员❯33按集成深度选择召唤、SDK 或 App ServerSlack、Linear 负责零代码召唤，SDK 与 App Server 负责程序嵌入。约 36 分钟进阶最近更新会员❯

09

把实践沉淀为稳定工作方法

把零散技巧压成每次都能重复执行的方法。

34用规则、计划、自验证和证据链形成工作法用短规则、计划、自验证和线上证据链把协作从碰运气变成流程。约 19 分钟主线会员❯

10

按角色进入迁移或企业治理支线

只有正在迁移工具或负责团队治理时，才需要进入这条支线。

35把 Claude Code 工作流正确迁移到 Codex迁移重点是转换配置，并把权限理解改为沙箱与审批双旋钮。约 28 分钟选读最近更新会员❯36用身份、策略、审计和成本治理企业 Codex企业落地围绕身份、数据、集中策略、审计和成本治理展开。约 22 分钟选读最近更新会员❯

11

遇到问题时能快速定位并查证

FAQ、速查与术语表不必顺序阅读，需要时再回来。

37从版本、登录和权限三项开始排障先查版本、登录和当前权限，再按网络、模型、上下文等症状排障。约 23 分钟工具书最近更新会员❯38快速查到命令、配置、权限和模型用法集中查询 CLI、斜杠命令、配置键、沙箱档位和模型选择。约 22 分钟工具书最近更新会员❯39按四类概念快速查清 Codex 术语按基础概念、Codex 专有能力、扩展和模型四组查询术语。约 20 分钟工具书会员❯