Codex

Codex is compatible with the OpenAI protocol. Point the model provider at aicentos and you can use every model aicentos offers.

Two integration options are provided below: manage everything with CC Switch (recommended), or edit config.toml manually.

Option 1: Use CC Switch (recommended)Copy anchor link

CC Switch can also manage Codex's provider configuration, letting you switch between multiple setups in one click.

See Connect with CC Switch →

Option 2: Manual configurationCopy anchor link

PrerequisitesCopy anchor link

First create a dedicated key on the console's "API Keys" page; including codex in the name makes usage easier to track.

Set the API KeyCopy anchor link

Set the environment variable in your terminal:

export AICENTOS_API_KEY="sk-your-API-Key"

To persist it, add the line to ~/.zshrc or ~/.bashrc, then reload:

source ~/.zshrc

Confirm the variable is active:

echo $AICENTOS_API_KEY

Configure the Codex providerCopy anchor link

Edit ~/.codex/config.toml and add:

model = "your-model-name"
model_provider = "aicentos"

[model_providers.aicentos]
name = "aicentos"
base_url = "https://aicentos.com/v1"
env_key = "AICENTOS_API_KEY"
wire_api = "responses"

Replace your-model-name with a model name listed in the Model Gallery of the console; see Supported models.

Launch CodexCopy anchor link

codex

Send a simple request to confirm the provider works.

TroubleshootingCopy anchor link

When a request fails, compare Codex's terminal output with the usage logs in the console. Common causes:

• The model name is wrong (follow the Model Gallery).
• The Base URL format is wrong (fill in only up to /v1; do not add extra paths).
• The environment variable was not picked up by the current terminal (reopen the terminal or source the config file).