Codex 使用教程 - 极速安装指南

快速生成配置命令

输入你的 API Key，下面的教程命令将自动更新，可直接复制使用。

你的 API KEY (sk-...)

安装 Node.js 环境

Codex 需要 Node.js 环境才能运行。建议安装 LTS (长期支持) 版本。

官网下载（推荐）

1. 访问 nodejs.org
2. 点击 "LTS" 版本进行下载
3. 运行 .msi 文件按默认引导安装

命令行安装

# 使用 Scoop

scoop install nodejs

# 或使用 Choco

choco install nodejs

Windows 注意事项

建议使用 PowerShell 而不是 CMD
如果遇到权限问题，尝试以管理员身份运行
某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

# 检查 Node.js 版本

node --version

# 检查 npm 版本

npm --version

如果显示版本号，说明安装成功了！

安装 Codex

打开 PowerShell 或 CMD，运行以下命令：

# 全局安装 Codex

npm install -g @openai/codex

# 国内镜像（下载慢可用）

npm install -g @openai/codex --registry=https://registry.npmmirror.com

这个命令会从 npm 官方仓库下载并安装最新版本的 Codex。

提示

建议使用 PowerShell 而不是 CMD，功能更强大
如果遇到权限问题，以管理员身份运行 PowerShell

验证 Codex 安装

安装完成后，输入以下命令检查是否安装成功：

codex --version

如果显示版本号，恭喜你！Codex 已经成功安装了。

修改配置文件

修改 C:/用户/<用户名>/.codex/config.toml 和 C:/用户/<用户名>/.codex/auth.json 文件。

如果没有上述文件夹或文件，需要手动创建它们。

config.toml

model_provider = "qmcode"
model = "gpt-5.3-codex" # 可设置gpt-5.2 gpt-5.2-codex等模型
model_reasoning_effort = "high"

[model_providers.qmcode]
name = "qmcode"
base_url = "https://611996.xyz/v1"
wire_api = "responses"

auth.json

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

开始使用

现在你可以开始使用 Codex 了！

启动 Codex

codex

在特定项目中使用

# 进入你的项目目录

cd C:\path\to\your\project

# 启动 Codex

codex

如需在 VSCode 中使用 Codex，上述步骤完成后，再在扩展中安装 Codex 插件即可。（上面的步骤不能跳过）

安装 Node.js 环境

# 使用 Homebrew 安装

brew install node

或者访问 nodejs.org 下载 .pkg 安装包。

验证安装是否成功

安装完成后，打开 Terminal，输入以下命令：

# 检查 Node.js 版本

node --version

# 检查 npm 版本

npm --version

如果显示版本号，说明安装成功了！

安装 Codex

打开终端，运行以下命令：

# 使用 sudo 全局安装

sudo npm install -g @openai/codex

# 国内镜像（下载慢可用）

sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com

在 macOS 上，全局安装通常需要管理员权限（sudo）。

提示

如果提示 Enter password，请输入你的 Mac 登录密码（输入时不会显示字符）
建议在安装完成后运行验证命令确保路径已生效

验证 Codex 安装

安装完成后，输入以下命令检查是否安装成功：

codex --version

如果显示版本号，恭喜你！Codex 已经成功安装了。

修改配置文件

修改 ~/.codex/config.toml 和 ~/.codex/auth.json 文件。

如果没有上述文件夹或文件，需要手动创建它们。

config.toml

model_provider = "qmcode"
model = "gpt-5.3-codex" # 可设置gpt-5.2 gpt-5.2-codex等模型
model_reasoning_effort = "high"

[model_providers.qmcode]
name = "qmcode"
base_url = "https://611996.xyz/v1"
wire_api = "responses"

auth.json

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

开始使用

现在你可以开始使用 Codex 了！

启动 Codex

codex

在特定项目中使用

# 进入你的项目目录

cd /path/to/your/project

# 启动 Codex

codex

如需在 VSCode 中使用 Codex，上述步骤完成后，再在扩展中安装 Codex 插件即可。（上面的步骤不能跳过）

安装 Node.js

# Ubuntu/Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装是否成功

安装完成后，打开终端，输入以下命令：

# 检查 Node.js 版本

node --version

# 检查 npm 版本

npm --version

如果显示版本号，说明安装成功了！

安装 Codex

在终端中运行以下命令：

# 全局安装 Codex

sudo npm install -g @openai/codex

# 国内镜像（下载慢可用）

sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com

Linux 系统通常需要 sudo 权限来安装全局 npm 包。

提示

如果不想使用 sudo，建议配置 npm 全局目录到用户目录下
WSL2 用户请确保 Node.js 环境已在子系统中正确安装

验证 Codex 安装

安装完成后，输入以下命令检查是否安装成功：

codex --version

如果显示版本号，恭喜你！Codex 已经成功安装了。

修改配置文件

修改 ~/.codex/config.toml 和 ~/.codex/auth.json 文件。

如果没有上述文件夹 or 文件，需要手动创建它们。

config.toml

model_provider = "qmcode"
model = "gpt-5.3-codex" # 可设置gpt-5.2 gpt-5.2-codex等模型
model_reasoning_effort = "high"

[model_providers.qmcode]
name = "qmcode"
base_url = "https://611996.xyz/v1"
wire_api = "responses"

auth.json

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

开始使用

现在你可以开始使用 Codex 了！

启动 Codex

codex

在特定项目中使用

# 进入你的项目目录

cd /path/to/your/project

# 启动 Codex

codex

如需在 VSCode 中使用 Codex，上述步骤完成后，再在扩展中安装 Codex 插件即可。（上面的步骤不能跳过）

备注（最简单的配置方法）

也可省略上述步骤，直接修改 OPENAI_BASE_URL 环境变量为 https://611996.xyz/v1，登录方式按照官方正常的 API Key 登录。

注意：新手不推荐这种配置方法，可能会影响到其他工具的配置和使用。

🎉 恭喜你！安装配置完成后，即可享受 AI 编程助手带来的便利。