NeonAPI Docs
Connect your tools

Codex

Practical guidance for using NeonAPI.

Before you connect

Install Codex using official instructions. Choose a model supporting the Responses endpoint and set a dedicated gateway key in your shell.

export NEON_API_KEY="YOUR_API_KEY"

Configure the provider

Merge this into ~/.codex/config.toml; preserve any unrelated existing settings.

model_provider = "neon_gateway"
model = "YOUR_RESPONSES_MODEL_ID"

[model_providers.neon_gateway]
name = "NeonAPI"
base_url = "https://neon-api.com/v1"
env_key = "NEON_API_KEY"
wire_api = "responses"

Restart Codex from a shell that has NEON_API_KEY set. Select the exact published model ID; do not enter an API key into the TOML snippet above.

Check compatibility

An endpoint-compatible model is required; model names alone do not guarantee client-specific features. If a request fails, inspect the redacted error and test the Responses endpoint independently.

Official configuration reference