供应商与本地代理
约 307 字大约 1 分钟
ShimX 可以管理多个上游 API 供应商，并通过本机反向代理接管 Codex 请求。代理默认监听 127.0.0.1:<port>，不会对外网开放服务。
供应商配置
每个供应商包含名称、Base URL、API Key、协议、模型列表、选中模型和权重。ShimX 支持三类上游协议：
responseschatmessages
代理会把 Codex 的 Responses 请求转换到对应上游协议。
接管 Codex
开启接管后，ShimX 会把 Codex ~/.codex/config.toml 当前 base_url 改成本地代理地址。接管前会保存 config.toml 和 auth.json 快照，用于处理官方登录切换导致配置被擦写的情况。
健康检查与自动切换
供应商页支持测速、健康状态、失败统计、慢响应检测、模型 reasoning effort 覆盖和工具过滤关键词。自动切换策略包括：
- 手动
- 故障转移
- 最快优先
切换范围支持同类型、同协议或任意范围，并可配置失败阈值、冷却时间、后台测速周期、慢响应阈值和同家模型 fallback。