TOOL

3个免费用Claude Code的方法

Claude Code 并不关心 API 后面实际上是什么模型。 它只是与你指向的任何 URL 对话。

admin

— 阅读时间 7 分钟
分享
3个免费用Claude Code的方法

每个人都认为 Claude Code 需要 Anthropic 订阅。

并不是。

我在花了 20 分钟试图向自己证明每月 20 美元的计划是合理的时候才发现这一点。然后我深入钻研，在 Panaversity AI Agent Factory 文档中找到了实际设置，并在 10 分钟内让它免费运行起来。

这是没人一开始就告诉你的：Claude Code 并不关心 API 后面实际上是什么模型。 它只是与你指向的任何 URL 对话。所以如果你指向一个免费模型 —— Gemini、DeepSeek 或 OpenRouter 上 30 多个模型中的任何一个 —— 它的运作方式完全相同。相同的技能、相同的 MCP 服务器、相同的子代理、相同的一切。

让我向你展示具体方法。

1、但首先 —— 选择你的武器

你有 3 个选项。它们并不相等。选择之前请了解：

OpenRouter Gemini DeepSeek
成本 免费（每日限制） 免费（每日限制） 约 $0.028/M tokens
模型 30+（Qwen、Llama、Gemini） Gemini 2.5 Flash DeepSeek Chat + Reasoner
最适合 灵活性、实验 最简单的设置 一致的质量
注意 模型轮换、质量各不相同 限制在 2025 年 12 月下降 50–80% 并非真正免费
⚠️ 人们不知道的事： Google 在 2025 年 12 月悄悄削减了 Gemini 的免费层 —— 大多数模型的每日请求限制下降了 50–80%。它仍然有效，但如果你大量编码，你会遇到瓶颈。OpenRouter 给你更多的喘息空间，因为当一个模型用完时你可以切换模型。

我将介绍 OpenRouter —— 它是最灵活的，也是我实际上每天使用的选项。Gemini 和 DeepSeek 的设置遵循完全相同的模式，只是配置文件不同。

2、实际情况是怎样的

在我们接触终端之前，了解架构。这将在以后为你省去困惑。

你 → ccr code → Claude Code Router（本地）→ OpenRouter API → 免费模型

Claude Code 与运行在端口 3456 上的本地路由器对话。路由器将 Claude 的请求转换为后端模型期望的任何格式。就是这样。没有黑客手段，没有越狱 —— 这字面上就是 Anthropic 自己生态系统中记录的设置。

该工具称为 claude-code-router (ccr)。它是开源的。

3、设置：OpenRouter + Claude Code

3.1 获取你的免费 OpenRouter 密钥

  1. 前往 openrouter.ai/keys
  2. 点击 "Create Key" —— 随便命名 - 复制它（以 sk-or-v1-... 开头）

免费账户可让你访问 30 多个模型，具有每日限制。无需信用卡。

3.2 安装两个工具

npm install -g @anthropic-ai/claude-code @musistudio/claude-code-router

🧾 刚刚发生了什么： 你安装了 Claude Code（代理）和路由器（转换器）。两者都是必需的。没有路由器，Claude Code 会尝试直接访问 Anthropic 的付费 API。

验证它们都存在：

claude --version   # Claude Code v2.x.x
ccr version        # 显示版本号

3.3 创建配置文件

Mac/Linux —— 粘贴整个块：

mkdir -p ~/.claude-code-router ~/.claude
cat > ~/.claude-code-router/config.json << 'EOF'
{
  "LOG": true,
  "LOG_LEVEL": "info",
  "HOST": "127.0.0.1",
  "PORT": 3456,
  "API_TIMEOUT_MS": 600000,
  "Providers": [
    {
      "name": "openrouter",
      "api_base_url": "https://openrouter.ai/api/v1",
      "api_key": "$OPENROUTER_API_KEY",
      "models": [
        "qwen/qwen-coder-32b-vision",
        "google/gemini-2.0-flash-exp:free",
        "meta-llama/llama-3.3-70b-instruct:free",
        "qwen/qwen3-14b:free"
      ],
      "transformer": {
        "use": ["openrouter"]
      }
    }
  ],
  "Router": {
    "default": "openrouter,qwen/qwen-coder-32b-vision",
    "background": "openrouter,qwen/qwen-coder-32b-vision",
    "think": "openrouter,meta-llama/llama-3.3-70b-instruct:free",
    "longContext": "openrouter,qwen/qwen-coder-32b-vision",
    "longContextThreshold": 60000
  }
}
EOF

Windows —— 打开记事本并将相同的 JSON 保存到： %USERPROFILE%\.claude-code-router\config.json

🧾 刚刚发生了什么： 你告诉路由器使用哪些模型以及用于什么目的。default 是你的日常编码模型，think 用于复杂的推理任务，longContext 处理大文件。路由器在它们之间自动切换 —— 你永远不需要考虑它。

