---
title: "Mac 上的 Unable to connect to API: SSL certificate verification failed · Kilobat 指南"
url: "https://kilobat.app/zh-hant/guides/claude-code-ssl-certificate-verification-failed"
description: "Mac 上的 Claude Code 回報 SSL certificate verification failed。有代理伺服器或私有 CA 在簽署流量。請用 NODE_EXTRA_CA_CERTS 加入它的 CA。"
---

# 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 連不上的原因](https://kilobat.app/zh-hant/guides/recipes/why-cant-it-connect)。

## 常見問題

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

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

**我可以關閉驗證嗎？**

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

## 資料來源

- [Claude Code：錯誤參考](https://code.claude.com/docs/en/errors.md)
- [Claude Code：企業網路設定](https://code.claude.com/docs/en/network-config.md)

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

## 相關指南

- [Mac 上 Claude Code 的「Unable to connect to API」](https://kilobat.app/zh-hant/guides/claude-code-unable-to-connect-to-api): 當請求無法送達 api.anthropic.com 時，Claude Code 會印出 Unable to connect to API。
- [Mac 上的「UNABLE_TO_GET_ISSUER_CERT_LOCALLY」](https://kilobat.app/zh-hant/guides/npm-unable-to-get-issuer-cert-locally): UNABLE_TO_GET_ISSUER_CERT_LOCALLY 表示 Node.js 找不到簽署某張憑證的機構。
- [公司代理伺服器憑證導致 Mac 上的終端機工具失效](https://kilobat.app/zh-hant/guides/corporate-proxy-certificates): 有些公司網路會檢查 HTTPS 流量。
- [Mac 上的「curl: (60) SSL certificate problem」](https://kilobat.app/zh-hant/guides/curl-60-ssl-certificate-problem): curl 結束代碼 60 表示某個步驟失敗。
