迁移教材

Codex 安装与配置教程

公益api每天可以领取50刀额度--为防止恶意刷取额度、转卖额度、批量注册等情况--兑换额度方式改为QQ交流群(743207026)管理员登记你的api账号(每人只能登记一个账号)每日重置50刀额度 -----公益api网址:https://api.kelaodealics.icu
Windows 10 / 11 macOS 12+ Linux 主流发行版 AutoCAD VSCode / Cursor 插件
适用场景

适合第一次安装 Codex,或者想把不同系统配置步骤统一放进一个说明页的人。

公益性质

没有任何收费方式,请勿被骗,请勿转卖

阅读方式

先看你对应的系统章节,再按顺序执行命令、创建令牌、写配置,最后启动 Codex 与安装插件。

Windows

Windows 版本教程

适合第一次配置 Codex 的 Windows 用户。建议先装 Git Bash,再安装 Node.js 与 Codex CLI。

系统要求

Windows 10 或 Windows 11 Node.js 22+ npm 10+ 网络连接

安装步骤

前置步骤:安装 Git Bash

访问 Git 官网下载对应系统版本,安装时保持默认设置,一直点击“下一步”即可。

Git - Downloads

1. 安装 Node.js

访问 Node.js 官网并安装最新 LTS 版本。

Node.js 官网

2. 安装 Codex CLI

命令
npm install -g @openai/codex

3. 验证安装

命令
codex --version

获取 API 令牌

Windows 章节要求令牌分组选择 codex专属

  • 访问 https://api.kelaodealics.icu,进入“控制台 → API令牌”。
  • 点击“添加令牌”,令牌名称可自定义。
  • 令牌分组选择 vip
  • 额度建议设置为“无限额度”,其他选项保持默认。
Windows 创建令牌占位图

写入配置

请将下方的 sk-xxx 替换为你在 https://api.kelaodealics.icu 创建的真实 API 密钥。Windows 下配置目录通常是 C:\Users\testuser\.codex。如果看不到该目录,请先在资源管理器里开启“显示隐藏的项目”。

  • 进入当前用户目录下的 .codex 文件夹。
  • 如果没有 .codex 文件夹,请手动创建该文件夹,并在里面创建 config.tomlauth.json 两个文件。
Windows 配置目录示意图 1 Windows 配置目录示意图 2
auth.json
{"OPENAI_API_KEY": "sk-xxx"}
config.toml
model_provider = "proxy"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.proxy]
name = "Kelaode Proxy"
base_url = "https://api.kelaodealics.icu/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000

[windows]
sandbox = "elevated"

启动 Codex

重启终端后,再进入你的工程目录启动 Codex。

启动命令
cd your-project-folder 
codex
例如:
cd C:\Users\a7078\Desktop\apis(注意路径不要重复)
codex

2.配置环境变量:系统属性 → 高级 → 环境变量 → 用户变量 → 新建
然后填:
变量名:OPENAI_API_KEY
变量值:API密钥

3.重启 Codex app
taskkill /F /IM Codex.exe
然后重新打开 app。
如果 app 还是不行,先用 CMD 启动一次看错误:
codex app
Windows 启动 Codex 示意图

安装 VSCode 插件

以上配置完成后,在 VSCode 扩展商店中搜索并安装 codex 即可。安装完成后,会出现在侧边栏中。

Windows VSCode 插件示意图 1 Windows VSCode 插件示意图 2

其他内容请参考视频教程

Mac / Linux

Mac / Linux 终端配置教程

系统要求

macOS 或 Linux Node.js 20+ npm 可用 网络连接

先注册账号,获取令牌

  • 打开 https://api.kelaodealics.icu,点击右上角注册并登录。
  • 登录后进入左侧创建密钥/令牌。

必要安装

1. Git

Mac 可以不单独安装 Git。Linux 如果系统没有 Git,请使用发行版自带包管理器安装。

2. Node.js

Node.js 版本需要 20 以上。安装过程中如果遇到问题,可以截图给 AI 排查,通常先检查 Node.js 和 npm 是否安装成功。

Node.js 下载页

3. 安装 Codex CLI

Mac / Linux 终端运行:

命令
sudo npm install -g @openai/codex

4. 验证安装

命令
codex --version

如果出现类似 codex-cli 0.xx.0 的版本信息,就说明安装成功。

创建配置目录

打开终端,先回到用户主目录并确认是否已有 .codex 文件夹。

回到主目录并查看隐藏文件
cd ~
ls -a

