Skip to main content
This documentation is provided for informational purposes only and demonstrates how to configure and use our API with third-party AI chat interfaces. Any third-party software, websites, or services mentioned are not operated, controlled, or endorsed by us.

Introduction to Codex

Image
Codex is OpenAI’s coding agent for software development. ChatGPT Plus, Pro, Business, Edu, and Enterprise plans include Codex. It can help you: Codex Key Features:
  • Write code: Describe what you want to build, and Codex generates code that matches your intent, adapting to your existing project structure and conventions.
  • Understand unfamiliar codebases: Codex can read and explain complex or legacy code, helping you grasp how teams organize systems.
  • Review code: Codex analyzes code to identify potential bugs, logic errors, and unhandled edge cases.
  • Debug and fix problems: When something breaks, Codex helps trace failures, diagnose root causes, and suggest targeted fixes.
  • Automate development tasks: Codex can run repetitive workflows such as refactoring, testing, migrations, and setup tasks so you can focus on higher-level engineering work.

Step

1

Install Codex

Need a one-click configuration tool? Try RouterLink Starter, officially released by RouterLink.
RouterLink has already prepared installation scripts for you. You can run the following commands for one-click installation of Node.js and the corresponding coding agent.macOS, Linux, WSL:
curl -fsSL https://install.routerlink.ai/codex.sh | bash
Windows PowerShell:
irm https://install.routerlink.ai/codex.ps1 | iex
Windows users may be unable to run scripts because of digital signature requirements. Please run the following command:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force
Or, you can choose to manually install Node.js and the corresponding coding agent:Install the newest LTS version of Node.js.After installation is complete, open the terminal (Windows users use PowerShell) and check the version number.
  • macOS, Linux, Windows:
npm i -g @openai/codex
Verify the installation.
codex --version
If the version number is displayed correctly, the installation is successful.
2

Install Codex

Need a one-click configuration tool? Try RouterLink Starter, officially released by RouterLink.
RouterLink has already prepared installation scripts for you. You can run the following commands for one-click installation of Node.js and the corresponding coding agent.macOS, Linux, WSL:
curl -fsSL https://install.routerlink.ai/codex.sh | bash
Windows PowerShell:
irm https://install.routerlink.ai/codex.ps1 | iex
Windows users may be unable to run scripts because of digital signature requirements. Please run the following command:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force
Or, you can choose to manually install Node.js and the corresponding coding agent:Install the newest LTS version of Node.js.After installation is complete, open the terminal (Windows users use PowerShell) and check the version number.
  • macOS, Linux, Windows:
npm i -g @openai/codex
Verify the installation.
codex --version
If the version number is displayed correctly, the installation is successful.
3

Configure Codex

Codex uses the config.toml file to parse provider parameters. Please locate and create/edit this file according to your operating system.Edit or create config.toml fileOn macOS & Linux: ~/.codex/config.tomlOn Windows: C:\Users\<USERNAME>\.codex\config.tomlDelete the previous content and replace it with the following.Configuration file:
model_provider = "custom"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.custom]
name = "custom"
wire_api = "responses"
base_url = "https://router-link.world3.ai/api/v1"
You can replace the “model” field with any model that is compatible with the OpenAI format:
Image
Next, edit or create auth.json file. Codex uses this file to read the API key.On macOS & Linux: ~/.codex/auth.jsonOn Windows: C:\Users\<USERNAME>\.codex\auth.jsonMake sure to replace <ROUTERLINK_API_KEY> with your API key from RouterLink. When replacing it, do not keep the angle brackets < and >.
{
  "OPENAI_API_KEY": "<ROUTERLINK_API_KEY>"
}
4

Codex Loading and Validation

Windows users may encounter issues running the software due to missing VC runtime libraries. Please download and install this software.
Navigate to your code working directory and run the codex command in the terminal
codex
Select “Yes” to trust this folder.
Image
Now you can use Codex CLI.