[工具分享]CCSwitch 接入Claude 无限token本期将会分享开源免费的AI环境切换助手同时以AgnesAI来给大家演示完整配置。目前AgnesAI提供免费Token使用大家可完整体验整个流程。1. 概念CCSwitch 是一款开源免费的跨平台桌面 AI 环境切换助手支持 Windows、macOS 和 Linux。它的核心作用是帮你统一管理多个 AI 编程工具的 API 配置实现一键切换。简单来说如果你同时使用 Claude Code、Codex、Gemini CLI 等多个 AI 编程工具每个工具都需要单独配置 API Key 和模型参数——手动改来改去非常麻烦。CCSwitch 就是解决这个痛点的工具你只需要在 CCSwitch 里配置好各个 Provider供应商然后点一下就能切换它会自动把配置同步到对应的 CLI 工具中。CCSwitch 支持管理的 AI 工具包括Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent等七大主流工具。它还内置了 50 多个预设 Provider 配置覆盖了主流的中外模型服务商。本文将以Claude Code CCSwitch Agnes-2.0-Flash的组合为例手把手教你完成配置。Agnes-2.0-Flash 是 Agnes AI 开放的一款完全免费的文本模型支持 1M Token 上下文非常适合新手入门。2. 安装在开始配置之前需要先做一些前置工作。第一步下载并安装 CCSwitch官方网址https://www.ccswitch.io/zh/官方下载地址https://github.com/farion1231/cc-switch/releasesWindows 用户下载.msi安装包推荐支持自动更新双击运行安装程序默认安装到 C 盘建议修改到非系统盘如D:\Program Files\CC Switch如果不想写注册表可以下载 Portable 便携版.zip文件解压后直接运行CC-Switch.exemacOS 用户下载.dmg文件双击打开后将CC Switch.app拖入「应用程序」文件夹首次启动时如果提示“未知开发者”或“无法验证开发者”这是正常情况。关闭提示后前往「系统设置」→「隐私与安全性」找到 CCSwitch 相关提示点击「仍然打开」即可Linux 用户根据发行版选择.deb、.rpm或.AppImage格式使用.AppImage的话下载后添加执行权限即可运行第二步准备 Claude Code 环境可选如果你打算用 Claude Code 来调用 Agnes 模型需要先安装并配置好 Claude Code 基础环境安装 Node.js推荐 LTS 版本macOSbrew install node20Windows去 nodejs.org 官网下安装包一路 NextLinuxcurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs通过 npm 安装 Claude Codenpm install -g anthropic-ai/claude-code安装完成后可以在终端中运行claude命令验证是否成功提示如果你主要用其他工具如 Codex 或 Gemini CLI也可以跳过这一步配置原理是一样的。# 查看是否安装成功node-vclaude-v第三步注册 Agnes AI 账号并获取 API KeyAgnes AI 开放了多款核心模型的 API其中Agnes-2.0-Flash是完全免费、无限期使用的文本模型。Agnes 的 API 地址是https://apihub.agnes-ai.com/v1你可以分别按需去配置模型比如说文本模型agnes-2.0-flash图片模型agnes-image-2.1-flash视频模型agnes-video-v2.0注册步骤访问 Agnes AI 平台注册地址https://platform.agnes-ai.com/login 。可直接通过Github账号登录注册并登录账号进入后台的「API密钥」页面或直接访问https://platform.agnes-ai.com/settings/apiKeys点击「创建新密钥」生成一个新的 API Key复制并保存好这个 Key格式类似sk-xxxxxxxxxxxxxxxx。出于安全考虑之后你将无法再次通过账户查看这个 Key遗失需要重新生成3. 配置完成准备工作后就可以在 CCSwitch 中添加 Agnes 作为 Provider 了。第一步打开新增供应商界面启动 CCSwitch 后根据你要使用的 AI 工具点击顶部对应的图标例如我这里使用的是 Claude-cli就点击 第一个Claude图标然后点击右上角的「 新增供应商」。第二步创建自定义供应商预设供应商选择「自定义配置」供应商类型选择「自定义配置」第三步填写 API 信息填写以下关键信息配置项填写内容名称任意备注名如Agnes-FreeAPI Key粘贴刚才复制的 Agnes API Key请求地址https://apihub.agnes-ai.com/v1API 格式选择OpenAI Chat Completions 兼容格式第四步获取模型列表并添加模型在配置页面找到「模型映射」点击「获取模型列表」系统会自动读取当前账号可用的模型列表如果成功拉取到列表通过下拉框选择不同模型映射即可。我这里全部选择映射到agnes-2.0-flash点击「添加」完成模型创建Claude Code 真实跑起来时可能会带一些模型不认识的参数比如 thinking、context_management 这类字段。为了避免请求因为参数不兼容直接失败可以再CC Switch 里加如下参数allowed_openai_params:[thinking,context_management],litellm_settings:{drop_params:true}第五步开启本地路由映射重要如果你使用的是 Claude Code需要额外开启本地路由映射在配置页面找到「需要本地路由映射」选项打开开关进入 CCSwitch 的「设置」→「本地路由」确保以下两个开关都打开路由总开关开启Claude Code 路由开启⚠️很多新手配置完发现无法使用原因就是本地路由没有开启。这一步非常关键请务必确认第六步切换到新创建的渠道返回 CCSwitch 主界面点击刚刚创建的 Provider如Agnes-Free再点击「启用」。配置就会自动生效。4. 验证配置完成后可以通过以下方式验证健康检查在 CCSwitch 中点击 Provider 旁边的「健康检查」按钮发送测试请求来验证 API Key 和网络连通性重启客户端关闭并重新打开 Claude Code或你使用的其他 AI 工具让配置重新加载# 终端输入claude以启动claude cliclaude实际测试随便问一下看是否能正常返回结果如果健康检查通过但工具无法使用请检查本地路由开关是否已开启。同时如果虽然Claude页面显示还是Opus 4.8模型但因为我们做了模型映射实际请求已经走到了Agnes大家也可以到Agnes官网去查看自己的token用量。token用量查询地址https://platform.agnes-ai.com/billing/billing常见问题Q1首次启动 CCSwitch 时提示“未识别的开发者”A这是 macOS 的安全机制。关闭警告窗口后前往「系统设置」→「隐私与安全性」找到 CCSwitch 相关提示点击「仍然打开」即可。Q2系统托盘里没有 CCSwitch 图标AWindows 版本可能默认启动后隐藏在任务栏了点击系统托盘区域的小箭头展开查看。如果还是没有尝试重新启动软件。Q3切换 Provider 后 AI 工具没有生效A检查是否在 CCSwitch 顶部正确选中了对应的应用如 Claude Code 或 Codex因为每个应用的配置是独立管理的。另外记得重启对应的客户端。Q4获取模型列表失败A检查 API Key 是否正确、Base URL 是否填写为https://apihub.agnes-ai.com/v1。错误配置 Base URL 会导致 404 错误。Q5Agnes 模型真的完全免费吗A是的。Agnes AI 开放了核心全模态模型的 API免费、无限期开放、无需等待名单。文本模型 Agnes-2.0-Flash 支持 1M Token 上下文足够日常编程使用。总结通过 CCSwitch Agnes AI 的组合你可以零成本搭建一个多模型切换的 AI 编程环境。整个过程的核心步骤就是安装 CCSwitch跨平台3 分钟搞定注册 Agnes AI 获取免费 API Key免费无限期在 CCSwitch 中添加自定义 Provider填好 Base URL 和 API Key开启本地路由映射Claude Code 用户必做启用并测试配置完成后你就可以在 Claude Code、Codex 等工具中自由使用 Agnes-2.0-Flash 模型了。如果你平时在多个 AI 编程工具之间切换、手上有几套不同的 API 配置CCSwitch 绝对值得一试。