Codex CLI | AI Gateway - Orq.ai Documentation

Route every model call Codex CLI makes through the Orq.ai AI Gateway by editing ~/.codex/config.toml. Requests appear in Traces automatically.

Prerequisites

Codex CLI installed
Active Orq.ai account with AI Gateway access
Orq.ai API key
Model enabled in AI Gateway → Supported Models

Setup

Export the API key

export ORQ_API_KEY="<your-orq-api-key>"

Replace <your-orq-api-key> with an API key. This sets the variable for the current shell session. To persist it across sessions, add the line to ~/.zshrc or ~/.bashrc.

Create or edit ~/.codex/config.toml

Create ~/.codex/config.toml if it does not exist. Add or merge the following keys. The top-level model and model_provider lines set the default; the [model_providers.orq] block registers the custom provider:

model = "openai/gpt-5.4"
model_provider = "orq"

[model_providers.orq]
name = "Orq AI Gateway"
base_url = "https://api.orq.ai/v3/router"
env_key = "ORQ_API_KEY"
wire_api = "responses"

Replace openai/gpt-5.4 with the provider-prefixed model to use by default (e.g. anthropic/claude-sonnet-4-6). If a model key already exists in the file, replace it.

Do not name the provider openai. That identifier is reserved and hardcoded to api.openai.com. Setting base_url has no effect on it.

Run Codex

codex

Running codex without flags routes all calls through the AI Gateway using the model configured in ~/.codex/config.toml.Pass --model to override the model for a single invocation:

codex --model anthropic/claude-sonnet-4-6

Configuration Reference

Field	Value	Description
`model`	`provider/model-id`	Default model. Must use provider-prefixed format.
`model_provider`	`orq`	Selects the custom provider defined below.
`base_url`	`https://api.orq.ai/v3/router`	AI Gateway router endpoint.
`env_key`	`ORQ_API_KEY`	Environment variable that holds the API key.
`wire_api`	`responses`	Wire protocol. Codex uses the Responses API.

Troubleshooting

Authentication error

Confirm ORQ_API_KEY is exported in the shell running Codex. Run echo $ORQ_API_KEY to verify the value is set.

Model not found

The model must be enabled in AI Gateway → Supported Models before Codex can route to it. Check that the model ID in config.toml uses the provider-prefixed format (e.g. openai/gpt-5.4, not gpt-4o).

No Traces appearing in Orq.ai

Confirm base_url is https://api.orq.ai/v3/router and model_provider is set to the custom provider name (e.g. orq), not openai.

Auto-review requests fail

With approvals_reviewer = "auto_review" in ~/.codex/config.toml, Codex sends its internal model name codex-auto-review for automatic approval reviews. The AI Gateway resolves this name to openai/gpt-5.3-codex, so that model must be enabled in AI Gateway → Supported Models. To keep approval prompts interactive instead, set approvals_reviewer = "user" (the default).

Verification

Send a prompt in Codex. The response appears in the terminal and the trace appears in Orq.ai Traces with the model identifier (e.g. openai/gpt-5.4).

AI Providers

Coding Assistants

Frameworks

Automations

Codex CLI | AI Gateway

Prerequisites

Setup

Configuration Reference

Troubleshooting

Verification

​Prerequisites

​Setup

​Configuration Reference

​Troubleshooting

​Verification

Prerequisites

Setup

Configuration Reference

Troubleshooting

Verification