Security

Claude Codeで見知らぬリポジトリをリモートMacでそのまま実行できる?2026年安全チェックリスト

Claude Codeで見知らぬリポジトリをリモートMacでそのまま実行できる?2026年安全チェックリスト

見知らぬリポジトリを開いた直後、Claude Codeにファイルの変更やコマンド実行を任せてよいか判断できないことがあります。

最短の判断は、ダウンロード先で直接実行しないことです。指示ファイルとスクリプトを確認し、作業領域、Agent権限、認証情報、外向き通信を制限できてから実行します。リモートMacというだけでは、コードも認証情報も隔離されません。

この記事が役立つ人
- 手元にMacがなく、リモートMacでClaude CodeやCodexを使って外部のリポジトリを扱う開発者。
- 共有のリモートMacやCIノードで、作業領域や認証情報の残留を点検するDevOps担当者。
- コーディングAgentをチームに導入する前に、受け入れ基準を決めたい技術責任者。

最終更新:2026年10月28日。確認対象は、2026年10月26日の研究事例を伝えた報道、AnthropicとOpenAIの公式資料です。

出所の信頼性:リポジトリの内容を信頼できる入力として扱えるか

確認すべきなのは、Gitの公開状態だけではありません。取得した経路、ダウンロードフォルダーに混在するファイル、プロジェクト指示ファイル、依存関係の導入スクリプト、フックや起動処理を個別に調べます。

2026年10月26日の報道は、研究者が悪意あるプロジェクト指示によるCodexとClaude Codeへの影響をテストした事例を伝えています。これは研究デモを媒体が報じたものであり、すべての利用者や設定で攻撃が成立することを示すものではありません。報道の範囲を超えて、一般的な発生率や製品の普遍的な欠陥とは扱わないでください。

指示ファイルは、Agentが参照するプロジェクト情報です。OpenAIのCodex向け指示ファイルの説明にあるように、AGENTS.mdは作業上の指示を伝える用途で使われます。しかし、そこに書かれた指示が、OSの権限やAgentの実行制御を上書きする安全装置になるわけではありません。

作業領域の隔離:プロジェクト外のファイルに届かないか

リポジトリ専用の作業フォルダーを用意し、Agentの開始ディレクトリと、実行ユーザーが読み書きできる範囲を確認します。ホームディレクトリ全体や、別プロジェクトのチェックアウト、共有の鍵・設定ファイルにアクセスできる状態なら、作業フォルダーを分けただけで安全とは判断できません。

AnthropicのClaude Codeサンドボックス説明では、ファイルシステムとネットワークに関する制御が説明されています。実際にどの範囲が制限されるかは、利用する設定と環境に基づいて確認してください。作業フォルダーを分けることは誤操作の範囲を抑える助けになりますが、それだけでプロセスがOSレベルで隔離された証明にはなりません。

判定項目 実行前に確認すること 放行の目安 保留する状態
入力元 配布元、取得経路、同梱ファイル 出所と内容を説明できる 由来不明のファイルが混在する
作業領域 開始ディレクトリ、読み書き範囲、実行ユーザー 対象リポジトリに必要な範囲へ限定される ホームや他案件までアクセスできる
実行権限 Agentの権限モード、承認対象、フック 副作用のある操作を確認して許可する 任意のコマンドが無確認で通る
認証情報 環境変数、設定、ログ、鍵 作業に必要な最小限だけを使う 長期トークンや共有鍵が読める
ネットワーク 外向き通信、取得先、プロキシ 必要な宛先と処理を説明できる 通信先を確認できず制限もない

実行権限の制御:指示と強制ルールを混同しない

Agentの自然言語指示、ツールの許可設定、OSレベルのサンドボックスは、異なる層の制御です。プロジェクト指示ファイルに「ファイルを書き換えない」と書いてあっても、それを強制する権限設定やOS制御がなければ、強制的な防護策とはみなせません。

実行前に、利用するAgentの権限モードとコマンド承認の挙動を確認します。AnthropicのClaude Code CLI権限モードの公式資料を参照し、書き込み、コマンド実行、設定変更など、状態を変える操作がどのように許可されるかを使う設定に照らして確認してください。プロジェクトフックや自動実行スクリプトも別に検査し、Agentの承認設定だけで安全と決めつけないようにします。

起動前に許可範囲を説明できない操作が一つでもあれば、実行を保留します。設定の名称だけではなく、実際にどの操作が通るかを対象環境の公式資料で照合してください。

認証情報の管理:読み取りと持ち出しの可能性を点検する

