菜單

Codex 安裝與配置教程

Windows 版本教程

系統要求

Windows 10 或 Windows 11
Node.js 22+
npm 10+
網絡連接

安裝步驟

前置步驟!!!
安裝 Git Bash,請訪問 Git - Downloads 下載對應您電腦系統的版本,之後一直點擊「下一步」即可完成安裝。
1. 安裝 Node.js
訪問 Node.js 官網 下載並安裝最新 LTS 版本。
2. 安裝 codex
打開命令提示符 (CMD) 或 PowerShell,運行:
npm install -g @openai/codex
3. 驗證安裝
打開命令提示符 (CMD) 或 PowerShell,運行:
codex --version

配置 API

1. 獲取 Auth Token
訪問 api.airai.cc 站點頁面進行以下操作:
點擊 控制台 → API令牌 頁面
點擊 添加令牌
令牌分組請選擇:codex專屬(務必選擇此分組,否則無法使用)
令牌名稱隨意
額度建議:設置為 無限額度
其他選項保持默認
Codex 安裝與配置教程 第1張
2. 配置文件
重要提示:請將下方的 sk-xxx 替換為您在 api.airai.cc 生成的實際 API 密鑰!
重要提示:請將下方的 sk-xxx 替換為您在 api.airai.cc 生成的實際 API 密鑰!
重要提示:請將下方的 sk-xxx 替換為您在 api.airai.cc 生成的實際 API 密鑰!
1.
進入當前用戶的用戶目錄下的 .codex 文件夾中,例如:C:\Users\testuser\.codex。
(注意:如果看不到該目錄,說明您沒有打開 Windows 的「顯示隱藏的項目」,請先在文件資源管理器中開啓。)
Codex 安裝與配置教程 第2張
2.
如果沒有 .codex 文件夾,請手動創建該文件夾,然後在其中創建 config.toml 以及 auth.json 兩個文件。
Codex 安裝與配置教程 第3張
3. 填寫配置 (需要將 sk-xxx 替換成您自己創建的真實 SK)。
a. auth.json 中的配置:
{"OPENAI_API_KEY": "sk-xxx"}
b. config.toml 中的配置(直接粘貼下面的內容即可):
model_reasoning_effort 可選值為 high, medium, low,分別代表模型思考的努力程度(高、中、低)。
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.airai.cc/v1"
wire_api = "responses"

啓動 codex

重啓終端!重啓終端!重啓終端!
然後進入到您的工程目錄:
cd your-project-folder
運行以下命令啓動:
codex
Codex 安裝與配置教程 第4張

VSCode 插件 codex

以上配置完成後,在 VSCode 擴展商店中搜索並安裝 codex 即可。
Codex 安裝與配置教程 第5張
安裝完成後會出現在側邊欄。

Codex 安裝與配置教程 第6張

Mac 版本教程

系統要求

macOS 12 或更高版本
Node.js 22+
npm 10+
網絡連接

安裝步驟

1. 安裝 Node.js
方式一:直接訪問 Node.js 官網 下載並安裝最新 LTS 版本。
方式二:使用 Homebrew(推薦)
# 如果尚未安装 Homebrew,请先运行此命令/bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"# 安装 Node.jsbrew install node
2. 安裝 codex
打開終端 (Terminal),運行(可能需要加 sudo):
npm install -g @openai/codex
3. 驗證安裝
打開終端 (Terminal),運行:
codex --version

配置 API

