Codex 应用下载安装与第一次使用
如果你希望直接使用图形界面,可以下载安装 Codex 桌面应用,不需要先安装 Node.js、npm 或 Codex CLI。应用提供项目管理、任务对话、文件修改、命令执行和差异审查等完整工作界面。
进入 OpenAI 官方下载页面
访问 OpenAI 的 Codex 中文页面:
在页面中选择与你电脑匹配的安装包。官方页面会持续提供当前版本,建议始终从这里下载,不要使用来源不明的第三方安装包,也不要长期保存可能已经过期的安装地址。
目前 Codex 桌面应用的官方资料覆盖 macOS 和 Windows。页面显示的具体系统版本、芯片架构和安装包要求可能随版本更新,请以下载页面当时显示的信息为准。
macOS 安装步骤
- 在官方下载页面选择 macOS 版本。
- 下载完成后打开安装包。
- 按安装界面提示,将 Codex 放入“应用程序”目录。
- 从“应用程序”或 Launchpad 启动 Codex。
首次打开时,macOS 可能显示来自系统的应用确认提示。请先确认安装包来自 OpenAI 官方页面,再按照正常系统流程打开;不建议为了安装而关闭系统安全保护。
如果下载页面提供不同芯片版本,可在苹果菜单的“关于本机”中查看当前 Mac 的芯片信息,然后选择匹配的安装包。
Windows 安装步骤
- 在官方下载页面选择 Windows 版本。
- 打开下载完成的安装程序。
- 按安装向导完成安装。
- 从开始菜单启动 Codex。
如果 Windows 显示安全确认,请核对文件来源和发布者。公司电脑可能受到管理员的软件安装策略限制,这种情况应联系设备管理员,不要绕过组织的安全策略。
首次启动与登录
打开 Codex 后,按照应用中的引导完成登录。可用登录方式、账号套餐和工作区权限可能随账号类型变化,以应用实际显示的选项为准。
没有 ChatGPT 账号或套餐?可以考虑第三方 API
如果你没有可用于 Codex 的 ChatGPT 账号,或者暂时不准备开通相应套餐,可以考虑使用第三方 OpenAI-compatible API。APIBest 的 API 地址为 https://apibest.org/v1,面向国内使用场景可以直接连接,并提供更灵活的模型选择。你可以根据速度、价格和任务类型选择 gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5,以及服务商提供的其他兼容模型。
具体步骤见 使用 APIBest 为 Codex 配置自定义 API。
登录完成后,应用会进入项目或任务界面。第一次使用时建议先选择一个用于练习的本地 Git 项目,不要直接打开包含生产密钥或大量未提交改动的重要仓库。
保护账号与密钥
只在官方应用内完成账号登录。不要把密码、验证码或 API Key 发给第三方,也不要把真实密钥写入项目文件、AGENTS.md 或 Git 仓库。
添加本地项目
在应用中选择添加或打开本地项目,然后选中 Git 仓库的根目录。一个正确的项目根目录通常包含 .git、README.md、package.json、pyproject.toml 或其他项目配置。
打开项目后,先确认三件事:
- 应用显示的路径确实是目标仓库。
- 当前分支和未提交改动符合你的预期。
- 项目的安装、测试和构建方式已经记录在 README 或
AGENTS.md中。
Codex 会根据项目中的文件和指令理解代码库。选择过大的上层目录会引入无关文件,也会扩大可访问范围,因此应尽量只打开实际需要处理的仓库。
选择合适的权限
Codex 在执行文件修改和命令时会受到权限与审批策略控制。第一次使用建议保持需要确认的安全模式,让应用在执行超出普通工作区范围的操作前询问你。
批准操作前要检查命令、文件路径和网络目标。删除文件、安装依赖、访问项目外目录或连接外部服务时,不要只看“允许”按钮,应先确认操作与当前任务一致。
更完整的说明见 Codex 沙箱、权限与命令审批。
开始第一个任务
第一次任务建议从只读调查开始:
阅读当前项目的 README 和主要配置文件,告诉我项目如何启动、如何运行测试。先不要修改文件。
这个任务可以检查 Codex 是否正确识别了项目,又不会立即写入代码。确认结果后再尝试一个小范围任务:
为工具函数
formatDate补充无效日期的测试。沿用现有测试风格,只修改相关文件,并运行对应测试。
完成后使用应用的差异审查界面检查实际改动,并确认 Codex 是否真的运行了测试。不要只根据完成摘要判断代码是否正确。
使用 APIBest 自定义 API
如果你准备通过 https://apibest.org/v1 使用自定义模型提供商,安装应用后继续阅读 使用 APIBest 为 Codex 配置自定义 API。模型提供商属于当前机器的用户级配置,不应写入项目仓库。
第三方 API 是否支持桌面应用当前版本所需的 Responses 流式协议、工具调用和模型能力,需要以实际测试结果为准。能完成普通聊天不代表能够完成完整编码代理任务。
常见安装问题
下载页面没有适合的版本
先确认操作系统和芯片架构是否满足官方下载页面的当前要求。不要下载其他网站重新打包的安装程序。Linux 用户如果在官方页面看不到桌面安装包,说明当前没有适合该平台的桌面版本。
应用无法打开
重新从官方页面下载安装,并检查系统版本、磁盘空间和企业设备策略。不要通过关闭操作系统安全功能来强行运行来源无法确认的文件。
无法登录
检查系统时间、网络连接、账号状态以及组织工作区策略。能够打开应用并不代表当前账号一定具有所有 Codex 功能。
无法读取项目
确认应用获得了访问项目目录所需的系统权限,并检查项目是否位于受保护、只读或云盘尚未同步完成的位置。尽量先用一个本地小型仓库验证。
官方资料
下载入口、支持平台和界面可能随版本更新。本文不固定具体安装包文件地址,确保读者始终从 OpenAI 官方页面取得当前版本。