Macの“Unable to connect to API: SSL certificate verification failed”

Claude Codeは、信頼していない認証局の証明書が使われると、これを表示します。ドキュメントでは、TLSを検査する社内プロキシや、プライベートCAを使うゲートウェイが挙げられています。

エージェントで解決するClaude Code、Codex、またはターミナルを使えるエージェント向けのプロンプトをコピーします。

私のMacでこの問題が起きています:Macの“Unable to connect to API: SSL certificate verification failed”。https://kilobat.app/ja/guides/claude-code-ssl-certificate-verification-failed.mdを読んで、一緒に進めてください。Kilobat CLIがなければインストールしてください:brew install seifip/kilobat/kilobat。ガイドにあるターミナルとkilobatのチェックはあなた自身で実行し、わかったことを教えてください。私にしかできない手順は一覧にしてください。設定を変更する前に必ず確認してください。

対象:ターミナルで動くClaude Code、現在のすべてのmacOS。確認日:2026年10月29日

症状

  • Claude CodeがUnable to connect to API: SSL certificate verification failedと表示します。
  • コードがUNABLE_TO_GET_ISSUER_CERT_LOCALLYになっているか、テキストにself-signed certificateと書かれています。
  • 職場のネットワークで始まります。

考えられる原因

  • TLSを検査するプロキシ。プロキシまたはセキュリティ機器が、独自の証明書でTLS通信を傍受しています。
  • プライベートCAを使うゲートウェイ。LLMゲートウェイが、プライベートな認証局の証明書を使うことがあります。
  • 読み込めないCAファイル。Claude Codeは、NODE_EXTRA_CA_CERTSのファイルを読めないと警告します。
  • 時計が違う。日付が大きくずれていると、証明書の確認に失敗します。

確認方法

  1. 発行者を確認します。

    curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer
  2. 変数を表示します。

    echo $NODE_EXTRA_CA_CERTS
  3. デバッグログを有効にしてClaude Codeを起動し、ログのCAの行を確認します。

    claude --debug
  4. 日付を確認します。

    date

解決方法

  1. 管理者から、PEM形式のCAバンドルを受け取ります。

  2. 起動前に、Claude Codeにそのファイルを指定します。

    export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
  3. または、ドキュメントにあるとおり、macOSのシステム証明書ストアにCAを追加します。

  4. NODE_TLS_REJECT_UNAUTHORIZED=0は設定しないでください。検証がオフになります。

Kilobatを使う場合

  1. Kilobatの接続ドクターは、APIホストを層ごとにテストします。TLSの層に、誰が証明書に署名したかが表示されます。

    kilobat why https://api.anthropic.com
  2. これらのKilobatのチェックは無料です。AIエージェントはMCPを通じてdiagnose_connectionとdiagnose_networkで実行します。1つのサイトやAPIに接続できない原因を見つけるを参照してください。

よくある質問

Claude CodeはmacOSの証明書ストアを使いますか?

初期設定では、同梱のMozillaのCAとオペレーティングシステムのストアを信頼します。ネイティブインストールでは、常にシステムストアを読み込みます。

検証をオフにできますか?

ドキュメントには、NODE_TLS_REJECT_UNAUTHORIZED=0を設定しないよう書かれています。

出典

2026年10月29日に確認。