OpenAI Codex CLI Setup Guide

Overview

Codex CLI is OpenAI's terminal coding agent. It reads, writes, and runs code through sandboxed, reviewable patches. Point its custom provider at dabboUno's base URL to use any model in the catalog.

Quick Config

Paste these into the client. Your key auto-fills when signed in.

Base URL: https://newapi.c.dabbo.net/v1
API Key: YOUR_API_KEY

Compatibility

Step-by-step setup

1. 1
   Install Codex CLI

   Install Codex CLI globally with npm.

   bash

   npm install -g @openai/codex

   Sign in to auto-fill your API key

2. 2
   Configure the model provider

   Edit `~/.codex/config.toml`. Set your model id and add a custom provider with dabboUno's base URL using the responses wire API.

   toml

   # ~/.codex/config.toml
   model = "YOUR_MODEL_ID"
   model_provider = "unorouter"
   
   [model_providers.unorouter]
   name = "UnoRouter"
   base_url = "https://newapi.c.dabbo.net/v1"
   wire_api = "responses"
   env_key = "OPENAI_API_KEY"

   Sign in to auto-fill your API key

3. 3
   Export your API key

   Export the variable named by env_key. Codex reads a custom provider's key from the environment; auth.json is only for signing in to OpenAI.

   bash

   export OPENAI_API_KEY="YOUR_API_KEY"

   Sign in to auto-fill your API key

4. 4
   Start Codex

   Run `codex` in your project directory.

   bash

   codex

   Sign in to auto-fill your API key

$env:OPENAI_BASE_URL="https://newapi.c.dabbo.net/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

Recommended models

Free models that work here. Paste any model id into the client.

Gotchas

• !On an unsupported endpoint error, confirm `wire_api` is `responses` and the base URL ends in `/v1`.
• !If requests are unauthenticated, check that env_key names a variable that is actually exported in the shell running codex.
• !You cannot reuse the reserved id openai for a custom provider. Any other id works, in the model_providers section and model_provider alike.