面向官方 OpenAI Codex 与主流 AI Coding Agent 的本地模型网关
在保留官方账号、GPT 模型和远程任务的同时，接入第三方模型供应商。
简体中文 | English
概览 · 快速开始 · 使用入口 · 界面 · 功能 · 供应商 · Agent 接入 · 文档
Codex Mixin 是一个用 Rust 编写的本地网关。它在本机提供 OpenAI、Anthropic 和 Gemini 兼容接口，把官方 Codex 和其他 Coding Agent 的请求路由到你配置的模型供应商，例如 DeepSeek、Claude、Gemini、Baidu OneAPI、AWS Bedrock、Google Antigravity，以及任意 OpenAI 或 Anthropic 兼容端点。
接入官方 Codex 时，自定义模型与官方 GPT 模型同时出现在模型选择器中；ChatGPT 账号登录、历史会话和移动端远程任务保持可用。断开接入后，网关恢复客户端原来的配置。
日常使用从图形界面开始：macOS 菜单栏、Windows 系统托盘，或 Linux / 远程机器的 Web 控制面板。添加供应商、选择模型、接入 Agent 和查看用量，都可以在界面中完成。管理目录收录 50 款 Agent，默认发布包支持其中 38 款的配置接入与恢复。
从 Releases 选择对应平台和架构的发布包，无需安装 Rust 或从源码编译。
| 平台 | 下载与运行 | 图形入口 |
|---|---|---|
| macOS | 下载 Apple Silicon 或 Intel 的 .dmg，将 App 拖入「应用程序」后启动 |
点击菜单栏图标 →「打开控制台…」 |
| Windows | 运行 windows-x86_64-setup.exe，或解压便携版 Zip 后启动 |
点击系统托盘图标 →「打开控制台…」 |
| Linux | 下载 x86_64 或 ARM64 的 unknown-linux-musl.tar.gz，解压后运行 ./codex-mixin panel；也可安装对应 .deb |
在浏览器打开终端打印的访问地址 |
Linux 压缩包内含可直接运行的二进制；进入解压后的目录执行即可。Web 面板运行期间请保持进程开启。系统要求、文件名和远程访问方法见 安装指南。
- 在「模型与服务」添加供应商，填写 API Key 或完成 OAuth 登录。
- 刷新模型列表，选择要使用的模型并保存，确认网关已启动。
- 打开 Agent 页面，找到已安装的客户端并接入；Codex 通常选择「官方账号模式」，保留官方 GPT 与 ChatGPT 登录。
- 重启对应客户端或打开新会话，在模型选择器中选择自定义模型。
菜单栏或托盘可快速查看网关状态和供应商额度；控制台的「用量明细」展示每天与每次回复的 Token、缓存和速度。需要恢复客户端原配置时，在 Agent 页面断开接入。
Web 面板默认监听所有网卡的 8000–9000 随机端口，访问需要本次启动生成的 Token。远程访问时，使用开发机可访问的地址和面板实际端口；网关与面板的访问边界见 数据与安全。
| 入口 | 主要用途 |
|---|---|
| macOS 菜单栏 / Windows 托盘 | 网关启停、额度速览、打开控制台；高级菜单中管理 Fusion、备份等功能 |
| 桌面控制台 | 模型与服务、Agent 接入、用量明细 |
| Web 控制面板 | 浏览器中管理模型与服务、Agent、用量、Fusion 及高级设置，适合 Linux 和远程机器 |
| CLI | 脚本、自动化与诊断，命令见 CLI 参考 |
以下为 v0.7.4 发版期间的 macOS App 实际界面。
模型与服务 · 供应商、模型选择、能力与上下文设置
 Agent 接入 · 安装版本、接入状态与恢复入口 |
 用量明细 · 每日统计、逐次回复、缓存与速度 |
