在 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 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、服务地址和账户额度。