Continue.dev：VS Code 与 JetBrains 内可切换本地 / 云端模型的开源 AI 编程助手｜部署与使用全指南

项目仓库： https://github.com/continuedev/continue

开源协议：Apache 2.0（© 2023-2026 Continue Dev, Inc.） · 交付形态：VS Code 扩展、JetBrains 插件、命令行 cn · 模型接入：云端 API 与 Ollama 等本地模型均可配置 · 无独立 Web 服务端口 · 官方文档：docs.continue.dev

官方维护状态说明（务必先读）：仓库 README 明确标注，continuedev/continue 代码库已不再积极维护、对所有用户只读；官方完成了 VS Code 扩展、CLI、JetBrains 插件的最终 2.0.0 版本发布，版本中移除了匿名遥测、剥离了账号认证相关逻辑。本文命令与配置均依据该冻结版本的官方 README、仓库 docs/ 目录文档与官方站点整理；后续是否恢复维护、版本如何演进，以官方仓库与 docs.continue.dev 最新说明为准。

1 项目简介

Continue 是一款可以装进代码编辑器的开源编程 Agent，以 CLI、VS Code 扩展和 JetBrains 插件三种形态分发。它在编辑器侧边栏里提供对话（Chat）、代码片段修改（Edit）、行内补全（Autocomplete）和任务型 Agent 模式，支持接入云端大模型，也可以对接本机 Ollama 等本地模型；模型、规则、MCP 工具和上下文来源都通过配置文件声明。

非官方 / 商业产品边界声明：Continue 由 Continue Dev, Inc. 开发运营，平台化产品（Continue 账号、托管助手、组织能力）属于官方商业服务；本指南只覆盖开源仓库交付的扩展、插件与 CLI。文章中出现的 Anthropic、OpenAI、Google、Ollama 等名称仅用于说明兼容目标，相关模型与服务归各自厂商所有。使用者须自行确认 API 额度、隐私条款与适用法规。

1.1 核心信息一览

1.2 适用场景

• 在 VS Code / JetBrains 中边写代码边对话：解释当前文件、生成函数、按提示词改写片段，不想在多个应用之间切换。
• 需要行内代码补全与整文件级编辑，同时希望模型可以自由切换云端 API 或本机 Ollama 模型。
• 在脚本、CI/CD、Git 钩子等无终端交互环境里，用 cn -p 无头模式跑单轮代码任务。
• 希望把项目规范、自定义斜杠命令、MCP 外部工具和上下文来源沉淀到一份可版本化的本地配置里。

1.3 能力边界（官方口径）

• 官方 README 自述定位为 “pioneering open-source coding agent”，提供 Agent、Chat、Edit、Autocomplete 四类编辑器内交互；JetBrains 插件官方建议优先使用 Continue CLI 替代。
• 开源仓库已停止积极维护并转为只读，不再承诺新功能、缺陷修复与平台兼容性；2.0.0 最终版已移除匿名遥测、剥离认证模块。
• 项目本身不附带任何模型、API Key 或模型权重；需要自行准备 Continue 账号、Anthropic 等云端 API Key，或本机运行的 Ollama 模型。
• 工具执行、文件写入等动作是否需要人工批准，由当前形态的交互界面与配置决定；在无头 / 自动化场景中请按最小权限约束运行目录与命令。

2 功能特性

2.1 编辑器内四种交互形态

• Agent 模式：围绕开发任务分步推进，可以读取文件、调用工具、多轮迭代完成任务；每步工具请求在界面上展示并等待确认。
• Chat 对话：提出一般性问题、澄清代码片段，通过 @ 引用文件、目录、文档等上下文。
• Edit 编辑：不离开当前文件即可改写选中的代码段，直接生成差异。
• Autocomplete 补全：输入过程中给出行内建议，可通过配置指定独立的补全模型与触发参数。

2.2 多模型与本地模型接入

• 支持接入 Anthropic、OpenAI、xAI、Cohere、Gemini、AWS Bedrock、OpenAI 兼容接口等云端提供者；也可对接本机 Ollama 实例。
• 旧版 config.json 中 models 条目可配置 title、provider、model、apiKey、apiBase、contextLength、template、completionOptions、systemMessage、requestOptions 等字段；新版本以 config.yaml 为准，详见官方 config.yaml 参考。
• 补全模型由 tabAutocompleteModel 单独配置，默认思路是使用本地 Ollama 实例；嵌入模型由 embeddingsProvider 配置，供 @Codebase、@docs 等上下文使用。

2.3 规则、命令与 MCP 扩展

