如何在 Linux 上运行 Codex Desktop — macOS 源码编译版使用指南

Codex Desktop 是 OpenAI 推出的 AI 编程助手桌面应用，支持多 Agent 并行、集成终端、项目管理等强大功能。但官方只提供了 macOS 版本。

现在，源码商城 将 macOS 版的真實源代码完整编译为 Linux 可执行文件，让 Ubuntu、Debian、Deepin 用户也能用上原汁原味的 Codex Desktop。

本文详细介绍安装步骤和常见问题。

版本说明

本 Linux 版与 macOS 官方的差异：

项目	macOS 版	Linux 版
核心代码	同一份	使用同一份 app.asar 源码 ✅
Electron	42.1.0	42.1.0 ✅
better-sqlite3	macOS 编译	Linux 重新编译 ✅
node-pty	macOS 编译	Linux 重新编译 ✅
语言包	55 种	55 种 ✅
包大小	~495MB	140MB（不含 arm64 二进制）

安装步骤

1. 下载 DEB 包

wget https://heao.online/downloads/Codex-Desktop-26.616.32156-amd64.deb

2. 安装

sudo dpkg -i Codex-Desktop-26.616.32156-amd64.deb
# 如果提示依赖缺失，运行：
sudo apt install -f

3. 启动

安装完成后，在终端运行：

codex-desktop

或者在应用菜单中找到 Codex 图标点击启动。

系统要求

• 操作系统： Ubuntu 22.04+ / Debian 12+ / Deepin 20+
• 架构： x86_64 (amd64)
• 内存： 建议 8GB+
• 依赖： libc6, libstdc++6, libx11-6, libnss3, libnspr4, libgbm1

常见问题

点击图标没反应？

在终端运行以下命令查看错误输出：

/opt/codex-desktop/electron --no-sandbox /opt/codex-desktop

如何切换中文界面？

Codex 会自动检测系统语言。如果未自动切换，在设置面板中将语言改为简体中文。

能否和 VS Code 一起使用？

可以。Codex Desktop 是独立应用，不冲突。你可以同时打开 VS Code 写代码、Codex 做 AI 辅助。

性能优化建议

• 使用 SSD 硬盘可获得更好的数据库读写性能
• 关闭不必要的后台应用释放内存
• 在 Deepin 上如果遇到沙箱错误，安装 chrome-sandbox 即可