GUIDE · 通用
通义灵码（Qoder CN）能接自定义 API 吗？免费用法与自定义模型限制说明
通义灵码已于 2026 年 5 月 20 日更名为 Qoder CN。它的「自定义模型」不是任意 OpenAI 兼容接口，只能接入阿里云百炼、智谱、Kimi、MiniMax 四家的 Coding Plan 套餐，所以百炼新人免费 Token 这类按量免费额度没法直接塞进去。新人更实际的用法是先用好内置模型。
- 适用对象
- 用通义灵码 / Qoder CN 的开发者，想知道能不能接入自己领到的免费 API 额度
- 预计用时
- 约 3 分钟
- 最后核实
准备
- 已安装 Qoder CN（原通义灵码）IDE 或 JetBrains 插件，并登录阿里云账号
步骤
先认清：通义灵码 = Qoder CN
阿里云官方说明：Qoder CN 系列原名「智能编码助手通义灵码」（Lingma），于 2026 年 5 月 20 日正式更名；在其他渠道看到的「通义灵码」与它是同一产品。产品覆盖 IDE、JetBrains 插件、CLI 等形态，内置模型选择器，支持 GLM、DeepSeek、Kimi、MiniMax 等国内模型切换。
免费用法：直接用内置模型
登录后在对话框的模型选择器里切换内置模型即可开始用，不需要任何 API Key。这是新人零成本上手的方式；订阅席位使用 Credits 计量，具体额度以 Qoder CN 当前版本的计费说明为准。
自定义模型：只支持四家的 Coding Plan
官方「自定义模型」文档写明：
- 适用版本：个人专业版（文档标注个人基础版限时免费体验中）；
- 支持的供应商：阿里云百炼、智谱、Kimi、MiniMax；
- 接入对象：供应商的 Coding Plan，不是任意 Base URL。
操作路径：IDE 左上角 Qoder CN → 首选项 → Qoder CN 设置 → 左侧 模型 → 添加 → 选服务商和模型、填 API 密钥 → 点添加自动验证。
这对「白嫖免费额度」意味着什么
Coding Plan 是平台的编程订阅套餐，和百炼按量计费的新人免费额度是两套东西（百炼文档明确两者的 API Key 和地址都不通用）。所以：
- 想用百炼 / 硅基流动的按量免费额度写代码，请换用支持自定义 OpenAI 兼容接口的工具，例如本站的 Cline、OpenCode、TRAE、CodeBuddy 教程；
- 已经订阅了上述四家任一 Coding Plan 的，可以按上一步接入 Qoder CN，费用由服务商账户结算，不消耗 Qoder CN 额度。
注意事项
- 结论：Qoder CN（通义灵码）不支持填写任意自定义 OpenAI 兼容地址，本站将其归为「只能用自带模型 + 指定套餐」的工具。
- 添加自定义模型失败时，官方建议检查：Key 是否正确无空格、是否过期或被禁用、服务商账户余额是否充足、网络是否正常。
- 官方提示 Qoder CN 新文档站已上线（docs.qoder.cn），旧站内容可能滞后，功能以最新版本为准。
常见问题
在设置里找不到「模型」选项？
需要先完成阿里云账号登录；自定义模型面向个人专业版（基础版限时免费体验中），以客户端实际显示为准。
用自定义模型会扣 Qoder CN 的额度吗？
官方 FAQ：不消耗。自定义模型的费用由服务商 API 账户直接结算。
相关优惠
信息来源
- 阿里云 · 什么是 Qoder CN 系列（原通义灵码）help.aliyun.com/zh/lingma/product-overview/introduction-of-lingma
- 阿里云 · Qoder CN 自定义模型help.aliyun.com/zh/lingma/qoder-cn/user-guide/custom-model
- 阿里云百炼 · Claude Code（各计费方案 Key 与地址不通用）help.aliyun.com/zh/model-studio/claude-code
最后核实日期：2026-10-09 · 政策可能随时调整，请以官方页面为准