Pairing する

ペアリング は、Mac と iPhone を最初につなぐ 1 回の操作です。やることは、Mac で QR を出して iPhone で読むだけです。ここを通せば、あとは iPhone からいまの Codex の続きを開けます。

最初は QR を使うのがいちばん簡単です。普段から Mac で Codex を使っている人なら、追加で意識することは CodexPocketMac を開くことと、QR を読み取ることの 2 つで十分です。

Mac 側	iPhone 側

ペアリング前に Mac で確認すること

• CodexPocketMac が起動している
• 一般 の ランタイム が 実行中 になっている
• 連携後すぐ使いたいなら、プロジェクト に少なくとも 1 件の Project がある

CodexPocketMac を開いた時点で Bridge がすでに動いていることがあります。ランタイム が 実行中 なら、そのまま次へ進めます。

Mac 側の操作

1. CodexPocketMac を開く
2. 一般 で ランタイム が 実行中 になっていることを確認する
3. ペアリング を開く
4. 表示された QR を iPhone から読み取れる状態にする

同じ画面から ペアリングURLをコピー と ペアリングコードをコピー も使えます。iPhone のカメラを使えないときは、こちらを貼り付けても構いません。

iPhone 側の操作

1. 初回は空の画面で QR から追加 を押す
2. 2 台目以降は左上のサイドバーから ホスト を開き、右上の + で QR から追加 を選ぶ
3. 必要ならカメラ権限を許可する
4. Mac の QR を読み取る
5. 読み取り結果 を確認する
6. Host として保存 を押す

QR を使わない場合は、同じ画面の またはペアリングコードを貼り付け からコードを読み込めます。

保存後に起こること

保存すると、iPhone 側では次の初回設定が自動で進みます。

• Bridge の検証
• Project 取り込み
• Workspace 準備
• Host 確定

この間、ホスト の一覧では対象 Host が 初回設定中 になります。Bridge の確認と最初の Project の準備が終わるまで、iPhone の画面を開いたまま待つのが確実です。

iPhone をバックグラウンドにすると処理が一時停止することがあります。その場合も、アプリに戻れば続きから再開されます。

QR が使えないとき

代わりに使える方法は次のとおりです。

• ペアリングURLをコピー した内容を開く
• ペアリングコードをコピー した内容を貼り付ける
• 必要なら 手入力で追加 で Bridge URL と Bearer Token を入れる

ペアリングURL と ペアリングコード は、どちらを使っても最終的に同じ内容が iPhone に登録されます。細かい接続先を自分で決めたいときだけ 手入力で追加 を使えば十分です。

セキュリティについて

QR とペアリングコードには、接続に必要なトークンが含まれます。取り込み後のトークンは iPhone の Keychain に安全に保存され、アプリの通常保存領域には残りません。

もし QR やコードを見られた可能性があるなら、Mac の ペアリング で トークンを再生成 してから、iPhone 側で登録し直してください。