Linux 上的 Codex：桌面應用程式預覽版、CLI，以及 Linux 還做不到的事

Linux 上該用哪種 Codex

• ChatGPT 桌面應用程式（預覽版）：一個視窗，Codex 和 Chat、Work 並列。這就是 Linux 上的 Codex GUI。OpenAI 的指南涵蓋的是桌面版 Linux；在沒有桌面的伺服器上，請使用 CLI。
• Codex CLI：在終端機裡執行，可以在桌面上，也可以在透過 SSH 連線的 headless 伺服器上。
• IDE 外掛，支援 VS Code、Cursor 或 Windsurf，適合想留在編輯器裡的人。
• Codex cloud：任務在 OpenAI 的伺服器上執行，所以你自己的機器都不必一直開著。請看下方的 Codex cloud。

如何在 Linux 上安裝 Codex 桌面應用程式

1. 確認你的發行版和架構

   預覽版支援 Ubuntu 24.04 LTS 和 26.04 LTS、Debian 13、Fedora 43 和 44，以及保持最新、完整更新的 Arch Linux。其他發行版或許能用，但沒有正式支援。套件提供 x64 和 ARM64 兩種：執行 uname -m；x86_64 代表 x64，aarch64 或 arm64 代表 ARM64。

   uname -m

2. 下載並安裝套件

   取得符合你發行版和架構的套件（見 OpenAI 的 Linux App 指南），從你儲存它的資料夾安裝。在 Arch 上，OpenAI 的安裝指令碼還會執行一次完整的系統升級。

   # Ubuntu or Debian (ARM64: chatgpt_arm64.deb)
   sudo apt install ./chatgpt_amd64.deb
   
   # Fedora (ARM64: chatgpt.aarch64.rpm)
   sudo dnf install ./chatgpt.x86_64.rpm
   
   # Arch Linux: download install-arch.sh from
   # https://persistent.oaistatic.com/codex-app-prod/linux/install-arch.sh
   # then run it (it does a full system upgrade)
   sudo bash install-arch.sh

3. 開啟它並選擇 Codex

   從應用程式選單開啟 ChatGPT，或在終端機裡執行 chatgpt，登入並選擇 Codex。在 Wayland 上，應用程式會在可用時使用 XWayland；原生 Wayland 支援仍是實驗性的，你可以用 chatgpt --ozone-platform=wayland 強制使用。

4. 保持更新

   更新透過你的套件管理員取得。

   # Ubuntu or Debian
   sudo apt update
   sudo apt install --only-upgrade chatgpt
   
   # Fedora
   sudo dnf upgrade --refresh chatgpt
   
   # Arch Linux
   sudo pacman -Syu

5. 讓長時間的對話繼續執行

   開啟 Settings > General > Prevent sleep while running（macOS 和 Linux 上都有），讓本機對話在你離開電腦時繼續進行。

來源：OpenAI 的 Codex 文件，Linux 版 ChatGPT App（英文）

如何在 Linux 上安裝 Codex CLI

1. 執行安裝指令碼

   同一個指令可以安裝和更新 Codex；如果已安裝的版本支援，codex update 也能套用更新。裝了 Node.js 的話，npm install -g @openai/codex 也可以。OpenAI 發布了 x86_64 和 aarch64 的 Linux 建置。

   curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. 為沙箱安裝 bubblewrap

   Codex 的 Linux 沙箱需要 bubblewrap。PATH 上沒有 bwrap 時，Codex 會改用內建的輔助程式，它需要非特權使用者命名空間（unprivileged user namespaces），而且 Codex 啟動時會發出警告。在 Ubuntu 25.04 上，套件版的 bubblewrap 直接就能用；在 Ubuntu 24.04 上，可能要載入 bwrap-userns-restrict AppArmor 設定檔，警告才會消失（見 OpenAI 的沙箱文件）。

   # Ubuntu or Debian
   sudo apt install bubblewrap
   
   # Fedora
   sudo dnf install bubblewrap
   
   # Ubuntu 24.04, if Codex still warns: copy the bwrap-userns-restrict
   # profile to /etc/apparmor.d/, then load it
   sudo apt install apparmor-profiles apparmor-utils
   sudo apparmor_parser -r /etc/apparmor.d/bwrap-userns-restrict

3. 登入

   執行 codex，選擇 Sign in with ChatGPT 來使用你的方案，或用 API 金鑰登入，依標準 API 費率計費。Codex cloud 需要用 ChatGPT 登入。登入後，codex login status 會以 0 結束。

4. 在 headless 伺服器上，用裝置代碼登入

   機器上沒有瀏覽器時，選擇 Sign in with Device Code，或執行 codex login --device-auth（beta）。裝置代碼登入必須先開啟，可以在你的 ChatGPT 安全性設定裡開啟，或由工作區管理員開啟。另外還有兩種方式：從瀏覽器登入成功的電腦複製 ~/.codex/auth.json，並把這個檔案當成密碼一樣保管；或透過 SSH 轉送登入回呼，再在伺服器上執行 codex login。

   # On the server, with device code login turned on in ChatGPT
   codex login --device-auth
   
   # Or forward the sign-in callback from your own computer, then sign in on the server
   ssh -L 1455:localhost:1455 user@remote
   codex login

來源：OpenAI 的 Codex 文件，Codex CLI（英文）

Linux 上還沒有 Computer Use

