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

• 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 x6.ai Starter, officially released by x6.ai.

• CLI - Node.js
• App
• VS Code Extension

You can 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.

The Codex app is available on macOS and Windows.Please follow the tutorial to complete the installation.

Install the Codex Code extension from the VS Code Marketplace — Codex is OpenAI’s coding agent that helps you write, review, and ship code faster. Use it side-by-side in your IDE or delegate larger tasks to the cloud.

2

Install Codex

Need a one-click configuration tool? Try x6.ai Starter, officially released by x6.ai.

• CLI - Node.js
• App
• VS Code Extension

You can 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.

The Codex app is available on macOS and Windows.Please follow the tutorial to complete the installation.

Install the Codex Code extension from the VS Code Marketplace — Codex is OpenAI’s coding agent that helps you write, review, and ship code faster. Use it side-by-side in your IDE or delegate larger tasks to the cloud.

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.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.custom]
name = "custom"
wire_api = "responses"
base_url = "https://api.x6.ai/v1"

You can replace the “model” field with any model that is compatible with the OpenAI format:

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 <X6_API_KEY> with your API key from x6.ai. When replacing it, do not keep the angle brackets < and >.

{
  "OPENAI_API_KEY": "<X6_API_KEY>"
}

4

Codex Loading and Validation

• CLI
• App
• VS Code Extension

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.

Now you can use Codex CLI.

Open Codex App. If prompted to choose, select “sign in with your OpenAI API key” and enter your API key from x6.ai.Now you can use Codex App.

Click the Toggle Chat button at the top (shortcut: Ctrl+Alt+I), then click Codex.

Done! You can now use Codex for VS Code.