Skip to main content
Codex uses @openai/codex-sdk. Config is written to ~/.codex/. You can also authorize reading local files you already have. Install the Codex SDK in Settings → SDK dependencies first. If the install is incomplete (CLI integrity is missing), the status stays uninstalled. Codex provider page

​
How to connect

​
Add a provider

Click Add provider and enter a name plus config JSON. The UI edits two blocks:
  • config: model_provider, model, model_providers, and similar
  • auth: auth fields such as OPENAI_API_KEY
You can also pick official OpenAI direct access, or a third-party / proxy preset. Official direct access uses https://api.openai.com. Saving writes to ~/.codex/ immediately.

​
Authorize local config

If you already use the Codex CLI in a terminal:
  1. Run codex login in a terminal and confirm you can ask a question
  2. In CC GUI, authorize reading ~/.codex/config.toml and auth.json
  3. Restart the IDE
Authorization is read-only and does not overwrite those two files. You can revoke it at any time.

​
Custom models and environment variables

Each Codex provider can add models:
  • Model ID is required
  • Display name and description are optional
  • You can set a context window separately (unit: K tokens)
You can also add environment variables for the chat process and the MCP tool-discovery process separately. Built-in protected variables cannot be overridden.

​
Differences from Claude

​
Usage stats

After you add input / output / cache prices on a model, Settings → Usage stats can estimate cost.

​
Next steps