Codex Bridge

简体中文 · English

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 或模型服务时，请求会发送给你选择的服务。

当前版本为 v2.0.4。

下载与安装

从 GitHub Releases 下载最新版本。

平台	v2.0.4 安装包	安装方式
macOS 14+，Apple Silicon	CodexBridge-2.0.4-macos-arm64.dmg	打开 DMG，将 App 拖入 Applications
macOS 14+，Intel	CodexBridge-2.0.4-macos-x86_64.dmg	打开 DMG，将 App 拖入 Applications
Windows x64	CodexBridge-Windows-x64-2.0.4-Setup.exe	运行安装器，选择安装位置
Windows ARM64	CodexBridge-Windows-arm64-2.0.4-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-2.0.4.deb	使用 APT 安装，详见 Linux 指南
Ubuntu 24.04 LTS ARM64	CodexBridge-Linux-arm64-2.0.4.deb	使用 APT 安装，详见 Linux 指南
Ubuntu 24.04 LTS x64 / ARM64，便携运行	codex-bridge-linux-x64-2.0.4.tar.gz / codex-bridge-linux-arm64-2.0.4.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 模型设置页展示各 Agent 的模型与权限；推理选项按模型能力显示，Antigravity 的强度包含在模型 ID 中。

OpenCode 的模型与权限设置，以及 Direct 工作区的命令模式、白名单和黑名单。

审批与 MCP 设置页展示 Direct 操作和远程任务启动策略，以及 GPT/Qwen 的 MCP 自定义指令。

使用指南

• 详细使用指南：安装、项目授权、Qwen、任务与故障排查
• ChatGPT / Tunnel / OpenAI API Key 配置
• DeepSeek Harness 安装与 API 配置 · 原生桌面连接
• Pi 与 Qoder 安装、地区选择与连接
• OpenCode 连接 · Antigravity 连接与权限
• MCPB 客户端连接与 Registry 发布

首次配置

如果只需要读写本地文件、运行命令，登记项目目录后，配置好 Tunnel、添加并启用 Codex Bridge 插件即可，无需安装或连接 Agent。 这些操作由 Direct Workspace 执行，按已登记的项目目录、Direct 执行规则与审批设置处理。

本地文件与命令

1. 启动服务：打开 App，确认后台服务已连接。macOS 如提示后台项目需要批准，请按提示在系统设置中允许。
2. 添加项目：登记本地目录即授权完整访问。
3. 连接聊天客户端：ChatGPT / Dot 按 Tunnel 配置指南完成 Tunnel 配置，在 ChatGPT 插件 → 添加 → 创建自定义 MCP 服务器 中添加 Codex Bridge，并在对话中启用插件（ChatGPT 使用 Secure MCP Tunnel 需要 Plus 及以上订阅或团队订阅）；Qwen Studio 使用本机回环 HTTP MCP，连接页提供配置复制入口。
4. 直接操作项目：在已启用插件的对话中要求读取、修改项目文件或运行命令；需要批准时在 Bridge 中处理。

委派 Agent 任务（可选）

需要让 Codex、OpenCode、DeepSeek Harness 等 Agent 执行任务时，再完成以下配置：