在 Windows 安装 Codex:CLI 与桌面应用

在 Windows 上安装 Codex CLI 或桌面应用,了解前置条件、验证步骤和常见故障。

本文介绍在 Windows 上安装 Codex CLI 和桌面应用。CLI 在终端中运行;桌面应用提供图形界面。选择一种即可,不必同时安装。

安装 Codex CLI

准备 Windows 11,或更新到较新版本的 Windows 10。OpenAI 对 Windows 10 提供尽力支持;详见 Windows 支持说明。先从 Node.js 官方下载页 安装包含 npm 的 Node.js,然后打开 PowerShell,检查:

node --version
npm --version

两条命令都显示版本号后,运行:

npm install -g @openai/codex
codex --version

显示 Codex 版本号表示 CLI 已安装。进入项目文件夹后运行 codex,按提示登录;也可以按 Codex CLI 配置接入 GetToken。首次启动后发送一个简单问题,收到回复才能确认登录或服务配置可用。安装与登录是两个独立步骤。

安装 Codex App

Windows Codex 安装教程

下面是第三方下载页,可获取 Windows x64 .exe 安装包;请自行核对下载来源:

安装前确认使用 64 位 Windows;下载后打开安装包,按提示完成安装并启动应用。若要接入 GetToken,请准备 API Key。

写入 GetToken 配置

Codex App 会读取 %USERPROFILE%\.codex。推荐使用 PowerShell 自动配置:

$env:GETTOKEN_API_KEY='<你的 GetToken API Key>'; $env:GETTOKEN_BASE_URL='https://api.clawto.link'; irm 'https://yinziai-public-1257376750.youidian.com/scripts/codex-install-config.ps1' | iex

脚本会创建 config.toml 和 auth.json;检测到旧配置时会先备份。

完成首次测试

完全退出并重新打开 Codex App,新建或打开一个项目,发送:

你好,请用一句话介绍你自己。

收到正常回复,就表示安装和配置已经生效。

常见问题

  • node 或 npm 无法识别:确认 Node.js 已安装,关闭并重新打开 PowerShell,再检查版本;仍失败时检查 PATH。
  • codex 无法识别:确认 npm 安装没有报错,重新打开 PowerShell;检查 npm prefix -g 指向的全局命令目录是否在 PATH 中。
  • PowerShell 阻止运行脚本:先查看错误信息和组织的执行策略;可在命令提示符中重试,或联系管理员,不必直接降低安全策略。
  • 没有读取到配置:确认 %USERPROFILE%\.codex\config.toml 和 auth.json 存在,再重启 App。
  • 模型不可用:确认模型列表中有 gpt-5.6-sol,必要时参考「Codex App 配置」中的修复脚本。
  • 请求失败:检查 API Key、服务地址和账户额度。

本页内容