Codex下载站
第一步:下载 Codex 安装包
打开下载中心,点击下载按钮进入统一网盘地址,将安装包转存到自己的网盘后下载到本地。 网盘中包含各平台的安装文件,请根据你的系统选择对应的安装包。
Windows 版安装步骤
- 运行安装程序:双击下载好的 .exe 安装包。如果系统弹出"Windows 已保护你的电脑"提示,点击「更多信息」→「仍要运行」即可,这是因为安装包未经商店签名分发,属正常现象。
- 按向导完成安装:跟随安装向导选择安装目录(建议保持默认),点击「安装」,等待进度条完成。
- 启动 Codex:安装完成后桌面会出现快捷方式,双击启动。若提示权限不足,右键选择「以管理员身份运行」。
- 登录账号:首次启动会引导你使用 ChatGPT 账号登录,浏览器完成授权后会自动返回应用。
提示:部分精简版 Windows 系统缺少运行库,若启动报错缺少组件,安装提示中给出的运行库后重试。
macOS 版安装步骤
- 打开安装镜像:双击 .dmg 文件挂载镜像。Apple Silicon 机型请确认下载的是对应架构的安装包。
- 拖入应用程序文件夹:将窗口中的 Codex 图标拖入右侧的 Applications 文件夹,等待复制完成。
- 首次启动:在「启动台」或「应用程序」中打开 Codex。若提示"无法验证开发者",前往「系统设置 → 隐私与安全性」,点击「仍要打开」。
- 登录账号:与 Windows 版一致,首次启动使用 ChatGPT 账号登录即可。
CLI 命令行版安装(开发者推荐)
CLI 版适合习惯终端工作流的开发者,支持 Windows、macOS 与 Linux。网盘安装包内含离线安装方式; 如果你已具备 Node.js 环境,也可以直接使用 npm 在线安装:
npm i -g @openai/codex
国内网络环境下,如果 npm 下载缓慢,可以先切换为国内镜像源再安装:
npm config set registry https://registry.npmmirror.com
安装完成后,在终端输入以下命令验证是否成功:
codex --version
要求:Node.js 20 或更高版本。可用
node -v 查看当前版本,过低时请先升级 Node.js(建议 LTS 版本)。第二步:登录账号
Codex 支持两种方式登录,任选其一:
- ChatGPT 账号登录(推荐):在应用或 CLI 中执行登录命令后,浏览器会跳转授权页面,确认后自动完成登录。额度与你的 ChatGPT 订阅套餐相关。
- API Key 配置:在 OpenAI 平台创建 API Key,按引导填入即可。该方式按实际用量计费,适合需要精确控制成本的用户。
登录状态会自动保持,日常使用无需重复登录。
第三步:发起第一个任务
登录完成后,把 Codex 指向你的项目目录,然后用一句话描述目标即可。例如在终端中:
cd your-project
codex "为用户模块补充登录失败的单元测试"
Codex 会先扫描项目结构、阅读相关文件,然后给出改动计划,确认后开始修改代码并运行验证, 最后输出变更摘要。你可以逐步审查每一处改动,不满意随时要求重做或回滚。
常见安装报错与解决方法
| 现象 | 原因 | 解决方法 |
|---|---|---|
| Windows 提示"已保护你的电脑" | SmartScreen 对未签名程序的默认拦截 | 点击「更多信息」→「仍要运行」 |
| 安装时提示权限不足 | 当前账户无写入权限 | 右键安装程序,选择「以管理员身份运行」 |
| npm 安装超时或失败 | 默认源在国外,网络不稳定 | 切换 npmmirror 国内镜像源后重试 |
| CLI 提示 Node 版本过低 | Node.js 低于 20 | 升级 Node.js 至 20 以上(LTS 推荐) |
| 登录页面打不开 | 网络无法访问授权服务 | 检查网络与代理配置,或改用 API Key 方式 |
| macOS 提示"无法验证开发者" | Gatekeeper 拦截未公证应用 | 系统设置 → 隐私与安全性 → 「仍要打开」 |