Continue 接入 OpenAI 兼容 API：VS Code 编程助手教程

Continue 的 OpenAI Provider 支持自定义 apiBase。在 ~/.continue/config.yaml 里设置 provider: openai、版本根地址、API Key 和模型 ID，即可让现有 VS Code 扩展连接 OpenAI 兼容服务。先用下面的最小配置验证 Chat，再逐项启用 Edit、Apply 和 Autocomplete。

维护状态核对日期：2026-10-14。官方 README仍说明项目不再积极维护，并将 VS Code、CLI 与 JetBrains 的 2.0.0 称为最终版本。本文面向已有 Continue 安装；长期采用时应把维护状态和新模型兼容性纳入评估。

OpenAI 兼容 API 的完整配置

Continue 官方 OpenAI Provider 文档给出的核心方法是：

• provider 设为 openai；
• model 填服务商接受的精确模型 ID；
• apiBase 改为第三方服务的版本根地址；
• apiKey 填相应服务的密钥。

以 Nbility 为例：

name: Nbility Coding
version: 0.0.1
schema: v1

models:
  - name: Nbility Coding Model
    provider: openai
    model: YOUR_MODEL_ID
    apiBase: https://api.nbility.ai/v1
    apiKey: YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply

字段说明：

字段	作用
name	Continue 中显示的名称，可自定义
provider	使用的协议适配器，这里为 openai
model	网关接受的精确模型 ID
apiBase	OpenAI 兼容 API 的版本根地址
apiKey	对应网关的访问密钥
roles	该模型承担的 Continue 功能角色

不要把 apiBase 写成：

https://api.nbility.ai/v1/chat/completions

正确的版本根地址是：

https://api.nbility.ai/v1

Continue 会根据功能自行调用相应端点。更多路径概念可参考什么是 OpenAI 兼容 API。

保存后先验证 Chat

在 Continue 中选择配置里的模型，发送“只回复 OK，不调用工具”。能收到文本后，再选中一个小文件，要求只解释内容，并核对 调用日志中的模型。Chat 成功后再测试 Edit 或工具调用；一个普通文本请求不能验证所有角色。请求字段可参考 SDK 接入文档。

第一次调用怎么测试

保存 config.yaml 后，在 Continue 中选中刚添加的模型，先做只读测试：

读取当前项目的 package.json，解释项目使用的框架和测试命令，不要修改文件。

如果 Chat 正常，再测试 Edit：

在一个新的测试文件中添加最小示例，不要安装依赖，也不要修改其他文件。

最后检查：

1. 模型是否稳定返回；
2. 读取的文件是否正确；
3. Edit 生成的 diff 是否合理；
4. Apply 是否能把修改放到正确位置；
5. 多轮对话是否保持上下文；
6. API 网关的请求日志与用量是否符合预期。

不要用“你好”作为唯一验证。编程助手必须通过真实代码上下文和修改流程测试。

安装 Continue VS Code 扩展

打开 VS Code Extensions，搜索：

Continue - open-source AI code agent

也可以在 Quick Open 中运行：

ext install Continue.continue

安装后，打开 Continue Chat 侧边栏。官方文档给出的 VS Code 快捷键是：

Ctrl/Cmd + L

然后在聊天输入框上方打开 Config 选择器，找到 Local Config，点击齿轮图标编辑配置。

Continue 2.0 使用 config.yaml

当前配置文件位置是：

macOS / Linux: ~/.continue/config.yaml
Windows: %USERPROFILE%\.continue\config.yaml

旧文章常见的：

~/.continue/config.json

已经被官方标记为 Deprecated。新配置应使用 YAML。

最小配置的顶层结构包含：

name: My Local Config
version: 0.0.1
schema: v1

models:
  # 模型配置

保存后 Continue 会自动重新加载，不需要重启 VS Code。若 YAML 缩进错误，扩展通常会显示配置问题。

不要把真实 API Key 提交到 Git

为了让示例直观，上面的 YAML 使用了 YOUR_API_KEY。实际使用时，不要把真实密钥提交到仓库。

