codex-desktop-linux

Linux 也能用上 ChatGPT 桌面版，装好即用。

非官方的 Linux 版 ChatGPT 桌面应用（前身为 Codex 应用），基于 OpenAI 官方 macOS 应用本地构建，内置 Chat、Work 与 Codex 三大模式。提供 .deb、.rpm、pacman、Nix 与 AppImage 等多种安装包，让 Linux 用户也能畅享官方级 AI 桌面体验。

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3841

维护状态活跃

是否开源是

定价模式 free

项目数据

分类编程开发

开发团队ilysenko

所属国家

官网地址

GitHubhttps://github.com/ilysenko/codex-desktop-linux

定价模式free

价格说明开源免费，自行构建安装，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型ai-coding,appimage,archlinux,chatgpt,chatgpt-desktop,codex,codex-desktop,debian,desktop-app,electron,fedora,linux,nix,nixos,openai,opensuse,rpm,ubuntu,wayland,x11

GitHub 星标★ 3841

30天Star增速

HF 下载量

上线时间2026-02-05 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 30 分钟部署方式：本地安装 7 步

环境要求

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克隆仓库

先把仓库下载到本地，后续的 make 命令都需要在仓库目录内执行。
```
git clone https://github.com/ilysenko/codex-desktop-linux.git
cd codex-desktop-linux
```
2一键构建并安装

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

如果构建依赖都已就绪，可跳过依赖安装环节，直接构建并安装原生包。
```
make install-native
```
4选择可选功能

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

NixOS 或其他带 Nix 的系统可直接运行 flake 输出，由 Nix 负责构建并启动。
```
nix run github:ilysenko/codex-desktop-linux
```
6生成 AppImage

原子化桌面或其他发行版可改为构建本地 AppImage，该方式不含原生更新器。
```
make build-app && make appimage
```
7免安装本地运行

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

关键配置

配置项	必填	说明	示例
`CODEX_LINUX_DISABLE_USAGE_REPORTING`	否	设为 1 可关闭每日一次的匿名启动统计上报	`1`

如何确认成功

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

常见问题

Q：它会和 OpenAI 官方的 ChatGPT 包冲突吗？

A：两者可以共存，但都会使用上游同一个 Codex 用户配置目录，请勿同时运行；上游的单实例锁可能把第二次启动路由到已运行的进程。

Q：AppImage 启动后提示沙箱相关错误怎么办？

A：AppImage 不会自动添加 --no-sandbox。若你的发行版禁用了非特权用户命名空间，请改用原生包，或按仓库 Troubleshooting 文档中的沙箱说明处理。

Q：已经装好所有依赖，还要跑 bootstrap-native 吗？

A：不必。依赖齐备时直接用 make install-native 完成构建与安装即可。

Q：支持哪些 CPU 架构？

A：仅支持 OpenAI 最新签名稳定 Linux 包所覆盖的 amd64 与 arm64；树莓派 5 需使用 64 位系统。

Q：如何卸载？

A：先关闭 ChatGPT Community 和官方 ChatGPT 两个应用，再用当初安装该原生包的包管理器将其移除。

注意事项

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

核心亮点

将OpenAI官方macOS应用功能（Chat/Work/Codex）完整移植到Linux，覆盖主流发行版安装包（.deb/.rpm/pacman/Nix/AppImage）
原生支持Wayland和X11显示协议，适配现代Linux桌面环境，安装体验接近官方应用
基于Electron构建，保持跨平台一致性，且代码开源可审计，社区可自行构建和定制

不足之处

非官方移植，可能滞后于macOS版功能更新，且存在API密钥管理安全风险
文档/社区待观察：项目处于成长阶段，安装包稳定性及长期维护可持续性需验证

适用场景

Linux用户需要原生ChatGPT桌面客户端，替代浏览器标签页使用
开发者希望在Linux环境直接使用Codex编程助手，集成到本地工作流
需要离线或本地化部署AI助手的企业/个人，通过Nix或AppImage实现可复现环境

替代项目

ChatGPT Desktop (official, Windows/macOS)、Unofficial ChatGPT Desktop (electron-based, cross-platform)、Chatbox (cross-platform ChatGPT client)

项目介绍

codex-desktop-linux 是对话助手领域的开源项目，由 ilysenko 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（3,841）位列前 30%，在对话助手分类的 907 个项目里位列前 7%。

近 42 天，它的 GitHub 星标从 3,646 增加到 3,841，净增 195。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。开源免费，自行构建安装，无付费版本。

它主要面向的使用场景是：Linux用户需要原生ChatGPT桌面客户端，替代浏览器标签页使用。同类可对比的替代方案包括 ChatGPT Desktop (official, Windows/macOS)、Unofficial ChatGPT Desktop (electron-b…。

上一篇：ChuanhuChatGPT

下一篇：open-webui