Codex Setup

Codex is OpenAI's official coding assistant CLI. model-go speaks the OpenAI API format, so you can connect it directly.

Prerequisites

• You have created an API token in model-go
• You have installed Node.js 18+ Environment Check

Install

macOS / Linux

npm install -g @openai/codex

Windows (run as Administrator)

npm install -g @openai/codex

Verify the installation:

codex --version

Configuration

Codex can read API settings from a config file.

macOS / Linux (~/.codex/config.toml)

model_provider = "model-go"
model = "replace with a model name from the Models page"

[model_providers.model-go]
name = "model-go"
base_url = "https://model-go.com/v1"
wire_api = "responses"
requires_openai_auth = true

Windows (%USERPROFILE%\.codex\config.toml)

# 1. Press Win+R, type %USERPROFILE%, and press Enter
# 2. Create the .codex folder
# 3. Create config.toml and auth.json inside that folder

model_provider = "model-go"
model = "replace with a model name from the Models page"

[model_providers.model-go]
name = "model-go"
base_url = "https://model-go.com/v1"
wire_api = "responses"
requires_openai_auth = true

You also need an auth.json file in the same directory as config.toml:

macOS / Linux (~/.codex/auth.json)

{
  "OPENAI_API_KEY": "your model-go token"
}

Windows (%USERPROFILE%\.codex\auth.json)

{
  "OPENAI_API_KEY": "your model-go token"
}

Creating the .codex folder on Windows

mkdir "%USERPROFILE%\.codex"

Configuration Notes

Setting	Purpose
base_url	model-go OpenAI-compatible endpoint: https://model-go.com/v1
OPENAI_API_KEY	The API token you created in model-go
model	The model name shown in the Models page

WARNING

Codex requires the /v1 suffix. Make sure you use https://model-go.com/v1, not https://model-go.com.

Launch

cd your-project-folder
codex

Common Issues

See the Codex FAQ.