Skip to content

Setting up ChatGPT / Codex Desktop

Codex Desktop uses the same connection configuration as the local Codex clients. Create a separate Nexus profile so the default connection remains unchanged.

Nexus profile

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

model = "MODEL_FROM_V1_MODELS"
model_provider = "nexus"

[model_providers.nexus]
name = "Nexus"
base_url = "https://api.nexus-hub.ru/v1"
env_key = "NEXUS_API_KEY"
wire_api = "responses"

Set the key in the environment before starting the application:

export NEXUS_API_KEY="your_nexus_key"

Select the nexus profile in Codex Desktop. If the profile is selected at startup, use --profile nexus. Set model to an exact identifier returned by GET /v1/models.

Required values

  • base URL: https://api.nexus-hub.ru/v1;
  • protocol: OpenAI Responses;
  • route: POST /v1/responses;
  • key: the NEXUS_API_KEY environment variable.

Do not store the Nexus API key directly in config.toml.

Official reference: Codex configuration reference.