Use Gradiated with Codex

Add Gradiated as a separate Codex profile. Your current provider and default model stay unchanged.

Set up automatically

Run the Gradiated wizard:

npx -y @gradiated/wizard --agent codex

The wizard adds a Gradiated provider and a gradiated profile. It stores the key outside the Codex configuration and preserves your default profile.

Start Codex with the Gradiated profile:

codex --profile gradiated

Set your Gradiated API key in the shell that starts Codex:

export GRADIATED_API_KEY="grad_..."

Add this block to ~/.codex/config.toml:

[model_providers.gradiated]
name = "Gradiated"
base_url = "https://api.gradiated.com/v1"
env_key = "GRADIATED_API_KEY"
wire_api = "responses"

Keep this provider in the user configuration. A project-level file can affect everyone who opens the repository.

Create ~/.codex/gradiated.config.toml:

model_provider = "gradiated"
model = "YOUR_MODEL_ID"

Replace YOUR_MODEL_ID with an ID from models and pricing.

Start Codex with this profile:

codex --profile gradiated

Add -m YOUR_MODEL_ID to select another Gradiated model for one run.

Check that GRADIATED_API_KEY is set in the shell that starts Codex.
Check that the provider base URL is https://api.gradiated.com/v1.
Check that the model ID matches the Gradiated catalog.
Use codex exec --profile gradiated --strict-config to find configuration errors.
Check that the workspace has billing capacity.

Run the uninstall command:

npx -y @gradiated/wizard uninstall

Select Codex. The wizard removes the provider, profile, and stored credential. It keeps timestamped backups and does not change your default profile.