Claude Code 国内免代理直连指南

网络、账号、额度——卡住国内开发者的三件事,两行环境变量逐个解决。

在国内用 Claude Code 需要解决的三件事

Claude Code 是 Anthropic 的命令行编码工具,安装本身没有任何门槛,真正卡住国内开发者的是三件事:网络能不能稳定连上、账号能不能长期存活、额度够不够用。下面按顺序给出可执行的路径。

1. 安装 CLI

准备 Node.js 18+,执行 npm install -g @anthropic-ai/claude-code,然后在项目目录运行 claude。首次启动会要求登录或配置 Token。

2. 配置国内直连网关

使用本站独享实例或按量 Key 时,只需设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 两个环境变量,本地无需挂载全局代理。

3. 查看 5h / 7d 实时额度与策略

在控制台实时查看 5 小时与 7 天窗口百分比;多号用户可配置 5h / 7d 停用保护线,避免跑到一半突然 429 断流。

两种接入方式怎么选

维度官方账号直连本站独享实例 / 兼容网关
网络要求需要稳定的海外出口,代理抖动会直接断流国内直连域名,不依赖本地代理
账号风险自建环境不当容易因跳 IP 触发风控平台侧固定美国住宅静态 IP与隔离容器,一机一线一号
额度与扩容取决于单个官方订阅档位单台 ¥250 / 30 天 全包,多台支持聚合 Key 自定义优先级与保护线
计费官方订阅费 + 静态代理成本固定月租,专属 Key 调用不另扣 Token 余额

如果只是临时试用,可以先用 8毛钱一刀 claude官转 按量渠道(¥0.8 / $1 · 0.8倍率);如果每天都要跑 agent,独享实例的稳定性与固定成本更省心。

常见坑

  • Base URL 多写 /v1:Claude Code 的 ANTHROPIC_BASE_URL 用站点根域名(按量 Key 用 https://claudeagent.com.cn,独享租号 Key 用 https://claudeagent.com.cn/rental-api),不要自己拼 /v1。
  • 用 root 跑客户端:部分环境会因此触发额外的权限与安全校验,建议用普通用户独立目录运行。
  • 频繁切换网络:自跑官方账号时,一会儿公司网、一会儿家宽、一会儿手机热点,出口 IP 反复变化是最常见的风控诱因。

常见问题

Claude Code 需要全局代理吗?

用官方账号直连需要稳定海外出口;使用本站独享实例或按量网关时只需要设置两个环境变量,本地不需要挂任何代理。

ANTHROPIC_BASE_URL 要加 /v1 吗?

不要。按量 Key 填站点根域名,独享租号 Key 填站点根域名加 /rental-api,多写 /v1 会导致 404。

为什么总是跑到一半断开或报 429?

自跑官方号常见原因是代理抖动;若是额度窗口打满返回 429,可通过聚合 Key 多号自动切换或 85% 停用保护线解决。

更新于 2026-11-11