跳到主要内容

Codex CLI 接入指南

Codex CLI 是 OpenAI 推出的命令行 AI 编程助手，可以在终端中帮你生成代码、解释代码、回答编程问题。

安装​

步骤 1：安装 NVM（Node 版本管理器）

NVM 是用来管理 Node.js 版本的工具，安装它之后才能安装 Node.js。

  1. 打开浏览器，访问 https://github.com/coreybutler/nvm-windows/releases
  2. 找到最新版本，下载 nvm-setup.exe 文件
  3. 双击运行安装，一路点「下一步」即可完成

步骤 2：安装 Node.js

打开 PowerShell（在开始菜单搜索「PowerShell」，右键选择「以管理员身份运行」），依次输入以下命令：

# 安装最新 LTS 版本
nvm install lts

# 使用该版本
nvm use lts

# 验证安装，会显示版本号
node --version
npm --version

步骤 3：安装 Codex CLI

继续在 PowerShell 中输入：

npm install -g @openai/codex@latest

步骤 4：验证安装

安装完成后，输入以下命令，如果显示版本号说明安装成功：

codex --version

配置 weelinking​

需要在用户目录下创建一个 .codex 文件夹，并在里面放两个配置文件。请根据你的操作系统，按照以下步骤操作：

步骤 1：创建配置文件夹

  1. 打开文件资源管理器，在地址栏输入 %USERPROFILE% 并回车，进入你的用户目录（一般是 C:\Users\你的用户名\）
  2. 新建一个文件夹，命名为 .codex

步骤 2：创建 config.toml 文件

  1. 在 .codex 文件夹内，新建一个文本文件，将文件名改为 config.toml（注意去掉 .txt 后缀）
  2. 用记事本打开 config.toml，粘贴以下内容并保存：
model_provider = "weelinking"
model = "gpt-5.3-codex"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true

[model_providers.weelinking]
name = "weelinking"
base_url = "https://api.weelinking.com/v1"
wire_api = "responses"
requires_openai_auth = true

步骤 3：创建 auth.json 文件

  1. 在同一个 .codex 文件夹内，再新建一个文本文件，将文件名改为 auth.json（注意去掉 .txt 后缀）
  2. 用记事本打开 auth.json，粘贴以下内容并保存：
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

将 YOUR_API_KEY 替换为你的实际 API Key。

使用方法​

交互模式​

直接输入 codex 进入对话模式，可以连续提问：

codex

直接执行​

在 codex 后面加上引号和你的需求，一次性获得结果：

codex "写一个 Python 快速排序算法"

让 Codex 读取文件内容​

你可以把文件内容传给 Codex，让它帮你分析或解释代码：

Get-Content code.py | codex "解释这段代码"

其中 code.py 替换为你实际的文件名。| 是管道符号，意思是把前面命令的输出传给后面的 Codex。

功能特色​

  • 代码生成：用自然语言描述需求，自动生成代码
  • 代码解释：看不懂的代码丢给它，帮你逐行解释
  • 命令行集成：直接在终端中使用，无需切换窗口
  • 多语言支持：Python、JavaScript、Go、Java 等主流语言都支持

推荐模型​

场景模型
代码生成gpt-5.3-codex
快速问答gpt-4o-mini
复杂任务gpt-5.4

常见问题​

命令找不到​

输入 codex 提示"不是内部或外部命令"时，说明系统找不到 Codex 的安装位置，需要手动添加：

  1. 在 PowerShell 中输入 npm config get prefix，记下显示的路径
  2. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
  3. 在「用户变量」中找到 Path，双击打开，点击「新建」
  4. 将上面记下的路径粘贴进去，末尾加上 \bin（例如 C:\Users\你的用户名\AppData\Roaming\npm）
  5. 点击「确定」保存，重新打开 PowerShell 再试

API 连接失败​

  1. 打开上面创建的 .codex 文件夹，检查 config.toml 中的地址是否填写正确
  2. 检查 auth.json 中的 API Key 是否有效
  3. 确认网络连接正常

Node.js 版本问题​

Codex CLI 需要 Node.js 18 或更高版本。在终端中输入以下命令检查：

node --version

如果显示的版本号低于 18（例如 v16.x.x），需要升级：

nvm install --lts
nvm use --lts