KKCode文档站

Appearance

Codex 部署教程 ​

https://kkcode.vip/

1. 必要安装 ​

1.1 下载 Git（建议） ​

  • Windows 主链接：https://github.com/git-for-windows/git/releases/download/v2.53.0.windows.1/Git-2.53.0-64-bit.exe
  • Windows 备用链接：https://registry.npmmirror.com/-/binary/git-for-windows/v2.51.0.windows.1/Git-2.51.0-64-bit.exe

1.2 下载 Node.js（桌面端） ​

  • Windows 主链接：https://nodejs.org/dist/v24.13.1/node-v24.13.1-x64.msi
  • Windows 备用链接：https://npmmirror.com/mirrors/node/v24.13.0/node-v24.13.0-x64.msi
  • macOS（M 系列 / Intel）：https://nodejs.org/dist/v24.13.1/node-v24.13.1.pkg

2. Codex 一键部署安装 ​

Win/Linux/Mac 终端执行。Windows 下通常不需要 sudo。

bash
# Codex 一键部署
sudo npm install -g pumpkinai-config
codex-config

执行完毕后，终端、VSCode 与 Cursor 的 Codex 插件可直接使用（按图中说明）。

如果一键配置异常，可按下方“手动安装 Codex”执行，再重新运行：

bash
codex-config

3. 手动安装 Codex ​

3.1 Mac/Linux ​

bash
sudo npm install -g @openai/codex

3.2 Windows（CMD / PowerShell） ​

bash
npm install -g @openai/codex

4. 验证安装 ​

bash
codex --version

出现类似 codex-cli 0.50.0 即表示安装成功。

5. Codex 卸载命令 ​

bash
npm uninstall -g @openai/codex

6. API 配置（配置后自动登录） ​

需要在 VSCode / Cursor 中使用时，先在终端配置并验证通过。

6.1 Windows 终端配置 ​

进入当前用户目录下 .codex 文件夹，例如：

text
C:\Users\用户名\.codex

如果没有 .codex，先创建目录，再创建两个文件：

text
config.toml
auth.json

config.toml ​

toml
model_provider = "codex"
model = "gpt-5.2-codex" # 可改为 "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://kkcode.vip/"
wire_api = "responses"
requires_openai_auth = true

auth.json ​

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

图中提示：请将 sk-xxx 替换为你自己的 API 密钥。

7. vscode/cursor 使用 codex 插件 ​

7.1 mac/linux ​

bash
cd ~
mkdir .codex
cd .codex
touch config.toml auth.json
cd .codex && code .

如果本机没有 VSCode，请手动编辑文件。

7.2 配置内容（与上方一致） ​

config.toml ​

toml
model_provider = "codex"
model = "gpt-5.2-codex" # 可改为 model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://kkcode.vip/"
wire_api = "responses"
requires_openai_auth = true

auth.json ​

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