五大发行版 codex-desktop-linux 安装全攻略.deb、RPM、pacman、AppImage、Nix 一网打尽【免费下载链接】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想在 Linux 上安装 OpenAI 官方 ChatGPT 桌面应用codex-desktop-linux是基于官方签名 Linux 软件包构建的社区发行版覆盖 Debian/Ubuntu.deb、Fedora/openSUSERPM、Arch 系pacman、Atomic 桌面AppImage和 Nix/NixOS 五种安装方式支持 Wayland 与 X11。本文将带你用最简单的步骤在这五大发行版上完成 codex-desktop-linux 的安装、可选功能配置与卸载。一、codex-desktop-linux 是什么简单来说它是一个官方内核 社区外壳来源可靠唯一上游来源是 OpenAI 已签名的 Linux.deb构建时会依次验证仓库密钥 →InRelease→ 包哈希确保内容未被篡改桌面身份独立应用菜单中显示为ChatGPT Community蓝色 C 图标包名和命令仍为codex-desktop安装目录在/opt/codex-desktop可与官方ChatGPT包共存功能可选内置 30 个默认关闭的 Linux 扩展朗读、托盘用量、Computer Use、UI 微调等需要时通过向导一键开启架构支持amd64与arm64含 Raspberry Pi 5 实测。更多细节见 README.zh-CN.md 与 docs/architecture.md。二、安装前自检清单3 分钟确认环境 ✅在动手之前先确认以下几点官方要求见 docs/native-setup.md检查项说明系统架构amd64或arm64用uname -m查看构建依赖Node.js 20、npm、Python 3、curl、gpgv、make、C/C 工具链Rust更新器与原生扩展用磁盘空间官方包体积较大预留至少 3~4 GB不要同时运行官方chatgpt与codex-desktop共享同一用户 profile请勿并行启动放心的是make bootstrap-native会自动安装或提示安装这些依赖你不需要手动逐一配置。三、五发行版安装方式速查表 先克隆仓库所有方式通用git clone https://gitcode.com/gh_mirrors/co/codex-desktop-linux cd codex-desktop-linux发行版 / 桌面推荐命令生成的包格式Debian、Ubuntu、Pop!_OS、Mint、Elementarymake bootstrap-native.debFedora、openSUSEmake bootstrap-nativeRPMArch、Manjaro、EndeavourOSmake bootstrap-nativepacman 包Atomic 桌面或其他发行版make build-app make appimageAppImageNixOS 或其他 Nix 系统nix run github:ilysenko/codex-desktop-linuxNix 包下面按发行版逐个讲解。四、Debian / Ubuntu 安装一条命令搞定 .deb 包适合人群Ubuntu、Debian、Mint、Pop!_OS、Elementary 用户。make bootstrap-native这条命令会依次完成四件事安装构建依赖 → 从 OpenAI 签名 APT 索引解析最新版官方包 → 构建出codex-app/应用树 → 自动检测发行版并打包安装.deb。依赖已经装好过、只是想重新安装时用更轻量的make install-native完成后在桌面菜单中查找ChatGPT Community即可启动。卸载命令sudo apt remove codex-desktop五、Fedora / openSUSE 安装RPM 包步骤构建流程与 Debian 完全相同bootstrap-native会自动识别 RPM 系发行版并调用make rpm生成产物make bootstrap-native安装阶段优先使用dnf找不到时回退到rpm -Uvh逻辑在 Makefile 的install目标中可对照阅读。卸载方式# Fedora sudo dnf remove codex-desktop # openSUSE sudo zypper remove codex-desktop六、Arch / Manjaro 安装pacman 包流程Arch 系用户同样一条命令make bootstrap-native构建产物为dist/codex-desktop-[版本号].pkg.tar.*由pacman -U安装。注意 Arch 需要系统已安装base-devel工具链。卸载sudo pacman -R codex-desktop七、AppImage 安装Atomic 桌面的首选AppImage 是唯一不修改系统目录的方式特别适合 Fedora Atomic、Silverblue 等不可变系统make build-app make appimage产物位于dist/赋予执行权限后直接双击或命令行运行即可。⚠️ 两个重要提示AppImage不会自动添加--no-sandbox。如果你的发行版禁用了非特权用户命名空间user namespaces请改用原生包或参阅 docs/troubleshooting.md 中的沙箱指引AppImage 不含自动更新器升级时需重新构建并替换文件若搭配 Flatpak 版 Chrome 使用且扩展连接失败构建前需启用flatpak-chrome-native-messaging扩展见 linux-features/flatpak-chrome-native-messaging/。八、Nix / NixOS 安装声明式配置最省心Nix 的 flake 会下载官方.deb版本固定于 nix/upstream-linux-packages.json通过 Nix 校验哈希后直接包装官方运行时resources/app.asar与上游逐字节一致。快速体验不修改系统nix run github:ilysenko/codex-desktop-linuxNixOS / Home Manager 声明式安装推荐programs.codexDesktopLinux { enable true; linuxFeatures [ read-aloud ui-tweaks ]; };Nix 包不使用可变更新器升级走标准 Nix 流程nix flake update codex-desktop-linux sudo nixos-rebuild switch --flake .#your-host # 或home-manager switch --flake .#your-user完整说明含 Wayland 渲染约定、远程桌面控制服务等见 docs/nix.md模块源码在 nix/nixos-module.nix 与 nix/home-manager-module.nix。九、可选功能开启向导setup-native 详解 ️默认安装的 codex-desktop 与官方包完全一致ASAR 逐字节相同。想启用朗读、UI 微调、Computer Use 等扩展时make setup-native # 打开交互式向导勾选扩展 make install-native # 重新构建并安装向导会检查架构与工具、列出可用扩展及其依赖冲突、写入本地linux-features/features.json并让你选择是否包含更新器。它只写配置不会自动构建或安装新手可放心操作。不想用交互界面支持环境变量一键配置CODEX_BOOTSTRAP_NONINTERACTIVE1 \ CODEX_LINUX_FEATURESread-aloud,ui-tweaks \ make setup-native全部扩展清单及各自文档见 linux-features/README.md配置示例文件为 linux-features/features.example.json。十、自动更新管理器原生包独有 ⚙️原生包.deb / RPM / pacman默认内置codex-update-manager用户服务它轮询同一签名 APT 元数据、缓存官方包、按当前启用的扩展重建原生包并在应用退出后原子切换上一版始终保留可回滚。常用命令codex-update-manager status # 查看候选/已装/回滚状态 codex-update-manager check-now # 立即检查更新 codex-update-manager rollback # 回滚到上一版本服务管理systemctl --user status codex-update-manager.service --no-pager若不想自动更新构建时加PACKAGE_WITH_UPDATER0。详见 docs/updater.md。十一、常见问题快速排障 问题解决方法应用无法启动运行/opt/codex-desktop/start.sh --diagnose官方包与社区版互相干扰完全退出其中一个再启动另一个共享上游 profile 锁签名验证失败不要绕过检查系统时间、网络、gpgv、磁盘空间Wayland 下 HiDPI 显示 1x启动器会自动切 Wayland 后端可用CODEX_OZONE_PLATFORMx11\|wayland手动固定AppImage 报沙箱错误启用 user namespaces 或改用原生包桌面菜单名称/图标陈旧刷新桌面数据库或重新登录完整排障手册docs/troubleshooting.md。十二、卸载与数据清理# 1. 关闭所有 ChatGPT 进程 # 2. 用安装它的包管理器卸载apt / dnf / zypper / pacman 见上文 # 3. 若残留旧服务 systemctl --user disable --now codex-update-manager.service systemctl --user daemon-reload卸载保留用户数据。仅要清除社区版配置与更新器状态时检查后删除~/.config/codex-desktop、~/.local/state/codex-desktop、~/.cache/codex-desktop及对应的codex-update-manager目录即可不要删除~/.codex那是官方与应用共用的 Codex 配置目录。写在最后 至此codex-desktop-linux 的五大发行版安装方式已全部覆盖Debian/Ubuntu 装.deb、Fedora/openSUSE 装 RPM、Arch 系装 pacman、不可变桌面用 AppImage、Nix 系统走声明式配置。对新手最友好的路径就是记住两件事——先make bootstrap-native一键装想加功能再make setup-native勾选扩展。配合内置更新管理器后续官方包升级也能无感完成。更多进阶资料原生安装指南、树莓派 5 实测记录、构建与打包说明。注本项目为非官方社区发行版与 OpenAI 无隶属关系MIT 许可证仅适用于本仓库的 wrapper、打包脚本、文档与社区扩展。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考