文档 · 指南

NVIDIA NIM 接入 Claude Code、Codex 等 Agent

NVIDIA 在 build.nvidia.com 上托管 NIM 接口，用一把 nvapi- 开头的 Key 就能调用上面托管的许多模型。magpie 的 nvidia 预设把它接到 Claude Code、Codex、OpenCode 等 Agent。

添加

拿一把 Key。登录 build.nvidia.com，在 Settings → API Keys 里生成一把。
添加。在应用里选 NVIDIA NIM，把 Key 填进 API 密钥，或者在命令行：

终端

magpie provider add nvidia nvapi-…
magpie provider test nvidia

预设只配了 Chat Completions，地址是 https://integrate.api.nvidia.com/v1：NIM 的 /v1/responses 只对少数几个模型有回应，其余都是 404，所以 magpie 不去用它。

给 Agent 用

模型 id 写成 nvidia/<NIM 的模型 id>，模型列表由 NIM 自己给出：

终端

magpie claude nvidia/
magpie codex nvidia/

Claude Code 说 Anthropic 协议，Codex 说 Responses，magpie 都把它们转成 Chat Completions 发给 NIM，再把回答转回 Agent 认得的格式。

免费模型

在 NIM 上标价为 0 的模型，Agent 的模型选择器里会在旁边标上免费。这个价格只算 NIM 的：同一个模型在其他供应商那里照常按那里的价格计；NIM 的 $0 也不会被当作模型厂商的定价。

很多把 Key

从 CC Switch 这类「一把 Key 一个条目」的应用导入时，常见「NVIDIA #001」到「NVIDIA #600」这样几百个条目。magpie 会把除 Key 以外都一样的条目合成一个供应商，每把 Key 是它的一个账号：不然每个模型会在每个 Agent 的选择器里重复几百次。各条目原来的名字留作 Key 的名字，关着的还是关着。

几点说明

在 OpenCode 里配过的 nvidia 供应商，导入时也会变成这个预设。
NIM 的免费额度用完或被限速时，可以把它和其他供应商放进同一个路由组：一个失败了，组里的下一个接着回答。
magpie 分不出一把 NIM 的 Key 是免费的还是付费的，所以不会替你判断它的计费方式。

免费模型接入 Claude Code、Codex 等 Agent

常见问题

magpie 支持 NVIDIA NIM 吗？

支持，用 nvidia 预设。填一把 build.nvidia.com 的 API Key，magpie 走 integrate.api.nvidia.com/v1 的 Chat Completions，模型 id 写成 nvidia/<模型>。

Claude Code 和 Codex 能用 NIM 上的模型吗？

能。NIM 只用 Chat Completions，magpie 把 Claude Code 的 Anthropic 请求和 Codex 的 Responses 请求都转成 Chat，再把回答转回去。

怎么知道哪些模型免费？

NIM 标价为 0 的模型，在 Agent 的模型选择器里旁边标着免费。这只是 NIM 的价格，同一个模型在别的供应商那里照常计价。

导入了几百个 NVIDIA 条目怎么办？

magpie 会把除 Key 以外都一样的条目合成一个供应商，每把 Key 成为它的一个账号，模型不会在选择器里重复。