工作原理
选择器里点哪个模型，请求就按对应路线走——各用各的账号额度，互不干扰。
| 选择器里点的模型 | 请求去向 | 网络要求 | 鉴权方式 |
|---|---|---|---|
| Kimi Code（套餐） | api.kimi.com 国内直连 | 无，VPN 断了也能用 | 你的 KIMI_API_KEY |
| DeepSeek V4.1 Flash | api.deepseek.com 国内直连 | 无，VPN 断了也能用 | 你的 DeepSeek API Key（可选） |
| GLM / Qwen / MiMo | 各家官方接口直连 | 无 | 对应厂商 API Key（可选） |
| GPT-6 / 5.6 / 5.5 | chatgpt.com 官方后端 | 自动走 Windows 系统代理 | Codex 已登录的 ChatGPT 账号 |
中继只监听 127.0.0.1（本机），支持 zstd 压缩请求体和 SSE 流式透传，配置与日志全部留在本机。
好马配好鞍：用顶级 harness 驾驭国产模型
模型本身强，不等于会干活。脱离了工具和执行循环，再聪明的模型也只能「说代码」。Codex（OpenAI 出品）和 Claude Code（Anthropic 出品）是业内公认打磨最深的两款 AI 编程 harness——本中继做的事，就是让它们直接驾驶 Kimi / DeepSeek / GLM / Qwen / MiMo。
业界最专业的编程客户端
规划 → 调工具 → 看结果 → 修正的完整 Agent 循环，读写文件、执行命令、应用补丁、搜索代码全套工具，外加上下文自动压缩与权限体系——这是普通聊天窗口给不了的工程化环境。
harness 直接放大模型能力
同一个模型，裸聊只能吐出代码片段；装进 harness 后，它自己读懂项目结构、跨文件改代码、跑命令验证、看报错回头再修。模型没变，编程效果却是天壤之别。
旗舰工作流，国产模型成本
这两款 harness 官方只服务自家旗舰模型。接上中继后，用国内 API 的价格，获得 OpenAI / Anthropic 同款的编程工作流，不用付订阅、不用折腾网络。
一个 harness，随时换引擎
Codex 选择器或 Claude Code 的 /model 里点一下，同一个工程会话立刻换模型跑——哪家强用哪家，对比模型零成本。
特性
不止切换模型——围绕「国内网络 + 官方账号 + 小白可用」三个场景做的全套工程。
智能分流
按模型名自动路由：Kimi / DeepSeek 直连国内接口，GPT 走系统代理，互不干扰。
无感切换
从源头关闭 WebSocket 重试，切换模型后没有 20 秒白等的重连过程。
一键安装
自动备份并改写 Codex 配置、注册开机自启、写入 Claude Code 环境变量，一步到位。
Claude Code 接入
Anthropic Messages 协议直通中继，全模型可用，/model 下拉直接选，装完即用。
稳定性全家桶
套餐故障转移、上游熔断、静默看门狗、断流兜底、清单自愈——长任务不卡死，故障有交代。
自带体检
doctor 命令逐项检查配置、中继存活、各家链路连通性，问题一眼定位。
CLI 同款
命令行一样能切：codex -m 指定模型，或交互界面输入 /model 选择。
隐私本地
只监听 127.0.0.1，请求直达官方接口，不经过任何第三方服务器，源码随包可审。
30 秒上手
解压 → 双击 → 粘贴 Key，三步完成。全程不用编辑任何配置文件。
解压 zip，双击「安装.bat」
解压到任意目录。若 Windows 弹出蓝色"已保护你的电脑"，点 更多信息 → 仍要运行（未签名软件的正常提示，不是病毒）。
按提示粘贴 Key，没有的直接回车跳过
所有厂商的 Key 都可选——只配你有的那几家即可（只用 GPT 官方模型可以全部跳过）；在提示处输 o 会自动打开该厂商的申请页面。以后加 Key 或换 Key，双击「配置.bat」按同样方式粘贴即可：
== 改配置：逐项回车保留现有值，输入 - 删除，输 o 打开申请页 == Kimi API Key（当前 sk-kimi-...，回车保留，输入 - 删除，输 o 打开申请页）: █ DeepSeek API Key（可选）（回车跳过，输 o 打开申请页）: █ 智谱 GLM API Key（可选，bigmodel.cn Coding Plan）（回车跳过，输 o 打开申请页）: █ 阿里云百炼 API Key（可选，通义 Qwen）（回车跳过，输 o 打开申请页）: █
重启 Codex / Claude Code，点选模型
Codex 模型选择器里 GPT、Kimi、DeepSeek、GLM、Qwen、MiMo 同在；Claude Code 里输入 /model 全部可见。出问题双击「自检.bat」。
让 AI 助手帮你装（复制指令即可）
正在用 Kimi CLI、Claude Code、Codex 等 AI 编程工具？把下面整段指令复制给它，自动完成下载、安装、配 Key、自检一条龙，你只需最后重启客户端。把尖括号换成你的真实 Key，没有的厂商删掉对应参数。
请帮我在本机（Windows）安装 codex-model-relay——一个让 Codex / Claude Code 自由切换 GPT / Kimi / DeepSeek / GLM / Qwen / MiMo 模型的本机中继工具。全程不要向我提问，按以下步骤执行，完成后逐项汇报结果： 1. 访问 https://amazon888.com/codex-model-relay/version.json，取其中 url 字段作为下载地址，下载该 zip 并解压到合适目录 2. 在解压目录运行安装命令（把尖括号换成我的真实 Key；我没有的厂商就删掉对应两段参数）： codex-model-relay.exe install --kimi-key <我的KimiCode密钥> --deepseek-key <我的DeepSeek密钥> --glm-key <我的GLM密钥> --qwen-key <我的百炼密钥> --qwen-host <我的百炼专属域名> --mimo-key <我的MiMo密钥> （百炼专属域名形如 llm-xxxx.cn-beijing.maas.aliyuncs.com，在百炼控制台「模型广场 → 查看代码」页面可以看到；我没有的厂商，把对应两段参数都删掉） 3. 安装结束后运行 codex-model-relay.exe doctor 自检，把每项结果汇报给我；如有 NG 项，按提示修复后重跑直到全部 OK 4. 最后提醒我：重启 Codex 后模型选择器、重启 Claude Code 后 /model 里就能自由切换全部模型
还没有 Key？把对应参数删掉先装，装完双击 配置.bat 补填。
CLI 同样支持切换
Codex CLI 和桌面端共用同一份配置（~/.codex/config.toml），装完中继后命令行也能随便切——模型名和选择器里完全一致。
| 场景 | 用法 |
|---|---|
| 单次指定模型 | codex -m "kimi-code/kimi-for-coding" 或 codex -m "gpt-5.5" |
| 非交互执行 | codex exec -m "gpt-5.6-luna" "帮我重构这个函数" |
| 交互界面内切换 | 进入 codex 后输入 /model，弹出模型列表直接选 |
| 改默认模型 | 编辑 ~/.codex/config.toml 里的 model = "..." |
codex -m "kimi-code/kimi-for-coding" # Kimi Code，国内直连，VPN 断了也能用 codex -m "deepseek/deepseek-flash" # DeepSeek V4.1 Flash，国内直连按量付费 codex -m "gpt-5.5" # ChatGPT 订阅，自动走系统代理 codex -m "gpt-6-astra" # 目录里的任意 slug 都能用
Claude Code 接入
v1.9.43 起安装即插即用：双击 安装.bat 会自动写入 4 项用户环境变量，并把 Claude Code 默认权限设为 acceptEdits（自动接受文件编辑、命令仍询问）——装完重开终端直接 claude，零手动配置；卸载自动清理、自检逐项校验。老版本用户手动执行一次同样生效：
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "http://127.0.0.1:10100", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "relay", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-6", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "1", "User")
v1.9.44 起 /model 下拉直接选模型：开启模型发现后，重启 Claude Code 在 /model 里直接看到中继的全部模型——DeepSeek / Kimi / GLM / Qwen / MiMo，带品牌显示名（「Kimi · K3（1M 上下文）」「DeepSeek · V4.1 Pro」），选中即用、可存为默认，不用手填任何 ID；列表里的 GPT 官方模型直走 ChatGPT 官方链路。同一会话随时换模型，与 Codex 侧同一套路由、故障转移和熔断保护。
| Claude Code 里的模型名 | 实际路由 |
|---|---|
claude-sonnet-4-6 / claude-opus-4-6（默认映射） | Kimi K3（套餐额度，国内直连） |
claude-haiku-4-5（后台小任务） | DeepSeek Flash（按量，便宜） |
| 直接填中继 slug | deepseek/deepseek-v4-pro、glm/glm-5.3、qwen/qwen3-coder-flash、mimo/mimo-v2.6-pro、kimi/k3 等，填哪个用哪个 |
| 未列出的 claude 新名字 | 走 default 映射（默认 Kimi K3） |
想改默认映射：编辑 ~/.codex/model-relay/config.json 里的 claude_models 表（改完重启中继）。工具调用、多轮会话、上下文超限自动压缩均已实测可用。
已适配新版 Codex
2026 年新版 Codex 引入了不少破坏性变更，中继已全部适配，安装时自动处理：
| 新版变更 | 中继的处理 |
|---|---|
| 请求体改用 zstd 压缩 / chunked 编码 | 自动解压后路由转发，无需任何操作 |
| 默认走 WebSocket，失败重试 5 次白白等待 | 通过自定义提供商从源头关闭 WS，切换零等待 |
新增 namespace / web_search / image_generation 工具类型 | 发往 Kimi 时自动过滤其不支持的工具，GPT 不受影响 |
会话历史中的 compaction 压缩条目 | 中途切到 Kimi 时自动剔除，会话无缝继续 |
推理级别枚举收紧（max/ultra 非法） | 安装时自动把模型目录规范为新版合法取值 |
service_tier = "default" 失效 | 自检可识别，按提示删除该行即可 |
对比 CC Switch，我们的优势
CC Switch 是优秀的通用方案（GUI 管理、协议转换、支持多工具）。但如果你就是这个场景——国内网络 + 手上有任意几家的模型账号（官方订阅 / 厂商套餐 / 按量 Key），本工具更轻、更贴合：
| CC Switch | codex-model-relay（本工具） | |
|---|---|---|
| 定位 | 管理各种第三方中转站 API key | 订阅、套餐、按量随便混：GPT 走 ChatGPT 登录态，Kimi / GLM / MiMo 走套餐，DeepSeek / Qwen 走按量 Key——各扣各的额度，不经任何中转站 |
| 国内网络适配 | 需自行保证全局代理或中转站直连 | 自动读 Windows 系统代理：GPT 走代理，Kimi 永远直连，VPN 掉线不影响 Kimi |
| 新版 Codex 兼容 | 取决于版本跟进 | 已实测适配 2026 新版：zstd 压缩请求体、WebSocket 重试、compaction 条目、新工具类型自动过滤 |
| Claude Code 接入 | 协议转换方案 | 原生 Messages 协议直通，/model 下拉直接选模型、装完即用 |
| 体积与依赖 | 完整桌面应用（Tauri） | 18.1 MB 单文件 exe，无需安装运行环境 |
| 安装配置 | GUI 里添加供应商、开路由、调映射，约 10+ 步 | 双击安装.bat，粘贴一次 key 即可；自带 doctor 自检 |
| 透明度 | 开源（功能多、代码量大） | 包内附完整 Python 源码，几分钟可审完 |
一句话：重度玩中转站、多 CLI 工具的用户选 CC Switch；只要你在国内、手上有任意几家的模型账号（订阅/套餐/Key）、用 Codex 或 Claude Code，就选我们。
故障排查
按现象对号入座；解决不了就双击「自检.bat」，把结果发给帮你装的人。
| 现象 | 原因 | 处理 |
|---|---|---|
| 所有模型转圈 | 中继没在运行 | 运行自检.bat，或重新安装 |
| 只有 GPT 超时 | 系统代理未开启 | 打开 VPN 的系统代理模式 |
| GPT 报 401/403 | ChatGPT 登录过期 | Codex 里重新登录 |
| Kimi 鉴权错误 | KIMI_API_KEY 不对 | 改 ~/.codex/model-relay/config.json 后重启中继 |
| 切换模型后没反应 | 旧会话缓存 | 开新会话即可 |
| 切到 Kimi 报 item/tool type not supported | 旧版中继 | 下载本页最新包重新安装 |
| 长任务反复「正在重新连接」 | v1.1 及以下已知问题（流式超时 + 模型目录强制 WebSocket） | 升级到最新版并重启 Codex 即可解决 |
| GPT 突然 502 / 连接超时，Kimi 正常 | 代理节点抖动（日志里有 SSL handshake / EOF 错误），与具体 VPN 品牌无关 | 换个代理节点或稍等片刻；Kimi 链路不受影响可继续用 |
| Claude Code /model 列表是空的 | 环境变量没生效 | 重开终端 / 重启 Claude Code；确认 4 项变量已写入（自检.bat 可查） |
| 杀软误报 | PyInstaller 打包常见误报 | 包内附完整源码 codex_model_relay.py 可自查 |
更新日志
所有用户启动中继即自动更新到最新版，无需手动下载。点开看每个版本做了什么：
v1.9.54 · 新增 Kimi K3.1 Pro2026-10-27
Kimi 官方刚发布的 K3.1 Pro 与 K3.1 Pro 高速版 已加入模型下拉列表， Codex 里点选即用（上游发布当天跟进）。同时修复了一个历史问题：目录补录函数从未被调用，导致以往新模型必须等中继发版才能进列表——现在中继启动时自动补录，今后 Kimi 等厂商发布新型号即可自动跟进。
v1.9.53 · 适配 Codex 桌面 26.1021 新版2026-10-26
新版桌面加强了启动时的组织设置读取时限（约 1.6 秒），旧版桌面路由器的启动前置探测会超时，导致启动即弹「无法加载组织设置、应用已暂停」。本版内置的路由器改为快速启动：探测结果缓存优先、协议检测零子进程、后台预热、配置后台重试，启动准备从数秒降到约 50 毫秒，弹窗不再出现；对话内热切换模型等增强功能在新版桌面上全部恢复。实测桌面 26.1021 + 本版中继，DeepSeek / Kimi / Qwen / MiMo 对话与切换均正常。
v1.9.47 – 52 · 稳定性六连修2026-10-20 – 23
① 模型显示名自愈修复（47）：选择器显示名被打回原始 slug 后无法自动恢复的问题根治；
② 会话历史自动清扫（48）：第三方模型产生的历史条目自动规整，切回 GPT 官方模型回放历史不再整轮报 400；
③ 官方保护模式自动恢复（49）：Codex 自动更新窗口的瞬时探测失败不再把旧对话的第三方模型永久锁没，体检通过后自动还原；
④ Kimi 工具调用中断修复（50–51）：任务被中途停止后再继续，不再因孤儿 tool_calls / 输出乱序被 Kimi 整轮拒绝；
⑤ 防中断 Hold（52）：长任务不再莫名「自己停止」，对话长跑更安心。
v1.9.44 – 46 · Claude Code 接入三连升级2026-10-17
① /model 下拉列表直接显示中继全部模型（带品牌显示名，选中即用、可存默认）——自动适配 Claude Code 官方的模型发现过滤机制；
② 安装.bat 一键写入 Claude Code 环境变量并把默认权限设为 acceptEdits，装完即用、卸载自动清理；
③ 修复含连字符厂商名（kimi-code）的发现别名路由问题。
v1.9.41 · Claude Code 客户端支持2026-10-17
中继同时讲 Anthropic Messages 与 OpenAI Responses 两种协议，Claude Code 把 ANTHROPIC_BASE_URL 指向本机中继，即可使用 DeepSeek / Kimi / GLM / Qwen / MiMo 全部第三方模型；套餐故障转移、上下文门限、上游熔断保护与 Codex 侧完全一致，同一对话随时换模型。
另：DeepSeek 官方已下线 deepseek-v4（现仅 deepseek-flash / deepseek-v4-pro），旧会话与旧映射自动别名到 deepseek-v4-pro，无感过渡。
v1.9.40 · 模型选择器双重自愈更早
第三方目录条目被外部程序改坏（visibility 变 hide、显示名变原始 slug，选择器里 DeepSeek/Kimi/GLM/Qwen/MiMo 分组整体消失）时，守护进程每 10 分钟自动恢复 visibility=list 与品牌显示名；叠加官方清单缓存自愈（客户端异常退出写入残血清单自动垫回完整版）。
另有 v1.9.38 修复：保护模式迟滞——官方入口的自动体检探测单次失败不再立刻把第三方模型全部锁死（503 保护模式），需连续 2 次失败才切换。
v1.9.37 · 熔断自动换型更早
上游故障期间，旧会话里重发的消息即使请求体还带着故障模型，中继也会自动改走兜底模型（DeepSeek → Kimi K3）继续应答，会话不再卡死；熔断状态落盘保存，重启或更新中继后依然生效。DeepSeek 故障中实测：重发请求 2 秒由 K3 正常应答。
v1.9.36 · 上游熔断器更早
某家上游被判无响应后 10 分钟内，同上游请求直接秒级失败并提示切换模型，客户端自动重连循环不再每轮干等 4 分钟；上游故障原因以 SSE 事件直接显示在对话里。
v1.9.35 · 上游静默看门狗更早
上游返回 200 后持续 120 秒无任何数据（服务过载/挂起）时，自动整请求重试一次；重试后依旧静默则直接返回 504 明确报错并提示换模型，不再让客户端干等半小时。
v1.9.33 – 34 · 套餐故障转移链全厂商统一更早
DeepSeek-v4-pro / GLM-5.3 等套餐覆盖模型同样「按量⇄套餐」双向自动切换；按量余额不足(402)纳入转移触发；不在套餐内的型号 402 时直接提示可换用的同族套餐型号；体检欠费结论改为二次确认，杜绝中继重启瞬间把健康厂商从列表里误藏。
更早版本v1.9.32 及以下
MiMo 套餐优先级与故障转移链、新版 Codex 适配（zstd / WebSocket / compaction / 工具类型过滤）、智能分流与系统代理读取等基础能力。完整历史见包内源码与文档。
合规说明
本工具的性质：一个运行在你自己电脑上的本地中继（只监听 127.0.0.1），把客户端发出的请求按模型转发到你自己的账号——Kimi 走你自己的 KIMI_API_KEY，GPT 走你自己已登录的 ChatGPT 订阅。它不破解任何付费墙，不获取他人账号，不上传你的任何数据，完整源码随包附带可审计。
| 事项 | 说明 |
|---|---|
| Kimi 侧 | Kimi 官方文档明确支持在 Codex 中接入 Kimi Code（原生兼容 OpenAI Responses API），本工具即按官方用法实现。套餐面向个人开发者，请勿用于企业场景。 |
| GPT 侧 | 请确保你本人持有合法的 ChatGPT 订阅。OpenAI 条款限制从不受支持的地区访问其服务，账号使用方式的风险由使用者自行承担——这与是否使用本工具无关。 |
| 网络 | 本工具不提供任何代理/VPN 功能，仅读取 Windows 系统已有代理设置。网络工具的合规性由使用者自行负责。 |
| 禁止事项 | 禁止转售、共享账号、打包后进行商业分发。本工具为非官方开源工具，仅供个人学习开发使用，与 OpenAI、Anthropic、Moonshot AI 无任何隶属关系。 |
使用本工具即表示你已阅读并同意以上说明；如不同意，请使用包内的「卸载.bat」一键还原。