五大发行版 codex-desktop-linux 安装全攻略：.deb、RPM、pacman、AppImage、Nix 一网打尽-港品优选

五大发行版 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/openSUSE（RPM）、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、Elementary	`make bootstrap-native`	`.deb`
Fedora、openSUSE	`make bootstrap-native`	RPM
Arch、Manjaro、EndeavourOS	`make bootstrap-native`	pacman 包
Atomic 桌面或其他发行版	`make build-app && make appimage`	AppImage
NixOS 或其他 Nix 系统	`nix run github:ilysenko/codex-desktop-linux`	Nix 包

下面按发行版逐个讲解。

四、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-linux

NixOS / 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_NONINTERACTIVE=1 \ CODEX_LINUX_FEATURES=read-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_UPDATER=0。详见 docs/updater.md。

十一、常见问题快速排障 🩺

问题	解决方法
应用无法启动	运行`/opt/codex-desktop/start.sh --diagnose`
官方包与社区版互相干扰	完全退出其中一个再启动另一个（共享上游 profile 锁）
签名验证失败	不要绕过，检查系统时间、网络、`gpgv`、磁盘空间
Wayland 下 HiDPI 显示 1x	启动器会自动切 Wayland 后端；可用`CODEX_OZONE_PLATFORM=x11\\|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、打包脚本、文档与社区扩展。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析