面向 ChatGPT Plus / Pro 的开源 MCP 桥Cloudflare quick tunnel
不需要域名设置，适合 demo。每次重启 URL 都变，因此每次都要更新 ChatGPT App 的 Server URL。
codexpro start面向 ChatGPT Plus / Pro 的开源 MCP 桥
ChatGPT plus 本地仓库工具
把 ChatGPT 变成本地代码代理。
CodexPro 把 ChatGPT Developer Mode 连接到你机器上的仓库。一个 setup 命令之后，ChatGPT 可以读取文件、搜索代码、精确编辑、查看 git 状态和 diff、运行安全检查，并读取 Codex 风格上下文。它不绕过限制，也不提供模型。
AGENTS.md 上下文
.ai-bridge handoff
ngrok / Cloudflare 稳定 URL
npm install -g codexpro
codexpro setup
ChatGPT
“打开当前仓库，读取 Codex 上下文，修复失败测试，然后给我看 diff。”
CodexPro tools
codex_context
AGENTS.md + .ai-bridge + git 状态
edit
工作区内精确替换
bash
安全运行 npm test / lint / build
README.md加入中文文档入口
src/http.tstoken auth checked
.ai-bridge/current-plan.mdhandoff ready
日常命令
codexpro start
用 ngrok 或 Cloudflare named tunnel 保持同一个 ChatGPT URL。
01
Start
全局安装一次，在目标仓库里运行 setup。
02
Paste
复制好的 Server URL 已包含私有 token。
03
Build
ChatGPT 获得本地仓库工具和显式上下文。
用好已有订阅
把 ChatGPT 变成本地开发工作流的一部分。
CodexPro 面向已经使用 ChatGPT Plus 或 Pro 的开发者。它让 ChatGPT 不再只是回答问题，而是通过 MCP 获取本地仓库工具：读取文件、精确编辑、搜索源码、查看 git 状态、查看 diff，并运行允许范围内的验证命令。
Codex 和 ChatGPT 是不同产品界面。某个工作流暂时不可用时，如果另一个你本来就有权限的界面仍然可用，CodexPro 可以让它继续在同一个本地仓库上工作，但不会修改任何产品限制。
如果你的 ChatGPT 账号在 Web 产品里提供 GPT-5.5 或更强模型，并且该模型界面可以调用 Developer Mode Apps，CodexPro 可以让它通过 MCP 使用本地仓库工具。CodexPro 不提供、不代理、不转售、也不解锁模型。
ChatGPT 可以看到
AGENTS.md、.ai-bridge、git 状态、源码文件和显式 Codex 风格上下文
默认编码模式可以
读取、写入、编辑、搜索，并在工作区内运行安全验证
Pro 上下文回退可以
给不能调用 MCP 工具的模型导出持久上下文包
账号要求
ChatGPT Plus 或 Pro，并且有 Apps / Developer Mode。当前测试中 Free / Go 不支持这个 app 流程。
快速开始
全局安装，然后在仓库中运行 setup。
默认路径使用 normal coding 模式、workspace 写入、安全 bash 和你选择的 tunnel。setup 保存配置后，日常启动只需要 codexpro start。
1
全局安装
npm install -g codexpro
2
进入目标仓库
cd /path/to/your/repo
codexpro setup
3
以后日常启动
codexpro start
ChatGPT 设置路径
Settings
-> Apps
-> Advanced settings
-> Developer mode: on
-> Enforce CSP in developer mode: on
-> Create app
Create App 字段
Name: CodexPro
Connection: Server URL
Server URL: paste copied URL
Authentication: No Authentication / NoneChatGPT App 设置
把 CodexPro 复制的 URL 粘贴到 Create app。
保持 Enforce CSP in developer mode 开启。CodexPro 的小组件按 CSP 开启路径设计，不依赖远程脚本、外部字体、iframe 或第三方图片。
复制的 Server URL 已包含私有 CodexPro token。Authentication 选择 No Authentication / None，不需要单独粘贴 token。
URL 选择
根据使用场景选择 tunnel。
quick tunnel 适合演示，稳定 URL 适合每天使用。
ngrok free dev domain
推荐给大多数用户。免费 ngrok 账号会给一个 dev domain，保存一次后每天可以复用同一个 ChatGPT App URL。
ngrok config add-authtoken YOUR_TOKEN
codexpro settings set --tunnel ngrok --hostname your-name.ngrok-free.dev
codexpro startCloudflare named tunnel
适合已有域名的用户。把 DNS 路由到 codexpro.example.com 这样的 hostname，之后 URL 保持不变。
codexpro stable --hostname codexpro.example.com --tunnel-name codexpro工作模式
根据任务风险选择控制级别。
Normal coding
默认模式。ChatGPT 可以在工作区内读取、写入、编辑、搜索并验证。
Handoff
规划模式。ChatGPT 写 .ai-bridge/current-plan.md，本地代理执行。
Pro context
给不能调用连接器或 MCP 工具的模型导出持久上下文包。
工具清单
ChatGPT 通过 MCP 获取的本地动作。
Standard tools
默认精简的仓库读取、编辑、验证和 handoff。
server_config
open_current_workspace
open_workspace
tree
search
read
write
edit
bash
show_changes
read_handoff
export_pro_context
handoff_to_agent
敏感路径默认阻止
.env、私钥、.git、node_modules、生成目录、缓存目录、工作区外路径和 symlink 逃逸会被拒绝。
验证而不是任意 shell
safe 模式允许常见检查、git、test、lint、typecheck 和 build 命令。只在信任的本地仓库里使用 full bash。
只给关键动作卡片
open workspace 摘要、write/edit diff、show_changes 审查和 handoff 导出会显示紧凑卡片。skills、git 和 tree 详情默认折叠；load_skill 按需加载有限长度的说明，bash 保持纯数据。
用文件保持连续性
把项目规则写进 AGENTS.md，把计划和决策写进 .ai-bridge，让 ChatGPT 换会话后也能恢复上下文。
FAQ
安装前最常见的问题。
需要 Plus / Pro 吗？
需要 ChatGPT Plus 或 Pro，并且账号能访问 Apps / Developer Mode。当前测试中 Free / Go 不支持这个 app 创建流程。
这会绕过限制吗？
不会。CodexPro 不绕过、不提升、不合并、不转售、不修改任何 ChatGPT、Codex、OpenAI 或第三方模型限制。
Pro 模型一定能调用工具吗？
不一定。账号权限和模型工具能力是两回事。某些规划模型界面不能调用连接器或 MCP 工具，此时用 codexpro pro-bundle --copy。
ChatGPT 能看到 Codex 上下文吗？
能看到显式文件：AGENTS.md、.ai-bridge、git status、git diff 和指定源码文件。它不能读取隐藏的 Codex 运行时记忆。
如何避免每次改 URL？
不要用 quick tunnel 做日常使用。用 ngrok free dev domain 或 Cloudflare named tunnel 保存稳定 hostname。
如何停止？
终端按 q 或 Ctrl+C。quick URL 会失效。稳定 hostname 仍然保留，下一次 codexpro start 可复用。
安全边界
这是本地开发桥，不是操作系统级沙箱。
- 公网 tunnel 默认使用 token 保护。
.env、私钥、.git、node_modules和 symlink 逃逸默认阻止。- safe bash 用于常见检查和测试，不是任意 shell 控制。
- 只想让 ChatGPT 做计划时，用 handoff 模式。