Codex 可以在桌面应用、终端、IDE、云端和手机上使用。多端配置最关键的是确定两件事：你从哪里发消息，任务又在哪台机器上执行。
资料核对日期：2026 年 9 月 8 日。本文按官方当前入口整理；终端命令见 Codex 安装与初始配置。
各端分别负责什么
| 入口 | 常见用途 | 文件与命令在哪里 |
|---|---|---|
| 桌面应用里的 Codex | 管理项目、查看文件和修改结果 | 所选本地目录或任务环境 |
| Codex CLI | 在终端里处理项目 | 启动它的电脑或远程开发环境 |
| IDE 集成 | 围绕当前文件和选中代码工作 | 编辑器打开的项目环境 |
| Codex cloud | 让长任务在后台继续运行 | 云端仓库环境 |
| 手机 Remote | 查看、指导电脑上的任务 | 已连接的 Mac 或 Windows 电脑 |
桌面端安装与首次配置
官方桌面文档 当前将桌面入口列为 ChatGPT 桌面应用。安装后，在产品下拉菜单中选择 Codex 来处理代码项目。
macOS / Windows
- 从官方桌面页面进入对应系统的下载入口。
- 安装后启动应用，登录自己的 ChatGPT 账号。
- 选择 Codex，新建或打开项目，选择真实的项目文件夹。
- 确认任务显示的工作位置。
- 发送一次文件解释任务，再尝试小范围修改。
macOS 下载时注意支持的芯片型号。Windows 支持原生 PowerShell 与 Windows 沙盒，也可以在设置中选择 WSL 2 作为 Agent 环境。
集成终端的类型和 Agent 的执行环境是分别设置的。 把终端切换为 WSL，不代表 Agent 已经切换为 WSL。需要时在设置里调整 Agent 环境并重启应用，详见 Windows 官方指南。
Linux
官方 Linux 桌面应用目前处于 preview，支持的桌面发行版包括 Ubuntu 24.04 / 26.04、Debian 13、Fedora 43 / 44，提供 x64 与 ARM64 包。
按 Linux 桌面安装页 选择对应安装包：Ubuntu / Debian 使用 .deb，Fedora 使用 .rpm。
例如，下载页面列出的 x64 Debian 包后，在下载目录执行：
sudo apt install ./chatgpt_amd64.deb文件名以实际下载的文件为准。安装后从应用菜单打开 ChatGPT，登录并选择 Codex。Linux preview 中部分功能仍有平台限制，不能直接套用 macOS 的所有功能说明。
VS Code、Cursor、Windsurf
从 官方 IDE 页面 选择编辑器的安装链接，核对扩展由 OpenAI 提供。
- 在编辑器中打开项目文件夹。
- 安装 Codex 扩展并登录。
- 点击 Codex 图标；找不到图标时，在命令面板中运行 Codex: Open Codex Sidebar。
- 打开目标文件，把当前文件或选中代码加入问题。
- 先让 Codex 解释，再要求修改，最后查看差异。
在 WSL 或 SSH 环境下开发时，确认当前窗口连接的是正确的环境。终端显示 /home/... 与显示 C:\...，对应的是不同的工具和依赖位置。
Xcode 和 JetBrains IDE 使用各自提供的 Codex 集成。官方当前说明是：Xcode 在 coding assistant 中选择 Codex；JetBrains 在 AI Chat 中选择 Codex。具体可用性取决于 IDE 版本和账号。
云端：先连接仓库，再发任务
从 Codex cloud 官方页面 进入云端产品：
- 使用 ChatGPT 账号登录。
- 按提示连接 GitHub，选择需要使用的仓库；官方也提供 GitLab beta 接入。
- 为仓库创建环境，配置依赖、安装步骤和必要的环境变量。
- 选择环境，描述一个边界清楚的任务。
- 完成后查看改动和检查结果，再决定是否创建或合入 PR。
可以先尝试：
阅读仓库，补充 README 中的本地启动步骤。以当前依赖文件和脚本为依据，检查文档里的命令是否存在。
云端使用仓库中的文件。电脑里还没提交和同步的改动，不会自动进入这次云端任务；本地的密钥和依赖也需要在云端按需另行配置。
手机：Remote 连接自己的电脑
官方当前的手机 Remote 使用 ChatGPT 手机应用，连接 Mac 或 Windows 电脑。功能是否出现取决于开放进度和工作区设置。
配置步骤：
- 在电脑上的桌面应用打开 Settings → Connections → Control this Mac or PC。
- 选择 Set up 或 Add，完成界面要求的访问确认和验证。
- 用手机扫描二维码，登录同一个 ChatGPT 账号和工作区。
- 在手机应用打开 Remote，选择连接的电脑和项目。
- 打开已有任务，发送一条后续要求，检查两端是否同步。
连接只应在自己的可信设备之间建立。连接完成后，电脑要保持唤醒和联网，因为读取文件、修改代码和运行测试仍发生在电脑上。
若希望电脑关闭后任务继续运行，需要使用云端任务，并确保云环境能拿到所需文件。
换电脑时迁移什么
代码、README 和 AGENTS.md 适合随 Git 仓库同步。个人 ~/.codex/config.toml 可以按需要迁移，但应检查本机路径和工具依赖；账号在新设备上重新登录。
CLI 与 IDE 扩展会共享同一用户环境下的配置层和缓存登录信息。Windows 原生环境和 WSL 默认使用不同的用户目录，两台独立电脑也不会自动共享本地依赖或全部任务历史。
迁移后可以让 Codex 做一次检查：
读取 README 和 AGENTS.md，列出这个项目在当前机器上需要哪些工具。先检查哪些已安装，再告诉我缺少什么。
多端常见问题
| 现象 | 优先检查 |
|---|---|
| 手机找不到电脑 | 两端账号、工作区、Remote 是否已连接、电脑是否在线 |
| 云端找不到刚改的文件 | 本地改动是否已提交并同步到选中的仓库分支 |
| IDE 能用，终端不能用 | 独立 CLI 是否已安装；是否处在同一用户和运行环境 |
| 切到 WSL 后仍执行 Windows 命令 | 是否只改了集成终端，没有改 Agent 环境 |
| 有的设备没有某项功能 | 核对平台支持、版本、开放进度和工作区策略 |