環境変数

CLAUDE_CODE_CERT_STORE

TLS 接続用の CA 証明書ソースのカンマ区切りリスト。bundled は Claude Code に同梱された Mozilla CA セット。system は OS のトラストストアで、tls.getCACertificates を備えたランタイム、つまりネイティブバイナリまたは npm インストールの場合は Node 22.15 以降でのみ読み込まれる。CA 証明書ストアの詳細は該当セクションを参照。デフォルトは bundled,system

使い方・用途

  • 企業内の TLS インスペクションプロキシのルート証明書が OS の信頼ストアにインストールされている環境で、追加設定なしでプロキシ経由の通信を信任させたい場合に使う。
  • 企業のセキュリティポリシー上、OS の証明書ストアを信頼せず Claude Code に同梱の Mozilla CA セットだけを使わせたい場合に、bundled のみを指定して制限できる。
  • 古い Node バージョンの npm 環境では OS ストアを読めないため、同梱 CA と NODE_EXTRA_CA_CERTS だけで TLS 接続を構成したい場合に挙動を明示的に制御できる。
英語原文(公式ドキュメントより)

Comma-separated list of CA certificate sources for TLS connections. bundled is the Mozilla CA set shipped with Claude Code. system is the operating system trust store, read only on runtimes with tls.getCACertificates: the native binary, or Node 22.15 or later for npm installs. See CA certificate store. Default is bundled,system

関連ドキュメント

関連する変更履歴

v2.1.307(1件)

Fixed
[VSCode] NODE_EXTRA_CA_CERTS が ~/.claude/settings.json でのみ設定されている場合に、TLS 検査プロキシ環境下で音声入力が失敗する問題を修正した。CLAUDE_CODE_CERT_STORE も参照するようになった
英語原文を表示
[VSCode] Fixed dictation failing behind a TLS-inspecting proxy when NODE_EXTRA_CA_CERTS is set only in ~/.claude/settings.json; it now also follows CLAUDE_CODE_CERT_STORE

関連ドキュメント

v2.1.101(1件)

Added
OSのCA証明書ストアをデフォルトで信頼するように変更(企業のTLSプロキシ環境での利用を簡素化)
英語原文を表示
Added OS CA certificate store trust by default, so enterprise TLS proxies work without extra setup (set CLAUDE_CODE_CERT_STORE=bundled to use only bundled CAs)

変更後

プロキシ設定の手間が軽減され、社内インフラ環境下でのインストールや利用がよりスムーズになります。

関連ドキュメント