Codex 安装与配置教程
适合第一次安装 Codex,或者想把不同系统配置步骤统一放进一个说明页的人。
没有任何收费方式,请勿被骗,请勿转卖
先看你对应的系统章节,再按顺序执行命令、创建令牌、写配置,最后启动 Codex 与安装插件。
Windows 版本教程
适合第一次配置 Codex 的 Windows 用户。建议先装 Git Bash,再安装 Node.js 与 Codex CLI。
系统要求
安装步骤
2. 安装 Codex CLI
npm install -g @openai/codex
3. 验证安装
codex --version
获取 API 令牌
Windows 章节要求令牌分组选择 codex专属。
- 访问
https://api.kelaodealics.icu,进入“控制台 → API令牌”。 - 点击“添加令牌”,令牌名称可自定义。
- 令牌分组选择
vip - 额度建议设置为“无限额度”,其他选项保持默认。
写入配置
请将下方的 sk-xxx 替换为你在 https://api.kelaodealics.icu 创建的真实 API 密钥。Windows 下配置目录通常是 C:\Users\testuser\.codex。如果看不到该目录,请先在资源管理器里开启“显示隐藏的项目”。
- 进入当前用户目录下的
.codex文件夹。 - 如果没有
.codex文件夹,请手动创建该文件夹,并在里面创建config.toml与auth.json两个文件。
{"OPENAI_API_KEY": "sk-xxx"}
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
安装 VSCode 插件
以上配置完成后,在 VSCode 扩展商店中搜索并安装 codex 即可。安装完成后,会出现在侧边栏中。
其他内容请参考视频教程
Mac / Linux 终端配置教程
系统要求
先注册账号,获取令牌
- 打开
https://api.kelaodealics.icu,点击右上角注册并登录。 - 登录后进入左侧创建密钥/令牌。
必要安装
1. Git
Mac 可以不单独安装 Git。Linux 如果系统没有 Git,请使用发行版自带包管理器安装。
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
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 密钥。
{
"OPENAI_API_KEY": "sk-xxx"
}
启动 Codex
以上处理完之后,启动 Codex 前请先重启终端,否则容易读不到新配置。
cd your-project-folder
codex
请参考视频教程
CAD 教程
本章节适合需要在 AutoCAD、Python 和 VS Code 环境中使用 Codex 插件的用户。涉及命令行检查的步骤,请使用 PowerShell 或 CMD 执行。
需要下载的软件
查看 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 对象里,注意逗号。
{
"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,再进入插件侧边栏测试连接。
请参考视频教程
VSCode / Cursor 插件配置
插件连接前,一定先在终端中完成上面的配置,并确认 codex 命令已经可以正常对话。
VSCode Codex 插件
- 在 VSCode 扩展商店搜索并安装官方
codex插件,认准带 OpenAI 认证的版本。 - 安装完成后,Codex 会出现在 VSCode 左侧边栏。
- 如果无法正常对话,打开 VSCode 设置,搜索
@ext:openai.chatgpt。 - 点击“在 settings.json 中编辑”,在 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 最下面加入下面配置;如果前面已有配置项,请注意逗号。
"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,即可重新使用。
请参考视频教程
完成检查
config.toml 中的 base_url 是 https://api.kelaodealics.icu/v1。auth.json 中的 OPENAI_API_KEY 已替换为自己的 sk- 开头令牌。codex 测试。codex 已经可以正常对话。