Claude Code 教程：安装、登录与终端代理设置（2026）

Claude Code 是什么，为什么需要机场

Claude Code 是 Anthropic 推出的命令行工具，你在终端里用自然语言描述任务，它读取当前项目的代码、调用 Claude 模型生成修改、经你确认后直接编辑文件、运行测试、提交代码。它的定位与 Codex CLI 类似，都是「住在终端里的编程代理」，网络配置方式也几乎相同。

国内使用需要机场的原因分三层。第一，Claude Code 的全部请求发往 Anthropic 的 API 域名，国内无法直连。第二，Anthropic 对请求来源地区有限制，不在官方支持地区列表内的出口 IP 会被拒绝；支持哪些地区以 Anthropic 官方页面为准，列表会调整，我们不在文章里给固定清单。第三，Claude Code 运行在 Node.js 环境里，不读浏览器代理，默认也不一定读系统代理设置。浏览器能打开 claude.ai，不等于终端里的 Claude Code 能连上，这是新手最常卡住的地方。

还有一点与 ChatGPT 系工具不同：Claude 对地区比 ChatGPT 更敏感，香港节点基本不可用，台湾节点也不稳定。如果你的机场只有香港和台湾节点可用，Claude Code 大概率用不了。详细的地区讨论见 Claude 网络指南。

装 Claude Code 之前：机场客户端和端口先就位

Claude Code 通过 npm 安装，安装过程本身要访问 npm 仓库和部分依赖的下载源。国内直连 npm 通常能成功但偶尔超时，建议安装前就把终端代理设好。

1. 确认机场客户端正在运行，并且至少有一个美国、日本或新加坡节点可用。可先在浏览器里打开 claude.ai 验证节点是否被 Anthropic 接受。
2. 找到客户端的本地 HTTP 代理端口。Clash Verge Rev 在「设置 → 端口设置」，默认混合端口 7890；sing-box、v2rayN、Shadowrocket 的端口各自不同，以各自设置页为准。
3. 确认 Node.js 版本满足要求，具体版本以 Claude Code 官方文档为准。
4. 先设置代理环境变量（见下一节），再执行 npm 全局安装。安装命令以官方文档为准。

安装过程中出现 ETIMEDOUT、ECONNRESET 基本都是代理没生效；出现 EACCES 是 npm 全局目录权限问题，与网络无关，按 npm 官方建议修复目录权限即可。

让终端里的 Claude Code 走代理

这是本文的核心。Claude Code 会读取标准的代理环境变量，设置方法如下：

# 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

# Windows PowerShell
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:HTTP_PROXY = "http://127.0.0.1:7890"

# Windows CMD
set HTTPS_PROXY=http://127.0.0.1:7890
set HTTP_PROXY=http://127.0.0.1:7890

设置后在同一个终端里运行 claude，请求经本地端口进入客户端，再由客户端按规则选节点。注意事项：

• 端口以客户端为准。7890 只是 Clash 系默认值。端口写错会立刻报 ECONNREFUSED。
• 环境变量只在当前会话有效。新开终端要重新设置。长期使用把 export 行写进 ~/.zshrc 或 ~/.bashrc，Windows 加到系统环境变量。
• NO_PROXY 包含 localhost。用 Claude 账号登录时授权回调访问本机端口，不排除会失败。
• 大小写都设。Node.js 同时识别大小写，但某些依赖只认其中一种。
• 客户端规则要对。环境变量只决定流量进入客户端，anthropic.com 最终走哪个节点由客户端规则决定。把 anthropic.com、claude.ai 归入固定美国节点的策略组。

另一种方式：TUN 模式

在客户端开启 TUN（增强）模式后，系统全部流量自动走代理，终端里任何程序都不需要环境变量。同时用 Claude Code、Codex CLI、Cursor 的用户用这种方式最省事。代价是规则要配得完善，否则国内流量被送出去会变慢，或者 AI 域名漏掉走直连。方法见 TUN 模式教程，开了 TUN 没网见 TUN 模式无网络排查。

验证链路

curl -I https://api.anthropic.com

返回任何 HTTP 状态码（包括 4xx）都说明代理链路通了；长时间无响应或 Connection refused 则先解决代理。链路通了但 Claude Code 报地区错误，问题在节点地区而不在代理。

Claude 账号登录与 API Key：各自对网络的要求

Claude Code 支持两种身份验证，网络要求不同。

Claude 账号登录

