跳到正文

Windows 安装 Codex

Windows 上配置 Codex 桌面客户端或 CLI,接入本站 API Key。

1

选择使用方式

  • 首次使用:从本步骤开始。
  • 已安装桌面端或能运行 codex:从第 3 步开始。
  • 像普通软件一样安装和打开。
  • 无需 Node.js、npm 或 CLI。
打开 OpenAI 官方安装说明
2

安装客户端

打开 OpenAI 官方安装说明
  • 根据你的系统下载并安装 Codex 桌面客户端。
  • 已安装可跳过此步。
3

准备 API Key

从交付信息复制完整 API Key,不带前后空格。

已有自定义配置时,先备份 config.tomlauth.json

4

运行配置命令

Windows 键搜索并打开 PowerShell,不要使用 CMD。

粘贴命令执行,按提示输入 API Key。

&([scriptblock]::Create((irm https://console.novamodelhub.com/install/codex.ps1))) -Mode desktop

写入 config.tomlauth.json,不安装 CLI。

出现 Codex 配置已完成 后,按提示回车结束。

中途报错时保留错误信息,按第 6 步排查。

5

重启并验证

完全退出客户端后重新打开,仅关闭窗口可能不会生效。

  • 在右下角通知区域找到 Codex 图标;隐藏时展开小三角。
  • 右键图标,选择 Quit / Exit / 退出
  • 从开始菜单或桌面快捷方式重新打开。

发送一个简单请求,确认收到响应,再到用量查询核对 Key 状态。

6

检查配置

连接失败时,打开配置目录核对文件与备份:

explorer $env:USERPROFILE\.codex

向支持人员提供文件名和报错信息时,请隐藏 Key,不公开完整 auth.json

常见问题

提示找不到 codex 命令

按 CLI 安装步骤补齐环境,再重新打开 PowerShell。桌面客户端用户无需安装 CLI。

出现 401、429 或连接中断

401 先核对 Key 与接口地址;429 检查错误详情、额度及频率限制;连接中断时检查网络与客户端提示。可通过用量查询确认套餐状态。

如何恢复原来的配置?

默认目录为 C:\Users\你的用户名\.codex。将配置前保存的对应文件恢复后重启客户端;如果设置过其他配置目录,核对实际读取位置。排错时隐藏 Key,不公开完整 auth.json

联系支持

扫码添加微信,备注「进群」,我拉你进用户交流群。

微信用户交流群二维码