VS Code Continue配置自定义API
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。配置前打开平台控制台的模型列表核对一下最稳。
apiBase 填 https://api.deepseek.com 或 https://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
几个实用点:
- 想免配置自动探测本机模型,
model填AUTODETECT; - 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,没有 deepseek、qwen 这种 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 Unauthorized | apiKey 缺失/错误/带空格 | 重新复制 key;必要时用 requestOptions.headers 自定义鉴权头 |
404 model not found | 模型名与平台不一致 | 对照 ollama list / 控制台 / 接入服务文档核对完整模型串 |
Failed to fetch / ECONNREFUSED | apiBase 拼错,或服务没起 | 浏览器直接访问 apiBase 验证;Ollama 先 ollama serve |
| 请求发出但秒回 404 | apiBase 带了接口尾路径 | 只留到版本根: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) -
provider是openai(OpenAI 兼容)/anthropic/ollama,没写厂商名 -
apiBase只到版本根(如/v1),无尾斜杠、无/chat/completions -
model与平台侧完全一致,Ollama 场景以ollama list输出为准 -
apiKey有值且无多余空格,真实 key 未提交进 Git - 保存配置后已执行 Reload Window
- 内网 HTTPS 接入层已配置
verifySsl/caBundlePath - 需要 Tab 补全的模型已带
autocomplete角色(或配置了tabAutocompleteModel)
更多推荐

所有评论(0)