Codex

Codex is a desktop AI programming agent developed by OpenAI that supports connecting to third-party model providers through configuration files. Its configuration method is the same as Codex CLI.

Prerequisites

• You have activated a TCB environment and obtained the environment ID cloudBaseEnvID
• Enable the required model in the AI console
• Obtain the Base URL and API Key in the AI console

Base URLhttps://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase

Configuration Steps

Codex shares the same config.toml configuration file with Codex CLI.

Configuration field reference

Field	Description
model	Model ID, copy the enabled model identifier from the AI Console model list
model_provider	Provider ID, pointing to the custom [model_providers] configuration
base_url	Model Base URL, obtained from the AI Console
experimental_bearer_token	API Key for calling the model, obtained from the AI Console

Configuration via CC Switch

CC Switch is an open-source desktop application for centrally managing provider configurations for multiple AI coding tools. For installation instructions, refer to the CC Switch configuration guide.

1. Open CC Switch and add CloudBase as a provider

Field	Description
API Key	Obtained from the AI console
Base URL	https://{{cloudBaseEnvID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
API Format	Chat Completions (requires local routing)

2. Enable local route mapping in advanced options and enter the model ID

3. Switch to the CloudBase provider and restart Codex

Configuration File

1. Open or create the configuration file

note

If browsing for the file, your file browser may hide files starting with ".". You may need to enable showing hidden files.

On Mac, use Finder shortcut Command + Shift + .. On Windows, check "File Explorer - View - Show - Hidden items".

• Mac/Linux path

~/.codex/config.toml

• Windows path

C:\Users\<your-username>\.codex\config.toml

2. Add or modify the following configuration

model = "hy3"
model_provider = "cloudbase"

[model_providers.cloudbase]
name = "CloudBase"
base_url = "https://{{cloudBase-env-ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase"
experimental_bearer_token = "eyJhbGciOiJSUzI1N..."

3. Restart Codex

After configuration is complete, restart Codex to start using CloudBase models for programming conversations.

Troubleshooting

Error	Solution
404 model not found	Base URL is incorrect, please copy the correct Base URL from the AI Console
401 Credentials are invalid	API Key is incorrect or may have been deleted
429 Token usage exceeded quota limit	Model name is incorrect, or the model is not enabled in the AI Console
Model not responding	Verify the model name is correct and the model is enabled in the console