• 可以定义项目级规则、自定义斜杠命令与提示词块，让助手遵循团队编码规范与流程。
• 通过 MCP（Model Context Protocol）挂载数据库、浏览器、文档等外部工具；CLI 侧可用 --mcp <slug> 在启动时追加 MCP 服务。
• 上下文提供者、文档索引、代码库索引等能力按官方文档在配置中开启。

2.4 命令行 Agent（cn）

• 终端内交互 TUI：cn 启动多轮会话，@ 引用文件，工具调用按需批准。
• 无头模式：cn -p "提示词" 单轮跑完输出到标准输出，适合脚本、CI/CD、容器与无 TTY 环境；支持 --format json 结构化输出与 --silent 去除思考标签。
• 会话管理：自动保存终端会话历史，cn --resume 恢复最近一次会话，cn ls 列出最近会话并选择恢复。
• 状态命令：cn login / cn logout 处理账号认证，cn remote 启动远程实例，cn serve 启动 HTTP 服务模式，cn --version 查看版本。

3 官方界面预览

3.1 VS Code 侧边栏对话

下图为 VS Code 中 Continue 侧边栏与代码区联动的官方文档截图：左侧为对话面板，右侧为正在编写的 Python 类，对话内容与当前打开文件联动。

3.2 Agent 模式与工具权限

Agent 模式下助手会主动申请读取当前文件等工具权限，界面展示上下文条目与模型选择器，确认后才继续执行。

3.3 Continue Console 日志面板

VS Code 中可打开 Continue Console，查看每次补全 / 请求的类型、成功状态、提示词与生成 Token 数、耗时与速度等诊断信息。

4 官方跳转链接汇总

下表列出项目相关官方入口，均可直接点击访问。

5 前置要求与环境配置

5.1 软件前提

• VS Code 1.xx 或任意 JetBrains IDE：用于安装扩展 / 插件；JetBrains 官方建议优先使用 CLI。
• Node.js 20 或更高版本：仅在使用 npm 安装 CLI 路径时需要；shell 安装脚本会自带运行时，不强制要求 Node。
• 稳定的网络连接：云端模型请求需要访问对应模型服务商接口。
• 模型凭据二选一：Continue 账号，或 Anthropic 等云端 API Key；使用本地 Ollama 模型时无需云端 Key，但需要本机先跑起 Ollama 服务。
• Git：在真实代码仓库内工作体验最佳；查看与提交改动会依赖 Git。

5.2 本地模型环境建议（官方 Ollama 指南口径）

说明：上表硬件口径来自仓库 Ollama 指南；模型体积与实际内存占用随模型参数规模变化，重度使用请按所选模型预留更多内存与显存。

5.3 端口说明

6 方式一：编辑器扩展安装（推荐日常使用）

适用于在 VS Code 或 JetBrains IDE 中以侧边栏形式使用 Continue。

6.1 VS Code 扩展

1. 打开 Visual Studio Marketplace 的 Continue 页面，点击 Install；浏览器会唤起 VS Code，在扩展详情页再次点击 Install。
2. 安装完成后左侧边栏出现 Continue 图标；官方建议将其拖动到右侧边栏以获得更好的面板宽度。
3. 首次打开按引导选择登录 Continue 账号，或输入 Anthropic 等云端 API Key；接入本地模型则在配置中填写 Ollama 提供者与模型名。

6.2 JetBrains 插件

1. 在 JetBrains IDE 中打开 Settings（Ctrl + Alt + S），进入 Plugins。
2. 在 Marketplace 搜索 “Continue”，点击 Install；安装后右侧工具栏出现 Continue 图标。
3. 若遇问题，可在 Settings → Plugins 中加入官方 EAP 渠道 https://plugins.jetbrains.com/plugins/eap/list 获取预发布版本；历史版本可在 JetBrains Marketplace 插件页 下载后从磁盘安装。

官方提示：JetBrains 平台上更推荐直接使用 Continue CLI（见第 7 章），而不是 JetBrains 插件。

6.3 本地模型（Ollama）配合步骤

# 1. 安装并启动 Ollama（Linux 示例；macOS 可用 brew install ollama）
curl -fsSL https://ollama.ai/install.sh | sh
ollama serve
# 另开终端验证服务已运行
curl http://localhost:11434

# 2. 先 pull 模型，再启动会话（不要用 ollama run 下载模型）
ollama pull qwen2.5-coder:1.5b
ollama list

在 Continue 配置中新增 Ollama 提供者条目，指向本机 http://localhost:11434，选择已 pull 的模型标签即可；旧版 config.json 写法示例：

