# 入口 · 体验、客户端与执行位置 · Codex · 多 Agent 的异步编码工作流 **作者** Aklman · **章节** 02 / 12 · **首发** 2026.08 · **语言** 中文为主, 中英双语 **原文** https://library.aklman.com/books/codex/02-surfaces **全书 markdown** https://library.aklman.com/books/codex/llms.md **上一章** https://library.aklman.com/books/codex/01-intro/llms.md **下一章** https://library.aklman.com/books/codex/03-cli/llms.md > 本章来自 Aklman · Library, 完整免费阅读。允许 AI 摘读、引用、问答; 转载请保留作者署名与原文链接 (CC BY-NC-ND 4.0, https://library.aklman.com/license)。 --- > 先选体验:Chat 对话,Work 交非代码成品,Codex 进仓库。再选 Codex 的客户端与执行位置:IDE 陪跑、CLI 进终端、桌面视图调度 Local / Worktree / Cloud,GitHub 接团队 PR 流。它们共享工作方式,却不共享所有配置。本章把体验、客户端、运行位置三层拆开,也把手机 Remote、diff 行内编辑、侧栏 PR review、多仓库与 Computer Use 放回真正有用的位置。 别把合并后的现实画成三个并排按钮,也别退回旧的「四个界面」。桌面应用全局切 ChatGPT / Codex,ChatGPT 内再切 Chat / Work;Codex 视图之外,CLI 与 IDE 是本地客户端,cloud 是远程执行环境,GitHub 是派活与 review 的集成层。体验、客户端、运行位置是三套不同问题。本章把它们分开,再决定一件活该留 Local、挪 Worktree、派 Cloud,还是拆给 subagents。 ### I · 先选体验,再选 Codex 的去处 先问「我要什么结果」:快速回答走 Chat,研究或文档 / 表格 / 演示 / Site 成品走 Work,真正要进入仓库、运行命令与测试、审 diff 才走 Codex。[^1]选了 Codex,第二问才是「我在哪里和它协作、它在哪里跑」: | 入口 / 层 | 它最擅长 | 代价 / 边界 | |---|---|---| | IDE 扩展 | 陪你改,盯每一步 diff | 你得在场 | | CLI | 进脚本、进管道、进 CI | 要自己搭上下游 | | 桌面 Codex 视图 | 调度 Local / Worktree / Cloud,集中看 diff 与 PR | 和 ChatGPT 历史分开;运行位置仍要选 | | Cloud | 离机、隔离、批量任务、交回 PR | 先配可复现环境 | | GitHub | 在团队 PR 流里派活、评审、收修复 | 它是集成层,不是本地客户端 | 合并后最值得改变习惯的不是图标,是三个动作。第一,发现 diff 里一行不对,可直接行内编辑,不用为一个字再开一整轮。第二,PR review 留在侧栏,从改动到反馈不必跳出控制台。第三,一个项目能放多个仓库,适合前后端或 app / SDK 联动改动。更快的 Computer Use 则留给**必须看真实 UI 才能复现或验收**的步骤,别让它替代更便宜、更确定的测试和命令。[^2]Codex 不能在 web / mobile 作为普通体验直接选择;手机 Remote 是条件式接回受支持桌面对话,不是在手机本地跑仓库。[^1] --- ### II · 一台引擎,不是一份配置走天下 这里最容易写错的是「共用」两个字。同一台机器上的 **CLI、IDE 扩展、ChatGPT 桌面应用**共用 Codex 的本地认证、`config.toml` 与 MCP —— 在 CLI 接好的服务器,切到编辑器或桌面应用还在。[^3]但云端任务与 GitHub 集成不会越过网络读取你电脑上的 `~/.codex/config.toml`。要让项目规则可移植,把 `AGENTS.md` 与 repo skill 签入版本库;具体 surface 是否调用某个 skill 仍以它的支持范围为准,云端环境、联网与 secrets 另配。[^3] 这条边界决定了本书的读法:第 4 章的本地沙箱与审批、第 5 章的 config、第 7 章的 MCP,先在本机客户端共用;第 6 章的自定义 agent 也属于本地配置层。签入仓库的 AGENTS.md 与 skills 才便于随项目去其它环境。你不是学几套互不相干的工具,也不是配一台会隔空同步一切的机器 —— 你是在同一套工作方式下,管理几处明确不同的运行边界。 --- ### III · 本地、worktree、云端:一个窗口,三种去处 在 ChatGPT 桌面应用里开一个 Codex 对话,先选它在哪跑:**Local** 直接在你当前项目目录里改;**Worktree** 在一个 Git worktree 里隔离改动;**Cloud** 在配好的云端环境里远程跑 —— Local 和 Worktree 都在你这台电脑上。[^4]这是运行位置,不是产品界面计数:同一个窗口里,你决定活留在当前工作树、挪到隔离工作树,还是离开这台机器。 worktree 是这里的关键零件:它基于 git worktree,让 Codex 在同一个项目里并行跑多个互不干扰的对话 —— 各自一份检出,共享 .git 元数据。[^5]Handoff 则把对话与 Git 状态在 Local / Worktree 间安全移动。前台想专心时把独立改动挪进 worktree,要亲手验时再 Handoff 回 Local —— 这是「不守着做完」的本地版,第 8 章再把它推到云端。 另一种并行是**subagents**:同一任务里的角色分工。主线程把检索、审阅、测试分析等独立分块交给专门 agent,再收摘要;CLI 的 `/agent` 只负责看和切线程。[^6]它适合「一件复杂活,多路调查」;多个 worktree / cloud task 适合「几件独立活,各自产生改动」。第 6 章会把配置、调用与 token 账完整走一遍,这里先记边界:subagent 隔离上下文,worktree / cloud 隔离写入。 > 一个实用默认:要陪着看、要立刻验的活,留在 IDE 扩展或 Local;一件复杂但能分块的调查,交给 subagents;方向可信、能自动验的独立改动,挪进 worktree 或送上云。别让一个入口硬扛所有活 —— 编辑器里跑一夜的批处理,和云端里逐字盯的小改,都是放错了地方。 动手 · 把三种并行各用对一次: - 挑一件中等改动,先在编辑器 / Local 里陪着跑一遍,感受「盯每一步」的成本。 - 同一类活,下次开一个 worktree 让它后台跑,你去干别的,回来只看 diff —— 对比你省下的时间。 - 让主 agent 用 subagents 分头查一件复杂问题,再用 /agent 看线程;不要让它们同时改同一处代码。 - 做一次边界测试:CLI 里接的 MCP 在同机 IDE / 桌面应用里应还在;云端不该凭空读到你的 ~/.codex/config.toml。 > 入口跟着活走, > 配置边界别想当然 ## 引用与参考 01 · OpenAI 帮助中心 · ChatGPT Work and Codex —— 桌面应用全局在 ChatGPT 与 Codex 间切换;ChatGPT 内再选 Chat / Work。Codex 保留独立视图与历史,不能作为普通体验在 web / mobile 直接选择;Remote 可在支持时接入桌面 Codex 对话。Work 与 Codex 的 plan、workspace 权限分别控制。截至 2026-08-05。 (OpenAI Help · ChatGPT Work and Codex) 02 · OpenAI · What's new / ChatGPT release notes —— 2026 年 7 月 9 日 Codex app 并入 ChatGPT 桌面应用(macOS / Windows),新增 diff 行内编辑、侧栏 PR review、更快 Computer Use 与多仓库项目。后续桌面层级明确为全局 ChatGPT ↔ Codex,ChatGPT 内 Chat ↔ Work;新布局对所有计划开放,具体 Work / Codex 功能仍看 plan 与 workspace。截至 2026-08-05。 (OpenAI · Codex what's new) 03 · OpenAI Codex 文档 · Config basics / MCP / Customization —— 同一台机器上的 CLI、IDE 扩展与 ChatGPT 桌面应用共用 Codex 的本地 config / auth / MCP;用户默认在 ~/.codex/config.toml,项目覆盖在受信任仓库的 .codex/config.toml。云端任务与 GitHub 集成不会读取你电脑上的用户 config;要随仓库走的规则 / skill 必须签进仓库。截至 2026-08-05。 (OpenAI · Config basics) 04 · OpenAI Codex 文档 · Codex environments —— 在 ChatGPT 桌面应用里开始一个 Codex 对话时选它在哪跑:Local(直接在你当前项目目录)、Worktree(在 Git worktree 里隔离改动)、Cloud(在配置好的云端环境里远程跑);Local 与 Worktree 都在你的电脑上运行。截至 2026-08-05。 (OpenAI · Codex environments) 05 · OpenAI Codex 文档 · Worktrees —— worktree 让 Codex 在同一个项目里并行跑多个互不干扰的对话(基于 git worktree,各自一份检出、共享 .git 元数据);Handoff 把一场对话连同 Git 状态在 Local 与 Worktree 之间安全搬移,由 Codex 处理底层的 Git 操作。仅在 ChatGPT 桌面应用的 Codex 里可用。截至 2026-08-05。 (OpenAI · Worktrees) 06 · OpenAI Codex 文档 · Subagents —— ChatGPT 桌面应用、CLI、IDE 扩展当前默认支持 subagents:主 agent 可以把一件复杂任务拆给多个专门 agent 并行处理,再汇总结果;CLI 里 /agent 查看、切换线程。它适合互不依赖的调查 / 审阅分块,代价是更多 token。Work 的 Ultra 档可主动委派。截至 2026-08-05。 (OpenAI · Subagents) --- *入口 · 体验、客户端与执行位置 · Codex · 多 Agent 的异步编码工作流 · Aklman 著 · CC BY-NC-ND 4.0 · https://library.aklman.com/books/codex/02-surfaces*