1. Plugin Configuration
beeswitch docs
  • Plugin Configuration
    • API Relay Setup
    • Claude Code for VS Code Tutorial
    • Claude Code Installation and Usage Guide
    • Gemini CLI Configuration and Usage Guide
    • Codex CLI Configuration Guide
    • OpenCode Integration Configuration Guide
    • N8N Workflow Relay API Usage Guide
  • List Models
    • Models (list models)
      GET
  • OpenAI Format (Supports Major Official Provider Models)
    • Chat (Responses)
      • Create Web Search
      • Create Model Response (GPT-5 Reasoning Enabled)
      • Create Function Call
      • Create Model Response
      • Create Function Call
      • Create Model Response (Streaming)
      • Create Model Response (Control Reasoning Length)
    • ChatGPT APIs
      • ChatGPT Audio
        • Create Video
        • Speech-to-Text gpt-4o-transcribe
        • Create translation (not supported)
        • Speech-to-Text whisper-1
        • Speech-to-Text gpt-4o-transcribe
        • Create speech gpt-4o-mini-tts
        • Create translation (not supported)
      • ChatGPT Chat
        • List Models
        • Create Video with Image
        • Continuously modify and generate videos
        • Create chat picture recognition (streaming) best64
        • Official N test
        • Create Structured Output
        • Control Reasoning Effort
        • Create Chat Function Call
        • deepseek-ocr recognition
        • Create Chat Completion (Non-streaming)
      • ChatGPT Completions
        • Create Completion
    • Images
      • Modify pictures (images)
      • Create Chat Completion (Streaming)
      • Create chat completion qwen-mt-turbo
      • Create chat completion deepseek v3.1 thinking level (streaming)
    • Audio
      • Speech recognition(audio)
      • Speech synthesis (audio)
      • Official Function Calling
      • Create a chat creation graph (non-streaming)
    • Embeddings
      • Text Embeddings
  • Anthropic Format
    • Chat
      POST
    • Chat (prompt cache)
      POST
    • Streaming Response
      POST
    • Chat (Deep Reasoning)
      POST
    • Tool Calling (Function Call)
      POST
    • Tool Calling (MCP) - Pending Support
      POST
    • Analyze Image
      POST
  • Google Gemini APIs
    • Native Format
      • Text-to-Image (Aspect Ratio + Clarity Controls)
      • Generate Image
      • Text Generation
      • Text Generation (Streaming)
      • Text Generation + Reasoning (Streaming)
      • Image Generation
      • Formatted Output
      • Function Calling
      • Document Understanding
      • URL context [native format]
      • Code Execution
      • google search
      • Video Understanding
      • URL context
      • Video understanding-url [native format]
      • Imagen 4 under development
      • Audio Understanding
      • Embeddings
      • Chat
      • Edit Image
    • Image-to-Image Base64 Request (Officially Recommended)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Single Image with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Generation with gemini-2.5-flash-image
      • Image Generation with gemini-2.5-flash-image (Aspect Ratio Control)
      • Image Understanding
    • Image-to-Image URL Request / OpenAI-style URL Request
      • Single Image-to-Image with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Image Understanding
    • Image-to-Image URL Request (Not Currently Supported)
      • Multi-Image Fusion with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Image Understanding
    • Image-to-Image URL Request, Gemini Format (Not Currently Supported)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Image Understanding
  • NanoBanana
    • Image-to-Image Base64 Request (Officially Recommended)
      • Multi-Image Fusion Generation with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Editing
      • Single Image with gemini-3-pro-image-preview (Aspect Ratio + Clarity Controls)
      • Image Generation with gemini-2.5-flash-image
      • Image Generation with gemini-2.5-flash-image (Aspect Ratio Control)
      • Image Understanding
    • Gemini Request Format
      • Generate Image
      • Edit Image
    • OpenAI Request Format
      • Edit Image
      • OpenAI Image Format
  • Midjourney Format
    • Task Query API
    • Upload Image
    • Get Seed
    • Submit Imagine Task
    • Query Tasks by ID List
    • Face Swap
    • Execute Action
    • Submit Blend Task
    • Submit Describe Task
    • Submit Modal
    • Refresh URL
    • Edit Image
    • Query Task Status by Task ID
    • Get Seed for Task Image
  • Doubao Video Generation
    • Text-to-Video Example
    • Image-to-Video - First Frame
    • seedance-lite - First and Last Frames
    • Image-to-Video - Base64 Encoding
    • seedance-lite - Reference Image
    • Query Single Task
    • Query video generation task list-default
    • Query video generation task list - search multiple task IDs
  • Doubao Image Generation
    • doubao-seededit-3-0-i2i-250628
    • doubao-seedream-4-0-250828 - Text-to-Image
    • doubao-seedream-4-0-250828 - Image-to-Image
    • doubao-seedream-4-0-250828 - Multi-Image-to-Image
  • Jimeng AI
    • Jimeng AI - Image Generation
      • seedream-4.5
      • seedream-4.5 - Text-to-Image
      • seedream-4.5 - Image-to-Image
      • seedream-4.5 - Multi-Image-to-Image
    • Jimeng AI - Video Generation
      • Unified Task Submission API
      • Unified Query API
  • Rerank Models
    • Rerank
  • Text-to-Music (Suno)
    • Task Submission
      • Generate Song (Inspiration Mode)
      • Generate Song (Custom Mode)
      • Generate Song (Continuation Mode)
      • Generate Song (Singer Style)
      • Generate Song (Remix Uploaded Song)
      • Generate Song (Song Concatenation)
      • Generate Lyrics
      • Song Concatenation
    • Query APIs
      • Fetch Tasks in Batch
      • Query Single Task
  • Veo Video Generation
    • Latest Veo Video Generation (Recommended First)
      • Upload Image (Valid for One Day)
      • Create Video Generation Task - Text Only
      • Create Video Generation Task with Reference Image
      • Query Task Status
    • OpenAI Video Format (Recommended)
      • OpenAI Create Video with Image
      • OpenAI Query Task
      • OpenAI Download Video
    • Unified Video Format (Pending Unification)
      • Create Video
      • Create Video with Image
      • Query Task
      • Create Video (Reference Image)
  • Sora Video Generation
    • Official OpenAI Video Format (Recommended)
      • sora-2/sora-2-pro
        • OpenAI Query Task
        • OpenAI Download Video
        • OpenAI Create Video with Image
        • OpenAI Create Video (with Character)
        • OpenAI Edit Video
    • Chat Format
  • Kling (Kuaishou)
    • Text-to-Video
    • Image-to-Video
    • Query tasks (free)
  • Wan (Qwen)
    • Create Video with Image (Wan)
    • Query Video (Wan)
  • MinMax Video Generation
    • Text-to-Video Generation Task (MinMax)
    • Image-to-Video Task (MinMax)
    • Query Video Generation Task Status (MinMax)
    • Video Download (MinMax)
  • Vidu Video Generation
    • Vidu Generate Video
    • Vidu Query
  1. Plugin Configuration

