Macの“UNABLE_TO_GET_ISSUER_CERT_LOCALLY”

UNABLE_TO_GET_ISSUER_CERT_LOCALLYは、Node.jsが証明書に署名した認証局を見つけられないことを意味します。TLSを検査するプロキシやプライベートな認証局が、よくある原因です。

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

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

対象:現在のすべてのmacOS上の、Node.js、npm、Node.jsで作られたツール。確認日:2026年10月29日

症状

  • Node.jsのツールがUNABLE_TO_GET_ISSUER_CERT_LOCALLYで止まります。
  • メッセージにunable to get local issuer certificateと表示されることがあります。
  • ブラウザでは、同じサイトが開けることがあります。

考えられる原因

  • TLSを検査するプロキシ。職場のプロキシが、独自の証明書で通信に署名しています。社内プロキシの証明書がMacのターミナルツールを壊すをご覧ください。
  • プライベートな認証局。社内のレジストリやゲートウェイが、Node.jsが知らない認証局の証明書を使っています。
  • HTTPSをスキャンするセキュリティアプリ。独自のルート証明書を加えますが、Node.jsは初期設定ではそれを使いません。
  • 中間証明書の欠落。サーバが、証明書チェーンの一部を送っていない可能性があります。

確認方法

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

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
  2. npmが使うCAファイルを表示します。

    npm config get cafile
  3. Node.jsのCA変数を表示します。

    echo $NODE_EXTRA_CA_CERTS
  4. iPhoneのテザリングを試します。

解決方法

  1. ネットワーク管理者から、PEM形式のCA証明書を受け取ります。

  2. このシェルで、Node.jsにそれを信頼させます。

    export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
  3. npmには、同じファイルを設定します。

    npm config set cafile /path/to/ca.pem
  4. NODE_TLS_REJECT_UNAUTHORIZED=0は設定しないでください。すべての確認がオフになります。

Kilobatを使う場合

  1. Kilobatの接続ドクターは、ホストを層ごとにテストします。TLSの層に、このMacが信頼していない証明書が表示されます。

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

よくある質問

ブラウザでは動くのはなぜですか?

macOSは、管理者がインストールした証明書を信頼します。Node.jsは、ファイルを追加しない限り、独自の一覧を使います。

NODE_TLS_REJECT_UNAUTHORIZED=0を設定すれば解決しますか?

いいえ。すべての接続で証明書の検証がオフになります。代わりに、CAを追加してください。

出典

2026年10月29日に確認。