What it does
ChatGPT thinks. Codex works. Use ChatGPT as the planning brain while keeping the Codex harness.
- Connects Instruction files the AI reads; connects to nothing
- Account or key No key needed
- Category 自動化とエージェント
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/skills/xiaoduoya-codex-with-chatgpt)似た Skill
同じ種類の作業。Skill 一覧と同じ並び
XiaoDuoYa による 1 個の Skill(指示セット)。AI が読んでそのとおりに作業します · MCP server ではありません
Skill と MCP の違い
MCP = 手
AI を外部のサービスやデータにつなぎます(例:Notion を読む、請求書を作る)。プログラムやサーバーが動いている必要があります。
Skill = 手順書
作業のやり方を AI に教えるテキストファイル。どのサービスにもつながりません。
重なる部分もあります。ツールを呼ぶスクリプト付きの Skill や、知識だけを渡す MCP もあります。やりたい作業から選んでください。
使えるアプリ
Codex
提供元の README と repo のフォルダから判断
インストール
Is it safe?
- Who made it
GitHub account XiaoDuoYa (person), 4 years old
- Use and upkeep
★ 7,718 stars · code last changed 2026年10月1日
- Any scripts?
No, plain text files the AI reads and follows
- Uses the internet?
No scripts, so it does not go online by itself
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 535a07d (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
まず:どの AI を使っていますか
使っているアプリを選ぶと、そのアプリでのインストール方法だけが表示されます
Option 1Upload to claude.ai (web and app)
Uploading to claude.ai would fail: the description is over 200 characters (343). Use "Let the AI install it" instead
Option 1Claude Code にインストールしてもらう
この文をコピーして Claude Code のチャットに貼り付けます
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Claude Code を開き直し、/skill と入力するか関連する作業を頼むと Claude が自動で使います
Checked against official docs 2026年11月12日 · Source: code.claude.com
For Terminal users
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
skill フォルダを ~/.claude/skills にコピー
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
git clone --depth 1 https://github.com/xiaoduoya/codex-with-chatgpt.git /tmp/popnx-skill-xiaoduoya-codex-with-chatgpt-535a07d && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-xiaoduoya-codex-with-chatgpt-535a07d/skill' ~/.claude/skills/skillClaude Code を開き直し、/skill と入力するか関連する作業を頼むと Claude が自動で使います
ChatGPT デスクトップアプリ
ChatGPT デスクトップアプリには Codex が組み込まれていて、Codex は ~/.agents/skills フォルダから Skill を読み込みます
Option 1ChatGPT にインストールしてもらう
ChatGPT デスクトップアプリで Codex を開き、この文をチャットに貼り付けます
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2自分でフォルダを置く
codex-with-chatgpt フォルダを ~/.agents/skills/codex-with-chatgpt に置きます
~ はホームフォルダ($HOME)です
For Terminal users
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
skill フォルダを ~/.agents/skills にコピー
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
git clone --depth 1 https://github.com/xiaoduoya/codex-with-chatgpt.git /tmp/popnx-skill-xiaoduoya-codex-with-chatgpt-535a07d && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-xiaoduoya-codex-with-chatgpt-535a07d/skill' ~/.agents/skills/skill
インストールしたあと
- ChatGPT デスクトップアプリ:サイドバーの Skills を開いて Skill があるか確認します
- 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
- Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
Web 版とモバイル版の ChatGPT
自分でインストールした Skill は使えません。ディレクトリのプラグインに含まれる Skill だけが使えます
この Skill を ChatGPT で使うには、上の方法で ChatGPT デスクトップアプリを使ってください
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
Option 1Codex にインストールしてもらう
この文をコピーして Codex のチャットに貼り付けます · ChatGPT デスクトップアプリ内の Codex、Codex CLI、IDE 拡張機能で使えます
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください · 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
For Terminal users
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
skill フォルダを ~/.agents/skills にコピー
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
git clone --depth 1 https://github.com/xiaoduoya/codex-with-chatgpt.git /tmp/popnx-skill-xiaoduoya-codex-with-chatgpt-535a07d && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-xiaoduoya-codex-with-chatgpt-535a07d/skill' ~/.agents/skills/skillCodex を開き直して関連する作業を頼むと、Codex が skill を一覧に出します
Option 1Cursor にインストールしてもらう
この文をコピーして Cursor のチャットに貼り付けます
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Cursor の Agent チャットで / を入力し skill を選ぶ
Checked against official docs 2026年11月12日 · Source: cursor.com
For Terminal users
Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください
skill フォルダを ~/.cursor/skills にコピー
repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします
git clone --depth 1 https://github.com/xiaoduoya/codex-with-chatgpt.git /tmp/popnx-skill-xiaoduoya-codex-with-chatgpt-535a07d && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-xiaoduoya-codex-with-chatgpt-535a07d/skill' ~/.cursor/skills/skillCursor の Agent チャットで / を入力し skill を選ぶ
Option 1Let the AI install it
Skill を読めるほかのアプリ向けです。この文には Claude Code、Codex、Cursor のパスが入っていて、AI が使っているアプリに合わせて選びます · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Gemini CLI や GitHub Copilot など Agent Skills 対応の他のアプリはフォルダが違います。そのアプリのガイドを見て、SKILL.md のあるフォルダをコピーしてください。
2026年11月11日 に Claude Code、Codex、Cursor の公式ガイドで skill フォルダを確認
✓ コマンド確認済み 2026年11月16日
元の SKILL.md を見る
以下は提供元の repo の文章で、PopNx MCP の指示ではありません
最初の 8,000 文字を表示 · GitHub で全文を開く
---
name: codex-with-chatgpt
description: >
Use ChatGPT (web) as the planning and review brain for Codex coding sessions,
while Codex keeps full execution ownership. Use when the user says
"使用 Codex with ChatGPT ..." / "Set up Codex with ChatGPT" / "用 ChatGPT 规划",
when they ask to connect ChatGPT to the current workspace, disconnect it,
or run a task through the ChatGPT planning loop.
---
# Codex with ChatGPT
ChatGPT thinks. Codex works.
You (Codex) own execution: editing, shell, git, tests, recovery.
ChatGPT owns high-level reasoning: understanding, planning, review, debug strategy.
The C2C Bridge gives ChatGPT read-only MCP access to the current workspace, so
control messages between you and ChatGPT stay tiny (< 1 KB) — ChatGPT pulls
whatever data it needs by itself.
**Golden rules**
1. NEVER paste file contents, diffs, or logs into ChatGPT. ChatGPT reads them through MCP.
2. NEVER show the user technical internals (MCP, OAuth, PKCE, tunnel, ports, localhost).
Speak in terms of "连接 ChatGPT / 安全连接 / 配对". The only exception is the
**guided manual ChatGPT setup** below: expose only the exact settings
field labels/values the user must enter, without explaining internals.
3. The pairing code is the ONLY credential you may ever type into a browser.
Never touch OAuth tokens, cookies, or session storage.
4. If something fails, run `c2c doctor` and repair silently. Only involve the user
for logins, CAPTCHA, 2FA, explicit consent screens, or **guided manual
ChatGPT setup** below — and then give them ONE action.
Before the first ChatGPT connection on this machine, `c2c prefs --json`:
- `setupMode` missing: tell the user exactly `setupChoicePrompt`, wait for
「1」or「2」, then `c2c prefs set --setup-mode auto|manual --json`.
Do not start ChatGPT configuration until they answer. Do not guess.
- `setupMode` is `manual`: skip automatic ChatGPT settings. Use guided
manual from the start (chosen, not a failure).
- `setupMode` is `auto`: automatic browser setup. Two explicit failures of
the same configuration step after repair then enter guided manual.
A browser/js timeout, a page still loading/generating, or waiting for
user login/2FA does NOT count as a failure. Do not change the saved
`setupMode` when falling back.
`developerModeEnabled: true` means skip `#settings/Security` until a
connector create fails because developer mode is required. Then open
that page, enable it, and `c2c prefs set --developer-mode --json`.
These prefs are for this machine, not per workspace. Do not ask again
on reconnect or a second repo. A new computer (empty prefs) asks/checks
once.
5. ALWAYS use the built-in in-app browser (iab) for every ChatGPT step.
Follow **In-app browser (ChatGPT)** below. NEVER Computer Use (no
screenshot-click). NEVER launch or control a third-party/external browser
(Chrome, Safari, Edge…), and never use `open <url>` to hand off to one.
- The ONLY exception: the user explicitly says the Cloudflare login must use
their own browser session — that single Cloudflare login step may go through
their browser; everything else stays in the built-in browser.
- If the user asks to run ChatGPT in their own browser, refuse politely and
explain: "Codex 需要持续调用 ChatGPT 和配置连接,这会频繁操作页面,可能影响
你浏览器的正常使用。ChatGPT 只能跑在内置浏览器里。" Only if the user replies
with an explicit "我愿意承担影响" may you proceed in their browser; otherwise
keep ChatGPT in the built-in browser, every time they ask.
6. Conversation reuse depends on `c2c session --json` → `conversation.mode`
(see Conversation management). Do not invent a second mode.
- **long-chat** (legacy session file, or the user opted out): ONE ChatGPT
conversation per workspace. Never silently start a new chat.
- **project** (new workspaces, or an existing workspace that opted in):
ONE ChatGPT Project (collection) per workspace. Same Codex conversation
reuses the ChatGPT chat URL saved in THIS thread. A new Codex
conversation opens a new chat from the Project collection page — never
`goto` `https://chatgpt.com/` to create it, and never reuse another
Codex conversation's chat URL just because `session.url` exists.
Each workspace also has exactly ONE ChatGPT connector. Do not create a
second connector for the same workspace. Other workspaces may have their
own connectors — never edit those.
7. After first-time setup, never ask the user to approve writing C2C's local
settings directory. Run `c2c sandbox-allow --json` (idempotent). If it fails
with EPERM / Operation not permitted, request elevated permissions and retry
ONCE. After `{ "alreadyAllowed": true }` or `{ "added": true }`, stay silent.
8. ChatGPT pages: only the URLs in **In-app browser (ChatGPT)**. Never start
from chatgpt.com and click through menus.
9. **Doctor gate.** After `c2c doctor --json`, do not `goto` ChatGPT and do not
send `[C2C]` until local is green — except the reconnect settings pages when
`chatgptRepair.needed` is true. Not green:
- `report.bridge.ok` is not true
- `report.mcp.ok` is not true (unauthenticated local `/mcp` must be 401)
- sandbox / state-dir write failed (EPERM)
- this workspace used to have a public URL and the tunnel is down
- `chatgptRepair.needed` is true (fix the connector first, then doctor again)
- `namedRepair.needed` is true (user must log in to Cloudflare, then doctor again.
Do not Delete the ChatGPT connector — the address did not change)
- `report.bridge` says 状态无法确认: the local bridge may still be running.
Do not `c2c start`, do not Delete the connector, do not treat it as
`chatgptRepair`. Wait and run doctor again.
If doctor is already green and `chatgptRepair.needed` is false, do not
`c2c restart`, do not start a second tunnel, and do not Delete the
connector. ChatGPT/IAB-only errors are not permission to churn the
public address.
A ChatGPT-side 401 after a sent message is different: repair then, do not
treat it as permission to skip this gate next time.
## In-app browser (ChatGPT)
Official skill: `control-in-app-browser`. These C2C rules override defaults
that close the tab, hide the window, or stall on the settings page.
1. **Surface.** Once per Codex session: `setupBrowserRuntime()`, then
`const iab = await agent.browsers.get("iab")`. Reuse `iab`. Do not re-read
`documentation()` if it is already bound. Never `getDefault()`, `getForUrl()`,
or Computer Use.
2. **One tab.** Create the ChatGPT tab once (`tabs.new()`). After that, only
`tab.goto(...)` to switch URLs. If the tab still exists, claim it — never
open a second ChatGPT tab. Do not `goto` the URL you are already on.
3. **Foreground + keep (standby).** Right after opening or claiming the tab:
- `await (await iab.capabilities.get("visibility")).set(true)` — first-time
setup and ChatGPT chatting stay in front of the user so they can watch.
- `await tab.markHandoff()` immediately, then again at the start and end of
every turn. After setup succeeds or the C2C chat is open, also
`await tab.markDeliverable()`.
Never close this tab. Finished, waiting for the user, or timed out: leave it
marked (standby). Do not let default turn cleanup close it.
4. **URLs only** (same tab, `goto` — never hunt menus):
- 开发人员模式: `https://chatgpt.com/#settings/Security`
(skip when `c2c prefs --json` has `developerModeEnabled: true`)
- 插件总管: `https://chatgpt.com/plugins`
- 加插件: `https://chatgpt.com/plugins#settings/Connectors?create-connector=true&redirectAfter=%2Fplugins`
- 新对话 (long-chat only, and only if no saved chat): `https://chatgpt.com/`
- Saved C2C chat: `conversation.chatUrl` / `session.url` (long-chat, or
the chat already bound in THIS Codex conversation)
- Saved Project collection: `conversation.projectUrl`
(`https://chatgpt.com/g/g-p-…/project`)
Never click Reconnect話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
GitHub の情報
- GitHub スター
- 7,718
- 提供元
- XiaoDuoYa
- ライセンス
- MIT
- 最終コード更新
- 2026年10月1日
- repo 内の SKILL.md(翻訳版とテンプレートを含む)
- 1
- トピック
- ai-agents, chatgpt, codex, mcp, model-context-protocol, oauth