Codex Router 兼容应用 — Codex、Cursor、Claude Code 等
一套 Codex Router 服务现在可以把相同的、已选择且已认证的模型目录发布到多个编码 Agent。供应商密钥、故障转移、Vision Bridge 与用量统计仍由共享的本地路由层负责；每个客户端只写入连接它所需的最小配置。
支持的客户端目标
| 客户端 | Target | 集成作用 |
|---|---|---|
| Codex App 与 CLI | codex | 把路由模型合并进原生选择器，保留 GPT 模型与 ChatGPT 登录 |
| DeepSeek Harness | dsh | 向 Harness 设置添加一个可热加载的 codex-router 供应商 |
| Gemini CLI | gemini | 在 ~/.gemini/.env 写入标记块，并提供 Gemini 形状的本地端点 |
| Cursor Agent 与 Cursor App | cursor | Cursor Agent 走本地适配器，Cursor App BYOK 走专用 HTTPS 边缘 |
| Claude Code | claude | 添加私有 claude-router 启动器与 Anthropic Messages 兼容接口 |
| OpenClaw | openclaw | 发布托管的 codex-router Responses 供应商，Control Center 可一键设置 |
可以直接安装新目标，也可以给现有路由器增加目标：
./install.sh --target dsh --auto --providers configured
./bin/model-router gemini enable
./bin/model-router claude enable
./bin/model-router openclaw enabledoctor、status、enable 与 disable 都可使用这些 target 名称。移除一个目标不会动其它客户端；只有最后一个客户端不再使用时，共享服务才会退役。
opencode、pi、omp、Command Code 与 Hermes Agent
另外五个编码客户端把供应商配置保存在你也拥有的配置文档里。Control Center 的 Harness 页面为每个客户端提供 Route 开关。打开 Route 会在路由器能够处理时安装对应 CLI，并把路由器拥有的那一个 provider key 写入该文档；关闭时只删除由 Codex Router 管理的条目，不会停用共享服务，也不会改变其它客户端。
| 客户端 | 路由器编辑的文档 | 协议 | 安装 |
|---|---|---|---|
| opencode | ~/.config/opencode/opencode.json | Responses | opencode-ai |
| pi | ~/.pi/agent/models.json | Responses | @earendil-works/pi-coding-agent |
| omp (oh-my-pi) | ~/.omp/agent/models.yml | Responses | 需先自行安装 omp（omp.sh，基于 Bun） |
| Command Code | ~/.commandcode/providers.json | Anthropic Messages | command-code 1.30.0 或更高（过旧版本会在设置时升级） |
| Hermes Agent | ~/.hermes/config.yaml | Anthropic Messages | 需先自行安装 Hermes |
终端里同样的操作，每个客户端一条命令：
./bin/control client-setup opencode
./bin/control client-setup pi
./bin/control client-setup omp
./bin/control client-setup commandcode
./bin/control client-setup hermes
./bin/control client-disconnect opencode这些客户端是被发布进去而不是作为目标安装：它们没有 MODEL_ROUTER_TARGET，也没有第二个服务。它们共用其它客户端使用的同一路由层，因此启用供应商、保存密钥或整理模型会一起重新发布。保持更新是单独的显式操作——./bin/control client-update <id>（或 --all）会运行各客户端自己的更新器（opencode upgrade、pi update --self、command-code update、hermes update --yes），而不是 npm install -g，因此用 Homebrew 或 curl | sh 安装的 CLI 会原地升级。YAML 文档按行区间拼接，保留注释与其它供应商；无法往返的 JSON 会被拒绝而不是被重排；基础 URL 不是本路由器签发的 codex-router 供应商不会被替换或删除。
各客户端的重要差异
DeepSeek Harness 会监控设置，通常无需重启。Gemini CLI 在下次启动时读取托管环境；如询问认证方式，选择 “Use Gemini API key”，因为该值是本地回环调用能力，不是 Google 凭据。
Claude Code 通过 claude-router 启动，用 /model 选择 codex_router/anthropic/<provider>/<model>。启动器会让新建子代理以及 Claude 默认的 Opus/Sonnet/Haiku 层级别名继续使用当前会话选择的路由模型，避免内置别名回落到路由器并未提供的 Anthropic 模型 ID。兼容层可以暴露非 Claude 模型，但 Anthropic 官方只为 Claude 模型记录了 gateway 用法。
OpenClaw 以 codex-router/<router-slug> 发布已选择模型，并保留现有 Agent、频道、插件、其它供应商与已有默认模型。
Cursor Agent 保持全本地。零售版 Cursor App 会让 Cursor 后端代发 OpenAI BYOK 请求，无法访问 127.0.0.1；因此需要你控制域名上的稳定公网 HTTPS 地址，通常使用命名的 Cloudflare Tunnel。不要暴露主路由端口，专用 App 边缘只发布必要的模型与聊天接口。
T3 Code 与其它 Codex 包装器
T3 Code 通过适配器驱动官方编码 CLI。使用 Codex adapter 时，只需安装 codex 目标，完全退出并重新打开 T3 Code，再从选择器选择路由模型，不需要单独的 T3 target。其它启动官方 Codex CLI 并读取其模型目录的 GUI 也遵循同样的继承方式。
实验性订阅 Agent Bridge
Control Center 的 Harness 页面还能检测已有的 Claude Code、Cursor Agent 与 Gemini CLI 会话。这些 bridge 与路由模型选择器相互独立：它们调用已安装的官方客户端，不会复制或把 OAuth token 当 API 凭据复用。
./bin/model-router codex agents status
./bin/model-router codex agents probe anthropic
./bin/model-router codex agents probe cursor
./bin/model-router codex agents probe geminiBridge prompt 可能消耗所属客户端的订阅额度。目前实验性 bridge 尚不发布文件系统与终端能力；在具备前台审批界面前，权限请求会默认拒绝。
在非 Codex 客户端使用原生 GPT
外部客户端携带本地 caller key，而不是 ChatGPT 会话。若要把原生 GPT 发布给 DeepSeek Harness、Gemini CLI、OpenClaw 与未来客户端，请先通过 Codex 登录，再显式授权共享本地层一次：
codex login
./bin/model-router codex chatgpt-session enable运行 ./bin/model-router codex chatgpt-session disable 可撤销跨客户端授权；Codex 本身仍保持登录并保留原生模型。