企业官网建设流程全解析

OpenCode 接入 SenseNova 大模型 API 教程：opencode.json 配置方法

推荐标题：OpenCode 接入 SenseNova 大模型 API 教程：终端 AI 编程助手配置方法

关键词

OpenCode、OpenCode接入SenseNova、opencode.json配置、终端AI编程助手、SenseNova API、sensenova-6.8-flash-lite、OpenCode自定义模型、OpenCode 404解决方法

摘要

OpenCode 是一款终端 AI 编程助手，支持 OpenAI 兼容 API，可以通过配置文件接入 SenseNova（商汤日日新）大模型。这篇文章主要分享 OpenCode 接入 SenseNova 的完整教程，包括安装与验证、opencode.json 配置文件的创建路径、完整配置内容，以及 Base URL 末尾/v1必须保留这个关键细节。

大家好 这里是「代码简单说」，这篇文章主要分享一下 OpenCode 接入 SenseNova 大模型 API 的配置方法。

OpenCode 是跑在终端里的 AI 编程助手，不依赖编辑器，装好命令行工具、写一个 JSON 配置文件就能用。SenseNova 提供了 OpenAI 兼容接口，OpenCode 的 provider 配置正好支持这类接口，所以两边可以很自然地接起来。

这篇文章适合习惯命令行工作流、想用终端 AI 编程工具的开发者。配置本身不难，但有一个 404 的坑（Base URL 少了/v1）需要提前避开，文中会重点说明。

一、OpenCode 和 SenseNova 是什么

OpenCode 是一款终端 AI 编程助手，支持 OpenAI 兼容 API。它以 npm 包的形式分发，安装后直接在命令行里启动使用。

SenseNova（商汤日日新）提供 OpenAI 兼容接口，覆盖文本对话、多模态理解、图像生成、工具调用与流式响应等能力，可直接接入主流 AI 编程助手。接入 OpenCode 用的配置信息如下：

SenseNova 当前可用的模型包括：

注意：sensenova-u1-fast是图像生成专用接口，不支持作为对话模型配置到 OpenCode 里。

二、准备工作

1. 安装 Node.js

OpenCode 需要 Node.js v18.0 或更高版本。如果本机没有安装或版本过低，先去 Node.js 官网下载安装：

2. 申请 SenseNova API Key

在 SenseNova 控制台 https://platform.sensenova.cn/console/keys 申请 API Key。建议为不同工具创建独立的 API Key，方便后续监控与轮换，密钥也可以在控制台随时注销。

三、OpenCode 安装与配置步骤

1. 安装 OpenCode

Node.js 准备好后，执行以下命令全局安装：

npminstall-gopencode-ai

2. 验证安装

opencode-v

能正常输出版本号，说明安装成功。

3. 创建配置文件

在以下路径创建配置文件opencode.json：

• macOS / Linux：~/.config/opencode/opencode.json
• Windows：C:\Users\您的用户名\.config\opencode\opencode.json

注意 Windows 下路径在用户目录的.config文件夹里，如果文件夹不存在需要手动创建。

4. 写入配置内容

将以下配置写入文件（将$SENSENOVA_API_KEY替换为你的 SenseNova API Key）：

{"$schema":"https://opencode.ai/config.json","provider":{"sense-nova":{"npm":"@ai-sdk/openai-compatible","name":"Sense Nova","options":{"baseURL":"https://token.sensenova.cn/v1","apiKey":"$SENSENOVA_API_KEY"},"models":{"sensenova-6.8-flash-lite":{"name":"SenseNova 6.8 Flash-Lite","modalities":{"input":["text","image"],"output":["text"]},"limit":{"context":256000,"output":65536}}}}}}

这里特别强调一个关键点：

Base URL 末尾必须附带/v1，否则将报错 404 Not Found。

也就是options.baseURL的值必须是https://token.sensenova.cn/v1。写成https://token.sensenova.cn会导致请求路径不对，直接 404。

配置中几个字段的含义：

• npm：指定使用@ai-sdk/openai-compatible这个兼容协议适配器；
• name：provider 显示名称，配置后会以Sense Nova出现在模型列表里；
• baseURL：SenseNova 的 OpenAI 兼容接口地址；
• apiKey：替换为你的真实密钥；
• models：声明的模型列表，sensenova-6.8-flash-lite支持文本和图片输入、文本输出，上下文 256000，最大输出 65536。

5. 重启 OpenCode

保存配置文件后，退出并重新启动 OpenCode使新配置生效。只保存不重启，新配置不会被加载。

四、使用方法与验证

在终端进入项目目录，启动 OpenCode：

opencode

在命令行输入/models，搜索Sense Nova，选择模型后即可使用。

验证是否配置成功，可以在选中模型后发送一个中文问题，例如让它介绍自己或写一个简单函数，能正常返回内容就说明 baseURL、apiKey 都配置正确。

五、常见问题

1. 启动后 /models 里搜不到 Sense Nova 怎么办？

按顺序检查：

• 配置文件路径是否正确：macOS/Linux 是~/.config/opencode/opencode.json，Windows 是C:\Users\您的用户名\.config\opencode\opencode.json；
• JSON 格式是否合法，少逗号、少引号都会导致配置解析失败；
• 修改配置后是否退出并重新启动了 OpenCode。

2. 请求报 404 Not Found 怎么办？

检查baseURL末尾是否带上了/v1。正确值为https://token.sensenova.cn/v1，少了/v1会直接报 404 Not Found。

3. 提示鉴权失败怎么办？

确认apiKey字段已经把$SENSENOVA_API_KEY替换为在 SenseNova 控制台申请的真实密钥，且密钥仍在有效额度内。

4. 怎么换用其他模型？

在opencode.json的models里追加模型条目即可，Model ID 用 SenseNova 的模型标识，例如deepseek-v4-pro、glm-5.2、kimi-k3。保存后重启 OpenCode，再用/models搜索选择。

5. 能配置 SenseNova U1 Fast 吗？

不能。sensenova-u1-fast是图像生成专用接口，不支持作为对话模型使用，无法在 OpenCode 中配置为对话模型。

六、总结

以上就是 OpenCode 接入 SenseNova 大模型 API 的完整教程。流程总结：安装 Node.js v18 及以上版本，npm install -g opencode-ai安装并opencode -v验证，在~/.config/opencode/opencode.json（Windows 为C:\Users\用户名\.config\opencode\opencode.json）写入完整配置，把 apiKey 替换成自己的密钥，确认 baseURL 末尾带/v1，重启 OpenCode 后用/models搜索 Sense Nova 选择模型即可使用。最常见的 404 问题就是/v1丢了，配置时务必留意。