界面说明见 Wiki 的 产品展示。截图中的模型和统计值仅反映采集时状态。
与官方 Codex 共存。 自定义模型以独立名称加入 Codex 模型目录，与官方模型并列显示。官方目录从 OpenAI 同步，接入和断开都不改动 Codex 的会话数据库与账号状态。
协议转换。 网关在 OpenAI Responses、Chat Completions、Anthropic Messages 和 Gemini 之间转换请求与流式响应，保留思考内容、工具调用和多轮上下文。
模型能力探测。 对已添加的模型发送真实请求，标注 Reasoning、Function Calling、Tool Search 与 Web Search 能力，结果缓存后供目录和 Fusion 使用。
用量与额度。 查看每天和每次回复的 Token、缓存命中率、思考消耗、返回模型、首字延迟与输出速度，本地保留最近 5000 条回复。供应商额度支持圆环或条形显示，已用超过 90% 时标红。
模型融合（Fusion）。 一个模型标识可以调度主模型和辅助模型，由 Judge 模型评审结果；也可以按时间段把同一标识路由到不同供应商。
Claude Desktop 接入。 在 Agent 页面连接 Claude Desktop，让 Code 标签页通过网关使用所选模型，保留 Claude.ai 登录；断开接入即可恢复原配置。
配置备份。 在高级菜单导出或导入供应商、模型与 Fusion 配置，用于恢复或跨机器迁移。备份包含 API Key，Base64 只是编码，请按凭据妥善保管。
官方 GPT 的 ECH 连接（实验性）。 在高级菜单启用前会先测试 DNS 与 TLS，再通过 DoH 与 ECH 访问 OpenAI 官方端点。详见 ECH GPT。
客户端鉴权（可选）。 默认构建不校验入站 Key，便于本机客户端直接使用。以 --features client-auth 构建时，网关要求客户端携带密钥。
在界面中添加供应商时可选择以下预设，其余兼容端点选择「自定义」。
| 预设 | 供应商 | 上游协议 | 鉴权 |
|---|---|---|---|
openai |
OpenAI 官方 | OpenAI Responses | ChatGPT OAuth |
baidu-oneapi |
Baidu OneAPI | Anthropic Messages；GPT 系列走 OpenAI Responses | API Key |
openrouter |
OpenRouter | OpenAI Chat Completions | API Key |
deepseek |
DeepSeek | OpenAI Responses | API Key |
agy |
Google Antigravity | Gemini | Google OAuth |
opencode-go |
OpenCode Go | OpenAI Responses | API Key，自动附加会话亲和 Header |
aws-bedrock |
Amazon Bedrock (Mantle) | Anthropic Messages | Bedrock API Key 或 AWS 访问密钥 |
custom |
任意兼容端点 | OpenAI Responses（默认） | 自定义 Header 与 Key |
添加后可在界面中测试连接、刷新模型列表，并从模型操作菜单重新探测能力；探测会发送真实请求，可能消耗额度。
管理目录收录 50 款 AI Coding Agent，其中 38 款在默认构建中支持一键写入网关配置，并能在断开时恢复原配置。
 Codex |
 Claude Code |
 Claude Desktop |
 DSH |
  OpenCode |
  Pi |
 OpenChamber |
  MiMo Code |
  OmO |
  Goose |
  VS Code |
  VS Code Insiders |
  Copilot (JetBrains) |
 Air |
 Crush |
  Oh My Pi |
  Hermes Agent |
 Mister Morph |
  Kimi Code |
 Qwen Code |
  Droid |
  Qoder |
  Qoder CN |
  Grok Build |
 ZCode |
 WorkBuddy |
 CodeBuddy |
 Pencil |
 T3 Code |
 AtomCode |
  VSCodium |
 Reasonix |
  Command Code |
  fx |
 Empryo |
 Ante |
 MiniMax Code |
  Cline |
以下 12 款客户端的配置依赖系统钥匙串加密、进程级注入、闭源认证协议或应用内私有运行时 API，目前不写入网关配置：
 Gemini CLI |
 agy |
 Aside |
  Cursor CLI |
  Cursor |
  Zed |
  Copilot CLI |
  Devin |
 Muse |
 Hanako |
 Alma |
 Cindy |
安装对应框架后，可在控制台的 Agent 页面一键连接或恢复配置，亦可通过 CLI 命令操作：
codex-mixin agent connect <id>与codex-mixin agent disconnect <id>。各适配器的写入文件、契约与限制见 Agent integration contracts；图标归属声明见 Agent Logos Attribution。
仓库内文档：
使用教程见 GitHub Wiki：
版本变更见 RELEASE_NOTES.md。