Codex を Linux で：デスクトップアプリのプレビュー、CLI、Linux でまだできないこと

Linux でどの Codex を使うか

• ChatGPT デスクトップアプリ（プレビュー）：Chat や Work と並んで Codex があるウィンドウのアプリです。これが Linux での Codex の GUI です。OpenAI のガイドが扱っているのはデスクトップの Linux で、デスクトップのないサーバーでは CLI を使います。
• Codex CLI：ターミナルで動きます。デスクトップでも、SSH で接続するヘッドレスサーバーでも使えます。
• 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 アプリのガイドを参照）、保存したフォルダーからインストールします。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. 長いチャットを動かし続ける

   macOS と Linux にある Settings > General > Prevent sleep while running をオンにすると、コンピューターから離れている間もローカルのチャットが続きます。

出典：OpenAI の Codex ドキュメント（Linux 版 ChatGPT アプリ）

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 は非特権ユーザー名前空間を必要とする同梱のヘルパーに切り替え、起動時に警告を出します。Ubuntu 25.04 ではパッケージの bubblewrap がそのまま動きます。Ubuntu 24.04 では、AppArmor の bwrap-userns-restrict プロファイルを読み込むまで警告が出る場合があります（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. ヘッドレスサーバーではデバイスコードでサインインする

   マシンにブラウザがない場合は、Sign in with Device Code を選ぶか、ベータの codex login --device-auth を実行します。デバイスコードでのログインは、先に ChatGPT のセキュリティ設定か、ワークスペースの管理者がオンにしておく必要があります。ほかにも方法が 2 つあります。ブラウザでのサインインがうまくいったコンピューターから ~/.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 PC を使いましょう。Windows の Computer Use は作業中に画面を占有します。Windows で使う Codex をご覧ください。常時稼働の Mac については Mac mini で動かす Codex をご覧ください。

Mac や PC のデスクトップアプリから Linux マシンを使う

OpenAI のリモート接続のドキュメントが、スマートフォンの ChatGPT アプリから操作できるホストとして挙げているのは Mac と Windows のコンピューターだけなので、Linux のデスクトップアプリをスマートフォンから操作する方法はドキュメントに載っていません。それでも Linux マシンは SSH ホストになれます。Mac か Windows PC のデスクトップアプリがそのマシン上のプロジェクトを開き、Codex はそこでコマンドを実行し、ファイルを読み、変更を書き込みます。あとはその Mac か PC を通して、スマートフォンから操作します。

1. Linux マシンを SSH の設定に追加する

   デスクトップアプリを動かしている Mac か PC で、~/.ssh/config にホストを追加します。Codex はこのファイルから具体的なホストのエイリアスを読み取り、パターンだけのエントリは無視します。そのコンピューターから ssh devbox が動くことを確認します。ほかの SSH アクセスと同じように、信頼できる鍵と最小権限のアカウントを使い、認証のないものを公開ネットワークで待ち受けさせないようにします。自分のネットワークの外にあるマシンに届くには、VPN かメッシュネットワークのツールを使います。

   # ~/.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 をインストールしてサインインする

   アプリはリモートマシン上の Codex を SSH で、リモートユーザーのログインシェルで起動するので、そこで codex が PATH に入っている必要があります。上のスクリプトでインストールしてサインインします。ヘッドレスサーバーでは codex login --device-auth を使います。

3. デスクトップアプリでホストを追加する

   Settings > Connections に進み、SSH ホストを追加するか有効にして、その上のプロジェクトフォルダーを選びます。同じ Git リポジトリが両側でプロジェクトとして保存されていれば、チャットのフッターから、コンピューターと Linux ホストの間でチャットを引き継げます。

4. スマートフォンから操作する

   Codex のリモートコントロール の説明どおりに、スマートフォンを Mac か PC とペアリングします。スマートフォンがやり取りするのはそのコンピューターで、電源を入れたままにしておく必要があり、Codex は Linux マシン上で作業します。借りたサーバーについては VPS で動かす Codex をご覧ください。

出典：OpenAI の Codex ドキュメント（Remote connections）

または Codex cloud にタスクを任せる

マシンの電源をまったく入れておきたくないなら、Codex cloud が OpenAI のサーバーでタスクを動かします。タスクごとに専用のワークスペースがあり、コンピューターがスリープしている間も進みます。

• Web かデスクトップアプリから Work in > Cloud でタスクを始めるか、ChatGPT のモバイルアプリの 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 社員に変えます。勤務時間中は、macOS や Windows だけでなく Linux でも動く crewmark CLI が社員を起こし、共有ボードから次の 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 の活用例 をご覧ください。

よくある質問