Claude Code 网络配置教程

Claude Code 对网络出口地区比较敏感：即使能连上，如果出口在不受支持的地区，也会被拒绝。按下面的步骤配置即可稳定使用。

准备工作#

1. 按 Codex CLI 教程 的方法把 KeepKite 订阅导入代理客户端。
2. 打开 服务状态，选择 Claude 显示「可达」 的节点。显示「地区受限」的节点不要用于 Claude。
3. 安装 Claude Code：

# 官方安装脚本（macOS / Linux / WSL）
curl -fsSL https://claude.ai/install.sh | bash
# 或使用 npm
npm install -g @anthropic-ai/claude-code
claude --version

方式 A：TUN 模式（推荐）#

在客户端中开启 TUN（虚拟网卡）模式并使用规则模式，然后新开终端运行 claude。登录时的浏览器授权也会自动走代理。

方式 B：代理环境变量#

Claude Code 支持标准的 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY。注意：Claude Code 不支持 SOCKS 代理，请使用客户端的 HTTP / 混合端口。

临时设置（当前终端）：

export HTTPS_PROXY=http://127.0.0.1:7897
export NO_PROXY=localhost,127.0.0.1,::1
claude

推荐写进 Claude Code 的设置文件，这样无论从哪个终端或 IDE 启动都会生效。编辑 ~/.claude/settings.json：

{
  "env": {
    "HTTPS_PROXY": "http://127.0.0.1:7897",
    "NO_PROXY": "localhost,127.0.0.1,::1"
  }
}

端口 7897 是 Clash Verge Rev 的默认混合端口，请换成你客户端里实际的端口。

验证#

curl -fsSL https://app.keepkite.com/check.sh | bash
claude doctor

检测脚本中 Claude 一项通过后，运行 claude 并输入一个简单问题测试。

常见问题#

Request not allowed / 403 / 地区不可用？ 当前出口地区不受 Anthropic 支持。切换到状态页上 Claude「可达」的节点（通常美国、日本、新加坡线路），并确认请求确实走了代理。

ECONNRESET 或 fetch failed？ 一般是代理没生效或节点不稳定。检查 settings.json 的 env 是否正确，或改用 TUN 模式。

公司网络有自签名证书？ 可通过 NODE_EXTRA_CA_CERTS=/path/to/ca.pem 指定根证书。

更多排查步骤见 Codex / Claude 连不上怎么办。