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. 修改关键配置:
yaml 复制代码
# 管理后台密码,自行设置
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. 填写信息:
  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. 写入以下配置:
json 复制代码
{
  "apiBaseUrl": "http://localhost:8317",
  "apiKey": "你的 NVIDIA API Key"
}

或环境变量写法:

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

保存后重启终端。


四、验证与可用模型清单

4.1 验证是否成功

终端执行:

bash 复制代码
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 平替首选方案。

相关推荐
Flandern11115 天前
从“能跑”到“可运营”:Agent Harness 工程化建设指南
学习·agent·claudecode·harness
逐梦苍穹8 天前
Claude Code 迁移 Codex 实战复盘:基于 15 天本地日志分析使用量、信任成本与失败地图
prompt·claude·codex·claudecode
梦想的颜色9 天前
【AI 速览】2026 硬核横评:Claude Code vs GPT-5.3 Codex 底层架构 / CLI / 工程能力 / 生产落地全维度对比
claudecode·ai 开发工具·gpt codex·大模型代码能力对比·ai 工具选型指南·ai 编程代理横
带刺的坐椅11 天前
SolonCode v2026.7.13 发布:多工作区协同、推理水平可控、子代理任务分组、工程体验再进化
llm·agent·codex·solon-ai·claudecode·opencode
forestsea16 天前
如何使用 Winget 下载 Claude Code 并实现绿色便携安装
windows·claudecode
yubajin18 天前
ClaudeCode本地源码编译、调试、自定义接入大模型实操案例
源码分析·claudecode
yubajin18 天前
Claude Code 本地源码解读——claw-code
源码分析·claudecode
不爱记笔记20 天前
ClaudeCode接入DeepSeek教程!防封号!
人工智能·ai·deepseek·claudecode
程序员徐公22 天前
Claude Code 是怎么悄悄认出中国用户的
claudecode
小七-七牛开发者23 天前
Coding Agent 规则管理:CLAUDE.md、Skills、Hooks、Subagents 到底怎么选?
ai·大模型·agent·claude·token·loop·mcp·claudecode·ai coding