Agnes AI最近有点火,免费、无限token的Agnes AI是真的离谱,而且它还能接入到Claude Code、codex上,今天这篇就跟大家分享一下Claude Code+Agnes安装及使用教程。 环境准备
安装前得先把Node.js和Git装好。打开Windows PowerShell依次执行:
安装 Claude Code
PowerShell里执行全局安装:
装完用claude --version校验,正常会输出类似2.1.193 (Claude Code)这样的版本号,没有报错就说明装成功了。
装 CC Switch,配置 Agnes 供应商
先去platform.agnes-ai.com注册登录,进API Key页面创建并复制一个新Key,这一步是后面配置的前提。
新增供应商时,供应商类型选claude,配置方式选自定义配置,主要填四项:
填完先点一次"获取模型列表",能拉到agnes-2.0-flash就说明Key和地址没填错,再按提示做模型映射。另外,自定义JSON配置区域里还需要手动补一个ANTHROPIC_AUTH_TOKEN字段,值就是上面创建的API Key,这是配置生效的必要一步,别漏掉。
加兼容参数、开路由
Claude Code跑起来时会带一些第三方模型不认识的字段,比如thinking、context_management,不处理容易直接请求失败。在CC Switch自定义参数里加上这段:
供应商配好后,回到CC Switch左上角设置页,进路由配置,打开本地路由总开关,同时启用Claude相关路由。开启后Claude Code的请求会先走CC Switch,再转到Agnes API。
验证链路
打开Claude Code,先发一句"你好",能正常回复就说明基础链路通了。界面上可能还显示Opus 4.8的字样,但底层其实已经在走agnes-2.0-flash,可以去看后台消耗token的模型是不是Agnes,或者直接问它有没有走Agnes来确认。如果提示找不到模型,用/model手动切到agnes-2.0-flash就行。
Claude Code + Agnes AI 实际使用效果
文本模型这块,Claude Code接入后可以直接拿来做前端页面开发。有人给了一个高颜值音乐社区单页Demo的需求,包含暗黑潮流风格、顶部导航、Banner横幅、热歌榜卡片等要求,Claude Code一两分钟就写完了,要求基本都满足。
图片和视频模型也开放了API,可以用Python直接调用。图片走的是/v1/images/generations接口,模型填agnes-image-2.1-flash,也可以让Claude Code把这个接口封装成一个Skill,调用起来更省事;视频走/v1/videos,模型是agnes-video-v2.0,提交任务后需要轮询task_id直到状态变成completed。
常见报错怎么查
下面这组报错归类来自Agnes官方对API接入问题的整理,不只针对Claude Code这一条链路,但因为调用的是同一套Agnes API,遇到问题时同样可以参考排查:
| |
|---|
| 上下文超限、请求参数与客户端/模型不兼容、视频参数不一致 |
| |
| |
| RPM超限,免费用户限制更低,4K图片频率限制更严格 |
| 参数问题,如图片尺寸非16的倍数、视频尺寸非64的倍数 |
| |
| |
| |
遇到问题别急着怀疑Key挂了,先对照这张表核对参数、地址和路由配置,大部分情况都能自己排查出来。
Claude Code+Agnes安装及使用教程走通后,日常前端开发、轻量代码任务都能用免费的Agnes模型顶上,配置成本不高,报错也基本有据可查,适合先跑通再逐步接入自己的工作流。