Codex Router进阶配置清单curate-models、API Key池与自定义端点的10种用法【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-routerCodex Router 进阶配置的核心是三个能力用curate-models命令把上游最新模型拉进选择器、用 API Key 池key-pool让多把密钥自动轮换、用自定义端点把请求指到你自己的网关。本文面向新手列出 10 种最常用玩法全部只读操作、不动仓库文件配好凭据后在本地终端执行即可。仪表盘会显示路由服务健康状态、近 24 小时流量和配额余量是做完任何进阶配置后的第一检查点。一、curate-models把上游模型「策展」进选择器 1. 交互式拉取注册表之外的新模型仓库自带的config/目录登记了经过验证的模型但厂商经常发新模型。curate-models会实时读取上游目录把注册表里还没有的模型列出来让你逐个勾选后保存为本地「用户模型」——它绝不会改动仓库内受检的注册表。./bin/curate-models opencode-zen # 列出该提供方实时目录中可勾选的模型Homebrew 安装则用等价的codex-router curate-models provider。勾选结果只写在本机状态目录详见 src/curate-models.mjs。2. 一键导入全部免费模型部分网关如 OrcaRouter提供免费模型目录。加--free-only --apply可以把当前所有免费模型一次性拉入之后目录更新时重跑一遍即可./bin/curate-models orca --free-only --apply3. 用--dry-run预演用--remove清理旧模型--dry-run只打印将要发生的变更不写任何文件适合先看再动手。--remove model-id把之前策展进来的模型从选择器中移除。--refresh/--static控制读取实时目录还是使用缓存快照。⚠️ 注意--no-apply不是预演它会落盘但只推迟发布真正安全的预演是--dry-run。4. 用--efforts调整策展模型的推理档位策展模型可以附带 Codex 的推理阶梯minimal 到 ultra。只勾选上游确实支持的档位避免 400 或被静默重映射./bin/curate-models groq --efforts low,medium,high各档位含义定义在 src/curate-models.mjs例如high对应 Deep reasoning、xhigh对应 Extended reasoning。二、API Key 池多把密钥自动轮换 5. 用add-env导入密钥不落盘、不复制同一提供方有 Go 订阅和 Zen 按量两个端点时可以把两个环境变量分别加入密钥池路由在转发时按池选择密钥原始密钥不会被复制进池文件或凭据元数据codex-router key-pool opencode-go add-env OPENCODE_API_KEY codex-router key-pool opencode-go add-env OPENCODE_GO_API_KEY codex-router key-pool opencode-go status密钥永远在交互式 shell 里导出不要写进命令行参数或聊天里。池建立后即成为权威来源空池或无效池会「失败关闭」而不会偷偷退回单把旧密钥。6. 三种轮换策略round-robin / quota / fill-first用policy子命令切换策略见 src/provider-api-key-pool.mjs策略适合场景round-robin多把密钥均摊流量最常用quota有明确额度上限的密钥按余量分配fill-first先把一把用尽再换下一把codex-router key-pool opencode-go policy round-robin请求返回前遇到 401/403/408/429 时池会自动重绑到下一把健康密钥一旦响应头开始输出就不再切换保证流式输出不被打断。7.pause/resume临时停用一把密钥某把密钥额度告急或需要人工检查时无需删除codex-router key-pool opencode-go pause credential-id codex-router key-pool opencode-go resume credential-id停用的凭据元数据保留恢复即继续参与轮换。三、自定义端点把请求指向你自己的网关 8. custom 提供方每个模型自带端点config/custom/内置了一个openai-compatible类型的 custom 提供方authMode为per-model——每一行模型各自命名自己的 endpoint启用它本身不花钱需要密钥的模型会在自己的行上明确提示。结构见 config/custom/custom.json。适合自建 vLLM、LiteLLM 代理或内网推理服务。9. 用baseUrlEnv覆盖任意提供方的端点每个提供方的 base URL 都可通过其环境变量重定向这样区域端点和自托管网关可以复用同一提供方条目例如OPENCODE_GO_BASE_URL/OPENCODE_ZEN_BASE_URLopencode 家族QWEN_PLAN_BASE_URLQwen 订阅计划META_BASE_URLMeta Model APIMODEL_ROUTER_LMSTUDIO_BASE_URLLM Studio 本地服务只需在导出变量的 shell 里重跑安装器--providers configured让后台服务继承新值即可详见 docs/LOCAL-MODELS.md。四、收尾验证与可视化 10. 用test-model验证在控制中心管理./bin/test-model orca/MODEL_ID --live --yes先真实请求验证再用于工具驱动的任务。之后在 Control Center 的Models页勾选/取消勾选模型、在Dashboard页确认路由健康全程可视化操作详见 docs-site/qa/control-center-gallery.png 的界面画廊进阶配置速查表 需求命令 / 配置拉取上游新模型./bin/curate-models provider导入全部免费模型./bin/curate-models orca --free-only --apply安全预演--dry-run调整推理档位--efforts low,medium,high多密钥轮换key-pool provider add-envpolicy round-robin临时停用密钥key-pool provider pause id每模型独立端点config/custom/的 custom 提供方覆盖默认端点对应*_BASE_URL环境变量验证单个模型./bin/test-model id --live --yes更多背景见 README.md 的 Models and authentication 一节与 docs/DEVELOPMENT.md。记住三条安全原则密钥只进隐藏终端提示、池空即失败关闭、改完重启客户端Codex Router 的进阶配置就只属于你本机凭据始终留在你的电脑上。【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考