Codex Setup

Windows

System requirements

• Windows 10 or 11
• Node.js 22+
• npm 10+
• Network access

Install

Prerequisites Install Git Bash from Git - Downloads for your OS and click Next until finished.

1. Install Node.js Visit nodejs.org and install the latest LTS.

2. Install Codex In CMD or PowerShell:

npm install -g @openai/codex

3. Verify

codex --version

Configure API

1. Get an Auth Token

On 在线文档:

• Open Console → API Tokens
• Click Add token
• Group: Codex exclusive (required)
• Name: anything
• Quota: unlimited
• Other options: defaults

2. Config files

Important: Replace sk-xxx below with your real API key from 4zapi.com!

1. Open .codex under your user profile, e.g. C:\Users\testuser\.codex. (Note: enable Show hidden items in File Explorer if needed.)

2. If .codex is missing, create it, then create config.toml and auth.json.

3. Fill in the config (replace sk-xxx with your real SK).

   a. auth.json:

   {"OPENAI_API_KEY": "sk-xxx"}
   

   b. config.toml (model_reasoning_effort = high / medium / low):

   model_provider = "api111"
   model = "gpt-5.6-sol"
   model_reasoning_effort = "high"
   disable_response_storage = true
   preferred_auth_method = "apikey"
   
   [model_providers.api111]
   name = "api111"
   base_url = "https://4zapi.com/v1"
   wire_api = "responses"
   requires_openai_auth = true
   

Start Codex

Restart the terminal, then:

cd your-project-folder

codex

VS Code extension

Search and install codex in the VS Code marketplace.

It appears in the sidebar after install.

macOS

System requirements

• macOS 12+
• Node.js 22+
• npm 10+
• Network access

Install

1. Install Node.js

• Option A: Download LTS from nodejs.org
• Option B: Homebrew (recommended)

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  
  brew install node
  

2. Install Codex In Terminal (may need sudo):

npm install -g @openai/codex

3. Verify

codex --version

Configure API

1. Get an Auth Token On 在线文档:

• Open Console → API Tokens
• Click Add token
• Group: Codex special (required)
• Name: anything
• Quota: unlimited
• Other options: defaults

2. Config files

Important: Replace sk-xxx with your real API key from 4zapi.com!

1. Create files:

   mkdir -p ~/.codex
   touch ~/.codex/auth.json
   touch ~/.codex/config.toml
   

2. Edit auth.json:

   vi ~/.codex/auth.json
   

   Press i, paste (replace sk-xxx), then ESC, :wq, Enter.

   {"OPENAI_API_KEY": "sk-xxx"}
   

3. Edit config.toml:

   vi ~/.codex/config.toml
   

   Press i, paste, then ESC, :wq, Enter.

   model_provider = "api111"
   model = "gpt-5.6-sol"
   model_reasoning_effort = "high"
   disable_response_storage = true
   preferred_auth_method = "apikey"
   
   [model_providers.api111]
   name = "api111"
   base_url = "https://4zapi.com/v1"
   wire_api = "responses"
   requires_openai_auth = true
   

Start Codex

Restart the terminal, then:

cd your-project-folder

codex

VS Code extension

Search and install codex in the VS Code marketplace. It appears in the sidebar after install.

Linux

System requirements

• Common distros (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)
• Node.js 22+
• npm 10+
• Network access

Install

1. Install Node.js

• Ubuntu/Debian

  sudo apt update
  curl -fsSL https://deb.nodesource.com/setup_lts.x  | 
  sudo -E bash -
  sudo apt-get install -y nodejs
  

• CentOS/RHEL/Fedora

  sudo dnf install nodejs npm
  # or
  sudo yum install nodejs npm
  

• Arch Linux

  sudo pacman -S nodejs npm
  

2. Install Codex

sudo npm install -g @openai/codex

3. Verify

codex --version

Configure API

1. Get an Auth Token On 在线文档:

• Open Console → API Tokens
• Click Add token
• Group: codex channel-gpt (required)
• Name: anything
• Quota: unlimited
• Other options: defaults

2. Config files

Important: Replace sk-xxx with your real API key from 4zapi.com!

1. Create files:

   mkdir -p ~/.codex
   touch ~/.codex/auth.json
   touch ~/.codex/config.toml
   

2. Edit auth.json:

   vi ~/.codex/auth.json
   

   Press i, paste (replace sk-xxx), then ESC, :wq, Enter.

   {"OPENAI_API_KEY": "sk-xxx"}
   

3. Edit config.toml:

   vi ~/.codex/config.toml
   

   Press i, paste, then ESC, :wq, Enter.

   model_provider = "api111"
   model = "gpt-5.6-sol"
   model_reasoning_effort = "high"
   disable_response_storage = true
   preferred_auth_method = "apikey"
   
   [model_providers.api111]
   name = "api111"
   base_url = "https://4zapi.com/v1"
   wire_api = "responses"
   requires_openai_auth = true
   

Start Codex

Restart the terminal, then:

cd your-project-folder

codex

VS Code extension

Search and install codex in the VS Code marketplace.

It appears in the sidebar after install.

FAQ

If you hit errors, check:

1. API Key: unlimited quota, no model limits, group codex channel-gpt.

See the official Codex docs for more configuration details.