Claude Code 安装与代理配置:从安装到 HTTPS_PROXY 设置
AI 工具 · 发布 2026-09-25 · 更新 2026-11-18 · 约 8 分钟读完
快速答案
Claude Code 可通过官方安装脚本或 npm 安装,登录需要 Claude Pro / Max 账号或 Anthropic API Key。国内使用的关键是让终端走代理:设置 HTTPS_PROXY / HTTP_PROXY 环境变量,或直接开启客户端 TUN 模式,并把出口固定在美国、日本等受支持地区。
目录
Claude Code 国内能用吗:先给结论安装 Claude Code方法 A:用 HTTPS_PROXY 环境变量配置代理方法 B:开启 TUN 模式登录 Claude CodeClaude Code 常见报错与排查长时间编码任务的稳定性建议适合 Claude Code 用户的机场小结常见问题Claude Code 国内能用吗:先给结论
能用,但比网页版多一步:终端程序默认不走系统代理。很多人浏览器里 claude.ai 打得开,终端里运行 claude 却一直卡住或报 ETIMEDOUT,原因就在这里。解决方法有两种,任选其一:
- 方法 A:在终端设置
HTTPS_PROXY/HTTP_PROXY环境变量,指向本地代理端口(如http://127.0.0.1:7890); - 方法 B:在 Clash Verge Rev 等客户端里开启 TUN 模式,让所有程序的流量都被接管。
另外,Claude Code 和 Claude 网页版一样受地区限制,出口必须在受支持地区(美国、日本等),香港不行。账号方面需要 Claude Pro / Max 订阅,或在 Anthropic Console 创建的 API Key。如果你还没有能用的 Claude 账号,先看 Claude 国内怎么用。
安装 Claude Code
截至 2026 年,官方提供两种主要安装方式:
| 方式 | 命令 | 说明 |
|---|---|---|
| 原生安装脚本(macOS / Linux / WSL) | curl -fsSL https://claude.ai/install.sh | bash | 官方推荐,自动更新,不依赖 Node |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex | 原生 Windows 安装 |
| npm 全局安装 | npm install -g @anthropic-ai/claude-code | 需要 Node.js 18 或更高版本 |
国内网络下,安装脚本本身就需要访问海外地址,所以安装前就要让终端走代理。用 npm 安装时,也可以单独给 npm 配置代理:
npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890
不要使用 sudo npm install -g,权限问题会导致后续自动更新失败;更推荐用 nvm 等工具管理 Node。终端、git、npm 代理的通用设置方法,可以参考 终端 / git / npm 代理设置。
方法 A:用 HTTPS_PROXY 环境变量配置代理
首先确认你的代理客户端的本地端口。Clash Verge Rev 默认混合端口一般是 7897,旧版 Clash 常见 7890,Shadowrocket 等工具请在设置里查看。下面以 7890 为例:
macOS / Linux(zsh、bash)
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1
claude
想永久生效,把前三行加到 ~/.zshrc 或 ~/.bashrc 末尾,然后执行 source ~/.zshrc。
Windows PowerShell
$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"
claude
写进 Claude Code 的 settings.json
Claude Code 支持在设置文件的 env 字段里声明环境变量,每次启动自动生效。用户级配置文件路径为 ~/.claude/settings.json:
{
"env": {
"HTTPS_PROXY": "http://127.0.0.1:7890",
"HTTP_PROXY": "http://127.0.0.1:7890"
}
}
注意代理地址要写 http:// 开头。如果你的客户端只提供 SOCKS5 端口,也可以尝试 socks5:// 地址,但 HTTP 代理的兼容性最好。
方法 B:开启 TUN 模式
TUN 模式会在系统里创建一个虚拟网卡,所有程序的流量都会经过代理客户端,不需要逐个程序配置。它的优点是:
- Claude Code 内部调用的子进程(git、npm、curl、MCP 服务器)也能走代理;
- DNS 解析也被接管,避免 DNS 泄漏导致的地区识别错误;
- IDE 插件、桌面 App 等不读环境变量的程序同样生效。
缺点是首次开启需要授予管理员权限,部分公司电脑可能不允许。Clash Verge Rev 里的操作路径是“设置 → 虚拟网卡模式 / TUN 模式”,具体图文步骤见 Clash Verge Rev 教程 和 TUN 模式详解。
登录 Claude Code
第一次运行 claude 会进入登录流程,有两种选择:
- Claude 订阅账号(Pro / Max):终端会打开浏览器进行授权,授权完成后回到终端即可使用。如果浏览器没有自动打开,可以复制终端里显示的链接,在已开启代理的浏览器里手动打开;
- Anthropic Console 账号(API 计费):按 Token 计费,适合团队或已有 API 额度的用户。也可以直接设置
ANTHROPIC_API_KEY环境变量使用。
登录时浏览器和终端的出口地区应当一致:比如终端走美国节点,浏览器也应该是同一个美国节点。若两者走了不同出口,授权回调有时会失败。这也是推荐 TUN 模式的原因之一——浏览器和终端天然一致。
Claude Code 常见报错与排查
| 现象 / 报错 | 可能原因 | 处理方法 |
|---|---|---|
| 启动后长时间无响应,或 ETIMEDOUT / ECONNRESET | 终端没有走代理 | 设置 HTTPS_PROXY 或开启 TUN;用 curl -I https://api.anthropic.com 测试连通性 |
| Request not allowed / 403 | 出口地区不受支持(如香港) | 把 AI 策略组切到美国、日本节点 |
| 登录授权后终端仍未登录 | 浏览器与终端出口不同,或回调被拦截 | 改用 TUN 模式;手动复制授权码粘贴到终端 |
| API Error 529 / overloaded | 官方服务繁忙,与网络无关 | 稍后重试 |
| 429 rate limit | 订阅额度或 API 速率达到上限 | 等待额度重置,或升级方案 |
| self signed certificate 证书错误 | 代理客户端启用了 HTTPS 解密 / MITM | 关闭 MITM,或为该域名排除解密 |
| 安装脚本下载失败 | 安装前终端未走代理 | 先 export 代理变量再执行安装命令 |
如果设置了环境变量却仍然不生效,检查是否在新打开的终端窗口里执行(旧窗口不会读取新写入 .zshrc 的变量),以及代理客户端的“允许局域网连接 / 端口”是否和你填写的一致。系统代理不生效的通用排查见 系统代理不生效。
长时间编码任务的稳定性建议
Claude Code 常常一次运行几分钟到几十分钟,期间会持续和服务器保持流式连接。网络中途断开,任务可能需要重来,还会浪费额度。几点建议:
- 固定节点:AI 策略组用手动选择,不要用自动测速切换;
- 选择专线线路:IEPL / IPLC 专线晚高峰丢包更低,原理见 IEPL 专线是什么;
- 预留流量:Claude Code 会上传代码上下文,长期重度使用时每月流量明显高于网页聊天;
- 远程服务器:在海外 VPS 上运行 Claude Code 可以完全避开本地网络问题,但要注意 VPS 的 IP 也要在受支持地区。
适合 Claude Code 用户的机场
开发者使用 Claude Code,最在意的是长连接稳定和出口 IP 固定。本站 AI 专用机场推荐 中,速界 的定位就是面向每天用 ChatGPT / Claude / Codex 的程序员和学生,月付 25 元 150GB,IEPL 专线 + VLESS,支持自研客户端和第三方订阅导入;如果你更看重价格和运营时间,光速云 年付折算约 7.5 元/月,2020 年运营至今。两家的 AI 能力均为品牌资料描述,实际可用性受节点 IP、地区和平台策略影响。
小结
Claude Code 在国内使用的关键只有一点:让终端也走代理。设置 HTTPS_PROXY 最简单,开启 TUN 模式最彻底;再把出口固定在美国或日本,登录时浏览器和终端保持同一出口,大部分问题都能避免。需要挑选稳定线路,可以从 机场推荐总榜 开始。
常见问题
Claude Code 一直卡住不动是什么原因?
最常见的原因是终端没有走代理。设置 HTTPS_PROXY 环境变量或开启 TUN 模式即可,详见 终端代理设置。
Claude Code 需要付费吗?
需要 Claude Pro / Max 订阅,或者使用 Anthropic Console 的 API Key 按量计费,免费账号无法使用 Claude Code。
Claude Code 的代理端口填多少?
填你代理客户端的本地 HTTP 或混合端口,常见为 7890 或 7897,以客户端设置页面显示的为准。
Claude Code 提示 Request not allowed 怎么办?
一般是出口地区不受支持,例如走了香港节点。把 AI 相关域名切到美国或日本节点后重试,节点选择见 AI 工具节点选择。
开启 TUN 模式后还需要设置 HTTPS_PROXY 吗?
一般不需要。TUN 模式会接管所有程序的流量,包括终端和 Claude Code 调用的子进程。
AI 工具 · 继续阅读
ChatGPT 国内怎么用:从网络环境、节点选择到账号注册
中国大陆不在 OpenAI 的服务地区内,需要先通过代理把出口切到受支持的地区(美国、日本、新加坡、台湾等,避开香港),再用邮箱或 Google / 微软 / Apple 账号注册登录;日常使用尽量固定一个节点,配合规则模式或 TUN 模式,即可稳定访问网页版、App 和 API。
ChatGPT Plus 怎么开通:官方付款渠道、费用与注意事项
ChatGPT Plus 只能通过官方渠道开通:网页端绑定 OpenAI 支持的银行卡付款,或在受支持地区的 App Store / Google Play 应用内订阅。开通前先固定一个受支持地区的节点,账单地址与节点地区尽量一致;第三方代充和共享账号存在封号、退款和隐私风险,不建议使用。
Claude 国内怎么用:网络环境、注册验证与账号防封
Claude 不向中国大陆和香港提供服务,国内使用需要把网络出口固定在美国、日本、英国等受支持地区;注册时可能需要受支持地区的手机号验证。Claude 对 IP 变动和共享 IP 比 ChatGPT 更敏感,建议使用干净的固定节点、开启 TUN 模式防 DNS 泄漏,并且不要多人共用账号。
OpenAI Codex 使用教程:CLI、IDE 插件与云端任务
Codex 是 OpenAI 的编程智能体,有命令行(Codex CLI)、IDE 插件和 ChatGPT 网页里的云端版本。国内使用需先让终端走代理(设置 HTTPS_PROXY 或开 TUN 模式),出口固定在美国、日本等受支持地区,然后用 ChatGPT Plus 及以上账号或 API Key 登录。
Gemini 国内怎么用:Google 账号、节点地区与常见问题
国内使用 Gemini 需要一个 Google 账号和受支持地区的网络出口(美国、日本、新加坡、台湾等,香港不行)。如果节点没问题仍提示地区不支持,往往是 Google 账号的“关联国家”被判定为中国或香港,需要检查账号的国家/地区设置。
Google AI Studio 使用教程:创建 API Key 与解决地区限制
Google AI Studio(aistudio.google.com)是 Google 面向开发者的 Gemini 模型调试平台,可免费试用并创建 Gemini API Key。国内访问需要代理,出口须在受支持地区;调用 API 时如果报 User location is not supported,说明请求从不受支持的地区发出,需要让代码也走代理。