Claude Code 国内直连:不用代理、不用海外账号,十分钟跑通
实测在一台境内 Linux 上把 Claude Code 装好并直连国内可达的 Anthropic 兼容端点:官方脚本为何失败、npm 12 拦截 postinstall 怎么解、模型名该怎么填,以及四个常见坑的对照表。
文章目录
相比 11 月 4 日那篇《Claude Code 国内部署:绕不开区域限制与模型接入》,这次的新进展是:装完之后模型到底怎么接,已经有了确定答案——不用代理,用国内可达的 Anthropic 兼容端点直连。
1、先说结论:装得上,而且不用代理
1、先说结论:装得上,而且不用代理 · AI 生成示意图
很多人以为 Claude Code 在国内装不了或者必须挂代理。实测下来,卡住安装的其实是两个具体的技术细节,而"访问海外模型"这件事,现在有更省事的解法:让 Claude Code 直接连国内可访问的 Anthropic 兼容端点。
我在一台境内的 Linux 机器(Arch 系 pearOS,Node v26)上完整跑通了这条路,从零到能用一共四步,耗时不到十分钟,全程没有配任何代理。
先说最常踩的第一个坑:官方安装脚本在境内会直接失败。
# 这条在国内机器上会返回一张"App unavailable in region"的网页
curl -fsSL https://claude.ai/install.sh | bash
它不是脚本下载失败,而是服务端按地区直接返回了页面。所以要走 npm 路线。
2、npm 装 Claude Code:先放行 postinstall
2、npm 装 Claude Code:先放行 postinstall · AI 生成示意图
# npm 12 起默认拦截依赖的安装脚本,不放行的话二进制不会落地
npm config set allow-scripts=@anthropic-ai/claude-code --location=user
# 用户级安装,不需要 root
npm install -g --prefix ~/.local/npm @anthropic-ai/claude-code
export PATH="$HOME/.local/npm/bin:$PATH"
claude --version
# -> 2.1.318 (Claude Code)
这里有两个值得记的点:一是不用 root也能装,--prefix ~/.local/npm 把所有东西放在用户目录里,运维和卸载都干净;二是 npm 12 的新策略会拦 postinstall,报错文案是 "install scripts blocked",很多人会以为装失败了,其实是差一条 npm config set。
3、接上通道:把请求发到国内可达的兼容端点
装好只是壳,还得给它一个能用的模型通道。关键在于 CLI 认的是 Anthropic 的协议(/v1/messages),所以只要对方提供 Anthropic 兼容端点,改两个环境变量就能直连。
mkdir -p ~/.config/avanda
cat > ~/.config/avanda/claude.env <<'ENVEOF'
export ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic
export ANTHROPIC_AUTH_TOKEN=你的密钥
export ANTHROPIC_API_KEY=你的密钥
export ANTHROPIC_MODEL=claude-sonnet-4-5
export ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-5
export PATH="$HOME/.local/npm/bin:$PATH"
ENVEOF
chmod 600 ~/.config/avanda/claude.env
grep -q 'avanda/claude.env' ~/.bashrc || echo '[ -f ~/.config/avanda/claude.env ] && . ~/.config/avanda/claude.env' >> ~/.bashrc
验证很简单,-p 是非交互模式,直接当命令用:
claude -p "用一句话说明你能做什么"
# -> 我可以在你的终端里读写代码、执行命令、排查 Bug、开发功能……
模型名有个坑:写 MiniMax-M3 会提示"Claude Code 不认识这个模型,按 20 万上下文估算",虽然也能跑,但会一直提醒;写通道确实认识的 claude-sonnet-4-5 就干净了,通道会把它映射到实际后端。
4、四个坑,一张表说清
| 现象 | 根因 | 处理 |
|---|---|---|
| 官方脚本装完报错 | 服务端按地区返回页面 | 改走 npm 安装 |
| install scripts blocked | npm 12 拦截 postinstall | 先 npm config set allow-scripts=... |
| claude: command not found | PATH 没带上 | 把 export PATH 写进 shell 配置 |
| 提示无法识别模型名 | 模型 id 通道不认识 | 用通道支持的 id(如 claude-sonnet-4-5) |
| 401 认证失败 | 密钥没生效 | 检查 env 文件与 x-api-key 是否同一把 |
5、这套直连方案,和"官方+代理"怎么比
| 维度 | 官方 + 代理 | 国内兼容端点直连 |
|---|---|---|
| 首次配置 | 账号、网络、客户端三件事 | 一个 base_url + 一把密钥 |
| 稳定性 | 取决于代理线路 | 国内直连,延迟更低 |
| 账号风险 | 共享账号易被限流 | 无海外账号 |
| 成本 | 官方定价 + 代理成本 | 按国内通道计费 |
| 适合 | 必须用海外模型 | 团队日常开发与批量任务 |
两条路不冲突:关键任务可以走官方,其余日常任务走直连通道,成本和稳定性都能压下来。
写在最后
这件事的价值不在"又装了一个工具",而在于它把"AI 编程助手"从"要额外准备网络环境"变成了"装完就能用"。我们把这套配置连同体检脚本做成了标准交付件,团队里每个人按一份清单十分钟就能拉起来。
需要在自己的机器上拉起这套通道,或想把它接进现有的模型网关,站内服务页有完整说明与报价:查看阿凡达技术服务。
相关阅读
- 阿凡达开源站(项目目录):https://blog.zgyun.com.cn/hub/
- 前一篇(区域限制与模型接入):/posts/claude-code-cn-deploy-log
- Claude Code 团队落地:三道关口比安装更重要:/posts/three-blockers-for-claude-code-in-china
- 出海模型接入三方案与成本对照:/posts/model-gateway-three-plans-cost-table
- 会员专属下载:交付报告、验收清单与团队培训讲义:/posts/member-delivery-kit-download
文中链接
整理自本文的外部链接,请以来源页面说明为准。