VS Code Continue 插件配置自定义 API:DeepSeek 官方 / Claude 兼容端点 / 本地 Ollama 一套讲完

Continue 是 VS Code 里开源免费的 AI 编程助手,聊天、选中代码改、Tab 自动补全都有。它跟 Cursor、Copilot 最大的区别是不绑死任何一家厂商:只要对方提供 OpenAI 兼容 API(或 Anthropic 协议),往配置文件里填四个字段就能用。这篇把 DeepSeek 官方、Claude 兼容端点、本地 Ollama 三种最常见接法一次讲完,附排错表和检查清单。

配置文件在哪、改哪份

配置文件在 Continue 的全局目录:

  • Windows:%USERPROFILE%\.continue\
  • macOS / Linux:~/.continue/

打开方式二选一:命令面板(Ctrl+Shift+P)输入 Continue: Open Config;或者点开 Continue 侧边栏聊天框,右上角模型选择旁的小齿轮进 Local Config。

格式有个时间点要提醒:老教程几乎全是 config.json,而官方现已主推 config.yaml——目录里同时存在两份时,优先加载的是 yaml。先确认自己插件版本再抄配置,别把三年前的 json 原样贴进新版。

不管哪种格式,核心字段就四个:

字段含义常见错误
provider协议适配器,接 OpenAI 兼容就写 openai抄成厂商名如 deepseek
apiBase服务地址,决定请求发到哪带了完整接口路径或尾斜杠
model平台侧的模型名,必须一字不差旧名/别名,404
apiKey密钥空、错、带隐藏空格

场景一:DeepSeek 官方 API

先核实模型名。DeepSeek 官方平台目前的现役模型是 deepseek-v4-flash(快速、便宜)和 deepseek-v4-pro(强推理);老的 deepseek-chat / deepseek-reasoner 官方已公告于 2026-07-24 弃用,很多老教程还让你填这俩,照抄可能直接 404。配置前打开平台控制台的模型列表核对一下最稳。

apiBasehttps://api.deepseek.comhttps://api.deepseek.com/v1 都行——官方明确 /v1 只是 OpenAI 兼容别名,跟模型版本没关系。习惯上写 /v1 不容易出错。

新版 yaml 配置(对话 + 补全两个角色):

name: my-config
version: 0.0.1
schema: v1

models:
  - name: DeepSeek V4 Flash
    provider: openai
    model: deepseek-v4-flash
    apiBase: https://api.deepseek.com/v1
    apiKey: YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply
  - name: DeepSeek 补全
    provider: openai
    model: deepseek-v4-flash
    apiBase: https://api.deepseek.com/v1
    apiKey: YOUR_API_KEY
    roles:
      - autocomplete

还在用老版本 json 的话,对应写法是 models 数组 + tabAutocompleteModel

{
  "models": [
    {
      "title": "DeepSeek",
      "provider": "openai",
      "model": "deepseek-v4-flash",
      "apiBase": "https://api.deepseek.com/v1",
      "apiKey": "YOUR_API_KEY"
    }
  ],
  "tabAutocompleteModel": {
    "provider": "openai",
    "model": "deepseek-v4-flash",
    "apiBase": "https://api.deepseek.com/v1",
    "apiKey": "YOUR_API_KEY"
  }
}

场景二:Claude 兼容端点

接 Claude 兼容端点之前先确认一件事:它给的是 OpenAI 兼容地址,还是 Anthropic 原生协议地址? 这决定 provider 写什么。

  • 只提供 OpenAI 兼容 /v1 接口(自建接入层大多是这种)→ provider: openai
  • 原生 Anthropic Messages 协议 → provider: anthropic,同样能用 apiBase 指到接入地址。
models:
  - name: Claude 兼容
    provider: anthropic        # 若只给 OpenAI 兼容接口,改成 openai
    model: YOUR_MODEL          # 以接入服务给的模型名为准
    apiBase: YOUR_BASE_URL     # 写到版本根为止,别带 /messages 或 /chat/completions
    apiKey: YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply

接入 Claude 时最大的坑是模型名。Claude 官方模型串又长又带日期(claude-sonnet-4-20250514 之类),而接入服务经常做映射,给你的是 claude-sonnet-4 甚至自定义别名。别照抄 Anthropic 官网的模型串,去接入服务文档或接口列表里拿它实际接受的名称。

