企业官网建设流程全解析

codex-desktop-linux 远程手机控制完整指南：如何用移动端远程驱动Linux桌面Codex

【免费下载链接】codex-desktop-linuxUnofficial ChatGPT desktop app for Linux (formerly the Codex app), built locally from OpenAI’s official macOS app. Includes Chat, Work, and Codex. Packages for Debian/Ubuntu (.deb), Fedora/openSUSE (.rpm), Arch (pacman), Nix/NixOS, and AppImage, with Wayland and X11 support.项目地址: https://gitcode.com/gh_mirrors/co/codex-desktop-linux

📱codex-desktop-linux 远程手机控制功能，让你用手机上的 ChatGPT App（iOS / Android）远程控制跑在 Linux 桌面上的 Codex 会话。codex-desktop-linux 是一个社区维护的非官方 ChatGPT Linux 桌面应用（前身为 Codex 应用），基于 OpenAI 官方 macOS/官方 Linux 包本地构建，内置 Chat、Work 和 Codex 三大模块，提供 Debian/Ubuntu（.deb）、Fedora/openSUSE（.rpm）、Arch（pacman）、Nix/NixOS 与 AppImage 等多种安装包，并支持 Wayland 与 X11。

本文将带你快速完成远程手机控制的安装与配对，把 Linux 桌面变成一台"手机可遥控"的 AI 工作站。

一、什么是 codex-desktop-linux？一分钟认识项目

codex-desktop-linux 在桌面菜单中显示为ChatGPT Community（图标带蓝色C），它与 OpenAI 官方的 ChatGPT 包可共存，但二者共用同一个Codex用户配置目录，请勿同时运行。

它的一大特色是"可选功能框架"：所有增强功能默认关闭，按需在构建时启用。与远程手机控制直接相关的功能有：

⚠️ 需要明确：remote-mobile-control是实验性功能。OpenAI 官方目前只把 Remote hosts 文档面向 macOS 和 Windows，本功能是把上游的远程主机流程"移植适配"到 Linux，并不等于 Linux 已被官方支持为 Remote host。

二、远程手机控制是如何工作的？

简单说，它打通了三条控制链路，并在 Linux 上补齐了缺失的本地组件：

• 🖥️mobile-host（本机被控）：手机 App 通过账号配对后驱动这台 Linux 安装实例上的 Codex 会话，功能会启动带--remote-control的官方 app-server 守护进程；
• 📡outbound-control（本机去控别人）：保留"Control other devices"设置页，让这台桌面也能授权控制另一台已注册设备；
• 🌐remote-ssh（远程 SSH 主机）：与 Connections 界面共享设置区，但不参与 remote-control 注册。

关键机制（详见 linux-features/remote-mobile-control/README.md）：

1. 设备密钥：用 Linux 版 JavaScript ECDSA P-256 密钥替换上游的 macOS 原生密钥模块；
2. 密钥加密存储：优先使用 GNOME Secret Service（libsecret）或 KWallet 通过 ElectronsafeStorage加密，无钥匙串时回退到0600权限的私有文件（弱于 macOS Secure Enclave）；
3. 自动保活：每 5 秒刷新一次 Connections 状态，窗口聚焦、网络恢复时立即刷新；
4. 浏览器能力保留：本地 Chrome 插件健康时，远程会话也能继续使用 Browser Use；
5. 单实例约束：原生打包模式下强制单实例，避免出现第二个 Remote Control 属主。

三、一键安装步骤：5 分钟开启远程手机控制

所有功能都"默认关闭、构建时启用"，所以流程是：克隆仓库 → 勾选功能 → 构建安装。

1. 克隆仓库并进入目录

git clone https://gitcode.com/gh_mirrors/co/codex-desktop-linux cd codex-desktop-linux

2. 用向导勾选 remote-mobile-control

推荐直接运行交互式向导（会展示依赖、冲突与警告，并写入本地 linux-features/features.json）：

make setup-native make install-native

也可以手动配置——复制示例配置并加入功能 ID：

{ "enabled": [ "remote-mobile-control" ] }

