Skip to content

Integration guide

Codex

Codex talks to providers over the OpenAI-compatible API. Register Relay as a model provider in config.toml and every request routes through your Relay balance.

Setup

  1. 1

    Create a Relay API key, then export it in your shell: export RELAY_API_KEY=sk-relay-your-key.

  2. 2

    Save the config below to ~/.codex/config.toml — it registers a relay provider on the OpenAI-compatible endpoint and selects the Responses wire API.

  3. 3

    Keep disable_response_storage = true (Relay forwards statelessly). Replace YOUR_MODEL_ID with a catalog model, then run codex.

Configuration

~/.codex/config.toml
model = "YOUR_MODEL_ID"
model_provider = "relay"
disable_response_storage = true

[model_providers.relay]
name = "Relay"
base_url = "https://proxystacks.com/v1"
env_key = "RELAY_API_KEY"
wire_api = "responses"

Save to ~/.codex/config.toml, then set the key in your shell: export RELAY_API_KEY=sk-relay-your-key. Codex uses the Responses API; Relay forwards statelessly, so keep disable_response_storage.

All docs