场景三:本地 Ollama

先保证服务和模型就绪,再谈配置:

ollama serve          # 默认监听 http://localhost:11434
ollama pull qwen2.5-coder:7b
ollama list           # model 字段必须与这里输出的名字完全一致
models:
  - name: 本地 Qwen
    provider: ollama
    model: YOUR_MODEL          # 完整名字含 :tag,如 qwen2.5-coder:7b
    apiBase: http://localhost:11434
    roles:
      - chat
      - edit
      - autocomplete

几个实用点:

  • 想免配置自动探测本机模型,modelAUTODETECT
  • Ollama 跑在别的机器上,apiBase 改成 http://那台机器IP:11434,且那台机器要以 OLLAMA_HOST=0.0.0.0:11434 启动、防火墙放行 11434 端口;
  • model 不带 :tag 或拼错,报 404 model "xxx" not found, try pulling it first
  • agent 模式提示 not supported,说明模型不支持工具调用,换支持 tool_use 的模型,或在该模型下补 capabilities: [tool_use]

常见坑汇总

apiBase 填成完整路径。https://YOUR_BASE_URL/v1 即可,Continue 会自己拼 chat/completions。把完整接口路径或尾斜杠填进去,轻则 404,重则请求路径变成双斜杠。写完后浏览器直接访问一次 apiBase 验证地址本身通不通。

provider 写成厂商名。 OpenAI 兼容协议统一用 openai,没有 deepseekqwen 这种 provider 名(新版本里从 Hub 引用预置模型块是另一套 uses: 语法,别混)。

模型名对不上。 404 model not found 时按顺序核对三处:Ollama 的 ollama list 输出、平台控制台的模型列表、接入服务给的模型名表。

401 Unauthorized。 apiKey 空、错、复制时带了空格,最常见。少数接入服务鉴权头不叫 Authorization: Bearer,需要在模型配置的 requestOptions.headers 里自定义。

内网接入层证书报错。 自建接入层用自签名证书时,模型配置下加 requestOptions.verifySsl: false(仅内网调试)或 requestOptions.caBundlePath: C:/certs/company-ca.pem 指向公司根证书,思路跟命令行调 API 的证书排查完全一致。

改完配置没反应。 YAML 缩进错了整份配置会加载失败;保存后没生效就执行命令面板的 Developer: Reload Window 重载一次。

密钥进 Git。 项目里会生成 .continue/ 配置,别把含真实 key 的文件提交进仓库;新版支持用 ${{ secrets.XXX }} 引用密钥,或直接留空走环境变量。

快速排错表

现象原因处理
401 UnauthorizedapiKey 缺失/错误/带空格重新复制 key;必要时用 requestOptions.headers 自定义鉴权头
404 model not found模型名与平台不一致对照 ollama list / 控制台 / 接入服务文档核对完整模型串
Failed to fetch / ECONNREFUSEDapiBase 拼错,或服务没起浏览器直接访问 apiBase 验证;Ollama 先 ollama serve
请求发出但秒回 404apiBase 带了接口尾路径只留到版本根:https://YOUR_BASE_URL/v1
保存配置后模型列表没变化YAML 缩进错或未重载看 Continue 面板报错;执行 Reload Window
聊天正常,Tab 补全不触发补全模型角色没配yaml 加 roles: [autocomplete];json 用 tabAutocompleteModel
agent 模式提示不支持模型不支持工具调用换支持 tool_use 的模型,或补 capabilities: [tool_use]
内网接入层报证书错自签名 / 公司 CA 不受信requestOptions.verifySsl: false(调试)或 caBundlePath 指定 CA

配置检查清单

  • 改的是当前生效的那份配置(config.yaml 存在时优先于 config.json),路径在 ~/.continue(Windows 为 %USERPROFILE%\.continue
  • provideropenai(OpenAI 兼容)/ anthropic / ollama,没写厂商名
  • apiBase 只到版本根(如 /v1),无尾斜杠、无 /chat/completions
  • model 与平台侧完全一致,Ollama 场景以 ollama list 输出为准
  • apiKey 有值且无多余空格,真实 key 未提交进 Git
  • 保存配置后已执行 Reload Window
  • 内网 HTTPS 接入层已配置 verifySsl / caBundlePath
  • 需要 Tab 补全的模型已带 autocomplete 角色(或配置了 tabAutocompleteModel
Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