Posted in其他

free-claude-code，免费用上 Claude Code 工作流

Posted in其他
free-claude-code
free-claude-code

free-claude-code 是一个能让你免费用上 Claude Code 工作流的开源项目，它通过一个本地代理服务，把 Claude Code 原本调用的官方 API，无缝替换成各类免费或低成本的大模型 API。这样一来，你就能在 Claude Code 强大的终端交互体验下，用上像智谱 GLM、DeepSeek、NVIDIA NIM 等平台提供的免费模型了。

💡 核心工作原理：它如何“偷梁换柱”？

这个项目巧妙地在本地起了一个代理服务（Proxy Server），原理不复杂，但很有效：

  1. 伪装成官方：它修改了 Claude Code 的环境变量，让所有请求不再发向 Anthropic 官方，而是转向 http://localhost:8082 这个本地代理地址。
  2. 格式转换与修复：代理收到请求后，会进行 API 格式的转换（将 Anthropic 格式转为 OpenAI 格式），并修复一些开源模型输出不规范的地方（比如工具调用的格式），确保 Claude Code 能正确理解。
  3. 模型映射：你可以在配置里指定，把 Claude 的 Opus、Sonnet、Haiku 模型分别映射到不同的免费模型上，比如把 MODEL_OPUS 映射到 nvidia_nim/z-ai/glm-5.1。

✨ 主要特性与使用场景

  • 多平台支持：除了在终端（Terminal）使用，它还支持 VSCode 插件、JetBrains IDE，甚至能通过 Discord 或 Telegram 机器人进行远程操作。
  • 接入多种免费模型：你可以在配置中接入 NVIDIA NIM 的免费额度（每分钟约40次）、OpenRouter 的免费模型、Google Gemini 的免费 API、DeepSeek 等平台的模型。你也可以配置使用 lmstudio 或 llamacpp 这样的本地模型，实现完全离线免费使用。
  • 管理后台：项目提供了一个 Admin UI（通常在 http://127.0.0.1:8082/admin），可以直接在这个网页上配置 API Key、验证有效性、切换模型，非常方便。

⚠️ 值得注意的限制

当然，这种“白嫖”方式也有它的代价和局限：

  • 免费额度的限制：依赖的第三方免费 API 通常有速率限制（比如 NVIDIA NIM 的40次/分钟），高强度使用时可能会感觉受限。
  • 模型能力差距：用开源模型替换顶级闭源模型，在处理极其复杂的项目时，代码生成质量和推理深度可能会有肉眼可见的差距。
  • 安全与合规风险：你的对话会经过这个代理，有隐私泄露风险，不应在代理中暴露核心代码或个人隐私。另外，在企业环境中使用也需要注意合规性。

🚀 快速上手（核心步骤）

它的安装和配置比较直接，以下是一个极简的流程：

  1. 克隆与安装 git clone https://github.com/Alishahryar1/free-claude-code.git cd free-claude-code pip install uv uv sync
  2. 配置 .env 文件
    复制 .env.example 为 .env，然后填入你申请到的免费 API Key（比如 NVIDIA NIM）和想映射的模型。 NVIDIA_NIM_API_KEY="nvapi-你的Key" MODEL_OPUS="nvidia_nim/z-ai/glm-5.1" MODEL="nvidia_nim/z-ai/glm-5.1"
  3. 启动代理 uv run uvicorn server:app --host 0.0.0.0 --port 8082
  4. 配置 Claude Code 并运行
    通过环境变量让 Claude Code 知道代理的存在，然后直接运行 claude 命令即可。 # 在另一个终端窗口执行 export ANTHROPIC_BASE_URL="http://localhost:8082" export ANTHROPIC_AUTH_TOKEN="freecc" claude

补充一点：如果你对更纯粹的本地运行方案感兴趣，也可以了解下 Goose 这个项目，它是另一个开源的本地 AI 编程助手，也获得了超过 26,100 个 Star，主打完全在本地机器上运行，数据自主可控。