Skip to content
← リリースに戻る · 2.1.309
新機能 / v2.1.309

[VSCode] 証明書検証失敗時の警告ログ追加

CHANGELOG 原文(英語)

[VSCode] Added a log warning that says what to do when dictation or the extension's own requests fail certificate verification, such as behind a TLS-inspecting proxy
公式の変更履歴を開く ↗

日本語での補足

TLSを検査するプロキシの背後にいる場合など、音声入力や拡張機能自身のリクエストが証明書検証に失敗した際の対処法を示すログ警告を追加。

ドキュメント

ドキュメントの抜粋(参考訳)

TLSを検査するプロキシの背後でDictationやWebタブが失敗する

DictationやWebタブがunable to get local issuer certificateのような証明書エラーで失敗する場合は、NODE_EXTRA_CA_CERTSを~/.claude/settings.jsonのenvブロックに設定してください。値には、プロキシのルートCA証明書を含むPEMファイルのパスを指定します。このファイルはIT担当者から入手できます。この失敗は、マイクボタンやWebタブ、またはログに現れます。

  • Dictation: マイクボタンに、Dictation error: WebSocket error:の後にエラーテキストが表示されます。
  • Web tab: クラウドセッションを一覧表示するタブに、エラーテキストなしでRemote server is not connectedと表示されます。ログでエラーテキストを読むには:
    1. Command PaletteからClaude Code: Show Logsを実行して、Claude VSCode出力チャンネルを開きます。
    2. タブのReconnectをクリックし、Connecting…の表示が消えるまで待ちます。
    3. チャンネル内でError fetching remote sessions:またはFailed to fetch organization UUID:を検索し、一致する最新の行でそのプレフィックスの後のエラーテキストを読みます。
  • ログの警告: an authority that Claude Code does not trustという名前を含む警告は、証明書エラーを報告しています。TLSを検査するプロキシの背後にいる場合は、~/.claude/settings.jsonのenvにNODE_EXTRA_CA_CERTSを設定してください。v2.1.309より前のバージョンはこの警告をログに出力しません。

この修正には拡張機能バージョン 2.1.307 以降が必要なので、まず拡張機能を更新してください。次に、NODE_EXTRA_CA_CERTSに証明書ファイルのフルパスを、~を使わずに設定します。Windowsのパスの場合は、settings.json内でバックスラッシュをそれぞれ2つ重ねて書いてください。たとえばC:\\certs\\example-ca.pemのようにします。

[!NOTE]

WSL、SSHホスト、devコンテナ、またはその他のシステムに接続したウィンドウでは、証明書ファイルを保存し、~/.claude/settings.jsonをそのシステム上で編集してください。ローカルコンピューター上では編集しないでください。

この例は、LinuxまたはmacOSのパス/etc/ssl/certs/example-ca.pemにある証明書ファイルを指定しています。

{
  "env": {
    "NODE_EXTRA_CA_CERTS": "/etc/ssl/certs/example-ca.pem"
  }
}

settings.jsonを保存したら、録音を開始するか、もう一度Reconnectをクリックしてください。エラーが再発する場合は、Claude Code: Show Logsで出力チャンネルを開き、use the CA certificates fileを検索してください。この警告は、拡張機能がファイルを使えない理由と、パスをどこから読み取ったかを示します。その後、NODE_EXTRA_CA_CERTSを設定した場所をそれぞれこの表で確認し、各行の指示に従ってください。

設定した場所 対処方法
VS Codeを起動した環境 ここで設定した値は、指定先のファイルが使えない場合でも、~/.claude/settings.json内の値より優先されます。修正または削除してから、VS Codeを再起動してください
~/.claude/settings.json内のenv 値またはそれが指す先のファイルを修正し、録音を開始するか、もう一度Reconnectをクリックしてください
VS CodeのclaudeCode.environmentVariables設定、~/.claude.json、プロジェクトの.claude/settings.jsonや.claude/settings.local.json、または管理設定 ここで設定した値は、DictationやWebタブには適用されません。~/.claude/settings.jsonのenvにも同じ変数を設定してください

取得日 · 2026-11-20

変更の詳細