Codex Installation and Configuration Guide#
Windows Tutorial#
System Requirements#
Installation Steps#
Prerequisites!!!
Install Git Bash by visiting Git - Downloads to download the version for your system, then click "Next" through the installation process.2. Install codex
Open Command Prompt (CMD) or PowerShell, and run:3. Verify Installation
Open Command Prompt (CMD) or PowerShell, and run:1. Obtain Auth Token
Visit the Crazyrouter website and perform the following:Click Console → API Tokens page
Token name: Any name you prefer
Quota recommendation: Set to Unlimited
Keep other options as default
Important: Replace sk-xxx below with your actual API key generated from Crazyrouter!
Important: Replace sk-xxx below with your actual API key generated from Crazyrouter!
Important: Replace sk-xxx below with your actual API key generated from Crazyrouter!
1.
Navigate to the .codex folder in your user directory, e.g., C:\Users\testuser\.codex.
(Note: If you cannot see this directory, you haven't enabled "Show hidden items" in Windows. Please enable it in File Explorer first.)
2.
If the .codex folder doesn't exist, manually create it, then create two files inside: config.toml and auth.json.

3. Fill in the configuration (replace sk-xxx with your actual SK).a. Configuration in auth.json:{"OPENAI_API_KEY": "sk-xxx"}
b. Configuration in config.toml (just paste the content below):
model_reasoning_effort options are high, medium, 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://api.crazyrouter.com/v1"
wire_api = "responses"
Launch codex#
Restart your terminal! Restart your terminal! Restart your terminal!
Then navigate to your project directory:Run the following command to start:VSCode codex Extension#
After completing the above configuration, search for and install codex in the VSCode Extension Marketplace.
Once installed, it will appear in the sidebar.Mac Tutorial#
System Requirements#
Installation Steps#
Option 2: Use Homebrew (Recommended) 2. Install codex
Open Terminal and run (may require sudo):3. Verify Installation
Open Terminal and run:1. Obtain Auth Token
Visit the Crazyrouter website and perform the following:Click Console → API Tokens page
Token group: Select codex-special (you must select this group, otherwise it won't work)
Token name: Any name you prefer
Quota recommendation: Set to Unlimited
Keep other options as default

Important: Replace sk-xxx below with your actual API key generated from Crazyrouter!
Important: Replace sk-xxx below with your actual API key generated from Crazyrouter!
Important: Replace sk-xxx below with your actual API key generated from Crazyrouter!
1.
Create directory and files: 2.
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 the config.toml file: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://api.crazyrouter.com/v1"
wire_api = "responses"
Launch codex#
Restart your terminal! Restart your terminal! Restart your terminal!
Then navigate to your project directory:Run the following command to start:VSCode codex Extension#
After completing the above configuration, search for and install codex in the VSCode Extension Marketplace.
[Image]Once installed, it will appear in the sidebar.
[Image]
Linux Tutorial#
System Requirements#
Major Linux distributions (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)
Installation Steps#
2. Install codex
Open Terminal and run:3. Verify Installation
Open Terminal and run:1. Obtain Auth Token
Visit the Crazyrouter website and perform the following:Click Console → API Tokens page
Token group: Select codex-channel-gpt (you must select this group, otherwise it won't work)
Token name: Any name you prefer
Quota recommendation: Set to Unlimited
Keep other options as default
[Image]
Important: Replace sk-xxx below with your actual API key generated from Crazyrouter!
Important: Replace sk-xxx below with your actual API key generated from Crazyrouter!
Important: Replace sk-xxx below with your actual API key generated from Crazyrouter!
1.
Create directory and files: 2.
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 the config.toml file: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://api.crazyrouter.com/v1"
wire_api = "responses"
Launch codex#
Restart your terminal! Restart your terminal! Restart your terminal!
Then navigate to your project directory:Run the following command to start:VSCode codex Extension#
After completing the above configuration, search for and install codex in the VSCode Extension Marketplace.
Once installed, it will appear in the sidebar.FAQ#
If you encounter errors, troubleshoot with the following steps:1.
Confirm the API Key was created correctly: Set quota to Unlimited, don't restrict models, and select codex-channel-gpt as the group.
For more codex configuration and usage details, please refer to the official codex tutorial.
Modified at 2026-09-28 12:50:39