ShimX manages multiple upstream API providers and can take over Codex requests through a local reverse proxy. The proxy listens on 127.0.0.1:<port> only.

Each provider includes a name, Base URL, API Key, protocol, models, selected model, and weight. Supported upstream protocols are responses, chat, and messages.

When takeover is enabled, ShimX rewrites the current base_url in ~/.codex/config.toml to the local proxy URL. It saves snapshots of config.toml and auth.json before takeover.

Provider tools include latency tests, health status, failure counts, slow-response detection, reasoning effort overrides, tool keyword filters, and auto switching by failover or fastest provider.

Contributors: 挽风

Previous pageHow It Works

Next pageSession Management