🚨 切勿替换 $OPENROUTER_API_KEY 在配置文件中。 完全保持原样 $OPENROUTER_API_KEY**。路由器从你的环境变量（下一步）中读取它。如果你直接将密钥粘贴到文件中，它将不起作用，你会困惑 30 分钟。

3.4 永久设置你的 API 密钥

Mac (zsh):

echo 'export OPENROUTER_API_KEY="YOUR_KEY_HERE"' >> ~/.zshrc
source ~/.zshrc

Mac (bash):

echo 'export OPENROUTER_API_KEY="YOUR_KEY_HERE"' >> ~/.bashrc
source ~/.bashrc

Windows (PowerShell — 以管理员身份运行):

[System.Environment]::SetEnvironmentVariable('OPENROUTER_API_KEY', 'YOUR_KEY_HERE', 'User')

然后关闭所有 PowerShell 窗口并打开一个新窗口。

验证它是否有效：

echo $OPENROUTER_API_KEY  # 应该打印你的密钥

🧾 刚刚发生了什么： 你将密钥存储在 shell 中，以便它在每次会话时自动加载。没有这个，你每次打开终端时都需要手动导出它 —— 每个人都会忘记，然后想知道为什么什么都不起作用。

3.5 日常工作流程（两个终端）

这是让人们困惑的部分。你需要两个终端。

终端 1 —— 启动路由器：

ccr start

等待直到你看到 ✅ Service started successfully。保持此窗口打开。

终端 2 —— 开始编码：

cd your-project-folder
ccr code

🧾 为什么需要两个终端？ 路由器是一个必须保持运行的本地服务器。ccr code 是指向该服务器的 Claude Code。如果你杀死终端 1，你的编码会话就会死亡。把终端 1 视为引擎，终端 2 视为驾驶员座位。

⏳ 首次启动需要 10–20 秒。 如果 ccr code 似乎卡住了不要惊慌。 路由器正在初始化。只需等待。

4、验证它是否有效

进入 Claude Code 后，键入：

hi

如果它响应，你就上线了。要进行更深入的检查：

Explain what files are in this directory and what this project does

Claude 应该读取你的实际文件并响应。如果它这样做 —— 你就有了一个完全工作的基于免费模型的代理编码环境。

5、如果我想要 Gemini 或 DeepSeek 怎么办？

完全相同的步骤。只需交换配置文件内容。

对于 Gemini，从 aistudio.google.com/api-keys 获取你的密钥并使用：

"Providers": [{
  "name": "gemini",
  "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
  "api_key": "$GOOGLE_API_KEY",
  "models": ["gemini-2.5-flash-lite", "gemini-2.0-flash"],
  "transformer": { "use": ["gemini"] }
}]

环境变量：GOOGLE_API_KEY

对于 DeepSeek，从 platform.deepseek.com 获取你的密钥并使用：

"Providers": [{
  "name": "deepseek",
  "api_base_url": "https://api.deepseek.com/v1",
  "api_key": "$DEEPSEEK_API_KEY",
  "models": ["deepseek-chat", "deepseek-reasoner"],
  "transformer": { "use": ["openai"] }
}]

环境变量：DEEPSEEK_API_KEY

6、故障排除

"command not found: ccr" npm 全局 bin 目录不在你的 PATH 中。运行：

npm config get prefix
# 将输出 + /bin 添加到 ~/.zshrc 或 ~/.bashrc 中的 PATH

路由器启动但 Claude 挂起 你在 ccr start 完成之前运行了 ccr code。终止两者，首先重新启动终端 1，等待成功消息，然后启动终端 2。

"API key not found" 你在一个终端会话中设置了变量，但它没有持久化。如步骤 4 所示，将导出添加到你的 ~/.zshrc 或 ~/.bashrc 并 source 它。

在会话中途达到速率限制 在配置中切换你的默认模型到 OpenRouter 上的不同免费模型。你有 30 多个选项 —— 在它们之间轮换。

7、诚实的看法

免费意味着与 Claude Sonnet 或 Opus 相同的质量吗？不。对于复杂的多步推理，付费的 Claude 模型更好。

但这是我的发现：对于大多数实际开发工作，读取代码库、生成样板、解释错误、编写测试，OpenRouter 上的免费模型确实足够好。Qwen-Coder-32B 在代码任务方面特别强大。

为 Claude Pro 支付 20 美元/月来使用 Claude Code 的人大多是为了便利性和峰值性能。如果你正在学习、实验或构建副业项目 —— 免费可以让你达到 90% 的目标。

从免费开始。当你实际达到上限时再升级。

原文链接: I Didn't Pay a Single Dollar to Use Claude Code — Here's Exactly How

汇智网翻译整理，转载请标明出处

阅读更多