Skip to content
Console docs

Codex

Contents

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.

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.

Terminal
export OPENCODE_API_KEY="oc_sk_..."
codex

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"

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

Terminal
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.

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"
Terminal
codex --profile go

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

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

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

Terminal
codex mcp login opencode-console