今回のアップデートは何をするもの?
Claude Codeにはサンドボックス化という仕組みがあり、Bashツールで実行されるコマンドをOSレベルで隔離して安全に自動実行できるようにしています。今回のv2.1.224では、そのサンドボックスの中で「うっかりAPIキーやトークンなどの秘密情報が画面や出力に表示されてしまう」のを防ぐための、マスキング(隠す)機能が強化されました。
たとえば、環境変数の中にAPIキーが入っていたり、AWSの認証情報を使う処理があったりすると、コマンドの出力やログにそのままの値が表示されてしまうことがあります。人間なら「これは見せちゃまずいやつだ」と気づけますが、自動実行されるコマンドの出力にそのまま流れてしまうと、意図せず漏れてしまうリスクがあります。今回追加された設定は、そうした値を検出して隠す仕組みを何パターンか用意した、というアップデートです。
追加された3つのマスキングのやり方
今回追加されたのは大きく分けて3種類の仕組みです。
- extract / onExtractNoMatch: 構造化された環境変数の値から、隠すべき部分を抽出して処理するオプションです。パターンに一致しなかった場合の挙動を
onExtractNoMatchで指定できます。 - decode: "jwt" と maskClaims: JWT(JSON Web Token、ログイン情報などを含む認証トークンの一種)を解読したうえで、その中の特定の項目(claims)だけを隠す機能です。JWTはそのままだと一見ただの文字列ですが、中身を分解すると意味のある情報が入っているため、それを踏まえて狙い撃ちでマスキングできます。
- awsPairs / sigv4: AWSの認証方式であるSigV4に対応した機能で、AWSの認証情報を使って通信への署名をやり直す(再署名する)処理です。
細かい設定名は普段あまり意識しない人がほとんどだと思いますが、「JWTの中身まで見て隠せるようになった」「AWSの認証情報にも対応した」という点がポイントです。単純な文字列一致でマスキングするより、一段賢く秘密情報を扱えるようになったということですね。
使うために必要な条件
これらの機能を使うには、いくつか条件があります。
network.tlsTerminateという設定が有効になっている必要があります。これは通信の中身をサンドボックス側で確認できるようにするための前提条件です。- 設定できる場所も限定されていて、ユーザー設定・組織の管理設定(managed)・
--settingsで明示的に指定した設定ファイルのいずれかからしか有効になりません。つまり、プロジェクトの.claude/settings.jsonのような場所に書いても効かない、ということです。
これは裏を返すと「誰でも気軽に設定できるものではなく、管理者やユーザー自身が意図的に設定する前提の機能」だということです。マスキングの設定自体が誤って書き換えられると困る性質のものなので、置き場所が絞られているのは理にかなっています。
どんな人が気にすべき機能か
普段Claude Codeを個人の開発用途で使っているだけなら、この機能を直接いじる場面はそう多くないかもしれません。一方で、組織でClaude Codeを導入していてサンドボックス化や自動実行を積極的に使っている場合、あるいはAWSのAmazon Bedrock経由でClaudeを使っていてAWSの認証情報を扱う場面が多い場合には、意識しておく価値のあるアップデートです。
「秘密情報が漏れないようにする」というのは地味に見えて、AIエージェントに自動実行を任せる上ではかなり重要な土台の部分です。今回のアップデートは、その土台をさらに一段しっかりさせたものだと捉えるとわかりやすいと思います。
このページは役に立ちましたか？