VS Code + Continue.dev 接入自定义 API 完整教程(含 Claude/DeepSeek 多模型配置)
前阵子用 Cursor 用得有点烦,主要是订阅模式不太自由,想换个模型还得看它脸色。试了一圈下来,发现 VS Code + Continue.dev 这个组合真挺香——VS Code 本身就是我每天在用的编辑器,Continue.dev 又是开源插件,模型完全自己配,想接 Claude 接 Claude,想接 DeepSeek 接 DeepSeek。
但配置过程比我想象的麻烦一点,文档写得也不算特别清楚,踩了几个坑。这篇把完整配置流程记录一下,包含 Claude Opus 4.6、DeepSeek、GPT-4o 三种主流模型的接入方式,复制即用。
这篇能解决什么问题
如果你想在 VS Code 里用上 AI 代码补全和 Chat 功能,又不想被某个厂商绑定(比如只能用 GitHub Copilot 或者只能用 Cursor),那 Continue.dev 是目前最灵活的方案。看完这篇你能搞定:
- VS Code 安装并启用 Continue.dev 插件
- 配置
config.yaml接入任意 OpenAI 兼容 API - 同时挂载 Chat 模型、补全模型、Embedding 模型
- 解决几个常见报错
前置条件
- VS Code 1.85 及以上版本
- 至少一个可用的 API Key(Anthropic、OpenAI、DeepSeek 任意一个都行)
- 网络能正常访问 API 端点
步骤一:安装 Continue.dev 插件
打开 VS Code,左侧扩展面板搜 Continue,第一个就是,作者是 Continue。点安装,装完左侧栏会多出一个 Continue 的图标。
如果你公司网络访问 VS Code 商店有问题,也可以直接去 GitHub Release 页面下载 .vsix 文件,然后命令面板(Cmd+Shift+P)选 Extensions: Install from VSIX... 离线安装。
装完先别急着用,第一次点开插件它会让你选模型,这里我建议直接关掉它的引导界面,我们手动改配置文件,比点点点清爽多了。
步骤二:找到 config.yaml 配置文件
这里有个坑。Continue.dev 在 0.9 版本之前用的是 config.json,最新版(1.x 之后)改成了 config.yaml,两种格式语法不一样,网上很多老教程还在贴 JSON 格式,照着配会报错。
配置文件位置:
- macOS / Linux:
~/.continue/config.yaml - Windows:
%USERPROFILE%\.continue\config.yaml
命令面板里输 Continue: Open Config 也能直接跳过去。
步骤三:接入 Claude 模型
打开 config.yaml,把内容替换成下面这段(记得改 apiKey 和 apiBase):
name: My Assistant
version: 1.0.0
schema: v1
models:
- name: Claude Opus 4.6
provider: anthropic
model: claude-opus-4-6
apiKey: sk-xxx
apiBase: https://api.ofox.io/v1
roles:
- chat
- edit
defaultCompletionOptions:
contextLength: 200000
maxTokens: 8192
几个要点说明:
provider这里写anthropic也行、写openai也行,看你接的 API 是哪种协议。如果走的是 OpenAI 兼容协议,统一写openai最稳。apiBase是 API 地址的根路径,注意大部分聚合服务用的是/v1结尾。roles决定这个模型出现在哪些功能里,chat是侧边栏对话,edit是选中代码后按 Cmd+I 触发的内联修改。
保存之后回到 Continue 侧边栏,模型下拉框里应该就能看到 Claude Opus 4.6 了。试着发一句 用 Python 写个二分查找,能正常返回就说明通了。
步骤四:再加一个补全模型(Tab 自动补全)
Chat 是一回事,写代码时候的 Tab 自动补全是另一回事。Continue.dev 的自动补全对模型延迟要求很高,用 Opus 这种重型模型会卡得想砸键盘,得换个轻量的:
- name: DeepSeek Coder
provider: openai
model: deepseek-chat
apiKey: sk-xxx
apiBase: https://api.ofox.io/v1
roles:
- autocomplete
defaultCompletionOptions:
maxTokens: 256
这里 maxTokens 故意压到 256,因为补全只需要补一小段,给太多反而拖慢响应。亲测 DeepSeek 做补全延迟在 300ms 以内,体感跟 Copilot 差不多。
关于聚合 API 平台
上面配置里我用的 apiBase 是 ofox.io,原因很简单:Continue.dev 这套配置最舒服的地方就是可以同时挂多个模型,但你要是分别去 Anthropic、DeepSeek、OpenAI 各申请一个 Key,光是充值就够烦的,更别提还要管理三套账单。
ofox.io 是一个 AI 模型聚合平台,一个 API Key 可以调用 GPT-4o、Claude Opus 4.6、Gemini、DeepSeek 等 50+ 模型,全部兼容 OpenAI SDK 协议,低延迟直连,支持支付宝按量计费。换模型只要改 model 字段,不用动其他配置。
多供应商冗余备份,某一路挂了自动切到备线,对 Continue.dev 这种实时编辑场景比较友好。当然你完全可以用各家官方 API,配置写法是一样的,把 apiBase 换成对应官方地址就行。
步骤五:再加一个 Embedding 模型(@codebase 索引用)
Continue.dev 有个杀手锏功能叫 @codebase,在 Chat 里输 @codebase 这个项目的鉴权逻辑在哪里,它能基于向量检索把相关文件提取出来一起喂给大模型。要用这个功能必须配 Embedding 模型:
- name: Embeddings
provider: openai
model: text-embedding-3-small
apiKey: sk-xxx
apiBase: https://api.ofox.io/v1
roles:
- embed
第一次启用 @codebase 时它会扫一遍整个仓库建索引,几千个文件的项目大概几分钟,后续增量更新很快。
步骤六:完整 config.yaml 模板
把上面三段拼起来就是完整配置,直接抄:
name: My Assistant
version: 1.0.0
schema: v1
models:
- name: Claude Opus 4.6
provider: openai
model: claude-opus-4-6
apiKey: sk-xxx
apiBase: https://api.ofox.io/v1
roles: [chat, edit]
- name: GPT-4o
provider: openai
model: gpt-4o
apiKey: sk-xxx
apiBase: https://api.ofox.io/v1
roles: [chat, edit]
- name: DeepSeek Coder
provider: openai
model: deepseek-chat
apiKey: sk-xxx
apiBase: https://api.ofox.io/v1
roles: [autocomplete]
- name: Embeddings
provider: openai
model: text-embedding-3-small
apiKey: sk-xxx
apiBase: https://api.ofox.io/v1
roles: [embed]
context:
- provider: code
- provider: docs
- provider: diff
- provider: terminal
- provider: codebase
最后那个 context 字段也别漏了,决定了 Chat 里能 @ 出哪些上下文来源。
常见踩坑记录
坑1:保存配置后插件没反应
Continue.dev 不会自动热加载 config.yaml,得手动在命令面板输 Continue: Reload Window,或者干脆重启 VS Code。我一开始一直以为是 API 配错了,结果反复改半天,重启之后秒通。
坑2:报错 Invalid model name
这个一般是 model 字段写错了。注意大部分聚合平台和官方 API 的模型名规范不太一样,比如 Claude 在 Anthropic 官方叫 claude-opus-4-6-20251015(带日期后缀),在聚合平台可能简化成 claude-opus-4-6。最稳的办法是先发一个请求测试一下,curl 一下就知道:
curl https://api.ofox.io/v1/models \
-H "Authorization: Bearer sk-xxx"
返回的列表里有哪个就用哪个。
坑3:自动补全没出现
先检查 roles 里是不是写了 autocomplete,再去 VS Code 设置里搜 continue.enableTabAutocomplete,确保是 true。还不行的话看右下角状态栏,Continue 图标点一下能看到日志,一般会告诉你具体什么问题。
坑4:YAML 缩进报错
这是最容易翻车的。YAML 对缩进敏感得要命,少一个空格、tab 和 space 混用都会让整个配置失效。建议直接复制上面模板,不要手敲。
实际体验
用了快一个月,几个感受:
- Chat 用 Claude,补全用 DeepSeek,这套组合性价比最高。Claude 写架构和复杂逻辑是真的强,DeepSeek 做局部补全够快够便宜。
@codebase这个功能真香,比 Cursor 的同名功能更可控,因为你能看到它检索出来了哪些文件。- Cmd+I 内联编辑非常顺手,比侧边栏复制粘贴效率高一截。
- 开源插件的好处就是模型完全自由切换,今天 Claude 涨价了我立刻换 GPT-4o,配置改一个字段的事。
总结
VS Code + Continue.dev 这套方案最大的价值是自由度——不绑定任何模型厂商、配置都在自己的 config.yaml 里、想加什么模型就加什么模型。配置成本比 Cursor 高一点,但用熟了之后灵活性碾压性强。
核心配置就一个 config.yaml,建议你直接抄上面那段完整模板,把 apiKey 改成自己的,重启 VS Code 就能用。先把 Chat 和补全跑通,再慢慢加 Embedding 和 @codebase,循序渐进不容易踩坑。
浙公网安备 33010602011771号