Continue OpenAI Compatible API 配置教程

更新于 2026-10-18 · laozhang.cfd

简答：在 Continue 中接入 OpenAI Compatible API，核心是把模型的 provider 设置为 openai，再填写实际模型名、apiBase 和 API Key。推荐使用 config.yaml，并通过 secrets 或 .env 保存密钥，不要把真实 Key 直接提交到代码仓库。

定义：OpenAI Compatible API 是一种兼容 OpenAI 请求格式的接口，Continue 可以通过 provider: openai 加 apiBase 指向这类服务的 /v1 接口。

Continue OpenAI Compatible API 是什么

Continue 是面向代码开发场景的 AI 编程助手。它的模型配置通常放在 config.yaml 中，每个模型至少需要定义名称、供应商、模型标识和调用地址等信息。对于采用 OpenAI 风格请求格式的接口，Continue 官方文档建议使用 provider: openai，再通过 apiBase 修改默认 API 地址。

这里的“OpenAI Compatible”主要表示接口在请求结构上兼容 OpenAI 风格，通常会提供类似 /v1/chat/completions 的路径，但不同服务对模型名称、工具调用、视觉输入、Responses API 和流式输出的支持可能不同。因此，Continue 能否正常使用，不只取决于 Base URL，还取决于接口是否实现了 Continue 实际发送的请求能力。

Continue 官方列出的配置字段包括 name、provider、model、apiBase、apiKey 和 roles。YAML 是当前推荐的配置形式，旧版 config.json 主要用于迁移或兼容已有配置。可参考 Continue 官方 OpenAI 配置说明 和 Continue config.yaml 配置参考。

配置前需要准备什么

1. 接口地址：准备服务商提供的 OpenAI Compatible API Base URL。Continue 示例使用类似 http://localhost:8000/v1 的地址，实际使用时应以接口文档给出的地址为准。
2. 模型标识：准备服务端实际接受的模型名，例如服务端返回的模型列表中的某个 id。模型名写错时，常见结果是 404、模型不存在或请求被服务端拒绝。
3. API Key：准备可用的 API Key。不要把真实密钥直接发布在文章、截图、Git 仓库或公共配置中。
4. Continue 配置目录：全局配置通常位于 macOS/Linux 的 ~/.continue/config.yaml，Windows 通常位于 %USERPROFILE%\.continue\config.yaml。Continue CLI 使用的也是这一类配置路径。
5. 接口能力：确认服务端至少支持 Continue 当前配置所需的对话接口。如果还要使用 Agent、工具调用、图片输入或自动补全，需要进一步核对模型能力。

如果你使用的是 VS Code 或 JetBrains 扩展，Continue 官方说明指出，IDE 扩展不能直接读取你在终端中执行的 export OPENAI_API_KEY=...。更稳妥的方式是在工作区或 Continue 配置目录中创建 .env，然后在 YAML 中使用 ${{ secrets.OPENAI_API_KEY }}。详情可查看 Continue 官方 FAQ 中的密钥与环境变量说明。

最小可运行的 config.yaml 示例

下面是一个适合 OpenAI Compatible API 的最小配置。请把示例中的地址、模型名和密钥变量替换成你自己的值：

name: OpenAI Compatible Config version: 0.0.1 schema: v1 models: - name: My Compatible Model provider: openai model: your-model-id apiBase: https://api.example.com/v1 apiKey: ${{ secrets.OPENAI_API_KEY }} roles: - chat - edit - apply

其中，provider: openai 告诉 Continue 按 OpenAI 类型处理该模型；model 必须与接口实际识别的模型 ID 一致；apiBase 应填写服务商要求的基础路径，是否包含 /v1 不能凭猜测，必须按照接口文档确认；roles 则决定该模型可以被用于聊天、编辑或应用代码修改等任务。

如果服务端只提供旧式 Completions 接口，而不是 Chat Completions，可以尝试增加 useLegacyCompletionsEndpoint: true。不过，这个设置只有在服务端确实要求旧接口时才使用。Continue 官方文档同时说明，对于部分较新的模型，Continue 可能默认使用 Responses API；如果接口不支持该 API，可以根据官方配置说明设置 useResponsesApi: false，改用 Chat Completions。

具体设置步骤：从 API 地址到 Continue 生效