启动 claude 后选择用 Claude 账号登录，它会打开浏览器跳到 Anthropic 授权页，确认后结果通过回调发回本机。涉及浏览器与终端两个程序，两者必须走同一地区节点。浏览器走美国、终端走日本，Anthropic 可能判定为异常登录。

做法是在客户端把 anthropic.com、claude.ai 统一归入一个「AI 服务」策略组并固定美国节点，浏览器与终端的请求都由同一条规则处理。规则配置见 规则分流教程。另外浏览器时区、语言与节点地区匹配可以减少额外验证，这部分在 Claude 网络指南里有详细说明。

此方式要求账号有有效的付费订阅，哪些档位包含 Claude Code 额度以官方页面为准。账号注册地区与日常使用地区保持一致，减少风控。

API Key 方式

有 Anthropic API 账号的用户可以把 API Key 设为环境变量后直接使用，不经过浏览器授权。只要终端能访问 api.anthropic.com 即可，适合服务器和远程开发环境。费用按 API 用量计费，与订阅是两套体系，以官方页面为准。

两种方式都要求出口节点在支持地区内。API Key 方式还有一点：API 账号的组织所在地区在注册时就确定了，后续调用的出口 IP 最好与之一致。

节点选择：稳定性优先

Claude Code 的网络模式是长请求加流式返回：一次 Agent 任务可能发送几万 token 的上下文，然后持续接收几十秒到几分钟。节点的长连接稳定性比延迟重要。延迟 180ms 但不掉线的美国专线，体验好于延迟 50ms 但晚高峰频繁重连的中转。

策略组一定要手动固定，不要自动测速。会话中途切换出口 IP 会导致 Anthropic 直接断开当前请求，重试要重新发送全部上下文。专线与中转的区别见 IEPL 与 IPLC 对比；圈内常提的「原生 IP」概念见 原生 IP 科普，但本站 17 家品牌资料都没有标注它，我们不以此作为推荐依据。

Claude Code 报错速查

适合 Claude Code 的机场（品牌资料标注 AI 场景）

Claude Code 依赖 Anthropic 服务，机场选择标准与 Claude 一致：品牌资料有 AI 标注、专线为主、能按月买。下表列出品牌资料有 AI 标注的 12 家，按本站综合评分排序，「AI 标注」一列直接取自品牌资料：只有速界明确写了 Claude，其余 11 家写的是「常见 AI 工具（未指明平台）」，Claude Code 能不能用要自己验证。各家美国、日本节点的情况以官网和 测速页 的 2026-08-11 测速截图所列地区为准。

针对编程场景的补充：

• 速界是唯一明确标注 Claude 的，¥25/月 150GB，VLESS + IEPL + 自研客户端，流量对 Claude Code 的 5–20GB 月用量绰绰有余；2024 年起运营、风险「中」，先月付。
• 光速云2020 年起运营，IEPL + 企业级内网专线、自研客户端，标注常见 AI 工具；入门 59GB 对个人开发者够用，但 ¥7.5/月是年付折算价，建议先在月付机场验证 Claude 可用再锁定。
• U1S1¥20/月 120GB，VLESS + IEPL + 自研客户端，2023 年起、风险「低」，标注常见 AI 工具，月付里最均衡；SOGO 云¥25/月 150GB 规格更高，但 2026 年新品牌只建议月付。
• 二猫云¥20/月 130GB，VLESS + IEPL，标注常见 AI 工具，会用 Clash 的开发者可按月验证。
• 星岛梦、宇宙云、唯兔云、灵猫网络、可信云品牌资料没有 AI 标注，不建议为 Claude Code 购买；星岛梦是价格主推，不是 AI 推荐。多台开发机的设备数本站 17 家都以官网为准。

更多对比见 Claude 机场推荐与 AI 解锁榜。

流量估算与多工具配合

Claude Code 每次请求携带代码上下文，流量比网页聊天大。日常开发每月 5–20GB 比较常见，让它批量重构大型仓库时更多。100GB 以上的套餐基本不用考虑。估算方法见 每月需要多少流量。

如果你同时用 Codex CLI、Cursor 或 Copilot，建议客户端开 TUN 模式，建一个 AI 策略组覆盖 anthropic.com、openai.com、Google 域名组和 GitHub，固定同一个美国或日本专线节点。所有工具看到的地区一致，排查只看一个策略组。不开 TUN 时，Claude Code 与 Codex CLI 可以共用同一组 HTTPS_PROXY 环境变量，写进 shell 配置文件一次搞定；Cursor 的图形化代理设置见 Cursor 网络指南。

常见问题