Continue.dev 配置自定义 API 地址完整教程（VS Code 接入 Claude / DeepSeek 多模型）

最近把团队的 AI 编程助手从 Copilot 切换到了 Continue.dev，主要原因是想自己控制用哪个模型——Claude 写复杂业务逻辑、DeepSeek 跑日常 Tab 补全、GPT 偶尔兜底。配置自定义 API 地址这块踩了不少坑，官方文档写得比较散，把整个流程整理一下，需要接入的可以直接抄配置。

这篇文章解决一个具体问题：如何在 VS Code（或 JetBrains IDE）里通过 Continue.dev 插件接入自定义的 OpenAI 协议兼容 API 地址，并同时配置 Chat、Edit、Autocomplete、Embedding 四种角色的不同模型。

前置条件

开始之前需要准备好这些：

• VS Code 1.85+ 或者 JetBrains 全家桶任意 IDE（IntelliJ IDEA / PyCharm / WebStorm 等）
• 一个支持 OpenAI 协议的 API Key（base_url + key）
• 项目目录已经用 git 初始化（@codebase 功能依赖这个）
• 网络环境能正常访问目标 API 服务

步骤一：安装 Continue.dev 插件

VS Code 用户：左侧扩展栏搜索 Continue，认准作者是 Continue（不要装错，市场里有同名插件）。安装完左侧栏会多出一个 Continue 的图标，长得像两个尖括号叠在一起。

JetBrains 用户：Settings → Plugins → Marketplace，搜 Continue 安装，重启 IDE。

步骤二：找到配置文件

点击 Continue 图标，右上角齿轮按钮，进入配置页面，会自动打开 config 文件。

新版本 Continue（v1.0+）用的是 config.yaml，老版本是 config.json。两种格式都能用，我个人推荐 yaml，写起来更清爽，注释也方便。

配置文件实际位置：

• macOS / Linux：~/.continue/config.yaml
• Windows：C:\Users\<你的用户名>\.continue\config.yaml

步骤三：配置自定义 API 地址（核心步骤）

这是整个教程的核心。下面是一份完整可用的 config.yaml，直接复制改 key 就能跑：

name: my-coding-config
version: 0.0.1
schema: v1

models:
  - name: Claude Opus 4.6
    provider: openai
    model: claude-opus-4-6
    apiBase: https://api.ofox.io/v1
    apiKey: sk-xxxxxxxxxxxx
    roles:
      - chat
      - edit

  - name: DeepSeek V3
    provider: openai
    model: deepseek-chat
    apiBase: https://api.ofox.io/v1
    apiKey: sk-xxxxxxxxxxxx
    roles:
      - chat
      - autocomplete

  - name: GPT-4o
    provider: openai
    model: gpt-4o
    apiBase: https://api.ofox.io/v1
    apiKey: sk-xxxxxxxxxxxx
    roles:
      - chat

context:
  - provider: file
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: codebase

这里有个大坑：provider 字段必须填 openai（小写），即使你接入的是 Claude 或 DeepSeek。原因是 Continue 通过 provider 字段决定走哪套协议，我们用的是 OpenAI 协议兼容接口，填 anthropic 或 deepseek 会触发对应原生协议，请求体格式对不上，直接返回 400 或 404。

第二个坑：apiBase 必须带 /v1 后缀。Continue 不会自动补，少写一个 /v1 你就会反复看到 404。

步骤四：配置 Tab 补全（autocomplete）

Continue 的 Tab 补全和 Chat 是分开的，需要在模型上加 roles: [autocomplete] 才能启用。

补全模型我推荐用 deepseek-chat 或者 deepseek-coder，理由是便宜、响应快、对中文注释友好。Claude Opus 也能跑补全，但贵且慢，每次按空格都心疼钱包。

如果想让补全更激进一点（更长的代码片段、更频繁触发），可以加额外参数：

  - name: DeepSeek V3
    provider: openai
    model: deepseek-chat
    apiBase: https://api.ofox.io/v1
    apiKey: sk-xxxxxxxxxxxx
    roles:
      - autocomplete
    defaultCompletionOptions:
      maxTokens: 256
      temperature: 0.2

