Codex CLI

Scope

For Codex CLI, local scripts, and workflows that support a custom OpenAI-compatible model provider.

Configuration notes

[model_providers.zltokens]
name = "zltokens"
base_url = "https://www.zltokens.com/v1"
env_key = "ZLTOKENS_API_KEY"

model_provider = "zltokens"
model = "PUBLIC_MODEL_NAME"

• Store the API Key in an environment variable, not in the repository.
• Automation should use separate low-quota Keys for limits, attribution, and quick shutdown.

Verification

• Send a short text with images, files, and long context disabled.
• When checking pricing, Tidal Tokens, or channel issues, start from request_id, model, tokens, channel, and error body.

Verification and limits

• The config file is ~/.codex/config.toml; on Windows it is normally %USERPROFILE%\.codex\config.toml.
• Complete one minimal task and confirm the model, status, and /v1/responses request in usage logs. Do not claim unverified model or tool capability.