原文: English original · Product Compass

来源推文: @PawelHuryn / 2066052757895749891

一种无需 IDE 也能进入 repo 的方式。它可以和 Claude Code 并排运行，共享 skill 和 MCP，还能充当同行评审。

大家好，我是 Paweł。和我交流过的大多数 PM，平时都深度依赖 Claude（Cowork 或 Claude Code），但还没有真正把 Codex 用起来。数据说明，他们大概率应该试一试。

Codex 在四个月里，周活从大约 20 万增长到接近 400 万。Claude Code 则在 3 月初突破了 200 万。如果你点开了这篇文章，你大概率就是那 200 万人中的一个；而另外那 400 万人，已经在用另一个你还没认真试过的工具。

而且 Codex 早就不只是开发者工具了。如果 VS Code 一直让你觉得像一堵墙，那 Codex app 更像是一个带文件树、可视化 diff 和长时 session 的聊天窗口。PM 过去如果一直回避代码仓库，现在也不必再这样做。

ChatGPT Plus 每月 20 美元，已包含 Codex。整个配置大约只需要五分钟，这篇文章就是完整 walkthrough。

读完这篇指南后，你会得到：

  • 已安装并指向你的 repo 的 Codex app
  • 已把 AGENTS.md 桥接到 CLAUDE.md，让两个 runtime 共用一份单一事实源
  • 你日常使用应用的 Plugins，以及如果你平时用 AI 构建内容时所需同步的项目 skill
  • 在两个 runtime 中都跑起来的 MCP，以及一条可一次性完成导入的 prompt
  • 能把 Codex 当成同行来做 review 的 Claude Code
  • 一套在手机上工作的方案判断：该用 cloud tasks，还是做远程控制

完整的 Cowork / Claude Code / Codex 对比在文末。先从配置开始。

1. 为什么 PM 要加上 Codex

我给自己的工作流加上 Codex，主要有五个原因，按它们在实际工作中出现的频率排序：

  • 不用 VS Code 也能进入 repo。如果 IDE 一直像一道门槛，Codex app（桌面版）就是一个带文件树、可视化 diff 和长时聊天 session 的窗口。你不用学命令，也不用自己折腾一堆扩展配置，甚至可以直接通过给 Codex 留评论来编辑文件。Cowork 更偏聊天界面，没有文件树，也没有 diff。
  • 手动 Compact。你可以自己决定什么时候压缩 session，而不是等模型把上下文打满。在 Codex 里，输入 c，再输入 /com，等 Compact 出现后选中即可。Claude Code 在 CLI 里有 /compact。Cowork 没有等价的手动重置能力。这和你的预算直接相关：Claude Code 的限额其实很宽松，问题通常出在你的配置。
  • 多一个视角。当我想让某个 prompt 或一段代码多一双眼睛时，我会把它交给那个没参与编写的 runtime。模型不同，遗漏点也会不同。
  • 套餐里顺带包含图像生成。附带 Codex 的 ChatGPT 订阅本身就包含图像生成，而 Claude 不覆盖这条 workflow。
  • 能在同一个 repo 上与 Claude Code 并行运行。相同的文件、相同的 skill、相同的 MCP。切换 runtime 时，不用重建整套配置。

2. 安装 Codex（桌面 app 和 VS Code 扩展）

你需要安装两样东西。Codex app（桌面版）是长时聊天 session 和 Compact 所在的主工作区；Codex for VS Code 则是编辑器扩展，能让你在与 Claude Code 相同的窗口里调用 Codex。

它们共用同一个 OpenAI 账号，也都能操作同一个 repo，只是各自适合不同的任务。

Codex app（桌面版）

从 OpenAI 下载 Codex app。使用拥有 Plus、Pro 或 Business 的 ChatGPT 账号登录，Codex 已包含在这三个计划中。

第一次打开时，系统会提示你是否迁移 VS Code 设置。我通常会跳过。不是因为它麻烦，而是因为在点确认前，你最好先知道它究竟会导入什么。之后你随时都可以在 Settings 里再做迁移，或者直接让 Codex 帮你处理。

打开你已经与 Claude 一起使用的同一个项目文件夹。文件树会出现在右侧，可视化 diff 也会在同一个面板里显示。

Codex for VS Code

从 VS Code marketplace 安装 Codex 扩展，并使用同一个 OpenAI 账号登录。

如果你已经在 VS Code 里使用 Claude Code 扩展，那么两个扩展都会出现在 activity bar 中，你可以通过 tab 在它们之间切换。

为什么两种界面都保留？Codex app 更适合长时间聊天 session 和 Compact；Codex for VS Code 更适合直接编辑 repo，包括 app 文件选择器默认会隐藏的点目录（.agents、.codex）。这才是完整的开发体验。

3. 让 Codex 理解你的 repo：从 AGENTS.md 到 CLAUDE.md

Codex 会在 repo 根目录寻找 AGENTS.md。Claude Code 则会寻找 CLAUDE.md。如果你把它们当成两份独立文档来维护，它们迟早会漂移。

解决方法是做一个单文件桥接：AGENTS.md 只放一段简短指引；CLAUDE.md 保持为权威文档。Codex 读到 AGENTS.md 后，看到指引，就会继续去读 CLAUDE.md。

把下面这段内容放到 repo 根目录，保存为 AGENTS.md：

# AGENTS.md

This repository keeps its canonical agent instructions in [CLAUDE.md](./CLAUDE.md).
When operating in this repo:

1. Read and follow `CLAUDE.md` as the source of truth.
2. Treat references to "Claude Code" as applying to Codex when you are the acting agent.
3. Do not duplicate `CLAUDE.md` content here. Update `CLAUDE.md` instead.

一个文件，一份单一事实源，两个 runtime 都按它执行。

AGENTS.md 是桥，CLAUDE.md 是主体。我使用的结构如下：

  1. Communication：agent 该如何沟通、应该产出什么内容
  2. [For personal work] About me：角色、受众、社交媒体账号
  3. [For product work] Strategy：市场分层、价值主张、取舍
  4. Project structure：代码和资料放在哪里、整体架构如何、有哪些约定
  5. Workflow：我们如何做事（review、发布）。它不是操作手册，而是协作规则
  6. Progressive disclosure：链接到更深的文件（如 strategy.md、knowledge/INDEX.md，或你自己维护的其他资料），按需加载，而不是每个 session 都全部塞进上下文

只有当某段内容原本会在每次 session 里被反复解释，它才值得进 CLAUDE.md。CLAUDE.md 不是文档中心，而是 agent 对你工作方式的长期记忆。

Progressive disclosure 之所以重要，是因为上下文从来不是免费的。不要把 500 行内容都硬塞进 CLAUDE.md，结果其中 100 行只对某一个 workflow 有用。核心文件要保持精炼，其他内容则通过链接按需展开。

4. 配置并共享 skill

如果你以前没用过 skill，可以把它理解成一组可复用的指令包。SKILL.md 会告诉 runtime 什么时候触发这套 skill，以及接下来该做什么。

在 Codex 里，配置 skill 有两种路径。

先从用户级 skill 开始。Codex app 自带一个 Plugins 面板，点一下就能安装 Gmail、Linear、Jira、Slack 等应用。应用连接和对应 skill 会一起装好。

安装好 Plugins 后，Codex 就能读取你的 CLAUDE.md，并与你每天在用的那些应用协同工作。

这已经构成了 PM 可用的最小 Codex 配置。

再往下一步，就是让 Codex 和 Claude Code 像一个操作系统那样协同运转：有经过挑选的 skill、有在两个 runtime 之间同步的项目 skill、有镜像的 MCP，以及一套可重复执行的 review loop。