[!IMPORTANT]
遇到问题？ 请先向 Codex 发送 「更新 Codex with ChatGPT」 并重试。更新到最新版本可以解决大多数已知问题。 Having trouble? First ask Codex to “Update Codex with ChatGPT” and try again. Updating to the latest version resolves most known issues.
The problem · 解决什么问题
中文 — ChatGPT 付费订阅的网页版额度大量闲置，Codex 却在消耗紧张的
API 额度做规划和 Review。本项目把"思考"交给你已付费的网页版 ChatGPT，
Codex 只负责执行。不用 API Key、不搞逆向代理——官方网页 + 只读 MCP 桥接。
EN — ChatGPT Plus/Pro web quota sits idle while your coding agent burns
scarce API/Codex tokens on planning and review. This project moves the
thinking to the subscription you already pay for; Codex only executes.
No API keys, no reverse proxy — official web UI plus a read-only MCP bridge.
EN — Use the ChatGPT web app as the planning and review brain for your
Codex coding sessions, while Codex keeps full ownership of execution. Your
repository is never uploaded: ChatGPT reads exactly the lines it needs through
a secure, OAuth-protected, read-only MCP connection to your current
workspace.
Detailed docs below are in English · 详细中文文档见 README.zh-CN.md
EN — Don't know git, Node, or terminals? You don't need to. Copy the
paragraph below, paste it to your coding agent (Codex), and go grab a coffee:
Please install and configure "Codex with ChatGPT" for me, fully automatically.
I am a non-technical user — do everything yourself:
1. Check the environment: git and Node.js >= 20 must be available. Install
anything missing yourself (macOS: Homebrew, Windows: winget). Also install
cloudflared.
2. Download: clone https://github.com/XiaoDuoYa/codex-with-chatgpt into
~/codex-with-chatgpt (if it already exists, git pull to update).
3. Build: inside that folder run `corepack pnpm install` then `corepack pnpm build`.
4. Install the Skill: copy skill/SKILL.md to
~/.codex/skills/codex-with-chatgpt/SKILL.md, and update the line
"The codex-with-chatgpt checkout lives at:" to the actual clone path.
5. First-time setup: follow the SKILL.md "first-time setup" workflow
(run c2c setup, configure the ChatGPT connector in the BUILT-IN browser,
enter the pairing code). Never open a third-party browser.
6. Only interrupt me for logins (ChatGPT / Cloudflare), CAPTCHAs or 2FA —
and give me exactly ONE action at a time.
7. When done, show me the ✓ checklist and confirm the file-read test passed.
I don't know what MCP, OAuth, tunnels or ports are. Don't explain them.
If anything breaks, fix it yourself first.
Updates · 更新 — The Skill checks GitHub once a day and updates itself when a
new version is released; no action needed. You can also say "更新 Codex with ChatGPT"
anytime. / Skill 每天自动检查一次 GitHub，有新版本会自动更新，无需任何操作；
也可以随时对 Codex 说"更新 Codex with ChatGPT"。
The sections below are in English. 以下详细内容为英文，中文完整版见
README.zh-CN.md。
Install → Setup → Use (manual)
Install the Codex Skill: copy skill/ to ~/.codex/skills/codex-with-chatgpt/.
Tell Codex: "Set up Codex with ChatGPT." (中文: "使用 Codex with ChatGPT 完成首次配置。")
Use Codex normally: "Use Codex with ChatGPT to implement XXX."
That's the whole manual. You don't need to know what MCP, OAuth, tunnels,
ports or localhost are — Codex configures everything automatically and you
just see:
Codex with ChatGPT
✓ Project detected
✓ Workspace Bridge started
✓ Secure connection established
✓ ChatGPT connected
✓ File read test passed
Ready.
The only steps that may need you: logging into ChatGPT (and, if you want a
stable hostname, logging into Cloudflare once). A new workspace also asks
you to create a ChatGPT Project (collection) once — pick project-only
memory, name it after the workspace. If the sidebar has no Projects row,
hover Chats, open the … menu, and choose Organize by project. Codex
then saves that collection link and starts chats from that page. Existing
workspaces that already have a C2C chat stay on the old one-conversation
style until you ask to switch.
Optional stable hostname
The default public address is a temporary Cloudflare URL. It changes when the
bridge restarts, and Codex repairs ChatGPT by deleting that workspace's
connector and adding it again.
If you have a Cloudflare account and a domain already on Cloudflare, first-time
setup (and the next coding session, once) will ask whether you want a stable
hostname such as c2c-<project>.your-domain.com. That path opens a browser so
you can authorize Cloudflare. After that, the ChatGPT connector keeps working
across restarts. If you skip it, or the login fails, Codex stays on the temporary
address — same features, just a slower repair.
Credentials stay in the OS app state directory, not in the project.
Control plane (Computer Use): Codex and ChatGPT exchange tiny structured
[C2C] state messages — INIT → PLAN → EXECUTED → REVIEW → DONE. No diffs,
no logs, no file bodies are ever pasted.
Data plane (MCP): ChatGPT pulls what it needs itself through 9 read-only
tools: workspace_info, list_directory, read_file, search_workspace,
git_status, git_diff, test_status, execution_summary,
execution_output.
Independent review: after Codex executes, ChatGPT inspects the actual
git diff and test records through MCP — it never trusts "all tests passed"
claims blindly.
Security model (short version)
Read-only by construction: write/delete/shell/commit tools simply do not
exist on the server. No prompt injection can enable them.
One workspace = one boundary: every token is bound to a single workspace;
path containment uses canonical realpaths (symlink/..//absolute-path escapes
are all blocked and tested).
Sensitive files never leave: .env*, keys, SSH, credentials are denied by
default (.env.example allowed); .c2cignore adds your own rules.
Knowing the URL grants nothing: the public MCP endpoint requires OAuth 2.1
(PKCE S256, dynamic client registration, rotating refresh tokens). Without a
token: 401. Wrong workspace: 403.
The model never sees long-lived credentials: the only secret that ever
touches a browser is a one-time pairing code (5-minute TTL, 5 attempts,
rate-limited, destroyed on use).
怎样安装和设置？将 skill/ 文件夹复制到 ~/.codex/skills/codex-with-chatgpt/，然后对 Codex 说 'Set up Codex with ChatGPT.'。之后你照常使用 Codex 即可，例如 'Use Codex with ChatGPT to implement XXX.'
这是一个 Codex Skill，它把 ChatGPT 网页版（你的 Plus/Pro 订阅）变成 Codex 编码会话中的规划和审查大脑，而执行环节仍完全由 Codex 掌控。