3. 重新构建并安装

向导已包含安装；若只想重建：

make install-native

完成后可从应用菜单启动ChatGPT Community。完整的构建依赖说明见 docs/native-setup.md 与主 README.md。

🐧 Nix 用户的最快配置方法

Nix flake 构建不读取本地features.json（该文件被 git 忽略），请改用声明式变体：

nix run .#codex-desktop-remote-mobile-control

想叠加 Computer Use UI 功能：

nix run .#codex-desktop-computer-use-ui-remote-mobile-control

NixOS 更推荐 Home Manager 模块（会自动管理codex-remote-control.service用户服务，桌面端则以 proxy 模式转发 RPC）：

programs.codexDesktopLinux = { enable = true; computerUseUi.enable = true; remoteMobileControl.enable = true; remoteControl.enable = true; };

四、手机端如何配对并开始远程驱动？

1. 确保手机上的 ChatGPT App（iOS / Android）与桌面登录同一账号，且账号满足官方 Remote 功能的灰度条件（账号、工作区、移动端要求由 OpenAI 服务端决定）；
2. 在桌面端设置 → Remote / Connections中打开远程控制（remote-control-ui会确保该界面在 Linux 上可见）；
3. 按手机提示完成配对；本机 app-server 守护进程会在冷启动时自动以remote-control start拉起（使用包内官方 Codex 可执行文件，不额外下载安装 CLI）；
4. 配对成功后，即可在手机端发起/查看桌面 Codex 会话，桌面侧每 5 秒自动同步状态。

🧪KDE Plasma / Wayland 自检小贴士：若手机端要驱动桌面操作，还依赖 Computer Use 后端。构建后运行以下命令确认 KWin 后端就绪（doctor 报告应显示 KWin、XDG Portal 与输入检查均为 ready）：

./codex-app/resources/plugins/openai-bundled/plugins/unified-computer-use/bin/codex-computer-use-linux doctor

五、使用注意与安全须知

• 🧪实验性质：这是实验性的账号级远程控制管道，OpenAI 服务端仍可能拒绝 Linux 主机注册或出站授权——本功能只移除了本地应用内的 macOS-only 限制，重新构建不会解锁账号灰度；
• 🔐密钥保护：私钥存放在~/.config/codex-desktop/remote-control-device-keys/（0700目录 +0600文件），可用gnome_libsecret/kwallet*时自动加密；检查 JSON 中的storageBackend字段即可确认，日志永远不会打印密钥材料；
• 🔒卸载前务必先撤销已配对设备，再删除私有设备密钥（详见主 README.md 的 Uninstall 章节与 README.zh-CN.md）；
• 🚫单实例要求：原生打包模式下第二实例会被单实例锁挡回，避免产生第二个 Remote Control 属主；
• 📌桌面与官方包勿同时运行：两者共用Codex配置目录，可能互相抢占会话。

六、总结

通过 codex-desktop-linux 的remote-mobile-control功能，Linux 用户终于可以用手机 ChatGPT App 远程驱动桌面 Codex：克隆仓库 →make setup-native勾选功能 → 构建安装 → 手机端配对，四步即可把 Linux 桌面变成随身可遥控的 AI 工作台。虽然目前是实验性能力，但密钥加密存储、单实例守护、状态自动刷新等工程细节都很扎实，值得动手尝鲜。

延伸阅读

• 功能完整说明：linux-features/remote-mobile-control/README.md
• 功能框架总览：linux-features/README.md
• 原生安装向导：docs/native-setup.md
• 中文主文档：README.zh-CN.md

【免费下载链接】codex-desktop-linuxUnofficial ChatGPT desktop app for Linux (formerly the Codex app), built locally from OpenAI’s official macOS app. Includes Chat, Work, and Codex. Packages for Debian/Ubuntu (.deb), Fedora/openSUSE (.rpm), Arch (pacman), Nix/NixOS, and AppImage, with Wayland and X11 support.项目地址: https://gitcode.com/gh_mirrors/co/codex-desktop-linux