Skip to main content
supakook.DOCS

Sign-in is not available yet.

The account center is not connected yet. For existing orders, use your original purchase channel to find account and delivery details.

Read the user guide

Codex GUI/CLI setup

GUI installation​

Install the desktop app that includes Codex.

Windows provides an official installer and also supports installation from the Microsoft Store with winget. Either method works.

Download the official Windows installer ↗

Install with winget

Open PowerShell and run the official installation command below:

PowerShell
winget install --id 9PLM9XGG6VKS -s msstore

After installation, open ChatGPT from the Start menu and sign in.

CLI installation​

Choose your operating system to install the terminal client.

Choose one method to install Codex CLI in PowerShell.

Use curl to download and run the official Windows installer. Node.js is not required.

PowerShell
$codexInstaller = curl.exe -fsSL https://chatgpt.com/codex/install.ps1
if ($LASTEXITCODE -eq 0) {
  Invoke-Expression ($codexInstaller -join [Environment]::NewLine)
}
Don’t have curl? Install curl

Recent Windows 10 versions and Windows 11 normally include curl. Check first:

curl.exe --version

If the command is not found, download the archive for your system architecture from the official site. Extract it, add its bin directory to your user Path environment variable, then reopen PowerShell.

Download curl for Windows ↗
Install with Chocolatey

If Chocolatey is installed, open PowerShell as administrator and run:

PowerShell
choco install curl -y

No Chocolatey? Official installation guide ↗

Reopen PowerShell after installation. Choose only one installation method.

After installation, reopen PowerShell and check the Codex version:

cmd /c codex --version

For WSL, select Linux and install, configure, and run Codex inside WSL.

A version number confirms installation. Use the same installation method when updating to avoid conflicting versions.

Connect to Supakook​

The GUI and CLI use the same configuration. Prepare your Supakook API key and configure it once.

Find the .codex folder in your user home directory and edit config.toml. If the folder does not exist, create it with the PowerShell commands below.

User configuration file: .codex\config.toml

PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

Add the following configuration to config.toml and save it.

config.toml
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.supakook.com/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

Create auth.json in the same .codex folder, enter your API key, and save it.

.codex\auth.json

PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\auth.json"
auth.json
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

You can also use CC Switch. If you set CODEX_HOME, use that directory. WSL and native Windows use separate user directories.

Restart and verify​

GUI​

Fully quit and reopen the app if it is running. Open Codex and a project, then send “Hello” to check the basic connection.

CLI​

Exit any running CLI session, then run this in your project folder:

codex

Windows PowerShell can also use:

cmd /c codex

Send “Hello”. This configuration uses the OpenAI provider and gpt-5.5 model.

Troubleshooting​

  • Command not found: reopen the terminal and check PATH.
  • Missing key: check OPENAI_API_KEY in .codex/auth.json.
  • 401/403: check your key, balance, and model permissions.
  • 404: check the Base URL, Responses support, and model name.
  • Settings ignored: check CODEX_HOME, project settings, and launch arguments.

Official desktop guide · Official CLI guide · Authentication