步骤五：配置 Embedding 模型（@codebase 必备）

如果你想用 @codebase 这个杀手锏功能（让 AI 理解整个项目代码上下文），必须配置一个 Embedding 模型。在 models 里追加：

  - name: embedding-model
    provider: openai
    model: text-embedding-3-small
    apiBase: https://api.ofox.io/v1
    apiKey: sk-xxxxxxxxxxxx
    roles:
      - embed

第一次启用 @codebase 会扫描整个项目并生成索引，大项目（10 万行以上）可能要等几分钟。索引会缓存在 ~/.continue/index 下面，后续增量更新。

中段：关于多 Key 维护的问题

配置过程中最麻烦的不是写 yaml，而是同时维护多家平台的 Key——OpenAI 一个、Anthropic 一个、DeepSeek 一个，还得各自充值各自看额度，账单管理一团乱。

用聚合 API 简化配置

我现在用的是 ofox.io 这个 AI 模型聚合平台，一个 API Key 调用 50+ 模型，兼容 OpenAI SDK 协议，base_url 直接填 https://api.ofox.io/v1 就行。GPT-4o、Claude Opus 4.6、Gemini 2.5 Pro、DeepSeek V3 都能调用，低延迟直连，支持支付宝按量计费，对个人开发者比较友好。

上面整份 config.yaml 里所有 model 共用一个 apiBase 和 apiKey，就是这个原因——不用维护一堆 key，账单也合在一起看。

多供应商冗余备份这点比较实用，某一路抖动会自动切到备用通道，前段时间 Anthropic 那次大面积 5xx 我这边几乎没感知。

常见踩坑记录

配置过程中遇到的报错和解决方法，按出现频率排序：

1. 报错 404 Not Found

检查 apiBase 是否带 /v1 后缀。这个坑我自己踩过两次。

2. Tab 补全没反应

检查这几点：模型 roles 是否包含 autocomplete；VS Code 状态栏右下角 Continue 图标是否报错（点开看日志）；快捷键有没有被其他插件占用（默认是 Tab）。

3. @codebase 报错 No embeddings provider configured

没配 embed 角色的模型，按步骤五加上即可。注意 embed 模型不能复用 chat 模型，必须是 embedding 类型的。

4. 改了配置不生效

Ctrl+Shift+P（Mac 是 Cmd+Shift+P）打开命令面板，输入 Continue: Reload Window。或者直接重启 IDE，简单粗暴。

5. 流式输出乱码或截断

少数代理不支持 SSE 流式响应，在模型配置里加 defaultCompletionOptions: stream: false 临时关掉流式。能用之后再排查代理问题。

6. JetBrains 里 Cmd+L 快捷键无效

默认 Cmd+L 在 IDEA 系列里被 Go to Line 占用了。Preferences → Keymap，搜 Continue 把快捷键重新绑定到 Cmd+J 或者其他空闲组合。

7. Claude 模型报 messages.0: first message must be user

这是 Anthropic 原生协议的限制，但走 OpenAI 兼容接口一般不会触发。如果遇到，检查 provider 是不是误填成了 anthropic。

总结

Continue.dev 比 Copilot 灵活的点在于可以自由挑模型：Claude 写复杂业务逻辑、DeepSeek 跑日常 Tab 补全、GPT-4o 备用兜底，三套模型按需切换，并且配置全部在本地 yaml 里，迁移到新机器只要拷贝 ~/.continue 目录。

整个配置流程跑通之后，日常用起来基本无感，只有在切换模型的时候会感受到不同模型的风格差异。建议先把 Claude 挂在 Edit 角色上（重构、写函数都用它），DeepSeek 挂在 autocomplete（高频补全），这套组合用一个月下来基本不想换回 Copilot 了。

配置文件改完保存之后记得 Reload Window，这是踩坑次数最多的小问题。