「CodexをLinuxで使いたいけど、デスクトップアプリはMacとWindowsだけ…?」——そんな疑問を持つLinuxユーザーの方へ。結論から言うと、LinuxでもCodexは問題なく使えます。主役になるのはCLI(コマンドライン版)で、サーバー用途や開発マシンとしてLinuxを使っている方なら、むしろCLIのほうが相性が良い場面も多いです。
この記事では、Linuxでの選択肢の全体像から、CLIのインストール手順、Linux特有のつまずきポイントまで、順を追って解説します。
この記事でわかること
- ✅ LinuxでCodexを使う3つの方法と使い分け
- ✅ CLIのインストール手順(Ubuntu/Debian系の実例つき)
- ✅ Linux特有のトラブルと対処法
- ✅ デスクトップアプリの代わりになる組み合わせ
⚠️ 本記事は OpenAI 公式とは無関係の解説記事です。
LinuxでCodexを使う3つの方法
まず全体像です。2026年現在、CodexのデスクトップアプリはMac版・Windows版のみで、Linux版アプリは提供されていません。ただし、以下の3つの入り口はLinuxでも使えます。
| 方法 | インストール | 向いている人 |
|---|---|---|
| CLI(コマンドライン) | 必要 | ターミナルに抵抗がない人・本命 |
| VS Code拡張 | 必要 | エディタ中心で作業する人 |
| Web版(ブラウザ) | 不要 | まず試したい人・軽い相談 |
Linuxユーザーの多くはターミナルに慣れているはずなので、基本はCLI、補助的にVS Code拡張やWeb版、という組み合わせがおすすめです。それぞれの詳しい使い方は CLIの使い方・VS Code拡張の使い方・Web版の使い方 も参考にしてください。
事前準備:動作要件の確認
CLIのインストール前に、次の2点を確認しましょう。
- Node.js 18以上が入っているか
- ChatGPTアカウントがあるか(なければ アカウント作成ガイド)
Node.jsのバージョン確認は:
node -v
v18.0.0 以上が表示されればOKです。入っていない、または古い場合は、Ubuntu/Debian系なら NodeSource 経由か、バージョン管理ツール(nvm等)でのインストールが定番です:
# nvm を使う場合の例
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
source ~/.bashrc
nvm install --lts
ディストリビューション標準のパッケージ(apt install nodejs)はバージョンが古いことがあるので注意してください。マシンスペック全般の目安は 動作環境ガイド にまとめています。
CLIのインストール手順(3ステップ)
STEP 1:npmでインストール
npm install -g @openai/codex
権限エラー(EACCES)が出る場合は、sudo を使うより nvm経由のNode.jsに切り替えるのが安全です(後述のトラブル節参照)。
STEP 2:ログイン
codex login
ブラウザが開き、ChatGPTアカウントでの認証を求められます。**デスクトップ環境のないサーバー(SSH接続先など)**では、ブラウザが開けないため:
codex login --no-browser
で表示されるURLを手元のPCのブラウザで開き、認証コードを貼り付ける方式が使えます。
STEP 3:動作確認
プロジェクトのフォルダに移動して起動します。
cd ~/my-project
codex
対話画面が開けば成功です。最初のタスクの動かし方は CLIの使い方ガイド で詳しく解説しています。
なお、この手順の基本はMacと共通です。Mac向けの詳細は CLIインストール完全ガイド にもまとまっています。
Linux特有のつまずきポイント
編集部がUbuntu環境で試した際にぶつかった(または報告の多い)ポイントです。
① `codex: command not found` になる
npmのグローバルインストール先にPATHが通っていないケースが大半です。
npm config get prefix
で表示されるパスの bin ディレクトリ(例:~/.nvm/versions/node/v22.x.x/bin)がPATHに含まれているか確認し、なければ ~/.bashrc に追記します。詳しい切り分けは command not foundの解決法 を参照してください。
② `sudo npm install -g` で入れてしまい権限が壊れる
sudo でグローバルインストールすると、以降のアップデートや設定ファイルの権限が混乱しがちです。すでにやってしまった場合は、いったんアンインストールして nvm 環境で入れ直すのがきれいです。
③ ブラウザなし環境でログインが進まない
前述の --no-browser オプションで解決します。それでも認証エラーが続く場合は ログイン・認証エラーの対処 へ。
④ ファイアウォール・プロキシ環境で接続できない
社内サーバーなどでは、プロキシ設定(HTTPS_PROXY 環境変数)が必要な場合があります。接続系のエラーは ネットワークエラーの対処 にまとめています。
「デスクトップアプリ相当」をLinuxで実現する組み合わせ
Mac/Windows版アプリの魅力は、複数エージェントの並列管理や視覚的なタスク管理です。Linuxでは次の組み合わせで近い体験を作れます。
- 並列作業 → ターミナルのタブ・tmux で複数の
codexセッションを起動 - 視覚的な操作 → VS Code拡張 のパネルでタスク管理
- 重いタスクの外出し → Codex Cloud に投げてローカル負荷ゼロ
- 外出先から確認 → モバイルアプリ で進捗チェック
特にCloudとの組み合わせは、非力なLinuxマシンでも重いタスクを回せるので相性抜群です。
WSL2ユーザーはどっちを読むべき?
「WindowsのWSL2上のLinux」で使いたい方は、実質的にこの記事のCLI手順がそのまま使えます。ただし、Windows側のデスクトップアプリと併用できる分、選択肢が広いので、Windows版ガイド を先に読むのがおすすめです。日本語の文字化けが出た場合は 文字化けの直し方 も参考に。
よくある質問(FAQ)
Q. Linux版のデスクトップアプリは出ないのですか?
A. 2026年8月時点で公式提供はMac・Windows版のみです。今後の対応は公式発表を待つ形になりますが、CLI+VS Code拡張で機能面の不足はほぼありません。
Q. どのディストリビューションで動きますか?
A. Node.js 18以上が動く環境なら基本的に動作します。Ubuntu・Debian・Fedora等の主要ディストリビューションでの利用報告が多いです。
Q. サーバー(GUIなし)でも使えますか?
A. 使えます。codex login --no-browser で認証すれば、SSH接続先のサーバーでもCLIをフル活用できます。
Q. 無料で試せますか?
A. アカウントとプランの条件次第です。詳しくは 無料で使う方法 と 料金プラン解説 をどうぞ。
Q. Raspberry Piでも動きますか?
A. ARM版Node.jsが動けばインストール自体は可能ですが、メモリの少ないモデルでは動作が重くなりがちです。重さ対策は 軽量化ガイド を参考にしてください。
まとめ
LinuxでのCodexは「CLIが主役」。Node.js 18以上を用意して npm install -g @openai/codex → codex login の3ステップで始められます。デスクトップアプリはなくても、VS Code拡張・Cloud・tmuxの組み合わせで遜色ない環境が作れます。
つまずいたときは command not foundの解決法 や トラブル総合ガイド へ。CLIに慣れてきたら CLIの使い方ガイド で活用の幅を広げていきましょう。