英伟达 NIM API 配置 Claude Code 完整教程（使用 CCR UI）
## 前言
2026年，英伟达（NVIDIA）在 NIM 平台上提供了免费的 API 调用服务，包括智谱 GLM 4.7 和 MiniMax M 2.1 等顶级模型。完全免费、不限调用、国内直连！
本教程教你如何配置 Claude Code 使用英伟达 NIM API，实现零成本调用顶级大模型。
---
## 第一步：获取英伟达 API Key
### 1.1 注册 NVIDIA 账号
1. 访问 https://build.nvidia.com/models
2. 点击右上角「Sign In」→「Create Account」
3. 填写邮箱和密码，完成人机验证
### 1.2 手机号验证
- 地区选择「China (+86)」
- 填写国内手机号
- 验证码秒到
### 1.3 生成 API Key
1. 登录后，点击右上角头像 →「Settings」
2. 选择「API Keys」→「Generate API Key」
3. **重要：Expiration 选择「Never Expire」（永不过期）**
4. 立即复制保存 Key（以 nvapi- 开头）
> ⚠️ 注意：Key 只显示一次，务必保存！
---
## 第二步：安装 Claude Code Router (CCR)
Claude Code Router 是一个中间件工具，可以将 Claude Code 的请求转发到 OpenAI 兼容的 API。
### 2.1 安装 Node.js
确保已安装 Node.js 18+，可通过以下命令检查：
```bash
node -v
```
### 2.2 安装 CCR
```bash
npm install -g @musistudio/claude-code-router
```
### 2.3 启动 CCR UI
```bash
ccr ui
```
浏览器会自动打开 http://127.0.0.1:3456/ui/
---
## 第三步：配置 NVIDIA 供应商
### 3.1 添加供应商
在 CCR UI 界面：
1. 点击「添加供应商」按钮
2. 填写以下信息：
| 字段 | 值 |
|------|-----|
| 名称 | nvidia |
| API 完整地址 | https://integrate.api.nvidia.com/v1/chat/completions |
| API 密钥 | 你的 nvapi-xxx 密钥 |
### 3.2 添加模型
在「模型」输入框中添加：
```
z-ai/glm4.7
```
按回车确认添加。
> 💡 你也可以添加其他模型，如 minimaxai/minimax-m2.1
### 3.3 设置默认路由
1. 在右侧「路由」区域
2. 将「默认」下拉框选择为 nvidia, z-ai/glm4.7
3. 点击「保存并重启」
---
## 第四步：启动 Claude Code
配置完成后，使用以下命令启动：
```bash
ccr code
```
而不是直接运行 claude。CCR 会自动将请求转发到 NVIDIA API。
---
## 常见问题
### Q1: 提示 Auth conflict 错误？
检查是否有残留的环境变量或 settings.json 配置：
1. 删除 ~/.claude/settings.json
2. 清除系统环境变量中的 ANTHROPIC_* 变量
3. 重新打开终端
### Q2: API 调用失败？
1. 确认 API Key 正确
2. 检查网络连接（国内可直接访问）
3. 确认模型名称正确：z-ai/glm4.7
### Q3: 如何切换模型？
在 CCR UI 的「路由」区域，选择不同的模型即可。
---
## 支持的模型列表
英伟达 NIM 平台支持的模型（部分）：
| 模型 | 描述 |
|------|------|
| z-ai/glm4.7 | 智谱 GLM 4.7，前端 UI 能力强 |
| minimaxai/minimax-m2.1 | MiniMax M 2.1，多语言编程强 |
---
## 总结
通过 Claude Code Router + 英伟达 NIM API，你可以：
- ✅ 免费使用顶级大模型
- ✅ 国内直连，无需代理
- ✅ 简单配置，一键启动
- ✅ 支持 GLM 4.7、MiniMax M 2.1 等模型
赶紧去试试吧！这种官方福利通常有窗口期，用的人多了可能会限流或收费。