Codex CLI Configuration Guide

Codex CLI Installation and Configuration Tutorial#


Windows Tutorial#

System Requirements#

Windows 10 or Windows 11
Node.js 22+
npm 10+
Internet connection

Installation Steps#

Prerequisite Steps
To install Git Bash, please visit Git - Downloads to download the version corresponding to your computer system, and then keep clicking "Next" to complete the installation.
1. Install Node.js
Visit Node.js official website to download and install the latest LTS version.
2. Install codex
Open a command prompt (CMD) or PowerShell and run:
3. Verify installation
Open a command prompt (CMD) or PowerShell and run:

API Configuration#

1. Get Auth Token
Visit the wolfai site page to do the following:
Click on the Console → API Token page
Click Add Token
Please select the token group: codex group (be sure to select this group, otherwise it cannot be used)
Token name is arbitrary
Quota recommendation: Set to Unlimited
Keep other options as default
2. Configuration file
IMPORTANT: Please replace sk-xxx below with your actual API key generated at wolfai!
IMPORTANT: Please replace sk-xxx below with your actual API key generated at wolfai!
IMPORTANT: Please replace sk-xxx below with your actual API key generated at wolfai!
1.
Enter the .codex folder in the current user's user directory, for example: C:\Users\testuser\.codex.
(Note: If you cannot see this directory, it means that you have not turned on Windows' "Show hidden items". Please turn it on in File Explorer first.)
image.png
2.
If there is no .codex folder, please create the folder manually, and then create two files config.toml and auth.json in it.
image.png
3. Fill in the configuration (you need to replace sk-xxx with the real SK you created).
a. Configuration in auth.json:
    {"OPENAI_API_KEY": "sk-xxx"}
b. Configuration in config.toml (just paste the following content directly):
model_reasoning_effort The optional values are high, medium, and low, which respectively represent the effort level of model thinking (high, medium, low).
    model_provider = "api111"
    model = "gpt-5.2-codex"
    model_reasoning_effort = "high"
    disable_response_storage = true
    preferred_auth_method = "apikey"

    [model_providers.api111]
    name = "api111"
    base_url = "https://new-api.aicarb.com/v1"
    wire_api = "responses"

Start Codex#

Restart the terminal! Restart the terminal! Restart the terminal!
Then go to your project directory:
Run the following command to start:
image.png

macOS Tutorial#

System Requirements#

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

Installation Steps#

1. Install Node.js
Method 1: Directly visit Node.js official website to download and install the latest LTS version.
Method 2: Use Homebrew (recommended)
2. Install codex
Open Terminal and run (you may need to add sudo):
3. Verify installation
Open Terminal and run:

API Configuration#

1. Get Auth Token
Visit the wcnb.ai site page to perform the following operations:
Click on the Console → API Token page
Click Add Token
Please select the token group: codex special offer (be sure to select this group, otherwise it cannot be used)
Token name is arbitrary
Quota recommendation: Set to Unlimited
Keep other options as default
2. Configuration file
IMPORTANT: Please replace sk-xxx below with the actual API key you generated at wcnb.ai!
IMPORTANT: Please replace sk-xxx below with the actual API key you generated at wcnb.ai!
IMPORTANT: Please replace sk-xxx below with the actual API key you generated at wcnb.ai!
1.
Create directories and files:
2.
Edit the auth.json file:
Press i to enter insert mode, paste the following (replace sk-xxx with your key), then press ESC, enter :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, enter :wq and press Enter to save and exit.
    model_provider = "api111"
    model = "gpt-5.2-codex"
    model_reasoning_effort = "high"
    disable_response_storage = true
    preferred_auth_method = "apikey"

    [model_providers.api111]
    name = "api111"
    base_url = "https://new-api.aicarb.com/v1"
    wire_api = "responses"

Start Codex#

Restart the terminal! Restart the terminal! Restart the terminal!
Then go to your project directory:
Run the following command to start:

Linux Tutorial#

System Requirements#

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

Installation Steps#

1. Install Node.js
Ubuntu/Debian
CentOS/RHEL/Fedora
Arch Linux
2. Install codex
Open Terminal and run:
3. Verify installation
Open Terminal and run:

API Configuration#

1. Get Auth Token
Visit the wcnb.ai site page to perform the following operations:
Click on the Console → API Token page
Click Add Token
Please select the token group: codex channel-gpt (be sure to select this group, otherwise it cannot be used)
Token name is arbitrary
Quota recommendation: Set to Unlimited
Keep other options as default
2. Configuration file
IMPORTANT: Please replace sk-xxx below with the actual API key you generated at wcnb.ai!
IMPORTANT: Please replace sk-xxx below with the actual API key you generated at wcnb.ai!
IMPORTANT: Please replace sk-xxx below with the actual API key you generated at wcnb.ai!
1.
Create directories and files:
2.
Edit the auth.json file:
Press i to enter insert mode, paste the following (replace sk-xxx with your key), then press ESC, enter :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, enter :wq and press Enter to save and exit.
    model_provider = "api111"
    model = "gpt-5.2-codex"
    model_reasoning_effort = "high"
    disable_response_storage = true
    preferred_auth_method = "apikey"

    [model_providers.api111]
    name = "api111"
    base_url = "https://wcnb.ai/v1"
    wire_api = "responses"

Start Codex#

Restart the terminal! Restart the terminal! Restart the terminal!
Then go to your project directory:
Run the following command to start:
image.png

VS Code Codex Extension#

After the above configuration is completed, search and install codex in the VS Code extension store.
image.png
It will appear in the sidebar after installation is complete.
image.png
Find and click Settings to open the settings.json file of the VS Code IDE
Picture.png
At the end of the settings.json file, add the following configuration entries. Replace the API key with your own API token, and keep the other values unchanged.

  "chatgpt.apiBase": "https://deeprouter.top/v1",
  "chatgpt.apiKey": "replace-with-your-sk-token",
  "chatgpt.config": "{\"preferred_auth_method\": \"apikey\"}",
  "chatgpt.model": "gpt-5.2-Codex"

FAQ#

If an error occurs, please follow the steps below to troubleshoot:
1.
Confirm whether the API Key is created correctly: select Unlimited Quota for the quota, do not limit the model, and select codex channel for the group.
For more codex configuration and usage details, please refer to codex official tutorial.
Modified at 2026-07-09 10:12:46
Previous
Gemini CLI Configuration and Usage Guide
Next
OpenCode Integration Configuration Guide
Built with