Codex App Transfer 是一个面向 OpenAI Codex CLI 的轻量桌面配置 + 转发工具。它在本机起一个网关,把 Codex CLI 发出的 Responses API 请求(HTTP 流式 / 非流式 + /responses 回退)翻译成 Chat Completions / Gemini Native / Anthropic Messages / Grok Web 等格式,转发到你选择的供应商。
跟 farion1231/cc-switch 这类偏 Claude Code 的 Anthropic 工具不同,本项目专注 OpenAI Codex CLI 的接入:用桌面 UI 管理供应商、模型映射、转发端口、日志面板,让 Codex CLI 无缝使用第三方 OpenAI / Gemini / Claude-compatible / Grok 等推理服务。
启动转发后,Codex CLI 通过本机 127.0.0.1:18080 与本工具通信。关闭窗口会缩到系统托盘继续运行,右键托盘"退出"才完全退出。
当前版本 v2.1.6(详见 Changelog 与 Releases)。
| 仪表盘 | 供应商 |
|---|---|
 |
 |
| 设置 | 日志 |
 |
 |
启用任意供应商后,Codex CLI 模型选择器会显示「 / 」形式的真实模型名,对话过程中工具循环 / previous_response_id 历史回放 / thinking 模式 reasoning_content 注入全部由本地代理透明处理:
- 管理多套供应商,按 OpenAI 模型名(
gpt-5.5/gpt-5.4/gpt-5.4-mini/gpt-5.3-codex/gpt-5.2)映射到供应商真实模型 ID - 把 Codex CLI 的 Responses API 流式 / 非流式请求转换为上游协议:Chat Completions、Gemini Native(
:streamGenerateContent)、Gemini CLI OAuth(Cloud Code Assist)、Anthropic Messages(/v1/messages)、Grok Web(/rest/app-chat/conversations/new)、Responses 透传等 - 多轮工具对话上下文 +
previous_response_id历史回放 + autocompact 展开 + thinking / reasoning_content 注入全部对齐 OpenAI Responses API 协议 - 会话历史两层持久化:L1 内存 LRU + L2 sqlite 30 天 TTL(
~/.codex-app-transfer/sessions.db),.app重启不丢历史 - Codex CLI 原配置守护:apply 前自动快照
~/.codex/{config.toml,auth.json},退出 / 下次启动按 key 智能合并还原 - 实时日志面板,2 秒自动刷新;统一
tracing::warn!(error_id, detail)+ 稳定 token,operator 可 grep / 聚合 - 反馈弹窗附带诊断材料(环境信息、脱敏配置、最近错误快照及完整请求 / 响应),减少手工补材料
- 中文 / 英文界面,浅色 / 深色 / 绿色 / 橙色 / 灰色 / 白色多种主题
- 跨平台单实例锁定(双击启动自动唤起已有窗口)+ 跨进程 file lock 防多实例同时写 config 丢更新
- Windows / macOS / Linux 系统托盘
最新版:https://github.com/Cmochance/codex-app-transfer/releases/latest
推荐资产命名:
Codex-App-Transfer-v<版本>-Windows-x64-Setup.exe Windows NSIS 安装版(推荐)
Codex-App-Transfer-v<版本>-Windows-x64.msi Windows MSI(企业 MDM / GPO)
Codex-App-Transfer-v<版本>-macOS-arm64.dmg macOS Apple Silicon
Codex-App-Transfer-v<版本>-macOS-x64.dmg macOS Intel x64(v2.1.0+,close #61)
Codex-App-Transfer-v<版本>-Linux-x86_64.deb Debian / Ubuntu
Codex-App-Transfer-v<版本>-Linux-x86_64.AppImage 通用 Linux x86_64,`chmod +x` 直接跑
每个二进制都附带 .sha256 与 .sig(RSA-3072 PKCS#1 v1.5 + SHA-256 签名);公钥 Codex-App-Transfer-release-public.pem 跟随每个 Release 一起发布,直接从 Releases 下载即可验签。
Windows 暂未做 Authenticode 代码签名,系统可能提示未知发布者,可用 .sha256 / .sig 校验下载完整性。
- 启动 Codex App Transfer,弹出桌面窗口
- 在仪表盘点右上角加号 → 选择 preset 或自定义供应商,填入 API Base URL、API Key、模型映射
- 在"转发"页面点"启动转发",本机
18080端口开始监听 - 在 Codex CLI 配置文件(
~/.codex/config.toml)里把base_url指向http://127.0.0.1:18080,把 API Key 设为本工具显示的 Gateway API Key - 重新打开 Codex CLI,模型选项就会自动列出当前供应商的模型映射
⚠️ 必须把 Codex CLI 切到 Full access(/approvals→ "Full access"):第三方 provider 在 Codex CLI 默认auto审批模式下,工具调用会卡审批弹窗;Full access 直接放行工具调用,这是接入第三方 provider 的事实必要前提
桌面窗口无法打开时(罕见,通常是 Tauri webview 初始化失败 / 系统 webview 缺失),先尝试重启;若仍异常,从 Releases 重新下载并查看 ~/.codex-app-transfer/logs/proxy-*.log,或开 Issue 反馈。v2 架构无独立 HTTP admin UI(管理面板走 Tauri 同进程 cas://,不再监听 18081 端口)。
| Provider | 多轮历史 | autocompact | tool_call_repair | 备注 |
|---|---|---|---|---|
| Kimi(Moonshot Platform / Kimi For Coding) | ✅ | ✅ | ✅ | thinking 三层防御 |
| DeepSeek V4(含 Max 思维) | ✅ | ✅ | ✅ | 视觉输入剥离避免 400 |
| Xiaomi MiMo(Token Plan / Pay for Token) | ✅ | ✅ | ✅ | 纯图请求兜底空格 text part |
| MiniMax M2.x / Text-01 | ✅ | ✅ | ✅ | role=system 转 user 防 400(v2.1.6) |
Google AI Studio(gemini_native) |
✅ | ✅ | ✅ | Gemini 3 /v1alpha + Gemini 2.x /v1beta 自动选 |
| Google Gemini CLI OAuth | ✅ | ✅ | ✅ | 浏览器登录 Google 一次,免 API key |
| Anthropic Messages(custom Claude-compatible) | ✅(PR #153) | ✅(PR #153) | ✅(PR #153) | apiFormat=anthropic_messages,Claude preset 待真实验证后开放 |
| Grok Web(SuperGrok / X Premium+) | ✅ | ✅ | ✅(v2.1.6 加 tool_calls flatten) | 实验性,TOS 灰色,仅本机个人使用 |
| Google Antigravity OAuth | ✅ | ✅ | ✅ | 后端就绪,UI 待 PR |
| 智谱 GLM / 阿里云百炼 | — | — | OpenAI Chat 兼容反代 | |
| Responses 协议透传(custom) | — | — | — | 直连上游不经代理(适合 OpenAI 官方 / 原生 Responses 反代);namespace 工具包不展平,部分上游会静默丢工具 |
Codex CLI 按 OpenAI 模型名提示;第三方 provider 用 deepseek-v4-pro / kimi-k2.6 / glm-5.1 / gemini-3-pro 等真实 ID。
本工具用 provider.models[slot](gpt-5.5 → deepseek-v4-pro 等)做槽位映射,Codex CLI 模型选择器看到 <provider> / <real-model> 形式真实模型名;上游 chatcmpl-... 应答 ID 自动重写为 Codex CLI 校验通过的 resp_<base64>,保留 deployment affinity 编码,previous_response_id 跨轮一致。
git clone https://github.com/Cmochance/codex-app-transfer.git
cd codex-app-transfer
cargo tauri dev # 启动桌面窗口,代码改动自动重编译
cargo test --workspace --lib # 跑单元测试
make mac-app # macOS 本地打包到 dist/mac/Fixture 反向 diff(契约测试):
cargo run --bin xtask -- gen-fixtures打包(参考 .github/workflows/release.yml):
cargo tauri build --bundles app,dmg # macOS arm64
cargo tauri build --bundles nsis,msi # Windows x64
cargo tauri build --bundles deb,appimage # Linux x86_64frontend/css/ 走"组件库"形式拆开,不需要全文 grep style.css:
| 想改什么 | 改哪个文件 |
|---|---|
| 主题色 / 圆角 / 阴影 / 间距等 design tokens | frontend/css/tokens.css(129 vars + 6 套主题) |
| 全局 reset / body 字体 / focus 描边 | frontend/css/base.css |
| 按钮 / 卡片 / 表单 / 徽章 / 模态等组件 | frontend/css/components/<name>.css |
| 仪表盘 / 提供商 / 转发 / 设置 / 引导某一页专属样式 | frontend/css/pages/<route>.css |
| 响应式断点 / 1100px / 720px | frontend/css/responsive.css |
预览所有组件 + 各状态 + 主题切换:
# 浏览器直接打开(不需 dev server)
open frontend/gallery.html # macOS
xdg-open frontend/gallery.html # Linux
start frontend/gallery.html # Windowsgallery.html 顶部有主题切换 + 深浅色按钮,改 component css 后刷新即看。frontend/index.html 主入口 <link href="css/style.css"> 不需要改 — style.css 只是 @import 入口聚合所有子文件。
加新组件: 在 components/ 建 <name>.css + 在 style.css 加一行 @import url("components/<name>.css"); + 在 gallery.html 加 section。
老版本只有 /v1/responses,Codex CLI 0.126 起回退到 /responses(不带 /v1/)。本工具已加路由别名,更新到 v1.0.1+ 即可。
通常是 response.id / response.model 没按 Codex CLI 期望填回。本工具把上游 chatcmpl-... 重写成 resp_<base64> 并保留请求模型名,请确认转发日志确实看到 resp_... 而不是 chatcmpl-...。
Kimi / DeepSeek 开启 thinking 后强制要求历史中带 tool_call 的 assistant 消息提供 reasoning_content。v1.0.1+ 已自动补默认空字符串,并把 Responses 输入里的 reasoning items 映射到对应 assistant 消息。
Codex 用户配置里若把 model_reasoning_effort 设成 xhigh / max,本工具自动降级到 high。auto / none 等 Chat 端不接受的值会被丢弃。
v2.1.5 及之前的版本未把 role=system 转 role=user,导致 MiniMax /v1/chat/completions 整请求 400。v2.1.6+ 已修(close #139),所有 role=system 消息转 role=user + content 前置 [System]\n marker。
v2 默认监听 18080(转发);管理界面走 Tauri 同进程 cas://,不再占用 18081。netstat -ano | findstr :18080 查占用,或在 设置 → 端口 改成空闲端口后重启转发。
当前 Windows 构建未做 Authenticode 代码签名。Release 页提供 .sha256 与 .sig,可用于校验安装包未被替换。
v2.1.12+ 的客户端 强制 RSA-3072 PKCS#1-v1.5-SHA256 验签 latest.json 跟 installer:升级流程会主动拉 <url>.sig + 用 build-time 嵌入的官方公钥 (release/Codex-App-Transfer-release-public.pem) 验,失败硬 fail 不 fallback 到 SHA256-only。
自定义 update URL 必须自签才能用:
- fork 仓库,把
release/Codex-App-Transfer-release-public.pem换成你自己的公钥 - 用对应私钥跑
cargo run -p xtask --release -- release-bundle签latest.json+ 每个 installer - 重 build 客户端,公钥嵌进二进制
- 用户在 设置 → Update URL 填你的
latest.json地址
设计意图: 客户端只信"build-time 嵌入的公钥"产生的签名,运行时不可替换公钥,防 MITM 改 latest.json 推任意 installer (公钥 PEM 已在 release/ 目录,但若让客户端动态从 update URL 旁边拉公钥就破坏 trust anchor)。
- 应用界面:转发页面下方实时面板,2 秒自动刷新
- 磁盘文件:
~/.codex-app-transfer/logs/proxy-YYYY-MM-DD.log,点"查看日志"按钮直接打开 - 清除日志:把当前日志移到
logs/backup/并加时间戳后缀,不直接删除
- 后端 / 转发:Rust 1.80+ · axum 0.8 · reqwest 0.12(rustls-tls)· tokio
- 协议适配:
crates/adapters/— Responses ↔ Chat / Gemini Native / Gemini CLI OAuth / Anthropic Messages / Grok Web 互转(请求 body + 流式响应状态机 + reasoning_content + tool_calls) - 前端:HTML + CSS + 原生 JavaScript + Bootstrap 5.3.3(本地化,无 CDN 依赖)
- 桌面壳:Tauri 2 + tray-icon 0.23,通过
cas://URI scheme 把 frontend/ 与 axum 同进程串起来,无 TCP loopback - 存储:
~/.codex-app-transfer/config.json(配置,与 v1.x 互通)、~/.codex-app-transfer/sessions.db(L2 sqlite 会话持久化)、~/.codex/{config.toml,auth.json}(Codex CLI 集成) - 打包:
cargo tauri build单命令出 dmg/AppImage/deb/exe/msi;xtask release-bundle收口出 sha256 + RSA-3072 sig + latest.json + draft GitHub release
本项目专注 OpenAI Codex CLI 接入,不是 OpenAI / Anthropic / Google / xAI 的官方项目,也不复用其商标 / Logo / 发布身份。
上游 API key / OAuth token 仅保存在本机 ~/.codex-app-transfer/(Unix 0600 + atomic write);转发服务只监听 127.0.0.1,不接管系统代理。
部分实验性 provider(Grok Web / Gemini CLI OAuth / Antigravity OAuth)涉及上游 TOS 灰色地带 — Grok Web 反代 grok.com Web 后端协议、Gemini CLI OAuth 借用 cloudcode-pa.googleapis.com/v1internal 内部端点 — 严格限定个人使用,不应作为对外服务发布,用户自担风险。
以下列表为概览(每条一句话)。完整借鉴形式 / 借鉴清单 / 本项目对应 file:line 见 ACKNOWLEDGEMENTS.md。
farion1231/cc-switch— provider 切换形态启发lonr-6/cc-desktop-switch— v1.x 桌面壳骨架 + README 结构参考BerriAI/litellm— 协议双向转换思路tauri-apps/tauri— v2 +cas://架构基座Piebald-AI/claude-code-system-prompts— autocompact prompt 蓝本7as0nch/mimo2codex— MiMo 协议借鉴router-for-me/CLIProxyAPI— Gemini OAuth wire 参考chenyme/grok2api— Grok Web 反向工程参考 + dynamic statsig 算法 + tool_calls flatten 模式galaxywk223/codex-plugin-unlocker— Codex Desktop Plugins 解锁注入脚本(React Context-value 反查 + DOM enable + MutationObserver,MIT)QwenLM/qwen-code— 阿里官方 Qwen CLI,百炼 Token Plan (*.maas.aliyuncs.com) 模型清单硬编码模式(packages/cli/src/auth/providers/alibaba/tokenPlan.ts的TOKEN_PLAN_MODELS,Apache-2.0)BigPizzaV3/CodexPlusPlus— Windows MSIX Codex Desktop CDP 注入路径(IApplicationActivationManagerCOM + AUMID 自动解析 + cmdline 序列化,codex_session_delete/launcher.py,MIT)
通过 PR 直接改进过本项目的贡献者(按首次提交时间倒序;完整列表见 Contributors):
如果提交过 PR 想改名 / 补链接 / 移除,开 issue 跟我说一声。
MIT License。完整文本见 LICENSE.txt。