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

OfoxAI

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

公告

View Post

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

最常见。原因有三个:

  1. apiKey 拼错了(多了空格/换行)
  2. apiBase 末尾没带 /v1 或者多了 /
  3. 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,希望这篇能帮你少踩点坑。

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

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