为什么需要这一步?
Claude Code 通过 Anthropic 的 API(编程接口,可理解为"远程服务器通道")提供服务,服务器位于美国。 在中国大陆直接访问会被屏蔽,需要先配置代理工具(俗称"梯子")才能正常使用。
Claude Code 通过 Anthropic 的 API(编程接口,可理解为"远程服务器通道")提供服务,服务器位于美国。 在中国大陆直接访问会被屏蔽,需要先配置代理工具(俗称"梯子")才能正常使用。
📹 视频教程
跟随视频完成网络配置,大约需要 3-5 分钟:
视频教程即将上线
请先按下方文字教程完成网络配置
📋 网络配置检查清单
按照以下步骤完成配置,每完成一步请在脑海中打勾:
1
准备可用的网络工具
Claude Code 需要连接境外服务器,所以你需要一个网络代理工具(即俗称的"梯子")。如果你还没有,可以点击下方按钮下载:
⬇️ 点击下载网络工具(国内直链)
下载后按视频教程安装配置,工具需要支持系统代理模式(让电脑所有软件都走代理网络)。
2
开启系统代理
打开网络工具,找到并启用以下任一选项:
- 系统代理(让电脑所有软件都走代理网络,包括命令行终端)
- 全局模式(推荐新手使用,所有流量统一走代理,最省心)
⚠️ 注意:只开启"增强模式"或"PAC 模式"是不够的,命令行终端可能无法走代理。
📸 [此处插入 V2Ray 系统代理设置截图]
3
启用 Tun 模式(重要)
⚠️ 警告:不改 Core 类型直接开 Tun 会导致无法联网,请严格按以下顺序操作。
- 1 打开 V2Ray 设置 → Core 类型设置
-
2
将
VMess、Shadowsocks、VLESS、Trojan全部改为sing_box - 3 点击确定保存
- 4 回到主界面,开启「启用 Tun」开关
- 5 将代理模式设为「V4-全局 (Global)」
Tun 模式会创建虚拟网络接口,让命令行终端的流量也能走代理,比普通系统代理更彻底。
4
验证网络连通性
先打开命令行终端(一个可以输入命令的黑色窗口):
🪟 Windows 用户:
按 Win +
R,
在弹出的框里输入
powershell,按回车打开
🍎 Mac 用户:
按 Command +
空格,
在搜索框输入
terminal,按回车打开
然后在终端窗口里粘贴以下命令,按回车执行:
curl https://api.anthropic.com
✅ 成功标志:返回一段英文文字或 JSON 数据
❌ 失败标志:显示「连接超时」或长时间没有响应,说明代理未生效,请重新检查步骤 2 / 步骤 3
5
(可选)手动告诉命令行走哪个代理
如果步骤 4 测试失败、但浏览器能正常上网,说明系统代理没有覆盖到命令行,可以手动指定:
在终端里输入以下命令(把 7890 换成你代理工具显示的端口号):
set HTTPS_PROXY=http://127.0.0.1:7890
端口号(代理工具监听的门牌号)通常在代理工具设置里能看到,常见值:7890、7891、1080、10809。
安装程序也会自动尝试这些常用端口,大部分情况下不需要手动设置。
✓ 完成标志: 能够在浏览器中正常访问
claude.ai,
说明网络已配置完成,可以进行下一步。
🔧 常见问题
🐢 连接很慢怎么办?
- 尝试切换节点(代理服务器的位置)
- 选择延迟(响应时间,越低越好)低的境外节点
- 关闭其他占用网络的程序
❌ 连接超时怎么办?
- 检查代理工具是否已启动运行
- 确认已开启系统代理(全局模式)
- 重启代理工具后重试步骤 3