Codex をスマホから使う方法：監視、承認、差分確認までモバイルで

Codex はよく動きますが、セッションが「一度の作業」で終わらないと、デフォルトの使い勝手は扱いにくくなります。

ターミナルから離れた瞬間に、手軽な操作ループが失われがちです。

進捗を確認する
補足の指示を送る
ツールの権限を承認する
変更をレビューする

スマホでも SSH で力業で対応することは できます。ただ、スマホはターミナルとしては使いにくいものです。

つまり課題はこうです。Codex をセッションを所有するマシンで動かしたまま、スマホからセッションを進める（指示、承認、レビュー）。

Happier は、Codex、Claude Code などのエージェントを、スマホ、デスクトップ、Web からクロスデバイスで実行・オーケストレーションできるオープンソースのアプリです。トレードオフ：使いたいフロー（attach / resume など）に合わせて、所有するマシン側で認証と適切なバックエンドを設定しておく必要があります。

要点

Happier をセットアップし、マシン上で Codex を認証します（CLI または連携サービス）。
Happier（スマホ / Web / デスクトップ）から Codex セッションを開始し、実行するマシンを選びます。
Happier 0.2.13 以降と Codex CLI 0.131.0 以降の組み合わせ：ネイティブの Codex TUI と Happier アプリが同じ App Server スレッドに接続します。ターミナルで入力しながらスマホで承認でき、どちらも同じセッションでリアルタイムに動きます。
スマホでは、トランスクリプトを追い、指示を送り、承認を処理し、差分をレビューします。
いつでも happier attach <session-id> でターミナルに切り替えられます。セッションは共有されたままです（App Server を使う macOS / Linux）。

Happier を通さずに codex で直接開始した Codex スレッドには、実行中は Happier から参加できません。Codex はスレッドごとに書き込み可能なクライアントをひとつに限っているためです。

課題

Codex は作業そのものは得意です。

手間がかかるのはその周りです。

「セッションはどこで動いている？」
「ノート PC の前にいないとき、どうやってセッションを進める？」
「セッションを分岐させずにターミナルに戻るには？」

認証：Codex に確実にログインさせる

Codex はマシンごとの認証を次の場所で管理できます。

設定 → AIプロバイダー → Codex（Settings → AI provider settings → Codex）

ここでは次のことができます。

選択したマシンで Codex にログインしているか確認する
Happier が CLI のログインと OPENAI_API_KEY のどちらを検出したか確認する
Happier の中から直接 codex login を開く

Happier の連携サービスから認証することもできます。

サブスクリプション認証（デバイス / 貼り付けフロー）
または API キー

CLI の例：

happier connect codex --device
happier connect codex --paste
happier connect codex --api-key

バックエンド：Codex でつまずきやすいポイント

これは理解しておきたい Codex 特有の注意点です。

Happier では、Codex を複数のバックエンドで動かせます。

Codex App Server（デフォルト）：再開のしやすさとアプリ中心のワークフローを重視するなら、おすすめの方法です。
Codex ACP：明示的に選んだ場合のフォールバックです。
Codex MCP：新規セッションには使えますが、通常のベンダー再開の経路ではありません。

実際に重要な動作は 2 つです。

新規セッションでは、Happier はデフォルトで App Server を使い、利用できない場合に黙って別の方法へフォールバックしません。
再開では、Happier は厳格です。黙って新しいセッションを始めるのではなく、エラーを返します。

この 2 つのルールを理解すれば、スマホからの Codex 操作が「予測できない」と感じなくなります。

Happier を初めて使う場合（概要と入手方法）

Happier は、Claude Code、Codex、OpenCode などの AI コーディングエージェント向けの オープンソースのコンパニオンアプリ（モバイル / Web / デスクトップ）です。

ここでのワークフローは、Codex をワークスペースのあるマシンで動かしたまま、スマホの Happier から監視、指示、承認、レビューを行うというものです。

このガイドでいえば、Codex の「セッションの見守り」部分（指示、承認、差分のレビュー）を SSH に張り付かずにこなせます。

セットアップ：

