How to Integrate CCAPI into Codex CLI

This guide helps you connect OpenAI Codex CLI to CCAPI, allowing you to use OpenAI models at a lower price.

Codex CLI is OpenAI's open-source AI coding CLI tool, supporting code generation, debugging, shell operations, file management, and more.

Prerequisites

Codex CLI installed — npm install -g @openai/codex

CCAPI account — sign up at ccapi.ai (Google login supported)

CCAPI token — create one at Console > Tokens

Step 1: Get Your CCAPI Token

Go to ccapi.ai and sign up / log in

Navigate to Console > Tokens

Click Create Token, copy the key (shown only once)

Step 2: Configure Codex CLI

Method A: Environment Variables (Quickest)

Set one environment variable to point Codex to CCAPI:

Add to ~/.bashrc or ~/.zshrc and restart your terminal.

Method B: Config File (Recommended)

Edit ~/.codex/config.toml:

model = "gpt-4o"
model_provider = "ccapi"

[model_providers.ccapi]
name = "CCAPI Gateway"
base_url = "https://api.ccapi.ai/v1"
env_key = "CCAPI_API_KEY"
wire_api = "responses"

Then set the environment variable:

Step 3: Choose a Model

CCAPI supports the following OpenAI models at as low as 10% of official pricing:

Model	Description
`gpt-4o`	Multimodal flagship, proven quality
`gpt-4.1`	1M context window
`gpt-5-mini`	GPT-5 family, balanced
`gpt-5-nano`	Ultra-low cost
`gpt-4o-mini`	Best value
`gpt-5.4`	Latest and strongest

Switch models:

For the full model list and real-time pricing, visit Model Market.

Step 4: Verify

If it responds normally, the setup is complete. You can check call logs at Console > Logs.

Troubleshooting

Problem	Solution
Connection timeout	Confirm `OPENAI_BASE_URL` is set to `https://api.ccapi.ai/v1` (note the `/v1`)
Invalid token	Check token status at Console
Insufficient balance	Top up at Console > Top Up
Model not found	Check model name spelling. View available models at Model Market

Quick Reference

Base URL: https://api.ccapi.ai/v1

Auth env var: OPENAI_API_KEY or custom env_key

Config file: ~/.codex/config.toml

Model Market: ccapi.ai/pricing

Console: ccapi.ai/console

codex cli integration

How to Integrate CCAPI into Codex CLI#

Prerequisites#

Step 1: Get Your CCAPI Token#

Step 2: Configure Codex CLI#

Method A: Environment Variables (Quickest)#

Method B: Config File (Recommended)#

Step 3: Choose a Model#

Step 4: Verify#

Troubleshooting#

Quick Reference#