OpenAI 的 Codex 现在有三个入口:电脑桌面应用、命令行工具(CLI),以及手机上的 ChatGPT 应用。很多人第一次装会卡在「到底该下哪个」和「手机上那个是不是要单独下载」这两件事上。这篇把电脑端和手机端的安装、登录、配对一次讲清楚,并列出几个最容易踩的坑。
本文信息核对时间:2026 年 11 月 10 日。安装包与功能迭代较快,以官方页面显示为准。
一、先分清三个形态,别下错
- Codex 桌面应用(App):图形界面,能同时管理多个任务、并行跑工作、查看项目文件。支持 macOS、Windows,官方也提供 Linux 入口。这是大多数人该装的。
- Codex CLI:终端里的命令行版本,开源在 GitHub,适合习惯命令行的开发者、脚本化与 CI 场景。
- 手机端:不需要单独下载任何 App。OpenAI 把 Codex 做进了 ChatGPT 移动应用(iOS 与 Android),手机在其中扮演的是「遥控器」——代码真正跑在你自己的电脑上,手机负责发起任务、看进度、审批下一步。
二、电脑端安装
macOS:打开官方下载页 https://chatgpt.com/download/,取 macOS 版安装包(dmg),拖进「应用程序」文件夹即可。也可以直接走官方直链 https://persistent.oaistatic.com/codex-app-prod/Codex.dmg。首次启动用 ChatGPT 账号登录。
winget install --id 9PLM9XGG6VKS -s msstore
Linux:官方提供 Linux 版入口,按官方页面的发行版指引安装。
如果你之前装过旧版 Codex 应用,不用重装,它会自动更新;旧版现在在应用内被标为「Classic」,新版才是默认入口。
三、CLI(可选,给习惯终端的人)
先确认本机有 Node.js 与 npm,然后二选一:
npm install -g @openai/codex # 通用 brew install --cask codex # macOS 用 Homebrew
装完执行 codex --version 验证,能看到版本号即成功;没有输出时优先检查 Node 版本、npm 全局路径与网络。后续用 codex 直接进入,或用 codex app 从终端拉起桌面图形界面。
四、登录:两种方式
方式一(推荐):ChatGPT 账号登录。首次运行会自动触发,也可手动执行:
codex login
浏览器会弹出授权页,登录你的 ChatGPT 账号即可,凭证自动保存。支持 ChatGPT Plus、Pro、Business、Edu、Enterprise 订阅;OpenAI 也曾限时向 Free 与 Go 用户开放。没有浏览器环境时可用 codex login --device-auth 走设备码流程。
方式二:API Key。适合不打算用订阅、走 API 计费的场景,把密钥通过 codex login --with-api-key 或环境变量传入。
五、手机端安装与配对
手机端的「安装」其实只有一步:把 ChatGPT 应用更新到最新版(iOS 与 Android 均可)。更新后,ChatGPT 底部导航或侧边菜单里会出现 Codex 入口。配对流程如下:
- 在电脑上打开 Codex 应用,保持运行;
- 在应用里找到手机配对入口(界面上通常写作「Set up Codex Mobile」或远程连接);
- 电脑会显示一个二维码,用手机 ChatGPT 里的 Codex 扫码;
- 手机上确认授权,完成后即可看到你电脑上正在运行的线程列表与各自状态(运行中/等待审批/已完成)。
连上之后手机能做三件事:接着做电脑上没做完的任务;任务完成或卡住时收到提醒;直接从头发起一个新任务。适合通勤、开会、离开工位时盯进度。
需要注意:手机端不是把模型装进手机本地跑,所有执行仍发生在电脑上,所以电脑要开机、Codex 要保持运行、网络要通。配对能力的平台支持范围以桌面端设置页是否出现该入口为准(早期版本仅支持 macOS 作为被控端),Windows 用户请先在应用内确认。
六、四个容易踩的坑
- 别下山寨应用:应用商店里有开发者名不是 OpenAI 的同名「Codex」应用,还有第三方站点提供的「Codex 下载」,都不是官方版本。官方入口只有
chatgpt.com/download、微软商店(ID 9PLM9XGG6VKS)与官方 GitHub 仓库。 - 桌面版和 CLI 不要搞混:桌面版解决「多任务并行、看文件」,CLI 解决「终端里快速改代码、写进脚本」;两者共用同一个账号,可以都装。
- 旧版叫 Classic:找不到新界面时先确认自己开的是不是旧版窗口。
- 手机端扫码扫不上:先确认电脑端应用是最新版、ChatGPT 也更新到最新版,再重开配对页刷新二维码;仍不行就退出重登。
七、适合谁
想让 AI 直接在自己项目里改代码、跑命令的人;经常离开工位但需要盯长任务进度的开发者;以及想给团队统一一套「电脑执行 + 手机审批」工作流的团队。
官方入口
- 统一下载页:https://chatgpt.com/download/
- Codex 介绍与平台说明:OpenAI · Introducing the Codex app
- Windows 微软商店:Microsoft Store · Codex
- CLI 开源仓库:github.com/openai/codex
版权与合规提示:Codex 为 OpenAI 产品,安装包与商标归其所有,本文仅整理公开可查的安装路径,不提供任何非官方下载镜像。