sandbox.credentials

settings.json型object記述場所どの設定ファイルでも可

サンドボックス化されたコマンドから認証ファイルとシークレット環境変数の読み取りをブロックします。

含まれる設定

5件
  • allowPlaintextInjectbooleanマスクされた認証情報の置換を、TLS 終端された HTTPS だけでなくプレーンテキストの HTTP リクエストに対しても許可します。
  • awsPairsobject[]クレデンシャルが非標準の名前の環境変数にある場合に、SigV4 再署名用の 1 つの AWS クレデンシャルを構成するマスク済み環境変数をグループ化する。
  • envVarsobject[]サンドボックス化されたコマンドに対して、環境変数から削除する秘匿情報の変数名を指定します。
  • filesobject[]サンドボックス化されたコマンドから隠蔽する、認証情報ファイルのパスを指定します。
  • sigv4objectサンドボックスプロキシが再署名できない AWS リクエスト形式をどう扱うかを選択する。

記述例

{
  "sandbox": {
    "credentials": {
      "files": [{ "path": "~/.aws/credentials", "mode": "deny" }],
      "envVars": [{ "name": "GITHUB_TOKEN", "mode": "deny" }]
    }
  }
}

使い方・用途

  • sandbox.credentials.files で保護するファイルパスを指定し、mode を deny または mask に設定する
  • sandbox.credentials.envVars で保護する環境変数名を指定する
  • 無効なエントリは自動的に削除され、有効なエントリは引き続き適用される
英語原文

Block sandboxed commands from reading credential files and secret environment variables (v2.1.187+). Entries merge across settings scopes. See https://code.claude.com/docs/en/sandboxing#protect-credentials

関連する変更履歴

v2.1.318(1件)

Gateway: フェデレーション(external_account)クレデンシャルファイルに含まれる Google アクセストークンの有効期限が近づいた際に、ログへ警告を出力するようにした。
英語原文を表示
Gateway: Added a log warning when the Google access token from a federation (external_account) credentials file is about to expire

変更後

Google Cloud の Workload Identity Federation(external_account)認証情報ファイルを使っている場合、アクセストークンの有効期限が切れそうになったときに Gateway がログで警告を出すため、401 エラーによるジョブの失敗に気づく前にトークンを更新できる。

関連ドキュメント

v2.1.317(2件)

stdio MCP サーバーが環境設定で空文字列に設定された AWS_BEARER_TOKEN_BEDROCK を受け取ってしまう問題を修正した。現在は変数を未設定にすることで、サーバーがマシンの AWS 認証情報をそのまま使用できるようにした
英語原文を表示
Fixed stdio MCP servers receiving an empty AWS_BEARER_TOKEN_BEDROCK when their env config sets it to empty; the variable is now unset, so the server can use the machine's own AWS credentials

関連ドキュメント

Azure 認証情報が読み込めない場合に Microsoft Foundry で表示されるエラーを改善した。認証情報の確認または更新を促すメッセージが表示されるようになり、エラーは cloud_credential_error として報告される
英語原文を表示
Improved the error shown on Microsoft Foundry when Azure credentials can't be loaded: it now says to check or refresh them, and reports as cloud_credential_error

変更後

Microsoft Foundry で Azure 資格情報を読み込めなかった場合に、原因がわからず戸惑うことなく、資格情報の確認や再取得という対処方法がすぐにわかるようになる。また、エラーが cloud_credential_error として報告されるため、他の種類のエラーと区別して問題を把握しやすくなる。

v2.1.316(1件)

Claude Code が単独で終了したとき(資格情報が拒否された場合やクラウドセッションがアーカイブされた場合など)、macOS と Linux でシェルコマンドが実行されたまま残る問題を修正した
英語原文を表示
Fixed shell commands being left running on macOS and Linux when Claude Code exits by itself, for example when credentials are refused or a cloud session is archived

v2.1.314(1件)

Anthropic プロファイルログインを複数セッションで共有し、認証情報ロックがビジー状態のときに、サインインの更新が余分に行われる問題を修正
英語原文を表示
Fixed extra sign-in renewals when several sessions share an Anthropic profile login and the credentials lock is busy

v2.1.311(1件)