{
  "models": [
    { "title": "Ollama", "provider": "ollama", "model": "AUTODETECT" }
  ],
  "tabAutocompleteModel": {
    "title": "My Starcoder",
    "provider": "ollama",
    "model": "starcoder2:3b"
  }
}

新版配置以 ~/.continue/config.yaml 为准，字段映射参考官方 config.yaml 参考；上面的 JSON 示例用于对照旧版字段含义。

7 方式二：命令行 CLI 安装与本地运行

适用于终端结对编程、脚本自动化与 CI/CD 场景；源码开发则进入仓库 extensions/ 对应子目录，构建命令以仓库 CONTRIBUTING 与包内脚本最新说明为准。

7.1 一键脚本安装（macOS / Linux）

# 安装 Continue CLI（cn）
curl -fsSL https://raw.githubusercontent.com/continuedev/continue/main/extensions/cli/scripts/install.sh | bash

# 验证安装
cn --version

Windows PowerShell：

irm https://raw.githubusercontent.com/continuedev/continue/main/extensions/cli/scripts/install.ps1 | iex

7.2 npm 安装（需要 Node.js 20+）

npm i -g @continuedev/cli
cn --version

7.3 首次启动与认证

# 进入项目目录后启动交互式会话
cd your-project
cn

# 浏览器登录 Continue 账号
cn login

# 无头 / CI 环境使用 API Key 环境变量
export CONTINUE_API_KEY=your-key-here
cn -p "your prompt"

未使用 Continue 账号时，首次启动可选择直接输入 Anthropic API Key；无浏览器环境下通过 CONTINUE_API_KEY 环境变量提供凭据。

7.4 常用会话与无头命令

# 交互式 TUI 多轮会话
cn

# 无头模式：单轮任务并输出到 stdout
cn -p "Generate a conventional commit name for the current git changes."

# 管道输入
echo "Review this code" | cn -p

# 结构化 JSON 输出，供下游脚本处理
cn -p "Analyze the code" --format json

# 去除思考标签的静默模式
cn -p "Write a README" --silent

# 恢复上一次会话 / 列出最近会话
cn --resume
cn ls
cn ls --json

7.5 常用启动参数

完整参数以 cn --help 输出为准。

7.6 从源码运行（开发者）

git clone https://github.com/continuedev/continue.git
cd continue

# VS Code 扩展源码：extensions/vscode
# CLI 源码：extensions/cli
# JetBrains 插件源码：extensions/intellij
# 具体依赖安装、构建与调试命令以各子目录 README 与 CONTRIBUTING 最新说明为准

仓库已冻结只读，源码构建脚本与依赖版本不会再随上游演进；在新工具链上构建时如遇依赖冲突，请以本地锁定文件与官方仓库 Issues 历史记录为参考。

8 配置项说明

8.1 配置解析顺序（CLI 官方口径）

cn 按以下顺序解析模型、MCP、规则等配置：

1. 启动时 --config 标志指定的本地 YAML 文件；
2. 上一次使用后保存下来的配置；
3. 默认路径 ~/.continue/config.yaml。

TUI 会话内输入 /config 可在可用本地配置之间切换，选择会被保存到下次启动。

8.2 密钥与环境变量

• 敏感值（API Key、Token）应放在环境变量中，在配置文件里以 ${{ secrets.MY_API_KEY }} 形式引用，不要把密钥明文提交到 Git。
• CLI 相关环境变量：

8.3 模型条目常用字段（旧版 config.json 对照）

8.4 补全与嵌入配置

• tabAutocompleteModel：独立指定行内补全模型，格式与 models 条目相同；tabAutocompleteOptions 可设置 disable、maxPromptTokens（默认 1024）、debounceDelay（默认 350 ms）、maxSuffixPercentage（默认 0.2）、prefixPercentage（默认 0.3）、onlyMyCode（默认 true）等。
• embeddingsProvider：@Codebase、@docs 使用的嵌入模型，可选 transformers.js、ollama、openai、cohere、gemini 等。

配置格式已从 config.json 迁移到 config.yaml；旧 JSON 字段仅用于理解历史配置，新建配置请以官方 config.yaml 参考 为准。

9 常用运维命令

# ---- CLI 会话与进程 ----
cn                              # 启动交互式会话
cn -p "..."                     # 无头单轮任务
cn --resume                     # 恢复上次会话
cn ls                           # 列出最近会话
cn login / cn logout            # 登录 / 退出账号
cn serve                        # 启动 HTTP 服务模式
cn --version                    # 查看 CLI 版本
cn --help                       # 查看完整参数列表