1. 獲取 Auth Token
訪問 api.airai.cc 站點頁面進行以下操作:
點擊 控制台 → API令牌 頁面
點擊 添加令牌
令牌分組請選擇:codex特供(務必選擇此分組,否則無法使用)
令牌名稱隨意
額度建議:設置為 無限額度
其他選項保持默認
Codex 安裝與配置教程 第7張
2. 配置文件
重要提示:請將下方的 sk-xxx 替換為您在 api.airai.cc 生成的實際 API 密鑰!
重要提示:請將下方的 sk-xxx 替換為您在 api.airai.cc 生成的實際 API 密鑰!
重要提示:請將下方的 sk-xxx 替換為您在 api.airai.cc 生成的實際 API 密鑰!
1.
創建目錄和文件:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
編輯 auth.json 文件:
vi ~/.codex/auth.json
按 i 進入插入模式,粘貼以下內容(將 sk-xxx 替換為您的密鑰),然後按 ESC 鍵,輸入 :wq 並回車保存退出。
{"OPENAI_API_KEY": "sk-xxx"}
3.
編輯 config.toml 文件:
vi ~/.codex/config.toml
按 i 進入插入模式,粘貼以下內容,然後按 ESC 鍵,輸入 :wq 並回車保存退出。
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.airai.cc/v1"
wire_api = "responses"

啓動 codex

重啓終端!重啓終端!重啓終端!
然後進入到您的工程目錄:
cd your-project-folder
運行以下命令啓動:
codex
[圖片]

VSCode 插件 codex

以上配置完成後,在 VSCode 擴展商店中搜索並安裝 codex 即可。
[圖片]
安裝完成後會出現在側邊欄。
[圖片]

Linux 版本教程

系統要求

主流 Linux 發行版 (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)
Node.js 22+
npm 10+
網絡連接

安裝步驟

1. 安裝 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
# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)sudo dnf install nodejs npm# 或sudo yum install nodejs npm
Arch Linux
sudo pacman -S nodejs npm
2. 安裝 codex
打開終端 (Terminal),運行:
sudo npm install -g @openai/codex
3. 驗證安裝
打開終端 (Terminal),運行:
codex --version

配置 API

1. 獲取 Auth Token
訪問 api.airai.cc 站點頁面進行以下操作:
點擊 控制台 → API令牌 頁面
點擊 添加令牌
令牌分組請選擇:codex渠道-gpt(務必選擇此分組,否則無法使用)
令牌名稱隨意
額度建議:設置為 無限額度
其他選項保持默認
[圖片]
2. 配置文件
重要提示:請將下方的 sk-xxx 替換為您在 api.airai.cc 生成的實際 API 密鑰!
重要提示:請將下方的 sk-xxx 替換為您在 api.airai.cc 生成的實際 API 密鑰!
重要提示:請將下方的 sk-xxx 替換為您在 api.airai.cc 生成的實際 API 密鑰!
1.
創建目錄和文件:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
編輯 auth.json 文件:
vi ~/.codex/auth.json
按 i 進入插入模式,粘貼以下內容(將 sk-xxx 替換為您的密鑰),然後按 ESC 鍵,輸入 :wq 並回車保存退出。
{"OPENAI_API_KEY": "sk-xxx"}
3.
編輯 config.toml 文件:
vi ~/.codex/config.toml
按 i 進入插入模式,粘貼以下內容,然後按 ESC 鍵,輸入 :wq 並回車保存退出。
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.airai.cc/v1"
wire_api = "responses"

啓動 codex

重啓終端!重啓終端!重啓終端!
然後進入到您的工程目錄:
cd your-project-folder
運行以下命令啓動:
codex
Codex 安裝與配置教程 第8張

VSCode 插件 codex

以上配置完成後,在 VSCode 擴展商店中搜索並安裝 codex 即可。
Codex 安裝與配置教程 第9張
安裝完成後會出現在側邊欄。

Codex 安裝與配置教程 第10張

常見問題

出現錯誤請按照如下步驟排查:
1.
確認 API Key 創建是否正確:額度選擇無限額度,不要限制模型,分組選擇 codex渠道-gpt。
更多 codex 配置及使用詳情請參考 codex 官方教程。


有用嗎?

技術支持在線客服
返回頂部
简体中文ZH-CNDefault繁體中文ZH-TWEnglishEN日本語JA한국어KOภาษาไทยTHTiếng ViệtVIBahasa IndonesiaIDEspañolESFrançaisFRDeutschDEРусскийRUPortuguêsPTItalianoITالعربيةAR