夜雨聆风学习资料网

ARTICLE · 1225816

免费模型插件,我亲手跑通了:安装、调用、接Claude Code全流程【帮你把坑全踩了】

免费模型插件,我亲手跑通了:安装、调用、接Claude Code全流程【帮你把坑全踩了】

前两天说的那个 dsh-our-free-model,号称免注册免 Key 直调 DeepSeek、Kimi。我不光看了 README,这次直接把它跑起来了——从安装到真实调用,每一步都是我亲手操作的。下面是完整流程,跟着做就行。

先说这是什么:一句话,它是个本地网关。你在自己电脑上起个服务,它在背后接免费的模型渠道(OpenCode 的官方免密网关、Kilo 的公共免费池),然后在你本机暴露出 OpenAI 和 Anthropic 兼容的 API。你的 Claude Code、Codex 就把请求发到本机,不用填任何公网 Key。

第一步:安装,三条命令

要 Node.js 22 以上。先拉代码:

bash

git clone https://github.com/Ebony-Vinyl/dsh-our-free-model.git

cd dsh-our-free-model

npm install

我实测装了 23 个包,5 分钟装完。然后启动独立服务(不用装 DSH,独立版就行):

bash

npm run start:standalone

看到这两行就是起来了:API 跑在 http://127.0.0.1:18900/v1,你的专属 Key 存在 ~/.our-free-model/settings.json 里。

提醒一句:别从 npm 装同名包,README 里明确说了 npm 上的 dsh-our-free-model 是第三方冒名打包的,内容被改过。只从 GitHub 仓库拉。

第二步:拿到你的 Key,验证服务

Key 在 ~/.our-free-model/settings.json 的 forwardKey 字段里,每个人启动时单独生成。先确认服务活着:

bash

curl -s http://127.0.0.1:18900/health

返回 {"ok":true} 就行。再看模型列表:

bash

curl -s http://127.0.0.1:18900/v1/models \

-H "Authorization: Bearer $KEY"

我这边拉出来 28 个:beam-free、deepseek-v4.1-flash-free、minimax-m3.1-flash-free、glm-5.3-flash-free、longcat-2.5-preview-free、kilo-auto/free 都在。

第三步:真实调用,我调通了两个

OpenAI 格式:

bash

curl -s http://127.0.0.1:18900/v1/chat/completions \

-H "Content-Type: application/json" \

-H "Authorization: Bearer $KEY" \

-d '{"model":"beam-free","messages":[{"role":"user","content":"Hi"}],"max_tokens":50}'

beam-free 和 minimax-m3.1-flash-free 我都调通了,有正常回答。Anthropic 格式也通:

bash

curl -s http://127.0.0.1:18900/v1/messages \

-H "Content-Type: application/json" \

-H "Authorization: Bearer $KEY" \

-H "anthropic-version: 2023-06-01" \

-d '{"model":"beam-free","max_tokens":50,"messages":[{"role":"user","content":"Hi"}]}'

第四步:接到 Claude Code 和 Codex 上

这是最实用的部分。Claude Code 认 Anthropic 协议,设两个环境变量就行:

bash

export ANTHROPIC_BASE_URL="http://127.0.0.1:18900"

export ANTHROPIC_AUTH_TOKEN="你的forwardKey"

Codex 和 OpenAI SDK 认 OpenAI 协议,base_url 填 http://127.0.0.1:18900/v1,api_key 填你的 forwardKey,模型名从上面 28 个里选。局域网里别的机器想用也行,服务支持开中继,但 Key 要单独生成,别把本机的 forwardKey 发出去。

最后说三个坑,都是我实测撞见或核实的

第一个坑:限速是真的。我调 deepseek-v4.1-flash-free 时直接撞上 429,glm-5.3-flash-free 也一样。"不限量"指的是没有计费体系,不是无限——免费车道按 session 限速,打满就等。有用户 6 个 IP 被上游封过,别拿它跑批量任务。

第二个坑:别传敏感东西。Kilo 那边明确声明 prompt 可能被记录;流量虽然直连上游不经过作者服务器,但上游看得到你的请求内容。密码、密钥、个人身份信息、商业机密,别往里送。

第三个坑:灰色渠道别碰。插件里除了干净的免费车道,还有"十一个账号渠道",是逆向第三方 AI 工具免费额度的——今天刚收到律师函,WorkBuddy 渠道当天就下架了。用免费车道和 Kilo 就够了,账号渠道碰了可能连累你的 IP。

总结一下:三条命令装起来,28 个模型免 Key 调,Claude Code 两个环境变量就能接上。能用,但别当生产环境,别传敏感内容,别碰灰色渠道。

相关学习资料