マルチエージェントClaude Code クラウド環境の設定｜通信・変数・準備
この記事の要点
- クラウドの会話は「クラウド環境」の中で動く。設定は通信・環境変数・準備スクリプトの3つ
- 通信は None・Limited・Full の3段階。最初は Limited で、パッケージの置き場など決まった先だけに出られる
- API の鍵はネットワークシークレットにすると、Claude に値を見せずに外部 API を呼ばせられる
活用例：パソコンを閉じている間に、クラウドで AI に定型の作業を進めてもらう
- 部署
- 開発・業務改善
- 使うもの
- Claude Code のクラウドの会話とクラウド環境
- AIに任せる
- 決められた環境の中での作業（テスト・集計・下書き）
- 人が決める
- 外に出てよい通信先・渡す鍵・準備で入れる道具・結果の確認
Claude Code は、ブラウザ・スマホ・デスクトップアプリ・claude --cloud から、クラウドで動く会話 を始められます。そのクラウドの会話が動く「部屋」が クラウド環境（cloud environment） です。どこまで外と通信してよいか、どんな値を渡すか、最初に何を入れておくかを、この部屋ごとに決めます。
この記事では、公式ドキュメント「Configure cloud environments」（2026年11月14日確認）にもとづいて、設定の3つの柱と、仕事で使う前に決めておくことを整理します。クラウドの会話の始め方は Claude Codeをクラウドで動かす で解説しています。
結論：決めるのは「通信」「値」「準備」の3つ
何も設定しなければ「Default」という環境で動きます。 Default は通信が Limited（決まった先だけ）で、環境変数も準備スクリプトもありません。足りなくなったときに、次の3つを足していきます。
| 柱 | 決めること | こんな時に足す |
|---|---|---|
| 通信（Network access） | どこまで外に出てよいか | 決まった先以外の API やサイトに出たい |
| 値（環境変数・ネットワークシークレット） | 会話に渡す設定や鍵 | テストに設定値が要る／外部 API を呼ばせたい |
| 準備（Setup script） | 作業の前に入れておく道具 | 最初から入っていない道具が要る |
同じ環境は、ブラウザ・スマホ・デスクトップアプリ・claude --cloud・クラウドの定期実行（ルーティン）のどこから始めても使われます。
環境を作る・選ぶ
環境の追加と編集は、claude.ai/code の新しい会話の画面で行います。 メッセージ欄の下の最初のボタンから選び、「New environment」で新しく作れます。動いている自分の会話の環境は、会話の題名の横から「Edit cloud environment」で直せます。
ターミナルから使うときは、/remote-env で claude --cloud に使う環境の既定を選べます。ただし /remote-env は選ぶだけで、作ったり直したりはできません。
Team と Enterprise のプランでは、オーナーが組織全員で使う共有の環境 を作れます。一人ひとりが同じ設定を作り直さずに済むので、チームで使うなら共有の環境から始めると揃えやすくなります。
通信の3段階
最初は Limited で、必要な分だけ広げるのが基本です。
| 段階 | 外への通信 |
|---|---|
| None | 会話のネットワークからは外に出られない |
| Limited（最初の設定） | パッケージの置き場・GitHub・クラウドの SDK などの決まった先と、自分で足した先だけ |
| Full | どこへでも出られる |
足したい先があるときは、Limited のまま「許可する先」に足します。設定を変えると、動いている会話にも 1分ほどで反映 されます。なお GitHub は専用の中継を通るので、段階にかかわらず使えます。会話でつないだ MCP のコネクタも、Anthropic のサーバーを通るため、許可する先に足さなくても使えます。
環境変数とネットワークシークレット
設定値は環境変数に、API の鍵はネットワークシークレットに分けます。
環境変数は「KEY=value」を1行に1つ書く形です。Claude が動かすコマンドから読めます。注意したいのは、その環境を使う人は誰でも値を読める ことです。だから鍵は入れません。
鍵を使わせたいときは ネットワークシークレット を使います。鍵を環境に預け、どのホストへの通信に付けるか を決めておくと、外に出ていく通信に Anthropic の中継が鍵を付けてくれます。Claude にも、会話の中のファイルや環境変数にも、鍵の値は出てきません。 保存した後は値を見直すこともできません。
| 環境変数 | ネットワークシークレット | |
|---|---|---|
| 向いているもの | 動作の設定（ログの細かさなど） | 外部 API の鍵・トークン |
| Claude から見えるか | 見える | 見えない |
| 付く先 | すべてのコマンド | 決めたホストへの通信だけ |
ネットワークシークレットは、自分で動かす環境（セルフホスト）では使えません。また、Anthropic の API や公開のパッケージの置き場への通信、準備スクリプトの通信には付きません。鍵の扱い方の考え方は Claude Codeのセキュリティの考え方 でまとめています。
準備スクリプトとキャッシュ
準備スクリプトは、会話が始まる前に動く Bash のスクリプトです。 最初から入っていない道具を入れるときに使います。Ubuntu 24.04 の上で管理者の権限で動くので、apt install などが使えます。
書くときの決まりは4つです。
- 最後は成功（0）で終わらせる。失敗すると会話が始まらないことがある。止まってもよい行には
|| trueを付ける - 5分以内に終わらせる。5分を超えると、次回から使い回す準備（キャッシュ）が作られない
- 入れる道具の置き場に出られる通信にしておく。Limited の既定で主な置き場は届く
- 環境変数はまだ入っていない。スクリプトで要る値はスクリプトの中に書く
5分以内に終わると、作業場所の中身をそのまま保存して、次の会話から使い回します（キャッシュ）。入れた道具やファイルは残りますが、動かしていたサービスは残りません。スクリプトや許可する先を変えたときと、約7日たったときに作り直されます。
手元とクラウドの両方で動かしたい準備（依存の取り込みなど）は、準備スクリプトではなく、会話の始まりに動くフックに書きます。違いは Claude Codeのフック で解説しています。
性能と時間の上限
Anthropic のクラウドで動く会話には、おおよその上限があります。 公式ドキュメントの目安は、CPU 4つ・メモリ 16GB・ディスク 30GB です。大きなビルドのようにメモリを多く使う作業は止まることがあります。
コマンドは既定で2分待ち、最大10分まで待てます。足りないときは、環境変数 BASH_DEFAULT_TIMEOUT_MS と BASH_MAX_TIMEOUT_MS（ミリ秒）で延ばせます。数分間何もしないと、作業場所はファイルを残したまま一時停止します。上限を超える作業は、手元のパソコンで動かしてスマホから見る Remote Control を使う方法もあります。
仕事で使う前に決めておくこと
- 通信の段階：Limited から始め、足す先は1つずつ理由を書いて足す
- 鍵の渡し方：環境変数に鍵を入れない。外部 API はネットワークシークレットで
- 環境の持ち主：チームで使うなら共有の環境にして、変えてよい人を決める
- 使わなくなった環境：アーカイブする（Anthropic のクラウドの環境は削除ではなくアーカイブ）
決まった時刻にクラウドで作業を回したいときは、Claude Codeのルーティン と組み合わせます。
まとめ
- クラウドの会話は クラウド環境 の中で動き、決めるのは 通信・値・準備 の3つ
- 通信は None・Limited・Full。Limited から必要な分だけ広げる
- 鍵は ネットワークシークレット で渡すと、Claude に値を見せずに API を呼ばせられる
- 準備スクリプトは 5分以内・成功で終わる ように書くと、次回から使い回される
出典
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。
