每个人都认为 Claude Code 需要 Anthropic 订阅。并不是。我在花了 20 分钟试图向自己证明每月 20 美元的计划是合理的时候才发现这一点。然后我深入钻研在 Panaversity AI Agent Factory 文档中找到了实际设置并在 10 分钟内让它免费运行起来。这是没人一开始就告诉你的Claude Code 并不关心 API 后面实际上是什么模型。它只是与你指向的任何 URL 对话。所以如果你指向一个免费模型 —— Gemini、DeepSeek 或 OpenRouter 上 30 多个模型中的任何一个 —— 它的运作方式完全相同。相同的技能、相同的 MCP 服务器、相同的子代理、相同的一切。让我向你展示具体方法。1、但首先 —— 选择你的武器你有 3 个选项。它们并不相等。选择之前请了解OpenRouterGeminiDeepSeek成本免费每日限制免费每日限制约 $0.028/M tokens模型30Qwen、Llama、GeminiGemini 2.5 FlashDeepSeek 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 Code3.1 获取你的免费 OpenRouter 密钥前往 openrouter.ai/keys点击“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 } } EOFWindows —— 打开记事本并将相同的 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_KEYYOUR_KEY_HERE ~/.zshrc source ~/.zshrcMac (bash):echo export OPENROUTER_API_KEYYOUR_KEY_HERE ~/.bashrc source ~/.bashrcWindows (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 doesClaude 应该读取你的实际文件并响应。如果它这样做 —— 你就有了一个完全工作的基于免费模型的代理编码环境。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_KEY6、故障排除“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% 的目标。从免费开始。当你实际达到上限时再升级。原文链接3个免费用Claude Code的方法 - 汇智网