要点

ヘッドレスな Linux マシン上の Codex セッションにスマホから到達する方法は 4 つあります。違いはひとつの問いに集約されます。Linux マシン以外に何が動いている必要があるか？

1. OpenAI の Remote（公式、サポート対象）： Mac または Windows PC で ChatGPT デスクトップアプリを動かし、SSH で Linux マシンに接続し、スマホはその PC とペアリングします。作業をするのは Linux マシンですが、Mac や PC は起きたままにしておく必要があります。
2. Linux マシン上で直接 codex remote-control： CLI のコマンドとしてドキュメントにあり、ChatGPT モバイルで動いたという報告があります。ただし OpenAI の Remote connections のページには、モバイルのセットアップはデスクトップアプリから始めると書かれたままなので、この方法は非公式と考え、変更があるものと思っておきましょう。
3. スマホのターミナルアプリから SSH + tmux（または mosh）： サーバーに追加するものはなく、完全に操作できますが、小さな画面で差分を読んだり承認に答えたりするのはつらくなります。
4. Linux マシン上で動くコンパニオンアプリ： たとえば Happier は、コーディングエージェントをクロスデバイスで実行・オーケストレーションできるオープンソースのアプリです。そのマシンが Codex セッションを直接始められるマシンになり、Codex CLI 0.131.0 以降ではネイティブの Codex TUI とスマホが同じスレッドを共有します。

常時起動している Mac がすでにあるなら、選択肢 1 がサポート対象のシンプルな答えです。常時起動しているのが Linux マシンだけなら、続きを読んでください。

課題

よくある構成：長時間の Codex の実行は、押し入れに置いた Linux マシンで動いています。スリープせず、リポジトリもあり、必要なツールチェーンも揃っています。ノート PC のほうはしょっちゅうスリープします。

「Linux サーバーで Codex をリモート操作」と検索すると、答えは「サポートされていない」「動く、コマンドはこれ」「10 分は動いたが、そのあとスマホにまたウェルカム画面が出た」が入り混じっています。どの方法を取るかによって、3 つとも本当だとわかります。

このガイドでは、それぞれの方法について、必要なもの、得られるもの、実際に報告されている失敗のパターンを整理します。

選択肢 1：OpenAI の Remote（間に Mac または Windows PC を置く）

これがサポート対象の方法です。2026-10-11 時点で、OpenAI の Remote connections のページには次のように書かれています。

• リモートアクセスは「macOS と Windows で ChatGPT デスクトップアプリを動かしているホストに対応」している。
• 「モバイルのセットアップはアプリから始まる。Codex CLI や IDE 拡張からはセットアップできない。」
• Linux マシンは SSH ホスト として組み込める。デスクトップアプリが ~/.ssh/config から具体的なホストエイリアスを読み、SSH 経由でリモートの Codex アプリサーバーを起動し、リモートのファイルシステムに対してチャットを実行する。codex はリモートユーザーの PATH 上にある必要がある。
• ChatGPT のワークスペースでは、「管理者が Remote Control のアクセスを有効にする必要がある場合がある」。

実際にはこういうことです：

• 良い点： ファーストパーティで、完成度の高いスマホの UI。承認も差分もスマホで扱え、作業は本当に Linux マシンで動きます。
• 注意点： デスクトップアプリを動かす Mac や Windows PC が経路に入ります。それがスリープしたり、ネットワークが切れたり、アプリを閉じたりすると、リモートアクセスは止まります。OpenAI 自身も、そのホストを電源につないで起こしたままにするよう案内しています。

どのみち常時起動の Mac mini があるなら、ここで終わりにして構いません。構成要素が少なく済む答えです。

選択肢 2：Linux マシン上で直接 codex remote-control

OpenAI の 開発者向けコマンド のリファレンスには次のように書かれています：

codex remote-control          # run in the foreground
codex remote-control start    # start the local app-server daemon with remote control enabled
codex remote-control pair     # print a short-lived manual pairing code
codex remote-control stop

