零成本玩转Claude Code：free-claude-code与cc-switch深度对比

最近 GitHub 上出现了一个持续霸榜的热门项目——free-claude-code。从名字就能大致猜到它的用途：让你免费使用 Claude Code。

看看这个项目自四月份以来的 Star 数增长曲线，斜率相当陡峭。截至目前已经狂揽了 1.4 万颗 Star，势头确实很猛。

对于想体验 Claude Code 但又不愿意付费的开发者来说，这个项目恰好解决了他们的痛点。如果你喜欢折腾 AI Agent 或者希望在本地尝试 Claude Code，free-claude-code 无疑是个省时省力的选择。

相信很多同学会立刻想到另一个功能类似的热门项目——cc-switch，它在开发者社区也引发了大量讨论。

下面咱们就来仔细看看，这两个项目各自有什么独到之处。

01 free-claude-code

free-claude-code 是一个轻量级的 Python 代理服务器。其核心思路非常巧妙：它把 Claude Code 向 Anthropic 官方发出的 API 请求“拦截”下来，然后转发到其他免费或本地的模型服务上。

简单来说，就是让你借助免费模型享受 Claude Code 的编辑体验。

核心亮点：

• 真正的零成本：直接支持 NVIDIA NIM（免费额度 40 次/分钟）、DeepSeek 直接 API、OpenRouter 等云端服务，甚至兼容 LM Studio 和 llama.cpp 这类本地模型，完全绕过 Anthropic 的计费体系。
• 协议级伪装：它并不只是简单地把请求地址改了，还能将 DeepSeek 等模型的 reasoning_content 转换为 Claude 原生的 thinking 格式。这样一来，你在 IDE 里依然能看到完整的思考链，体验几乎无损。
• 远程 Bot 模式：这是它的独有功能！支持 Discord 和 Telegram Bot，意味着你可以通过聊天软件远程下达指令，Claude Code 在后台默默执行并把结果回传给你，非常适合远程协作场景。
• 请求拦截：智能地识别并拦截 token 计数等非必要请求，直接返回本地缓存，既能节省配额又能降低延迟。

快速上手：

1. 环境准备

• 安装依赖：确保系统已安装 uv（Python 包管理器）和 claude（官方 CLI）。
• 获取密钥：根据你将使用的供应商（如 NVIDIA NIM、DeepSeek、OpenRouter）准备 API Key。若使用本地模型（LM Studio、Ollama），则无需任何密钥。

2. 安装与配置

# 克隆项目
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code

# 安装依赖（使用 uv 管理，避免环境冲突）
uv sync

3. 编辑环境变量
复制模板并配置你的模型供应商：

cp .env.example .env

编辑 .env 文件，根据你的供应商选择进行配置。例如使用 NVIDIA NIM（推荐其免费额度）：

NVIDIA_NIM_API_KEY="nvapi-xxx"
MODEL="nvidia_nim/your-model"

或者使用本地 Ollama（完全零成本）：

OLLAMA_BASE_URL="http://localhost:11434"
MODEL="ollama/llama3.1"

4. 启动服务

# 启动代理服务器（默认端口 8082）
uv run uvicorn server:app --host 0.0.0.0 --port 8082

5. 连接 Claude Code
在新终端中，设置环境变量指向你刚启动的代理：

export ANTHROPIC_BASE_URL="http://localhost:8082"
claude

现在你的 claude 命令就会使用你配置的模型进行响应了。

https://github.com/Alishahryar1/free-claude-code

02 cc-switch

cc-switch 是一个基于 Tauri 构建的跨平台桌面端 All-in-One 助手工具。它不像 free-claude-code 那样专注于“替换后端”，而是一个功能强大的配置管理中心。

核心亮点：

• 多工具统一管理：它不仅能管理 Claude Code，还能统一管理 GitHub Copilot、OpenCode、OpenClaw、Gemini CLI 等多个 AI 编程工具的 API Key 和配置。你再也不用在环境变量里来回切换了，十分便捷。
• 图形化界面（GUI）：提供直观的桌面应用，你可以可视化地切换模型预设、管理会话、查看用量统计，这对不习惯命令行的用户来说极其友好。
• 丰富的生态集成：内置了大量第三方 API 提供商（如 Crazyrouter、AIGoCode 等）的预设，支持一键切换，方便你寻找性价比更高的代理服务。
• 安全与隐私：支持 BYOK（自带密钥）模式，所有密钥都存储在你自己的电脑上，避免了泄露风险。

快速上手：

1. 安装

• Windows：直接下载 Releases 页面的 .msi 安装包或便携版 .zip。
• macOS（推荐）：

  brew tap farion1231/ccswitch
  brew install --cask cc-switch

• Linux：下载 .deb、.rpm 或 .AppImage 文件进行安装。

2. 基本配置

1. 添加供应商：启动应用，点击“添加供应商”，然后选择预设（如 Claude 官方、自定义反向代理）或手动输入 Endpoint 和 API Key。
2. 一键切换：在主界面选中一个供应商，点击“启用”。对于 Claude Code，配置通常即时生效；其他 CLI 工具可能需要重启终端。
3. 恢复官方：如果想切回官方服务，添加“官方登录”预设并重新进行 OAuth 认证即可。

3. 核心功能操作

• MCP 管理：点击侧边栏“MCP” → 添加服务器（如数据库、文件系统工具）→ 开启对应应用的同步开关，CC Switch 会自动帮你把配置写入文件。
• 会话与技能：
  • Sessions：查看和恢复所有托管应用的历史对话。
  • Skills：直接从 GitHub 仓库搜索并一键安装社区技能包到所有应用中。

https://github.com/farion1231/cc-switch

03 两款项目对比

相同点

两款项目都围绕 Claude Code 展开，让它能对接非官方模型或 API。它们都支持多模型后端接入，且均为开源免费项目，跨平台兼容性也很好。

核心差异

free-claude-code 本质上是一个 API 代理服务。它无需你的官方 API 密钥，支持免费模型接入、本地离线模型与协议转换，还具备请求优化、机器人集成等扩展功能。不过，你需要自己动手部署这个代理服务。

cc-switch 则是一个配置管理工具。它提供纯图形化操作，无需额外部署服务，支持多款 AI CLI 工具的统一管理，切换起来非常便捷。

适配场景与人群

需求场景	优选项目	理由
纯免费、不想充值、不想找各种Key	free-claude-code	自带免费中转，开箱即用
想用本地Ollama/开源离线模型	free-claude-code	独有的本地模型对接能力
想局域网内多设备共用 Claude Code 服务	free-claude-code	可部署为后端代理共享服务
模型兼容性差、需要强行适配小众模型	free-claude-code	自动协议转换，兼容性更广
只会点点鼠标、完全不想部署服务	cc-switch	可视化GUI，无脑操作
同时用 Claude Code、Gemini CLI 等多个AI工具	cc-switch	多工具统一管理，切换便捷
追求稳定、正规第三方付费API	cc-switch	直连官方/正规接口，无代理损耗

小结一下：

• 不怕麻烦，但不想花钱：优先选择 free-claude-code。稍微部署一次，就能永久免费使用。
• 愿意小额购买 API、极度不想折腾：直接用 cc-switch。全程图形化界面，零代码操作。
• 这两个项目并不冲突，可以共存：日常付费追求稳定时用 cc-switch，临时想白嫖测试新模型时用 free-claude-code。

大家完全可以根据自己的需求和喜好来选择上手体验。说到底，无论是想彻底白嫖，还是希望便捷地管理多个 AI 工具，开源社区都已经给出了相当不错的方案。如果你有体验心得，也欢迎到社区里分享交流。