Skip to main content
The Nito Plugin adds $nito: commands alongside Codex’s own model. Manual routing selects a model through Nito for Codex’s ordinary requests.

Configuration

Codex speaks the Responses API, which Nito serves as a stateless shim at /v1/responses. Add a provider to your user-level ~/.codex/config.toml and select it. Codex does not load provider definitions from a project’s .codex/config.toml.
wire_api = "responses" is the protocol Codex uses for custom providers. base_url ends in /v1, and Codex appends /responses. env_key names an environment variable; it does not contain the key. Choose a model available to your account from the catalog. A listed :confidential variant selects Confidential inference. Encrypted inference requires Nito’s Chat Completions encryption protocol and is unavailable through this Responses route. The top-level model_provider and model lines make Nito your default. For occasional Nito sessions, keep only [model_providers.nito] in the user-level file and launch with:
Codex’s configuration precedence lets this command override your usual model and provider for one session.

Check the route

Start a new Codex session from the shell that exports NITO_API_KEY. Ask for a one-sentence reply, then try a small file task that calls a function tool. A 401 points to a missing or invalid Nito key; a 404 points to the base URL or model ID. If a later turn fails after a successful first turn, check whether the client tried stored-response fields: Nito’s Responses endpoint is stateless and rejects previous_response_id and store: true. OpenAI’s Codex configuration reference documents user-level provider definitions, base_url, env_key, and the Responses wire format.

What This Route Supports

String and message-array input with text, image, and request-local file parts; function tools, Codex function namespaces, and custom tools; the web_search tool, which maps to Nito’s web search; reasoning.effort and reasoning.summary; streaming. Not supported: store: true, previous_response_id, response retrieve, cancel, and delete, background mode, provider-hosted file_id inputs, computer-use, MCP, and file-search built-in tools, and the Chat Completions model feature suffixes.

Responses Endpoint

What the shim accepts.

OpenAI SDK Drop-in

The same key from code.

Claude Code

Manual routing through the Messages endpoint.