ペアリングコードは ChatGPT のモバイルアプリに入力します。r/codex のユーザーは、ヘッドレスな Linux でこれが動いたと報告していますが、何度も話題になる要件が 2 つあります。API キーではなく ChatGPT でのサインインが必要なこと（スレッドで引用されているエラーは「remote control requires ChatGPT authentication」）、そして、npm 版では動かずインストールスクリプト版では動いたというコメントがあることです。

うまくいかなかったという報告（Reddit、2026 年 7 月〜9 月。バージョンによって結果は異なります）：

• スマホがつながったあと、数分すると Mac アプリへの接続を求めるウェルカム画面が表示される。
• セッションの履歴は見えるが、スマホからメッセージを送ると、すでに動いている CLI のセッションではなく 別のフォークに分かれてしまう。
• アップデート後、スマホがまるでコンピューターとペアリングしたことがないかのように振る舞う。そのスレッドでの OpenAI スタッフの返信は codex remote-control pair を案内している。

実際のところ：実在するコマンドで、特にスマホから新しいチャットを始めるなら試す価値があります。ただ、同じように動き続けることを前提にしたワークフローは組まないでください。公式ページでは、CLI はモバイル向けのサポート対象のセットアップ方法ではないとされています。

選択肢 3：スマホから SSH + tmux

昔ながらの確実な方法です。サーバー側で：

tmux new -s codex     # or: tmux attach -t codex
codex

スマホ側は、どの SSH クライアントでも構いません（Termius、Blink、Moshi、Android なら Termux）。接続先のネットワークが変わるなら mosh を、SSH をインターネットに公開したくないなら Tailscale を使いましょう。

• 良い点： 新たに信頼すべきものがなく、どのエージェントでも使え、tmux がセッションを保持するので切断にも耐えます。
• 注意点： スマホでフルのターミナル UI を読むことになります。差分のレビュー、長い承認プロンプト、「3 つのペインのどれが止まっている？」というあたりで疲れてきます。フックを自分で組まない限り、プッシュ通知もありません。

たまに様子を見るだけなら、これで十分ですし無料です。

選択肢 4：Linux マシン上で動くコンパニオンアプリ

別のコンピューターを起こしておかずに、スマホから Linux マシン上の Codex を操作したいなら、Happier は Codex、Claude Code、OpenCode などのエージェントを、スマホ、デスクトップ、Web からクロスデバイスで実行・オーケストレーションできるオープンソースのアプリです。この分野には他のアプリもあり、Linux 上の Codex に対応しているものもあります。以下の手順では Happier のセットアップを説明します。

仕組みは選択肢 1 や 2 とは違います。Linux マシンに Happier CLI をインストールすると、そのマシンがアカウントのマシンとして登録され、スマホはリレー（Happier Cloud、またはセルフホストしたもの）を通じてマシンと通信します。セッションの内容はデフォルトでエンドツーエンド暗号化されます。ID、タイムスタンプ、デバイス ID などのメタデータは暗号化されません。

1) Linux マシンに Happier をインストールする

curl -fsSL https://happier.dev/install | bash
happier setup

happier setup は使うリレーを尋ね、サインインし、このマシンを登録し、バックグラウンドサービスの自動起動を設定します。

デスクトップから進めたい場合は、デスクトップアプリから SSH 経由でリモートマシンをセットアップすることもできます（マシンの設定にある Add machine over SSH、または CLI が入っているコンピューターから happier machine setup --ssh user@host）。

2) マシンに Codex がインストールされ、サインイン済みであることを確認する

happier install provider codex   # or: npm install -g @openai/codex
codex --version                  # shared TUI control needs 0.131.0 or newer

次にサインインします。マシン上で codex login を実行するか、Happier に認証情報を持たせることもできます：

happier connect codex --device   # device-code flow, handy on a headless box
happier connect codex --paste    # fallback: paste the redirect URL
happier connect codex --api-key  # API key mode

デバイス認証では、先に ChatGPT の設定で「device code authorization for Codex」を有効にする必要がある場合があります。

3) どちら側からでもセッションを始める

マシン側から（SSH が切れても TUI が残るように tmux の中で）：

cd ~/src/my-repo
happier codex

