全文约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 支持百万级上下文，完全够日常编程用。

二、准备工作（必做！）
⚠️ 千万别跳过这一步，很多小白装不上就是因为环境没准备好。

1. 检查系统要求

Claude Code 支持 Windows 10/11、macOS 10.15以上、Linux（Ubuntu 20.04+等）。

1. 安装 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 node
Linux 用户：
去 https://nodejs.org/zh-cn/download 下载对应版本
3. 验证安装是否成功

打开终端（Windows打开PowerShell或命令提示符），分别输入：

node -v
npm -v

如果能看到版本号（如 v20.x.x 和 10.x.x），说明安装成功✅ 如果提示「不是内部或外部命令」，说明Node.js没装好，重新装一遍。

1. 设置国内镜像源（加速下载）

这一步强烈建议做，不然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/ccswitch
brew 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焦虑”