Integrations

Codex

Connect Codex Terminal and Desktop to your workspace with your company's provider account.

Connect your account

Connect your company's OpenAI, OpenRouter, Azure, or Bedrock account. This path uses provider API billing. Sovereign checks the account and lists the compatible models it can use through OpenAI Responses.

Choose a model and enter the user or application name. Press Create user setup. The provider key stays on the server. The generated gateway credential belongs to that user.

Set up Codex

Run the generated install command on the user's Mac or Linux machine. It adds Sovereign to ~/.codex/config.toml, or the directory named by CODEX_HOME, and sets the chosen model. Existing comments and other configuration remain in place. A private backup is saved before the first change.

Restart Codex Desktop, or start codex from Terminal. The connection uses HTTP Responses. The Connect page also provides a manual TOML configuration for other environments.

The local config holds the user's gateway credential with owner-only file permissions. Your provider API key stays in the workspace on the server.

Check the connection

Ask Codex to reply with OK. Open Sessions in your workspace to see the request, model, tokens, and routing status.

Create a separate setup for each user. You can use the same company provider account for all of them.