OpenCode + NVIDIA 免费 API：配置 AI 编程助手教程

AI 编程助手已经成为不少开发者的日常工具，但主流商业服务多要订阅费，本地部署大模型又对显卡有较高要求。本文介绍一种组合方案：用 NVIDIA 官方提供的免费 API（NVIDIA NIM），接入开源工具 OpenCode，把它变成一台可用的 AI 编程助手。

说明：NVIDIA 免费 API 的额度、调用频率限制以 build.nvidia.com 官方页面实时规则为准，本文不承诺长期有效。

一、获取 NVIDIA API 密钥

1. 注册账号：前往 build.nvidia.com，用邮箱注册并完成验证码校验，设置账户名称；
2. 手机验证：按提示绑定手机号（国内手机号可正常接收验证码），完成账户初始化；
3. 生成密钥：登录控制台，点击右上角头像 → API Key → Generate API Key，起个名字，有效期默认 12 个月即可；
4. 保存密钥：密钥只显示一次，复制后保存在本地文本文件中，关闭页面后无法再次查看。

二、安装与配置 OpenCode

1. 安装

OpenCode 官网：https://opencode.ai/

打开 PowerShell，按官网的 NPM 安装指引执行安装命令，装完后重启终端刷新环境变量。验证安装：

# 查看版本
opencode -v

# 启动
opencode

排查安装问题时可以用到：

# 查看 npm 全局安装路径
npm config get prefix

# 检查环境变量
$env:Path -split ';'

2. 对接 API 密钥

在 OpenCode 输入框中输入 /connect，选择 Nvidia 作为提供商，按提示粘贴上一步保存的 API 密钥。

粘贴技巧：在终端里直接 Ctrl+V 可能无效，可用 Ctrl + Shift + V 或鼠标右键粘贴。

3. 选择模型并测试

连接成功后，从模型列表中选择可用模型（如 Llama、Gemma、Qwen 系列）。如果某个模型提示不可用，切换列表中其他模型再试即可。

三、使用示例

配置完成后，就可以在 OpenCode 里用自然语言提需求，让 AI 生成代码。例如让它写一个贪吃蛇网页小游戏，AI 会生成完整代码并可自动创建本地存放路径，打开运行即可。

在 NVIDIA 控制台的模型库中可以看到当前开放的开源模型列表，具体可用模型以官方页面为准。

四、总结

通过 NVIDIA 免费 API 接入 OpenCode，个人开发者可以零成本体验大模型辅助编程。整个流程就是注册 → 拿 Key → 安装 → 对接四步，遇到问题欢迎在评论区交流。

---

说明：本文基于 NVIDIA NIM 与 OpenCode 官方版本流程整理，界面与免费政策以官网实时版本为准。