🤖 Codex Installation & Configuration Guide

Complete setup instructions for Windows, Mac, and Linux

🪟 Windows Version

System Requirements

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

⚠️ Prerequisites!!!

Install Git Bash. Visit Git - Downloads to download the version for your system, then click "Next" to complete installation.

Installation Steps

1

Install Node.js

Visit Node.js official website to download and install the latest LTS version.

2

Install codex

Open Command Prompt (CMD) or PowerShell and run:

npm install -g @openai/codex
3

Verify Installation

Open Command Prompt (CMD) or PowerShell and run:

codex --version

API Configuration

1

Configuration Files

Important: Replace sk-xxx below with your actual API key from v98store.com!

Important: Replace sk-xxx below with your actual API key from v98store.com!

Important: Replace sk-xxx below with your actual API key from v98store.com!

1. Navigate to the .codex folder in your user directory, for example: C:\Users\testuser\.codex.

Note: If you can't see this directory, enable "Show hidden items" in Windows File Explorer first.

2. If the .codex folder doesn't exist, create it manually, then create config.toml and auth.json files inside it.

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

a. Configuration in auth.json:

{"OPENAI_API_KEY": "sk-xxx"}

b. Configuration in config.toml (paste the content below directly):

model_reasoning_effort can be high, medium, or low, representing the model's thinking effort level.

model_provider = "api111" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.api111] name = "api111" base_url = "https://v98store.com/v1" wire_api = "responses"

Start codex

Restart your terminal! Restart your terminal! Restart your terminal!

Then navigate to your project directory:

cd your-project-folder

Run the following command to start:

codex

VSCode codex Extension

After completing the above configuration, search for and install codex in the VSCode extension store.

After installation, it will appear in the sidebar.


🍎 Mac Version

System Requirements

  • macOS 12 or higher
  • Node.js 22+
  • npm 10+
  • Network connection

Installation Steps

1

Install Node.js

Method 1: Visit Node.js official website to download and install the latest LTS version.

Method 2: Use Homebrew (Recommended)

# If Homebrew is not installed, run this command first /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Install Node.js brew install node
2

Install codex

Open Terminal and run (may need to add sudo):

npm install -g @openai/codex
3

Verify Installation

Open Terminal and run:

codex --version

API Configuration

1

Configuration Files

Important: Replace sk-xxx below with your actual API key from v98store.com!

Important: Replace sk-xxx below with your actual API key from v98store.com!

Important: Replace sk-xxx below with your actual API key from v98store.com!

1. Create directory and files:

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

2. Edit auth.json file:

vi ~/.codex/auth.json

Press i to enter insert mode, paste the following content (replace sk-xxx with your key), then press ESC, type :wq and press Enter to save and exit.

{"OPENAI_API_KEY": "sk-xxx"}

3. Edit config.toml file:

vi ~/.codex/config.toml

Press i to enter insert mode, paste the following content, then press ESC, type :wq and press Enter to save and exit.

model_provider = "api111" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.api111] name = "api111" base_url = "https://v98store.com/v1" wire_api = "responses"

Start codex

Restart your terminal! Restart your terminal! Restart your terminal!

Then navigate to your project directory:

cd your-project-folder

Run the following command to start:

codex

VSCode codex Extension

After completing the above configuration, search for and install codex in the VSCode extension store.

After installation, it will appear in the sidebar.


🐧 Linux Version

System Requirements

  • Mainstream Linux distributions (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)
  • Node.js 22+
  • npm 10+
  • Network connection

Installation Steps

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:

# Using dnf (Fedora) or yum (CentOS/RHEL) sudo dnf install nodejs npm # or sudo yum install nodejs npm

Arch Linux:

sudo pacman -S nodejs npm
2

Install codex

Open Terminal and run:

sudo npm install -g @openai/codex
3

Verify Installation

Open Terminal and run:

codex --version

API Configuration

1

Configuration Files

Important: Replace sk-xxx below with your actual API key from v98store.com!

Important: Replace sk-xxx below with your actual API key from v98store.com!

Important: Replace sk-xxx below with your actual API key from v98store.com!

1. Create directory and files:

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

2. Edit auth.json file:

vi ~/.codex/auth.json

Press i to enter insert mode, paste the following content (replace sk-xxx with your key), then press ESC, type :wq and press Enter to save and exit.

{"OPENAI_API_KEY": "sk-xxx"}

3. Edit config.toml file:

vi ~/.codex/config.toml

Press i to enter insert mode, paste the following content, then press ESC, type :wq and press Enter to save and exit.

model_provider = "api111" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.api111] name = "api111" base_url = "https://v98store.com/v1" wire_api = "responses"

Start codex

Restart your terminal! Restart your terminal! Restart your terminal!

Then navigate to your project directory:

cd your-project-folder

Run the following command to start:

codex

VSCode codex Extension

After completing the above configuration, search for and install codex in the VSCode extension store.

After installation, it will appear in the sidebar.