Codex CLI

When to use this page

Use this page for a local command-line coding agent that supports an OpenAI-compatible base URL.

Environment variables

export QUOTAFLOW_API_KEY="qf_your_key_here"
export OPENAI_API_KEY="$QUOTAFLOW_API_KEY"
export OPENAI_BASE_URL="https://api.quotaflow.ai/openai/v1"

Some clients use OPENAI_BASE_URL; others use OPENAI_API_BASE, OPENAI_HOST, or a config file. Use the variable your client supports.

Smoke test

curl "$OPENAI_BASE_URL/models" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Agent session guidance

If your client supports custom headers, set a stable x-session-id per workspace or task. If it supports prompt_cache_key, use a stable value per repository or long-running task.

Failure handling

Retry transient 429 with backoff.
Retry 503 and network timeouts.
Do not retry invalid API key errors without rotating the key.

AI agents: start at /llms.txt, fetch /llms-full.txt for full context, and parse /openapi.yaml for endpoint schemas.