Codex overview

When to use this page

Use this page when connecting a coding agent, local CLI, desktop agent, or CI agent to Quotaflow.

Recommended settings

• Base URL: https://api.quotaflow.ai/openai/v1
• API key environment variable: QUOTAFLOW_API_KEY
• Preferred endpoint: /responses
• Preferred session signal: x-session-id or prompt_cache_key
• Streaming: enabled for interactive agents

Local connector path

For Codex, Claude Code, Cursor, OpenCode, or another local coding agent, prefer the Local Connector flow:

qf doctor
qf link --workspace acme --workspace-type company --project backend
qf run -- codex

Use Personal vs Team usage to choose the right workspace and Routing policy to understand fallback rules.

Personal provider refresh tokens and ~/.codex/auth.json should stay local and should not be uploaded to Quotaflow cloud.

Why session ids matter

Quotaflow uses stable session signals to maintain continuity for related agent calls. This helps with cache locality and keeps retries predictable.

Capacity behavior

Quotaflow applies dynamic capacity protection. When temporary capacity is limited, requests may be queued briefly or return retry-safe errors such as 429 or 503.