> ## Content Index
> Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# 3个免费用Claude Code的方法
- URL: https://www.hubwiz.com/blog/3-ways-to-use-claude-code-for-free/
- Published: 2026-02-25T02:47:26.000Z
- Updated: 2026-02-25T02:47:26.000Z
- Description: Claude Code 并不关心 API 后面实际上是什么模型。 它只是与你指向的任何 URL 对话。
- Author: admin
- Tags: TOOL, CLAUDE CODE, #Import 2026-10-14 14:41

每个人都认为 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](https://openrouter.ai/keys?ref=hubwiz.com)
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](https://aistudio.google.com/api-keys?ref=hubwiz.com) 获取你的密钥并使用：

```
"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](https://platform.deepseek.com/?ref=hubwiz.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](https://ai.plainenglish.io/i-didnt-pay-a-single-dollar-to-use-claude-code-here-s-exactly-how-979b40132b02?ref=hubwiz.com)

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