Claude Codeのクラウド環境とは、クラウドセッションごとに使う実行環境の設定のことです。
依存関係はセットアップスクリプトで入れ、APIキーはネットワークシークレットで渡すのが基本です。
ネットワークシークレットなら、セッション側はキーの値を見ずにAPIを呼べます(公式ドキュメント、確認日は2026年11月7日)。
この記事では、環境で設定できる項目、依存関係の入れ方、キーの安全な渡し方を順に整理します。
クラウドセッションそのものの始め方は、別記事のClaude Code Web版の使い方で説明しています。
この記事は、その続きとして環境の中身に絞ります。
Claude Codeのクラウド環境とは
クラウド環境とは、クラウドセッションが動く実行環境に、ネットワーク範囲・環境変数・セットアップスクリプトなどを設定したものです。
公式ドキュメントは、各クラウドセッションがクラウド環境の中で動くと説明しています(公式ドキュメント)。
環境では、ネットワークアクセスの許可と拒否、環境変数、ネットワークシークレット、セットアップスクリプトを設定できます(公式ドキュメント)。
同じ環境は、デスクトップアプリ、モバイルアプリ、claude.ai/code、claude --cloud、クラウドのスケジュール実行で共通に使われます(公式ドキュメント)。
つまり、一度環境を整えれば、どの入り口から始めても同じ準備が効きます。
環境を一つも持っていない場合は、初回の設定で Default 環境が用意されます。
Default は、ネットワークアクセスが Trusted で、環境変数もセットアップスクリプトも持ちません(公式ドキュメント)。
クラウド環境を使えるプラン
クラウドセッションは、Pro・Max・Ultra・Teamのプランと、条件を満たすEnterpriseユーザーが対象です。
公式ドキュメントによると、Enterpriseは premium seat か Chat + Claude Code seat を持つユーザーが対象です(公式ドキュメント)。
ネットワークシークレットは、Pro・Max・Ultra・Team・Enterpriseの各プランで使えます(公式ドキュメント)。
ただし、シークレットを自分で追加できるかは、環境の種類や役割で変わります。
- 自分の環境では、どのプランでも自分でシークレットを追加・削除できます。
- TeamとEnterpriseでは、組織の管理者ロールを持つOwnerかどうかで、入力フォームが変わります。
- 組織で共有された環境のシークレットは、Ownerが管理画面から追加・削除します。
上の3点は、公式ドキュメントの Requirements の記載にもとづきます(公式ドキュメント)。
環境で設定できる4つの項目
環境で設定できるのは、ネットワークアクセス、環境変数、ネットワークシークレット、セットアップスクリプトの4つです。
設定は claude.ai/code の新規セッション画面にある環境セレクタから行います(公式ドキュメント)。
| 項目 | 何を決めるか | 見える人 |
|---|---|---|
| ネットワークアクセス | セッションが外へ出られる範囲 | 環境を使う人 |
| 環境変数 | セッションに渡す設定値 | 環境を使う人なら誰でも読める |
| ネットワークシークレット | APIキーなど、セッションに見せずに使う値 | 保存後は値を再表示できない |
| セットアップスクリプト | Claude Codeの起動前に走る準備処理 | 環境を使う人なら誰でも読める |
表の「見える人」は、公式ドキュメントの環境変数・セットアップスクリプト・シークレットの記述をもとに整理しました(公式ドキュメント)。
ネットワークアクセスには None・Trusted・Full・Custom の4段階があります。
Trusted はパッケージレジストリやGitHubなどの許可リストだけ、Custom は自分で書いた許可リストです(公式ドキュメント)。
最初から入っているツールと、入っていないもの
クラウドセッションの仮想マシンには、主要な言語のランタイムやビルドツールが最初から入っています。
仮想マシンはUbuntu 24.04のx86_64です。
公式ドキュメントでは、Python、Node.js、Ruby、PHP、Java、Go、Rust、C/C++、Docker、PostgreSQL、Redisなどが入っていると案内されています(公式ドキュメント)。
一方で、.NET SDKのように入っていないツールチェーンもあります。
パッケージレジストリが許可リストにあっても、入っていないものはセットアップスクリプトで入れる、というのが公式の案内です(公式ドキュメント)。
PostgreSQLとRedisは入っていますが、最初は起動していません。
使うときは、Claudeに起動を頼みます(公式ドキュメント)。
依存関係を準備する2つの方法
依存関係の準備には、環境のセットアップスクリプトと、リポジトリのSessionStartフックの2つの方法があります。
公式ドキュメントは、仮想マシン自体の準備にはセットアップスクリプト、どこでも走らせたいプロジェクトの準備にはSessionStartフックを勧めています(公式ドキュメント)。
| 比べる点 | セットアップスクリプト | SessionStartフック |
|---|---|---|
| 設定する場所 | claude.ai/code の環境ダイアログ | リポジトリの .claude/settings.json など |
| 走るタイミング | Claude Codeの起動前(キャッシュがあれば省略) | 起動後、再開時も含めて毎回 |
| 走る場所 | クラウドセッションだけ | ローカルとクラウドの両方 |
| 向いている用途 | 入っていないツールチェーンやCLI | npm install などのプロジェクト準備 |
この比較は、公式ドキュメントの Setup scripts vs. SessionStart hooks の表にもとづきます(公式ドキュメント)。
フックそのものの書き方は、Claude Codeのフックの使い方で確認できます。
settings.json の置き場所は、settings.jsonの場所と優先順位が参考になります。
フックには注意点もあります。
- 複数のリポジトリを入れたセッションでは、リポジトリの設定からフックが読み込まれません。
- プロジェクトのクラウドスレッドでも、リポジトリのフックは走りません。
- ローカルでも走るため、クラウド限定にするなら環境変数 CLAUDE_CODE_REMOTE が true かを確認して抜けます。
この3点は、公式ドキュメントの Limitations in cloud sessions に書かれています(公式ドキュメント)。
セットアップスクリプトの追加手順
セットアップスクリプトは、環境ダイアログの Setup script 欄にBashスクリプトを書いて保存するだけで追加できます。
スクリプトは新しいクラウドセッションが始まるとき、Claude Codeが起動する前に、Ubuntu 24.04のroot権限で走ります(公式ドキュメント)。
- claude.ai/code の新規セッション画面で、メッセージ欄の下にある環境セレクタを開きます。
- 新しい環境なら New environment、既存の環境なら設定アイコンを選びます。
- ダイアログの Setup script の行を開きます。
- スクリプトを入力するか、64KBまでのテキストファイルを Choose file で読み込みます。
- 新規なら Add environment、既存なら Save changes で保存します。
手順の流れは公式ドキュメントの Add a setup script に沿っています(公式ドキュメント)。
公式の例では、入っていないShellCheckを次の2行で入れています。
#!/bin/bash
apt update && apt install -y shellcheck
書くときは、次の4つの条件を守ります。
- 終了コードを0にします。失敗すると、セッションが始まらないか、入れたいものが欠けた状態で始まります。重要でないコマンドには
|| trueを付けます。 - 全体の実行を約5分以内に収めます。超えるとキャッシュが作られません。
- パッケージを入れるにはレジストリへ出られる必要があります。ネットワークが None だとインストールは失敗します。
- 環境変数はまだ設定されていません。スクリプトに必要な値は、スクリプト内で設定します。
この4条件は、公式ドキュメントの Script requirements にあります(公式ドキュメント)。
特に4つ目は見落としやすく、環境変数に入れたトークンは、スクリプトの実行時点ではまだ設定されていません。
環境キャッシュで起動を速くする
環境キャッシュは、セットアップスクリプトの結果を保存して、次のセッションの起動を速くする仕組みです。
セットアップが約5分以内に終わると、ファイルシステムのスナップショットが取られ、後のセッションはそこから始まります(公式ドキュメント)。
キャッシュに残るのは、入れたパッケージ、取得したDockerイメージ、書いたファイルです。
起動したデータベースやバックグラウンドのプロセスは残らないので、セッションごとに起動し直します(公式ドキュメント)。
キャッシュは、スクリプトや許可ホストを変えたときと、約7日の期限が来たときに作り直されます。
また、アイドルから復帰した仮想マシンではスクリプトが走り直しません。
変更をすぐ反映したいときは、セッション内でコマンドを走らせるか、新しいセッションを始めます(公式ドキュメント)。
実践用の「Claude Code・Codex 最初の安全設定と仕事の渡し方」を無料で配布しています。LINE で「AIエージェント設定」と送ると届きます。LINEで受け取る
環境変数に入れてよいものと、入れてはいけないもの
環境変数は.env形式で書きますが、環境を使う人なら誰でも値を読めるため、秘密の値には向きません。
書式は1行に1組のKEY=valueで、#を含む値や複数行の値は引用符で囲みます(公式ドキュメント)。
公式ドキュメントは、環境を使う人なら誰でも環境変数の値を読めると明記しています(公式ドキュメント)。
そのため、環境変数に向くのは、公開してよい設定値です。
- 入れてよい例:NODE_ENV や LOG_LEVEL のような動作モード
- 避ける例:APIキーやトークンのような、漏れると困る値
公式ドキュメントも、Anthropicがホストする環境では、プロキシが付けられるキーはネットワークシークレットに入れるよう案内しています(公式ドキュメント)。
変更の反映にも注意が必要です。
既存のセッションは、仮想マシンが復元または再構築されるまで、前に読み込んだ値を使い続けます(公式ドキュメント)。
ネットワークシークレットとは
ネットワークシークレットとは、環境に保存したAPIキーやトークンを、セッションに見せないままAPI呼び出しに使う仕組みです。
Anthropicのエージェントプロキシが、指定したホスト宛のリクエストに、仮想マシンの外でキーを付けます(公式ドキュメント)。
キー自体は仮想マシンの外に残るので、セッションの環境変数やファイルにキーは現れません(公式ドキュメント)。
この違いが、環境変数との大きな差です。
| 比べる点 | 環境変数 | ネットワークシークレット |
|---|---|---|
| セッションから値が見えるか | 見える | 見えない |
| 環境を使う人が値を読めるか | 読める | 保存後に値を再表示できない |
| キーを付ける場所 | セッション内のコマンド | 仮想マシンの外のプロキシ |
| 向いている値 | 公開してよい設定値 | APIキーやトークン |
この比較は、公式ドキュメントの環境変数とネットワークシークレットの記述を並べたものです(公式ドキュメント)。
使うための条件もあります。
- Anthropicがホストする既存のクラウド環境であること(セルフホスト環境にはネットワークシークレットがありません)
- APIがインターネットからの接続を受けること
- 顧客管理の暗号化キーを使う組織では、ネットワークシークレットを保存できないこと
この3条件は、公式ドキュメントの Requirements にあります(公式ドキュメント)。
ネットワークシークレットの追加手順
追加は、環境の編集画面で Network secrets の行を開き、Add secret のフォームに許可ホストと入れ方を書いて保存します。
シークレットは1件ずつ追加し、ホストや値を変えたいときは削除してから追加し直します(公式ドキュメント)。
- claude.ai/code で環境を編集用に開き、Edit cloud environment ダイアログの Network secrets の行を選びます。
- Add secret を選びます。
- Secret type は、ヘッダーで送るAPIキーなら初期値の Bearer のままにします。
- Allowed websites に、APIのホスト名を入れます。先頭の
*.は、すべてのサブドメインに一致します。 - Custom headers で、キーを運ぶヘッダーを1行設定します。初期値は、Header name が Authorization、Prefix が Bearer です。
- Value にキーを貼り付けて、Add で保存します。
この手順は、公式ドキュメントの Add a secret にもとづきます(公式ドキュメント)。
X-Api-Key のように値だけを受け取るヘッダーなら、名前を変えて Prefix を空にします。
保存したシークレットは、一覧に許可ホストと一緒に表示されます。
保存後に値を再表示することはできません(公式ドキュメント)。
TeamやEnterpriseで組織の管理者ロールがない場合は、1つのホストに1つのシークレットを付ける短いフォームになります。
その場合は、Host にホストを1つだけ入れます。ワイルドカードの *. は使えません。
種類は、ヘッダーで送るキーなら Token を選びます(公式ドキュメント)。
シークレットが付かないリクエストと、動作の確かめ方
エージェントプロキシは、GitHubや主要なパッケージレジストリなど、一部の宛先には追加したシークレットを付けません。
公式ドキュメントは、付かない宛先として次を挙げています(公式ドキュメント)。
- GitHub(専用のGitHubプロキシが認証するため、ネットワークシークレットは不要)
- Anthropic API(api.anthropic.com)と、npm・PyPI・crates.io・Goなどの公開パッケージレジストリ
- セットアップスクリプトからのリクエスト(Claude Codeがプロキシに接続するのは、スクリプトが走った後のため)
- Claude Codeのテレメトリ送信
この4つに当たる値は、環境変数に入れて使うことになります。
一方、シークレットに指定したホストへは、環境のネットワークアクセスが許可していなくても、セッションから届きます(上の例外を除く)。
確かめるには、その環境で新しいセッションを始め、ClaudeにcurlなどでそのAPIを呼ばせます。
APIがキー付きのように応答し、キーがセッションの環境変数にもファイルにも現れなければ成功です(公式ドキュメント)。
一覧に Not sent と出ている場合は、その下の注記に理由と対処が書かれています。
ホストが重なって完全には一致しない2つのシークレットは、どちらか1つしか送られません(公式ドキュメント)。
仮の例:依存関係とAPIキーをどう振り分けるか
振り分けの基準は、「入れるもの」はセットアップスクリプトかフック、「渡す値」はネットワークシークレットか環境変数です。
ここでは、公式の説明をもとにした仮の例として、あるプロジェクトの準備を振り分けます(実在の案件ではありません)。
| やりたいこと | 置き場所 | 理由 |
|---|---|---|
| .NET SDKを使いたい | セットアップスクリプト | 最初から入っていないツールチェーンのため |
| npm install を毎回の起動で最新にしたい | SessionStartフック | プロジェクトの準備はフックが向いているため |
| 外部の分析APIをキー付きで呼びたい | ネットワークシークレット | セッションにキーを見せないため |
| ログの詳しさを切り替えたい | 環境変数 | 公開してよい設定値のため |
表の置き場所は、前の章で確認した公式ドキュメントの区分を当てはめたものです(公式ドキュメント)。
キーをシークレットに入れても、前の章で挙げた宛先には付きません。
その場合は環境変数に頼ることになるため、環境を使う人全員が値を読める前提で、権限を絞ったキーにしておくのが安全です。
共有環境で気をつけること
TeamとEnterpriseでは、Ownerが組織の全員に共有する環境を作れます。
共有環境の設定は、メンバーには読み取り専用の概要として表示されます(公式ドキュメント)。
共有環境のセッションに読ませたくないキーは、環境変数ではなくネットワークシークレットで渡します。
公式ドキュメントも、全メンバーのセッションが環境変数を読むので、変数にシークレットを入れないよう案内しています(公式ドキュメント)。
環境を不要にしたいときは、削除ではなくアーカイブを使います。
アーカイブしても、実行中のセッションの環境にはネットワークシークレットが残るので、先に不要なものを削除します(公式ドキュメント)。
よくある質問(FAQ)
- Q1. Claude Codeのクラウド環境とは何ですか。
- クラウドセッションが動く実行環境の設定です。ネットワークアクセス、環境変数、ネットワークシークレット、セットアップスクリプトを設定できます(公式ドキュメント)。
- Q2. どのプランで使えますか。
- Pro、Max、Ultra、Teamと、premium seatかChat + Claude Code seatを持つEnterpriseユーザーが対象です(公式ドキュメント)。
- Q3. 依存関係はどこで入れればよいですか。
- 入っていないツールチェーンはセットアップスクリプトで入れます。npm install のようなプロジェクトの準備は、SessionStartフックが向いています(公式ドキュメント)。
- Q4. セットアップスクリプトが長いと何が起きますか。
- 全体が約5分を超えると、環境がキャッシュされません。独立した処理は並列に走らせるのが公式の案内です(公式ドキュメント)。
- Q5. APIキーは環境変数に入れてもよいですか。
- 環境を使う人なら誰でも環境変数の値を読めます。プロキシが付けられるキーは、ネットワークシークレットに入れるのが公式の案内です(公式ドキュメント)。
- Q6. ネットワークシークレットの値は、あとから確認できますか。
- 保存後に値を再表示することはできません。変えたい場合は削除して、追加し直します(公式ドキュメント)。
- Q7. GitHubにもシークレットが必要ですか。
- 必要ありません。GitHubへの操作は専用のGitHubプロキシが認証します(公式ドキュメント)。
読み終わったら、手元に残す
Claude Code・Codex 最初の安全設定と仕事の渡し方
中身
- 最初に決める6項目(契約・場所・権限・承認・使用量・検収)
- Claude Code と Codex の操作の違い
- 最初の仕事を小さく渡す方法
LINE を友だち追加して「AIエージェント設定」と送ると、無料で届きます。
LINEで「AIエージェント設定」を受け取るまとめ
Claude Codeのクラウド環境は、ネットワーク、環境変数、ネットワークシークレット、セットアップスクリプトの4つで整えます。
依存関係は、ツールチェーンならセットアップスクリプト、プロジェクトの準備ならSessionStartフックに分けます。
APIキーは、環境変数ではなくネットワークシークレットに入れると、セッションに値を見せずに使えます。
設定の細部は更新されることがあるため、実際に設定する前に公式ドキュメントで最新の記載を確認してください(確認日は2026年11月7日)。
あわせて読みたい・姉妹メディア

