1
网络准备
2
下载安装
3
登录使用
为什么需要这一步?
Claude Code 通过 Anthropic 的 API(编程接口,可理解为"远程服务器通道")提供服务,服务器位于美国。 在中国大陆直接访问会被屏蔽,需要先配置代理工具(俗称"梯子")才能正常使用。

📹 视频教程

跟随视频完成网络配置,大约需要 3-5 分钟:

视频教程即将上线

请先按下方文字教程完成网络配置

📋 网络配置检查清单

按照以下步骤完成配置,每完成一步请在脑海中打勾:

1

准备可用的网络工具

Claude Code 需要连接境外服务器,所以你需要一个网络代理工具(即俗称的"梯子")。如果你还没有,可以点击下方按钮下载:

⬇️ 点击下载网络工具(国内直链)

下载后按视频教程安装配置,工具需要支持系统代理模式(让电脑所有软件都走代理网络)。

2

开启系统代理

打开网络工具,找到并启用以下任一选项:

  • 系统代理(让电脑所有软件都走代理网络,包括命令行终端)
  • 全局模式(推荐新手使用,所有流量统一走代理,最省心)

⚠️ 注意:只开启"增强模式"或"PAC 模式"是不够的,命令行终端可能无法走代理。

📸 [此处插入 V2Ray 系统代理设置截图]
3

启用 Tun 模式(重要)

⚠️ 警告:不改 Core 类型直接开 Tun 会导致无法联网,请严格按以下顺序操作。
  1. 1 打开 V2Ray 设置 → Core 类型设置
  2. 2 VMessShadowsocksVLESSTrojan 全部改为 sing_box
  3. 3 点击确定保存
  4. 4 回到主界面,开启「启用 Tun」开关
  5. 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