Guide · Agent skill

How to use the Codex with ChatGPT agent skill: setup and examples

Updated 2026-11-02 · written with AI from the project's own documentation and checked against our catalogue data

The codex-with-chatgpt skill sets up a working loop in which ChatGPT (the web version) handles planning, review and debugging strategy, while Codex keeps the hands-on work: editing files, running commands, git and tests. This guide is for developers who already use Codex and have a ChatGPT account. By the end you will know what the skill does, how to install it, how to trigger it, and what it needs and touches on your machine.

Codex with ChatGPTXiaoDuoYa/codex-with-chatgpt · MIT Download the skill

Quick start

1Download and unzip the skill. Download the ZIP from this skill's page and unzip it to get SKILL.md.
2Place the skill folder. Put it in ~/.claude/skills/ for all projects, or in .claude/skills/ inside one project.
3Ask the agent to set up ChatGPT. Use a plain request such as Set up Codex with ChatGPT for this workspace.
4Choose a setup mode. When asked, pick 1 for automatic browser setup or 2 for guided manual setup.
5Complete logins and pairing. Log in to ChatGPT or Cloudflare in the built-in browser if prompted, and enter the pairing code when asked.
6Run a planning task. Ask for a task and say you want ChatGPT to plan or review it.

What does the codex-with-chatgpt skill make the agent do?

The skill splits the work between two models. ChatGPT owns high-level reasoning: understanding the task, planning, reviewing and choosing debug strategy. Codex owns execution: editing, shell commands, git, tests and recovery.

The skill connects ChatGPT to the current project through the C2C Bridge, so ChatGPT can read the workspace itself. You do not have to paste code, diffs or logs into the chat window. The skill also walks you through connecting ChatGPT, including a pairing code step and an optional guided manual setup.

ChatGPT (web) acts as planner and reviewer.
Codex edits files, runs commands, uses git and runs tests.
The C2C Bridge gives ChatGPT read-only access to the current workspace.

Install the skill from the ZIP or the Claude apps

Download the ZIP from this skill's page and unzip it. The package contains a single file, SKILL.md. Place the unzipped skill folder in one of these locations: ~/.claude/skills/ for all your projects, or .claude/skills/ inside a specific project if you want it only there.

If you use the Claude apps instead, upload the skill under Settings → Capabilities → Skills.

Personal install: ~/.claude/skills/
Project install: .claude/skills/ in the project folder
Claude apps: Settings → Capabilities → Skills, then upload

Connect ChatGPT to your project

Ask the agent in plain language to set up the connection. On the first run on a machine, the skill checks its preferences and asks you to choose a setup mode. Option 1 is automatic browser setup. Option 2 is guided manual setup, where the skill shows you the exact settings field labels and values to enter. Each workspace gets one ChatGPT connector.

The skill uses the built-in in-app browser for every ChatGPT step. It does not use Computer Use or your everyday browser. You may be asked to log in to ChatGPT, complete a CAPTCHA or two-factor check, or log in to Cloudflare for the tunnel step. These are the only points where you are asked to act.

Choose setup mode 1 (automatic) or 2 (guided manual) when prompted.
Log in to ChatGPT in the built-in browser if asked.
Complete the Cloudflare login if the tunnel step needs it.
Enter the pairing code only when the skill asks for it.

Trigger the skill with natural requests

You do not need a special command. The skill responds to requests such as setting up Codex with ChatGPT, connecting ChatGPT to the current workspace, disconnecting it, or running a task through the ChatGPT planning loop. Requests can be in English or Chinese; the skill's own trigger phrases include both.

Once connected, ask for a task in normal words and say you want ChatGPT to plan or review it.

"Set up Codex with ChatGPT for this repo."
"Connect ChatGPT to the current workspace."
"Use the ChatGPT planning loop to fix the failing login tests."
"Disconnect ChatGPT from this workspace."

Examples of useful tasks

The skill suits tasks where a second model's review helps. Codex still does the edits and tests, and ChatGPT reads the project directly rather than receiving pasted code.

Plan a refactor, then have ChatGPT review the plan before Codex edits files.
Ask ChatGPT to debug a failing test by reading the workspace, while Codex runs the tests.
Have ChatGPT review a set of changes Codex has made before you commit.

What you need and what the skill touches

You need Codex or a compatible agent runtime with the built-in in-app browser, a ChatGPT web account, the C2C Bridge command-line tool (c2c), and a Cloudflare login for the tunnel step. The skill runs scripts and uses the network.

Setup creates a public connection to your local project. Do not use the skill if you do not want your workspace exposed to ChatGPT. The skill also refuses by default to run ChatGPT in your own everyday browser, because it drives the page heavily and can interfere with normal browsing. You can override this only by explicitly accepting that impact.

Runs scripts: yes. Uses network: yes.
Public connection: setup exposes the local project to ChatGPT through a tunnel.
Browser: ChatGPT runs only in the built-in in-app browser by default.
Local C2C tool commands the skill uses include doctor, prefs, session, sandbox-allow, start and restart.

c2c doctor --json

What people use it for

Getting a second model to review a plan before Codex edits a large codebase.
Letting ChatGPT read a project directly for debugging without pasting logs into chat.
Reviewing changes Codex has made before committing them with git.
Running a guided manual ChatGPT connection when automatic browser setup does not work on your machine.

Frequently asked questions

How do I install the codex-with-chatgpt skill?

Download the ZIP from the skill page and unzip it. Put the folder in ~/.claude/skills/ for all projects or in .claude/skills/ inside one project. In the Claude apps, you can instead upload it under Settings → Capabilities → Skills.

Is the codex-with-chatgpt skill free?

The skill is published under the MIT licence. This page does not state any price, and you still need your own ChatGPT account and a Cloudflare login for the tunnel step.

What do I need before I can use it?

You need Codex or a compatible agent runtime with the built-in in-app browser, a ChatGPT web account, the C2C Bridge command-line tool (c2c), and a Cloudflare login for the tunnel step.

Does the skill expose my code to ChatGPT?

Setup creates a public connection to your local project so ChatGPT can read the workspace through the bridge. If you do not want your workspace exposed to ChatGPT, do not use this skill.

Why does the skill open ChatGPT in the built-in browser instead of mine?

By default it refuses to run ChatGPT in your everyday browser because it drives the page heavily and can interfere with normal browsing. ChatGPT runs only in the built-in in-app browser unless you explicitly accept that impact.

What should I do if the connection fails?

The skill runs c2c doctor and tries to repair the problem on its own. You are only asked to act for logins, CAPTCHA, two-factor checks, consent screens, or the guided manual setup, where you get one action at a time.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

This skill suits developers who already use Codex, have a ChatGPT account, and want a second model to review plans while letting ChatGPT read the project directly. It is not a good fit if you do not want your workspace exposed through a public connection, or if you lack a ChatGPT account. In those cases, keep using Codex alone or paste only the parts of code you choose into a chat.

Download the skill