Codex Mobile をセットアップする

約5分

ChatGPT モバイルアプリを Codex App ホストへ初めて接続する人

Codex Mobile の基礎を読み、Mac または Windows に Codex App を導入できること

このチュートリアルでは、Codex App を実行するコンピューターと ChatGPT モバイルアプリを接続し、読み取り中心のテストタスクで疎通を確認します。

完成する状態

完了後は、次の構成になります。

ChatGPT mobile app (iOS / Android)
          |
          | secure remote connection
          v
Codex App host (macOS / Windows)
          |
          +-- project files
          +-- shell and tests
          +-- plugins and permissions

スマートフォンからホストのプロジェクトを選び、スレッドを開始し、結果を確認できれば成功です。

前提条件を確認する

Codex を利用できる ChatGPT アカウント
最新の ChatGPT モバイルアプリ
最新の Codex App for macOS または Windows
両方で同じ ChatGPT アカウントとワークスペースを使用
組織アカウントでは、管理者が Remote Control を許可
必要な MFA、SSO、パスキーを完了できる状態

公式ドキュメントでは、モバイル設定は Codex App から開始し、Codex CLI や IDE extension からは開始できないと説明されています。

Step 1: ホストを準備する

Codex App を起動し、日常的に使うプロジェクトを開きます。Git の状態を確認し、未保存の重要作業がないことも確認します。

git status --short

期待する出力:

# 変更がなければ何も表示されない

確認: 接続対象のプロジェクト名とパスが正しく、既存変更の有無を説明できれば次へ進みます。

Step 2: Codex Mobile の設定を開始する

ホストの Codex App のサイドバーから Set up Codex mobile を選択します。遠隔接続を有効にすると QR コードが表示されます。

確認: ホスト画面に接続用 QR コードが表示されれば成功です。

Step 3: QR コードを読み取る

スマートフォンのカメラで QR コードを読み取ります。ChatGPT アプリが開いたら、ホストと同じアカウントおよびワークスペースであることを確認します。

MFA、SSO、パスキーを求められた場合は、表示された認証手順を完了します。

確認: ChatGPT モバイルアプリの Codex 画面にホスト名が表示されれば接続成功です。

Step 4: 接続設定を確認する

ホストの Codex App で Settings > Connections を開きます。次を確認します。

接続したスマートフォンが登録されている
意図しない端末が登録されていない
コンピューターを起動状態に保つ設定が意図どおりである
Computer Use や Chrome extension が必要な場合だけ有効である

確認: 接続端末と有効な機能を説明できれば成功です。

Step 5: 読み取りタスクで疎通を確認する

スマートフォンから新しいスレッドを開始し、次のように依頼します。

このプロジェクトの種類、主要な記事ディレクトリ、検証コマンドを調査してください。
ファイルは変更せず、読み取ったファイルと根拠を短く報告してください。

期待する結果:

- プロジェクト種別
- 記事ディレクトリ
- package.json などから確認した検証コマンド
- ファイル変更なしという報告

確認: ホストの実際のプロジェクトに合う情報が返り、変更ファイルが増えていなければ疎通確認は完了です。

Step 6: 承認要求をテストする

安全な読み取りコマンドを明示して依頼します。

`git status --short` を実行し、結果を報告してください。
書き込み操作やネットワークアクセスは行わないでください。

承認が表示された場合は、コマンドが指定どおりであることを確認して承認します。

確認: 実行コマンドと出力をスマートフォンで確認できれば成功です。

トラブルシューティング

症状	確認すること
ホストが表示されない	Codex App が動作中か、遠隔接続が有効か、同じアカウントか
承認通知が届かない	ChatGPT アプリの Codex 画面、通知設定、ワークスペースを確認
接続が切れる	ホストのスリープ、ネットワーク、Codex App の終了を確認
認証で止まる	MFA、SSO、パスキー、組織の Remote Control 設定を確認
Codex メニューがない	ChatGPT と Codex App を最新版へ更新し、提供地域とロールアウトを確認

接続を解除する

端末を紛失した場合や共有端末で試した場合は、ホストの Settings > Connections から該当端末を解除します。アカウントのセッション、MFA、組織ポリシーも必要に応じて確認します。

まとめ

QR コードによる接続後も、実行環境はホスト側にあります。最初は読み取りタスクで接続を確認し、端末一覧と権限を確認してから書き込みタスクへ進みます。

次は具体的な開発タスクを進めるで、調査からレビューまでの流れを実践します。

このページの外部仕様・背景情報は、参考文献を参照してください。[1][2]

参考文献

OpenAI, Codex documentation
OpenAI, OpenAI API documentation

クイズ

Codex Mobile で具体的な開発タスクを進める

Codex Mobile の基礎