Codex

Codex is OpenAI’s open-source local coding agent and desktop application. You can connect it to Routeway by defining a custom provider in your config file and using your Routeway API key.

Requires a valid Routeway API key. Get yours from the dashboard.

Setup

Install Codex

Follow the official installation instructions for your platform. Both the CLI and desktop app use the same settings file.

Configure Codex to use Routeway

Open (or create) ~/.codex/config.toml and add a custom provider pointing to Routeway:

model_provider = "routeway"
model_reasoning_effort = "high"
model = "o4-mini"

[model_providers.routeway]
name = "routeway"
base_url = "https://api.routeway.ai/v1"
env_key = "ROUTEWAY_API_KEY"

o4-mini is one example starter model. You can use any model that supports tools — browse available options at routeway.ai/models.

Set your API key

Codex reads the API key from the environment variable named in env_key.

export ROUTEWAY_API_KEY="YOUR_ROUTEWAY_API_KEY"

$env:ROUTEWAY_API_KEY="YOUR_ROUTEWAY_API_KEY"

Keep real API keys out of version control and shell history.

Start Codex

In your project directory, run:

codex

Your requests will be sent through Routeway using the provider defined in config.toml.

Reference

Setting	Value
Config file	`~/.codex/config.toml`
Base URL	`https://api.routeway.ai/v1`
API key env var	`ROUTEWAY_API_KEY`
Example model	`o4-mini`

Example Prompts

Try these once you’re connected:

“Summarize this repository: structure, build system, and entry points.”
“Find where feature X is implemented and list the relevant files.”
“Run tests and fix the first failing test.”
“Refactor module Y and update all call sites.”

Overview

Agents

Chat UIs

Roleplay Platforms

Other

Setup

Reference

Example Prompts

​Setup

​Reference

​Example Prompts

Setup

Reference

Example Prompts