Developers

Documentation

A technical guide to integrating leading AI models through Oblion's unified API.

On this page

Codex Setup

Tutorials for setting up the Codex CLI and VSCode plugin on Windows, macOS, and Linux.

Windows

System Requirements

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

Installation Steps

Prerequisite step: to install Git Bash, visit Git - Downloads and download the version matching your system, then click "Next" through the installer to finish.

  1. Install Node.js. Visit the official Node.js 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
  1. Verify the installation. Open Command Prompt (CMD) or PowerShell and run:
codex --version

API Configuration

1. Get an authentication token

Go to the Oblion AI dashboard and do the following:

  • Click Console → API Tokens page.
  • Click to add a token.
  • Select the token group: Codex Exclusive (this group is required, otherwise it won't work).
  • The token name can be anything.
  • Recommended credit limit: set to unlimited.
  • Leave the other options at their defaults.

2. Configuration files

Important: replace sk-xxx below with your actual API key generated from Oblion AI!

  1. Locate the .codex folder in your current user's home directory, e.g. C:\Users\testuser\.codex. (Note: if you don't see this directory, you haven't enabled "Show hidden items" in Windows. Enable it in File Explorer first.)
  2. If the .codex folder doesn't exist yet, create it manually, then create the files config.toml and auth.json inside it.
  3. Fill in the configuration (replace sk-xxx with your own actual key).

auth.json configuration:

{"OPENAI_API_KEY": "sk-xxx"}

config.toml configuration (paste the content below):

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.oblion.io/v1"
wire_api = "responses"

model_reasoning_effort accepts high, medium, or low, representing the model's reasoning effort level.

Start Codex

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

Then navigate to your project directory:

cd your-project-folder

Start it by running:

codex

Codex VSCode Plugin

After completing the configuration above, search for and install codex from the VSCode extension marketplace. It will appear in the sidebar after installation.

macOS

System Requirements

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

Installation Steps

1. Install Node.js

  • Method 1: Visit the official Node.js website directly to download and install the latest LTS version.
  • Method 2: Using Homebrew (recommended)
# If Homebrew isn't installed yet, run this 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 (you may need to prefix it with sudo):

npm install -g @openai/codex

3. Verify the installation

Open Terminal and run:

codex --version

API Configuration

1. Get an authentication token

Go to the Oblion AI dashboard and do the following:

  • Click Console → API Tokens page.
  • Click to add a token.
  • Select the token group: Codex Exclusive (this group is required, otherwise it won't work).
  • The token name can be anything.
  • Recommended credit limit: set to unlimited.
  • Leave the other options at their defaults.

2. Configuration files

Important: replace sk-xxx below with your actual API key generated from Oblion AI!

  1. Create the directory and files:
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  1. Edit the auth.json file:
vi ~/.codex/auth.json

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

{"OPENAI_API_KEY": "sk-xxx"}
  1. Edit the config.toml file:
vi ~/.codex/config.toml

Press i to enter insert mode, paste the content below, 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.oblion.io/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

Start it by running:

codex

Codex VSCode Plugin

After completing the configuration above, search for and install codex from the VS Code extension marketplace. It will appear in the sidebar after installation.

Linux

System Requirements

  • A mainstream Linux distribution (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 a terminal and run:

sudo npm install -g @openai/codex

3. Verify the installation

Open a terminal and run:

codex --version

API Configuration

1. Get an authentication token

Go to the Oblion AI dashboard and do the following:

  • Click Console → API Tokens page.
  • Click to add a token.
  • Select the token group: codex channel-gpt (this group is important, otherwise it won't work).
  • The token name can be anything.
  • Recommended credit limit: set to unlimited.
  • Leave the other options at their defaults.

2. Configuration files

Important: replace sk-xxx below with your actual API key generated from Oblion AI!

  1. Create the directory and files:
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  1. Edit the auth.json file:
vi ~/.codex/auth.json

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

{"OPENAI_API_KEY": "sk-xxx"}
  1. Edit the config.toml file:
vi ~/.codex/config.toml

Press i to enter insert mode, paste the content below, 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.oblion.io/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

Start it by running:

codex

Codex VSCode Plugin

After completing the configuration above, search for and install codex from the VSCode extension marketplace. It will appear in the sidebar after installation.

FAQ

If you run into errors, follow these steps to troubleshoot:

  1. Make sure the API key was created correctly: select an unlimited quota, don't restrict models, and select codex channel-gpt for the group.

For more details on configuring and using Codex, refer to the official Codex tutorial.