Claude Code が認証情報を送信していないリモートサーバーに対して /mcp が「authenticated」と表示する問題を修正した
英語原文を表示
Fixed /mcp showing "authenticated" for a remote server that Claude Code sends no credentials to

関連ドキュメント

v2.1.299(1件)

Self-hosted runner: ランナーのマシンに git 認証情報がない場合の setup と doctor のメッセージ内容を改善した
英語原文を表示
Self-hosted runner: Improved what setup and doctor say when the runner's machine has no git credentials

変更後

セルフホストランナーのマシンに git 資格情報が設定されていない場合でも、setup や doctor の出力からすぐにそのことが分かるようになり、セッションが git エラーで失敗する原因の特定に時間がかからなくなる。

v2.1.290(2件)

claude auth login の実行後や、設定ディレクトリに認証情報ファイルが既に存在する場合に、初回起動時にログイン方法の選択を再度求める問題を修正した。
英語原文を表示
Fixed first launch asking to pick a login method again after claude auth login or with a credentials file already in the config directory
Claude アプリゲートウェイのログを改善し、上流のクラウド認証情報や接続に失敗した際の警告が、根本的な原因で終わるようにした。
英語原文を表示
Improved the Claude apps gateway's log when an upstream's cloud credentials or connection fail: the warning now ends with the underlying cause

変更後

クラウドの認証情報や接続が上流で失敗した場合のログに、その失敗の根本原因まで表示されるようになり、トラブル発生時に原因を素早く特定できる。

関連ドキュメント

v2.1.288(3件)

