Macの“Unable to connect to API: SSL certificate verification failed”
Claude Codeは、信頼していない認証局の証明書が使われると、これを表示します。ドキュメントでは、TLSを検査する社内プロキシや、プライベートCAを使うゲートウェイが挙げられています。
私の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が
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のファイルを読めないと警告します。
- 時計が違う。日付が大きくずれていると、証明書の確認に失敗します。
確認方法
発行者を確認します。
curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer変数を表示します。
echo $NODE_EXTRA_CA_CERTSデバッグログを有効にしてClaude Codeを起動し、ログのCAの行を確認します。
claude --debug日付を確認します。
date
解決方法
管理者から、PEM形式のCAバンドルを受け取ります。
起動前に、Claude Codeにそのファイルを指定します。
export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pemまたは、ドキュメントにあるとおり、macOSのシステム証明書ストアにCAを追加します。
NODE_TLS_REJECT_UNAUTHORIZED=0は設定しないでください。検証がオフになります。
Kilobatを使う場合
Kilobatの接続ドクターは、APIホストを層ごとにテストします。TLSの層に、誰が証明書に署名したかが表示されます。
kilobat why https://api.anthropic.comこれらのKilobatのチェックは無料です。AIエージェントはMCPを通じて
diagnose_connectionとdiagnose_networkで実行します。1つのサイトやAPIに接続できない原因を見つけるを参照してください。
よくある質問
Claude CodeはmacOSの証明書ストアを使いますか?
初期設定では、同梱のMozillaのCAとオペレーティングシステムのストアを信頼します。ネイティブインストールでは、常にシステムストアを読み込みます。
検証をオフにできますか?
ドキュメントには、NODE_TLS_REJECT_UNAUTHORIZED=0を設定しないよう書かれています。
出典
2026年10月29日に確認。