JeecgBoot AI专题研究 | NVIDIA 免费 API 申请与 Claude Code 第三方模型接入实战指南
前言
Claude Code 已经成了很多开发者日常编程的首选工具,但它的付费门槛让不少人望而却步——尤其是以人民币结算的用户,每月开支不算小。好消息是,NVIDIA 提供了免费 API 额度,虽然有一些限制,但配合合适的代理工具,完全可以接入 Claude Code 使用。
不过,事情没那么简单。很多人在配置过程中卡住了,环境变量明明设了,Claude Code 就是连不上。这篇文章就从申请 NVIDIA API 开始,一步步讲清楚为什么会卡住、怎么绕过去,最终让免费 API 也能在 Claude Code 里顺畅跑起来。
NVIDIA 免费 API:能做什么,不能做什么
NVIDIA 通过 build.nvidia.com 向开发者提供免费 API 调用额度,支持包括 minimax-m2、glm4.7 等多个模型。
先说限制,免得你申请完才发现不合用:
- 每分钟限制 40 次调用——轻度使用绰绰有余,高强度编码需要合理分配
- 不兼容 Anthropic 格式——它走的是 OpenAI 兼容协议,跟 Claude Code 的原生格式对不上
- 用户量大时响应变慢——毕竟是免费服务,高峰期要有心理预期
核心矛盾就在这里:NVIDIA 的 API 是好的、免费的,但格式不对,直接喂给 Claude Code 它会「消化不良」。这就是后面要引入代理工具的原因。
申请 NVIDIA API Key
注册 NVIDIA 账号
打开 build.nvidia.com,点击「Login」进入登录/注册页面。
输入邮箱后点「Next」,系统会引导你完成密码设置和邮箱验证。
验证通过后会提示创建 NVIDIA Cloud Account——注意这里的账户名不能使用中文,只能英文或数字。
创建完成后,系统会要求进行身份验证。点击右上角「Verify」,输入国内 +86 手机号完成短信验证。这一步是获得 API 访问权限的必要条件。
创建 API Key
验证完成后进入后台,点击头像 →「API Keys」,或者直接访问 build.nvidia.com/settings/api-keys。
填写 Key 名称,过期时间选「永不过期」,然后点击生成。
关键一步:生成后立即复制保存 API Key。关掉这个弹窗之后,你就再也看不到完整的 Key 了,只能删掉重建。
为什么不能直接接入 Claude Code?
拿到 API Key 后,你可能会想直接配置 Claude Code 的环境变量:
export ANTHROPIC_BASE_URL=https://integrate.api.nvidia.com/v1
export ANTHROPIC_API_KEY=nvapi-xxxxx然后启动 Claude Code——大概率会报错。
原因在于协议不兼容。Claude Code 内部使用的是 Anthropic 原生 API 格式,而 NVIDIA(以及绝大多数第三方 API 厂商)提供的是 OpenAI 兼容格式。二者虽然都是 RESTful JSON,但请求和响应的字段结构完全不同。
打个比方:你拿着 Type-C 的充电线去插 Lightning 接口——物理上就插不进去,不是线的问题,也不是手机的问题,是协议不对。
Claude Code ──(Anthropic格式)──> NVIDIA API ← 对方只懂 OpenAI 格式,拒绝处理所以需要一个「协议转换器」来充当翻译。市面上有两个主流选择:CLIProxyAPI 和 CCR(Claude Code Router)。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用。你还可以使用@来通知其他用户。