0. 前言：当开发者遇到“物理”高墙

最近 Anthropic 发布的 Claude Code 这种 Agentic Coding 工具在技术圈刷屏了。作为一名开发者，谁不想体验一下“一句话生成代码”的快感？

但在国内尝试部署时，我瞬间被泼了一盆冷水。不仅需要“魔法”网络环境，还需要 Anthropic 官方账号，甚至必须绑定支持海外支付的信用卡（还要面临随时封号的风险）。 这一套“组合拳”下来，足以劝退 90% 的人。

这就没法玩了吗？ 当然不是。

本文将分享我如何在 Windows 10 环境下，利用聚合 API（Agicto）配合特殊的“环境变脸大法”，成功绕过官方登录验证，在本地跑通 Claude Code 的全过程。 其中包含两个我排查了很久才解决的致命配置坑点，希望能帮你节省一下午的时间。

---

1. 工具简介与破局思路

• Claude Code 是什么： 一个在终端运行的 AI 编程助手，它能直接读写你的本地文件、运行终端命令，甚至帮你提交 Git。
• 核心矛盾： 官方安装流程强依赖 claude login，这步需要浏览器跳转认证。
• 我的破局思路： Claude Code 本质上是基于 HTTP 请求的大模型应用。只要通过环境变量接管它的 API 地址和认证 Token，理论上就能跳过繁琐的 OAuth 登录流程，直接让它“干活”。

---

2. 环境准备

在开始之前，请确保你的本地环境满足以下最基础的要求：

• 操作系统： Windows 10 (本文演示环境) / macOS / Linux
• 核心依赖： Node.js (官方推荐 curl 安装，但国内网络下极易超时，强烈建议用 npm)
• 关键凭证： 一个可用的聚合大模型 API Key（本文以 Agicto 为例，因为它兼容 Anthropic 协议）。

---

3. 部署实战：三步走绕过限制

第一步：安装工具（避开官方 curl 坑）

官方文档推荐用 curl 下载安装脚本，但在国内大概率会卡在连接超时。我们采用更稳妥的 npm 方式：

# 1. 确保已安装 Node.js，在终端验证版本
node -v 

# 2. 使用 npm 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

此时如果直接运行 claude，你会发现系统提示“区域不支持”或者强制要求浏览器登录。别急，下面才是重头戏。

第二步：配置“绝招”环境变量

这是本文最核心的操作。我们需要在系统环境变量中“欺骗” Claude Code，让它以为我们已经登录了，并且把请求地址指向国内可访问的中转服务。

Windows 配置路径： 此电脑 -> 属性 -> 高级系统设置 -> 环境变量 -> 系统变量 -> 新建

我们需要配置两个关键变量：

变量名	变量值 (示例)	说明
ANTHROPIC_BASE_URL	https://api.agicto.cn	注意： 后面千万别带 /v1 (详见后文踩坑)
ANTHROPIC_AUTH_TOKEN	sk-xxxxxxxxx	你的 Agicto API Key

第三步：验证运行

配置完成后，重启终端（非常重要，否则环境变量不生效），输入：

claude

如果一切顺利，你将直接进入对话界面，不再弹出浏览器登录窗口！

---

4. 🔥 避坑指南：我踩过的两个“死循环”

这部分是我花了一下午时间试错总结出来的经验，也是本文最有价值的部分。

❌ 坑点一：傻傻分不清的 API_KEY 与 AUTH_TOKEN

现象：
我最初按照惯性思维，配置了 ANTHROPIC_API_KEY 变量。结果运行 claude 时，依然顽固地要求我进行网页登录，根本无法跳过。

原因分析：
Claude Code 的 CLI 逻辑中，API_KEY 仅用于底层调用，而只有检测到 ANTHROPIC_AUTH_TOKEN 时，它才会认为用户已经完成了身份认证（Session 建立），从而跳过 OAuth 登录流程。

✅ 解决方案：

• 删掉 ANTHROPIC_API_KEY
• 新增 ANTHROPIC_AUTH_TOKEN，并将你的 API Key 填入该变量。
• 一句话总结：用 Token 的名义传 Key，这是绕过登录的钥匙。

❌ 坑点二：多此一举的 /v1 后缀

现象：
解决了登录问题后，CLI 启动成功，但在对话时总是报错：
Error: model not found 或者 404 Not Found。

原因分析：
Agicto 的官方文档给出的 Base URL 通常是 https://api.agicto.cn/v1。但是在 Claude Code 内部逻辑里，它会自动拼接路径。如果你配置了带 /v1 的地址，最终请求地址可能会变成 .../v1/v1/messages，导致请求失败。

✅ 解决方案：
修改环境变量 ANTHROPIC_BASE_URL，去掉末尾的 /v1。

• 错误写法：https://api.agicto.cn/v1
• 正确写法：https://api.agicto.cn

---

5. 成果展示

经过上述配置调整后，终于成功在本地跑通了 Claude Code。

截图 1：环境变量配置参考

截图 2：成功运行并对话
可以看到，终端显示 Welcome back!，并且成功识别到了模型（虽然提示是 Haiku/Opus，实际上走的聚合渠道）。

实测体验：

• 无需开启任何代理工具，连接稳定。
• 可以直接让 Claude 读取我本地 F:\Nwy_Prjs 下的代码文件进行分析，响应速度完全取决于聚合 API 的转发速度，整体非常丝滑。

---

6. 总结

在 AI 落地过程中，环境配置往往是最大的拦路虎。通过**“环境变量劫持”**的方法，我们成功让 Claude Code 在国内无障碍运行。

核心要点回顾：

1. 放弃 curl，使用 npm 安装。
2. 必须使用 ANTHROPIC_AUTH_TOKEN 才能跳过登录。
3. Base URL 记得去掉 /v1。

希望这篇避坑笔记能帮大家省下折腾环境的时间，把精力真正花在体验 AI 编程带来的效率提升上。如果你在配置过程中遇到其他问题，欢迎在评论区留言交流！

---

我是hets，专注分享 AI 开源项目的实战落地经验。
本文纯分享，并非给AGICTO打广告，理论上只要支持claude模型的聚合API都可以。（如：openrouter、cherryin等等）