Continue 官方配置指南建议敏感数据通过环境变量或 Secret 引用，而不是硬编码。不同安装方式下 Secret 的管理入口可能不同，因此应以最终 2.0.0 扩展中的本地 Config/Secret 功能为准。

至少要做到：

• 不把真实 Key 写进项目共享配置；
• 不在截图、Issue 和聊天记录中展示完整 Key；
• 为开发工具创建独立 Key；
• 设置预算、用量或权限范围；
• 泄露后立即撤销并轮换。

roles 决定模型用在哪里

Continue 不只调用一个“聊天模型”。官方列出的模型角色包括：

Role	用途
chat	侧边栏对话与代码问答
edit	根据指令生成代码修改
apply	决定如何把修改应用到文件
autocomplete	编辑器内实时补全
embed	为代码和文档生成向量
rerank	对检索结果重新排序

一个普通 OpenAI 兼容聊天模型可以先承担：

roles:
  - chat
  - edit
  - apply

但不要默认把它同时用于 autocomplete、embed 和 rerank。

为什么 Autocomplete 应该单独配置

Autocomplete 对延迟和连续补全格式要求更高。一个擅长长上下文推理的模型，未必适合每次按键后快速返回代码。

如果 Provider 有专门的低延迟代码模型，可以单独增加：

models:
  - name: Main Coding Model
    provider: openai
    model: YOUR_MAIN_MODEL_ID
    apiBase: https://api.nbility.ai/v1
    apiKey: YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply

  - name: Fast Autocomplete Model
    provider: openai
    model: YOUR_FAST_MODEL_ID
    apiBase: https://api.nbility.ai/v1
    apiKey: YOUR_API_KEY
    roles:
      - autocomplete

是否真正可用于 Autocomplete，仍取决于 Continue 的适配和模型行为。若补全无响应或体验不稳定，先移除该角色，不要把 Chat 正常当成 Autocomplete 一定正常。

Embed 和 Rerank 不能用聊天模型冒充

Embedding 与 Rerank 的输入输出协议不同。只有 Provider 明确提供对应模型和端点时才配置，否则代码库检索会失败或返回无效结果。

Responses API 与 Chat Completions

Continue 当前 OpenAI Provider 文档说明：对于部分 o-series 和 GPT-5 模型，默认可能使用 /responses 端点。

如果第三方网关只支持 /chat/completions，或者遇到与 reasoning summaries、streaming、organization verification 相关的错误，可以配置：

models:
  - name: Compatible Chat Model
    provider: openai
    model: YOUR_MODEL_ID
    apiBase: https://api.nbility.ai/v1
    apiKey: YOUR_API_KEY
    useResponsesApi: false
    roles:
      - chat
      - edit
      - apply

这会要求 Continue 使用 Chat Completions 路径，而不是 Responses API。

不要看到 404 就立即更换 Key。先确认失败的是：

/v1/responses

还是：

/v1/chat/completions

两者支持情况可能不同。

什么时候使用 Legacy Completions

官方配置还保留：

useLegacyCompletionsEndpoint: true

它用于强制调用旧的 Completions Endpoint，而不是 Chat Completions。除非你的本地服务或旧模型明确要求，否则不要开启。

现代聊天和编程模型通常应优先使用 Chat Completions 或 Responses。错误启用 Legacy 模式可能导致消息、工具或上下文格式不兼容。

常见问题排查

配置保存后没有模型

检查：

• 文件是否位于 ~/.continue/config.yaml；
• Windows 路径是否正确；
• YAML 是否使用空格缩进；
• 是否包含 name、version 和 schema: v1；
• models 是否为列表；
• 当前打开的是不是 Local Config。

401 / Invalid API Key

确认 Key 属于当前 apiBase，没有多余空格，且账号拥有目标模型权限。不要把其他 Provider 的 Key 与 Nbility Base URL 混用。

404 / Model Not Found

常见原因有：

