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/zh-hant/guides/claude-code-ssl-certificate-verification-failed.md,並和我一起逐步處理。如果缺少 Kilobat CLI,請安裝:brew install seifip/kilobat/kilobat。請你自己執行指南中的終端機和 kilobat 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。

適用於:所有目前 macOS 版本上終端機中的 Claude Code。檢查日期: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. 或者依照文件所說,把 CA 加入 macOS 系統憑證儲存區。

  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 執行。請參閱找出某個網站或 API 連不上的原因。

常見問題

Claude Code 會使用 macOS 的憑證儲存區嗎?

預設會信任它內建的 Mozilla CA 和作業系統的儲存區。原生安裝版一律會讀取系統儲存區。

我可以關閉驗證嗎?

文件指出不要設定 NODE_TLS_REJECT_UNAUTHORIZED=0。

資料來源

查核日期:2026 年 10 月 29 日。