CodexをLinuxで使う方法｜アプリ・CLIの入れ方とサンドボックスの準備

「LinuxのパソコンでもCodexは使えるのか」「アプリはMacとWindowsだけではないのか」と気になっている方もいるのではないでしょうか。

結論から言うと、CodexはLinuxでも使えます。ターミナルから使うCLIは公式のインストーラーで入れられ、デスクトップアプリは2026年8月にプレビュー版として公開されました。プレビュー版なので、MacやWindowsのアプリにある機能の一部は、まだLinuxでは使えません。

この記事では、LinuxでCodexを使うために必要な情報を、対応しているディストリビューション、アプリとCLIの入れ方、Linuxならではのサンドボックスの準備、画面のないサーバーでの使い方、つまずきやすい点の対処の順に解説します。内容は2026年10月時点の公式情報をもとにしています。プレビュー版は変更されやすいため、実行前には公式ページもあわせて確認してください。

Linuxで使う方法と対応環境

Linuxで使う方法は、大きく2つに分かれます。デスクトップアプリとCLIです。

迷ったら、手元のデスクトップ環境で使うならアプリ、サーバーや画面のない環境で使うならCLI、と分けて考えると選びやすくなります。両方を入れても問題ありません。

VS Codeなどのエディタ拡張もありますが、Linuxでの動作条件を示した公式ページは確認できなかったため、この記事では扱いません。

対応しているディストリビューション

公式のLinux版アプリのページには、次のディストリビューション（Linuxの種類）が対象として載っています。CPUは、x64とARM64のどちらにも対応しています。

公式は、これ以外のディストリビューションでも動く可能性があるとしつつ、正式な対応対象には含めていません。仕事で使う場合は、上の表にあるバージョンを選ぶのが無難です。

自分のパソコンがx64かARM64かは、ターミナルでuname -mを実行すると分かります。x86_64と表示されればx64、aarch64またはarm64と表示されればARM64です。

プレビュー版の制限

Linux版アプリは、公式にプレビュー版と案内されています。公式のページと変更履歴で確認できる制限は、次のとおりです。

使えるプラン

公式の料金ページによると、PlusなどのChatGPTの有料プランでは、アプリ・CLI・IDE拡張・クラウドが使えます。FreeとGoは、デスクトップアプリで限られたモデルを使える形です。APIキーで使う場合は、CLIとIDE拡張が対象で、クラウド上の機能は使えません。料金ページにはLinux専用のプランや条件は載っていません。プランごとの違いは、別の記事で詳しく解説しています。

デスクトップアプリの入れ方

Linux版は、ChatGPTのデスクトップアプリとして配布されます。パッケージ名はchatgptで、Codexはこのアプリの中で選んで使います。

パッケージを選ぶ

使っているディストリビューションとCPUに合わせて、次のファイルを選びます。ダウンロード先は、公式が案内している次のアドレスです。

• .debファイル：https://persistent.oaistatic.com/codex-app-prod/linux/deb/latest/
• .rpmファイル：https://persistent.oaistatic.com/codex-app-prod/linux/rpm/latest/
• Arch Linux用スクリプト：https://persistent.oaistatic.com/codex-app-prod/linux/install-arch.sh

入れる手順

1. CPUの種類を確かめるターミナルでuname -mを実行し、x64かARM64かを確認します。
2. ファイルをダウンロードする上のアドレスから、自分の環境に合うファイルを「ダウンロード」フォルダなどに保存します。
3. パッケージを入れるディストリビューションに合ったコマンドを実行します。コマンドは次の表のとおりです。
4. アプリを起動するアプリケーションの一覧から「ChatGPT」を開くか、ターミナルでchatgptと入力します。
5. サインインするChatGPTのアカウントでサインインします。APIキーでも使えますが、一部の機能は使えません。
6. 作業するフォルダを開く新しい会話を始め、作業したいフォルダを指定します。会話の種類は、ソフトウェア開発向けの「Codex」を選びます。

Arch Linuxでは、スクリプトをダウンロードして実行します。

curl --proto '=https' --tlsv1.2 -fL -o install-arch.sh \
  https://persistent.oaistatic.com/codex-app-prod/linux/install-arch.sh
sudo bash install-arch.sh

アプリの更新

インストールすると、署名つきのパッケージリポジトリが設定されます。更新は、ふだんのパッケージ管理のコマンドで行います。

最初の権限の設定

