Claude Code 免费接入 NVIDIA NIM 国产大模型完整教程（零成本可用）

前言

Claude Code 作为终端 AI 编程利器，官方 API 成本较高，而NVIDIA NIM 平台免费开放 GLM‑4.7、MiniMax M2.5、Kimi K2.5 等国产优质模型，可满足代码生成、调试、长上下文理解等需求。

核心问题：NVIDIA API 为 OpenAI 兼容协议，Claude Code 要求 Anthropic 协议，无法直连 。解决方案：用 CLIProxyAPI 做反向代理实现协议转换，全程免费、10 分钟即可配置完成，OpenClaw 等工具可复用此思路。

---

一、申请 NVIDIA API Key（必做第一步）

1.1 注册 NVIDIA 开发者账号

打开官网：https://build.nvidia.com/，完成注册登录。

1.2 手机号验证（国内用户必看）

注册后进入 Verify 验证，手机号必须加 +86 区号 ，格式：+86138xxxxxxxx，否则验证失败。

1.3 生成并保存 API Key

1. 点击右上角头像 → API Keys
2. 点击 Generate API Key
3. Key 仅显示一次，立即复制保存。

---

二、部署 CLIProxyAPI 反向代理（协议转换核心）

2.1 下载 CLIProxyAPI

📌 备用下载（夸克网盘）：
https://pan.quark.cn/s/cb89d172c72c

Windows 选 windows_amd64.zip，解压到本地目录。

2.2 编辑配置文件

1. 复制 config.example.yaml，重命名为 config.yaml
2. 修改关键配置：

# 管理后台密码，自行设置
secret-key: "你的后台密码"
# 允许远程访问
allow-remote: true
# 填入刚才申请的 NVIDIA API Key
api-keys: "nvapi-xxxxxx"

其他参数默认即可。

2.3 启动代理服务

Windows 运行 cli-proxy-api.exe，服务默认监听 8317 端口 ，窗口不能关闭。

2.4 后台添加 AI 提供商

浏览器访问：http://localhost:8317/management.html

1. 用 secret-key 登录
2. 进入 AI 提供商 → 添加提供商
3. 填写信息：
   • 提供商名称：nvidia
   • Base URL：https://integrate.api.nvidia.com/v1
   • API 密钥：填入 NVIDIA API Key
   • 模型列表：添加 z-ai/glm4.7（推荐稳定模型）
4. 保存并测试连通性。

---

三、配置 Claude Code 连接代理（两种方式任选）

方式一：CC Switch 工具（推荐，可视化管理）

📌 备用下载（夸克网盘）：
https://pan.quark.cn/s/ce7ed4e4acd5

1. 打开 CC Switch，新建供应商
2. 关键参数：
   • API Key：NVIDIA API Key
   • 请求地址：http://localhost:8317
   • API 格式：Anthropic Messages (原生)
   • 主模型：z-ai/glm4.7
3. 保存并应用配置。

方式二：手动修改配置文件（无额外工具）

1. 找到 Claude Code 配置目录：~/.claude/settings.json
2. 写入以下配置：

{
  "apiBaseUrl": "http://localhost:8317",
  "apiKey": "你的 NVIDIA API Key"
}

或环境变量写法：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "nvapi-xxxx",
    "ANTHROPIC_BASE_URL": "http://localhost:8317",
    "ANTHROPIC_MODEL": "z-ai/glm4.7"
  }
}

保存后重启终端。

---

四、验证与可用模型清单

4.1 验证是否成功

终端执行：

claude

输入 你是哪个模型，返回 GLM-4.7 即配置成功。

4.2 免费可用模型（NVIDIA NIM）

模型标识	模型名称	核心优势
z-ai/glm4.7	GLM‑4.7	数学推理强，稳定可靠
z-ai/glm5	GLM‑5	综合能力更强
minimaxai/minimax‑m2.5	MiniMax M2.5	代码编辑/修复优秀
moonshotai/kimi‑k2.5	Kimi K2.5	长上下文支持极佳

提示：GLM‑5、MiniMax M2.7 偶有不稳定，优先用 GLM‑4.7。

---

五、常见问题与避坑指南

1. 手机号验证失败 ：必须加 +86 区号
2. 代理无法启动：检查 8317 端口是否被占用
3. Claude Code 连接失败：确认 CLIProxyAPI 窗口未关闭，配置地址正确
4. 模型调用报错：切换为 GLM‑4.7 重试
5. 权限问题：Windows 以管理员身份运行 CLIProxyAPI

---

总结

本方案通过 NVIDIA 免费 API + CLIProxyAPI 协议转换，实现 Claude Code 零成本调用国产大模型，兼顾性能与成本，适合日常开发、学习使用。配置简单、稳定性高，是 Claude Code 平替首选方案。