必须满足操作系统(Win10 v1809+或Win11,仅64位)、硬件(最低4GB内存、推荐8GB+、预留2GB以上磁盘空间)、网络(稳定直连OpenAI或配置中转API Key)和权限(管理员身份)四方面硬性条件,否则安装中断或无法调用模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Windows系统上顺利安装并使用Codex,必须满足操作系统、硬件、网络和权限四方面硬性条件,缺一不可,否则安装过程会中断或启动后无法调用模型。
系统与硬件基础要求
操作系统必须为 Windows 10(v1809+)或 Windows 11,且仅支持64位系统,32位系统完全不兼容,强行尝试会导致安装包无法运行。
内存最低需 4GB,但若开启 Computer Use 功能或处理中等规模项目,8GB 及以上才可避免卡顿和响应超时。
磁盘空间预留至少 2GB,用于缓存模型元数据、日志及临时沙箱环境;若后续启用本地代码执行,建议预留 5GB 以上空闲空间。
网络与账户准备
必须拥有稳定、可直连 OpenAI API 的网络环境。国内用户若无法访问 api.openai.com,需提前配置可用的中转服务(如 Yunaicode、Coding Plan 或 OpenRouter),并获取对应 API Key。
账户无需付费订阅,但必须完成邮箱注册与验证;首次启动 Codex 桌面版或 CLI 时,会强制触发登录流程,不登录无法进入主界面或执行任何命令。
注意:浏览器登录方式比 API Key 更易通过国内网络环境,推荐新手优先选用。
通过 Codex CLI 生成图片,支持尺寸控制和批量模式。依赖:codex (npm)。代理默认启用。用 generate.sh 生成单张,batch_generate.sh 批量生成游戏 UI 素材,gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
核心依赖:Node.js 安装(仅 CLI 模式必需)
方法一:官网下载安装
访问 nodejs.org,下载 Windows 64 位 .msi 安装包(务必选 Node.js 22 LTS 或更高版本)→ 双击运行 → 勾选 “Add to PATH” → 其余默认 → 完成安装。
方法二:校验是否生效
以管理员身份打开 PowerShell → 执行 node -v 和 npm -v → 两行均输出版本号(如 v22.4.1、v10.8.2)即成功。
方法三:加速国内依赖安装(可选但强烈建议)
执行 npm config set registry https://registry.npmmirror.com,否则 npm install codex 可能因超时失败。
可选但强推的辅助工具
第一步:安装 Git
执行 git --version 能返回版本号即可,Codex 修改文件时不会自动提交,但 Git 能让你在改崩后 3 秒内 git restore . 恢复全部改动。
第二步:准备独立测试项目
新建一个空文件夹,例如 D:\codex-test,不要用已有 Git 仓库或生产项目——Codex 当前版本尚无操作确认弹窗,误删文件无法撤销。
第三步:选择编辑器(非必需,但提升效率)
VS Code 是目前对 Codex IDE 扩展支持最完善的编辑器,安装后启用 Codex 插件,即可在侧边栏直接发起对话并编辑当前打开的文件。

