1. 创建配置文件：在 Continue 全局目录中创建或编辑 config.yaml。如果已有旧的 config.json，优先参考 Continue 的 YAML 配置格式迁移，避免同时维护两套互相冲突的配置。
2. 填写接口基础地址：将 apiBase 改成服务商提供的 OpenAI Compatible API 地址。不要把完整的 /chat/completions 路径直接当作 apiBase，除非该服务商文档明确要求这样填写。
3. 填写模型 ID：把 model 改成服务端认可的精确字符串。名称大小写、连字符、版本后缀都可能影响识别。
4. 配置密钥：在 .env 中写入 OPENAI_API_KEY=你的密钥，并在 YAML 中使用 ${{ secrets.OPENAI_API_KEY }}。同时把 .env 加入 .gitignore。
5. 保存并重新加载：在 Continue 扩展的配置选择器中执行 Reload config，或重启编辑器。官方模型配置说明将重新加载配置列为模型设置后的必要步骤之一。
6. 先做简单对话测试：先使用短问题测试模型是否能返回文本，再测试代码解释、代码编辑和 Agent 工具调用。不要一开始就用大型项目或复杂任务判断接口是否可用。
7. 按角色测试：如果聊天正常但自动补全或 Agent 不工作，检查 roles、模型能力和服务端是否支持相应接口。不同模型的工具调用、图片输入和流式输出支持可能并不相同。

如果使用 Continue CLI，可以通过默认的 ~/.continue/config.yaml 读取配置，也可以使用 cn --config ./my-config.yaml 指定一个配置文件。Continue CLI 的配置加载方式可参考 官方 CLI 配置文档。

常见报错与排查方法

如果接口是自签名证书或企业内部 CA，Continue FAQ 提到可以为请求配置 CA 证书路径。此类问题通常表现为 TLS、证书链或连接安全错误，而不是普通的 API Key 错误。

安全与兼容性注意事项

• 不要硬编码真实 Key：示例、提交记录和屏幕截图中只保留占位符，真实密钥放在 .env 或 Continue 支持的 secrets 引用中。
• 不要默认所有 OpenAI Compatible API 都完全兼容：兼容通常只覆盖部分请求格式，模型上下文长度、工具调用、视觉输入、流式传输和错误格式仍可能不同。
• 先确认 Base URL 规则：有些服务要求 https://example.com/v1，有些网关可能要求其他路径。地址应以服务商公开文档为准，不能通过猜测拼接。
• 谨慎启用能力声明：Continue 支持通过 capabilities 添加 tool_use 或 image_input，但声明能力不等于服务端真的支持。配置错误可能导致请求发送成功但任务执行失败。
• 保存最小配置：先只配置一个模型和 chat、edit 角色，确认基础调用正常后，再增加自动补全、Agent、MCP 或其他模型。

如果你需要连接多个模型，可以在同一个 models 列表中添加多个配置，并为每个模型设置不同的 name、model 和 apiBase。Continue 官方文档支持在同一配置中使用多个模型提供方。

结论：Continue 接入 OpenAI Compatible API 的最短路径

最短路径是：创建 ~/.continue/config.yaml，使用 provider: openai，填写准确的 model 和 apiBase，通过 ${{ secrets.OPENAI_API_KEY }} 读取密钥，重新加载 Continue，再先测试普通聊天。出现问题时，优先按“密钥—Base URL—模型 ID—接口能力—IDE 配置加载顺序”排查。

如果你还没有确定使用哪种 API 接入方式，可以先把服务商文档中的 Base URL、模型 ID、认证方式和接口类型整理出来，再套用本文配置。无法从公开资料确认的字段，不要自行补全，应以对应服务商的官方文档为准。

参考资料

本文主要依据 Continue 官方资料整理：OpenAI 与 OpenAI Compatible 配置说明、config.yaml Reference、FAQ：密钥、环境变量与证书问题、CLI 配置说明。

常见问题

Continue 的 OpenAI Compatible API 应该填写哪个 provider？

通常填写 provider: openai。Continue 官方文档对 OpenAI API 兼容服务的示例也是使用 openai 提供方，再通过 apiBase 指向实际接口。

apiBase 应该写到 /v1 还是 /chat/completions？

应以接口服务商官方文档为准。一般 apiBase 写基础地址，例如包含 /v1 的路径，不要直接猜测或把完整请求路径重复拼接。

为什么在终端设置 OPENAI_API_KEY，Continue 插件仍然提示未授权？

Continue 官方 FAQ 说明，VS Code 和 JetBrains 扩展不能直接读取终端中的 shell 环境变量。请在工作区、工作区 Continue 目录或全局 Continue 目录中创建 .env，然后重新加载配置或重启 IDE。

Continue 能调用所有 OpenAI Compatible API 吗？

不能保证。接口还需要满足 Continue 当前使用的请求格式和模型能力要求。聊天、代码编辑、工具调用、图片输入和流式输出可能分别存在兼容性差异。

配置后出现 404，应该先检查什么？

先检查 apiBase 是否多写或少写了路径，再检查 model 是否为服务端真实模型 ID，最后确认服务端是否确实提供 Continue 所需的接口路径。

相关阅读

• 查看 AI API 接入与模型调用指南
• 参考 AI 编程工具报错排查思路
• 浏览更多 AI API 与工具更新

参考资料

1. Continue 官方：如何配置 OpenAI 与 OpenAI Compatible 模型
2. Continue 官方：config.yaml 配置参考
3. Continue 官方 FAQ：密钥、环境变量与证书配置
4. Continue 官方 CLI 配置说明