by Fanch-hui
ChatGPT的MCP 桥接工具，赋予网页版ChatGPT本地读写能力，并将ChatGPT连接至本机codex、agy、dsh、opencode，作为大脑调用本机agent。Connect ChatGPT to local projects and coding agents via MCP. Run Codex, OpenCode, DeepSeek Harness & Antigravity with approvals, live output and session control.
# Add to your Claude Code skills
git clone https://github.com/Fanch-hui/codex-bridgeLast scanned: 10/3/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-10-03T09:41:34.607Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how codex-bridge compares with popular alternatives.
codex-bridge is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Fanch-hui. ChatGPT的MCP 桥接工具，赋予网页版ChatGPT本地读写能力，并将ChatGPT连接至本机codex、agy、dsh、opencode，作为大脑调用本机agent。Connect ChatGPT to local projects and coding agents via MCP. Run Codex, OpenCode, DeepSeek Harness & Antigravity with approvals, live output and session control. It has 129 GitHub stars.
Yes. codex-bridge passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/Fanch-hui/codex-bridge" and add it to your Claude Code skills directory (see the Installation section above).
codex-bridge is primarily written in Swift. It is open-source under Fanch-hui on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh codex-bridge against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Published on the official MCP Registry.
Codex Bridge 是面向个人自托管场景的桌面 App 与后台服务，将 ChatGPT 网页版、OpenAI Dot、Qwen Studio 和本机工作台接入已授权的本地项目，并统一管理 Codex、OpenCode、DeepSeek Harness、Antigravity、Pi 与 Qoder 的任务、审批和会话。
macOS、Windows 与 Linux 共用 Swift 核心和桌面界面。项目权限、任务记录与配置保存在本机；调用 ChatGPT 或模型服务时，请求会发送给你选择的服务。
当前版本为 v1.3.6。
从 GitHub Releases 下载最新版本。
| 平台 | v1.3.6 安装包 | 安装方式 |
|---|---|---|
| macOS 14+，Apple Silicon | CodexBridge-1.3.6-macos-arm64.dmg |
打开 DMG，将 App 拖入 Applications |
| macOS 14+，Intel | CodexBridge-1.3.6-macos-x86_64.dmg |
打开 DMG，将 App 拖入 Applications |
| Windows x64 | CodexBridge-Windows-x64-1.3.6-Setup.exe |
运行安装器，选择安装位置 |
| Windows ARM64 | CodexBridge-Windows-arm64-1.3.6-Setup.exe |
运行安装器，选择安装位置 |
| Windows x64 / ARM64，便携运行 | codex-bridge-windows-x64.zip / codex-bridge-windows-arm64.zip |
完整解压后运行 codex-bridge-windows-app.exe |
| Ubuntu 24.04 LTS x64 | CodexBridge-Linux-x64-1.3.6.deb |
使用 APT 安装，详见 Linux 指南 |
| Ubuntu 24.04 LTS ARM64 | CodexBridge-Linux-arm64-1.3.6.deb |
使用 APT 安装，详见 Linux 指南 |
| Ubuntu 24.04 LTS x64 / ARM64，便携运行 | codex-bridge-linux-x64-1.3.6.tar.gz / codex-bridge-linux-arm64-1.3.6.tar.gz |
完整解压后运行 ./codex-bridge |
macOS 安装包使用 ad-hoc 签名，尚未经过 Apple 公证。若系统阻止打开，请在系统设置的“隐私与安全性”中允许此次打开。Windows 需要 WebView2 Runtime；App 会在运行环境缺失时给出提示。
升级时沿用现有应用数据和内置浏览器登录态。Windows 关闭主窗口后保留托盘，使用托盘菜单退出。
带内置更新功能的版本会在每次启动时后台检查 GitHub 更新，发现新版后在首页提示。点击“立即更新”即可下载并安装；有任务正在执行时，等待任务结束后安装并重新启动。每次更新完成后请在 ChatGPT 中刷新一次插件以清除旧版缓存（参见 配置指南）。Linux 的更新入口提供对应架构的 .deb 下载，下载后通过系统包管理器安装并重新启动 App。设置页可手动检查更新。旧版本需先手动安装一次带更新功能的版本。
以下页面为 macOS 实录，Windows 与 Linux 共用同一套产品界面。约 15 秒演示：ChatGPT 提交“你好” → 本机批准 → Codex 执行 → 工作台显示回复。
本机批准卡片显示待执行操作，点击“仅本次允许”后继续执行任务。
概览页集中显示后台服务、本地 MCP 通道、Secure Tunnel、Agent 引擎和最近任务状态。
Agent 模型设置页展示 Codex、Antigravity CLI 和 DeepSeek Harness 的模型、推理强度与权限。
OpenCode 的模型与权限设置，以及 Direct 工作区的命令模式、白名单和黑名单。
审批与 MCP 设置页展示 Direct 操作和远程任务启动策略，以及 GPT/Qwen 的 MCP 自定义指令。
如果只需要读写本地文件、运行命令，添加项目并配置权限后，配置好 Tunnel、添加并启用 Codex Bridge 插件即可，无需安装或连接 Agent。 这些操作由 Direct Workspace 执行，按项目权限、Direct 执行规则与审批设置处理。
需要让 Codex、OpenCode、DeepSeek Harness 等 Agent 执行任务时，再完成以下配置：
Read Only / Write，并设置该 Agent 的模型偏好。submit_task。任务输出、工具执行、审批和结构化提问在工作台显示。密钥通过系统凭据存储管理。分享配置、日志或截图前，请移除凭据。
Dot 可以直接通过 Codex Bridge 读写本地项目文件并运行命令，无需安装或连接 Agent，也无需启动 Work 或 Codex。 操作由本机 Bridge 服务的 Direct Workspace 能力执行，沿用项目权限、Direct 执行规则与审批设置。项目维护者实测文件读写可用，并认为 Dot 的插件使用体验更好。
完成 ChatGPT 插件连接后，确保 Codex Bridge 已在当前账号启用且连接有效，即可让 Dot 直接操作已授权的项目。Dot 沿用插件已有权限；参见 OpenAI 的插件接入说明。
| 模块 | 功能 |
|---|---|
| Codex | Thread/Turn、实时输出、审批、结构化提问、补充指令与中断；macOS 同时识别新版与旧版 App 内置 CLI 路径 |
| OpenCode | ACP 连接、模型与推理选项、权限回传、会话继续 |
| DeepSeek Harness | ACP 入口与能力探测、真实模型目录、搜索配置、MCP 服务配置与会话持久化 |
| Antigravity | CLI 接入、原生权限策略、执行过程与会话继续 |
| Pi | 原生 CLI 与会话接入、模型目录、MCP、Skills 与任务续写 |
| Qoder | CN/国际版原生 CLI 与 SDK 接入、地区隔离、权限模式、工具审批与会话续写 |
| 工作台 | 按 Agent 分组的项目会话、历史分页、工具卡片、审批、失败任务重试与跨 Agent 交接 |
| Direct Workspace | 受控文件读写、Patch、命令执行与 Git 操作 |
| Skills | 本机技能发现、只读查看与显式 Action 调用 |
可用能力由实际 Agent、连接探测和项目权限共同决定。远程请求省略 project_id 时使用工作台默认项目；省略 provider_id 时使用 Codex。
macOS、Windows 与 Linux 使用相同的任务并发规则：
| 范围 | 限制 |
|---|---|
| 同一个项目 | 最多 1 个活跃写入任务，所有 Agent 共用该名额 |
| 不同项目 | 可以同时执行写入任务，仍受对应 Agent 的并发限制 |
| Codex | 最多 4 个并发执行会话，只读与写入合计 |
| 外部 Agent | Bridge 未设置统一的总并发上限；受项目写入名额、Provider 自身限制和本机资源约束 |
待本机批准、启动中、运行中、等待权限批准及状态未知的写入任务都会占用项目写入名额。达到限制时，新任务会被拒绝或启动失败，需要在名额释放后重试；不会自动排队。任务历史记录数量不计入执行并发限制。
ChatGPT Web ── Secure MCP Tunnel ─┐
Qwen Studio ── localhost MCP ────┼─► Codex Bridge Service
Desktop App ── local IPC ────────┘ ├─ 项目权限与审批
├─ 任务、会话与 SQLite
├─ Codex / OpenCode / DSH / AGY / Pi / Qoder
└─ Direct Workspace / Skills
macOS 使用 WKWebView 和 XPC；Windows 使用 WebView2 和命名管道；Linux 使用 GTK 3 / WebKitGTK 4.1 和 Unix domain socket。三平台共用 BridgeDesktopUI 与 BridgeServiceAppCore，Windows 与 Linux 还共用 BridgeDesktopShell 的桌面状态和命令适配。活动会话通过独立订阅接收实时输出。
默认开发主线为 win。
git clone --branch win https://github.com/Fanch-hui/codex-bridge.git
cd codex-bridge
需要 Xcode 与可编译项目的 Swift 工具链。
Scripts/with-xcode.sh xcodebuild \
-project CodexBridge.xcodeproj -scheme CodexBridge \
-configuration Debug -destination 'platform=macOS,arch=arm64' \
-derivedDataPath .build/Xcode build CODE_SIGNING_ALLOWED=NO
普通源码构建可使用本地 MCP。ChatGPT Secure Tunnel 还需要经过摘要校验的 tunnel-client；正式安装包已包含该组件。
Intel Mac 构建将 arch=arm64 替换为 arch=x86_64。发布脚本的架构参数同样支持 arm64 与 x86_64。
需要 Swift 6.3.3、Visual Studio C++ 工具链、Windows SDK、vcpkg SQLite，以及生成安装器所需的 Inno Setup 7.1.0。
pwsh -File Scripts/build-windows.ps1 `
-VcpkgRoot 'D:\Dev\Tools\vcpkg' `
-Installer -ISCCPath 'C:\Program Files (x86)\Inno Setup 7\ISCC.exe'
构建脚本默认使用本机架构，也可通过 -Architecture x64 或 -Architecture arm64 指定目标。SQLite 的 vcpkg triplet 需分别使用 x64-windows 或 arm64-windows。
构建脚本使用 swiftbuild，输出 portable ZIP 和 EXE 安装器到 .build。
Linux 桌面版使用 GTK 3 与 WebKitGTK，共用工作台与项目管理界面，提供 .deb 和便携包。系统依赖、构建命令与数据目录见 Linux 指南。
感谢 LINUX DO 社区。