系统代理模式（HTTP Proxy）#

1
浏览器           ──→  系统代理  ──→  代理服务器  ──→  Claude API  ✅
2
终端程序         ──→  直连      ──→  Claude API  ❌ (真实IP)
3
Claude Code      ──→  直连      ──→  Claude API  ❌ (403!)
4
VSCode 插件      ──→  直连      ──→  Claude API  ❌ (403!)
5
Claude 桌面客户端 ──→  直连      ──→  Claude API  ❌ (403!)
6
Cowork           ──→  直连      ──→  Claude API  ❌ (403!)

系统代理（HTTP Proxy）只对 主动读取系统代理设置的程序 生效。浏览器会读取系统代理，但终端程序、CLI 工具、编辑器插件、Electron 客户端 不会自动走系统代理。

这意味着：

• 浏览器 → 走代理 → 住宅 IP → 正常
• Claude Code / 桌面客户端 / Cowork → 不走代理 → 真实 IP / 机房 IP → 403

TUN 模式（虚拟网卡）#

1
浏览器           ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
2
终端程序         ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
3
Claude Code      ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
4
VSCode 插件      ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
5
Claude 桌面客户端 ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
6
Cowork           ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅

TUN 模式在系统网络层创建一个虚拟网卡，接管所有程序的网络流量，不管程序是否支持代理设置。这就是为什么 TUN 模式能彻底解决所有 Claude 产品的 403 问题。

方案一：V2rayN 开启 TUN 模式（推荐）#

这是最简单有效的方案，适用于 Windows 和 macOS。

前提条件：需要有一个纯净的住宅 IP 节点。如果你还没有，可以参考 纯净住宅 IP 配置指南 获取。

方案二：手动设置环境变量（备选）#

如果无法使用 TUN 模式，可以手动为终端设置代理环境变量：

1
# 设置代理（端口以你自己代理软件实际放出的端口为准）
2
export https_proxy=http://127.0.0.1:端口号
3
export http_proxy=http://127.0.0.1:端口号
4
export all_proxy=socks5://127.0.0.1:端口号
5

6
# 然后运行 Claude Code
7
claude

可以将这些环境变量写入 ~/.bashrc 或 ~/.zshrc 使其永久生效：

1
echo 'export https_proxy=http://127.0.0.1:端口号' >> ~/.bashrc
2
echo 'export http_proxy=http://127.0.0.1:端口号' >> ~/.bashrc
3
echo 'export all_proxy=socks5://127.0.0.1:端口号' >> ~/.bashrc
4
source ~/.bashrc

⚠️ 注意：这个方法仅对终端中的 Claude Code 有效，VSCode 插件可能仍需 TUN 模式。

1
export http_proxy=http://127.0.0.1:端口号
2
export https_proxy=http://127.0.0.1:端口号
3
open -a Claude

方案三：VSCode 代理设置（仅 VSCode 插件）#

如果只是 VSCode 插件报 403，可以在 VSCode 中配置代理：

1. 打开 VSCode 设置（Ctrl + ,）
2. 搜索 proxy
3. 在 Http: Proxy 中填写代理地址：http://127.0.0.1:端口号（端口以你代理软件为准）
4. 重启 VSCode

但这种方式不一定对所有插件生效，TUN 模式仍然是最可靠的方案。

Q: 开了 TUN 模式还是 403？#

检查以下几点：

• 是否以 管理员身份 运行 V2rayN
• 当前选择的节点是否是 住宅 IP（不是所有节点都是住宅 IP）
• 在终端运行 curl https://api.ip.sb/ip 确认出口 IP 是否已变化
• 访问 Ping0 确认 IP 类型

Q: 用了住宅 IP 还是偶尔 403？#

• 可能住宅 IP 被多人共用，已被标记，换一个节点试试
• 检查 IP 欺诈值，Scamalytics 评分应低于 30
• 确保没有频繁切换 IP 地区

Q: macOS 上 TUN 模式不生效？#

• 检查系统偏好设置 → 隐私与安全性 → 网络扩展，确认已允许 V2rayN
• 运行 xattr -cr /Applications/v2rayN.app 解除系统限制
• 重启 V2rayN 后再开启 TUN

Q: 环境变量设置了也不管用？#

• 确认代理软件正在运行且端口正确
• 某些程序使用独立的 DNS 解析，可能绕过了代理
• 这种情况下只有 TUN 模式能彻底解决