• 博客园logo
  • 会员
  • 周边
  • 新闻
  • 博问
  • 闪存
  • 赞助商
  • Chat2DB
    • 搜索
      所有博客
    • 搜索
      当前博客
  • 写随笔 我的博客 短消息 简洁模式
    用户头像
    我的博客 我的园子 账号设置 会员中心 简洁模式 ... 退出登录
    注册 登录

OfoxAI

  • 博客园
  • 联系
  • 订阅
  • 管理

公告

View Post

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,循序渐进不容易踩坑。

posted on 2026-05-26 10:11  失控的上下文  阅读(53)  评论(0)    收藏  举报

刷新页面返回顶部
 
博客园  ©  2004-2026
浙公网安备 33010602011771号 浙ICP备2021040463号-3