Start typing to search the documentation.

Console navigation

Codex

Codex speaks the OpenAI Responses API. Point it at Console and use any paid or Go model, including Claude, Gemini, and open models. Console translates the request for models that don’t accept Responses.

Configure

Add Console as a model provider in ~/.codex/config.toml and make it the default.

~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "opencode"

[model_providers.opencode]
name = "OpenCode Console"
base_url = "https://opencode.ai/inference/openai/v1"
env_key = "OPENCODE_API_KEY"
wire_api = "responses"

Codex appends /responses to the base URL and reads the key from env_key. Create a personal API key, then export it.

export OPENCODE_API_KEY="oc_sk_..."
codex

Go

Use the Go base URL and a key from a workspace with a Go subscription.

~/.codex/config.toml
model = "kimi-k3"
model_provider = "opencode-go"

[model_providers.opencode-go]
name = "OpenCode Go"
base_url = "https://opencode.ai/inference/go/openai/v1"
env_key = "OPENCODE_API_KEY"
wire_api = "responses"

Models

Set model to any model ID from the Console or Go table. Override it for one run with --model.

codex --model claude-sonnet-5-5

Codex doesn’t know the context window or reasoning settings of models outside its own catalog. It uses generic defaults for them and prints a warning, which you can ignore.

Profiles

Keep pay-as-you-go and Go side by side with a profile. Define both providers in ~/.codex/config.toml, then add a profile file that switches to Go.

~/.codex/go.config.toml
model = "kimi-k3"
model_provider = "opencode-go"
codex --profile go

Console MCP

Add the Console MCP server and sign in from the browser.

codex mcp add opencode-console --url https://opencode.ai/console/mcp

If the sign-in doesn’t start automatically, run it yourself.

codex mcp login opencode-console