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 用的配置信息如下配置项值Base URLhttps://token.sensenova.cn/v1API Key在 SenseNova 控制台 https://platform.sensenova.cn/console/keys 申请Model IDsensenova-6.8-flash-lite或其他可用模型SenseNova 当前可用的模型包括模型名称Model ID说明SenseNova 6.8 Flash Litesensenova-6.8-flash-lite轻量高效的多模态智能体模型适配数据分析和复杂信息呈现场景DeepSeek V4 Prodeepseek-v4-pro旗舰通用模型面向复杂 Agent 与高强度推理任务支持 1M 上下文DeepSeek V4 Flashdeepseek-v4-flash高效经济型通用模型适合日常问答、代码辅助GLM-5.2glm-5.2智谱旗舰开源模型面向长程 Coding 与复杂工程任务Kimi K3kimi-k3月之暗面旗舰开源原生多模态 Agent 模型1M 上下文注意sensenova-u1-fast是图像生成专用接口不支持作为对话模型配置到 OpenCode 里。二、准备工作1. 安装 Node.jsOpenCode 需要 Node.js v18.0 或更高版本。如果本机没有安装或版本过低先去 Node.js 官网下载安装项目地址Node.js 下载https://nodejs.org/en/download/2. 申请 SenseNova API Key在 SenseNova 控制台 https://platform.sensenova.cn/console/keys 申请 API Key。建议为不同工具创建独立的 API Key方便后续监控与轮换密钥也可以在控制台随时注销。三、OpenCode 安装与配置步骤1. 安装 OpenCodeNode.js 准备好后执行以下命令全局安装npminstall-gopencode-ai2. 验证安装opencode-v能正常输出版本号说明安装成功。3. 创建配置文件在以下路径创建配置文件opencode.jsonmacOS / Linux~/.config/opencode/opencode.jsonWindowsC:\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这个兼容协议适配器nameprovider 显示名称配置后会以Sense Nova出现在模型列表里baseURLSenseNova 的 OpenAI 兼容接口地址apiKey替换为你的真实密钥models声明的模型列表sensenova-6.8-flash-lite支持文本和图片输入、文本输出上下文 256000最大输出 65536。5. 重启 OpenCode保存配置文件后退出并重新启动 OpenCode使新配置生效。只保存不重启新配置不会被加载。四、使用方法与验证在终端进入项目目录启动 OpenCodeopencode在命令行输入/models搜索Sense Nova选择模型后即可使用。验证是否配置成功可以在选中模型后发送一个中文问题例如让它介绍自己或写一个简单函数能正常返回内容就说明 baseURL、apiKey 都配置正确。五、常见问题1. 启动后 /models 里搜不到 Sense Nova 怎么办按顺序检查配置文件路径是否正确macOS/Linux 是~/.config/opencode/opencode.jsonWindows 是C:\Users\您的用户名\.config\opencode\opencode.jsonJSON 格式是否合法少逗号、少引号都会导致配置解析失败修改配置后是否退出并重新启动了 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.jsonWindows 为C:\Users\用户名\.config\opencode\opencode.json写入完整配置把 apiKey 替换成自己的密钥确认 baseURL 末尾带/v1重启 OpenCode 后用/models搜索 Sense Nova 选择模型即可使用。最常见的 404 问题就是/v1丢了配置时务必留意。