Claude Code「Unable to connect to API」「Unable to connect to Anthropic services」怎么办（2026）
大约 3 分钟ClaudeClaude CodeUnable to connect to APIECONNREFUSEDENOTFOUNDClaude Code报错
一句话结论
这类报错都是 Claude Code 跟 API 之间的网络连接没建立起来。先在同一个终端运行 curl -I https://api.anthropic.com 看能不能连通；能连通但 Claude Code 还是报错，重点查是否残留了 ANTHROPIC_BASE_URL 或代理设置。
阅读说明
官方信息查阅日期：2026-10-24。来源：Claude Code 官方文档 Error reference、Network configuration。本站只整理官方排查步骤，不提供任何绕过地区限制的方法。
你可能看到的报错
会话中：
Unable to connect to API. Check your internet connection
Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server — check your internet or DNS (ENOTFOUND)
No internet route — check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
第一次启动、登录前：
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
首次启动时，Claude Code 会先检查能不能连到 api.anthropic.com 和 platform.claude.com，每项最多等 10 秒，失败就退出。
错误码对照
| 错误码 | 官方说明的含义 | 先查什么 |
|---|---|---|
ECONNREFUSED / ConnectionRefused | 连接被拒绝，可能是防火墙或代理拦截 | 防火墙、代理、残留的 ANTHROPIC_BASE_URL |
ENOTFOUND | 找不到 API 服务器 | 网络和 DNS |
EHOSTUNREACH | 没有可用的网络路由 | 网络连接、VPN 客户端状态 |
ERR_PROXY_TUNNEL | 代理拒绝建立隧道 | 代理的账号密码、是否放行该主机 |
ECONNRESET | 连接中途断开 | 偶发的会自动重试；持续出现看网关设置 |
按顺序排查
- 测试连通性：在启动 Claude Code 的同一个终端运行
curl -I https://api.anthropic.com。Windows PowerShell 用curl.exe -I https://api.anthropic.com，避免调用内置别名。 - 公司网络要代理：启动前设置
HTTPS_PROXY，参考官方 Network configuration 文档；报错里点名了代理变量的，让网络管理员确认代理放行对应主机。 - 防火墙：确保放行官方「Network access requirements」列出的主机。
- curl 通、Claude Code 不通：
- 运行
echo $ANTHROPIC_BASE_URL（PowerShell：echo $env:ANTHROPIC_BASE_URL），也检查设置文件的env块。设了这个变量，请求就发往那个地址，而不是api.anthropic.com；指向一个已经不运行的本地代理或网关，就会Connection refused。删掉后从新终端启动。 - Linux / WSL：检查
/etc/resolv.conf里的 DNS 服务器是否可达，WSL 可能继承宿主机的错误配置。 - macOS：断开或卸载过的 VPN 客户端可能留下隧道接口或路由规则，用
ifconfig查看残留的utun接口，并在系统设置里移除该 VPN 的网络扩展。 - Docker Desktop 等容器工具可能拦截出站流量，先退出它们再试。
- 运行
- 偶发失败：Claude Code 会自动重试。
网络正常也连不上？
官方在「Unable to connect to Anthropic services」一节写明：网络正常但仍失败，可能是 Claude Code 在你所在的国家或地区不可用。见 Claude 支持哪些国家和地区。
相关阅读
参考来源（官方）
- Claude Code Docs · Error reference（Unable to connect to API；Unable to connect to Anthropic services）：https://code.claude.com/docs/en/errors（查阅日期：2026-10-24）
- Claude Code Docs · Network configuration：https://code.claude.com/docs/en/network-config（查阅日期：2026-10-24）
- Anthropic · Supported countries and regions：https://www.anthropic.com/supported-countries（查阅日期：2026-10-24）