またはスマホから：新しいセッションを作り、Linux マシンを選び、Codex を選んで、タスクを入力します。

4) スマホと TUI を同じスレッドで使う

Happier 0.2.13 以降、macOS または Linux で Codex CLI 0.131.0 以降を使う場合、Happier と Codex TUI は 同じ実行中のアプリサーバーのスレッド に接続します。SSH 越しに TUI で入力し、次のコマンドをスマホで承認しても、どちらもライブのままです。スマホから始めたセッションなら、マシン上で happier attach <session-id> を実行すると、同じセッションで TUI が開きます。

正直な制限：

• 共有操作が使えるのは Happier 経由で始めた セッションだけです。codex で直接始めたスレッドには、実行中に Happier から参加できません。Codex はスレッドごとに書き込み手をひとつに保つためです。
• Windows、ACP モード、古い Codex CLI では操作は排他的になり、スマホからのメッセージはターミナル側のターンが安全な区切りに達するまで待ちます。
• Linux マシンはオンラインである必要があります。Happier は、電源の切れたマシン、切れたネットワーク、プロバイダーの障害を解決するわけではありません。起きている必要があるのをそのマシンだけにする、というだけです。

任意：ターミナルマルチプレクサーとして Herdr を使っているなら、Happier 0.2.16 のリリースで、新しいセッションのターミナルホストとして Herdr が追加されました（Herdr 0.9.2 以降、macOS と Linux）。ドキュメントのページによっては、更新が追いつくまで開発ビルドの機能と表記されているものもあります。

どれを選ぶべき？

トラブルシューティング

「remote control requires ChatGPT authentication」

API キーでサインインしています。選択肢 1 と 2 では、Codex に ChatGPT アカウントでサインインしてください（codex login を実行して ChatGPT を選ぶ）。Happier では happier connect codex --api-key で API キーモードも使えますが、どのアカウントにセッションを課金したいか確認しましょう。

スマホにまた「Mac を接続」のウェルカム画面が出る

選択肢 2 でよく報告される症状です。codex remote-control pair を再実行して、もう一度ペアリングしてください。何度も起こるなら、それはこの方法のサポート対象外の部分が表に出ているということです。安定して使うなら選択肢 1 か 4 です。

スマホからのメッセージが CLI のセッションの続きではなく新しいチャットになる

選択肢 2 で報告されているフォークの挙動です。Happier では、happier codex で（またはアプリから）セッションを始めると、TUI とスマホが同じスレッドを共有します。素の codex で始めたスレッドにはライブで参加できません。

Happier で Linux マシンがオフラインと表示される

マシン上で：

happier daemon status --all

マシンとスマホが 同じリレーとアカウント を使っていることを確認してください。サービスは動いているのにセッションで Codex が起動しない場合は、codex が対話シェルだけでなく、バックグラウンドサービスから見える PATH にもあるか確認してください。

よくある質問

スマホから Codex を操作するのに Mac は必要ですか？

OpenAI のサポート対象の Remote を使うなら必要です。ChatGPT デスクトップアプリを動かす Mac または Windows PC が要ります（2026-10-11 時点）。codex remote-control の CLI やサードパーティのコンパニオンアプリなら不要です。

作業はスマホで動くのですか、それともクラウドですか？

4 つの選択肢すべてで、コードとコマンドは Linux マシンで動きます。スマホはプロンプトと承認を送るだけです。（Codex のクラウドタスクは OpenAI の別の製品で、ここでは扱いません。）

Claude Code でも同じことができますか？

はい。ただし Anthropic の Remote Control には別の要件があります（API キーではなく claude.ai でのサインイン）。Claude Code をスマホから監視する方法 を参照してください。

Happier は無料ですか？

アプリと CLI はオープンソースです。Codex 自体の料金は、引き続き OpenAI のプランか API キーで請求されます。

関連ガイド

• Codex をスマホから使う方法
• Claude Code、Codex、OpenCode を自宅サーバーで動かし、スマホのブラウザから進捗を確認する方法
• Tailscale 経由でスマホから Happier にアクセスする方法