リポジトリの外にも注意が必要です。作業フォルダー、ユーザーの環境変数、コマンドライン設定、ログに、リポジトリ用トークン、クラウド資格情報、モデル認証情報が残っていないか確認します。Agentが実行可能なコードに触れる環境へ長期利用の認証情報を注入したまま、「別フォルダーだから隔離済み」と判断するのは危険です。

OpenAIのAgent実行環境に関するセキュリティ資料では、実行環境の分離、ネットワーク制限、認証情報の扱いが説明されています。そこで説明される機能を、あらゆるリモートMacサービスの既定動作とみなしてはいけません。使う環境にその制御があるかを確かめ、漏えいが疑われる場合は該当する認証情報を失効または更新します。

ネットワーク境界:未承認の取得先に接続できないか

リポジトリのスクリプトや依存関係の導入処理は、外部への通信を伴う場合があります。許可された取得先、パッケージ配布元、プロキシ経由の通信を確認し、Agentの承認とは別に、環境側で外向き通信を制限できるか調べます。

OpenAIの環境資料が説明する機能と、利用者やチームがネットワーク側で設定する制御は区別してください。リモート環境であることだけから、通信先が制限されているとは推測できません。CIで同じノードを共有する場合は、GitHub Actionsの安全な利用に関する公式資料も参照し、ジョブ間で認証情報や実行状態を共有しない設計を検討します。

初回実行の受け入れ手順

  1. 取得元を記録します。 リポジトリの配布元と取得経路を確認し、別のダウンロード物が混在するフォルダーから切り離します。
  2. 指示ファイルを読みます。 AGENTS.mdなど、Agentが参照するファイルと、その内容が対象作業に必要かを確認します。
  3. 実行処理を先に調べます。 導入スクリプト、フック、ビルド処理を読み、取得するファイル、変更内容、送信先を確認します。
  4. 専用の作業領域と実行ユーザーを決めます。 Agentがアクセスできるファイルを調べ、対象外のプロジェクトや認証情報から分離します。
  5. 権限と通信を制限します。 利用するAgentの公式資料を参照し、書き込みやコマンド実行を確認して許可できる状態にします。通信先も必要な範囲に絞れるか確認します。
  6. 最小限の認証情報で実行します。 作業に不要な鍵や長期トークンを外し、終了後はログや作業領域に残留がないか点検します。漏えいの疑いがあれば、該当情報を失効または更新します。

FAQ:見知らぬプロジェクトを渡す前の判断

Claude Codeで初めて扱うリポジトリは、どのファイルを確認しますか?
配布元に加え、Agent向け指示ファイル、依存関係の導入処理、フック、起動スクリプトを確認します。名称だけで無害とは判断せず、実行時に何を読み書きし、どこへ通信するかを調べます。

ダウンロードフォルダー内のプロジェクト指示ファイルはAgentに影響しますか?
CodexではAGENTS.mdのような指示ファイルが作業内容を伝えるために使われます。ファイルの内容を確認し、信頼できない指示を採用しないことが重要です。指示の文章は、実行権限を制限する仕組みではありません。

リモートMacなら作業領域や認証情報は自動で隔離されますか?
いいえ。リモート環境であることと、ファイルや通信が隔離されていることは別です。実行ユーザーの権限、アクセス可能な領域、認証情報の配置、ネットワーク制御を確認し、環境提供側の機能と利用者側の設定を分けて評価します。

見知らぬリポジトリの起動スクリプトをCodexに任せられますか?
内容を読まずに実行を許可するのは避けます。スクリプトが変更する設定、取得する依存関係、通信先、必要権限を確認してください。判断できない処理があるなら、認証情報のない専用環境で調べ、確認できるまで通常の作業環境では実行しません。

リモートMacは実環境の制御を確かめてから選ぶ

手元の共有Macは他の作業の設定や認証情報が残りやすく、Linuxのクラウド環境ではmacOS専用のツールチェーンを使えません。一方、Macを購入すると初期費用と保守が必要です。どの方法でも、実行ユーザー、引き渡し方式、作業領域の初期化、ネットワーク制御を確認しなければ、陌生リポジトリの安全性は判断できません。

一時的なmacOS環境が必要なら、ProxyMacのレンタルを候補に含めつつ、利用前に実際のアカウント権限と提供方式、必要な隔離設定を確認してください。サービス名や「リモート」という表現だけで安全性を推定せず、利用案内で環境の確認方法を調べ、認証情報やアカウント設定を見直す場合はパスワード変更の案内も参照できます。

見知らぬコードの確認に、専用のリモートMacを

ProxyMacなら、Apple Silicon M4搭載の専用Mac miniを使って、普段の作業環境と分けた場所でコードを確認できます。
SSHとVNCに対応しているため、ターミナルでもデスクトップでも、使いやすい方法で接続できます。