2026年、OpenHandsのサンドボックスをどう導入すれば、AIコーディング作業とmacOSホストを隔離できるか?
OpenHandsは、公式ドキュメントに沿ったコンテナ実行を選び、タスクに必要な作業ディレクトリだけを渡して導入してください。コンテナは絶対的な隔離ではないため、Docker socketやホストの認証情報は、必要性を確認できるまで接続しないのが基本です。
macOSで初めてOpenHandsを動かす開発者は、実行環境とマウント範囲を順に確認できます。
複数のコードベースを扱うチームは、作業領域、認証情報、接続口をタスクごとに分ける判断に役立ちます。
XcodeなどmacOS固有のツールチェーンを使う責任者は、コンテナ実行とネイティブビルド環境の役割を切り分けられます。
1. OpenHandsの実行先を選び、現行の手順を確認する
OpenHandsのサンドボックス導入では、最初に「Agentをどこで動かすか」を決めます。ホスト上で直接実行する方式と、Dockerコンテナ内で実行する方式では、Agentが触れられるファイルや実行環境の境界が異なるためです。コードの編集やテストに加え、信頼できないリポジトリのスクリプトも実行するなら、公式に案内されているコンテナ実行経路を優先してください。
現行のローカル導入手順はOpenHands公式のローカルセットアップで確認し、公式のサンドボックス概要とDockerサンドボックスの説明も合わせて参照します。文書にはV0と明記された旧Docker Runtimeの説明もあります。古い手順を現行の標準設定とみなさず、実際に使う導入経路、イメージ指定、マウント方法、Docker socketの扱いを、その時点の現行ページで照合してください。
次の条件分岐で実行先を決めます。
- プロジェクトの編集やテストが目的で、macOS固有のビルドを必要としない場合:公式のコンテナ実行を選び、作業ディレクトリを限定します。
- Agentにホスト上の広いファイルアクセスが必要な場合:その理由と対象パスを先に特定し、直接実行を含む構成を慎重に再検討します。利便性だけを理由にホームディレクトリ全体を渡すのは避けます。
- XcodeなどのmacOSネイティブ環境が必要な場合:コンテナがmacOSのビルド環境になるとは考えず、Agentの実行場所とネイティブビルド場所を分けて設計します。
2. 作業領域を用意し、ホストから見える範囲を絞る
Agentが作業する専用ディレクトリを用意し、タスクに不要なソース、秘密鍵、個人データを同じ場所に置かないようにします。参照だけでよい資料は読み取り専用のマウントにし、編集対象だけに書き込みを許可してください。
Dockerのバインドマウントは、ホスト上のパスとコンテナ内のパスを結び付けます。たとえば設定上のsource:targetは、ホスト側の場所とコンテナ側の場所の対応を表し、読み取り専用オプションを指定した領域は書き込み用途と分けられます。具体的な書式やオプションはDocker公式のバインドマウント説明で確認してください。
注意:マウントした作業領域は、コンテナ内から変更した内容がホスト側にも反映されます。コンテナで動かすだけでは、マウント先の削除や上書きを防げません。
OpenHandsが見られるファイルは、コンテナ内に存在するものだけでなく、設定で渡したホスト側のマウント先にも左右されます。したがって「Mac上のどのファイルにアクセスできるか」は、OpenHandsの画面上の権限表示だけではなく、実際のマウント設定で判断します。プロジェクトだけを渡すなら、ホスト側の専用プロジェクトディレクトリをマウント元に指定し、親ディレクトリやホームディレクトリを不用意に含めないでください。
3. サービスの接続口とDocker権限を制限する
管理画面は、アクセスする必要がある範囲にだけ公開します。ローカルでの利用なら、公式の起動設定においてホスト側の待受先がループバックアドレス127.0.0.1に制限されているかを確認し、外部ネットワークから到達できる設定を避けます。ポートを公開する場合のホストアドレス指定と挙動は、Docker公式のポート公開資料で確認できます。
Docker socketは、コンテナなどのクライアントからDockerデーモンに操作を依頼するための接続口です。macOS環境でも、OpenHandsのコンテナへホスト側のDocker管理ソケットを渡す設定は、Agentにコンテナ管理能力を与えることにつながります。別のコンテナを起動する必要があるタスクだと確認できない限り、socketを接続しないでください。Dockerデーモンへのアクセスを慎重に扱う理由は、Docker公式のアクセス保護資料にも説明されています。
4. 認証情報を分け、初回の小さなタスクで確認する
モデルサービスの認証情報、コードリポジトリの認証情報、作業ディレクトリへの権限は別々に管理します。コンテナ化しても、Agentへ渡したキーの誤用、ネットワーク経由のアクセス、ユーザーが許可した操作までは自動的に防げません。私有リポジトリや外部APIを使うなら、タスクに必要な範囲に絞った認証情報を用意し、作業終了後の失効・更新手順も決めておきます。GitHubのAPI認証情報に関する推奨事項とトークンの期限・失効手順を確認し、広い権限の個人用認証情報をそのまま渡す運用は避けてください。
初回は、機密情報を含まない小さなコード作業を選び、以下を順番に点検します。
- [ ] OpenHandsの管理画面に、意図した接続範囲からアクセスできる。
- [ ] 現行の公式手順どおりにコンテナ実行が始まり、実行環境のエラーがない。
- [ ] 作業ディレクトリだけがマウントされ、参照資料は必要に応じて読み取り専用になっている。
- [ ] 変更されたファイルが予定したホスト側ディレクトリにだけ現れる。
- [ ] タスクに不要なホストパスやDocker socketがOpenHandsへ渡っていない。
- [ ] タスク終了後、コンテナや一時的な認証情報の扱いを確認できる。
この確認で見落としやすいのは、画面に表示された作業場所とホスト側のマウント元が一致しているかです。小さなファイルを一つ変更させ、ホストのどこに反映されたかを確認してから、実データを扱うタスクへ進めます。
5. 終了後に一時環境を整理し、ネイティブビルドを分担する
作業が終わったら、必要な変更だけをレビューして保存し、使い捨てのコンテナや作業領域をいつまでも既定の信頼環境として残さないようにします。タスク用に発行した認証情報は、予定した作業が済んだ段階で失効させるか、運用方針に従って更新します。
OpenHandsのコンテナ実行と、macOSアプリ向けのネイティブビルドは別の役割です。Dockerコンテナを使うことは、コンテナ内にmacOSやXcodeのネイティブ実行環境が用意されることを意味しません。また、AppleのApp Sandbox公式説明が扱うのは、アプリと許可された機能に関する仕組みです。これをコンテナの隔離保証と同一視しないでください。
| 作業条件 | 選ぶ構成 | 確認する境界 |
|---|---|---|
| 一般的なコード編集・テスト | OpenHandsの公式コンテナ実行 | 作業用バインドマウント、接続口、認証情報 |
| 参照資料を読むだけ | 読み取り専用マウントを含む構成 | 書き込み可能なパスが別に残っていないか |
| コンテナ操作をAgentに任せる必要がある | 必要性を個別に検証してから判断 | Docker socketを渡す影響と代替手段 |
| XcodeなどmacOS固有のビルドが必要 | AgentとmacOSネイティブビルド環境を分担 | ソース受け渡し方法と各環境の認証情報 |
従来のローカル実行はホスト側のファイルに触れやすく、広いマウントを使う構成では削除・上書きの影響範囲が広がり、Docker socketまで渡すとコンテナ管理権限も加わります。一方、コンテナだけでmacOSネイティブビルドまで完結できるとは限りません。Xcodeを含む作業では、Agentの実行領域とMac上のビルド領域を分けることで、専用ハードウェアの購入や常時稼働環境を抱えずに済む場合がありますが、必要な構成や提供条件は事前確認が必要です。
macOSネイティブのビルド環境を一時的に用意する場合は、KuzCloudの日本語サービス案内と日本向け料金ページで利用条件を確認できます。これはOpenHandsのコンテナを置き換える安全保証ではなく、Xcodeなどを使う工程を別のmacOS環境に分担させる選択肢です。
AI開発の実行環境を、KuzCloudの専用Macへ
専用のMac mini M4をリモートで利用し、AIによるコーディング作業を手元のMacから切り離して進められます。
SSHやリモートデスクトップで接続でき、root権限を使って必要なツールや実行環境を自由に整えられます。