跳转到内容
NoviaHub 文档

编辑器与插件

Kilo Code

在 Kilo Code 的「Custom provider」里添加 NoviaHub：安装、配置、设置上下文长度、切换模型。

Kilo Code 是一个开源的 AI 编程 Agent，可以根据自然语言生成代码、执行终端命令，支持 VS Code、JetBrains 和命令行。它的设置里可以添加「Custom provider」（自定义服务商），填入 NoviaHub 的地址和密钥即可使用 NoviaHub 上的模型。

本页按 VS Code 扩展的界面介绍，界面名称保留英文原文，方便对照。

前提条件

Section titled “前提条件”
  • 一把 NoviaHub API 密钥，见 API 密钥；账户里有余额，见 钱包与充值。
  • VS Code 1.84.0 或更新版本。

安装

Section titled “安装”
  1. 打开 VS Code，按 Ctrl+Shift+X（macOS 为 Cmd+Shift+X）打开扩展面板。
  2. 搜索 Kilo Code。
  3. 点击 Install 旁边的下拉箭头，选择 Install Pre-Release Version。

官方说明：当前版本的 Kilo Code 扩展以「预发布版」渠道发布，这只是 VS Code 扩展市场的发布渠道，扩展本身是稳定版，推荐所有用户使用。

VSCodium、Windsurf 等无法访问 VS Code 官方市场的编辑器，可以在 Open VSX 上搜索 Kilo Code 安装。

配置 NoviaHub

Section titled “配置 NoviaHub”

  1. 打开 Kilo Code 面板，点击齿轮图标打开 Settings，切换到 Providers 标签页。

  2. 滚动到列表底部，点击 Custom provider。

  3. 在弹出的对话框里按下表填写：

    字段 填什么
    Provider ID 服务商 ID，只能用小写字母、数字、- 和 _，例如 noviahub。选模型时会写成 noviahub/模型ID。
    Display name 显示名，例如 NoviaHub。
    Provider API 选 OpenAI Compatible。
    Base URL https://noviahub.com/v1（要带 /v1）。
    API key 你的 NoviaHub 密钥（sk- 开头）。
    Models 填好 Base URL 和 API key 后，Kilo Code 会从 NoviaHub 的 /v1/models 自动读取模型列表，勾选要用的模型即可；也可以手动输入模型 ID。至少要添加一个模型。
    Headers 留空。

  4. 点击 Submit 保存。添加的模型会出现在聊天框的模型选择器里。

换用 Responses 或 Anthropic 协议（可选）

Section titled “换用 Responses 或 Anthropic 协议（可选）”

Provider API 另外还有 OpenAI Responses 和 Anthropic Messages 两个选项。三个选项的 Base URL 都填 https://noviahub.com/v1，Kilo Code 会在后面接上各自的接口路径：

Provider API Base URL 实际请求的接口 模型需要有的端点标签
OpenAI Compatible https://noviahub.com/v1 /v1/chat/completions Chat
OpenAI Responses https://noviahub.com/v1 /v1/responses Response
Anthropic Messages https://noviahub.com/v1 /v1/messages Anthropic
  • 端点标签在 模型&价格 的模型详情里查看。2026-09-28 NoviaHub 上所有文本模型都有 Chat 标签，不确定时用 OpenAI Compatible 即可。Claude 模型建议用 Anthropic Messages，原因见 协议转换。
  • 选 Anthropic Messages 时，Kilo Code 不会自动读取模型列表，要在 Models 里手动输入模型 ID（例如 claude-sonnet-5）。
  • 一个服务商只能选一种协议。想同时用两种协议，就再添加一个 Custom provider，换一个 Provider ID（例如 noviahub-claude）。
  • 在配置文件里，这三个选项对应 npm 的 @ai-sdk/openai-compatible、@ai-sdk/openai 和 @ai-sdk/anthropic。

设置上下文长度（推荐）

Section titled “设置上下文长度（推荐）”

官方说明：对不在 Kilo Code 内置模型目录里的模型，如果不设置上下文长度（limit.context）和最大输出长度（limit.output），两者都按 0 处理，此时：

  • 自动压缩对话（Compaction）会被关闭，对话会一直变长，直到接口因为超长而拒绝请求；
  • 单次回复最多输出 32,000 tokens；
  • 不显示上下文用量。

这两个值要在配置文件里设置。官方说明设置界面读写的就是这些配置文件，全局配置文件的位置是：

  • macOS / Linux：~/.config/kilo/kilo.jsonc
  • Windows：C:\Users\<用户名>\.config\kilo\kilo.jsonc

在文件的 provider 下找到刚才添加的服务商（键名就是你填的 Provider ID），给每个模型加上 limit。文件里找不到、或者想跳过设置界面的话，可以直接写入下面这个完整的例子：

~/.config/kilo/kilo.jsonc
{
  "provider": {
    "noviahub": {
      "npm": "@ai-sdk/openai-compatible",
      "env": ["NOVIAHUB_API_KEY"],
      "options": {
        "baseURL": "https://noviahub.com/v1"
      },
      "models": {
        "deepseek-v4-flash": {
          "name": "deepseek-v4-flash",
          "limit": { "context": 1000000, "output": 384000 }
        }
      }
    }
  },
  "model": "noviahub/deepseek-v4-flash"
}
字段 说明
npm 协议所用的包。@ai-sdk/openai-compatible 对应 OpenAI Chat Completions，不写时默认就是它。
env 从哪个环境变量读取密钥，这样就不用把密钥写进文件。通过设置界面添加、已经填过 API key 的服务商不需要这一项。也可以改成在 options 里写 "apiKey": "sk-..."。
options.baseURL https://noviahub.com/v1。
models 键名是 NoviaHub 上的模型 ID，要和 模型&价格 里的写法逐字一致。
limit.context / limit.output 上下文长度和最大输出长度。示例里的数值取自 2026-09-28 的「模型&价格」页，请以页面上的「上下文」「最大输出」为准。官方说明 limit.output 默认最多为 32,000。
model 默认使用的模型，格式为 服务商ID/模型ID。

用 env 读取密钥时，要先把密钥存进环境变量 NOVIAHUB_API_KEY，方法见 快速开始 第 2 步，然后重新打开 VS Code。

验证

Section titled “验证”

在 Kilo Code 的聊天框里，用模型选择器选中 NoviaHub 下的模型，发一句话。能收到回复，并且 NoviaHub 的 使用日志 里出现这次调用，就说明配置成功。

切换模型

Section titled “切换模型”
  • 点击聊天框的模型选择器，或输入 /models 打开模型列表。
  • 要添加更多模型：回到 Settings → Providers，点击该服务商旁边的 Edit provider，在 Models 里勾选；或直接在配置文件的 models 里添加。

常见问题

Section titled “常见问题”

提示「Invalid API Key」或返回 401 Invalid token（无效的令牌） 密钥写错了，或者这把密钥已被禁用、已过期、额度已用完。到「API 密钥」页检查状态，见 API 密钥 · 密钥的四种状态。

提示「Model Not Found」 模型 ID 与 NoviaHub 上的不一致。到 模型&价格 复制准确的模型 ID。

模型列表没有自动出现 检查 Base URL 是否为 https://noviahub.com/v1、API key 是否正确。自动读取失败时，可以手动输入模型 ID。

返回 403 insufficient_user_quota 账户余额不足，先充值。

参考资料

Section titled “参考资料”

以下资料查阅于 2026-09-28 至 2026-09-29：