零成本用Claude Code：ModelScope免费API配置指南

Claude Code 的编程体验让不少开发者心动，但每月 20 美元的订阅费对学生党和兼职开发者来说是一道门槛。B站 UP 主分享了一套替代方案：通过 ModelScope（魔搭社区）的免费 API 额度，配合 VS Code 和协议转换工具，实现零成本在 Claude Code 中调用国产大模型写代码。

总体流程

为什么选择 ModelScope 替代方案

ModelScope 是阿里旗下的模型社区，注册后每天会赠送一定数量的免费 API 调用额度。据 UP 主介绍，这些额度每天大约可支撑 100 到 400 次调用，个人学习完全够用。平台内提供 DeepSeek^广告、通义千问^广告等模型，涵盖文本生成、文生图、图生视频等多种类型。

这套方案的核心逻辑并不复杂：Claude Code 作为前端交互界面保持不变，底层实际请求的是 ModelScope 上的国产模型。用户获得的体验是 Claude Code 的操作方式，付出的成本为零。

ModelScope 与免费额度机制

ModelScope（魔搭社区）是阿里巴巴达摩院于 2022 年推出的开源模型平台，定位类似 Hugging Face，汇集了国内外大量预训练模型与数据集。其核心资源之一是「模型推理 API」：用户无需本地部署 GPU 环境，即可通过 HTTP 请求直接调用托管在云端的模型。平台每日向注册用户发放一定额度的免费调用次数，通常与账号实名状态、模型类型挂钩。不同模型的免费额度相互独立，因此实际可用总量取决于所选模型。免费额度按自然日刷新，未用完不累积。由于平台策略可能调整，建议在使用前于个人中心查看实时额度说明。

五步完成配置：从注册到跑通

UP 主将整个流程拆解为五个步骤，前置准备需要三个工具：VS Code、Claude Code 插件，以及一个名为 SystemService 的桌面协议转换网关。

注册与实名认证

第一步在 ModelScope 完成手机号注册，过程简单。关键在第二步：必须绑定阿里云账号并完成实名认证，这是硬性要求。UP 主演示了通过支付宝扫码加人脸识别的方式，大约一分钟即可完成。如果不做实名认证，API 调用会直接失败。

创建令牌与选模型

第三步是新建访问令牌拿到 API Key。在令牌页面点击新建，名称随意填写，有效期可选长期或指定日期，模型默认勾选大模型推理。创建后会得到一串以 MS 开头的 Key，需要完整复制保存。

选模型时有明确的筛选标准：在模型库中搜索带有“推理 API / Inference”标签的模型，这类模型会显示闪电图标，表示有免费调用次数，使用不会报错。UP 主以 DeepSeek 的某个模型为例，演示了如何复制模型 ID 备用。

SystemService 配置要点

第四步在 SystemService 中新建 Provider，类型选择 API Convert，供应商选 ModelScope，填入 API Key 和请求地址。这里有一个容易忽略的细节：需要在 SystemService 中做模型映射。因为 Claude Code 默认请求的是它自己的模型名称，而实际要调用的是 DeepSeek，所以要把显示名称映射到从 ModelScope 复制的模型 ID，兜底模型也填同一个。

最后是 JSON 配置部分，把 API Key 替换成 ModelScope 申请的那串即可。UP 主提到，如果配置参数填好了，代码通常会自动生成，不完整的话可以借助豆包等工具检查。

配置界面

协议转换与模型映射的必要性

Claude Code 插件在发起请求时，遵循 Anthropic 定义的 API 协议格式，并在请求体中指定 Claude 系列模型名称（如 claude-sonnet-4-20250514）。而 ModelScope 的推理接口采用 OpenAI 兼容的 Chat Completions 协议，两者在请求路径、鉴权头、消息结构上均存在差异。SystemService 的 API Convert 模式充当中间层：它监听本地端口，接收 Claude Code 发出的 Anthropic 格式请求，将其转换为 OpenAI 格式后转发至 ModelScope，再把响应转换回 Anthropic 格式返回给插件。模型映射则是告诉转换层「当收到对 Claude 模型名的请求时，实际改用哪个 ModelScope 模型 ID」，缺少这一步请求会因模型不存在而失败。

三个必须避开的坑

UP 主特别强调了三个常见错误。第一是模型选错，没有选择带推理 API 标签的模型会直接报错。第二是个人资料不完善，ModelScope 账户信息缺失可能导致每日额度不发放。第三是 API Key 复制遗漏，MS 开头的字符串必须完整无误地粘贴。

个人资料完善提示

推理 API 标签与普通模型页的区别

在 ModelScope 模型库中，并非所有模型都开放免费在线推理。带有「推理 API / Inference」标签（闪电图标）的模型表示平台已为其部署在线推理服务，用户可直接通过 API 调用并获得每日免费次数；没有该标签的模型通常只提供权重下载，若强行对其发起 API 请求会返回权限或服务不可用错误。此外，同一模型的不同版本（如 7B 与 67B）可能分别标注或未标注推理标签，复制模型 ID 时需确认所选版本本身支持在线推理。

实际体验：Claude Code 交互不变

配置完成后，UP 主在 VS Code 中做了实测。新建项目后打开 Claude Code 对话窗口，确认 SystemService 程序处于打开状态且 Provider 已启用，然后测试模型连通性。他让 AI 帮忙写一个 React 待办清单，AI 顺利调用了 ModelScope 上的 DeepSeek 模型完成代码生成。

在对话过程中，AI 还自动生成了 MVP 功能梳理的 Markdown 文件并给出建议。UP 主表示后续可以继续让 AI 做原型设计、技术方案选型、写代码、测试到本地部署的完整流程。

这套方案的价值在于降低了 AI 编程工具的尝试门槛。ModelScope 的免费额度虽然有限，但对于学习和小规模实验来说，足以覆盖日常使用。对于想体验 Claude Code 工作流但不愿承担订阅成本的开发者，值得按这个流程试一次。需要提醒的是，免费额度的具体可用模型种类和调用次数可能随平台策略调整，配置前建议先在 ModelScope 个人中心确认当前额度情况。