sandbox.network
object記述場所どの設定ファイルでも可サンドボックス化された Bash 環境のネットワーク分離設定を構成します。
含まれる設定
11件- allowAllUnixSocketsbooleanすべてのUnixドメインソケット接続を許可します。
- allowedDomainsstring[]サンドボックス内のコマンドに許可するネットワークドメインのホワイトリストで、ワイルドカードパターンをサポートしています。
- allowLocalBindingbooleanローカルネットワークアドレス(localhostのポートなど)へのバインドを許可します。
- allowMachLookupstring[]macOS専用の設定で、iOSシミュレーターやPlaywrightなどのXPCを介して通信するツールに必要な追加のMachサービス名の検索を許可します。
- allowManagedDomainsOnlyboolean管理設定で有効な場合、ユーザーやプロジェクトの設定を無視して管理設定の許可ドメインのみを適用し、未許可ドメインへのアクセスをプロンプトなしで自動ブロックします。
- allowUnixSocketsstring[]ローカルIPC(SSHエージェントやDockerなど)に使用するUnixドメインソケットへのアクセスを、特定のパスの配列で許可します。
- deniedDomainsstring[]サンドボックス化されたコマンドに対するネットワークドメインの拒否リストで、広範な許可設定よりも優先して特定のドメインをブロックします。
- httpProxyPortintegerネットワークフィルタリングに使用するHTTPプロキシのポートを指定します。
- socksProxyPortintegerネットワークフィルタリングに使用するSOCKSプロキシのポートを指定します。
- strictAllowlistbooleanサンドボックス内で許可リストに含まれないホストへのアクセスを、ユーザーへの問い合わせなしで拒否するための設定です。
tlsTerminateobject実験的機能として、サンドボックスプロキシ内で TLS を終端して HTTPS リクエストの内容を読み取ります。(2件)
- caCertPathstringサンドボックス環境内で TLS を終端し、HTTPS リクエストの中身を読み取れるようにするための認証局証明書(CA)のパスを指定します。
- caKeyPathstringTLS 終端時に利用する認証局のプライベートキーのパスを指定します。
記述例
{
"sandbox": {
"network": {
"allowedDomains": ["github.com", "*.npmjs.org"],
"deniedDomains": ["uploads.github.com"],
"allowLocalBinding": true
}
}
}使い方・用途
sandbox.network.allowDomainsで許可するドメインを指定するsandbox.network.strictAllowlistをtrueに設定して厳格なホワイトリストモードにするsandbox.network.tlsTerminateを設定して TLS を終端し、HTTPS リクエストの内容を読み取る
Configures network isolation settings for the sandboxed bash environment, including domain restrictions, Unix socket access, and custom proxy configuration.
関連する変更履歴
v2.1.319(2件)
CLAUDE_CODE_PROXY_RESOLVES_HOSTS の挙動を変更した:ホストがネットワークを管理している環境では設定ファイルから設定できなくなり、プロセスの環境変数で設定する必要がある英語原文を表示英語原文を閉じる
CLAUDE_CODE_PROXY_RESOLVES_HOSTS so that settings files can no longer set it where the host manages the network; set it in the process environmentv2.1.318(6件)
/logout、claude auth logout、claude mcp remove が成功と報告したり、trust・consent・MCP 設定の変更が黙って破棄されたりする問題を修正した英語原文を表示英語原文を閉じる
/logout, claude auth logout and claude mcp remove reporting success, and changes to trust, consent or MCP settings being dropped with no word, when the config file could not be updated on a shared network home directory英語原文を表示英語原文を閉じる
~/.claude.json、設定ファイル、保存されたログイン情報が、共有ネットワークホームディレクトリ上での保存時に破損しにくくなるよう改善した。削除されたり、一時的に空になったり、ほぼ空の古いコピーで置き換えられる頻度が減っている英語原文を表示英語原文を閉じる
~/.claude.json, settings files and the stored login survive saves on shared network home directories: they are less often deleted, briefly emptied or replaced by a near-empty or older copy変更後
共有ネットワークホームディレクトリ環境でも、~/.claude.json や設定ファイル、ログイン情報が保存時に消失したり空になったり古い内容で上書きされたりしにくくなり、設定や認証が安定して維持できるようになる
英語原文を表示英語原文を閉じる
変更後
ネットワークファイルシステム上で設定ファイルが一時的に見つからないと誤検出されても再確認するため、MCPサーバーや信頼済みフォルダの読み込みに失敗するセッションが減る。
英語原文を表示英語原文を閉じる
変更後
リリースの検証中に一時的なネットワーク障害が発生しても、即座に再試行されるため、次の自動更新チェックを待つことなくアップデートを完了できる。
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
サーバーやネットワークの一時的なエラーが発生しても自動で再試行し、それでも失敗した場合には空のカードではなく「再試行」バナーが表示されるため、Code Review のアナリティクスページを安定して確認できる。
v2.1.317(5件)
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
Claude apps ゲートウェイに起動時に接続できない場合のエラーが、サインインではなくネットワークの問題を指し示すようになり、原因の切り分けがしやすくなった。また、ゲートウェイの TLS 証明書を検証できないときはその旨が表示されるため、企業プロキシ環境などでの CA 証明書の設定漏れにも気づきやすくなる。
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
v2.1.316(2件)
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
変更後
Enterprise メンバーも自分のクラウド環境にネットワークシークレットを追加・削除できるようになり、Owner に依頼せず自分で認証情報を管理できるようになった。シークレットの追加や更新のたびに管理者に問い合わせる手間が減る。
v2.1.312(2件)
英語原文を表示英語原文を閉じる
変更後
クラウドセッションで WebFetch が名前解決できないホストに失敗したとき、そのホストが許可されたネットワークドメインの外にある可能性があることが示され、許可すべきドメイン名が具体的に表示されるため、原因が分かりにくかったエラーからすぐに許可設定を判断できる。
英語原文を表示英語原文を閉じる
v2.1.311(2件)
英語原文を表示英語原文を閉じる
関連ドキュメント
英語原文を表示英語原文を閉じる
v2.1.310(1件)
英語原文を表示英語原文を閉じる
変更後
クラウド環境の設定ダイアログが整理され、ネットワークアクセス・セットアップスクリプト・環境変数を個別の行から開けるようになり、設定項目を見つけやすく編集しやすくなる。
v2.1.305(1件)
英語原文を表示英語原文を閉じる
変更後
セッションが時間内に開始できずフックも動いていない場合のメッセージで、出力ログが先に表示され、原因が一覧で確認できるため、ログインやネットワーク問題と誤認して無関係な対処を試す前に、フック出力など実際の原因をすばやく特定できるようになる。
関連ドキュメント
v2.1.304(1件)
/privacy-settings があなたに適用されない可能性のある選択肢を提示する問題を修正した。英語原文を表示英語原文を閉じる
/privacy-settings offering choices that may not apply to you after a network or server errorv2.1.300(1件)
英語原文を表示英語原文を閉じる
関連ドキュメント
v2.1.299(1件)
--debug、--debug-file)によるメモリ増大、およびデバッグログの出力先が書き込みを受け付けなくなるディスクやネットワークマウント上にある場合の終了時ハングを修正した。英語原文を表示英語原文を閉じる
--debug, --debug-file), and a hang on exit when the debug log is on a disk or network mount that stops accepting writesv2.1.295(1件)
英語原文を表示英語原文を閉じる
関連ドキュメント
v2.1.292(1件)
英語原文を表示英語原文を閉じる
変更後
ネットワークパス (UNC パス) からのファイル読み取りについて、PreToolUse フックの承認や自動モードによって権限確認をスキップされなくなります。そのため、意図しないネットワーク上のホストへのアクセスや認証情報の漏洩リスクを抑えながら、ファイル読み取り時に必ず確認を受け取れるようになります。
v2.1.290(1件)
英語原文を表示英語原文を閉じる
変更後
ネットワークプロキシ配下でも、MCP サーバーの起動がブロック(HTTP 403)された際に無駄な再試行が行われず、起動がすぐに完了する。
v2.1.287(1件)
英語原文を表示英語原文を閉じる
変更後
クラウドセッションや Remote Control で Claude がファイルを送る際に、タイムアウト・ネットワークエラー・502/503/504 でアップロードが失敗しても自動的に 1 回再試行されるため、一時的な障害でファイルの共有が途中で止まりにくくなる。
v2.1.286(3件)
英語原文を表示英語原文を閉じる
変更後
claude.ai のアーティファクトへのリンクを WebFetch で読む場合も、Artifact ツールでの読み取りと同じ質問が行われるようになり、ネットワークアクセスの有無にかかわらず確認フローが一貫する。また、自動モードでの承認が自分だけが答えられる場面でカウントされなくなるため、意図しない承認の流用を防げる。
英語原文を表示英語原文を閉じる
変更後
fetch、skill、ファイル読み取り、サンドボックスのネットワーク、Claude in Chrome、workflow スクリプト、ノートブック編集の権限確認ダイアログが、ファイル編集時のものと同じ見た目に統一され、どの種類の操作を承認するのかを一貫した形式で確認できる。
claude-api スキルの Managed Agents の例を、ネットワークを制限した環境を作成するように変更した英語原文を表示英語原文を閉じる
claude-api skill's Managed Agents examples to create environments with limited networkingv2.1.285(2件)
英語原文を表示英語原文を閉じる
関連ドキュメント
英語原文を表示英語原文を閉じる
v2.1.284(2件)
/claude-api を改善した。hillclimb が eval で測定できないほど小さなプロンプトの言い換えにラウンドを費やさなくなり、report.html 以外に追加で要求したページもネットワークから何も読み込まない単一のローカルファイルとして構築される英語原文を表示英語原文を閉じる
/claude-api: hillclimb no longer spends rounds on prompt rewordings too small for the eval to measure, and an extra page you ask for beside report.html is built as one local file that loads nothing from the network変更後
/claude-api の hillclimb では、評価で差が出ないほど小さなプロンプトの言い換えにラウンドを浪費せず、実質的な改善に集中できる。また、report.html と一緒に追加ページを要求した場合もネットワーク接続なしで開けるローカルファイルとして生成されるため、オフライン環境でもレポートを共有・閲覧できる。
関連ドキュメント
` host share パスや /net オートマウント)を拒否するように変更した。ただし --add-dir` で追加したマウント済みネットワークドライブ上のファイルは除く。英語原文を表示英語原文を閉じる
\\host\share path or a /net automount) unless it is on a mapped network drive added with --add-dir変更後
ネットワーク共有上のファイルを公開しようとしてホストへのアクセスや認証情報の送信が起こるのを防ぎ、セキュリティ上の安全な形でアーティファクトを公開できるようにする。Windows でマップ済みドライブを --add-dir で渡しておけば、共有上のファイルからもそのまま公開できる。
関連ドキュメント
v2.1.281(5件)
英語原文を表示英語原文を閉じる
/.vol、/.nofollow、/.resolve(ネットワークマウントに到達しうる)配下のパスについて、権限ダイアログや添付ファイルのチェックが承認前に読み取ってしまう問題を修正した英語原文を表示英語原文を閉じる
/.vol, /.nofollow or /.resolve (which can reach a network mount) before approval英語原文を表示英語原文を閉じる
sandbox.network.allowLocalBinding を指し示すようにした英語原文を表示英語原文を閉じる
sandbox.network.allowLocalBinding変更後
macOS のサンドボックス内でローカル開発サーバーがポートをバインドできずに失敗したとき、原因と解決策が分からず戸惑っていた状況でも、sandbox.network.allowLocalBinding の設定で解決できることがすぐに分かり、スムーズに問題を解消できる。
英語原文を表示英語原文を閉じる
v2.1.277(2件)
英語原文を表示英語原文を閉じる
関連ドキュメント
英語原文を表示英語原文を閉じる
v2.1.275(1件)
API Error: 400 が発生する問題を修正した英語原文を表示英語原文を閉じる
API Error: 400 on every turn for users behind a network gateway that rewrites API error responses when a beta request header is rejectedv2.1.274(1件)
英語原文を表示英語原文を閉じる
関連ドキュメント
v2.1.273(1件)
--add-dir でマップドネットワークドライブを追加した際の UNC パスに対するネットワークパス権限チェックを改善した英語原文を表示英語原文を閉じる
--add-dir変更後
--add-dir でマップ済みネットワークドライブを追加した場合、そのドライブ経由の UNC パスについて、不要な拒否や余分な権限プロンプトが発生しにくくなり、ネットワーク共有上のファイルをスムーズに扱えるようになる。
v2.1.271(3件)
英語原文を表示英語原文を閉じる
変更後
ネットワークが不安定な環境でセットアップに失敗しても、claude.ai 上に空のセッションが残りにくくなり、セッション一覧を整理しやすくなる。
関連ドキュメント
英語原文を表示英語原文を閉じる
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
組織の管理者が、管理設定のクラウド環境エディターで Custom ネットワークアクセスを選択し、許可ドメインのリストを自由に設定できるようになる。共有環境で claude.ai/code の環境ダイアログが読み取り専用の場合でも、管理設定から独自ドメインへの接続を許可できる。
関連ドキュメント
v2.1.269(1件)
/goal の実行が静かに停止する問題を修正した。ゴール処理はバックオフ付きで再試行するか、一時停止して理由を説明するようになり、使用制限がリセットされるまで待機することも含まれる英語原文を表示英語原文を閉じる
/goal runs silently stalling after API errors, network drops, or token limits: the goal now retries with backoff, or pauses and says why, including until a usage limit resetsv2.1.257(4件)
example.com.)問題を修正した。deniedDomains エントリがサンドボックス内のホストをブロックせず、そのようなホストの「次回から確認しない」を選んでも確認が続いていた英語原文を表示英語原文を閉じる
example.com.): a deniedDomains entry didn't block the host inside the sandbox, and "don't ask again" for such a host kept prompting/login を提案するようになった英語原文を表示英語原文を閉じる
/login instead of reporting a network error英語原文を表示英語原文を閉じる
--add-dir、/add-dir、additionalDirectories が、ネットワークパス(UNC 共有、/net/<host> のオートマウント)に触れる前にメッセージとともに拒否するように変更した。Windows ではマップ済みドライブレターを使用する英語原文を表示英語原文を閉じる
--add-dir, /add-dir, and additionalDirectories to refuse network paths (UNC shares, /net/<host> automounts) with a message before touching them; on Windows use a mapped drive letter変更後
ネットワークパスが作業ディレクトリに登録される前に拒否されるため、パスの参照によってホストへの意図しない接続や Windows での資格情報の送信を避けられる。
関連ドキュメント
v2.1.251(1件)
英語原文を表示英語原文を閉じる
変更後
クラウドセッションのBashコマンド実行中にネットワーク接続が切断されても、どのホストで・どんな理由で失敗したのかがツール結果に表示されるため、接続問題の原因をすぐ特定して対処できる。
v2.1.247(1件)
英語原文を表示英語原文を閉じる
変更後
ネットワークパスやオートマウンタへのリンク、制御文字や不可視文字を含むリンク先が、意図せずクリック可能なハイパーリンクとして表示されなくなります。危険なパスや見えない文字が仕込まれたリンクを誤って開いてしまうリスクを減らせます。
v2.1.243(2件)
curl がプロキシの 403 ページを表示する場合)、Bash ツールの結果からサンドボックスのネットワーク違反の詳細が欠落する問題を修正した。英語原文を表示英語原文を閉じる
curl printing the proxy's 403 page)英語原文を表示英語原文を閉じる
変更後
サンドボックス化された Bash コマンドでも、許可リストにないホストへのリクエストを拒否前提とせずに実際に試みるようになったため、新しいホストにアクセスする際にその都度承認を求められるだけで済み、必要なホストを柔軟に許可できるようになる。
v2.1.239(1件)
英語原文を表示英語原文を閉じる
変更後
Claude Code on the web で、Bash などのツールから www.anthropic.com や docs 先の anthropic.com ホストへのリクエストがセッションのネットワークプロキシを経由するようになり、環境で設定した許可ドメインのポリシーがこれらのリクエストにも適用される。これにより、anthropic.com 関連のホストが例外扱いにならず、環境全体で一貫したネットワークアクセス制御が行き渡る。
関連ドキュメント
v2.1.238(3件)
英語原文を表示英語原文を閉じる
関連ドキュメント
英語原文を表示英語原文を閉じる
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
VPN やプロキシなどが一時的に HTTP 403 で拒否しても、Remote Control のセッションが最大 3 分間は自動的に再接続を試みるため、短いネットワーク変更でセッションが切れなくなります。拒否が続いた場合も、通信を妨げているのがネットワーク境界なのかプロキシ・VPN・ファイアウォールなのかがエラーで分かるようになります。
v2.1.234(1件)
英語原文を表示英語原文を閉じる
v2.1.232(1件)
英語原文を表示英語原文を閉じる
変更後
一時的なネットワーク断が発生しても、最大約30分間自動的に再接続を試みるため、外に出たりネットワークが不安定になったりしても Remote Control セッションが切れず、スマホやブラウザから中断せずに操作を続けられる。
関連ドキュメント
v2.1.229(2件)
英語原文を表示英語原文を閉じる
[::1]:443)に修正するとともに、曖昧なスペルのドメイン指定は安全側に倒して拒否(fail-closed)し、/doctor コマンドでフラグを立てるよう改善しました。英語原文を表示英語原文を閉じる
[::1]:443), and ambiguous spellings are enforced fail-closed and flagged by /doctor変更後
サンドボックスの通信制御設定ミスによる意図しない外部ネットワーク漏洩を未然に防ぐことができます。
v2.1.224(2件)
extractおよびonExtractNoMatch、JWTトークン用のdecode: "jwt"(およびmaskClaims)、AWS SigV4再署名用のawsPairs/sigv4が利用できるようになります。これらを使用するには、network.tlsTerminateが有効であり、かつユーザー設定、管理者管理設定、または--settingsフラグでのみ指定されている必要があります。英語原文を表示英語原文を閉じる
extract and onExtractNoMatch for structured env values, decode: "jwt" with maskClaims for JWT-aware masking, and awsPairs/sigv4 for AWS SigV4 re-signing; these need network.tlsTerminate and are honored only from user, managed, or --settings settings変更後
ツールに必要な認証情報の利便性を損なうことなく、認証ファイルやトークン内の本当に保護すべき重要な情報だけを確実に隠蔽または安全に中継できるようになります。
英語原文を表示英語原文を閉じる
v2.1.219(1件)
sandbox.network.strictAllowlist 設定を追加しました。サンドボックス環境から許可されていないホストへのアクセスを警告なしで拒否します。英語原文を表示英語原文を閉じる
sandbox.network.strictAllowlist setting to deny non-allowlisted hosts for sandboxed commands without prompting変更後
許可リストを定義するだけで安全な通信環境を維持できます。
関連ドキュメント
v2.1.218(1件)
英語原文を表示英語原文を閉じる
変更後
企業内のセキュアなネットワーク環境下でも問題なくBedrockを起動できます。
v2.1.216(2件)
sandbox.filesystem.disabled を追加英語原文を表示英語原文を閉じる
sandbox.filesystem.disabled setting to skip filesystem isolation while keeping network egress control変更後
ファイルシステム隔離の制限を気にせず、ネットワーク環境の制約がある場所での操作を完結できます。
関連ドキュメント
英語原文を表示英語原文を閉じる
v2.1.214(1件)
英語原文を表示英語原文を閉じる
変更後
デバッグ時に不要なノイズに悩まされることがなくなります。
v2.1.210(1件)
英語原文を表示英語原文を閉じる
変更後
Windows 環境でプラグインのインストールや更新が失敗して環境が汚れる心配がなくなります。
v2.1.207(1件)
英語原文を表示英語原文を閉じる
変更後
移動中や外出先からでも、AIの作業進捗をリアルタイムで安心して見守ることができます。
v2.1.206(1件)
英語原文を表示英語原文を閉じる
awsCredentialExport helper on networks with restricted egress変更後
セキュリティの厳しいエンタープライズ環境でも、待ち時間なしで作業を開始できます。
v2.1.202(1件)
英語原文を表示英語原文を閉じる
変更後
不安定なネットワーク環境下でも、安定して最新版への更新を行うことができます。
関連ドキュメント
v2.1.198(3件)
英語原文を表示英語原文を閉じる
変更後
不安定なネットワーク環境下でもセッションを安定して継続でき、やり直しの手間が減ります。
関連ドキュメント
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
v2.1.191(3件)
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
tools/list, prompts/list, resources/list) now retries transient network errors with short backoff変更後
MCPツール経由のデータ取得がより安定し、エラー対応の手間が減ることで作業を中断せずに進められます。
関連ドキュメント
英語原文を表示英語原文を閉じる
変更後
サーバー環境やSSH接続などのヘッドレス環境でもMCP認証がスムーズに完了できるようになり、導入のハードルが下がります。
関連ドキュメント
v2.1.181(2件)
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
v2.1.176(1件)
英語原文を表示英語原文を閉じる
v2.1.157(1件)
英語原文を表示英語原文を閉じる
変更後
完全なハンズフリー操作が可能になり、エージェントによる一連の作業がよりスムーズに進むようになります。
v2.1.147(1件)
英語原文を表示英語原文を閉じる
変更後
ツールの更新作業がより堅牢になり、問題が発生した際のデバッグやサポートへの問い合わせがスムーズに行えるようになります。
関連ドキュメント
v2.1.146(1件)
英語原文を表示英語原文を閉じる
v2.1.142(1件)
claude agents がデッドロックする問題を修正英語原文を表示英語原文を閉じる
claude agents deadlocking on Windows with network-drive working directories; Ctrl+C now works during startup変更後
共有ドライブや特定の開発インフラを使用している Windows ユーザーも、バックグラウンド機能を安定して利用できます。
関連ドキュメント
v2.1.133(1件)
英語原文を表示英語原文を閉じる
--add-dir / SDK additionalDirectories変更後
共有サーバーや外部ストレージ上にプロジェクト資産がある場合でも、Claude Code を制限なく利用できるようになります。
関連ドキュメント
v2.1.113(1件)
sandbox.network.deniedDomains 設定を追加しました英語原文を表示英語原文を閉じる
sandbox.network.deniedDomains setting to block specific domains even when a broader allowedDomains wildcard would otherwise permit them変更後
広域な許可を与えつつ、特定の機密ドメインや不要なドメインへのアクセスを確実に遮断できるため、セキュリティが向上します。
関連ドキュメント
v2.1.111(1件)
英語原文を表示英語原文を閉じる
変更後
インターフェースがより整理され、不要な警告に惑わされることなく開発に集中できます。
関連ドキュメント
v2.1.105(1件)
英語原文を表示英語原文を閉じる
v2.1.98(1件)
sandbox.network.allowMachLookup の設定が有効に機能していなかった問題を修正しました。英語原文を表示英語原文を閉じる
sandbox.network.allowMachLookup not taking effect on macOS変更後
安全性を保ちつつ、シミュレータの操作やOS機能を利用したテストなどの開発作業をサンドボックス内で完結できます。
v2.1.97(3件)
英語原文を表示英語原文を閉じる
英語原文を表示英語原文を閉じる
sandbox.network.allowMachLookupが有効に機能するように改善しました。英語原文を表示英語原文を閉じる
sandbox.network.allowMachLookup now takes effect on macOS変更後
macOS上でのエージェントの動作をより安全に、かつ意図した範囲内に制限でき、セキュリティリスクを低減できます。
v2.1.81(1件)
英語原文を表示英語原文を閉じる
v2.1.53(1件)
英語原文を表示英語原文を閉じる
v2.1.49(1件)
英語原文を表示英語原文を閉じる
変更後
開発者は、MCPを利用したツール連携の認証プロセスをより迅速かつスムーズに行えるようになります。認証の待ち時間が減り、全体的な開発体験が向上することで、より効率的に作業を進めることができます。
関連ドキュメント