夜雨聆风全文约3500字，阅读约10分钟，跟着操作约20分钟即可完成。
大家好，我是你们的技术老司机🚗Java老兵搞AI
最近AI编程工具火得不行，但很多小伙伴反映：Claude Code不知道怎么装、装了不知道怎么换模型、换了模型又怕烧钱。今天我就把这三件事一次性给你讲明白，手把手带你把 Claude Code + CCSwitch + AgnesAI 这套组合装好，全程免费，小白也能看懂。
一、先搞清楚这三样东西是什么
在动手之前，花2分钟了解一下这三个工具各是干什么的——理解了就不容易出错。
Claude Code：Anthropic 推出的终端AI编程助手。它不像网页版Claude那样只能聊天，而是可以直接读取你的项目文件、修改代码、执行命令、排查Bug。简单说，它就是一个「住在你终端里的AI程序员」。
CCSwitch：一个图形化配置工具，用来给Claude Code更换「大脑」。Claude Code默认只能用官方模型，对国内用户来说又贵又不方便。CCSwitch可以让你一键切换到国产模型或其他兼容API，内置了50+个供应商预设。
AgnesAI：新加坡SapiensAI推出的免费多模态API平台。注册不需要绑卡、不需要手机号，提供文本、图像、视频三种模型能力。文本模型 Agnes-2.0-Flash 支持百万级上下文，完全够日常编程用。
二、准备工作（必做！）⚠️ 千万别跳过这一步，很多小白装不上就是因为环境没准备好。
检查系统要求
Claude Code 支持 Windows 10/11、macOS 10.15以上、Linux（Ubuntu 20.04+等）。
安装 Node.js（最关键的一步！）
Claude Code 依赖 Node.js 18 或更高版本。
Windows 用户：打开 https://nodejs.org/zh-cn/download下载 Windows 安装包（.msi），双击运行一路「下一步」完成安装macOS 用户：方式一：去 https://nodejs.org/zh-cn/download 下载安装包方式二（推荐）：打开终端，输入 brew install nodeLinux 用户：去 https://nodejs.org/zh-cn/download 下载对应版本3. 验证安装是否成功
打开终端（Windows打开PowerShell或命令提示符），分别输入：
node -vnpm -v
如果能看到版本号（如 v20.x.x 和 10.x.x），说明安装成功✅ 如果提示「不是内部或外部命令」，说明Node.js没装好，重新装一遍。
设置国内镜像源（加速下载）
这一步强烈建议做，不然npm下载可能会慢到怀疑人生：
npm config set registry https://registry.npmmirror.com/三、安装 Claude Code（一条命令搞定）
环境准备好之后，安装 Claude Code 真的就一条命令的事。打开终端，输入：
npm install -g @anthropic-ai/claude-code
装完之后验证一下：
claude --version
能看到版本号就说明装好了✅
💡 小提示：Windows用户请以管理员身份打开PowerShell或命令提示符再执行安装命令。注意，暂时先不要启动claude code，等按照下面的步骤全部配置完后再启动，否则claude code会要你在官网的账号才能使用，我们本教程的重点是“拒绝Token焦虑”，所以一定要按照找本教程进行操作；
四、安装 CCSwitch（拒绝Token焦虑的关键点一）
CCSwitch 是一个桌面应用，有界面、点鼠标就能操作，对小白极度友好。
下载地址访问 GitHub Releases 页面下载最新版本：👉 https://github.com/farion1231/cc-switch/releases
Windows 安装
提供两种方式：
MSI安装包（推荐）：下载 CC-Switch-v{版本号}-Windows.msi，双击运行，一路下一步。建议把安装路径改到非系统盘（如 D:\Program Files\CC Switch）。绿色版（免安装）：下载 CC-Switch-v{版本号}-Windows-Portable.zip，解压后直接运行 CC-Switch.exe。
如果遇到 SmartScreen 拦截，点击「更多信息」→「仍要运行」即可。
macOS 安装
提供两种方式：
Homebrew安装（推荐）：
brew tap farion1231/ccswitchbrew install --cask cc-switch
手动安装：下载 CC-Switch-v{版本号}-macOS.dmg，双击打开，把 CC Switch.app 拖进「应用程序」文件夹。
首次打开如果提示「无法验证开发者」，去「系统设置」→「隐私与安全性」→ 点击「仍要打开」。
Linux 安装
根据你的发行版选择：
Debian/Ubuntu：下载 .deb 包，执行 sudo dpkg -i CC-Switch-v{版本号}-Linux.deb通用方案：下载 .AppImage 文件，chmod +x 后直接运行五、获取 AgnesAI 免费 API Key（拒绝Token焦虑的关键点二）
重点来了！AgnesAI 完全免费，不需要绑信用卡。
第一步：注册账号
打开 AgnesAI 开发者平台：👉 https://platform.agnes-ai.com/
点击注册，用邮箱完成注册即可。不需要绑卡、不需要手机号。
第二步：获取 API Key
登录后：
左侧菜单找到「API 密钥」（或「API Keys」）点击「创建新密钥」（或「Create New Key」）系统会生成一串类似 sk-xxxxxxxxxxxxxxxxxxxxxxxx 的密钥。如下图所示：
⚠️ 立即复制并保存好！ 关闭页面后就看不到了。六、配置 CCSwitch 接入 AgnesAI
这是最后一步，也是最关键的一步——把免费的 AgnesAI 模型装进 Claude Code 里。
第一步：启动 CCSwitch
找到并打开 CCSwitch 应用。Windows桌面会有快捷方式，macOS在「应用程序」里。
第二步：确认应用类型
打开后，在顶部应用切换器中，确认当前选中的是 Claude（或 Claude CLI / claude-cli）。
第三步：添加供应商
点击右上角的 「+」按钮（或「Add Provider」）。
在「预设」下拉框中，选择 「自定义配置」 （Custom）。
第四步：填写 AgnesAI 信息
在打开的配置面板中填写以下内容：
字段 填写内容名称 随便填，比如「AgnesAI」API Key 粘贴刚才复制的 Agnes API Key端点地址（Base URL） https://apihub.agnes-ai.com模型名称 Agnes-2.0-Flash💡 Agnes API 完全兼容 OpenAI 格式，所以用「自定义配置」方式添加即可。
第五步：启用并保存
填写完成后点击「添加」或「保存」。然后选中刚添加的供应商，点击「Enable」启用。
第六步：重启 Claude Code
完全关闭终端，然后重新打开。在你的项目文件夹里输入：
claude
这时候 Claude Code 就会用你配置的 AgnesAI 模型来工作了🎉
七、验证是否成功
启动 Claude Code 后，可以简单测试一下：
在终端输入 claude 进入对话模式，如下图所示：
输入一个简单的问题，比如「用Python写一个Hello World」如果能正常返回代码，说明整套流程跑通了✅八、常见问题排查❌ 问题1：输入 claude 提示「command not found」
原因：Node.js 的全局包没有加到系统 PATH 中。
解决：
Windows：重新打开终端（以管理员身份），或者重启电脑macOS/Linux：尝试 sudo npm install -g @anthropic-ai/claude-code 重装一次❌ 问题2：npm install 卡住不动或超慢
原因：默认访问的是国外源。
解决：执行 npm config set registry https://registry.npmmirror.com/ 切换国内源，然后重新安装。
❌ 问题3：CCSwitch 打开后找不到 Claude 选项
解决：检查顶部应用切换器，确保选中的是「Claude」而不是 Codex 或其他。
❌ 问题4：Claude Code 启动后报 API 相关错误
解决：
检查 CCSwitch 中 API Key 是否粘贴正确（注意不要有多余空格）确认已点击「Enable」启用该供应商完全关闭终端再重新打开九、总结
回顾一下我们做了哪些事：
步骤 操作 耗时① 安装 Node.js 3分钟② 安装 Claude Code（一条命令） 30秒③ 安装 CCSwitch 2分钟④ 注册 AgnesAI 获取 API Key 1分钟⑤ CCSwitch 配置 AgnesAI 2分钟⑥ 重启验证 1分钟
总共不到20分钟，一套免费的AI编程助手就部署好了。
后续你想换其他模型（比如DeepSeek、通义千问、Kimi等），只需要在CCSwitch里添加新的供应商，一键切换就行。再也不用每次手动改配置文件了。
💡 最后提醒：AgnesAI 目前是完全免费的，但不排除未来调整政策。且用且珍惜，赶紧动手装起来吧！
如果这篇教程帮到了你，欢迎点赞收藏转发，让更多小伙伴用上免费AI编程工具！有问题欢迎在评论区留言，我看到都会回复🙌，如果按照教程未配置成功，添加我微信进行远程指到安装，保证解决你使用claude code的“Token焦虑”
