README

Codex with ChatGPT

English | 简体中文

 ChatGPT 负责思考，Codex 负责干活。

 解决什么问题

ChatGPT 付费订阅的网页版额度大量闲置，Codex 却在消耗紧张的 API 额度做
规划和 Review。本项目把"思考"交给你已付费的网页版 ChatGPT，Codex 只负责
执行。不用 API Key、不搞逆向代理——官方网页 + 只读 MCP 桥接。

 这是什么

把 ChatGPT 网页版变成 Codex 编码会话的"规划与审查大脑"，而执行权完全保留在
Codex 手里。你的仓库永远不会被上传——ChatGPT 通过一条安全的、OAuth 保护的
只读 MCP 连接，按需读取当前工作区里它真正需要的那几行代码。

 一段话安装（纯小白专用）

不懂 git、Node、终端？完全不需要懂。把下面这段话原样复制给你的编码
Agent（Codex），然后去倒杯咖啡：

text
请帮我完整安装并配置 Codex with ChatGPT，全程自动，我是不懂技术的小白，
所有事情你自己做：

1. 环境自检：需要 git 和 Node.js ≥ 20，缺什么就自动安装
  （macOS 用 Homebrew，Windows 用 winget），同时安装 cloudflared。
2. 下载：把 https://github.com/XiaoDuoYa/codex-with-chatgpt 克隆到
   ~/codex-with-chatgpt（已存在就 git pull 更新）。
3. 构建：在该目录里执行 corepack pnpm install 和 corepack pnpm build。
4. 安装 Skill：先确定 Codex home：如果设置了非空的 CODEX_HOME 就使用它，
   否则使用 ~/.codex（Windows 默认为 %USERPROFILE%\.codex）。把仓库里的
   skill/SKILL.md 复制到 /skills/codex-with-chatgpt/SKILL.md，
   并把文件中 "The codex-with-chatgpt checkout lives at:" 那一行的路径改成实际克隆路径。
5. 首次配置：按 SKILL.md 里的 first-time setup 流程执行
  （运行 c2c setup，用内置浏览器打开 ChatGPT 配置连接器并输入配对码）。
   全程只用内置浏览器，禁止打开任何第三方浏览器。
6. 只有遇到需要我登录（ChatGPT / Cloudflare）、验证码或两步验证时才叫我，
   而且一次只告诉我一个动作。
7. 完成后给我看 ✓ 清单，并确认文件读取测试通过。我不懂 MCP、OAuth、
   Tunnel、端口这些词，不要向我解释；出了问题先自己修。


更新：Skill 每天自动检查一次 GitHub，有新版本会自动更新并继续任务，
无需任何操作；也可以随时对 Codex 说"更新 Codex with ChatGPT"。

 安装 → 配置 → 使用（手动版）

设  为：如果 CODEX_HOME 已设置且非空，则使用 CODEX_HOME；
否则使用 ~/.codex（Windows 上默认为 %USERPROFILE%\.codex）。

1. 安装 Codex Skill：把 skill/ 复制到 /skills/codex-with-chatgpt/。
2. 对 Codex 说："使用 Codex with ChatGPT 完成首次配置。"
3. 之后正常使用："使用 Codex with ChatGPT，帮我实现 XXX。"

 安装范围： 本项目不会发布或安装 Codex 网页版 GPT、启动器或模型目录条目。
 安装内容是构建本仓库、把 skill/SKILL.md 安装为 Codex Skill，然后运行
 c2c setup 配置 ChatGPT 连接器。网页版 GPT 或模型目录的问题请先查看
 故障排查。

说明书到此结束。你不需要知道 MCP、OAuth、Tunnel、端口、localhost 是什么——
Codex 会自动完成所有配置，你只会看到：


Codex with ChatGPT

✓ 当前项目已识别
✓ Workspace Bridge 已启动
✓ 安全连接已建立
✓ ChatGPT 已连接
✓ 文件读取测试通过

Ready.


唯一可能需要你动手的步骤：登录 ChatGPT（如果要用固定域名，再登录一次 Cloudflare）。新仓库还会请你在 ChatGPT 里建一次项目（合集）：名字用仓库名，记忆选「仅限项目记忆」。侧栏如果没有「项目」，把鼠标放在「聊天」上，点右边三个点，选「按项目整理」。之后对话都从合集页开，不用回首页。已经在用的仓库默认还是原来的一条长对话，除非你说要改成 Project。

 可选的固定域名

默认公网地址是临时的，桥重启后会变。Codex 会删掉这个项目的 ChatGPT 插件再按新地址加回去。

如果你有 Cloudflare 账号，并且域名已经加在 Cloudflare 上，首次配置时（老用户则在下一次编码时问一次）会问你要不要用固定域名，例如 c2c-.你的域名。选是的话，浏览器里授权一次 Cloudflare 即可。之后重启一般不用再改插件。没有账号、不想用、登录失败：继续用临时地址，功能一样，只是修复更慢。

凭证放在系统目录，不进项目。

 工作原理


             ┌───────────────────────────┐
             │      ChatGPT 网页版       │
             │   推理 / 规划 / 审查      │
             └──────────┬──────────▲─────┘
                        │          │
               MCP      │          │ Computer Use
              数据面    │          │ 控制面（消息  --from  --to  安全导入。
导入过程限制在工作区内，会验证签名和大小、拒绝活动 SVG，并且绝不覆盖现有文件。

 安全模型（简版）

- 从构造上只读：服务端根本不存在写文件/删除/Shell/提交类工具，任何提示
  注入都无法启用它们。
- 一个工作区 = 一道边界：每个令牌绑定单一工作区；路径校验基于规范化
  realpath（symlink、../、绝对路径逃逸全部被拦截并有测试覆盖）。
- 敏感文件永不外泄：.env、密钥、SSH、各类凭据默认拒绝
  （.env.example 放行）；.c2cignore 可追加自定义规则。
- 知道 URL 不等于有权限：公网 MCP 端点强制 OAuth 2.1（PKCE S256、动态
  客户端注册、refresh token 轮

Top issues

Discussions

Latest release

Codex with ChatGPT v0.1.4

ChatGPT thinks. Codex works.

v0.1.4 is a correctness and docs update: execution records can name which agent ran an iteration; Quick Tunnel setup waits before the first health probe so fresh hostnames are not negatively cached; search truncation is reported accurately; Windows Named Tunnel credential gaps get clearer doctor diagnostics; ChatGPT can inspect workspace images safely; and install docs honor CODEX_HOME.

The core model remains unchanged: ChatGPT plans and reviews; Codex owns execution. No API key. No reverse proxy. No cookies or session extraction.

This