太爽了！我把 Claude Code 的底层模型换了，换成了这个完全免费的！

大家好！我是瓜哥。前互联网技术副总裁，现在带队死磕 AI 编程。

有没有一种方案？

既可以用上优秀的智能体（Claude Code），又可以完全不用考虑词元（Token）成本。

今天向大家介绍，这套免费组合方案：Claude Code + Agnes LLM。

5月31日，Agnes 官方宣布免费，无API限制和地域限制。我只能说，太友好了吧。

但这个免费的大模型的能力到底行不行呢？

5 分钟上手清单

熟悉的直接照着清单上手，不熟悉的继续往下看。

1. 打开 https://platform.agnes-ai.com/login，用 Google 或 GitHub 登录

1. 点'API 密钥' → '创建新的密钥'，立刻复制 Key，弹窗关了就没了

1. 下载路由工具（见文末 GitHub 链接，按系统选版本）

1. 添加 Agnes 供应商，填入 Key 和请求地址 https://apihub.agnes-ai.com/v1

1. 打开路由开关，最容易忘的一步

1. 模型映射：Sonnet/Opus/Haiku 全部填 agnes-2.0-flash

1. 启动 Claude Code，确认顶部显示 agnes-2.0-flash

01 / 先看跑出来的成品

我让 Claude Code 从零写了一个俄罗斯方块。1 分 14 秒，一把跑通，在浏览器里能玩，消行逻辑和按键响应都没问题。

同一套配置，让它生成了一套《三个和尚》AI 绘本，人物和场景的风格一致性还不错，拿来做故事配图够用。

整个过程没花一分钱。 分别通过 API 调用 Agnes 的免费模型搞定。

02 / Agnes 是什么，三模型咋配置？

① Agnes 是什么？

Agnes 是新加坡公司 Sapiens AI 旗下的多模态大模型，目前三种能力都有：文本推理（写作、代码生成、逻辑分析）、图像生成与编辑、音画同步视频生成。

最关键的一条：现在完全免费，不设等待队列，不限量。

② 配置到 Claude Code

API 兼容 OpenAI 风格，原来接 OpenAI 的项目基本可以直接切过来，几乎不用改代码。

接 Claude Code 的时候，有一个细节要说清楚。

Claude Code 本身有三个模型角色——Sonnet、Opus、Haiku，分别对应不同任务的调用档位。我推荐的是： 三个角色全部映进行分别映射，处理不同的任务切到对应模型执行。

如果你是对接 Hermes 那就更舒服了，Hermes 提供了给不同模型指派不同任务的能力，直接将三个模型都配上，对应到不同的任务处理，类似这样：

这里就不展开了，有需要的小伙伴评论区留言，人多下期我单讲。

03 / 超细致配置步骤（CC为例）

第一步：拿到免费 API Key

访问 Agnes AI 平台，地址：

https://platform.agnes-ai.com/login

用 Google 账号或 GitHub 账号登录，不用填表单，秒通过。

进去之后，左侧菜单点「API 密钥」，再点右上角 「创建新的密钥」，起个名字保存就行。

这里有一个地方要注意：Key 的明文只出现一次，弹窗关掉之后就再也看不到了。复制完立刻粘到本地记事本，别偷懒，这是后面最容易踩的坑之一。

第二步：配置路由工具，把请求转到 Agnes

光有 Key 还不够。Claude Code 默认把请求打到 Anthropic 官方接口，需要一个中间层帮你把流量转发到 Agnes 的地址上。

我用的是 GitHub 上一个开源路由工具（文末放了链接），支持 macOS 和 Windows，下载对应版本安装就行。

打开工具，添加新供应商，按下面的参数填入：

供应商名称：Agnes官网链接：https://agnes-ai.comAPI Key：刚才复制的 sk- 开头的 Key请求地址：https://apihub.agnes-ai.com/v1API 格式：OpenAI Chat Completions（需开启路由）认证字段：ANTHROPIC_AUTH_TOKEN（保持默认）

填完之后，找到 Agnes 供应商旁边的路由开关，手动拨开。这一步很容易漏，漏掉的话请求还是走官方接口，Key 根本没生效，后面会细说。

然后进模型映射，把 Sonnet、Opus、Haiku 三个角色的'实际请求模型'全部填成 agnes-2.0-flash，保存。

我主要拿来编程，所以只配了agnes-2.0-flash。

启动 Claude Code，顶部如果出现 agnes-2.0-flash · API Usage Billing，说明接入成功了。

05 / 踩过的两个坑分享

坑一：路由没开。

第一次配完，测了一下，发现 Key 没生效。后来才发现，加完供应商和打开路由是两件事，供应商列表里有个独立的路由开关，当时直接忽略了。

加供应商 ≠ 开路由，这两步必须都做。

坑二：Key 没及时保存。

创建密钥的时候没当回事，弹窗关了才发现明文 Key 没了，平台上只剩掩码显示。只能回去删掉重建一条。不算太麻烦，但多折腾了一圈，Key 只显示一次这件事，

第一次用的时候真的容易忽视。

06 / 写在最后

说实话，现在的 AI 开发者真的太幸福了，AI 大厂拼命卷，各种免费的开源工具和 API 满天飞。

像 Agnes 这种，肯定比不上顶尖模型，但对付日常学习，跑 demo 这种小打小闹，性价比简直无敌。趁着现在免费，花 5 分钟跟着我的清单配上，哪怕作为日常的备选也行啊。

下一步我打算用来养小龙虾或 Hermes，看看能不能作为 token 消耗大户的平替选项。

如果你们有更好的经验和技巧？欢迎在评论区里聊聊，我们互相避坑。

扩展阅读

• Agnes AI 平台：https://platform.agnes-ai.com/login

• 路由工具 GitHub：搜索 xx-switch