環境変数

NODE_EXTRA_CA_CERTS

型string

カスタムCA証明書ファイルへのパス

使い方・用途

  • 企業プロキシ環境や制限のあるネットワークで、APIリクエスト時のSSL証明書エラーを回避するために使用します
  • OAuthログインや接続チェックが失敗する場合、ITチームから提供された証明書バンドルを信頼させることで解決できます
  • 証明書の問題による接続失敗時に、適切なネットワーク設定のガイダンスを表示するための基盤となります
英語原文(公式ドキュメントより)

Path to custom CA certificate file

関連ドキュメント

関連する変更履歴

v2.1.307(2件)

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

関連ドキュメント

Changed
[VSCode] 拡張機能自身のリクエストが、CLI と同様に信頼する証明書をフィルタリングし、環境変数またはユーザー設定で指定された NODE_EXTRA_CA_CERTS のファイルを信頼するように変更した
英語原文を表示
[VSCode] Changed the extension's own requests to filter their trusted certificates as the CLI does, and to trust the NODE_EXTRA_CA_CERTS file named in the environment or in user settings

変更後

企業内の TLS 検査プロキシやプライベート CA を利用した環境でも、VSCode 拡張機能からのリクエストが CLI と同じ CA 証明書の設定に従うようになり、NODE_EXTRA_CA_CERTS を設定するだけで拡張機能も正常に接続できるようになる。

関連ドキュメント

v2.1.273(1件)

Improved
セッション内の SSL 証明書やプロキシ接続エラーを改善し、エラーコードと修正すべき内容を示すようにした。例えば、信頼されていない企業 CA に対しては NODE_EXTRA_CA_CERTS を案内する
英語原文を表示
Improved the in-session SSL certificate and proxy connection errors to name the error code and what to fix, such as NODE_EXTRA_CA_CERTS for an untrusted corporate CA

変更後

セッション中に SSL 証明書やプロキシ接続のエラーが発生した際、エラーコードと具体的な対処法(企業の自己署名 CA の場合は NODE_EXTRA_CA_CERTS の設定など)が表示されるようになり、何を修正すればよいかすぐに把握できるようになる。

関連ドキュメント

v2.1.199(1件)

Fixed
SSL証明書エラー(プロキシ、CA証明書設定、期限切れなど)発生時に、リトライを繰り返さず即座に修正ヒントを表示するよう改善
英語原文を表示
Fixed SSL certificate errors (TLS-inspecting proxies, missing NODE_EXTRA_CA_CERTS, expired certs) burning retries before showing actionable guidance — they now fail immediately with the fix hint

変更後

不毛な待ち時間が減り、環境設定やネットワーク上の問題を即座に特定して解決できます。

関連ドキュメント

v2.1.73(1件)

Added
SSL証明書エラーによるOAuthログインや接続チェックの失敗時に、具体的な解決策を案内する機能を追加
英語原文を表示
Added actionable guidance when OAuth login or connectivity checks fail due to SSL certificate errors (corporate proxies, NODE_EXTRA_CA_CERTS)

変更後

トラブルシューティングの手間が減り、制限のあるネットワーク環境下でもスムーズに導入を開始できるようになります。

関連ドキュメント

v1.0.40(1件)

Fixed
Fixed a bug causing API connection errors with UNABLE_TO_GET_ISSUER_CERT_LOCALLY if NODE_EXTRA_CA_CERTS was set

関連ドキュメント