入力欄の下にある権限の設定では、まず「Ask for approval」を選びます。公式の権限モードのページでも、はじめはこのモードが推奨されています。作業フォルダの外のファイルを編集するときや、インターネットを使うときに、確認が出る設定です。「Full access」はパソコン上のあらゆるファイルに触れるため、中身を把握している作業にだけ使いましょう。

Linuxで知っておきたい設定

公式の設定のページに載っている項目のうち、Linuxに関係するのは次の2つです。

• Prevent sleep while running：「General」にある設定で、MacとLinuxのみにあります。オンにすると、作業中にパソコンがスリープしなくなります。席を離れて長い作業を任せるときに便利です
• 入力欄での改行：Enterで送信されます。複数行を入力したいときは、WindowsとLinuxではCtrl+Enterを使います（Macではcommand+Enter）

CLIの入れ方

CLIは、ターミナルでコマンドを入力して使う版です。Linuxでも、公式のインストーラーでコマンド1行で入ります。

1. ターミナルを開く使っているデスクトップ環境の端末アプリを開きます。サーバーなら、SSHでログインした画面で実行します。
2. インストーラーを実行する次のコマンドを貼り付けて実行します。
3. 新しいターミナルを開くインストール後は、いったんターミナルを閉じて開き直します。
4. Codexを起動する作業するフォルダに移動して、codexと入力します。
5. サインインする初回は「Sign in with ChatGPT」を選び、ブラウザでログインします。

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

更新も、同じコマンドをもう一度実行します。入っているバージョンはcodex --versionで確かめられます。

入れ方の種類

社内のネットワークなどでインストーラーの取得に失敗するときは、GitHub Releasesから取得するように指定できます。次のように、環境変数を付けて実行します。

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

サンドボックスの準備

サンドボックスは、Codexが実行するコマンドが触れる範囲を区切る仕組みです。Linuxでは、bubblewrap（bwrap）というツールを使って実現されています。公式の説明では、gitやパッケージ管理、テストの実行も、同じ区切りの中で動きます。

MacやWindowsと違い、Linuxでは環境によって事前の準備が必要になることがあります。準備が足りないと、Codexの起動時に警告が表示されます。

bubblewrapを入れる

Codexは、PATH（コマンドの探索場所）にある最初のbwrapを使います。見つからない場合は、Codexに同梱されているヘルパーを使いますが、これには、一般のユーザー権限でユーザー名前空間を作れることが必要です。公式は、同梱のものに頼るより、ディストリビューションのパッケージを入れる方が確実としています。

Arch Linux向けの手順は、公式のサンドボックスのページには載っていません。

Ubuntu 24.04で警告が出るとき

Ubuntuは、セキュリティの仕組み（AppArmor）で、一般ユーザーによるユーザー名前空間の作成を制限しています。公式の説明では、Ubuntu 25.04ではbubblewrap用のプロファイルが標準で入っているため、追加の設定は不要です。一方、Ubuntu 24.04では、bubblewrapを入れても警告が出ることがあり、プロファイルを追加で読み込む必要があります。

1. 必要なパッケージを入れるsudo apt updateのあと、sudo apt install apparmor-profiles apparmor-utilsを実行します。
2. プロファイルを配置するsudo install -m 0644 /usr/share/apparmor/extra-profiles/bwrap-userns-restrict /etc/apparmor.d/bwrap-userns-restrictを実行します。
3. プロファイルを読み込むsudo apparmor_parser -r /etc/apparmor.d/bwrap-userns-restrictを実行します。再起動は要りません。

すべてのAppArmorのプロファイルを読み込み直したいときは、sudo systemctl reload apparmor.serviceも使えます。

設定ファイルで選べる項目

サンドボックスと承認の設定は、設定ファイル（config.toml）で決められます。公式に載っている主な項目は次のとおりです。

sandbox_mode = "workspace-write"
approval_policy = "on-request"
approvals_reviewer = "user"

[sandbox_workspace_write]
writable_roots = ["/path/to/extra/dir"]

CLIでは、起動時にcodex --sandbox workspace-write --ask-for-approval on-requestと指定することもできます。起動したあとは/permissionsで権限の選択画面を開けます。

設定ファイルの場所は、個人用が~/.codex/config.toml、プロジェクト用がプロジェクト内の.codex/config.tomlです。プロジェクト用の設定は、そのプロジェクトを信頼したときだけ読み込まれます。Unix系のOS（Linuxを含む）では、システム全体の設定として/etc/codex/config.tomlも使われ、優先順位は個人用より低くなります。

