設定の基本はMac miniで共有、MacBook Proで登録する2ステップ
OrcaのRemote Orca Serversを利用すると、Mac miniにある開発環境を、外出先のMacBook Proから操作できる。Claude CodeやCodexのセッション、Git worktree、ターミナルなどをMac mini側に保持したまま、別の端末からアクセスできるのが特徴だ。
結論から言うと、設定の本体は2ステップだ。Mac miniのOrcaで「このコンピューターを共有」からアクセスリンクを発行し、MacBook ProのOrcaでそのリンクを登録する。基本的にはGUIだけで完結する。
本シリーズ本編では機能やメリットを中心に解説したので、この記事は設定作業のための補足資料となる。Mac miniとMacBook ProをTailscaleで接続し、実際にリモート開発を始めるまでの手順を紹介する。
今回の環境と事前準備
今回の構成は、サーバー側がMac mini、クライアント側がMacBook Pro、開発管理がOrca、AIエージェントがClaude Code / Codex、接続ネットワークがTailscale、接続方式がRemote Orca Serversだ。Mac miniに開発環境を集約し、MacBook Proからリモートで操作する。ソースコードやDocker環境をMacBook Proに移動する必要はない。
事前準備として、Mac miniとMacBook Proの両方で次を確認する。Orcaがインストールされ、互換性のあるバージョンになっていること。Tailscaleがインストールされていること。両方のMacが同じTailscaleネットワークに参加していること。Mac miniでOrcaが起動していること。そして、Mac miniがスリープしていないこと。
Tailscaleは、離れた端末同士をプライベートネットワークで接続できるサービスだ。今回の構成では、Mac miniに割り当てられたTailscale IPアドレスを利用する。
Mac mini側でリモート共有を設定する
まずは普段開発に使用しているMac miniで操作する。流れは、リモートサーバーの画面を開く、接続アドレスを選ぶ、アクセスリンクを作成する、リンクをMacBook Proへ渡す、の4ステップだ。
[画像挿入：Mac mini側の共有設定手順が分かるフロー図]
リモートサーバーの画面を開く
Mac miniでOrcaを起動し、設定から「リモート Orca サーバー」を開く。右上にある「このコンピューターを共有」をクリックする。
接続アドレスを選ぶ
共有設定画面では、接続先からアクセスするためのアドレスを選択する。今回の構成では「別のデバイス」を選び、Tailscaleのアドレスを指定する。TailscaleのIPアドレスは、一般的に100.x.x.xの形式になる。
127.0.0.1はMac mini自身を指すため、別のMacから接続する今回の用途では選択しない。
アクセスリンクを作成する
共有設定画面で「リンクを作成」を操作し、接続用リンクを発行する。画面には「ブラウザー用リンク」と「アクセスリンク」が表示されるが、今回使用するのは「アクセスリンク」だ。右端のコピーアイコンでコピーする。
すでに「有効なリンク1件」と表示され、利用できるリンクがある場合は、新しく作る必要はない。
リンクをMacBook Proへ渡す
コピーしたアクセスリンクを、MacBook Proで利用できるようにする。リンクは接続権限を与える情報なので、パスワードと同じように取り扱う。
ブログ記事、SNS、公開リポジトリなどには貼り付けないこと。スクリーンショットを公開する場合も、リンク全体を確実に隠しておこう。
MacBook Pro側でMac miniを登録する
続いて、外出先で使用するMacBook Pro側の設定だ。流れは、サーバーを追加から登録を始める、接続情報を入力する、ホストを追加で確定する、接続状態を確認する、の4ステップで進む。
「＋ サーバーを追加」から登録を始める
MacBook ProでOrcaを起動する。「設定」→「リモート Orca サーバー」を開き、右上の「＋ サーバーを追加」をクリックする。
接続情報を入力する
表示される登録画面には、2つの項目がある。「Orcaでの名前」にはMac mini、「アクセスリンク」にはMac miniでコピーした接続リンクを入力する。
「Orcaでの名前」は、接続先を識別するための表示名だ。Mac miniと入力しておけばわかりやすい。接続に利用するホスト名やIPアドレスを、ここに入力する必要はない。接続情報は「アクセスリンク」に含まれている。
「ホストを追加」で登録を確定する
2つの項目を入力したら、「ホストを追加」をクリックする。今回確認した日本語UIでは、最初の画面に「＋ サーバーを追加」、登録画面の確定ボタンに「ホストを追加」と表示されている。似た名称なので注意したい。
接続状態を確認する
登録されたMac miniの接続状態を確認する。未接続や切断の状態であれば、接続操作を行う。接続が確立されれば、Mac miniのOrcaランタイムへアクセスできる。
Mac miniの既存プロジェクトを開いてセッションを確認する
接続できたら、MacBook Pro側のOrcaでMac miniのリモートサーバーを選択する。Mac mini側の既存プロジェクトを開き、以前使用していたワークスペースを選ぶ。
Remote Orca Serversでは、Mac mini側がプロジェクト、Git worktree、ターミナル、AIエージェントのセッション、ワークスペースのタブや表示状態を管理している。これらはMacBook Pro側にコピーされるのではなく、Mac mini側のものを利用する。MacBook Proで新しいリポジトリをcloneしたり、既存worktreeを作り直したりする必要はない。
既存のClaude Codeセッションを開き、次の4点を確認しよう。1) 以前の会話や実行結果が表示される。2) ターミナルに入力できる。3) 新しい指示に対してエージェントが動作する。4) ファイルの変更がMac mini側のリポジトリに反映される。この確認ができれば、Mac miniとMacBook Proの間で開発作業を引き継ぐ環境が整ったことになる。
Webアプリの動作確認
Next.jsなどのWebアプリを開発している場合は、ブラウザでも確認しよう。Orcaの内蔵ブラウザを使う方法と、Chromeなどの通常ブラウザを使う方法の2通りがある。
Orcaの内蔵ブラウザを使う
Mac miniで開発サーバーを起動する。例えば3000番ポートでNext.jsが動いている場合は、MacBook ProのOrcaで、該当するリモートワークスペースのブラウザを開き、http://localhost:3000にアクセスする。
Orcaのリモートワークスペースには、内蔵ブラウザの通信をリモートホスト側へ経由させる仕組みがある。これにより、Mac mini側で動いている開発サーバーをMacBook Proから確認できる。
SSHポートフォワーディングでChromeなどから開く
Chrome、Brave、Vivaldiなどを使って確認するなら、SSHポートフォワーディングが利用できる。まずMac miniで、macOSの「システム設定」→「一般」→「共有」から「リモートログイン」を有効にし、接続ユーザーを許可する。
MacBook Proのターミナルで次を実行する。Mac miniのユーザーがdeveloper、Tailscale IPが100.64.1.20であれば、次のようになる。
ssh -N -L 3000:localhost:3000 developer@100.64.1.20
このコマンドのターミナルを開いたまま、MacBook ProのChromeなどでhttp://localhost:3000を開く。Mac mini側のWebアプリが表示されれば成功だ。
なお、MacBook Proの3000番ポートを別のアプリが使用している場合は、ローカル側だけ3001などに変更できる。
ssh -N -L 3001:localhost:3000 developer@100.64.1.20
この場合は、MacBook Pro側でhttp://localhost:3001にアクセスする。SSHポートフォワーディングはOrcaとは独立した方法なので、通常ブラウザでの検証にも利用できる。
外出先で使うためのMac miniのスリープ設定
Remote Orca Serversでは、Mac miniがサーバーとして動作する。そのため、外出中もMac miniを起動しておく必要がある。特に重要なのがスリープ設定だ。Mac miniがスリープすると、リモート接続できなくなる場合がある。
macOSの省エネルギー関連設定を確認し、必要に応じて、ディスプレイがオフになってもコンピューターがスリープしないように設定する。Orcaにも、スリープを抑制する関連設定がある。
接続できないときの確認ポイント
接続トラブルの大半は、Orcaの起動、Tailscaleの接続、Mac miniのスリープ、リンクの取り違え、CLIと認証の所在、バージョン互換のいずれかに起因する。症状別に確認点を整理しよう。
Mac miniが表示されない場合は、まずMac miniのOrcaが起動しているかを確認する。続いて、両方のMacのTailscaleが接続されているか、Mac miniがスリープしていないかを確認する。
アクセスリンクで登録できない場合は、Mac mini側の「アクセスリンク」を正しくコピーしたか、「ブラウザー用リンク」と取り違えていないか、リンクが無効になっていないかを確認する。
接続済みなのにプロジェクトが表示されない場合は、接続先としてMac miniを選択しているかを確認する。ワークスペース一覧で、他のクライアントのワークスペースを非表示にするフィルターが有効になっている場合もある。既存プロジェクトを作り直す前に、接続先と表示フィルターを確認したい。
Claude Codeが起動できない場合は、CLIと認証情報がMac mini側にあるかを確認する。Remote Orca Serversで使用するCLIや認証情報はMac mini側のものだ。MacBook ProにClaude CodeやCodexがインストールされていても、それだけではMac mini側で実行できるとは限らない。
接続できない原因が他に見当たらないときは、Orcaのバージョンを確認する。リモートサーバーとクライアントで互換性のないバージョンを使用すると、接続できないことがある。両方のMacのOrcaを更新してから、再度接続を試してみよう。
セキュリティ上の注意
Remote Orca Serversは、開発環境のファイルやターミナルへアクセスできる強力な機能だ。そのため、接続権限の管理が重要になる。
今回の構成では、Tailscaleによるプライベートネットワークを利用する。Orcaのサーバーポートを、インターネット上へ直接公開する必要はない。
また、ペアリングしたクライアントのアクセス権限についても適切に管理したい。使用しなくなった端末のアクセス権限は、無効化しておくとよい。
最終チェックリストとまとめ
設定が一通り終わったら、次の順番で動作を確認しよう。Mac miniとMacBook Proの両方にOrcaを導入した。両方のMacでTailscaleを接続した。Mac miniでアクセスリンクを作成した。MacBook Proで「Orcaでの名前」と「アクセスリンク」を入力し、「ホストを追加」で登録できた。Mac miniへの接続状態が正常になった。既存プロジェクトを開けた。Claude Codeなどの既存セッションを確認できた。Mac mini側のファイル変更を確認できた。Orcaの内蔵ブラウザでWebアプリを確認できた。必要に応じてChromeなどでのアクセスも確認できた。Mac miniのスリープ設定を確認した。
Remote Orca Serversを使えば、自宅のMac miniを開発拠点として維持しながら、外出先のMacBook Proで同じ開発環境を利用できる。構成そのものは意外とシンプルだ。Mac miniでOrcaを共有し、MacBook Proからアクセスリンクを使って登録する。これだけで、リモートのOrcaランタイムへ接続するための基本的な準備が整う。
あとは、既存プロジェクトやセッション、Webアプリの動作を確認すればよい。AIエージェントを使った開発を場所に縛られず続けるための、非常に便利な仕組みだと思う。