更新于

Continue.dev 国内 API 配置完整教程

Continue.devVSCodeJetBrainsAPI 中转配置教程

Continue.dev 是 VSCode/JetBrains 上少数完全开源、支持自定义模型的 AI 编程助手。它的核心价值是「config.yaml 全配置」——所有行为都在一个文件里，团队协作可以直接 commit 进 repo。本文给国内使用的完整接入流程。

一、安装

VSCode：搜索 “Continue” 安装。 JetBrains：Settings → Plugins 搜 “Continue”。

第一次启动会引导你做配置。不要走默认 Anthropic 登录，直接跳过到手动配置。

二、配置文件路径

  • macOS / Linux: ~/.continue/config.yaml
  • Windows: %USERPROFILE%\.continue\config.yaml

老版本是 config.json，新版本统一用 yaml。下面示例都用 yaml。

三、最小配置

name: my-config
version: 0.0.1
schema: v1

models:
  - name: Sonnet 4.6
    provider: openai
    model: claude-sonnet-4-6
    apiBase: https://yotradeapi.com/v1
    apiKey: sk-yo-...
    roles: [chat, edit, apply]

  - name: Haiku 4.5
    provider: openai
    model: claude-haiku-4-5
    apiBase: https://yotradeapi.com/v1
    apiKey: sk-yo-...
    roles: [autocomplete, summarize]

context:
  - provider: file
  - provider: code
  - provider: diff
  - provider: open
  - provider: terminal
  - provider: tree

保存后 VSCode 侧栏 Continue 会自动加载。

四、按角色分模型（roles）

Continue 的 roles 让一个模型只承担特定职责。常见角色：

Role用途推荐模型
chat对话Sonnet 4.6
edit内联编辑（选中代码改）Sonnet 4.6
apply应用 diffHaiku 4.5
autocompleteTab 自动补全Haiku 4.5
summarize上下文摘要Haiku 4.5
embedembeddingtext-embedding-3-large
rerank检索重排rerank model

按角色分能让最贵的模型只处理最难的任务。

五、上下文 Provider 详解

Continue 把上下文做成 plugin 化：

Provider触发方式作用
@file@filename加单文件
@code选中代码加片段
@diff@diffgit diff
@open@open所有打开的文件
@terminal@terminal最近终端输出
@tree@tree目录树
@docs@docs文档检索
@web@web联网搜索（需配置）
@codebase@codebase全代码库 RAG

@codebase 需要先建索引，长跑一次建索引（用 embedding 模型）。建好后能快速回答”这个项目里哪里实现了 X”。

六、JetBrains 注意点

JetBrains（IntelliJ / GoLand / PyCharm）配置同 VSCode，但有几点差异：

  • 快捷键不同：Cmd+L（VSCode）= Cmd+J（JetBrains 默认）
  • Edit 行为略不同：JetBrains 上下文窗口宽度限制更严
  • Terminal Provider 在 JetBrains 抓的是 Run 控制台

七、本地模型混搭

Continue 的特色是可以本地 + 云端混用：

models:
  - name: Local Code
    provider: ollama
    model: qwen2.5-coder:7b
    apiBase: http://localhost:11434
    roles: [autocomplete]  # 本地跑补全

  - name: Cloud Chat
    provider: openai
    model: claude-sonnet-4-6
    apiBase: https://yotradeapi.com/v1
    apiKey: sk-yo-...
    roles: [chat, edit]    # 云端跑复杂任务

补全这种高频低复杂度任务，本地小模型完全够用；复杂任务走云端大模型。

八、slash commands（自定义命令）

定义项目特定指令：

slashCommands:
  - name: review
    description: 代码评审
    prompt: |
      请评审选中代码，按以下维度：
      1. 正确性
      2. 性能
      3. 可读性
      4. 安全性
      为每个维度给出 1-10 分和具体建议。

  - name: test
    description: 生成单元测试
    prompt: |
      为选中函数生成完整 Jest 单元测试，覆盖：
      - 正常路径
      - 边界值
      - 异常输入

侧栏输入 /review 或 /test 即可触发。

九、Quick Actions（行内提示）

Continue 在每个函数上方默认显示 “Continue” 行内按钮。可以在配置里加自定义动作：

quickActions:
  - title: 加 docstring
    prompt: 给这个函数加完整 docstring，包含参数、返回值、异常。

  - title: 加日志
    prompt: 在关键步骤加 logger 日志，使用项目里现有的 logger 实例。

十、常见报错

报错原因
404 Unknown modelmodel 名拼错
apiBase must be defined写成 baseURL 而不是 apiBase
Autocomplete 没反应没给 autocomplete 角色配模型
@codebase 出错没配 embed 模型
中文乱码终端 / IDE 编码问题

十一、与 Cline / Cursor 的差异

维度Continue.devClineCursor
开源是是否
形态插件插件独立
配置yaml 文件设置 UI设置 UI
团队协作commit 配置各自配各自配
长任务 agent弱强强
自定义极强中中

如果你的诉求是「团队统一配置、能 commit 进 repo、配置驱动」，Continue.dev 是最自然的选择。如果是「单人长任务 agent」，Cline / Cursor 更顺。

十二、相关阅读

用一把 Key 同时配置 Continue.dev 的 chat / edit / autocomplete / embed？YoTradeApi 创建 API Key 后按上面 yaml 模板填即可。

相关阅读