Skip to content

VS Code 编程助手 ​

VS Code 里主流的几个 AI 编程插件都支持「OpenAI 兼容」,配置项名字不同但内容一致:

  • Base URL / API 地址:https://api.nowhub.org/v1
  • API Key:sk-...
  • Model ID:模型与价格页里的完整 ID

VS Code 内置 BYOK(Copilot Chat) ​

新版 VS Code 的 Chat 自带「自带密钥」能力,不用装插件也能接第三方模型。

  1. 打开 Chat 视图,点顶部的模型选择器
  2. 选 Manage Models…(命令面板里对应 Chat: Manage Language Models)
  3. 提供商选 OpenAI Compatible
  4. 填写:
    • 名称:NowHub
    • Base URL:https://api.nowhub.org/v1
    • API Key:你的令牌
  5. VS Code 会请求 /v1/models 列出模型,勾选要用的即可;回到 Chat 顶部切换模型

使用限制

  • 需要较新版本的 VS Code,旧版本没有该入口
  • 内置 BYOK 拿到的是「对话模型」,Agent 模式、工具调用等能力取决于所选模型是否支持
  • 密钥存在本机密钥库里,不会写进工作区配置
  • 换模型后如果报 404,多半是模型 ID 不在令牌的可用范围内

Cline ​

  1. 安装扩展 Cline(原 Claude Dev)
  2. 打开设置 → API Provider 选择 OpenAI Compatible
  3. 填写:
    • Base URL:https://api.nowhub.org/v1
    • API Key:你的令牌
    • Model ID:模型广场里的模型 ID
  4. 关掉 Enable streaming 以外的默认选项,先发一句「你好」验证

工具调用

Cline 依赖 function calling。选模型时优先挑模型详情里「能力」标了工具的模型,否则它无法读写文件。

Roo Code ​

Roo Code 是 Cline 的分支,配置位置几乎相同:

  1. 设置 → Provider 选 OpenAI Compatible
  2. Base URL 填 https://api.nowhub.org/v1,粘贴 Key
  3. Model 手动填模型 ID(下拉列表可能拉不到自定义模型)
  4. 需要视觉能力时,勾选模型支持图片输入

Continue ​

Continue 用配置文件,支持 VS Code 与 JetBrains。

  1. 安装扩展后打开 ~/.continue/config.json
  2. 在 models 里加一项:
json
{
  "models": [
    {
      "title": "NowHub",
      "provider": "openai",
      "model": "<模型ID>",
      "apiBase": "https://api.nowhub.org/v1",
      "apiKey": "sk-你的令牌"
    }
  ]
}
  1. 保存后重载窗口,在侧边栏选中该模型

自动补全(tab 补全)用的是单独的 tabAutocompleteModel 字段,配置方式相同,建议选便宜的小模型。

Kilo Code ​

Kilo Code 是 Roo Code 的分支,主打开箱即用的多种模式(Architect / Coder / Debugger / 自定义编排)、内置 MCP 与更细的任务审批,同样跑在 VS Code 里。

配置 ​

  1. 安装扩展 Kilo Code
  2. 打开设置(齿轮)→ API Provider 选 OpenAI Compatible
  3. 填写:
    • Base URL:https://api.nowhub.org/v1
    • API Key:你的令牌
    • Model:点下拉会自动请求 /v1/models;拉不到就手动填模型 ID
  4. 建议同时填这两个字段,否则大文件会提前被截断:
    • Context Window:模型详情页里的上下文长度(1M 就填 1048576)
    • Max Output Tokens:按模型能力填,不确定就留空
  5. 保存后新建任务,随便问一句验证

和 Cline / Roo Code 的差别 ​

项目Kilo CodeClineRoo Code
模式内置多种 + 自定义编排单一流程内置多种
MCP内置管理面板支持支持
审批粒度按工具/命令逐项配置相对简单中等
配置方式图形化为主图形化图形化 + JSON

三者配置项完全一致:Base URL 带 /v1、Key、模型 ID。选哪个主要看交互偏好,模型侧不需要任何改动。

Kilo Code 常见问题 ​

现象原因
报 404Base URL 少了 /v1,或选了令牌不可用的模型
报 400 model not found模型 ID 有空格或大小写不对,回模型广场复制
上下文只有 8K/32K没填 Context Window,扩展用了默认值
能对话但不能改文件模型不支持工具调用,换支持 tools 的模型
一直等待无输出上游超时或模型不支持流式,换模型或调小 max tokens

通用排查 ​

现象原因
404 / Not FoundBase URL 漏了 /v1
401Key 错误或已禁用
模型下拉为空插件调用 /v1/models 拿不到 → 手动输入模型 ID
一直转圈无输出模型不支持流式或上游超时,换模型试
读写文件失败模型不支持工具调用

内容以模型广场与后台实际配置为准。