> ## 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. # 用 Zen 免费模型运行Claude Code - URL: https://www.hubwiz.com/blog/run-claude-code-with-zen-free-models/ - Published: 2026-05-10T19:27:50.000Z - Updated: 2026-10-13T14:39:54.000Z - Description: 你可以免费使用 Claude Code，方法指向一个免费的 OpenCode Zen 模型，比如 minimax-m2.5-free。 - Author: admin - Tags: AGENT, CLAUDE CODE, OPENCODE, #Import 2026-10-14 14:41 是的，你可以免费使用 Claude Code，方法是通过一个小型 Cloudflare Worker 进行路由，并将该 Worker 指向一个免费的 OpenCode Zen 模型，比如 `minimax-m2.5-free`。 Claude 仍然是界面。OpenCode 成为模型层。 这意味着你可以保留人们已经喜欢的 Claude 体验，在低风险工作中跳过 Anthropic 的计费，只在任务真正需要时才切换到付费提供商通道。 ![如何通过 OpenCode 模型免费运行 Claude Code](https://www.hubwiz.com/blog/content/images/2026/05/0-uCb1jwYo4JtedUhd.jpeg.jpg) 事情是这样的，2026 年 3 月底，Anthropic 发布了一个 Claude Code npm 包，里面包含了一个 source map。这个打包错误暴露了 Claude Code TypeScript 源代码的很大一部分。几个小时内，镜像在 GitHub 上扩散开来。一些仓库在 Anthropic 开始发送下架通知之前就获得了数千颗星和分叉。 然后清理工作变得混乱了。TechCrunch 在 2026 年 4 月 1 日报道，Anthropic 的 DMCA 请求波及了大约 8,100 个 GitHub 仓库，之后公司才缩小了范围。 这告诉我两件事。 首先，开发者非常想要 Claude Code，以至于蜂拥至泄漏的源代码。其次，使用 Claude 界面与其他提供商通道的需求已经存在。 这一切发生的时候，我正在测试各种编码工具的替代方案。 但我仍然喜欢 Claude Code。而且我仍然想尝试 Claude Cowork，而不想每次想要一个精致的编码会话时都支付完整的 Anthropic 费用。 问题很简单。 Claude 说 Anthropic 的语言。OpenCode Zen 和 OpenCode Go 大多说 OpenAI 兼容的端点语言。 所以我构建了一个翻译器。 [OpenCode Cowork Proxy Worker](https://github.com/cucoleadan/opencode-cowork-proxy?ref=hubwiz.com) 让 Claude Code 能够与 OpenCode Go 模型和选定的 OpenCode Zen 模型对话。Claude 继续发送 Anthropic 风格的请求，然后 Worker 将它们转换为 OpenCode 期望的上游格式。 不存储密钥。不存储消息。只是一个格式桥接。 有了这个，你可以从免费的 OpenCode Zen 模型（如 `minimax-m2.5-free`）开始，然后在工作变得更具挑战性时切换到 OpenCode Go 的订阅通道。 我特意让切换变得简单。你需要一个 Cloudflare 账户和一个 OpenCode 账户。两者都可以免费开始，只有当工作流变得值得时才升级。 本文内容包括： 1. 如何在你的 Cloudflare 账户中部署 Worker 2. 如何配置 Claude Desktop 或 Claude Cowork 进行第三方推理 3. 从哪些免费的 OpenCode Zen 模型开始 4. 什么时候用 `/zen`，什么时候切换到 `/go` 5. 在接触真实仓库之前运行的第一个安全测试 6. 最可能导致首次设置失败的错误 ## 1、先在 Cloudflare 中部署 Worker 在 Claude 可以使用 OpenCode 之前，你需要一个它可以调用的网关 URL。 打开 [OpenCode Cowork Proxy Worker 仓库](https://github.com/cucoleadan/opencode-cowork-proxy?ref=hubwiz.com)，点击顶部的 **Deploy to Cloudflare Workers** 按钮。Cloudflare 直接支持 Workers 项目的一键部署流程，这就是为什么这个设置可以快速交付。 Cloudflare 会引导你完成其余步骤。完成后，复制你的 Worker URL。 此时，你的网关已经上线。 你部署的 URL 看起来会像你自己的 Cloudflare Worker 端点。在下面的示例中，我将其称为： ``` YOUR_DEPLOYED_WORKER_URL ``` ## 2、配置 Claude Desktop 使用 OpenCode Zen 打开 Claude Desktop，进入第三方推理设置。 如果你使用 Windows，前往： ``` Help > Troubleshooting > Enable Developer Mode ``` Claude 将重启并显示一个新菜单： ``` Developer > Configure Third-Party Inference ``` Anthropic 目前关于 Claude Cowork 第三方设置的帮助文档使用的是同一路径，所以你并不是在依赖某个奇怪的黑客技巧。你使用的是预期的设置 UI。 对于第一次测试，将 Claude 指向 OpenCode Zen，使用免费模型 `minimax-m2.5-free`： ``` Backend: Gateway Gateway base URL: YOUR_DEPLOYED_WORKER_URL/zen API key: 你的 OpenCode API 密钥 Auth scheme: x-api-key Model: minimax-m2.5-free ``` 完成后，确保也手动添加模型： ``` minimax-m2.5-free ``` 点击 **Apply locally**。完全退出 Claude Desktop。重新打开它。 这就是通过你的 Worker 使用免费 OpenCode 模型运行 Claude Code 的基本路径。 ## 3、从免费的 OpenCode Zen 模型开始 从 OpenCode Zen 开始，而不是 Go。 Zen 是 OpenCode 精选的模型网关。一些 Zen 模型是付费的。一些在模型团队收集反馈期间限时免费。 **最后更新：2026 年 5 月 7 日** 当前的 [OpenCode Zen 文档](https://opencode.ai/docs/zen/?ref=hubwiz.com) 列出了这些免费模型： ``` minimax-m2.5-free ling-2.6-flash hy3-preview-free nemotron-3-super-free big-pickle ``` 首先使用这个： ``` minimax-m2.5-free ``` 你的 base URL 应该以以下结尾： ``` /zen ``` 你的模型字段应该是： ``` minimax-m2.5-free ``` 免费意味着在 OpenCode 提供该模型的免费期间内免费。它不意味着不需要账户、不需要 API 密钥或没有注意事项。 你仍然需要一个 OpenCode API 密钥。 而且你绝对应该在使用免费模型处理敏感工作之前检查隐私说明。截至 2026 年 5 月 7 日，OpenCode 的 Zen 文档表示几个免费模型可能在免费期间使用收集的数据来改进模型。这包括 `minimax-m2.5-free`。这与处理敏感代码时你想要的通道完全相反。 这是测试通道。 将其用于摘要、低风险代码审查、文档清理和一次性文件夹中的小文件编辑。不要一开始就以写入权限指向你的主仓库。 在我自己的首次测试中，免费 Zen 路线处理摘要、低风险审查和小文件编辑没问题，但一旦我需要在更大的仓库上进行更强的推理，我就切换到了 `/go`。 ## 4、/zen 用于免费模型，/go 用于 OpenCode Go 使用 `/zen` 用于免费模型和 Zen 按量付费模型： ``` YOUR_DEPLOYED_WORKER_URL/zen ``` 使用 `/go` 用于 OpenCode Go 月度订阅通道： ``` YOUR_DEPLOYED_WORKER_URL/go ``` 如果你想要一个快速的心智模型，这样使用： - `/zen` 是免费测试通道 - `/go` 是更强的日常工作通道 截至 2026 年 5 月 7 日，[OpenCode Go 文档](https://opencode.ai/docs/go/?ref=hubwiz.com) 列出 Go 首月 5 美元，之后每月 10 美元。 同一文档目前列出了这些使用限制： ``` 5小时限制：12 美元的使用量 每周限制：30 美元的使用量 每月限制：60 美元的使用量 ``` 你的实际请求计数取决于模型。 更便宜的模型可以用得更久。更重的模型更快消耗限额。 重要的隐私区别在于：OpenCode Go 表示其提供商遵循零保留策略，不使用你的数据进行模型训练。这使它比免费模型通道更适合真正的编码工作。我仍然不会把任何东西称为"完全隐私"，但根据当前文档，这是更安全的路线。 ## 5、为什么不用 OpenRouter 或 Ollama？ 因为这里的关键不仅仅是"找任何更便宜的提供商"。 关键是保留 Claude 的界面和工具流，同时替换下面的模型层。 如果你只想要最快的通用提供商切换，OpenRouter 更简单。 如果你想要完全本地的推理，Ollama 是更好的答案。 如果你特别想要 Claude Code 或 Claude Cowork 作为前端，同时让 OpenCode 在后台处理模型，这条 Worker 路线就是正确的工具。 这比听起来更重要。很多人实际上并不想要一个新界面。他们只是想要在已经喜欢的界面后面有一个更便宜或更灵活的推理通道。 ## 6、在一次性文件夹中安全测试 Claude Code 不要一开始就把这指向你的主仓库。 创建一个一次性文件夹： ``` claude-opencode-proxy-test ``` 添加一个文件： ``` project-notes.md ``` 在其中放入虚假的项目笔记。 然后让 Claude Code： ``` Read project-notes.md. Summarize the project in 10 bullets. Create a second file called next-actions.md with a short implementation checklist. Do not modify project-notes.md. ``` 这检查路由和工具行为是否协同工作。Claude 必须从笔记中创建新文件而不触碰原始文件。 如果这可行，尝试一个小型代码审查： ``` Review this function for bugs. Do not edit files yet. Give me the risk list first. ``` 我喜欢第二个测试，因为它让模型远离编辑，直到你看到它的行为方式。 之后，测试一个小型的工具密集型任务。让它比较两个文件并创建一个简短的笔记。保持任务无聊。 你在测试路由和工具行为，不是模型的品味。 ## 7、当免费通道不再值得时切换到 OpenCode Go OpenCode Go 是目前更透明的 AI 订阅之一，因为限制以美元价值表示，而不是模糊的"稍后再来"聊天上限。 当免费 Zen 模型太弱、太慢、太多速率限制或对工作来说风险太大时，切换到 `/go`。 这通常在以下情况之一变为现实时发生： 1. 你想在更大的代码库上获得更好的推理。 2. 你想要更少关于数据使用的注意事项。 3. 你做的编码工作足够多，以至于 10 美元的通道比在其他地方消耗高级订阅更便宜。 好的部分是设置几乎没有变化。你保持 Claude 作为界面。你只是切换路线和模型。 ## 8、这如何也适用于 Claude Cowork 这是比免费模型本身我更关心的部分。 人们喜欢 Claude Code 和 Claude Cowork，因为界面用起来感觉很好，没有人想要另一个在每次小编码会话上都悬着模糊限制的订阅。 Claude Cowork 特别具有那种让人想留在里面的产品打磨。项目视图感觉干净，工具活动易于跟踪，整个东西感觉更像一个应用程序，而不是一堆你需要看管的智能体。 烦人的部分是每次你想要那种应用体验时都要为整个 Anthropic 路线付费。 当我请求困难的架构帮助或审查有风险的变更时，我可以证明高级推理模型的费用是合理的。我不想在每个小的整理任务上消耗高级使用量。 这就是我构建这个代理的原因，我希望兼容性这一点是明确的：这个代理同时适用于 Claude Cowork 和 Claude Code。 便宜的路径让你保留 Claude 应用体验，而不是强迫自己进入另一个界面。 你可以从免费的 OpenCode Zen 模型开始，然后当你想在 Claude Cowork 或 Claude Code 中使用更强的开放模型时，切换到 10 美元的 OpenCode Go 通道。 我仍然喜欢 OpenCode。我仍然使用 Codex。Hermes 仍然是我认真的循环工作流所在。关键是 Claude Cowork 不必成为另一个昂贵的订阅决策，当 OpenCode 可以免费或以更低成本提供模型层时。 --- 原文链接: [How to Run Claude Code for Free with OpenCode Models](https://medium.com/@cucoleadan/how-to-run-claude-code-for-free-with-opencode-models-cdc5c5153dd2?ref=hubwiz.com) 汇智网翻译整理，转载请标明出处 > **这是「AI 编程 / Vibe Coding」专题的一部分。**完整地图见：[AI 编程 / Vibe Coding 完全指南](https://www.hubwiz.com/blog/vibe-coding-stack/)