Agnes AI 免费使用全攻略（适配 CC Switch + Claude Code）

一、Agnes AI 免费使用规则（2026 最新）

从2026年6月开始，新加坡的 Agnes AI 开放了永久免费使用权限，覆盖文本、绘图、视频全部核心模型。没有套路、不用到期续费，也不需要绑卡、充值，普通个人日常使用完全足够。

平台开放三套核心模型，全部免费调用：

文本模型 agnes-2.0-flash（最推荐，主打编程） 没有总Token使用上限，支持超大上下文，日常稳定128K上下文，最长可支持百万级Token。不管是写代码、调试bug、梳理项目逻辑、总结文档、多轮对话，还是简单的识图问答、自动化任务都能搞定，非常适合搭配 Claude Code 写项目。
绘图模型 agnes-image-2.1-flash 支持文字生成图片、图片改图、画面修复、风格调整，最高支持4K高清画质，日常做海报、产品图、社交素材、创意插画都够用。
视频模型 agnes-video-v2.0 可以文字生成视频、图片转动态短片，自带音画同步效果，不用额外后期剪辑，适合做创意短视频、简单广告素材、角色动画。

只需要用普通邮箱注册账号即可，不需要海外手机号、不用实名认证、不用绑定银行卡，国内网络可以直接正常访问平台和接口。

免费账号每分钟最多可以发送20次请求，日常写代码、聊天、创作素材完全够用。如果短时间批量跑大量任务会轻微限流，等待几秒重试就好；企业大规模商用可以升级付费版本解除限制。

想要对接 CC Switch、Claude Code 等工具，首先要拿到自己的 API 密钥，步骤很简单：

通用固定接口地址（所有工具统一使用）：

1

Base URL：https://apihub.agnes-ai.com/v1

这套配置专门针对代码开发场景，设置好之后，Claude Code 会全程调用免费的 Agnes 模型。

打开 CC Switch，顶部切换到 Claude 标签页
点击右上角「+新增供应商」，选择自定义配置，填写以下信息：
- 供应商名称：自定义填写，比如 Agnes-Free-Code
- API Key：粘贴你刚才保存的 sk 密钥
- 请求地址：https://apihub.agnes-ai.com/v1
展开高级选项，必须开启两项关键设置：
- API 格式选择：OpenAI Chat Completions \(需开启路由\)
- 打开「需要本地路由映射」开关（不开启无法转发请求）
模型统一映射（全部指向免费编程模型）
- Sonnet、Opus、Haiku、Fable 全部映射为：agnes-2.0-flash
- 上下文窗口统一填写：131072
切换到「配置JSON」栏目，粘贴下面代码，解决 Claude 参数不兼容报错：

1
2
3
4


{
  "allowed_openai_params": ["thinking", "context_management"],
  "litellm_settings": {"drop_params": true}
}

粘贴完成后点击保存，供应商就配置好了。

很多人对接失败都是漏了这一步：

打开 CC Switch 左上角设置，进入路由页面，开启两个开关：

本地监听地址默认 127.0.0.1:15721，不用手动修改。

如果不想折腾 CC Switch 配置，只想快速试试模型效果，可以直接用在线测试工具，零部署、零配置，打开就能用，适合新手提前体验和调试参数。