Skip to main content
Connecting Codex CLI to BetterToken only requires configuring base_url and API Key. No BetterToken-specific model name is needed — the default Codex model works out of the box.

​
Prerequisites

Clear any conflicting environment variables before configuring:
unset OPENAI_API_KEY
unset OPENAI_BASE_URL

​
Install Codex CLI

npm install -g @openai/codex

​
Setup

1

Edit the Codex config file

Config file location: ~/.codex/config.toml (create if it doesn’t exist)Add the following (replace YOUR_API_KEY with your BetterToken API Key):
[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.com/v1"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000

[profiles.bt]
model = "codex-mini-latest"
model_provider = "bettertoken"
2

Set the environment variable

export BETTERTOKEN_API_KEY="YOUR_API_KEY"
To persist this across sessions, add the line to ~/.zshrc or ~/.bashrc.
3

Start Codex CLI

codex --profile bt

​
Verify

Send a test message after startup. A normal response confirms the connection is working. If you encounter issues, check that base_url is set to https://www.bettertoken.com/v1 and that BETTERTOKEN_API_KEY is exported.