スマホから Happier を使う方法
GitHub: https://github.com/happier-dev/happier
インストール / ダウンロード: https://github.com/happier-dev/happier#how-it-works
Discord（コミュニティとサポート）: https://discord.gg/W6Pb8KuHfg

スマホでのワークフロー：Codex セッションを開始して進める

1) スマホからセッションを開始する

スマホ（アプリまたはモバイル Web UI）で：

新しいセッションを作成する
Codex を選ぶ
実行するマシンを選ぶ
タスクを送る

2) スマホで見守りのループを回す

スマホでできること：

トランスクリプトで進捗を読む
指示を送る（「いったん止めて、何を変えたか説明して」「このファイルだけ触って」）
モードに応じて権限のプロンプトを処理する
コミット前に差分をレビューする

3) ターミナルとスマホを行き来する（どちらもリアルタイム）

Happier 0.2.13 以降と、macOS / Linux 上の Codex CLI 0.131.0 以降の場合：

Happier から Codex セッションを開始すると、ネイティブの Codex TUI と Happier アプリが 同じ実行中の App Server スレッド に接続します。両方が同時にリアルタイムで動きます。

SSH 経由の TUI でプロンプトを入力する → スマホのアプリに表示される
スマホでコマンドを承認する → TUI が処理を続ける
happier attach <session-id> で、スマホから開始したセッションの TUI を開ける

これは引き継ぎではなく 共有コントロール です。画面を切り替えてもセッションは止まりません。

制限：

共有コントロールが使えるのは Happier から開始した セッションだけです。codex で直接開始したスレッドには、実行中は Happier から参加できません（Codex はスレッドごとに書き込み可能なクライアントをひとつに限っています）。
Windows、ACP モード、または古い Codex CLI では、操作は排他的になります。スマホからのメッセージは、ターミナル側のターンが安全な区切りに達するまで待機します。
セッションを実行するマシンはオンラインである必要があります。オフラインのマシンやプロバイダーの障害は Happier では解決できません。

セッションを所有するマシンのノート PC やターミナルに戻ったら：

happier attach <session-id>

非アクティブな Codex セッションを再開する（何が起きるか）

Happier での Codex の再開は、通常はデフォルトの App Server 経路を使います。

非アクティブな Codex セッションを再開できるのは次の場合です。

セッションに有効な Codex の再開メタデータがある
現在のバックエンドとマシンの組み合わせが再開に対応している（デフォルトは App Server、明示的に選んだ場合は ACP）
選択した再開経路に必要な依存関係がマシンにインストール済み

CLI から：

happier resume
# または
happier resume <session-id>

スマホ / アプリ / Web から：

非アクティブなセッションは、再開可能な場合にだけ入力を受け付けます
メッセージを送ると、まず再開が実行されます

権限とモード（簡単に）

プロンプトで頻繁にブロックされる場合：

まずは デフォルト（Default）から始める
中断を減らしたいなら セーフYOLO（Safe YOLO）を試す
YOLO は意図して使い、あとで差分を確認する

トラブルシューティング

症状：Codex セッションが再開できない

考えられる原因：

セッションがベンダー再開に対応していないバックエンド経路にある（素の MCP を強制した場合によくあります）
選択した経路に必要な依存関係がインストールされていない

対処：

再開可能なセッションにはデフォルトの App Server 経路を使う
マシン上で Codex を認証済みで使える状態にしておく

症状：ターミナルから attach できない

考えられる原因：

セッションを所有するマシンとは別のマシンで操作している
attach の動作は OS によって異なる（Linux / macOS では tmux、Windows では別のホストモード）

対処：

セッションを所有するマシンで attach を実行する

よくある質問

Codex の継続性は Claude と同じくらい安定していますか？

うまく動くこともありますが、ドキュメントには、一部の経路では Codex の引き継ぎや継続性が Claude / OpenCode ほど成熟していないと明記されています。

現時点でマシン間の引き継ぎを安定させたいなら Claude / OpenCode を選んでください。Codex を使うなら、使うマシンで認証と依存関係を準備しておきましょう。