编辑器与插件
Cline
在 VS Code 等编辑器的 Cline 插件里,用「OpenAI Compatible」服务商接入 NoviaHub:安装、配置、选择模型。
Cline 是一个 AI 编程 Agent(官方介绍:Your AI-powered agent for complex work),以插件形式运行在 VS Code、JetBrains 等编辑器中,也提供命令行和桌面应用。它的「OpenAI Compatible」服务商可以填写自定义的接口地址,用来接入 NoviaHub。
- 一把 NoviaHub API 密钥,见 API 密钥;账户里有余额,见 钱包与充值。
- 已安装 VS Code(或 Cursor、Windsurf、VSCodium 等兼容编辑器),或 JetBrains 系列 IDE。
- 按
Ctrl+Shift+X(macOS 为Cmd+Shift+X)打开扩展面板。 - 搜索
Cline,点击 Install。官方扩展的 ID 是saoudrizwan.claude-dev,安装前可核对发布者。
在 IDE 中打开 Settings → Plugins → Marketplace,搜索 Cline 并安装;也可以在 JetBrains 插件页 安装。
本页只介绍编辑器插件的配置方法。
配置 NoviaHub
Section titled “配置 NoviaHub”-
打开 Cline 面板,点击面板里的设置图标(⚙️)。
-
API Provider 选择 OpenAI Compatible。
-
填写:
字段 填写内容 Base URL https://noviahub.com/v1(要带/v1)API Key 你的 NoviaHub 密钥( sk-开头)Model ID 要使用的模型 ID,例如 deepseek-v4-flash -
可选:在 Model Configuration 中填写该模型的 Context Window(上下文长度)、Max Output Tokens(最大输出)等信息,数值可以在 模型&价格 的模型详情里查到。
-
完成设置后回到 Cline 面板。
在 Cline 面板里发一个简单的任务(例如「解释一下这个文件是做什么的」),能正常回复就表示接通。再到 NoviaHub 控制台的 使用日志 里确认出现了这次调用。
在设置里修改 Model ID 即可。模型 ID 必须与 NoviaHub 模型页上的完全一致。Cline 的 Plan 模式和 Act 模式分别保存各自的模型选择,两个模式可以用不同的模型。
Cline 以 OpenAI 兼容方式调用模型。2026-09-28 NoviaHub 上的所有模型都支持 OpenAI 兼容的 Chat Completions 接口(端点标签 Chat),模型会增减,请以 模型&价格 为准。
返回 401 Invalid token(无效的令牌)
密钥填错,或密钥已被禁用、已过期、额度已用完,到「API 密钥」页检查,见 API 密钥 · 密钥的四种状态。
返回 503,提示 No available channel for model ...
Model ID 写错了,或这个模型当前不可用。核对模型页上的 ID,不要有多余的空格。
返回 403 insufficient_user_quota
账户余额不足,先充值。
以下资料查阅于 2026-09-28:
- Cline 概览:https://docs.cline.bot/cline-overview
- 安装:https://docs.cline.bot/getting-started/installing-cline
- OpenAI Compatible 服务商配置:https://docs.cline.bot/provider-config/openai-compatible
- Cline 源码(OpenAI Compatible 设置界面):https://github.com/cline/cline/blob/main/apps/vscode/webview-ui/src/components/settings/providers/OpenAICompatible.tsx