Computer Use 讓 Codex 透過移動游標和打字來操作桌面應用程式。Linux 預覽版的桌面應用程式沒有這項功能；OpenAI 的 Linux 指南說，未來的版本會加入。目前它在 macOS 和 Windows 的桌面應用程式裡執行。

• 在終端機裡進行的工作仍然能在 Linux 上執行：Codex 在那裡執行指令、編輯檔案，都在它的 bubblewrap 沙箱裡。
• 需要桌面應用程式的任務，請用 Mac 或 Windows 電腦。在 Windows 上，Computer Use 工作時會接管螢幕：請看 Windows 上的 Codex。想要一台一直開著的 Mac，請看在 Mac mini 上執行 Codex。

從 Mac 或 Windows 電腦上的桌面應用程式使用 Linux 機器

OpenAI 的遠端連線文件只把 Mac 和 Windows 電腦列為 ChatGPT 手機 App 能控制的主機，所以用手機控制 Linux 桌面應用程式並沒有文件說明。不過 Linux 機器仍然可以當 SSH 主機：Mac 或 Windows 電腦上的桌面應用程式開啟它上面的專案，Codex 在那裡執行指令、讀取檔案、寫入修改。接著你再透過那台 Mac 或 Windows 電腦，用手機操作它。

1. 把 Linux 機器加進 SSH 設定

   在執行桌面應用程式的 Mac 或 Windows 電腦上，把主機加進 ~/.ssh/config。Codex 會從這個檔案讀取具體的主機別名，忽略只有萬用字元樣式的項目。確認從那台電腦執行 ssh devbox 能連上。像對待任何 SSH 存取一樣對待它：使用信任的金鑰、權限最小的帳號，不要讓任何未經驗證的服務在公開網路上監聽；要連到你網路以外的機器，請用 VPN 或 mesh 網路工具。

   # ~/.ssh/config on the Mac or PC running the ChatGPT desktop app
   Host devbox
     HostName devbox.example.com
     User you
     IdentityFile ~/.ssh/id_ed25519

2. 在 Linux 機器上安裝並登入 Codex

   應用程式透過 SSH，在遠端使用者的登入 shell 裡啟動遠端機器上的 Codex，所以 codex 必須在那裡的 PATH 上。用上面的指令碼安裝並登入；在 headless 伺服器上用 codex login --device-auth。

3. 在桌面應用程式裡加入主機

   進入 Settings > Connections，新增或啟用這台 SSH 主機，並選擇它上面的一個專案資料夾。當同一個 Git 儲存庫在兩邊都儲存為專案時，你可以從對話底部，在你的電腦和 Linux 主機之間轉交對話。

4. 用手機控制它

   照 Codex 遠端控制的說明，把手機和那台 Mac 或 Windows 電腦配對。手機連線的是那台電腦，它必須一直開著；Codex 則在 Linux 機器上工作。如果是租來的伺服器，請看在 VPS 上執行 Codex。

來源：OpenAI 的 Codex 文件，遠端連線（英文）

或讓 Codex cloud 執行任務

如果你完全不想讓機器一直開著，Codex cloud 會在 OpenAI 的伺服器上執行任務。每個任務都有自己的工作空間，你的電腦睡眠時也會繼續進行。

• 從網頁或桌面應用程式的 Work in > Cloud 啟動任務，或從 ChatGPT 手機 App 的 Codex 啟動。在 Linux 終端機裡，codex cloud 會開啟雲端對話的選擇清單，codex cloud exec 提交一個任務，codex cloud list 則列出最近的任務。
• 它需要用 ChatGPT 登入，不能用 API 金鑰。OpenAI 的方案表把它列在 Plus、Pro、Business 和 Enterprise。
• 雲端任務只看得到自己的雲端環境。你機器上的本機檔案、執行中的程序、瀏覽器登入狀態和 VPN 存取都不會帶過去，你電腦上的對話也無法轉交給它。
• 需要可重複使用的設定時，在 Work in > Cloud > Select environment > Create environment 建立一個環境，可以開放完整的公開網際網路存取，或使用允許清單。

給 Linux 機器上的 Codex 一份固定工作

桌面應用程式、CLI 和 SSH 都會等你啟動下一個任務。Crewmark 把 Linux 機器上的一段 Codex 對話變成一位有職位、目標、工作時間和心跳的 AI 員工：在它的工作時間內，crewmark CLI（除了 macOS 和 Windows，也能在 Linux 上執行）會喚醒它，讓它從共用看板上領取下一個 issue。這台機器必須一直開著，而 Linux 伺服器本來就是如此。

1. 聘用一位員工

   從 AI 員工職位中挑一個，例如軟體工程師，並寫下它的目標和 KPI。

2. 連接機器上的一段 Codex 對話

   透過 crewmark CLI，把 Linux 桌面或伺服器上的一段 Codex 對話綁定到這位員工。這段對話就成了這位員工。Claude Code 也可以。

3. 設定工作時間和心跳

   只排平日或每天都排，以你的時區為準，工作時間可以跨過午夜。在這段時間內，CLI 每 15、30、60、120 或 240 分鐘喚醒員工一次。請看如何讓 Codex 主動工作。

4. 從任何瀏覽器指派 issue

   在 crewmark.ai 的看板上建立並指派 issue；一指派，員工就會被喚醒。需要審查或決定時，它會把 issue 設為「Needs action」，並在那裡問你。可以交給它的工作，請看 Codex 使用情境。

常見問題