一处配置，让官方 Codex 与常用 Coding Agent 用上你的模型。
统一管理模型供应商，自定义模型与官方 GPT 并列，保留 ChatGPT 登录与会话。
简体中文 | English
下载 macOS 版 ·
下载 Windows 版 ·
下载 Linux 版
macOS / Windows 原生菜单栏与托盘应用 · Linux CLI 与 Web 面板
为什么选 Mixin · 实测对比 · 功能与界面 · 供应商 · 50 款 Agent · 快速开始 · 文档 · FAQ
Codex Mixin 是 Rust 为核心编写的本地模型网关，通过 OpenAI、Anthropic 和 Gemini 兼容接口，把请求路由到你配置的供应商。CLI、原生桌面应用和 Web 面板共用同一套核心能力。
| 自定义模型与官方 GPT 并列显示。ChatGPT 登录、历史会话和移动端远程任务照常可用,语音, dots 全都保留 | 47 款支持一键配置；Cursor CLI、Copilot CLI、Devin 提供厂商原生模型管理。查看完整列表。 |
| 在 OpenAI Responses、Chat Completions、Anthropic Messages 和 Gemini 之间无损转换请求与流式响应，处理思考内容与工具调用。 | 采用 Billion Context 压缩规则的 3 级上下文引擎，让模型压缩、检索和恢复归档原文。打开后即可节省 Token 的同时。了解机制。 |
| 本地保留最近 5,000 条回复，查看 Token、缓存命中、首字延迟与输出速度；菜单栏或托盘可以直接看供应商额度。 | 空闲时仅占用 76.8 MiB，40 条满载活动请求时为 113.5 MiB。见下文。 |
Mixin 0.7.7、CC Switch 4.0.26、Magpie 0.1.3051 同时连接本机受控 HTTP/SSE 上游。每请求携带 1,000,000 文本 token + 2 张 1024 × 768 PNG。每个主会话启动 4 个子会话，0 / 2 / 4 / 8 个主会话对应每款产品 0 / 10 / 20 / 40 路活动请求。
| 测量项 | Codex Mixin | CC Switch | Magpie |
|---|---|---|---|
| 空闲内存 | 76.8 MiB | 157.6 MiB | 243.2 MiB |
| 10 路活动请求 | 91.1 MiB | 165.1 MiB | 374.9 MiB |
| 20 路活动请求 | 98.0 MiB | 171.9 MiB | 664.3 MiB |
| 40 路活动请求 | 113.5 MiB | 185.8 MiB | 1,284.9 MiB |
| CPU 开销 · 40 路活动请求 | 1.047% | 1.777% | 6.743% |
添加供应商、刷新模型列表，并探测 Reasoning、Function Calling、Tool Search、Web Search 能力。探测结果缓存后供目录和 Fusion 使用；探测会发送真实请求，可能消耗额度。
在 Agent 页面接入已安装客户端；断开时恢复托管字段并保留无关配置。用量页展示每天与每次回复的 Token、缓存命中率、思考消耗、返回模型、首字延迟和输出速度。供应商额度支持圆环或条形显示，已用达到 90% 时标红。
 Agent 接入 · 安装版本、接入状态与恢复入口 |
 用量明细 · 每次回复的 Token、缓存与速度 |
启用上下文引擎后，模型可在支持的请求路径中压缩较早历史，再从本地归档检索或恢复原文。最近消息与工具调用对受到保护；控制台展示会话数、压缩次数、节省 Token 和缓存命中。详见 适用路径与配置。
 上下文引擎 · 启用开关与会话统计 |
 压缩与归档 · 机制示意图 |
WinUI 3 控制台管理模型、Agent、用量和上下文，托盘随时查看网关状态与额度。macOS 提供原生菜单栏与控制台；Linux 使用 CLI 和 Web 面板。
 Windows 控制台 · 模型与服务 |
 系统托盘 · 网关状态与供应商额度 |
界面说明见 产品展示。截图中的模型和统计值反映采集时状态。
- 模型融合（Fusion）： 一个模型标识可调度主模型和辅助模型，由 Judge 模型评审结果；也可按时间段路由到不同供应商。
- 配置备份： 在高级菜单导出或导入供应商、模型与 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 款 Agent 均提供接入或原生模型管理。47 款支持网关配置或原生应用接入，断开时恢复托管字段并保留无关配置。Cursor CLI、Copilot CLI、Devin 使用厂商账号管理厂商原生模型，不经过自定义模型网关。
 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 |
 Gemini CLI |
 agy |
  Cursor CLI · 原生模型 |
  Cursor |
  Copilot CLI · 原生模型 |
  Devin · 原生模型 |
  Zed |
 Aside |
 Muse |
 Hanako |
 Alma |
 Cindy |
从 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。远程访问时，使用开发机可访问的地址和面板实际端口；网关与面板的访问边界见 数据与安全。
仓库内文档：
使用教程见 GitHub Wiki：
版本变更见 RELEASE_NOTES.md。
接入后还能用 ChatGPT 登录和官方 GPT 吗？
可以。Codex 选择「官方账号模式」接入后，自定义模型加入官方模型选择器，登录、历史会话与移动端远程任务继续可用。接入和断开都不改动 Codex 的会话数据库与账号状态。详见 客户端接入。
50 款 Agent 都能使用自定义网关模型吗？
47 款支持网关配置或原生应用接入；Cursor CLI、Copilot CLI、Devin 通过厂商账号管理厂商原生模型。原生应用和终端启动各有前提，见 Agent 接入 中的说明及 接入契约。
远程 Linux 开发机怎么打开面板？
解压发布包后运行 ./codex-mixin panel，保持进程运行，使用可访问的主机地址打开终端打印的面板地址。面板默认监听所有网卡的 8000–9000 随机端口，需要本次启动生成的 Token。详见 安装指南 和 数据与安全。
上下文引擎会压缩所有请求吗？
默认关闭。开启后需要会话标识和支持的请求路径：Responses 及可保真映射的原生 Anthropic Messages 内容可进入共享回路；托管工具及无法保真映射的原生内容继续直通。详见 上下文引擎。
导出的备份文件加密了吗？
没有。备份包含 API Key，使用 Base64 编码，请按凭据妥善保管。详见 配置备份与恢复。
本项目采用 Codex Mixin Source Code Viewing License 1.0，第三方声明见 NOTICE。