如果你在安装或首次运行 Claude Code 时遇到：
- 初始化卡住
- 提示连接超时
- 无法访问服务
那么大概率不是软件问题，而是网络环境没有配置正确。
这一篇，我们不讲复杂原理，只讲一件事：
如何让"终端"真正连上网。
因为 Claude Code 是运行在终端里的，不是浏览器。
一、先搞清楚一个关键区别
很多人会陷入一个误区：
浏览器能访问 = 网络没问题
这是错的。
在大多数开发环境中：
- 浏览器走系统代理
- 终端默认不走代理
也就是说：
浏览器能打开网页，不代表命令行工具能访问外部服务。
Claude Code 是命令行工具，所以必须保证：
- 终端网络是可用的
- 代理在终端中生效
二、常见网络问题类型
在实际使用中，常见的网络问题主要有三类。
1️⃣ 完全无法访问外部服务
表现：
- 请求直接超时
- 无任何响应
说明终端没有配置代理或网络受限。
2️⃣ 浏览器正常，终端失败
表现：
- 浏览器能打开相关页面
- Claude Code 启动时报连接错误
说明代理只在浏览器中生效。
3️⃣ 偶发失败，连接不稳定
表现：
- 有时能用
- 有时超时
说明网络质量不稳定，或代理节点不稳定。
三、终端代理的基本原理
在命令行环境中，代理通常通过环境变量控制。
最常见的两个变量：
- HTTP_PROXY
- HTTPS_PROXY
它们的作用是：
告诉命令行工具：
"访问外部网络时，请通过这个代理地址。"
如果没有配置这两个变量，很多命令行程序会默认直连网络。
四、Windows 下的配置思路
在 Windows 中，常见终端包括：
- PowerShell
- Windows Terminal
基本配置逻辑
- 确认你使用的代理软件端口（例如本地端口）
- 在终端中设置 HTTP_PROXY 和 HTTPS_PROXY
- 重新打开终端，确认变量生效
注意两点：
- 设置环境变量后，要重新打开终端
- 不要只在图形界面里设置，而忽略命令行
如何确认是否生效？
你可以在终端中查看环境变量是否存在。
如果变量为空，说明代理并没有被终端读取。
五、macOS 下的配置思路
macOS 的终端通常是：
- 系统 Terminal
- iTerm2
macOS 下代理配置方式通常是：
- 临时设置（当前终端有效）
- 写入配置文件（长期生效）
如果你每次打开终端都要重新设置，说明只是临时配置。
建议：
将代理变量写入终端配置文件，让其长期生效。
六、代理软件常见误区
很多人使用本地代理软件时，会遇到这些问题：
1️⃣ 只开启了"系统代理"
这只对浏览器有效，对终端未必生效。
2️⃣ 忘记确认本地监听端口
代理软件通常监听一个本地端口，例如：
- 7890
- 1080
如果端口填错，终端自然无法连接。
3️⃣ 没有区分 HTTP 和 SOCKS
不同代理协议，配置方式不同。
如果使用的是 SOCKS 代理，变量格式也需要对应。
七、一个实用建议：先验证终端网络
在运行 Claude Code 之前，建议先验证：
- 终端是否能正常访问外部网络
- 是否可以成功建立连接
如果终端本身都访问不了外部服务，Claude Code 必然会失败。
八、公司网络环境的特殊情况
如果你在公司网络下使用，可能会遇到：
- 公司防火墙限制
- 需要走公司代理
- 内网环境限制访问
这种情况下：
- 优先咨询网络管理员
- 或在个人网络环境中测试
不要盲目怀疑工具。
九、什么时候说明网络已经配置成功？
当你看到：
- 初始化快速完成
- 无连接超时提示
- 可以正常进入交互状态
说明终端网络已经通畅。
之后使用中出现的问题，才可能是其他原因。
十、小结
Claude Code 的网络问题，本质只有一句话：
终端能不能连上外部网络？
记住这三点：
- 浏览器正常 ≠ 终端正常
- 代理变量是否生效是关键
- 重开终端是基本操作
把网络问题解决，Claude Code 的使用体验会稳定很多。