# ---- 本地模型服务（Ollama）----
ollama serve                    # 启动本地推理服务
ollama list                     # 查看已下载模型
ollama pull <model:tag>         # 拉取模型

# ---- 配置与日志 ----
# IDE 配置目录：~/.continue/config.yaml
# JetBrains 插件日志：~/.continue/logs/core.log（最新日志在文件末尾）

更新 CLI：重新运行第 7.1 / 7.2 节安装命令即可；VS Code 扩展由 Marketplace 自动更新，需要旧版本时可从 OpenVSX 下载 .vsix 手动安装。

10 常见故障排查

10.1 扩展无响应或行为异常

先看日志定位错误信息：

• VS Code：Ctrl / Cmd + Shift + P 调出命令面板，执行 Developer: Toggle Developer Tools，在 Console 标签查看日志；需要调试日志时把顶部 “Default levels” 切换为 Verbose。
• Continue Console：在 VS Code 设置中搜索 “Continue: Enable Console” 并开启，重载窗口后通过命令面板 Continue: Focus on Continue Console View 打开，查看提示词与请求记录。
• JetBrains：直接打开 ~/.continue/logs/core.log；也可通过 Help → Show Log in Explorer/Finder 查看平台日志。

10.2 尝试预发布或回退旧版本

• VS Code：在扩展详情页把版本渠道切换到 Pre-Release；等待修复时可在 OpenVSX 下载历史 .vsix，通过 “从 VSIX 安装” 手动回退。
• JetBrains：在 Plugins 设置的齿轮菜单中选择 Manage Plugin Repositories，加入 EAP 渠道 https://plugins.jetbrains.com/plugins/eap/list 后获取 EAP 版本。

10.3 快捷键不生效

在编辑器键盘快捷键设置中搜索 Continue 相关命令，检查是否被其他扩展或系统快捷键占用；冲突时为 Continue 命令重新绑定按键，或在官方文档快捷键章节核对默认映射。

10.4 MCP 服务器连接失败

• 核对 MCP 服务启动命令、传输方式（stdio / HTTP / SSE）与环境变量；CLI 侧用 --mcp <slug> 追加时确认 slug 与配置一致。
• 网络受代理或证书拦截时，检查系统代理与 CA 证书；公司内网 TLS 解密环境需让扩展 / CLI 信任对应根证书。

10.5 SSL 证书错误

若模型接口使用自签证书或内网代理，按编辑器 / 运行时要求导入受信根证书；不要在未校验证书的情况下关闭 HTTPS 校验后直接暴露到公网。

10.6 本地模型上下文被截断

Ollama 默认上下文窗口较小，超出部分会被静默丢弃；在 Ollama 启动参数或模型设置中调大上下文长度，并在 Continue 模型配置里如实填写 contextLength，避免长代码库对话丢失上下文。

11 风险与合规说明

以下条款整理自官方 README、Apache 2.0 许可证与官方文档口径；如与官方原文不一致，以仓库 LICENSE、README 与 docs.continue.dev 为准。

11.1 开源协议与使用边界

Continue 开源代码采用 Apache 2.0 许可证，允许自由使用、修改与再分发，修改部分需保留版权声明与许可证副本；平台化账号、托管助手与组织功能属于 Continue Dev, Inc. 的商业服务，不在开源仓库交付范围内。

11.2 模型与 API 责任

• Continue 本身不提供模型、API Key 与模型权重；接入的 Anthropic、OpenAI、Google、Ollama 等模型与服务归各自厂商所有，受其服务条款、隐私政策与计费规则约束。
• 代码片段、项目上下文会按所选模型发送到对应服务；接入云端模型前请确认项目代码是否允许外发，敏感仓库优先使用本地模型与离线配置。

11.3 自动化与工具权限风险

• Agent / 无头模式可以读写文件、执行命令；在共享服务器、CI 环境中应限制工作目录、禁用不必要工具，并保留人工审批环节。
• --auto、--readonly 等参数只影响当前会话工具策略，不构成对系统安全边界的保证。

11.4 维护状态与免责

开源仓库已冻结只读，官方不再承诺缺陷修复、功能迭代与第三方模型接口长期兼容；使用者在法律允许的最大范围内，自行承担因部署、修改、运行本项目产生的代码质量、数据泄露、服务中断与业务损失风险。如认为仓库内特定文件侵犯合法权益，请通过 GitHub Issues 提交说明，不要在公开 Issue 中提交账号凭据或敏感代码。