codex-desktop-linux

环境要求

• Linux 系统，架构为 amd64 或 arm64（Raspberry Pi 5 需 64 位系统）
• Node.js 20 或更高版本与 npm
• Python 3、curl、gpgv、dpkg-deb、tar、make
• C/C++ 工具链；构建更新器与本地特性辅助程序还需要 Rust
• 只支持 OpenAI 官方最新签名的稳定版 Linux 包

安装与启动步骤

1. 1克隆仓库

   先把仓库下载到本地，后续的 make 命令都需要在仓库目录内执行。

   git clone https://github.com/ilysenko/codex-desktop-linux.git
   cd codex-desktop-linux

   复制

2. 2一键构建并安装

   Debian/Ubuntu/Pop!_OS/Mint/Elementary、Fedora、openSUSE、Arch/Manjaro/EndeavourOS 及树莓派 5 均用此命令：自动装构建依赖、拉取上游签名包、构建 codex-app

   make bootstrap-native

   复制

3. 3依赖已装时直接安装

   如果构建依赖都已就绪，可跳过依赖安装环节，直接构建并安装原生包。

   make install-native

   复制

4. 4选择可选功能

   安装前想自定义特性时先运行 setup-native，它只写入本地特性选择、不构建也不安装，之后需再执行 install-native。

   make setup-native
   make install-native

   复制

5. 5Nix 系统运行

   NixOS 或其他带 Nix 的系统可直接运行 flake 输出，由 Nix 负责构建并启动。

   nix run github:ilysenko/codex-desktop-linux

   复制

6. 6生成 AppImage

   原子化桌面或其他发行版可改为构建本地 AppImage，该方式不含原生更新器。

   make build-app && make appimage

   复制

7. 7免安装本地运行

   只想先试用、不安装任何包时，构建本地应用树并直接启动。

   make build-app
   make run-app

   复制

关键配置

如何确认成功

桌面菜单出现带蓝色 C 图标的 ChatGPT Community 条目（包名仍为 codex-desktop），或执行 make run-app 后应用窗口正常启动。

常见问题

注意事项

• 这是社区维护的非官方发行版，仅支持 OpenAI 最新签名的稳定 Linux 包。
• 安装后桌面名称显示为 ChatGPT Community（蓝色 C 图标），但包名、命令与安装身份仍是 codex-desktop 和 /opt/codex-desktop。
• 启动器每天最多向公共 GoatCounter 看板发送一次匿名事件，仅含固定路径 /app-launch。
• 官方 chatgpt 与本包共用上游 Codex 用户配置，不要同时运行两者。