OpenAI Codex

Copy Markdown View Source

You can connect Tidewave Web directly to OpenAI Codex CLI by following the steps below:

  1. Install the codex CLI
  2. Authenticate with your OpenAI subscription
  3. Connect to Codex

Once setup, Tidewave will use your OpenAI subscription and settings (including MCP servers, subagents, etc). Note you can also use your OpenAI subscription with OpenCode.

Install the codex CLI

Follow OpenAI's official intructions to install the Codex CLI.

Authenticate with OpenAI

Once codex is installed, you must authenticate with your OpenAI subscription. You can do this by simply running codex in any directory and then following the described steps:

codex

Connect to Codex

Open up Tidewave Web settings, choose the Providers tab, choose "OpenAI Codex" and click "Connect".

Once connected, we will automatically configure Codex to also use Tidewave MCP. You may disable this option if (and only if) you have already customized Codex to use Tidewave MCP.

Custom codex-acp installation

Tidewave talks to Codex using the Claude Agent ACP project. It is possible to use a custom codex-acp executable by setting the TIDEWAVE_CODEX_ACP_EXECUTABLE environment variable, either in your running web application, or in the Tidewave App/CLI. This is rarely needed in practice but it may be required in some operating systems like NixOS.

Custom Providers

Codex comes with the ablity of running custom providers. This can be used to configure Ollama, OpenRouter, and other OpenAI compatible endpoints.

For example, to use Codex with OpenRouter, add the following to ~/.codex/config.toml:

model = "anthropic/claude-sonnet-4.5"
model_provider = "openrouter"

[model_providers.openrouter]
name = "Openrouter"
base_url = "https://openrouter.ai/api/v1"
http_headers = { "Authorization" = "Bearer sk-or-v1-..." }
wire_api = "chat"

FAQ

Using Tidewave Web with Codex emits "Authentication required"

This means you haven't authenticated in the codex CLI. Remember to run codex and, if Tidewave Web still claims you are not authenticated, restart the Tidewave App/CLI by clicking its menu bar icon (top-right on macOS and Linux, bottom-right on Windows) and selecting "Restart".