步骤 1: 确认基本网络连接
首先,排除 macOS 自身网络问题:
- 打开'系统设置' > '网络',检查 Wi-Fi 或以太网连接状态是否为'已连接'。
- 如果此步骤失败:请先解决 macOS 网络问题(如重启 Mac、重置网络设置),然后再继续。
尝试访问其他网站(如 apple.com)或使用终端命令测试:
ping -c 4 8.8.8.8 # 测试基本网络连通性
如果响应正常(显示'64 bytes from...'),则 macOS 网络正常;如果失败,可能是系统级问题(如路由器故障),需重启路由器或联系 ISP。
步骤 2: 检查 Claude Code 的网络权限
Claude Code 可能被系统防火墙或隐私设置阻止:
- 打开'系统设置' > '隐私与安全性' > '防火墙':
- 确保防火墙已关闭(临时测试),或添加 Claude Code 到允许列表:点击'防火墙选项' > '+' 添加应用。
- 在'隐私与安全性' > '本地网络'中:
- 检查 Claude Code 是否请求了网络访问权限;如果被拒绝,请启用它。
- 重启 Claude Code 应用,测试是否能联网。
步骤 3: 修复网络配置冲突
软件安装可能修改了代理或 DNS 设置:
- 检查代理设置:
- 打开'系统设置' > '网络' > 选择您的连接 > '高级' > '代理'。
- 确保所有代理选项(如 Web Proxy、Secure Web Proxy)未启用,除非您手动配置过。
- 重置 DNS 设置:
- 设置 DNS 为公共服务器(如 Google DNS):
- 在'网络'设置中,选择您的连接 > '高级' > 'DNS',添加服务器:
8.8.8.8和8.8.4.4。
- 在'网络'设置中,选择您的连接 > '高级' > 'DNS',添加服务器:
- 设置 DNS 为公共服务器(如 Google DNS):
- 重启 Mac:应用更改后,重启系统测试。
在终端运行以下命令清除 DNS 缓存:
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
步骤 4: 修复权限和系统文件
权限问题可能导致软件无法访问网络:
- 运行磁盘工具:
- 打开'磁盘工具' > 选择您的磁盘 > '急救',修复权限和磁盘错误。
- 重置网络服务:
- 检查应用权限:
- 打开'系统设置' > '隐私与安全性' > '完整磁盘访问',确保 Claude Code 被授予权限(如果它是开发工具,可能需要此权限)。
在终端中运行:
sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist
sudo rm /Library/Preferences/SystemConfiguration/preferences.plist