如果没有看到 .codex 文件夹,请运行:

创建配置文件
mkdir .codex
cd .codex
touch config.toml auth.json

如果已经存在 .codex 文件夹,可以直接打开编辑。

打开配置目录
cd ~/.codex
code .

写入 config.toml

config.toml
model_provider = "codex"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://api.kelaodealics.icu/v1"
wire_api = "responses"
requires_openai_auth = true

写入 auth.json

请把 sk-xxx 替换为你在 https://api.kelaodealics.icu 复制到的真实 API 密钥。

auth.json
{
  "OPENAI_API_KEY": "sk-xxx"
}

启动 Codex

以上处理完之后,启动 Codex 前请先重启终端,否则容易读不到新配置。

启动命令
cd your-project-folder
codex

请参考视频教程

CAD

CAD 教程

本章节适合需要在 AutoCAD、Python 和 VS Code 环境中使用 Codex 插件的用户。涉及命令行检查的步骤,请使用 PowerShell 或 CMD 执行。

需要下载的软件

1. AutoCAD

进入 Autodesk 官方页面下载并安装 AutoCAD。

AutoCAD 官方下载 / 试用

2. Python

进入 Python 官方下载页安装 Windows 版本。安装时建议勾选“Add python.exe to PATH”。

Python Windows 下载页

3. VS Code

进入 VS Code 官方下载页安装 Windows 版本。

VS Code 官方下载页

查看 Python 版本

在 Windows 上打开 PowerShell 或命令提示符 CMD,输入:

命令
python --version

或者:

命令
python -V

如果上面的命令不行,再试:

命令
py --version

或:

命令
py -V

正常会显示类似:

输出示例
Python 3.12.6

打开 VS Code 设置

打开 VS Code 设置,在最上面的搜索框里输入:

搜索内容
@ext:openai.chatgpt

点击“在 settings.json 中编辑”,按下面内容配置。如果你的 settings.json 里已经有其他配置,请合并到同一个 JSON 对象里,注意逗号。

settings.json
{
  "workbench.colorTheme": "Dark Modern",
  "chatgpt.cliExecutable": "",
  "chatgpt.apiBase": "https://api.kelaodealics.icu/v1",
  "chatgpt.config": {
    "preferred_auth_method": "apikey",
    "model": "gpt-5.4",
    "model_reasoning_effort": "xhigh",
    "wire_api": "responses"
  }
}

保存配置后重启 VS Code,再进入插件侧边栏测试连接。

请参考视频教程

Plugins

VSCode / Cursor 插件配置

插件连接前,一定先在终端中完成上面的配置,并确认 codex 命令已经可以正常对话。

VSCode Codex 插件

  • 在 VSCode 扩展商店搜索并安装官方 codex 插件,认准带 OpenAI 认证的版本。
  • 安装完成后,Codex 会出现在 VSCode 左侧边栏。
  • 如果无法正常对话,打开 VSCode 设置,搜索 @ext:openai.chatgpt
  • 点击“在 settings.json 中编辑”,在 JSON 最下面加入下面配置;如果前面已有配置项,请注意逗号。
settings.json 片段
"chatgpt.apiBase": "https://api.kelaodealics.icu/v1",
"chatgpt.config": {
  "preferred_auth_method": "apikey",
  "model": "gpt-5.4",
  "model_reasoning_effort": "xhigh",
  "wire_api": "responses"
}

保存之后重启 VSCode,即可重新使用。

Cursor Codex 插件

  • Cursor 中同样先安装官方 codex 插件。
  • 打开左上角 File,进入 Preferences,再进入 VSCode Settings,搜索 settings
  • 点击“在 settings.json 中编辑”,在 JSON 最下面加入下面配置;如果前面已有配置项,请注意逗号。
settings.json 片段
"chatgpt.apiBase": "https://api.kelaodealics.icu/v1",
"chatgpt.config": {
  "preferred_auth_method": "apikey",
  "model": "gpt-5.4",
  "model_reasoning_effort": "xhigh",
  "wire_api": "responses"
}

保存之后重启 Cursor,即可重新使用。

请参考视频教程

Check

完成检查

Mac / Linux 用户确认 config.toml 中的 base_urlhttps://api.kelaodealics.icu/v1
确认 auth.json 中的 OPENAI_API_KEY 已替换为自己的 sk- 开头令牌。
配置完成后一定重启终端,再进入工程目录运行 codex 测试。
VSCode 或 Cursor 插件连接前,先确认终端里的 codex 已经可以正常对话。