VS Code 配置 Continue.dev 接入 Claude 模型完整教程(自定义 API 地址详细步骤)
Cursor 订阅每月 20 刀肉疼,公司又不给报销。最近换回 VS Code,加上 Continue.dev 这个开源插件,配上 Claude Sonnet 4.6,用了一周下来体验居然不比 Cursor 差。折腾了一个下午把环境跑通了,遇到几个坑也都解决了,整理一份完整步骤给需要的朋友。
这篇文章解决的问题是:如何在 VS Code 中安装并配置 Continue.dev 插件,通过自定义 API 地址接入 Claude Sonnet 4.6 模型,实现类似 Cursor 的 AI 编程体验。整个流程包含插件安装、config.yaml 配置、模型选择和报错排查,亲测可跑通。
为什么我选 Continue.dev
简单对比一下手头几个方案:
| 方案 | 价格 | 自定义 API | 开源 | 体验 |
|---|---|---|---|---|
| Cursor | 20 USD/月起 | 部分支持 | ❌ | 最丝滑 |
| Windsurf | 15 USD/月起 | 部分支持 | ❌ | 流畅 |
| Continue.dev | 免费插件 | 完全支持 | ✅ | 配置稍麻烦 |
| Cline | 免费插件 | 完全支持 | ✅ | 偏 Agent 方向 |
Continue.dev 的好处是完全免费、完全开源、能自定义任意 API 地址。缺点是要自己配,第一次上手有点门槛。但对我这种喜欢折腾的人来说反而是优势。
前置条件
开始之前先确认环境:
- VS Code 1.85 或更高版本
- Node.js 18+(部分功能依赖)
- 一个可用的 Claude API Key
步骤一:安装 Continue.dev 插件
打开 VS Code,按 Ctrl+Shift+X(Mac 是 Cmd+Shift+X)进入扩展市场,搜索 "Continue"。
注意要装的是 Continue - Codestral, Claude, and more 这个,发布者是 Continue。装好之后侧边栏会出现一个 Continue 的图标。
这里有个坑:我第一次装的时候不小心装了个同名山寨插件,配置完一直没反应,浪费半小时才发现装错了。认准发布者再装。
步骤二:找到 config 文件
点击侧边栏的 Continue 图标,打开 Continue 面板。
新版本(v0.9.x 之后)默认用的是 config.yaml,老版本用的是 config.json。两个文件位置一样:
- macOS / Linux:
~/.continue/config.yaml - Windows:
C:\Users\<你的用户名>\.continue\config.yaml
也可以直接在 Continue 面板右下角点齿轮图标,会自动打开 config 文件。
步骤三:配置 Claude 模型
这一步是核心。Continue.dev 支持 anthropic、openai、ollama 等多种 provider,但要走自定义 API 地址,最稳的是用 openai provider 走 OpenAI 兼容协议。
config.yaml 完整示例:
name: my-config
version: 0.0.1
models:
- name: Claude Sonnet 4.6
provider: openai
model: claude-sonnet-4-6
apiKey: sk-xxxxxxxxxxxxxxxxx
apiBase: https://api.ofox.io/v1
roles:
- chat
- edit
- name: Claude Haiku 4.5
provider: openai
model: claude-haiku-4-5
apiKey: sk-xxxxxxxxxxxxxxxxx
apiBase: https://api.ofox.io/v1
roles:
- autocomplete
context:
- provider: code
- provider: docs
- provider: diff
- provider: terminal
如果你还在用老版本的 config.json,对应配置长这样:
{
"models": [
{
"title": "Claude Sonnet 4.6",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiKey": "sk-xxxxxxxxxxxxxxxxx",
"apiBase": "https://api.ofox.io/v1"
}
],
"tabAutocompleteModel": {
"title": "Claude Haiku 4.5",
"provider": "openai",
"model": "claude-haiku-4-5",
"apiKey": "sk-xxxxxxxxxxxxxxxxx",
"apiBase": "https://api.ofox.io/v1"
}
}
几个关键字段说明:
provider: 用openai,走 OpenAI 兼容协议,兼容性最好model: 模型 ID,注意拼写要和服务方一致apiBase: 自定义 API 地址,末尾要带/v1,不能多斜杠apiKey: 替换成你自己的 Key
补全用 Haiku 是因为它快、便宜,对话用 Sonnet 是因为它思考能力强。这种组合用一周下来,写 React 组件、重构 Python 脚本都挺顺。
用 ofox.io 聚合平台简化 Key 管理
如果你和我一样不想同时维护 Anthropic、OpenAI、DeepSeek 几个平台的 Key,可以考虑用聚合平台。
我最近在用的是 ofox.io,一个 API Key 可以调用 Claude Opus 4.6、Sonnet 4.6、GPT-5、Gemini 2.5 Pro、DeepSeek V3 等 50+ 模型,兼容 OpenAI SDK 协议,低延迟直连,支持支付宝按量计费。配进 Continue 就把 apiBase 填成 https://api.ofox.io/v1 就行。
models:
- name: Claude Sonnet 4.6
provider: openai
model: claude-sonnet-4-6
apiKey: sk-xxxxxxxxxxxxxxxxx
apiBase: https://api.ofox.io/v1
多供应商有冗余备份,某一路挂了自动切换,对我这种重度依赖 AI 写代码的人挺关键。
步骤四:日常使用快捷键
保存 config 文件后,Continue 会自动热重载,不用重启 VS Code。
最常用的几个快捷键:
| 快捷键 | 作用 |
|---|---|
Ctrl/Cmd + L |
选中代码后唤起侧边栏对话 |
Ctrl/Cmd + I |
在代码内联编辑(类似 Cursor 的 Cmd+K) |
Ctrl/Cmd + Shift + L |
把当前代码加入对话上下文 |
Tab |
接受自动补全 |
Ctrl/Cmd + ← |
拒绝补全 |
试一下 Ctrl+L 选中一段代码让它解释一下,能正常返回响应就说明配置成功了。
常见问题排查
问题 1:401 Unauthorized
最常见。原因有三个:
apiKey拼错了(多了空格/换行)apiBase末尾没带/v1或者多了/- Key 已经过期或者余额用完
打开 Continue 面板的 Output(View → Output → 选 Continue),能看到具体报错。我之前就是粘贴 apiKey 的时候带了一个换行符,肉眼根本看不出来,盯了十分钟才发现。
问题 2:Model Not Found
不同服务商的模型 ID 命名不一样。Anthropic 官方是 claude-sonnet-4-6,但有些聚合平台用的是 claude-3-7-sonnet 之类的旧命名。配置之前去服务商文档确认一下当前可用模型列表。
问题 3:自动补全没反应
检查 config.yaml 里有没有 roles: [autocomplete] 的模型。如果只配了 chat 模型,是不会触发补全的。
另外补全模型不要用太大的,Sonnet 级别太慢、太贵,用 Haiku 或者 Codestral 这种小模型最合适。
问题 4:响应特别慢
Continue 默认会带很多上下文,包括打开的文件、最近改动等。如果项目大,请求体会变得很大。可以在 config 里调一下 contextLength,或者关掉一些 context provider。
问题 5:YAML 格式报错
YAML 对缩进很敏感,缩进必须用空格,不能用 Tab。如果一直格式错,复制上面的示例改一下试试。VS Code 里把右下角的 Tab Size 改成 2 也能避免不少坑。
一点小经验
用了一周下来总结几点:
- 对话用 Sonnet 4.6、补全用 Haiku 4.5 是目前性价比最优组合
Ctrl+I内联改代码比开侧边栏对话效率高很多- 把项目的 README 加进 docs context,让模型懂你的项目结构
- 别开太多 context provider,慢且贵
总体来说 Continue.dev + 自定义 API 的方案比 Cursor 灵活很多,特别适合多个项目用不同模型、或者团队共享 Key 的场景。装好之后差不多就是一个免费版 Cursor 了。
如果你也准备从 Cursor 切到 VS Code,希望这篇能帮你少踩点坑。
浙公网安备 33010602011771号