零成本玩转Claude Code：免费API接入与多模态实测

Claude Code 是目前公认最强的 AI 编程助手之一，但官方订阅费用不低。近期有 B 站 UP 主分享了一套「零成本」方案：通过 Agnes AI 免费模型平台 和 CC Switch 路由工具，让 Claude Code 无限免费调用文本、图片甚至视频生成模型。本文基于该视频内容，拆解配置流程并评估实际效果。

为什么需要这套方案？

Claude Code 本身负责代码生成与任务执行，但必须连接后端模型。官方方案需要付费订阅，或者手动对接第三方 API——本质上都要花钱。UP 主发现的新路径是：用 Agnes AI 作为免费后端，由 CC Switch 负责接口转发。

Agnes AI 并非套壳或中转站，其文本、图片、视频三类模型均为自研，直接对标 OpenAI、Google 等第一梯队。最关键的是，它将全模块接口完全免费开放，不限期限、不限量。据 UP 主引用数据，免费开放后首周文本模型调用量超过 1 万次，图片生成超过 200 万张，视频生成超过 200 万秒。对用户而言，这是实打实的福利。

模型映射（Model Mapping） 是 CC Switch 这类路由工具的核心功能之一。Claude Code 内部会针对不同任务调用不同的模型标识（如执行代码生成时用某个模型、做轻量规划时用另一个），若不干预，这些请求会直接发往官方后端。模型映射的做法是在路由层建立一张对照表，把前端可能发出的任意模型名统一改写为后端实际可用的模型名。这样即便 Claude Code 请求了一个 Agnes 平台上并不存在的模型，路由也会将其重定向到 Agnes 2.0 Flash，从而避免 404 或鉴权失败。映射表通常支持多条规则并存，是让第三方后端「冒充」官方接口的关键机制。

三个工具的分工

Claude Code：前端执行工具，负责写代码、处理任务、调用模型。
Agnes AI：提供免费 API 的模型平台，覆盖文本、图片、视频生成。
CC Switch：开源免费的接口切换器，统一管理 Claude Code 的后端地址与模型映射。

UP 主总结得直白：Claude Code 负责干活，Agnes AI 提供免费模型，CC Switch 把它们连起来。

Cloud Code要连哪个后端

手把手配置：从 API Key 到路由启用

第一步：获取 Agnes 免费 API Key

打开 Agnes AI 的 API 开放平台，左侧菜单进入「API 密钥」，点击「创建新的密钥」，随意命名即可生成。

API Key 是一串由平台生成的凭证字符串，相当于调用模型接口的「门禁卡」。请求方每次访问网关时都要在 HTTP 头（通常是 Authorization 字段）里带上它，服务端据此识别身份、统计用量并限流。CC Switch 中的「鉴权字段」选项就是在指定这个凭证应该放在哪个请求头、以什么前缀（如 Bearer）发送。由于 Key 等同于账户权限，泄露后他人可冒用你的额度，因此不应写入公开的代码仓库，建议放在本地配置文件或环境变量中管理。免费平台的 Key 一般可随时在后台吊销重建。

第二步：在 CC Switch 中配置供应商

打开 CC Switch，顶部工具栏切换到 Claude Code 配置项，点击右上角「+」新增供应商：类型选择 Cloud Provider，再选「自定义供应商」。随后填写：

API Key：粘贴刚才复制的 Agnes 密钥。
请求地址：填写 Agnes 网关地址，用于转发 Claude Code 的请求。
API 格式：选择鉴权字段，保持默认。

填完后点击「获取模型列表」，若能拉出一串模型名称，说明已成功连接 Agnes。接着做 模型映射：将 Claude Code 可能调用的多个模型全部映射到 Agnes 2.0 Flash，这样无论前端请求哪个模型，实际都走免费后端。确认后保存，供应商列表会出现 Agnes 项。

模型供应商列表里面

第三步：开启本地路由并启用

仅配置供应商还不够，CC Switch 需要真正转发请求。点击左上角「设置」进入路由界面，打开「本地路由」，再开启 Claude 的路由开关。回到供应商列表，找到 Agnes 并点击「启用」。此后 Claude Code 的所有请求都会经 CC Switch 转发到 Agnes 免费网关。在终端输入 Claude 命令发送一条「你好」，收到回复即表示配置成功。

实测：免费模型能做什么？

文本模型：从数据复盘到商务落地页

UP 主用一份真实的视频运营数据（100 多条、横跨多个平台）测试。在 Claude Code 中调用 Agnes 2.0 Flash，要求生成运营复盘看板——输出结果包含图表、筛选、明细，排版清爽，可直接用于日常复盘。随后升级为「发给品牌方的商务合作落地页」，同样完整，数据快照、合作方式一应俱全。从普通表格到复盘看板再到商务页面，全靠免费模型完成。

免费的模型能够做出这样的效果

图片生成：文生图与图生图

由于 Claude Code 只能接入文本模型，UP 主创建了一个专门调用 Agnes 生图模型的 Skill。在对话框输入提示词，Claude Code 自动调用 Skill，图片直接生成到项目目录。

文生图测试：提示词为「35 毫米胶片职场风格人像」，输出画面具备胶片质感、闪光灯高光、皮肤纹理与毛孔细节，街头运动氛围到位。UP 主指出，付费生图模型单张稍好的效果就要几毛钱，而 AI 生图往往需要反复抽卡，成本叠加不低；在 Agnes 上完全零成本，随便抽、随便试。

图生图测试：给一张参考图让模型二次创作，输出标准职业形象照——半身构图、表情自然、笑容真诚，脸还是原来的脸，但衣服、背景、灯光全部替换。这种「换装不换脸」的能力，可用于将生活照转为简历或领英头像。

我们来看看效果

视频生成：连贯表情与偶发瑕疵

用提示词生成「红发女歌手唱歌」短视频，画面为半身特写，卷发发丝与逆光高光清晰。UP 主认为最难得的是表情递进：从闭眼酝酿到张嘴开唱，再到皱眉沉浸，嘴形、呼吸节奏连贯，没有 AI 常见的僵硬感。

不过视频模型偶尔也会「抽风」：另一段夜晚街拍视频中，女主和背景夜景逼真，但左侧路人突然「克隆」成两个人。UP 主对此态度轻松——毕竟是免费不限量，多抽几次卡即可，主体稳定就够了。

这套方案适合谁？

对于想体验 Claude Code 但不愿承担订阅费用的开发者、内容创作者，这套组合降低了门槛。需要提醒的是，免费第三方 API 的稳定性、数据隐私和长期可用性存在不确定性，建议仅用于非敏感项目和学习探索。UP 主的实测表明，免费模型在文本、图片、视频三个维度均达到「可用」水平，尤其适合需要大量试错的生图与视频场景。

本文基于 B 站 UP 主分享内容整理，配置细节请以官方文档和工具最新版本为准。

背景补充

文生图与图生图 是图像生成模型的两类基本输入形态。文生图（text-to-image）只接收文字提示词，模型从零合成画面，结果随机性较大，所以常需要「抽卡」——反复调整提示词或多次生成来挑选满意结果。图生图（image-to-image）则在文字之外额外输入一张参考图，模型在保留原图部分结构（如人脸、构图）的前提下按提示词改造风格、服饰、背景，常见于换装、风格迁移和头像制作。两者对算力的消耗不同，图生图通常需要更强的细节保持能力，也是评估模型是否实用的重要指标。