• Model ID 使用了展示名称；
• apiBase 缺少 /v1；
• apiBase 错误包含 /chat/completions；
• Continue 请求了网关不支持的 /responses；
• 该 Key 无权访问对应模型。

Chat 可用，Edit 或 Apply 失败

Chat 返回文本不代表修改链路完整。尝试：

• 明确加入 edit 和 apply roles；
• 更换工具/代码能力更稳定的模型；
• 缩小修改范围；
• 检查流式响应是否被网关截断；
• 将 useResponsesApi 设为 false 后重试。

Autocomplete 不工作

检查是否存在拥有 autocomplete role 的模型。然后确认模型延迟、协议与补全能力。不要假设任意聊天模型都能提供理想的行内补全。

429、超时或 5xx

429 通常与额度、并发和限流有关；超时可能来自模型延迟、上下文过长或网络；5xx 更可能来自网关或上游。使用有上限的退避重试，并参考 AI API 错误码排查指南。

Continue 现在还适合使用吗？

如果你已经在使用 Continue 2.0，并且配置稳定，它仍可以作为本地可控的 VS Code 编程助手继续运行。config.yaml、多模型角色和 OpenAI 兼容 Provider 仍然有实际价值。

但对于新项目，应同时考虑：

• 官方仓库已经只读；
• 新模型、新 API 和 VS Code 变化可能缺少后续维护；
• 团队需要自行承担兼容性和安全风险；
• 如果长期依赖 Agent 工作流，可评估仍在活跃维护的工具。

可以参考 Claude Code、Codex、Cursor 和 OpenCode 对比了解不同方向。选择重点不只是“能不能接 API”，还包括维护状态、权限控制、自动化和团队治理。

通过 Nbility 接入多个模型

如果你仍希望在 Continue 中通过一个入口测试不同模型，可以在 Nbility 模型广场复制准确 Model ID，并使用：

models:
  - name: Nbility Model
    provider: openai
    model: YOUR_MODEL_ID
    apiBase: https://api.nbility.ai/v1
    apiKey: YOUR_API_KEY
    useResponsesApi: false
    roles:
      - chat
      - edit
      - apply

请先用占位符准备配置，再通过本地 Secret 或环境变量方式注入真实 Key。遇到兼容问题，可在 Nbility 工单提交脱敏后的错误路径、状态码和 Model ID。

FAQ

Continue 可以连接任意 OpenAI 兼容 API 吗？

可以通过 provider: openai 和 apiBase 配置兼容端点，但实际功能取决于网关是否支持 Continue 使用的请求路径、流式响应和模型行为。

config.json 还能用吗？

官方文档已将 JSON 配置标记为 Deprecated。新配置应使用 ~/.continue/config.yaml。

为什么 /responses 返回 404？

部分兼容网关只实现了 /chat/completions。可以设置 useResponsesApi: false，再确认模型本身支持 Chat Completions。

一个模型能承担所有 roles 吗？

配置上可以给多个角色，但 Chat、Autocomplete、Embedding 和 Rerank 的需求不同。按角色选择模型通常更稳定。

Continue 停止维护后还能继续用吗？

现有最终版本不会因为仓库只读立刻失效，但未来兼容性、安全修复和新功能没有持续维护保证。长期使用前应评估风险。

总结

Continue 2.0 接入 OpenAI 兼容 API 的关键步骤是：

1. 安装 VS Code 扩展并打开 Local Config；
2. 在 ~/.continue/config.yaml 中使用 provider: openai；
3. 填写正确的 model、apiBase 和本地 Secret；
4. 为模型分配 chat、edit、apply 等合适 roles；
5. 用真实代码任务验证 Chat、Edit 和 Apply；
6. 遇到 Responses API 兼容问题时尝试 useResponsesApi: false；
7. 把官方仓库已只读这一维护状态纳入长期选型。

配置本身并不复杂，真正需要注意的是协议差异、角色能力和项目的长期可维护性。

参考资料

• Continue Documentation
• Continue OpenAI Provider
• Continue config.yaml Reference
• Continue Model Roles
• Continue Configuration Guide
• Continue VS Code Marketplace