主题
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 自带「自带密钥」能力,不用装插件也能接第三方模型。
- 打开 Chat 视图,点顶部的模型选择器
- 选 Manage Models…(命令面板里对应
Chat: Manage Language Models) - 提供商选 OpenAI Compatible
- 填写:
- 名称:
NowHub - Base URL:
https://api.nowhub.org/v1 - API Key:你的令牌
- 名称:
- VS Code 会请求
/v1/models列出模型,勾选要用的即可;回到 Chat 顶部切换模型
使用限制
- 需要较新版本的 VS Code,旧版本没有该入口
- 内置 BYOK 拿到的是「对话模型」,Agent 模式、工具调用等能力取决于所选模型是否支持
- 密钥存在本机密钥库里,不会写进工作区配置
- 换模型后如果报 404,多半是模型 ID 不在令牌的可用范围内
Cline
- 安装扩展 Cline(原 Claude Dev)
- 打开设置 → API Provider 选择
OpenAI Compatible - 填写:
- Base URL:
https://api.nowhub.org/v1 - API Key:你的令牌
- Model ID:模型广场里的模型 ID
- Base URL:
- 关掉
Enable streaming以外的默认选项,先发一句「你好」验证
工具调用
Cline 依赖 function calling。选模型时优先挑模型详情里「能力」标了工具的模型,否则它无法读写文件。
Roo Code
Roo Code 是 Cline 的分支,配置位置几乎相同:
- 设置 → Provider 选
OpenAI Compatible - Base URL 填
https://api.nowhub.org/v1,粘贴 Key - Model 手动填模型 ID(下拉列表可能拉不到自定义模型)
- 需要视觉能力时,勾选模型支持图片输入
Continue
Continue 用配置文件,支持 VS Code 与 JetBrains。
- 安装扩展后打开
~/.continue/config.json - 在
models里加一项:
json
{
"models": [
{
"title": "NowHub",
"provider": "openai",
"model": "<模型ID>",
"apiBase": "https://api.nowhub.org/v1",
"apiKey": "sk-你的令牌"
}
]
}- 保存后重载窗口,在侧边栏选中该模型
自动补全(tab 补全)用的是单独的 tabAutocompleteModel 字段,配置方式相同,建议选便宜的小模型。
Kilo Code
Kilo Code 是 Roo Code 的分支,主打开箱即用的多种模式(Architect / Coder / Debugger / 自定义编排)、内置 MCP 与更细的任务审批,同样跑在 VS Code 里。
配置
- 安装扩展 Kilo Code
- 打开设置(齿轮)→ API Provider 选
OpenAI Compatible - 填写:
- Base URL:
https://api.nowhub.org/v1 - API Key:你的令牌
- Model:点下拉会自动请求
/v1/models;拉不到就手动填模型 ID
- Base URL:
- 建议同时填这两个字段,否则大文件会提前被截断:
- Context Window:模型详情页里的上下文长度(
1M就填1048576) - Max Output Tokens:按模型能力填,不确定就留空
- Context Window:模型详情页里的上下文长度(
- 保存后新建任务,随便问一句验证
和 Cline / Roo Code 的差别
| 项目 | Kilo Code | Cline | Roo Code |
|---|---|---|---|
| 模式 | 内置多种 + 自定义编排 | 单一流程 | 内置多种 |
| MCP | 内置管理面板 | 支持 | 支持 |
| 审批粒度 | 按工具/命令逐项配置 | 相对简单 | 中等 |
| 配置方式 | 图形化为主 | 图形化 | 图形化 + JSON |
三者配置项完全一致:Base URL 带 /v1、Key、模型 ID。选哪个主要看交互偏好,模型侧不需要任何改动。
Kilo Code 常见问题
| 现象 | 原因 |
|---|---|
报 404 | Base URL 少了 /v1,或选了令牌不可用的模型 |
报 400 model not found | 模型 ID 有空格或大小写不对,回模型广场复制 |
| 上下文只有 8K/32K | 没填 Context Window,扩展用了默认值 |
| 能对话但不能改文件 | 模型不支持工具调用,换支持 tools 的模型 |
| 一直等待无输出 | 上游超时或模型不支持流式,换模型或调小 max tokens |
通用排查
| 现象 | 原因 |
|---|---|
404 / Not Found | Base URL 漏了 /v1 |
401 | Key 错误或已禁用 |
| 模型下拉为空 | 插件调用 /v1/models 拿不到 → 手动输入模型 ID |
| 一直转圈无输出 | 模型不支持流式或上游超时,换模型试 |
| 读写文件失败 | 模型不支持工具调用 |