Codex CLI

Codex CLI is OpenAI's official command-line coding agent; model providers are defined in ~/.codex/config.toml. Point a custom provider at aicentos and the models aicentos offers become usable in the terminal.

If you prefer managing multiple configurations graphically, CC Switch offers one-click switching; this guide covers manual configuration only.

PrerequisitesCopy anchor link

First create a dedicated key for Codex CLI on the console's "API Keys" page (naming it codex-cli makes usage easier to track):

• Console: https://aicentos.com
• Create a key: https://aicentos.com/keys
• Top up when the balance runs out: https://aicentos.com/wallet

Confirm Codex CLI is installed:

codex --version

Configuration to fill inCopy anchor link

Setup stepsCopy anchor link

1. Set the API Key environment variableCopy anchor link

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

To persist it, add the line to ~/.zshrc or ~/.bashrc, source the file, and verify with echo $AICENTOS_API_KEY.

2. Edit config.tomlCopy anchor link

Add the following to ~/.codex/config.toml:

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.

3. Start CodexCopy anchor link

codex

Send a simple request to confirm the provider works.

TestCopy anchor link

codex exec "Answer in one sentence: what is 1+1?"

A normal response means the integration works. The response consumes a small amount of quota, which you can check in the console's usage logs.

NotesCopy anchor link

• Enter the Base URL only up to /v1 — do not extend it to the full /v1/chat/completions path.
• Fields such as base_url and env_key only take effect in the user-level ~/.codex/config.toml. A .codex/config.toml inside the project is ignored and may trigger a startup warning.
• Set wire_api to responses, which corresponds to aicentos' Responses API. The official documentation currently only supports this value; if your version reports unknown variant, the CLI is too old — upgrade first.
• openai, ollama and lmstudio are reserved provider IDs. You cannot repoint the built-in openai provider's base_url at a third-party gateway; you must create a new provider name (aicentos in this guide).
• Troubleshooting order: does the model name match the console → is the Base URL only up to /v1 → are the environment variables visible in the terminal that launched codex → is the account balance sufficient.

Related linksCopy anchor link

• Connect Codex (via CC Switch)