クラウド環境を設定する

​

Default 環境

• Trusted ネットワークアクセス：セッションはパッケージレジストリおよび他の 許可リストドメイン に到達でき、セッションのネットワークを通じて他には何も到達できません。
• その他の設定なし：Default は環境変数またはセットアップスクリプトを定義しないため、セッションは プリインストールされたツール だけで開始されます。

• Web、Desktop アプリ、モバイルアプリでは、セッションは セレクタ に表示される環境を使用します。管理者が設定した 組織のデフォルト は、選択していない場合にセレクションを埋めます。
• CLI からは、セッションは /remote-env の選択 を使用するか、最初に利用可能なクラウド環境にフォールバックします。

​

環境を設定する

1

環境セレクターを開く

claude.ai/code で、メッセージボックスの上の行にある現在の環境名を表示するクラウドアイコンを選択します。セレクターの設定ページや直接 URL はありません。

2

環境を追加または編集する

クラウド環境を追加 を選択するか、既存の環境にホバーして右側に表示される設定アイコンを選択します。ダイアログには名前、ネットワークアクセスレベル、環境変数、セットアップスクリプトが含まれます。

​

環境変数を設定する

NODE_ENV=development
LOG_LEVEL=debug
DATABASE_URL=postgres://localhost:5432/myapp

​

CLI から環境を選択する

​

環境をアーカイブする

• 環境で既に実行中のセッションは引き続き機能します。
• 環境はセレクターと /remote-env から消えるため、新しいセッション用に選択できません。
• アーカイブされた環境では、どのサーフェスでも新しいセッションを開始できません。環境が保存された CLI デフォルト だった場合、CLI クラウドセッションは最初に利用可能なクラウド環境にフォールバックします。ルーチン など、環境で明示的に設定されたものは、その中で新しいセッションを開始できません。別の環境を指定してください。

​

組織共有環境

• claude.ai/admin-settings/claude-code で共有環境を組織の デフォルト環境 として設定します。
• Claude Tag 管理設定で チャネルにピン留めします。

​

ネットワークアクセス

​

アクセスレベル

​

特定のドメインを許可する

api.example.com
*.internal.example.com
registry.example.com

​

GitHub プロキシ

• Git 認証情報：VM 内の git クライアントはスコープされた認証情報を使用し、プロキシはそれを検証して実際の GitHub トークンと交換します。
• API リクエスト：組み込み GitHub ツールからのリクエスト、および proxy-injected プレースホルダー の下の gh からのリクエストは、実際の認証情報が置き換えられた状態で送信されます。
• プッシュ保護：git push はセッションの現在の作業ブランチに対してのみ機能します。クローン、フェッチ、PR 操作は通常どおり機能します。
• リポジトリスコープ：GitHub API およびリリースアセットリクエストはセッションに接続されたリポジトリのみに到達するため、セットアップスクリプトが接続されていないリポジトリからリリースアセットをダウンロードすると 403 が返されます。

​

セキュリティプロキシ

• 悪意のあるリクエストに対する保護
• レート制限と不正使用防止
• 強化されたセキュリティのためのコンテンツフィルタリング
• リクエストされたホスト名の DNS レベルの監査証跡

​

クラウドセッションで利用可能なもの

​

セットアップから引き継がれるもの

​

インストール済みツール

​

GitHub の問題とプルリクエストを操作する

• トークンを設定する場合、それはコンテナに変更されずに渡されるため、スクリプトと GitHub の gh CLI がインストールされている場合は直接使用します。
• どちらも設定せず、GitHub プロキシ がセッションの認証を処理している場合、両方の変数は Claude が実行するコマンドでプレースホルダー文字列 proxy-injected として読み取られ、プロキシは送信 GitHub リクエストで実際の認証情報を置き換えます。gh はトークンなしで機能しますが、GITHUB_TOKEN を直接読み取るスクリプトはプレースホルダーを取得し、使用可能なトークンは取得しません。

​

セッションに出力をリンクバックする

echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

​

テストを実行し、サービスを開始し、パッケージを追加する

​

テストを実行する

​

サービスを開始する

service postgresql start

service redis-server start

​

パッケージを追加する

​

リソース制限

• 4 vCPU
• 16 GB の RAM
• 30 GB のディスク

​

セットアップスクリプト

#!/bin/bash
apt update && apt install -y gh

​

スクリプト要件

• ゼロで終了：スクリプトがゼロ以外で終了する場合、セッションは開始に失敗します。非重要なコマンドに || true を追加して、一時的なインストール失敗がセッションをブロックしないようにします。
• 5 分以内に完了：スクリプトの総実行時間を約 5 分以内に保つため、環境キャッシュ をビルドできます。独立したインストールを & と wait で並列実行し、フィットしない単一ダウンロードを SessionStart フック に移動して、バックグラウンドで起動します。
• インストール用のネットワークアクセス：パッケージインストールはレジストリに到達する必要があります。デフォルトの Trusted レベルは npm、PyPI、RubyGems、crates.io を含む 一般的なパッケージレジストリ をカバーします。None ネットワークアクセスでは、インストールは失敗します。

​

環境キャッシング

​

セットアップスクリプト対 SessionStart フック

1. セットアップスクリプトは最初に実行され、Claude Code が起動する前に、キャッシュされた環境 が存在しない場合のみです。
2. Claude Code が起動し、SessionStart フックを実行します。ローカルまたはクラウドのすべてのセッションの開始時と同様です。

​

SessionStart フックで依存関係をインストールする

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash

if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
  exit 0
fi

npm install
pip install -r requirements.txt
exit 0

​

クラウドセッションの制限

• クラウドのみのスコープなし：フックはローカルとクラウドセッションの両方で実行されます。ローカル実行をスキップするには、上記のように CLAUDE_CODE_REMOTE 環境変数をチェックします。
• ネットワークアクセスが必要：インストールコマンドはパッケージレジストリに到達する必要があります。環境が None ネットワークアクセスを使用する場合、これらのフックは失敗します。Trusted の下の デフォルト許可リスト は npm、PyPI、RubyGems、crates.io をカバーします。
• プロキシ互換性：すべての送信トラフィックは セキュリティプロキシ を通じて渡されます。一部のパッケージマネージャーはこのプロキシで正しく機能しません。Bun は既知の例です。
• スタートアップレイテンシを追加：フックはセッションが開始または再開されるたびに実行されます。環境キャッシング の恩恵を受けるセットアップスクリプトとは異なります。依存関係が既に存在するかどうかをチェックして再インストールを避けることで、インストールスクリプトを高速に保ちます。

​

デフォルト許可ドメイン

​

関連リソース

• Web 上の Claude Code：クラウドセッションを開始、管理、共有します
• Web クイックスタート：GitHub を接続して最初のクラウドセッションを開始します
• Claude Tag：Claude が Slack から開始するセッションは同じ環境で実行されます
• ルーチン：スケジュール実行は同じ環境とネットワークアクセスレベルを使用します
• Remote Control：代わりに独自のマシンのネットワークとファイルでセッションを実行します
• SessionStart フック：ローカルとクラウドセッションで実行されるリポジトリコミットセットアップ
• サーバー管理設定：クラウドセッションに到達する組織ポリシー