4 4
5# ウェブ上の Claude Code を使用する5# ウェブ上の Claude Code を使用する
6 6
7> Anthropic のサンドボックスでクラウド環境、セットアップスクリプト、ネットワークアクセス、Docker を設定します。`--cloud` と `--teleport` を使用してウェブとターミナル間でセッションを移動します。7> Move sessions between web and terminal with `--cloud` and `--teleport`, manage and share sessions, and auto-fix pull requests from the cloud.
8 8
9<Note>9<Note>
10 ウェブ上の Claude Code は Pro、Max、Team ユーザー、およびプレミアムシートまたは Chat + Claude Code シートを持つ Enterprise ユーザーを対象としたリサーチプレビュー段階です。10 Claude Code on the web is in research preview for Pro, Max, and Team users, and for Enterprise users with premium seats or Chat + Claude Code seats.
11</Note>11</Note>
12 12
13ウェブ上の Claude Code は [claude.ai/code](https://claude.ai/code) の Anthropic 管理クラウドインフラストラクチャでタスクを実行します。セッションはブラウザを閉じても保持され、Claude モバイルアプリから監視できます。13ウェブ上の Claude Code は [claude.ai/code](https://claude.ai/code) の Anthropic 管理クラウドインフラストラクチャでタスクを実行するか、ルーティングされた場合は組織の[セルフホスト環境](/docs/ja/self-hosted-environments)で実行されます。セッションはブラウザを閉じても保持され、Claude モバイルアプリから監視できます。
14 14
15<Tip>15<Tip>
16 ウェブ上の Claude Code は初めてですか?[はじめに](/docs/ja/web-quickstart)から始めて、GitHub アカウントを接続し、最初のタスクを送信してください。16 ウェブ上の Claude Code は初めてですか?[はじめに](/docs/ja/web-quickstart)から始めて、GitHub アカウントを接続し、最初のタスクを送信してください。
18 18
19このページでは以下をカバーしています:19このページでは以下をカバーしています:
20 20
21* [クラウド環境](#cloud-environments):セッションが実行される場所、およびそれを設定する場所
21* [GitHub 認証オプション](#github-authentication-options):GitHub を接続する 2 つの方法22* [GitHub 認証オプション](#github-authentication-options):GitHub を接続する 2 つの方法
22* [クラウド環境](#the-cloud-environment):どの設定が引き継がれるか、どのツールがインストールされているか、環境を設定する方法
23* [セットアップスクリプト](#setup-scripts)と依存関係管理
24* [ネットワークアクセス](#network-access):レベル、プロキシ、デフォルト許可リスト
25* [`--cloud` と `--teleport` を使用してウェブとターミナル間でタスクを移動](#move-tasks-between-web-and-terminal)23* [`--cloud` と `--teleport` を使用してウェブとターミナル間でタスクを移動](#move-tasks-between-web-and-terminal)
26* [セッションの操作](#work-with-sessions):確認、共有、アーカイブ、削除24* [セッションの操作](#work-with-sessions):権限モード、確認、共有、アーカイブ、削除
27* [プルリクエストの自動修正](#auto-fix-pull-requests):CI 失敗とレビューコメントに自動的に応答25* [プルリクエストの自動修正](#auto-fix-pull-requests):CI 失敗とレビューコメントに自動的に応答
28* [セキュリティと分離](#security-and-isolation):セッションの分離方法26* [セキュリティと分離](#security-and-isolation):セッションの分離方法
29* [制限事項](#limitations):レート制限とプラットフォーム制限27* [制限事項](#limitations):レート制限とプラットフォーム制限
30 28
29<h2 id="cloud-environments">
30 クラウド環境
31</h2>
32
33すべてのクラウドセッションは[クラウド環境](/docs/ja/cloud-environments)で実行されます。これはネットワークアクセス、環境変数、セットアップスクリプトを制御する保存された設定です。環境がまだない場合、オンボーディングは[**Trusted** ネットワークアクセス](/docs/ja/cloud-environments#access-levels)を持つ**Default** 環境をセットアップします。これは、あなたのために作成するか、作成するよう依頼するかのいずれかです。[Default 環境](/docs/ja/cloud-environments#the-default-environment)を参照して、どちらがあなたのプランで発生するか、および複数の環境がある場合にセッションが環境を選択する方法を確認してください。
34
35同じ環境はクラウドセッションを開始する場所に関係なく適用されます:ウェブ、ターミナル、[Claude Tag](https://claude.com/docs/claude-tag/overview)、[ルーチン](/docs/ja/routines)、およびモバイルおよび Desktop アプリ。Claude Tag チャネルセッションは組織レベルの環境のみを使用します。[共有環境](/docs/ja/cloud-environments#organization-shared-environments)または[セルフホスト環境](/docs/ja/self-hosted-environments)のいずれかです。
36
37[クラウド環境を設定](/docs/ja/cloud-environments)して、環境が許可するものを変更し、変数を設定するか、セットアップスクリプトを追加してください。[インストール済みツール](/docs/ja/cloud-environments#installed-tools)を参照して、設定なしでセッションに含まれるものを確認してください。
38
31<h2 id="github-authentication-options">39<h2 id="github-authentication-options">
32 GitHub 認証オプション40 GitHub 認証オプション
33</h2>41</h2>
43 どちらの方法でも、クラウドセッションは Claude GitHub App がインストールされているリポジトリだけでなく、接続している GitHub アカウントが見ることができるすべてのリポジトリにアクセスできます。App インストールは [Auto-fix](#auto-fix-pull-requests) の PR webhook を有効にします;これはセッションレベルのアクセス制御ではありません。クラウドセッションからチームが到達できるリポジトリを制限するには、GitHub 自体でアクセスを制限してください。たとえば、接続している GitHub アカウントのチームまたはリポジトリメンバーシップを制限することで実現できます。51 どちらの方法でも、クラウドセッションは Claude GitHub App がインストールされているリポジトリだけでなく、接続している GitHub アカウントが見ることができるすべてのリポジトリにアクセスできます。App インストールは [Auto-fix](#auto-fix-pull-requests) の PR webhook を有効にします;これはセッションレベルのアクセス制御ではありません。クラウドセッションからチームが到達できるリポジトリを制限するには、GitHub 自体でアクセスを制限してください。たとえば、接続している GitHub アカウントのチームまたはリポジトリメンバーシップを制限することで実現できます。
44</Note>52</Note>
45 53
46どちらの方法でも機能します。[`/schedule`](/docs/ja/routines) は両方の形式のアクセスをチェックし、どちらも設定されていない場合は `/web-setup` を実行するよう促します。[ターミナルから接続](/docs/ja/web-quickstart#connect-from-your-terminal)で `/web-setup` のウォークスルーを参照してください。54どちらの方法でも機能します。`/schedule` がアクセスをチェックしてからルーチンを作成する方法については、[リポジトリとブランチの権限](/docs/ja/routines#repositories-and-branch-permissions)を参照してください。[ターミナルから接続](/docs/ja/web-quickstart#connect-from-your-terminal)で `/web-setup` のウォークスルーを参照してください。
47 55
48GitHub App は [Auto-fix](#auto-fix-pull-requests) に必須です。これは App を使用して PR webhook を受け取ります。`/web-setup` で接続し、後で Auto-fix が必要な場合は、それらのリポジトリに App をインストールします。56Quick web setup は、メンバーが `/web-setup` で GitHub を接続できるようにする組織設定で、ブラウザオンボーディング中に Claude GitHub App インストールプロンプトをスキップし、環境フォームを表示する代わりに、ブラウザオンボーディングが [**Default** 環境](/docs/ja/cloud-environments#the-default-environment)を作成するようにします。Team および Enterprise プランではデフォルトでオフになっており、`/web-setup` を非表示にします。[Owner](/docs/ja/server-managed-settings#access-control) は [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code) の **Quick web setup** トグルでオンにします。
49
50Team および Enterprise 管理者は [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) の Quick web setup トグルで `/web-setup` を無効にできます。
51 57
52<Note>58<Note>
53 [Zero Data Retention](/docs/ja/zero-data-retention) が有効な組織は `/web-setup` またはその他のクラウドセッション機能を使用できません。59 [Zero Data Retention](/docs/ja/zero-data-retention) が有効な組織は `/web-setup` またはその他のクラウドセッション機能を使用できません。
54</Note>60</Note>
55 61
56<h2 id="the-cloud-environment">
57 クラウド環境
58</h2>
59
60各セッションはリポジトリがクローンされた新しい Anthropic 管理 VM で実行されます。このセクションではセッション開始時に利用可能なものと、それをカスタマイズする方法をカバーしています。
61
62<h3 id="what’s-available-in-cloud-sessions">
63 クラウドセッションで利用可能なもの
64</h3>
65
66クラウドセッションはリポジトリの新しいクローンから開始されます。リポジトリにコミットされたものはすべて利用可能です。自分のマシンにのみインストールまたは設定したものは利用できません。組織のポリシーは [サーバー管理設定](/docs/ja/server-managed-settings)を通じて別途到着します。
67
68| | クラウドセッションで利用可能 | 理由 |
69| :----------------------------------------------------------------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
70| リポジトリの `CLAUDE.md` | はい | クローンの一部 |
71| リポジトリの `.claude/settings.json` フック | はい | クローンの一部 |
72| リポジトリの `.mcp.json` MCP サーバー | はい | クローンの一部 |
73| リポジトリの `.claude/rules/` | はい | クローンの一部 |
74| リポジトリの `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | はい | クローンの一部 |
75| `.claude/settings.json` で宣言されたプラグイン | はい | 宣言した[マーケットプレイス](/docs/ja/plugin-marketplaces)からセッション開始時にインストールされます。マーケットプレイスソースに到達するためにはネットワークアクセスが必要です |
76| 組織の[サーバー管理設定](/docs/ja/server-managed-settings) | はい | セッション開始時に Anthropic のサーバーから取得されます。クラウドセッションで `availableModels` がどのように適用されるかについては [Surface coverage](/docs/ja/model-config#surface-coverage) を参照してください。MDM または管理設定ファイルを通じてデバイスにデプロイされた設定は、セッションが Anthropic 管理 VM で実行されるため適用されません |
77| ユーザー `~/.claude/CLAUDE.md` | いいえ | マシンに存在し、リポジトリには存在しません |
78| ユーザー `~/.claude/skills/`、`~/.claude/agents/`、`~/.claude/commands/` | いいえ | マシンに存在し、リポジトリには存在しません。代わりにリポジトリの `.claude/` ディレクトリにコミットしてください。claude.ai で有効にしたスキルはクラウドセッションに自動的にロードされます |
79| ユーザー設定でのみ有効なプラグイン | いいえ | ユーザースコープの `enabledPlugins` は `~/.claude/settings.json` に存在します。代わりにリポジトリの `.claude/settings.json` で宣言してください |
80| `claude mcp add` で追加した MCP サーバー | いいえ | これらはローカルユーザー設定に書き込まれ、リポジトリには書き込まれません。代わりに [`.mcp.json`](/docs/ja/mcp#project-scope) でサーバーを宣言してください |
81| 静的 API トークンと認証情報 | いいえ | 専用シークレットストアはまだ存在しません。以下を参照してください |
82| AWS SSO のようなインタラクティブ認証 | いいえ | サポートされていません。SSO はクラウドセッションで実行できないブラウザベースのログインが必要です |
83
84クラウドセッションで設定を利用可能にするには、リポジトリにコミットしてください。組織のポリシーは [サーバー管理設定](/docs/ja/server-managed-settings)を通じて別途到着します。専用シークレットストアはまだ利用できません。環境変数とセットアップスクリプトの両方は環境設定に保存され、その環境を編集できる誰もが見ることができます。クラウドセッションでシークレットが必要な場合は、その可視性を念頭に置いて環境変数として追加してください。
85
86<h3 id="installed-tools">
87 インストール済みツール
88</h3>
89
90クラウドセッションには一般的な言語ランタイム、ビルドツール、データベースがプリインストールされています。以下の表はカテゴリ別に含まれるものをまとめています。
91
92| カテゴリ | 含まれるもの |
93| :---------- | :--------------------------------------------------------------- |
94| **Python** | pip、poetry、uv、black、mypy、pytest、ruff を備えた Python 3.x |
95| **Node.js** | nvm 経由の 20、21、22、npm、yarn、pnpm、bun¹、eslint、prettier、chromedriver |
96| **Ruby** | gem、bundler、rbenv を備えた 3.1、3.2、3.3 |
97| **PHP** | Composer を備えた 8.4 |
98| **Java** | Maven と Gradle を備えた OpenJDK 21 |
99| **Go** | モジュールサポート付きの最新安定版 |
100| **Rust** | rustc と cargo |
101| **C/C++** | GCC、Clang、cmake、ninja、conan |
102| **Docker** | docker、dockerd、docker compose |
103| **データベース** | PostgreSQL 16、Redis 7.0 |
104| **ユーティリティ** | git、jq、yq、ripgrep、tmux、vim、nano |
105
106¹ Bun はインストールされていますが、パッケージ取得に関して既知の[プロキシ互換性の問題](#install-dependencies-with-a-sessionstart-hook)があります。
107
108正確なバージョンについては、Claude にクラウドセッションで `check-tools` を実行するよう依頼してください。このコマンドはクラウドセッションにのみ存在します。
109
110<h3 id="work-with-github-issues-and-pull-requests">
111 GitHub の問題とプルリクエストを操作する
112</h3>
113
114クラウドセッションには、Claude がセットアップなしで問題を読み取り、プルリクエストをリストし、diff を取得し、コメントを投稿できる組み込み GitHub ツールが含まれています。これらのツールは [GitHub プロキシ](#github-proxy)を通じて認証され、[GitHub 認証オプション](#github-authentication-options)で設定した方法を使用するため、トークンはコンテナに入りません。
115
116[環境設定](#configure-your-environment)で `GH_TOKEN` または `GITHUB_TOKEN` を自分で設定するか、両方を設定しないままにして [GitHub プロキシ](#github-proxy)に認証を任せることができます:
117
118* トークンを設定した場合、コンテナに変更されずに渡されるため、`gh` とスクリプトは直接それを使用します。
119* どちらも設定しない場合、コンテナは両方の変数をプレースホルダー文字列 `proxy-injected` に設定し、プロキシは送信 GitHub リクエストで実際の認証情報を置き換えます。`gh` は独自のトークンなしで機能しますが、`GITHUB_TOKEN` を直接読み取るスクリプトはプレースホルダーを取得し、使用可能なトークンは取得しません。
120
121セッションにどちらが適用されるかを確認するには、Claude に `echo $GH_TOKEN` を実行するよう依頼してください。
122
123`gh` CLI はプリインストールされていません。組み込みツールがカバーしていない `gh` コマンド(`gh release` や `gh workflow run` など)が必要な場合は、自分でインストールして認証してください:
124
125<Steps>
126 <Step title="セットアップスクリプトに gh をインストール">
127 [セットアップスクリプト](#setup-scripts)に `apt update && apt install -y gh` を追加します。
128 </Step>
129
130 <Step title="プロキシが認証を処理していない場合はトークンを提供">
131 `echo $GH_TOKEN` が `proxy-injected` を出力する場合、[GitHub プロキシ](#github-proxy)が `gh` を認証し、このステップは不要です。それ以外の場合は、GitHub 個人アクセストークンを持つ `GH_TOKEN` 環境変数を [環境設定](#configure-your-environment)に追加してください。`gh` は `GH_TOKEN` を自動的に読み取るため、`gh auth login` ステップは不要です。
132 </Step>
133</Steps>
134
135<h3 id="link-output-back-to-the-session">
136 セッションに出力をリンク
137</h3>
138
139各クラウドセッションは claude.ai 上にトランスクリプト URL を持ち、セッションは `CLAUDE_CODE_REMOTE_SESSION_ID` 環境変数から独自の ID を読み取ることができます。これを使用して、PR 本文、コミットメッセージ、Slack 投稿、または生成されたレポートに追跡可能なリンクを配置し、レビュアーがそれを生成した実行を開くことができます。
140
141v2.1.179 以降、Claude がウェブセッションで作成するコミットには `Claude-Session: <url>` git トレーラーが含まれ、PR 本文にはセッション URL が独立した行に含まれます。v2.1.182 以降、[`attribution.sessionUrl`](/docs/ja/settings#attribution-settings)を `false` に設定してトレーラーと PR 本文リンクを省略できます。
142
143コミットまたは PR 以外のもの(Claude が投稿する Slack メッセージやそれが書き込むレポートファイルなど)にセッションリンクを含めるには、Claude に次のコマンドを実行させ、その出力を使用してください。このコマンドは環境変数の値の `cse_` プレフィックスをトランスクリプト URL が期待する `session_` プレフィックスに変換します:
144
145```bash theme={null}
146echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
147```
148
149<h3 id="run-tests-start-services-and-add-packages">
150 テストを実行し、サービスを開始し、パッケージを追加
151</h3>
152
153Claude はタスクに取り組む際にテストを実行します。プロンプトで依頼してください。例えば「fix the failing tests in `tests/`」または「run pytest after each change」。pytest、jest、cargo test などのテストランナーはプリインストールされているため、すぐに機能します。
154
155PostgreSQL と Redis はプリインストールされていますがデフォルトでは実行されていません。セッション中に Claude に各を開始するよう依頼してください:
156
157```bash theme={null}
158service postgresql start
159```
160
161```bash theme={null}
162service redis-server start
163```
164
165Docker はコンテナ化されたサービスを実行するために利用可能です。Claude に `docker compose up` を実行してプロジェクトのサービスを開始するよう依頼してください。イメージをプルするためのネットワークアクセスは環境の[アクセスレベル](#access-levels)に従い、[信頼できるデフォルト](#default-allowed-domains)には Docker Hub およびその他の一般的なレジストリが含まれます。
166
167イメージが大きいか遅い場合は、[セットアップスクリプト](#setup-scripts)に `docker compose pull` または `docker compose build` を追加してください。プルされたイメージは[キャッシュされた環境](#environment-caching)に保存されるため、各新しいセッションはディスク上にそれらを持っています。キャッシュはファイルのみを保存し、実行中のプロセスは保存しないため、Claude は各セッションでコンテナを開始します。
168
169プリインストールされていないパッケージを追加するには、[セットアップスクリプト](#setup-scripts)を使用してください。スクリプトの出力は[キャッシュされ](#environment-caching)、そこにインストールしたパッケージはすべてのセッションの開始時に利用可能で、毎回再インストールする必要はありません。セッション中に Claude にパッケージをインストールするよう依頼することもできますが、それらのインストールは他のセッションに引き継がれません。
170
171<h3 id="resource-limits">
172 リソース制限
173</h3>
174
175クラウドセッションは時間とともに変わる可能性のある概算リソース上限で実行されます:
176
177* 4 vCPU
178* 16 GB RAM
179* 30 GB ディスク
180
181大規模なビルドジョブやメモリ集約的なテストなど、大幅により多くのメモリを必要とするタスクは失敗するか終了される可能性があります。これらの制限を超えるワークロードについては、[Remote Control](/docs/ja/remote-control)を使用して独自のハードウェアで Claude Code を実行してください。
182
183<h3 id="configure-your-environment">
184 環境を設定
185</h3>
186
187環境は[ネットワークアクセス](#network-access)、環境変数、セッション開始前に実行される[セットアップスクリプト](#setup-scripts)を制御します。設定なしで利用可能なものについては [Installed tools](#installed-tools) を参照してください。ウェブインターフェースまたはターミナルから環境を管理できます:
188
189| アクション | 方法 |
190| :----------------------- | :------------------------------------------------------------------------------------------------------------------------ |
191| 環境を追加 | 現在の環境を選択して環境セレクターを開き、**Add environment** を選択します。ダイアログには名前、ネットワークアクセスレベル、環境変数、セットアップスクリプトが含まれます。 |
192| 環境を編集 | クラウドアイコンを選択して現在の環境の名前を表示し、セレクターを開き、環境にマウスを合わせて、右側に表示される設定アイコンをクリックします。 |
193| 環境をアーカイブ | 環境を編集用に開き、**Archive** を選択します。アーカイブされた環境はセレクターから非表示になりますが、既存のセッションは実行を続けます。 |
194| CLI クラウドセッションのデフォルト環境を設定 | ターミナルで `/remote-env` を実行します。単一の環境がある場合、このコマンドは現在の設定を表示します。`/remote-env` はデフォルトのみを選択します。ウェブインターフェースから環境を追加、編集、アーカイブしてください。 |
195
196環境変数は `.env` 形式を使用し、1 行に 1 つの `KEY=value` ペアです。値を引用符で囲まないでください。引用符は値の一部として保存されるためです。この例は 3 つの変数を定義しています:
197
198```text theme={null}
199NODE_ENV=development
200LOG_LEVEL=debug
201DATABASE_URL=postgres://localhost:5432/myapp
202```
203
204<h3 id="organization-shared-environments">
205 組織共有環境
206</h3>
207
208Team および Enterprise プランのオーナーと管理者は、組織のすべてのメンバーと共有されるクラウド環境を作成できます。共有環境は各メンバーの環境セレクターに個人環境と一緒に表示されるため、チームは各メンバーが再作成する代わりに 1 つの設定で標準化できます。
209
210[管理設定](https://claude.ai/admin-settings)の **Cloud environments** ページから共有環境を管理します。そこから以下を実行できます:
211
212* 共有環境を作成、編集、アーカイブします。各環境は個人環境と同じフィールドを持ちます:名前、[ネットワークアクセスレベル](#access-levels)、`.env` 形式の[環境変数](#configure-your-environment)、[セットアップスクリプト](#setup-scripts)。
213* 組織のデフォルト環境を設定します。
214
215共有環境の値はその環境のすべてのメンバーのセッションに到達します。個人環境と同様に、共有環境には専用シークレットストアがないため、シークレットを含めないでください。
216
217<h2 id="setup-scripts">
218 セットアップスクリプト
219</h2>
220
221セットアップスクリプトは新しいクラウドセッションが開始されるときに実行される Bash スクリプトで、Claude Code が起動する前に実行されます。セットアップスクリプトを使用して依存関係をインストールし、ツールを設定するか、セッションが必要とするプリインストールされていないものを取得します。
222
223スクリプトは Ubuntu 24.04 でルートとして実行されるため、`apt install` とほとんどの言語パッケージマネージャーが機能します。
224
225セットアップスクリプトを追加するには、環境設定ダイアログを開き、**Setup script** フィールドにスクリプトを入力します。
226
227この例はプリインストールされていない `gh` CLI をインストールします:
228
229```bash theme={null}
230#!/bin/bash
231apt update && apt install -y gh
232```
233
234スクリプトがゼロ以外で終了する場合、セッションは開始に失敗します。不安定なインストール失敗でセッションをブロックするのを避けるために、重要でないコマンドに `|| true` を追加します。
235
236スクリプトの総実行時間を約 5 分以下に保つため、[環境キャッシュ](#environment-caching)を構築できます。`&` と `wait` を使用して独立したインストールを並列で実行します。単一のダウンロードが 5 分の制限に収まらない場合は、バックグラウンドで起動する [SessionStart フック](#setup-scripts-vs-sessionstart-hooks)に移動します。
237
238<Note>
239 パッケージをインストールするセットアップスクリプトはレジストリに到達するためにネットワークアクセスが必要です。デフォルトの **Trusted** ネットワークアクセスは npm、PyPI、RubyGems、crates.io を含む[一般的なパッケージレジストリ](#default-allowed-domains)への接続を許可します。環境が **None** ネットワークアクセスを使用する場合、スクリプトはパッケージのインストールに失敗します。
240</Note>
241
242<h3 id="environment-caching">
243 環境キャッシング
244</h3>
245
246セットアップスクリプトは環境でセッションを開始するときに初めて実行されます。完了後、Anthropic はファイルシステムをスナップショットし、そのスナップショットを後のセッションの開始点として再利用します。新しいセッションはディスク上に依存関係、ツール、Docker イメージを既に持っており、セットアップスクリプトステップはスキップされます。これにより、スクリプトが大規模なツールチェーンをインストールするか、コンテナイメージをプルする場合でも、スタートアップは高速に保たれます。
247
248キャッシュはファイルをキャプチャし、実行中のプロセスはキャプチャしません。セットアップスクリプトがディスクに書き込むものはすべて引き継がれます。開始するサービスまたはコンテナは引き継がれないため、Claude に依頼するか、[SessionStart フック](#setup-scripts-vs-sessionstart-hooks)を使用してセッションごとにそれらを開始してください。
249
250環境のセットアップスクリプトまたは許可されたネットワークホストを変更するとき、およびキャッシュが約 7 日後に有効期限に達するときに、セットアップスクリプトが再度実行されてキャッシュが再構築されます。既存のセッションを再開することはセットアップスクリプトを再実行しません。
251
252キャッシングを有効にするか、スナップショットを自分で管理する必要はありません。
253
254<h3 id="setup-scripts-vs-sessionstart-hooks">
255 セットアップスクリプト対 SessionStart フック
256</h3>
257
258クラウドが必要とするがラップトップがすでに持っているもの(言語ランタイムや CLI ツールなど)をインストールするにはセットアップスクリプトを使用します。クラウドとローカルの両方で実行する必要があるプロジェクトセットアップ(`npm install` など)には [SessionStart フック](/docs/ja/hooks#sessionstart)を使用します。
259
260どちらもセッションの開始時に実行されますが、異なる場所に属しています:
261
262| | セットアップスクリプト | SessionStart フック |
263| ---- | ---------------------------------------------------------------- | --------------------------------- |
264| 添付先 | クラウド環境 | リポジトリ |
265| 設定場所 | クラウド環境 UI | リポジトリの `.claude/settings.json` |
266| 実行 | Claude Code が起動する前、[キャッシュされた環境](#environment-caching)が利用できない場合のみ | Claude Code が起動した後、再開を含むすべてのセッション |
267| スコープ | クラウド環境のみ | ローカルとクラウド両方 |
268
269SessionStart フックはローカルのユーザーレベル `~/.claude/settings.json` でも定義できますが、ユーザーレベルの設定はクラウドセッションに引き継がれません。クラウドでは、リポジトリとお客様の組織の[サーバー管理設定](/docs/ja/server-managed-settings)からフックが取得されます。
270
271<h3 id="install-dependencies-with-a-sessionstart-hook">
272 SessionStart フックで依存関係をインストール
273</h3>
274
275クラウドセッションのみで依存関係をインストールするには、リポジトリの `.claude/settings.json` に SessionStart フックを追加します:
276
277```json theme={null}
278{
279 "hooks": {
280 "SessionStart": [
281 {
282 "matcher": "startup|resume",
283 "hooks": [
284 {
285 "type": "command",
286 "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
287 }
288 ]
289 }
290 ]
291 }
292}
293```
294
295`scripts/install_pkgs.sh` にスクリプトを作成し、`chmod +x` で実行可能にします。`CLAUDE_CODE_REMOTE` 環境変数はクラウドセッションで `true` に設定されるため、ローカル実行をスキップするために使用できます:
296
297```bash theme={null}
298#!/bin/bash
299
300if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
301 exit 0
302fi
303
304npm install
305pip install -r requirements.txt
306exit 0
307```
308
309SessionStart フックはクラウドセッションでいくつかの制限があります:
310
311* **クラウドのみのスコープなし**:フックはローカルとクラウドセッションの両方で実行されます。ローカル実行をスキップするには、上記のようにスクリプトで `CLAUDE_CODE_REMOTE` 環境変数をチェックします。
312* **ネットワークアクセスが必要**:インストールコマンドはパッケージレジストリに到達する必要があります。環境が **None** ネットワークアクセスを使用する場合、これらのフックは失敗します。**Trusted** の下の[デフォルト許可リスト](#default-allowed-domains)は npm、PyPI、RubyGems、crates.io をカバーしています。
313* **プロキシ互換性**:すべてのアウトバウンドトラフィックは[セキュリティプロキシ](#security-proxy)を通じて渡されます。一部のパッケージマネージャーはこのプロキシで正しく機能しません。Bun は既知の例です。
314* **スタートアップレイテンシーを追加**:フックはセッションが開始または再開されるたびに実行されます。依存関係が既に存在するかどうかを確認してから再インストールすることで、インストールスクリプトを高速に保ちます。
315
316後続の Bash コマンドの環境変数を永続化するには、`$CLAUDE_ENV_FILE` のファイルに書き込みます。詳細については [SessionStart フック](/docs/ja/hooks#sessionstart)を参照してください。
317
318カスタム Docker イメージで基本イメージを置き換えることはまだサポートされていません。[提供されたイメージ](#installed-tools)の上にセットアップスクリプトを使用して必要なものをインストールするか、`docker compose` を使用して Claude と一緒にイメージをコンテナとして実行してください。
319
320<h2 id="network-access">
321 ネットワークアクセス
322</h2>
323
324ネットワークアクセスはクラウド環境からのアウトバウンド接続を制御します。各環境は 1 つのアクセスレベルを指定し、カスタム許可ドメインで拡張できます。デフォルトは **Trusted** で、パッケージレジストリおよび他の[許可リストドメイン](#default-allowed-domains)を許可します。
325
326環境のネットワークアクセスを変更するには、[編集用に開き](#configure-your-environment)、ダイアログで **Network access** セレクターを使用します。個別の Environments ページはありません。クラウドアイコンはクラウドセッションを開始するか、[ルーチン](/docs/ja/routines#environments-and-network-access)を設定する場所に表示されます。
327
328<Note>
329 MCP コネクタトラフィックは Anthropic のサーバーを通じてルーティングされるため、セッションまたはルーチンで有効にするコネクタは **Allowed domains** に追加しなくても機能します。コネクタはセッションごとまたはルーチンごとに設定されます。Claude が到達できるツールを制限するために、不要なものを削除します。これは [Security and isolation](#security-and-isolation) の下で記載されている同じ Anthropic バウンドチャネルに依存しています。
330</Note>
331
332<h3 id="access-levels">
333 アクセスレベル
334</h3>
335
336環境を作成または編集するときにアクセスレベルを選択します:
337
338| レベル | アウトバウンド接続 |
339| :---------- | :----------------------------------------------------------------- |
340| **None** | アウトバウンドネットワークアクセスなし |
341| **Trusted** | [許可リストドメイン](#default-allowed-domains)のみ:パッケージレジストリ、GitHub、クラウド SDK |
342| **Full** | 任意のドメイン |
343| **Custom** | 独自の許可リスト、オプションでデフォルトを含む |
344
345GitHub 操作は[別のプロキシ](#github-proxy)を使用し、この設定から独立しています。
346
347<h3 id="allow-specific-domains">
348 特定のドメインを許可
349</h3>
350
351Trusted リストにないドメインを許可するには、環境のネットワークアクセス設定で **Custom** を選択します。**Allowed domains** フィールドが表示されます。1 行に 1 つのドメインを入力します:
352
353```text theme={null}
354api.example.com
355*.internal.example.com
356registry.example.com
357```
358
359ワイルドカードサブドメインマッチングに `*.` を使用します。**Also include default list of common package managers** をチェックして [Trusted ドメイン](#default-allowed-domains)をカスタムエントリと一緒に保つか、リストしたものだけを許可するためにチェックを外します。
360
361許可ドメインは環境ごとに設定されます。Owner がすべてのユーザーの環境にプッシュできる組織レベルの許可リストはありません。[server-managed settings](/docs/ja/server-managed-settings)はクラウドセッションを制限できますが、許可ドメインを追加することはできません。
362
363<h3 id="github-proxy">
364 GitHub プロキシ
365</h3>
366
367セキュリティのため、すべての GitHub 操作は専用プロキシサービスを通じて行われ、実際の GitHub 認証情報をサンドボックスの外に保ちます。プロキシは 2 種類のトラフィックを認証します:
368
369* Git インタラクション:サンドボックス内の git クライアントはカスタムビルトのスコープ付き認証情報を使用し、プロキシはそれを検証して実際の GitHub 認証トークンに変換します
370* GitHub API リクエスト:プロキシは組み込み GitHub ツールからのリクエストおよび [Work with GitHub issues and pull requests](#work-with-github-issues-and-pull-requests) で説明されている `proxy-injected` プレースホルダーをセッションが設定する場合の `gh` からのリクエストで実際の認証情報を置き換えます
371
372プロキシはセキュリティのため git push 操作を現在のワーキングブランチに制限し、セキュリティ境界を維持しながらクローン、フェッチ、PR 操作を有効にします。
373
374プロキシは GitHub API およびリリースアセットリクエストを環境の[アクセスレベル](#access-levels)に関係なくセッションに接続されたリポジトリに制限します。接続されていないリポジトリからリリースアセットをダウンロードするセットアップスクリプトは 403 を返します。公開リポジトリからコミットされたファイルは `raw.githubusercontent.com` を通じてフェッチされ、[security proxy](#security-proxy)が代わりに処理します。そのドメインはデフォルト[Trusted リスト](#default-allowed-domains)にあるため、環境の[アクセスレベル](#access-levels)がそれを除外しない限りファイルは到達可能なままです。
375
376<h3 id="security-proxy">
377 セキュリティプロキシ
378</h3>
379
380環境はセキュリティと不正使用防止のため HTTP/HTTPS ネットワークプロキシの背後で実行されます。すべてのアウトバウンドインターネットトラフィックはこのプロキシを通じて渡され、以下を提供します:
381
382* 悪意のあるリクエストに対する保護
383* レート制限と不正使用防止
384* 強化されたセキュリティのためのコンテンツフィルタリング
385* リクエストされたホスト名の DNS レベル監査証跡
386
387<h3 id="default-allowed-domains">
388 デフォルト許可ドメイン
389</h3>
390
391**Trusted** ネットワークアクセスを使用する場合、以下のドメインはデフォルトで許可されます。`*` でマークされたドメインはワイルドカードサブドメインマッチングを示すため、`*.gcr.io` は `gcr.io` のすべてのサブドメインを許可します。
392
393<AccordionGroup>
394 <Accordion title="Anthropic サービス">
395 * api.anthropic.com
396 * statsig.anthropic.com
397 * docs.claude.com
398 * platform.claude.com
399 * code.claude.com
400 * claude.ai
401 </Accordion>
402
403 <Accordion title="バージョン管理">
404 * github.com
405 * [www.github.com](http://www.github.com)
406 * api.github.com
407 * npm.pkg.github.com
408 * raw\.githubusercontent.com
409 * pkg-npm.githubusercontent.com
410 * objects.githubusercontent.com
411 * release-assets.githubusercontent.com
412 * codeload.github.com
413 * avatars.githubusercontent.com
414 * camo.githubusercontent.com
415 * gist.github.com
416 * gitlab.com
417 * [www.gitlab.com](http://www.gitlab.com)
418 * registry.gitlab.com
419 * bitbucket.org
420 * [www.bitbucket.org](http://www.bitbucket.org)
421 * api.bitbucket.org
422 </Accordion>
423
424 <Accordion title="コンテナレジストリ">
425 * registry-1.docker.io
426 * auth.docker.io
427 * index.docker.io
428 * hub.docker.com
429 * [www.docker.com](http://www.docker.com)
430 * production.cloudflare.docker.com
431 * download.docker.com
432 * gcr.io
433 * \*.gcr.io
434 * ghcr.io
435 * mcr.microsoft.com
436 * \*.data.mcr.microsoft.com
437 * public.ecr.aws
438 </Accordion>
439
440 <Accordion title="クラウドプラットフォーム">
441 * cloud.google.com
442 * accounts.google.com
443 * gcloud.google.com
444 * \*.googleapis.com
445 * storage.googleapis.com
446 * compute.googleapis.com
447 * container.googleapis.com
448 * azure.com
449 * portal.azure.com
450 * microsoft.com
451 * [www.microsoft.com](http://www.microsoft.com)
452 * \*.microsoftonline.com
453 * packages.microsoft.com
454 * dotnet.microsoft.com
455 * dot.net
456 * visualstudio.com
457 * dev.azure.com
458 * \*.amazonaws.com
459 * \*.api.aws
460 * oracle.com
461 * [www.oracle.com](http://www.oracle.com)
462 * java.com
463 * [www.java.com](http://www.java.com)
464 * java.net
465 * [www.java.net](http://www.java.net)
466 * download.oracle.com
467 * yum.oracle.com
468 </Accordion>
469
470 <Accordion title="JavaScript と Node パッケージマネージャー">
471 * registry.npmjs.org
472 * [www.npmjs.com](http://www.npmjs.com)
473 * [www.npmjs.org](http://www.npmjs.org)
474 * npmjs.com
475 * npmjs.org
476 * yarnpkg.com
477 * registry.yarnpkg.com
478 </Accordion>
479
480 <Accordion title="Python パッケージマネージャー">
481 * pypi.org
482 * [www.pypi.org](http://www.pypi.org)
483 * files.pythonhosted.org
484 * pythonhosted.org
485 * test.pypi.org
486 * pypi.python.org
487 * pypa.io
488 * [www.pypa.io](http://www.pypa.io)
489 </Accordion>
490
491 <Accordion title="Ruby パッケージマネージャー">
492 * rubygems.org
493 * [www.rubygems.org](http://www.rubygems.org)
494 * api.rubygems.org
495 * index.rubygems.org
496 * ruby-lang.org
497 * [www.ruby-lang.org](http://www.ruby-lang.org)
498 * rubyforge.org
499 * [www.rubyforge.org](http://www.rubyforge.org)
500 * rubyonrails.org
501 * [www.rubyonrails.org](http://www.rubyonrails.org)
502 * rvm.io
503 * get.rvm.io
504 </Accordion>
505
506 <Accordion title="Rust パッケージマネージャー">
507 * crates.io
508 * [www.crates.io](http://www.crates.io)
509 * index.crates.io
510 * static.crates.io
511 * rustup.rs
512 * static.rust-lang.org
513 * [www.rust-lang.org](http://www.rust-lang.org)
514 </Accordion>
515
516 <Accordion title="Go パッケージマネージャー">
517 * proxy.golang.org
518 * sum.golang.org
519 * index.golang.org
520 * golang.org
521 * [www.golang.org](http://www.golang.org)
522 * goproxy.io
523 * pkg.go.dev
524 </Accordion>
525
526 <Accordion title="JVM パッケージマネージャー">
527 * maven.org
528 * repo.maven.org
529 * central.maven.org
530 * repo1.maven.org
531 * repo.maven.apache.org
532 * jcenter.bintray.com
533 * gradle.org
534 * [www.gradle.org](http://www.gradle.org)
535 * services.gradle.org
536 * plugins.gradle.org
537 * kotlinlang.org
538 * [www.kotlinlang.org](http://www.kotlinlang.org)
539 * spring.io
540 * repo.spring.io
541 </Accordion>
542
543 <Accordion title="その他のパッケージマネージャー">
544 * packagist.org(PHP Composer)
545 * [www.packagist.org](http://www.packagist.org)
546 * repo.packagist.org
547 * nuget.org(.NET NuGet)
548 * [www.nuget.org](http://www.nuget.org)
549 * api.nuget.org
550 * pub.dev(Dart/Flutter)
551 * api.pub.dev
552 * hex.pm(Elixir/Erlang)
553 * [www.hex.pm](http://www.hex.pm)
554 * cpan.org(Perl CPAN)
555 * [www.cpan.org](http://www.cpan.org)
556 * metacpan.org
557 * [www.metacpan.org](http://www.metacpan.org)
558 * api.metacpan.org
559 * cocoapods.org(iOS/macOS)
560 * [www.cocoapods.org](http://www.cocoapods.org)
561 * cdn.cocoapods.org
562 * haskell.org
563 * [www.haskell.org](http://www.haskell.org)
564 * hackage.haskell.org
565 * swift.org
566 * [www.swift.org](http://www.swift.org)
567 </Accordion>
568
569 <Accordion title="Linux ディストリビューション">
570 * archive.ubuntu.com
571 * security.ubuntu.com
572 * ubuntu.com
573 * [www.ubuntu.com](http://www.ubuntu.com)
574 * \*.ubuntu.com
575 * ppa.launchpad.net
576 * launchpad.net
577 * [www.launchpad.net](http://www.launchpad.net)
578 * \*.nixos.org
579 </Accordion>
580
581 <Accordion title="開発ツールとプラットフォーム">
582 * dl.k8s.io(Kubernetes)
583 * pkgs.k8s.io
584 * k8s.io
585 * [www.k8s.io](http://www.k8s.io)
586 * releases.hashicorp.com(HashiCorp)
587 * apt.releases.hashicorp.com
588 * rpm.releases.hashicorp.com
589 * archive.releases.hashicorp.com
590 * hashicorp.com
591 * [www.hashicorp.com](http://www.hashicorp.com)
592 * repo.anaconda.com(Anaconda/Conda)
593 * conda.anaconda.org
594 * anaconda.org
595 * [www.anaconda.com](http://www.anaconda.com)
596 * anaconda.com
597 * continuum.io
598 * apache.org(Apache)
599 * [www.apache.org](http://www.apache.org)
600 * archive.apache.org
601 * downloads.apache.org
602 * eclipse.org(Eclipse)
603 * [www.eclipse.org](http://www.eclipse.org)
604 * download.eclipse.org
605 * nodejs.org(Node.js)
606 * [www.nodejs.org](http://www.nodejs.org)
607 * developer.apple.com
608 * developer.android.com
609 * pkg.stainless.com
610 * binaries.prisma.sh
611 </Accordion>
612
613 <Accordion title="クラウドサービスと監視">
614 * statsig.com
615 * [www.statsig.com](http://www.statsig.com)
616 * api.statsig.com
617 * sentry.io
618 * \*.sentry.io
619 * downloads.sentry-cdn.com
620 * http-intake.logs.datadoghq.com
621 * browser-intake-us5-datadoghq.com
622 * \*.datadoghq.com
623 * \*.datadoghq.eu
624 * api.honeycomb.io
625 </Accordion>
626
627 <Accordion title="コンテンツ配信とミラー">
628 * sourceforge.net
629 * \*.sourceforge.net
630 * packagecloud.io
631 * \*.packagecloud.io
632 * fonts.googleapis.com
633 * fonts.gstatic.com
634 </Accordion>
635
636 <Accordion title="スキーマと設定">
637 * json-schema.org
638 * [www.json-schema.org](http://www.json-schema.org)
639 * json.schemastore.org
640 * [www.schemastore.org](http://www.schemastore.org)
641 </Accordion>
642
643 <Accordion title="Model Context Protocol">
644 * \*.modelcontextprotocol.io
645 </Accordion>
646</AccordionGroup>
647
648<h2 id="move-tasks-between-web-and-terminal">62<h2 id="move-tasks-between-web-and-terminal">
649 ウェブとターミナル間でタスクを移動63 ウェブとターミナル間でタスクを移動
650</h2>64</h2>
652これらのワークフローには [Claude Code CLI](/docs/ja/quickstart) が同じ claude.ai アカウントにサインインしている必要があります。ターミナルから新しいクラウドセッションを開始するか、クラウドセッションをターミナルにプルしてローカルで続行できます。クラウドセッションはラップトップを閉じても保持され、Claude モバイルアプリを含む任意の場所から監視できます。66これらのワークフローには [Claude Code CLI](/docs/ja/quickstart) が同じ claude.ai アカウントにサインインしている必要があります。ターミナルから新しいクラウドセッションを開始するか、クラウドセッションをターミナルにプルしてローカルで続行できます。クラウドセッションはラップトップを閉じても保持され、Claude モバイルアプリを含む任意の場所から監視できます。
653 67
654<Note>68<Note>
655 CLI からのセッションハンドオフは一方向です:`--teleport` でクラウドセッションをターミナルにプルできますが、既存のターミナルセッションをウェブにプッシュすることはできません。`--cloud` フラグは現在のリポジトリの新しいクラウドセッションを作成します。[Desktop アプリ](/docs/ja/desktop#continue-in-another-surface)は別のサーフェスに送信できる Continue in メニューを提供します。69 CLI からのセッションハンドオフは一方向です:`--teleport` でクラウドセッションをターミナルにプルできますが、既存のターミナルセッションをウェブにプッシュすることはできません。`--cloud` フラグはタスク説明を使用して現在のリポジトリの新しいクラウドセッションを作成します;`-p` とセッション ID または claude.ai/code URL を使用すると、代わりに[その既存セッションにメッセージをキューイング](/docs/ja/claude-code-on-the-web#send-follow-ups-from-the-cli)します。[Desktop アプリ](/docs/ja/desktop#continue-in-another-surface)は別のサーフェスにローカルセッションを送信できる Continue in メニューを提供します。
656</Note>70</Note>
657 71
658<h3 id="from-terminal-to-web">72<h3 id="from-terminal-to-web">
665claude --cloud "Fix the authentication bug in src/auth/login.ts"79claude --cloud "Fix the authentication bug in src/auth/login.ts"
666```80```
667 81
668これにより claude.ai 上に新しいクラウドセッションが作成されます。セッションは現在のディレクトリの GitHub リモートを現在のブランチでクローンするため、VM は GitHub からクローンするため、ローカルコミットがある場合は最初にプッシュしてください。`--cloud` は一度に 1 つのリポジトリで機能します。タスクはクラウドで実行され、ローカルで作業を続行できます。古い `--remote` スペルは `--cloud` の非推奨エイリアスとしてまだ機能します。82これにより claude.ai 上に新しいクラウドセッションが作成されます。クラウド VM はローカルチェックアウトではなく、現在のブランチで現在のディレクトリの GitHub リモートをクローンするため、ローカルコミットがある場合は最初にプッシュしてください。`--cloud` は一度に 1 つのリポジトリで機能します。タスクはクラウドで実行され、ローカルで作業を続行できます。古い `--remote` スペルは `--cloud` の非推奨エイリアスとしてまだ機能します。
669 83
670v2.1.195 以降、CLI はリポジトリのクローンや [セットアップスクリプト](#setup-scripts)の実行などのセットアップステップのライブチェックリストを表示し、クラウドコンテナが起動します。コンテナがプロビジョニング中に入力したメッセージはキューに入れられ、セッションの準備ができたら送信されます。84クラウドコンテナが起動している間、CLI はリポジトリのクローンやセットアップスクリプトの実行などのセットアップステップのライブチェックリストを表示します。プロビジョニング中に入力したメッセージはキューに入れられ、セッションの準備ができたら送信されます。
671 85
672<Note>86<Note>
673 `--cloud` はクラウドセッションを作成します。`--remote-control` は無関係です:ウェブから監視するためにローカル CLI セッションを公開します。[Remote Control](/docs/ja/remote-control)を参照してください。87 `--cloud` はクラウドセッションを作成します。`--remote-control` は無関係です:ウェブから監視するためにローカル CLI セッションを公開します。[Remote Control](/docs/ja/remote-control)を参照してください。
675 89
676Claude Code CLI で `/tasks` を使用して進捗をチェックするか、claude.ai または Claude モバイルアプリでセッションを開いて直接対話します。そこから Claude を操舵し、フィードバックを提供するか、他のすべての会話と同じように質問に答えることができます。90Claude Code CLI で `/tasks` を使用して進捗をチェックするか、claude.ai または Claude モバイルアプリでセッションを開いて直接対話します。そこから Claude を操舵し、フィードバックを提供するか、他のすべての会話と同じように質問に答えることができます。
677 91
92Claude が質問をして、セッションがアイドル状態のままの場合、[環境の有効期限切れ](#environment-expired)まで戻ってきたときに答えることができ、セッションはあなたの答えから続行されます。
93
678<h4 id="tips-for-cloud-tasks">94<h4 id="tips-for-cloud-tasks">
679 クラウドタスクのヒント95 クラウドタスクのヒント
680</h4>96</h4>
691claude --cloud "Execute the migration plan in docs/migration-plan.md"107claude --cloud "Execute the migration plan in docs/migration-plan.md"
692```108```
693 109
694このパターンにより、戦略を制御しながら Claude がクラウドで自律的に実行できます。
695
696**クラウドで ultraplan を使用してプランを作成**:ウェブセッション自体でプランを起案およびレビューするには、[ultraplan](/docs/ja/ultraplan)を使用します。Claude はウェブ上の Claude Code でプランを生成し、作業を続行し、ブラウザでセクションにコメントし、リモートで実行するか、プランをターミナルに送り返すことを選択します。
697
698**タスクを並列で実行**:各 `--cloud` コマンドは独立して実行される独自のクラウドセッションを作成します。複数のタスクを開始でき、すべて別々のセッションで同時に実行されます:110**タスクを並列で実行**:各 `--cloud` コマンドは独立して実行される独自のクラウドセッションを作成します。複数のタスクを開始でき、すべて別々のセッションで同時に実行されます:
699 111
700```bash theme={null}112```bash theme={null}
711 123
712GitHub に接続されていないリポジトリから `claude --cloud` を実行する場合、Claude Code はローカルリポジトリをバンドルしてクラウドセッションに直接アップロードします。バンドルにはすべてのブランチ全体のリポジトリ履歴と、追跡されたファイルへのコミットされていない変更が含まれます。124GitHub に接続されていないリポジトリから `claude --cloud` を実行する場合、Claude Code はローカルリポジトリをバンドルしてクラウドセッションに直接アップロードします。バンドルにはすべてのブランチ全体のリポジトリ履歴と、追跡されたファイルへのコミットされていない変更が含まれます。
713 125
126macOS、Linux、WSL では、Claude Code は認証情報またはキーのような名前のファイルへのコミットされていない変更をアップロードから除外し、除外したファイルに名前を付けます。これは `.env` ファイル、Terraform `*.tfvars` ファイル、および `id_rsa` や `*.pem` などのキーファイルをカバーしています。セッションは各のコミットされたバージョンで開始するか、コミットされたものがない場合はファイルなしで開始されます。リンクされたワーキングツリー、サブモジュール、または同様のレイアウトでは、Claude Code はこれらの変更を残りと一緒にアップロードし、アップロードしたファイルに名前を付けます。
127
714GitHub アクセスが利用できない場合、このフォールバックは自動的にアクティブになります。GitHub が接続されている場合でも強制するには、`CCR_FORCE_BUNDLE=1` を設定します:128GitHub アクセスが利用できない場合、このフォールバックは自動的にアクティブになります。GitHub が接続されている場合でも強制するには、`CCR_FORCE_BUNDLE=1` を設定します:
715 129
716```bash theme={null}130```bash theme={null}
724* 追跡されていないファイルは含まれません。クラウドセッションが見るべきファイルで `git add` を実行します138* 追跡されていないファイルは含まれません。クラウドセッションが見るべきファイルで `git add` を実行します
725* バンドルから作成されたセッションは、[GitHub 認証](#github-authentication-options)も設定されていない限り、リモートにプッシュバックできません139* バンドルから作成されたセッションは、[GitHub 認証](#github-authentication-options)も設定されていない限り、リモートにプッシュバックできません
726 140
141<h3 id="send-follow-ups-from-the-cli">
142 CLI からフォローアップを送信
143</h3>
144
145クラウドセッションが実行されている場合、どこで実行されていても、`claude auth login` でサインインしている任意のマシンの `claude` CLI からそれにフォローアップメッセージを送信します。CLI は Anthropic アカウント認証情報で認証し、ローカルセッション状態を送信しないため、コマンドはセッションを開始したマシンから実行する必要がなく、PowerShell を含むすべてのシェルで同じです。
146
147コマンドは 1 つのメッセージを投稿して終了します:
148
149```bash theme={null}
150claude -p "your message" --cloud <session-id>
151```
152
153CLI はメッセージをセッションにキューイングして、返信を待たずに終了します。長時間実行されるセッションを操舵し、現在のセッションがまだ終了している間に次のステップをキューイングするか、[CI スクリプト](/docs/ja/self-hosted-environments-testing#run-the-test-loop)からフォローアップを送信するために使用します。代わりに stdin でメッセージをパイプすることもできます:`echo "your message" | claude -p --cloud <session-id>`。
154
155`<session-id>` については、`session_...` または `cse_...` などの裸の ID、またはセッションの `claude.ai/code/<id>` URL をスキーム、クエリ文字列の有無で渡します。ID は claude.ai/code のセッションリストで見つけます。
156
157<Note>
158 `--cloud` には Anthropic アカウントが必要です。Claude Code が Amazon Bedrock、Google Cloud の Agent Platform、または別のサードパーティプロバイダー用に設定されている場合は利用できません。`ANTHROPIC_BASE_URL` を通じてのみ設定された[LLM ゲートウェイ](/docs/ja/llm-gateway)はこのチェックではサードパーティプロバイダーとしてカウントされませんが、`claude auth login` でサインインする必要があります。組織の `allow_remote_sessions` ポリシーも有効にする必要があります。Owner は claude.ai/admin-settings/claude-code の Claude Code 管理設定でオンにできます。
159</Note>
160
161<h4 id="output-and-errors">
162 出力とエラー
163</h4>
164
165成功時に、コマンドはセッション ID とセッションを表示するリンクを出力します:
166
167```
168Sent to cloud session.
169Session ID: session_01DiUkqY2kzbUbDmW1w96rfi
170View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0
171```
172
173マシン可読結果の場合は `--output-format json` を渡します:成功時は `{ok, session_id, url}`、送信が失敗した場合は `{ok: false, session_id, error}`(例えば、セッションが見つからないか、アーカイブされている場合)。設定エラー(サポートされていないプロバイダーや無効な組織ポリシーなど)は JSON なしで stderr に出力されます。`--output-format stream-json` は `--cloud <session-id>` ではサポートされていません。
174
175CLI はエラーの前に `Error: ` を付けます。失敗した配信は `failed to send message to cloud session <id>: <reason>` としてラップされます。
176
177| メッセージ | 意味 |
178| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
179| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code はサードパーティプロバイダー用に設定されています。メッセージは設定が使用するラベル(`Amazon Bedrock` や `Google Vertex AI` など)でプロバイダーに名前を付けます。そのプロバイダーの設定を削除します(例えば、`CLAUDE_CODE_USE_BEDROCK` を設定解除)、Anthropic アカウント(`claude auth login`)でサインインします。 |
180| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 組織ポリシーがオフです。 |
181| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code は組織のポリシーをフェッチできなかったため、クラウドセッションが許可されていると仮定するのではなく、送信を拒否します。ネットワーク接続を確認して再試行してください。 |
182| `Attaching to an existing cloud session is not enabled for your account.` | `-p` なしで `--cloud <session-id>` を実行しました。`claude -p "your message" --cloud <session-id>` でメッセージを送信します。 |
183| `Session not found: <id>` | ID または URL はアクセスできるセッションと一致しません。セッションの claude.ai/code URL に対して確認してください。 |
184| `cloud session <id> is archived and cannot accept new messages` | セッションはアーカイブされています。代わりに新しいセッションを開始します。 |
185
727<h3 id="from-web-to-terminal">186<h3 id="from-web-to-terminal">
728 ウェブからターミナルへ187 ウェブからターミナルへ
729</h3>188</h3>
731以下のいずれかを使用してクラウドセッションをターミナルにプルします:190以下のいずれかを使用してクラウドセッションをターミナルにプルします:
732 191
733* **`--teleport` を使用**:コマンドラインから `claude --teleport` を実行してインタラクティブセッションピッカーを表示するか、`claude --teleport <session-id>` を実行して特定のセッションを直接再開します。コミットされていない変更がある場合は、最初にそれらをスタッシュするよう求められます。192* **`--teleport` を使用**:コマンドラインから `claude --teleport` を実行してインタラクティブセッションピッカーを表示するか、`claude --teleport <session-id>` を実行して特定のセッションを直接再開します。コミットされていない変更がある場合は、最初にそれらをスタッシュするよう求められます。
734* **`/teleport` を使用**:既存の CLI セッション内で `/teleport`(または `/tp`)を実行して、Claude Code を再起動せずに同じセッションピッカーを開きます。193* **`/teleport` を使用**:既存の CLI セッション内で `/teleport` または `/tp` を実行して、Claude Code を再起動せずに同じセッションピッカーを開きます。
735* **`/tasks` から**:`/tasks` を実行してバックグラウンドセッションを表示し、`t` を押してセッションにテレポートします。194* **`/tasks` から**:`/tasks` を実行してバックグラウンドセッションを表示し、`t` を押してセッションにテレポートします。
736* **ウェブインターフェースから**:**Open in CLI** を選択してターミナルに貼り付けられるコマンドをコピーします。195* **ウェブインターフェースから**:セッションメニューから **Open in > Terminal** を選択して、ターミナルに貼り付けられるコマンドをコピーします。
196* **クラウドセッション内から**:`/teleport` を入力すると、Claude Code はそのセッションの正確な `claude --teleport <session-id>` コマンドで返信し、リポジトリのチェックアウトから実行する準備ができています。セッションの環境で Claude Code v2.1.223 以降が必要です。
737 197
738セッションをテレポートすると、Claude は正しいリポジトリにいることを確認し、クラウドセッションからブランチをフェッチしてチェックアウトし、完全な会話履歴をターミナルに読み込みます。198セッションをテレポートすると、Claude は正しいリポジトリにいることを確認し、クラウドセッションからブランチをフェッチしてチェックアウトし、完全な会話履歴をターミナルに読み込みます。ターミナルはセッションの独自のコピーを取得します:そこでの新しい作業はローカルのままで、claude.ai または Claude モバイルアプリのクラウドセッションに表示されません。テレポート後に電話から操舵を続けるには、ローカルセッションで [`/remote-control`](/docs/ja/remote-control) を開始します。
739 199
740`--teleport` は `--resume` とは異なります。`--resume` はこのマシンのローカル履歴から会話を再開し、クラウドセッションをリストしません。`--teleport` はクラウドセッションとそのブランチをプルします。200`--teleport` は `--resume` とは異なります。`--resume` はこのマシンのローカル履歴から会話を再開し、クラウドセッションをリストしません。`--teleport` はクラウドセッションとそのブランチをプルします。
741 201
746テレポートはセッションを再開する前にこれらの要件をチェックします。要件が満たされていない場合は、エラーが表示されるか、問題を解決するよう求められます。206テレポートはセッションを再開する前にこれらの要件をチェックします。要件が満たされていない場合は、エラーが表示されるか、問題を解決するよう求められます。
747 207
748| 要件 | 詳細 |208| 要件 | 詳細 |
749| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |209| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
750| クリーンな git 状態 | 作業ディレクトリにコミットされていない変更がないことが必要です。テレポートは必要に応じて変更をスタッシュするよう求めます。 |210| クリーンな git 状態 | 作業ディレクトリにコミットされていない変更がないことが必要です。テレポートは必要に応じて変更をスタッシュするよう求めます。 |
751| 正しいリポジトリ | フォークではなく、同じリポジトリのチェックアウトから `--teleport` を実行する必要があります。v2.1.199 以降、Claude Code は `git@work:owner/repo.git` のような SSH ホストエイリアスや `insteadOf` で書き直された短い形式など、リモートをホスト名に解析できない場合でも、チェックアウトを受け入れます。最初に確認プロンプトを表示し、リモートの所有者とリポジトリ名がセッションのリポジトリと一致する場合のみです。 |211| 正しいリポジトリ | フォークではなく、同じリポジトリのチェックアウトから `--teleport` を実行する必要があります。別のリポジトリのチェックアウトから実行する場合、Claude Code はセッションのリポジトリとチェックアウトの両方に名前を付けるエラーを表示します。Claude Code がリモートをホスト名に解析できない場合(`git@work:owner/repo.git` のような SSH ホストエイリアスなど)、確認を求め、リモートの所有者とリポジトリ名がセッションのリポジトリと一致する場合、チェックアウトを受け入れます。 |
752| ブランチが利用可能 | クラウドセッションからのブランチがリモートにプッシュされている必要があります。テレポートは自動的にフェッチしてチェックアウトします。 |212| ブランチが利用可能 | クラウドセッションからのブランチがリモートにプッシュされている必要があります。テレポートは自動的にフェッチしてチェックアウトします。 |
753| 同じアカウント | クラウドセッションで使用された同じ claude.ai アカウントに認証される必要があります。 |213| 同じアカウント | クラウドセッションで使用された同じ claude.ai アカウントに認証される必要があります。 |
754 214
756 `--teleport` が利用できない216 `--teleport` が利用できない
757</h4>217</h4>
758 218
759テレポートには claude.ai サブスクリプション認証が必要です。API キー、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 経由で認証されている場合は、代わりに claude.ai アカウントでサインインするために `/login` を実行してください。claude.ai 経由で既にサインインしており、`--teleport` がまだ利用できない場合は、組織がクラウドセッションを無効にしている可能性があります。219テレポートには claude.ai サブスクリプション認証が必要です。API キーで認証されている場合は、代わりに claude.ai アカウントでサインインするために `/login` を実行してください。エラーがプロバイダーに名前を付ける場合、クラウドセッションはサードパーティプロバイダーを通じて利用できません;[エラーテーブル](#output-and-errors)を参照してください。claude.ai 経由で既にサインインしており、`--teleport` がまだ利用できない場合は、組織がクラウドセッションを無効にしている可能性があります。
760 220
761<h2 id="work-with-sessions">221<h2 id="work-with-sessions">
762 セッションの操作222 セッションの操作
771クラウドセッションは[組み込みコマンド](/docs/ja/commands)をサポートしており、テキスト出力を生成します。ターミナルインターフェイスでのみ実行されるコマンド(`/plugin` や `/resume` など)は利用できません。ターミナルでピッカーまたはパネルを開くコマンドはクラウドセッションで異なる動作をします:231クラウドセッションは[組み込みコマンド](/docs/ja/commands)をサポートしており、テキスト出力を生成します。ターミナルインターフェイスでのみ実行されるコマンド(`/plugin` や `/resume` など)は利用できません。ターミナルでピッカーまたはパネルを開くコマンドはクラウドセッションで異なる動作をします:
772 232
773* **`/model`、`/effort`、`/fast`、`/color`、`/rename`**:ターミナルピッカーまたはスライダーを開く代わりに、引数として値を渡します。例えば `/model sonnet` のように使用します。引数形式はセッションの環境で Claude Code v2.1.205 以降が必要であり、各コマンドの[利用可能性に関する注記](/docs/ja/commands#all-commands)に従います。`/effort` はモデルの[起動デフォルト努力保持](/docs/ja/model-config#adjust-effort-level)が有効な場合は `Not applied` を報告し、`/fast` はファストモードを有効にして開始されたセッションでのみ機能します。233* **`/model`、`/effort`、`/fast`、`/color`、`/rename`**:ターミナルピッカーまたはスライダーを開く代わりに、引数として値を渡します。例えば `/model sonnet` のように使用します。引数形式はセッションの環境で Claude Code v2.1.205 以降が必要であり、各コマンドの[利用可能性に関する注記](/docs/ja/commands#all-commands)に従います。`/effort` はモデルの[起動デフォルト努力保持](/docs/ja/model-config#adjust-effort-level)が有効な場合は `Not applied` を報告し、`/fast` はファストモードを有効にして開始されたセッションでのみ機能します。
774* **`/config`**:ウェブ上では、値を設定する代わりに Claude Code セクションの設定を開き、`key=value` を含むコマンド後のテキストは無視されます。クラウドセッションの設定を変更するには、[環境変数](#configure-your-environment)を使用するか、[設定ファイル](/docs/ja/settings)をリポジトリにコミットします。234* **`/config`**:ウェブ上では、値を設定する代わりに Claude Code セクションの設定を開き、`key=value` を含むコマンド後のテキストは無視されます。クラウドセッションの設定を変更するには、[環境変数](/docs/ja/cloud-environments#set-environment-variables)を使用するか、[設定ファイル](/docs/ja/settings)をリポジトリにコミットします。
775 235
776コンテキスト管理の場合:236コンテキスト管理の場合:
777 237
781| `/context` | はい | 現在コンテキストウィンドウにあるものを表示します |241| `/context` | はい | 現在コンテキストウィンドウにあるものを表示します |
782| `/clear` | いいえ | サイドバーから新しいセッションを開始します |242| `/clear` | いいえ | サイドバーから新しいセッションを開始します |
783 243
784自動圧縮はコンテキストウィンドウが容量に近づくと自動的に実行されます。より早くトリガーするには、[環境変数](#configure-your-environment)で [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/ja/env-vars)を設定します。例えば、`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70` はウィンドウがほぼいっぱいになるまで待つのではなく、70% 容量で圧縮します。圧縮計算の有効なウィンドウサイズを変更するには、[`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ja/env-vars)を使用します。244自動圧縮はコンテキストウィンドウが容量に近づくと自動的に実行されます。Claude Code on the web は [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/ja/env-vars) をクラウドセッションで自身で設定するため、圧縮はウィンドウが満杯になるのではなく、[自動圧縮ウィンドウ](/docs/ja/model-config#set-the-auto-compact-window)の途中でトリガーされます。その値は[環境変数](/docs/ja/cloud-environments#set-environment-variables)に追加するものをオーバーライドするため、そこに変数を追加しても圧縮がトリガーされるタイミングは変わりません。
785 245
786[Subagents](/docs/ja/sub-agents)はローカルと同じように機能します。Claude は Task ツールでそれらをスポーンして、研究または並列作業を別のコンテキストウィンドウにオフロードし、メイン会話を軽くすることができます。リポジトリの `.claude/agents/` で定義された Subagents は自動的にピックアップされます。246自動圧縮ウィンドウを変更するには、[環境変数](/docs/ja/cloud-environments#set-environment-variables)で [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ja/env-vars) を設定するか、変数が設定されていないセッションで [`/autocompact`](/docs/ja/commands#all-commands) をトークン数で実行します。
787 247
788[Agent teams](/docs/ja/agent-teams)はデフォルトでオフですが、[環境変数](#configure-your-environment)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を追加することで有効にできます。248[Subagents](/docs/ja/sub-agents)はローカルと同じように機能します。Claude は Agent ツールでそれらをスポーンして、研究または並列作業を別のコンテキストウィンドウにオフロードし、メイン会話を軽くすることができます。リポジトリの `.claude/agents/` で定義された Subagents は自動的にピックアップされます。
249
250[Agent teams](/docs/ja/agent-teams)はデフォルトでオフですが、[環境変数](/docs/ja/cloud-environments#set-environment-variables)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を追加することで有効にできます。
251
252<h3 id="permission-modes-in-cloud-sessions">
253 クラウドセッションの権限モード
254</h3>
255
256クラウドセッションの[権限モード](/docs/ja/permission-modes)は[モードドロップダウン](/docs/ja/permission-modes#switch-permission-modes)から選択します。タスクを作成するときとセッションが実行されている間の両方です。Anthropic ホスト型[環境が有効期限切れ](#environment-expired)になったセッションを再度開くか、セルフホスト型ランナーが[アイドル中にリリース](/docs/ja/self-hosted-environments-reference#runner-cli-flags)したセッションにメッセージを送信する場合、Claude Code はセッションが存在していた権限モードで再開されます。
789 257
790<h3 id="review-changes">258<h3 id="review-changes">
791 変更を確認259 変更を確認
792</h3>260</h3>
793 261
794各セッションは追加および削除された行数を示す diff インジケーター(例:`+42 -18`)を表示します。それを選択して diff ビューを開き、特定の行にインラインコメントを残し、次のメッセージで Claude に送信します。PR 作成を含む完全なウォークスルーについては [Review and iterate](/docs/ja/web-quickstart#review-and-iterate)を参照してください。Claude が PR の CI 失敗とレビューコメントを自動的に監視するようにするには、[プルリクエストの自動修正](#auto-fix-pull-requests)を参照してください。262各セッションは追加および削除された行数を示す diff インジケーター(例:`+42 -18`)を表示します。それを選択して diff ビューを開き、特定の行にインラインコメントを残し、次のメッセージで Claude に送信します。
263
264Claude Code はこれらの diff を計算します。これには Claude が編集するときに表示される per-file diff が含まれます。これは raw git blob コンテンツから計算されるため、リポジトリで設定された diff ドライバーと `textconv` フィルターは適用されません。
265
266PR 作成を含む完全なウォークスルーについては [Review and iterate](/docs/ja/web-quickstart#review-and-iterate) を参照してください。Claude が PR の CI 失敗とレビューコメントを自動的に監視するようにするには、[プルリクエストの自動修正](#auto-fix-pull-requests)を参照してください。
795 267
796<h3 id="share-sessions">268<h3 id="share-sessions">
797 セッションを共有269 セッションを共有
815 287
816共有する前にセッションで機密コンテンツを確認してください。セッションにはプライベート GitHub リポジトリのコードと認証情報が含まれる可能性があります。リポジトリアクセス検証はデフォルトで有効になっていません。288共有する前にセッションで機密コンテンツを確認してください。セッションにはプライベート GitHub リポジトリのコードと認証情報が含まれる可能性があります。リポジトリアクセス検証はデフォルトで有効になっていません。
817 289
818受信者がリポジトリアクセスを持つことを要求するか、共有セッションから名前を非表示にするには、Settings > Claude Code > Sharing settings に移動します。290受信者がリポジトリアクセスを持つことを要求するか、共有セッションから名前を非表示にするには、[**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code) に移動します。
819 291
820<h3 id="archive-sessions">292<h3 id="archive-sessions">
821 セッションをアーカイブ293 セッションをアーカイブ
843Claude はプルリクエストを監視し、CI 失敗とレビューコメントに自動的に応答できます。Claude は PR の GitHub アクティビティをサブスクライブし、チェックが失敗するかレビュアーがコメントを残すと、Claude は調査し、明確な場合は修正をプッシュします。315Claude はプルリクエストを監視し、CI 失敗とレビューコメントに自動的に応答できます。Claude は PR の GitHub アクティビティをサブスクライブし、チェックが失敗するかレビュアーがコメントを残すと、Claude は調査し、明確な場合は修正をプッシュします。
844 316
845<Note>317<Note>
846 Auto-fix には Claude GitHub App がリポジトリにインストールされている必要があります。まだインストールしていない場合は、[GitHub App ページ](https://github.com/apps/claude)からインストールするか、[セットアップ](/docs/ja/web-quickstart#connect-github-and-create-an-environment)中にプロンプトが表示されたときにインストールします。318 Auto-fix には Claude GitHub App がリポジトリにインストールされている必要があります。まだインストールしていない場合は、[GitHub App ページ](https://github.com/apps/claude)からインストールしてください。
847</Note>319</Note>
848 320
849PR がどこから来たか、どのデバイスを使用しているかに応じて、auto-fix をオンにするにはいくつかの方法があります:321PR がどこから来たか、どのデバイスを使用しているかに応じて、auto-fix をオンにするにはいくつかの方法があります:
850 322
851* **ウェブ上の Claude Code で作成された PR**:CI ステータスバーを開き、**Auto-fix** を選択します323* **ウェブ上の Claude Code で作成された PR**:CI ステータスバーを開き、**Auto-fix** を選択します
852* **ターミナルから**:PR のブランチにいる間に [`/autofix-pr`](/docs/ja/commands)を実行します。Claude Code は `gh` で開いている PR を検出し、ウェブセッションをスポーンし、1 ステップで auto-fix をオンにします324* **ターミナルから**:PR のブランチにいる間に [`/autofix-pr`](/docs/ja/commands) を実行します。Claude Code は `gh` で開いている PR を検出し、ウェブセッションをスポーンし、1 ステップで auto-fix をオンにします
853* **モバイルアプリから**:Claude に PR を auto-fix するよう指示します。例えば「watch this PR and fix any CI failures or review comments」325* **モバイルアプリから**:Claude に PR を auto-fix するよう指示します。例えば「watch this PR and fix any CI failures or review comments」
854* **既存の PR**:PR URL をセッションに貼り付けて、Claude に auto-fix するよう指示します326* **既存の PR**:PR URL をセッションに貼り付けて、Claude に auto-fix するよう指示します
855 327
879 351
880各クラウドセッションはいくつかのレイヤーを通じてマシンおよび他のセッションから分離されます:352各クラウドセッションはいくつかのレイヤーを通じてマシンおよび他のセッションから分離されます:
881 353
882* **分離された仮想マシン**:各セッションは分離された Anthropic 管理 VM で実行されます354* **分離された仮想マシン**:各セッションは分離された Anthropic 管理 VM で実行されます。セッションが組織によってルーティングされる[セルフホスト環境](/docs/ja/self-hosted-environments)は、代わりに独自のインフラストラクチャで実行され、分離はデプロイメントの責任です
883* **ネットワークアクセス制御**:ネットワークアクセスはデフォルトで制限され、無効にできます。ネットワークアクセスを無効にして実行する場合、Claude Code は Anthropic API と通信できます。これにより VM からデータが出ることを許可する可能性があります。355* **ネットワークアクセス制御**:Anthropic ホスト型環境では、ネットワークアクセスはデフォルトで制限され、無効にできます。セルフホスト型環境では、独自のネットワーク境界でセッション出力を制限します。ネットワークアクセスを無効にして実行する場合、Claude Code は Anthropic API と通信できます。これにより VM からデータが出ることを許可する可能性があります。
884* **認証情報保護**:git 認証情報や署名キーなどの機密認証情報はサンドボックス内の Claude Code と一緒にありません。認証はスコープ付き認証情報を使用するセキュアプロキシを通じて処理されます。356* **認証情報保護**:Anthropic ホスト型環境では、git 認証情報と署名キーはサンドボックスの外に留まり、プロキシはスコープ付き認証情報で認証します。セルフホスト型環境では、デプロイメントが git 認証情報を提供します;[git を設定](/docs/ja/self-hosted-environments-deploy#configure-git)を参照してください
885* **セキュアな分析**:コードは PR を作成する前に分離された VM 内で分析および変更されます357* **API 認証情報**:Anthropic ホスト型環境の Pro および Max プランでは、[クラウド環境に追加](/docs/ja/cloud-environments#add-api-credentials)するキーはサンドボックスの外に留まり、セッションを離れた後、一致するリクエストに添付されます。セルフホスト型環境には API 認証情報がなく、Team および Enterprise プランはまだそれらを持っていません
358* **セキュアな分析**:コードは PR を作成する前に分離されたセッション環境内で分析および変更されます
886 359
887<h2 id="troubleshooting">360<h2 id="troubleshooting">
888 トラブルシューティング361 トラブルシューティング
900* 1 分後に再試行してください。容量はオンデマンドでプロビジョニングされます373* 1 分後に再試行してください。容量はオンデマンドでプロビジョニングされます
901* リポジトリが到達可能であることを確認してください。接続している GitHub アカウントは、Claude GitHub App 認可またはオンデマンドで `/web-setup` 経由で同期された `gh` トークンのいずれかを通じて、GitHub 上のリポジトリへのアクセス権を持つ必要があります。リポジトリに App をインストールする必要はありません。[GitHub 認証オプション](#github-authentication-options)を参照してください。374* リポジトリが到達可能であることを確認してください。接続している GitHub アカウントは、Claude GitHub App 認可またはオンデマンドで `/web-setup` 経由で同期された `gh` トークンのいずれかを通じて、GitHub 上のリポジトリへのアクセス権を持つ必要があります。リポジトリに App をインストールする必要はありません。[GitHub 認証オプション](#github-authentication-options)を参照してください。
902 375
376<h3 id="unable-to-get-organization-uuid">
377 組織 UUID を取得できない
378</h3>
379
380`claude --cloud` と `claude --teleport` には claude.ai アカウントでのサインインが必要です。API キーで認証されている場合、または保存されたアカウント詳細が古い場合、これらのコマンドは `Unable to get organization UUID` で失敗するか、API キー認証が十分でないというメッセージが表示されます。API キー認証または古いアカウント詳細を使用して、セッション ID なしで `claude --teleport` を実行すると、どちらかのメッセージの代わりにセッションピッカーで `Error loading Claude Code sessions` が表示され、同じ修正が適用されます。
381
382`/login` を実行して claude.ai アカウントでサインインし、コマンドを再試行してください。エラーがプロバイダーに名前を付ける場合は、[エラーテーブル](#output-and-errors)を参照してください:クラウドセッションはサードパーティプロバイダーを通じて利用できません。
383
903<h3 id="remote-control-session-expired-or-access-denied">384<h3 id="remote-control-session-expired-or-access-denied">
904 Remote Control セッションの有効期限切れまたはアクセス拒否385 Remote Control セッションの有効期限切れまたはアクセス拒否
905</h3>386</h3>
914 環境の有効期限切れ395 環境の有効期限切れ
915</h3>396</h3>
916 397
917クラウドセッションは非アクティブ期間後に停止し、基盤となる環境は回収されます。ローカルターミナルから、これは `Could not resume session ... its environment has expired. Creating a fresh session instead.` として表示されます。ウェブでは、セッションはセッションリストで期限切れとしてマークされます。398クラウドセッションは非アクティブ期間後に停止し、セッションの VM は回収されます。ウェブでは、セッションはセッションリストで期限切れとしてマークされます。
918 399
919[claude.ai/code](https://claude.ai/code) からセッションを再度開いて、会話履歴が復元された新しい環境をプロビジョニングしてください。400[claude.ai/code](https://claude.ai/code) からセッションを再度開いて、会話履歴が復元された新しい VM をプロビジョニングしてください。VM が回収されたときにまだ実行されていたバックグラウンド作業(subagents やシェルコマンドなど)は復元されません。
920 401
921<h2 id="limitations">402<h2 id="limitations">
922 制限事項403 制限事項
926 407
927* **レート制限**:ウェブ上の Claude Code はアカウント内のすべての他の Claude および Claude Code 使用とレート制限を共有します。複数のタスクを並列で実行すると、レート制限をより多く消費します。クラウド VM に対する個別のコンピュート料金はありません。408* **レート制限**:ウェブ上の Claude Code はアカウント内のすべての他の Claude および Claude Code 使用とレート制限を共有します。複数のタスクを並列で実行すると、レート制限をより多く消費します。クラウド VM に対する個別のコンピュート料金はありません。
928* **リポジトリ認証**:ウェブからローカルにセッションを移動できるのは、同じアカウントに認証されている場合のみです409* **リポジトリ認証**:ウェブからローカルにセッションを移動できるのは、同じアカウントに認証されている場合のみです
929* **プラットフォーム制限**:リポジトリのクローンとプルリクエストの作成には GitHub が必要です。自己ホスト型の [GitHub Enterprise Server](/docs/ja/github-enterprise-server) インスタンスは Team および Enterprise プランでサポートされています。GitLab、Bitbucket、およびその他の非 GitHub リポジトリは[ローカルバンドル](#send-local-repositories-without-github)としてクラウドセッションに送信できますが、セッションはリモートに結果をプッシュバックできません410* **プラットフォーム制限**:リポジトリのクローンとプルリクエストの作成には GitHub が必要です。セルフホスト型の [GitHub Enterprise Server](/docs/ja/github-enterprise-server) インスタンスは Team および Enterprise プランでサポートされています。GitLab、Bitbucket、およびその他の非 GitHub リポジトリは[ローカルバンドル](#send-local-repositories-without-github)としてクラウドセッションに送信できますが、セッションはリモートに結果をプッシュバックできません
930* **組織 IP 許可リスト**:クラウドセッションは Anthropic 管理インフラストラクチャから Anthropic API を呼び出すため、ネットワークからではありません。組織が [IP 許可リスト](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting)を有効にしている場合、すべてのクラウドセッションは認証エラーで失敗します。同じことが [Code Review](/docs/ja/code-review) および [Routines](/docs/ja/routines)に適用されます。[Anthropic サポート](https://support.claude.com/)に連絡して、Anthropic ホスト型サービスを組織の IP 許可リストから除外してください。411* **組織 IP 許可リスト**:クラウドセッションは Anthropic 管理インフラストラクチャから Anthropic API を呼び出すため、ネットワークからではありません。セッションが[セルフホスト環境](/docs/ja/self-hosted-environments)にルーティングされている場合、独自のネットワークから呼び出します。組織が [IP 許可リスト](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting)を有効にしている場合、すべての Anthropic ホスト型クラウドセッションは認証エラーで失敗します。同じことが [Code Review](/docs/ja/code-review) および Anthropic ホスト型環境で実行される[ルーチン](/docs/ja/routines)に適用されます;セルフホスト型環境にルーティングされたルーチンは独自のネットワークから API を呼び出します。[Anthropic サポート](https://support.claude.com/)に連絡して、Anthropic ホスト型サービスを組織の IP 許可リストから除外してください。
931 412
932<h2 id="related-resources">413<h2 id="related-resources">
933 関連リソース414 関連リソース
934</h2>415</h2>
935 416
936* [Ultraplan](/docs/ja/ultraplan):クラウドセッションでプランを起案し、ブラウザで確認417* [クラウド環境](/docs/ja/cloud-environments):クラウドセッションのネットワークアクセス、環境変数、セットアップスクリプトを設定
937* [Ultrareview](/docs/ja/ultrareview):クラウドサンドボックスで深いマルチエージェントコードレビューを実行418* [Ultrareview](/docs/ja/ultrareview):クラウドサンドボックスで深いマルチエージェントコードレビューを実行
938* [Routines](/docs/ja/routines):スケジュール、API 呼び出し、または GitHub イベントに応答して作業を自動化419* [ルーチン](/docs/ja/routines):スケジュール、API 呼び出し、または GitHub イベントに応答して作業を自動化
939* [フック設定](/docs/ja/hooks):セッションライフサイクルイベントでスクリプトを実行420* [フック設定](/docs/ja/hooks):セッションライフサイクルイベントでスクリプトを実行
940* [設定リファレンス](/docs/ja/settings):すべての設定オプション421* [すべての設定](/docs/ja/settings-reference):すべての設定オプション
941* [セキュリティ](/docs/ja/security):分離保証とデータ処理422* [セキュリティ](/docs/ja/security):分離保証とデータ処理
942* [データ使用](/docs/ja/data-usage):Anthropic がクラウドセッションから保持するもの423* [データ使用](/docs/ja/data-usage):Anthropic がクラウドセッションから保持するもの
943* [Claude Tag](https://claude.com/docs/claude-tag/overview):Slack で実行される組織管理の @Claude で、同じクラウド環境で動作424* [Claude Tag](https://claude.com/docs/claude-tag/overview):Slack で実行される組織管理の @Claude で、同じクラウドインフラストラクチャで動作