認証情報をセキュアストレージに保存できなかったにもかかわらず /login が 'Login successful' と報告する問題を修正した。失敗を表示するようになり、新しいログインが反映されていない場合は再試行を提案する(anthropics/claude-code#73861)
英語原文を表示
Fixed /login reporting "Login successful" when credentials could not be saved to secure storage; it now shows the failure, and offers a retry when the new login didn't take effect (anthropics/claude-code#73861)
permissions.blockReadsOutsideWorkingDirectories が有効な間、git 設定ファイルに対する sandbox.credentials.files のエントリが効かない問題を修正した
英語原文を表示
Fixed sandbox.credentials.files entries on git config files not taking effect while permissions.blockReadsOutsideWorkingDirectories is on
--bare セッション内の /login が、セッションが読み取らないサインインを実行し、保存済みのログインを置き換えてしまうことがある問題を修正した。どの認証情報が有効かを表示するようになった
英語原文を表示
Fixed /login in a --bare session running a sign-in the session never reads, which could replace your saved login; it now says which credentials work

関連ドキュメント

v2.1.287(1件)

ツール全体に対する Bash の allow ルールと許可フックについて、Claude Code のファイルツールが完全に拒否するファイル(Anthropic プロファイルストア、ホストの認証情報ファイル)へのシェル書き込みを実行ではなくプロンプトで確認するように変更しました
英語原文を表示
Changed whole-tool Bash allow rules and allowing hooks to prompt for, not run, shell writes to files Claude Code's file tools refuse outright (the Anthropic profile store, the host credentials file)

変更後

Bash 全体を許可するルールや許可フックがあっても、Claude Code のファイルツールが直接書き込みを拒否するファイル(Anthropic プロファイルストアやホストの認証情報ファイル)へのシェルによる書き込みは実行されず、確認を求められるようになった。こうした機密性の高いファイルが広範な許可設定によって意図せず書き換えられるのを防げる。

v2.1.286(2件)

gcpAuthRefresh や awsAuthRefresh の認証情報が期限切れになったとき、複数の Claude Code プロセスや IDE 拡張機能がそれぞれログイン用ブラウザを開いてしまう問題を修正した
英語原文を表示
Fixed several Claude Code processes and IDE extensions each opening a login browser when gcpAuthRefresh or awsAuthRefresh credentials expire
残存した ~/.claude/.credentials.json がある場合に、別の Claude Code ウィンドウで /login が成功した後も macOS のセッションで「Not logged in」や「Login expired」が表示され続ける問題を修正した
英語原文を表示
Fixed macOS sessions still showing "Not logged in" or "Login expired" after /login succeeds in another Claude Code window when a leftover ~/.claude/.credentials.json exists

v2.1.284(2件)

Claude アプリゲートウェイの telemetry.forward_to 送信先に auth: { google: {} } を追加した。ゲートウェイの Google Cloud 認証情報を使って、テレメトリを Google Cloud の OTLP エンドポイントに直接エクスポートできる。
英語原文を表示
Added auth: { google: {} } for Claude apps gateway telemetry.forward_to destinations, so telemetry can be exported straight to Google Cloud's OTLP endpoint using the gateway's Google Cloud credentials

変更後

Claude apps gateway の telemetry.forward_to に auth: { google: {} } を指定できるようになり、ゲートウェイが持つ Google Cloud の認証情報を使ってテレメトリを Google Cloud の OTLP エンドポイントへ直接エクスポートできる。サービスアカウントの JSON キーファイルを別途用意・管理することなく、Google Cloud 上のテレメトリ基盤にメトリクスやトレースを送れるようになる。

Claude アプリゲートウェイとその ID プロバイダー間の証明書クライアント認証(private_key_jwt)を追加した。クライアントシークレットの代わりに証明書認証情報を発行する ID プロバイダーに対応する。
英語原文を表示
Added certificate client authentication (private_key_jwt) between the Claude apps gateway and its identity provider, for identity providers that issue certificate credentials instead of client secrets

変更後

クライアントシークレットではなく証明書認証情報を発行するアイデンティティプロバイダー(例: Microsoft Entra の証明書認証情報)でも、Claude アプリゲートウェイとの間で private_key_jwt による認証を設定できるようになる。

v2.1.274(1件)

[Claude Code on the web] セッションの認証情報更新後の数分間、クラウドセッションでのコミットが署名エラーでまれに失敗する不具合を修正した
英語原文を表示
[Claude Code on the web] Fixed commits in cloud sessions occasionally failing with a signing error for a few minutes after the session's credentials refreshed

関連ドキュメント

v2.1.273(1件)

[Claude Tag] 小文字のトークンタイプを返すプロバイダーで、OAuth client-credentials や JWT-bearer 接続が失敗する問題を修正した。リクエストは標準の Bearer スキームを送信するようになった
英語原文を表示
[Claude Tag] Fixed OAuth client-credentials and JWT-bearer connections failing with providers that return a lowercase token type; requests now send the standard Bearer scheme

v2.1.267(1件)

Claude Desktop などのホストアプリ配下で AWS や Google Cloud の認証情報が期限切れになった際、汎用的な「リクエスト失敗」エラーで 10 回再試行してから再認証エラーが表示される問題を修正した。
英語原文を表示
Fixed expired AWS or Google Cloud credentials under a host app such as Claude Desktop retrying ten times with a generic "request failed" before the re-authenticate error appeared

v2.1.257(4件)

strictPluginOnlyCustomization で MCP をプラグイン専用サーバーに限定している場合に、claude mcp remove を実行してもリモートサーバーの保存済み OAuth 認証情報が残り続ける問題を修正した
英語原文を表示
Fixed claude mcp remove leaving a remote server's stored OAuth credentials behind when strictPluginOnlyCustomization locks MCP to plugin-only servers
セッション起動時にネットワークプロキシの起動に失敗すると、クラウドセッションがセッション中ずっと git/GitHub 認証情報を失う問題を修正した。バックグラウンドで再試行して復旧するようになった
英語原文を表示
Fixed cloud sessions losing git/GitHub credentials for the rest of the session when the session's network proxy failed to start at launch; it now retries in the background and recovers
MCP 接続および OAuth のデバッグ/エラーログを改善し、サーバーの URL やリクエストヘッダーに含まれる認証情報がマスクされるようにした
英語原文を表示
Improved MCP connection and OAuth debug/error logs so credentials carried in a server's URL or request headers are redacted

変更後

デバッグやエラーログを確認しても、認証情報が漏れる心配なく安心して共有・保管できるようになる。

関連ドキュメント

managedSourcesBehavior: 'merge' の挙動を変更し、sandbox.credentials.awsPairs と sandbox.ripgrep についてソース間の値を合成する代わりに、それらを設定している最上位の管理ソースからの値を丸ごと採用するようになった
英語原文を表示
Changed managedSourcesBehavior: "merge" to take sandbox.credentials.awsPairs and sandbox.ripgrep whole from the highest managed source that sets them instead of combining the sources' values

変更後

managedSourcesBehavior: 'merge' を使う場合、sandbox.credentials.awsPairs や sandbox.ripgrep が上位の管理ソースの値で一括して決まるようになり、複数ソースの値が混ざって意図しない設定になるのを防げる。

v2.1.251(1件)

サンドボックスの TLS を終端したり、サンドボックスのトラフィックを独自のプロキシ経由にルーティングしたり、認証情報を注入したり、サンドボックスの分離を弱めたりするサーバー管理の設定について、適用前に承認を必要とするように変更した。
英語原文を表示
Changed server-managed settings that terminate sandbox TLS, route sandbox traffic through your own proxy, inject credentials, or weaken sandbox isolation to require approval before they apply

変更後

サーバー管理設定によるサンドボックスの隔離を弱める変更が、管理者の配信後にも利用者の承認なしに適用されないようになり、意図しないTLS端末処理やプロキシ経由のトラフィック迂回からサンドボックス環境を保護できる。

v2.1.248(1件)

コンテナのセッション資格情報がまだ読み取れない場合に、クラウドセッションが起動時に失敗することがある問題を修正した。
英語原文を表示
Fixed cloud sessions occasionally failing at startup when the container's session credentials were not yet readable

v2.1.232(1件)

クラウドセッション内のブリッジがホストする Remote Control セッションが、そのセッションのトランスクリプトやクレデンシャルを継承する問題を修正しました。
英語原文を表示
Fixed Remote Control sessions hosted by a bridge inside a cloud session inheriting that session's transcript or credentials

v2.1.229(1件)

セルフホストランナーの起動時におけるリポジトリ準備処理が、Git Credential Manager(GCM)の認証プロンプト待ちで無期限にハングアップする問題を修正し、認証情報がない場合は git コマンドが即座にエラーで終了するようにしました。
英語原文を表示
Fixed self-hosted runner repository preparation hanging on a Git Credential Manager prompt; git now fails fast when credentials are missing

変更後

リポジトリの認証設定ミスが発生した際、何分もハングアップして待たされることなく、即座に設定漏れを検知できるようになります。

v2.1.228(1件)

Vertex AIの認証処理を改善し、Google Cloud認証情報の期限切れや欠落が発生した際に、数分間リトライし続けるのではなく数秒以内に即時失敗するようにしました。
英語原文を表示
Improved Vertex AI credential handling: expired or missing Google Cloud credentials now fail within seconds instead of retrying for minutes

変更後

認証エラーが起きた際、無駄な待機時間を取られることなく、即座に再ログイン(gcloud auth等)の対処を行うことができるようになります。

v2.1.224(1件)

古いログイン・セッショントークンが残っている状態でコールドスタートした際、Remote Controlの自動起動が「Remote credentials fetch failed」エラーで断続的に失敗する問題を修正しました。
英語原文を表示
Fixed Remote Control auto-start intermittently failing with "Remote credentials fetch failed" on a cold start with a stale login token

変更後

セッション再開時にRemote Controlが謎のエラーで落ちる現象に悩まされず、立ち上げ後すぐにスムーズに開発を再開できるようになります。

v2.1.216(1件)

MCP 再認証時に認証完了前に作業用クレデンシャルが失効する問題と、バックグラウンドセッションの警告を修正
英語原文を表示
Fixed MCP re-authenticate revoking working credentials before the new sign-in succeeds, and the reconnect needs-auth message in background sessions pointing at an unusable command

変更後

認証を更新する際に、接続の中断や無効なコマンド警告に遭遇しなくなります。

関連ドキュメント

v2.1.207(1件)

Bedrockにおいて、APIリクエストのたびにIAM Identity CenterにAWS SSOの新しい認証情報を繰り返し要求してしまう問題を修正しました。
英語原文を表示
Fixed Bedrock repeatedly requesting fresh AWS SSO credentials from IAM Identity Center on every API request

変更後

APIレスポンスが高速化し、頻繁な認証確認による作業の中断がなくなります。

関連ドキュメント

v2.1.187(1件)

サンドボックス設定に sandbox.credentials を追加し、認証情報ファイルや機密環境変数の読み取りをブロック可能に改善
英語原文を表示
Added sandbox.credentials setting to block sandboxed commands from reading credential files and secret environment variables

変更後

セキュリティが強化され、エージェントにコマンド実行を許可した際でも、意図せず重要な認証情報が読み取られるリスクを低減できます。

関連ドキュメント

v2.1.186(1件)

awsAuthRefresh が設定されている場合、/login に「Claude Platform on AWS - 認証情報の更新」オプションが表示されるようになりました。
英語原文を表示
Added "Claude Platform on AWS - refresh credentials" option to /login when awsAuthRefresh is configured

変更後

AWS環境でClaude Codeを利用する開発者が、認証の手間を最小限に抑えつつ、セキュアなアクセスを維持できるようになります。

関連ドキュメント

v2.1.181(1件)

AWS認証情報の更新頻度が過剰になる問題を修正し、aws configure export-credentials の出力形式に対応
英語原文を表示
Fixed AWS awsCredentialExport credentials with a short remaining lifetime causing credential refreshes every minute, and now accepts the JSON shape from aws configure export-credentials

変更後

AWS環境での認証プロセスが安定し、標準的なAWS CLIツールとの連携がよりスムーズになります。

v2.1.178(1件)

認証情報の更新後に、古いキャッシュ設定が原因でモデルのリクエストが認証エラーで失敗し続ける問題を修正しました。
英語原文を表示
Fixed model requests continuing to fail with auth errors after credentials were refreshed outside the session, due to a stale cached request configuration

v2.1.176(1件)

Amazon Bedrock の認証情報キャッシュの改善:awsCredentialExport による認証情報が、固定の1時間ではなく Expiration(有効期限)までキャッシュされるようになりました
英語原文を表示
Improved Bedrock credential caching: credentials from awsCredentialExport are now cached until their Expiration instead of a fixed 1 hour

変更後

不要な認証コマンドの実行が減り、セッション開始やレジューム時の待ち時間が短縮されます。

関連ドキュメント

v2.1.169(2件)

macOS ユーザーが claude.ai 認証でログインしている際に、ターンの開始時に発生していた 30-50ms の UI スタック(画面の固まり)を解消しました。
英語原文を表示
Fixed a ~30-50ms UI stall at the start of each turn for macOS users logged in with claude.ai credentials

変更後

開発中のテンポを削ぐ微細なストレスが解消され、より快適な対話体験が得られます。

Windows でバックグラウンドの git コマンドが実行された際、キャッシュがない場合に Git Credential Manager のポップアップが勝手に出てしまう問題を修正しました。
英語原文を表示
Fixed Git Credential Manager's "Connect to GitHub" popup appearing on Windows at startup when background git commands ran without cached credentials

v2.1.143(1件)

.credentials.json の scopes 値が配列でない場合にCLIが起動時にハングしたり、OAuthリフレッシュがサイレントに失敗したりする問題を修正しました
英語原文を表示
Fixed a corrupt .credentials.json with a non-array scopes value hanging the CLI on startup or silently aborting OAuth token refresh

変更後

認証周りのトラブルが起きにくくなり、万が一ファイルが壊れても安定して起動できるようになります。

関連ドキュメント

v2.1.141(1件)

Bedrock環境で、既存の認証情報があってもawsCredentialExportを常に実行するように変更し、クロスアカウントアクセスに対応。
英語原文を表示
Bedrock: awsCredentialExport now always runs when configured instead of being skipped when ambient AWS credentials resolve, fixing auth for cross-account access

変更後

複数のAWSアカウントを使い分けて開発・運用している組織において、認証の切り替えがスムーズかつ確実になります。

関連ドキュメント

v2.1.139(1件)

認証情報の期限切れとポリシー設定が重なった際に、ログイン・ログアウト等の基本操作ができなくなるデッドロックを修正。
英語原文を表示
Fixed a deadlock where expired credentials and the forceRemoteSettingsRefresh policy setting blocked claude auth login/logout/status with no way to recover

変更後

万が一の認証エラー時も、詰まることなくスムーズに再ログインして作業に戻ることができます。

関連ドキュメント

v2.1.133(1件)

リフレッシュトークンの競合により、並列セッションで共通の認証情報が消失し 401 エラーになる問題を修正しました。
英語原文を表示
Fixed parallel sessions all dead-ending at 401 after a refresh-token race wiped shared credentials

v2.1.129(1件)

user:inferenceスコープが不足しているOAuth認証情報を使用している場合でも、サーバー管理設定ポリシーが適用されるよう修正されました
英語原文を表示
Fixed server-managed settings policy not applying for enterprise/team users whose stored OAuth credentials lacked the user:inference scope

変更後

組織のセキュリティポリシーや設定が漏れなく全ユーザーに適用されるようになり、管理者・ユーザー共に安心して利用できます。

関連ドキュメント

v2.1.118(2件)

Linux および Windows における資格情報保存時のクラッシュとファイルの破損を修正
英語原文を表示
Fixed credential save crash on Linux/Windows corrupting ~/.claude/.credentials.json

変更後

OSを問わず認証情報の永続性が向上し、セッション開始時のトラブルが減少します。

関連ドキュメント

CLAUDE_CODE_OAUTH_TOKEN で起動したセッションで /login が機能しない問題を修正
英語原文を表示
Fixed /login having no effect in a session launched with CLAUDE_CODE_OAUTH_TOKEN — the env token is now cleared so disk credentials take effect

変更後

一時的なトークンと常設のログインアカウントを状況に合わせて柔軟に使い分けられます。

v2.1.83(2件)

サブプロセス環境(Bash ツール、フック、MCP stdio サーバー)から Anthropic やクラウドプロバイダーの認証情報を削除する CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 を追加しました
英語原文を表示
Added CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 to strip Anthropic and cloud provider credentials from subprocess environments (Bash tool, hooks, MCP stdio servers)

変更後

開発環境における機密情報の露出を最小限に抑え、信頼できないコードを分析したり、外部の MCP ツールを利用したりする際の安全性が大幅に向上します。

関連ドキュメント

プラグインのオプション設定(manifest.userConfig)が外部から利用可能になりました。機密情報は macOS のキーチェーン等に安全に保存されます
英語原文を表示
Plugin options (manifest.userConfig) now available externally — plugins can prompt for configuration at enable time, with sensitive: true values stored in keychain (macOS) or protected credentials file (other platforms)

変更後

プラグインのセットアップが簡単かつ安全になり、複雑な初期設定なしで高度な拡張機能を利用し始められます。

関連ドキュメント

v2.1.77(1件)

macOS において、キーチェーンからの認証情報読み込みを並列化することで起動速度を約 60ms 高速化しました
英語原文を表示
Faster startup on macOS (~60ms) by reading keychain credentials in parallel with module loading

v2.1.69(2件)

複数のOAuth MCPサーバー利用時に、メタデータがバッファを超えてmacOSキーチェーンが破損し、ログインが繰り返される問題を修正
英語原文を表示
Fixed macOS keychain corruption when using multiple OAuth MCP servers. Large OAuth metadata blobs could overflow the security -i stdin buffer, silently leaving stale credentials behind and causing repeated /login prompts.

変更後

ツール連携を多用するパワーユーザーでも、煩わしい再認証に邪魔されることなく作業に集中できます。

トークン更新時の通信エラーにより、サブスクリプションタイプが「Claude API」と誤表示される問題を修正
英語原文を表示
Fixed .credentials.json losing subscriptionType (showing "Claude API" instead of "Claude Pro"/"Claude Max") when the profile endpoint transiently fails during token refresh (anthropics/claude-code#30185)

変更後

表示上の混乱がなくなり、自身のプランに応じた機能を常に一貫して利用できるようになります。

関連ドキュメント

v2.1.30(1件)

Slackのような、動的なクライアント登録をサポートしないMCPサーバーのために、事前設定済みのOAuthクライアント認証情報が追加されました。claude mcp addコマンドで--client-idおよび--client-secretを使用してください。
英語原文を表示
Added pre-configured OAuth client credentials for MCP servers that don't support Dynamic Client Registration (e.g., Slack). Use --client-id and --client-secret with claude mcp add.

変更後

MCPサーバーとの連携設定が簡素化され、より多くのツールを迅速に利用できるようになりました。

関連ドキュメント

v2.0.64(1件)

Bedrock: Add support for aws login AWS Management Console credentials

関連ドキュメント