なお、DockerなどのコンテナでCodexを動かす場合の注意点は、公式のサンドボックスのページには載っていません。コンテナで使う場合は、手元の環境で動作を確かめてください。

画面のないサーバーで使う

Linuxでは、画面もブラウザもないサーバーでCodexを使いたい場面があります。この場合、初回のログインで使うブラウザがないことが課題になります。公式の認証のページには、次の3つの方法が載っています。

デバイスコードでのログイン

デバイスコードでのログインは、事前に有効にしておく必要があります。個人のアカウントならChatGPTのセキュリティ設定、会社のワークスペースなら管理者の権限設定です。そのうえで、サーバーのターミナルで次を実行します。

codex login --device-auth

表示されたリンクを手元のパソコンのブラウザで開き、サインインして、画面に出たワンタイムコードを入力すれば完了です。

認証情報のファイルを扱うときの注意

ファイルをコピーする方法では、auth.jsonにアクセストークン（ログイン状態を示す情報）が入っています。パスワードと同じ扱いにして、他人に渡したり、リポジトリに入れたりしないでください。また、このコピーの方法は、パソコンがログイン情報をOSのキーリングに保存している場合には使えません。

保存先は、設定のcli_auth_credentials_storeで選べます。公式に載っている値は次のとおりです。

• file：CODEX_HOME（標準は~/.codex）のauth.jsonに保存する
• keyring：OSの認証情報の保管場所を使う。使えない環境ではエラーになる
• auto：保管場所が使えればそれを使い、使えなければauth.jsonに保存する
• ephemeral：そのプロセスの間だけメモリに保持する

現在のログイン方法はcodex login status、ログイン情報の削除はcodex logoutで行えます。

決まった作業を自動で実行する

サーバーでは、codex execを使うと、対話画面を出さずに作業を実行できます。スクリプトや定期実行から呼び出す使い方です。

codex exec "このフォルダのREADMEを要約して"
codex exec --sandbox workspace-write "テストを実行して、失敗した理由をまとめて"

つまずきやすい点の対処

公式のドキュメントから確かめられる、Linuxで起きやすいつまずきを表にまとめました。

原因が分からないとき

公式のトラブルシューティングのページによると、会話の記録は$CODEX_HOME/sessions（標準では~/.codex/sessions）に保存されます。アプリのログの保存場所として公式のページに載っているのは、Macの場所だけです。Linux版アプリのログの場所は、公式には案内がありません。

問い合わせや不具合の報告は、公式のGitHub（github.com/openai/codex）で受け付けられています。ログや記録を共有する前には、顧客の情報などが含まれていないかを確かめてください。

なお、Linux版アプリのアンインストール手順も、公式には案内がありません。パッケージ管理のコマンドで消す方法は、ディストリビューションごとの一般的な手順になるため、この記事では扱いません。

会社のLinuxで使うとき

会社が管理しているLinuxのマシンやサーバーで使う場合は、始める前に確認しておきたい点があります。MacやWindows向けには、公式に法人向けの配布や更新の管理の案内がありますが、Linux版アプリについては、管理者向けの専用ページは確認できませんでした。そのため、次の表は、公式に載っている事実と、確認しておくべき点を分けて示しています。

導入は、次のような順で進めるとつまずきが少なくなります。

1. 試す環境を決める対応しているディストリビューションのマシンで、本番とは別の検証用の環境を用意します。
2. サンドボックスの準備を済ませるbubblewrapを入れ、Ubuntu 24.04の場合はAppArmorのプロファイルを読み込んで、警告が出ないことを確かめます。
3. 権限とフォルダのルールを決める最初は「Ask for approval」とし、作業用のフォルダだけを開かせます。
4. 動作を確認して広げるアプリの更新、サーバーでのログイン、自動実行が意図どおり動くかを確かめてから、対象を広げます。

よくある質問

まとめ

LinuxでのCodexは、手順どおりに進めれば短時間で使い始められます。ただしプレビュー版の制限があるため、まずは検証用の環境と作業用のフォルダで小さな依頼を試し、どこまで任せられるかを確かめてから広げるのがおすすめです。

社内のLinuxやサーバーに広げる段階では、インストール方法、サンドボックスの準備、権限と認証情報の扱いなど、決めることが増えます。INTERCREATE JAPANでは、Codex・Claude Codeの導入から、社内で使い続けられる設定やルールづくりまでをお手伝いしています。