---
title: "MacのClaude Codeでの“Unable to connect to API” · Kilobatガイド"
url: "https://kilobat.app/ja/guides/claude-code-unable-to-connect-to-api"
description: "MacのClaude Codeが“Unable to connect to API”と表示します。接続、APIホストをブロックするVPN、設定が必要なプロキシを確認してください。"
---

# MacのClaude Codeでの“Unable to connect to API”

Claude Codeは、リクエストがapi.anthropic.comに届かないと、Unable to connect to APIと表示します。Claude Codeのドキュメントでは、インターネットに接続できないこと、ホストをブロックするVPN、未設定の社内プロキシがよくある原因として挙げられています。

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

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

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

## 症状

- Claude Codeが`Unable to connect to API. Check your internet connection`と表示します。
- メッセージの末尾に、ENOTFOUND、EHOSTUNREACH、ECONNRESETなどのコードが付くことがあります。
- リクエストは失敗しますが、ほかのアプリは動くことがあります。

## 考えられる原因

- **インターネットに接続できない。**Macがオフラインか、DNSがありません。
- **APIホストをブロックするVPN。**Claude Codeのドキュメントは、これをよくある原因として挙げています。
- **プロキシが未設定。**社内プロキシが必要な場合は、起動前に`HTTPS_PROXY`を設定します。
- **トンネルを拒否するプロキシ。**ERR_PROXY_TUNNELは、プロキシがトンネルを拒否したことを意味します。プロキシの認証情報と、このホストが許可されているかを確認します。

## 確認方法

1. 同じシェルからAPIホストをテストします。

   ```
   curl -I https://api.anthropic.com
   ```
2. プロキシ環境変数を表示します。

   ```
   env | grep -i proxy
   ```
3. Claude Code内でチェックを実行します。

   ```
   /doctor
   ```
4. macOS経由でホスト名をテストします。

   ```
   dscacheutil -q host -a name api.anthropic.com
   ```

## 解決方法

1. DNSが失敗する場合は修正します。[MacでDNSが名前解決されない](https://kilobat.app/ja/guides/dns-server-not-found)をご覧ください。
2. 社内プロキシの内側にいる場合は、起動前に設定します。

   ```
   export HTTPS_PROXY=http://proxy.example.com:8080
   ```
3. ゲートウェイを使っている場合は、`ANTHROPIC_BASE_URL`にそのアドレスを設定します。
4. 短いテストのため、VPNをオフにします。終わったらオンに戻します。

## Kilobatを使う場合

1. Kilobatの接続ドクターは、APIホストを層ごとにテストします。ネットワーク、プロキシ、DNS、ルール、IPv4、IPv6、TLS、サーバの順です。

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

## よくある質問

**かっこ内のコードは重要ですか？**

はい。ENOTFOUNDはDNS、EHOSTUNREACHは経路、ECONNRESETはリセット、ERR_PROXY_TUNNELはプロキシを指しています。

**変数を設定したら、Claude Codeを再起動しますか？**

はい。ネットワーク設定のページには、実行中のセッションは、あとからのシェルの変更を反映しないと書かれています。

## 出典

- [Claude Code: Error reference](https://code.claude.com/docs/en/errors.md)
- [Claude Code: Enterprise network configuration](https://code.claude.com/docs/en/network-config.md)

2026年10月29日に確認。

## 関連ガイド

- [MacのClaude Codeでの“Request timed out”](https://kilobat.app/ja/guides/claude-code-request-timed-out): Claude Codeは、接続の期限までにAPIが応答しないと、Request timed outと表示します。
- [Macの“Unable to connect to API: SSL certificate verification failed”](https://kilobat.app/ja/guides/claude-code-ssl-certificate-verification-failed): Claude Codeは、信頼していない認証局の証明書が使われると、これを表示します。
- [Macで「curl: (6) Could not resolve host」と表示される](https://kilobat.app/ja/guides/curl-could-not-resolve-host): curlの終了コード6は、curlがホスト名のアドレスを取得できなかったことを示します。
- [Macでプロキシ設定のせいでアプリが接続できない](https://kilobat.app/ja/guides/proxy-settings-breaking-apps): プロキシ設定は、通信を別のサーバ経由で送ります。
