Windows 版本教程

系统要求

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

安装步骤

前置步骤！！！

安装git bash，Git - Downloads (opens in a new tab)，点击这个链接，下载自己电脑系统对应的git bash，之后一直点下一步即可完成安装。

1. 安装 Node.js

访问 Node.js 官网 (opens in a new tab) 下载并安装最新 LTS 版本。

2. 安装 codex

打开命令提示符(CMD)或 PowerShell，运行：

npm install -g @openai/codex

3. 验证安装

打开命令提示符(CMD)或 PowerShell，运行：

codex --version

配置 API

1. 获取 Auth Token

访问 YourAPI Token 页面 (opens in a new tab) 进行以下操作：

• 点击控制台 -> API令牌页面

• 点击 添加令牌

• 令牌分组请选择：openai codex专用（务必选择此分组，否则无法使用）

• 令牌名称随意

• 额度建议：设置为无限额度

• 其他选项保持默认

  

2. 配置环境变量

重要提示：请将下方的 sk-xxx 替换为您在 yourapi.cn 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 yourapi.cn 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 yourapi.cn 生成的实际 API 密钥！

1. 进入当前用户的用户目录下的 .codex文件夹中，例如：C:\Users\testuser\.codex（注意如果看不到隐藏目录说明你没有打开windows的显示隐藏项目，打开方法如下所示）

   

   

2. 如果没有.codex文件夹，那么需要手动创建文件夹，然后创建config.toml以及auth.json两个文件

   

3. 填写配置(需要将sk-xxx替换成刚才自己创建的真实的sk)

   1. auth.json中的配置

      {
      "OPENAI_API_KEY": "sk-xxx"
      }

   2. config.toml中的配置（原封不动直接粘贴下面的即可），model_reasoning_effort 可选择的有high medium low，代表模型思考的努力程度，分别为（高、中、低）

      model_provider = "yourapi"
      model = "gpt-5-codex"
      model_reasoning_effort = "high"
      disable_response_storage = true
      preferred_auth_method = "apikey"
      [model_providers.yourapi]
      name = "yourapi"
      base_url = "https://yourapi.cn/v1"
      wire_api = "responses"

启动 codex

重启终端！，重启终端！，**重启终端！**然后进入到工程目录

cd your-project-folder

然后，运行以下命令启动：

codex

vscode插件 codex

以上配置完成后直接安装即可

安装完成后会出现在侧边栏

常见问题

出现错误请按照如下步骤排查

1.key创建的是否正确，额度选择无限额度，不要限制模型，分组选择openai codex专用

2.实在解决不了可以联系QQ：2137994192

常见命令参考（按需使用）

内置斜杠命令

更多codex配置及使用详情参考claude官网 codex 官方教程 (opens in a new tab)