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