Cline 可以在 VS Code 中读取项目、提出修改计划、编辑文件和调用工具。它支持不同模型提供商，因此上手时最重要的是把插件、模型账号和 API 配置分开：安装了 Cline，并不等于已经有可用模型额度。

旧版 Gemini 2.0 实验模型、Grok 固定型号以及当时的免费额度，不再作为当前配置建议。下面按现在的提供商入口介绍配置方法。

安装 Cline，并打开一个小项目

从 Cline 官方仓库进入 VS Code Marketplace，核对扩展名称与发布来源，再安装。不要把名称相似的第三方扩展当成官方版本。Cline 曾使用 Claude Dev 这个名称，旧截图可能仍沿用旧称。

安装后打开 Cline 面板，并用 VS Code 打开一个你熟悉的小项目。第一次可以选择只有几份文件的练习仓库，方便检查它读了什么、改了什么。

Cline 是独立项目，OpenRouter 是它支持的模型接入方式之一；不能把插件本身描述为 OpenRouter 提供的服务。

先选择接入路径

左右滑动查看完整表格

你准备使用什么

在 Cline 中核对的提供商

需要准备什么

Google Gemini API

Google Gemini

Google AI Studio 的 API Key、可用模型与项目额度

xAI Grok API

xAI

xAI API Key、账号实际可用的模型

多家模型统一接入

OpenRouter

OpenRouter Key、余额和所选模型的可用性

Anthropic API

Anthropic

Anthropic API Key 与 API 额度

本地 Claude Code 登录路径

Claude Code（支持该入口的版本）

已安装并完成授权的 Claude Code CLI

其他兼容服务

OpenAI Compatible

服务商给出的 Base URL、API Key、准确模型 ID

聊天产品订阅、官方 API、聚合网关是不同的费用与授权关系。不要默认购买一个网页聊天套餐，就能把同一账号当作所有插件的 API Key 使用。

Gemini：选择当前可用的模型

在 Cline 的模型设置中选择 Google Gemini，按 官方接入说明创建或填入 API Key，再从当前模型列表选择账号可用的模型。

原文中的 gemini-2.0-flash-exp 是历史实验型号，不适合继续写成通用默认值。模型下线、项目权限变化和配额限制，都可能导致旧配置失效。遇到模型不存在时，先检查模型列表，而不是反复更换密钥。

先发一个短请求验证接入，例如“只解释当前 README，不修改文件”。确认可以回复后，再用一个小改动检查工具调用能力。免费层是否可用、速率和价格，应查看 Gemini API 价格页与自己项目的配额页面。

Grok：优先核对 xAI 专用入口

当前 Cline 文档已列出 xAI 提供商。打开设置后先查找该入口，按 提供商说明填写 xAI Key，并使用账号当前可用的模型名称。

旧文通过 OpenAI Compatible 接入 Grok 的思路，不应继续写成唯一方式。如果使用兼容入口，Base URL、Key 与模型 ID 必须来自同一家服务的文档，不能混用聚合网关的模型名和 xAI 的直连地址。

原文曾提到的 Grok-2-1212 与 25 美元赠金属于当时的信息，不代表今天仍可申请或调用。当前访问方式与用量以 xAI 文档及控制台为准。

OpenRouter 与兼容接口有什么区别

选择 OpenRouter 时，使用其专用入口和 Key，并从当前列表选择模型。模型价格、是否支持工具及可用上下文，都要按所选模型确认；“一个 Key 接多种模型”不等于这些模型免费。步骤见 Cline 的 OpenRouter 配置。

OpenAI Compatible 则用于兼容 OpenAI 接口的服务。通常要核对三项：

  1. Base URL 是服务商规定的 API 根地址，避免误填网页首页或重复追加路径。
  1. API Key 属于该服务，而非另一家平台的账号。
  1. Model ID 与服务端实际名称完全一致，不随意改大小写或前缀。

兼容接口也可能在工具调用、图片输入、流式输出或上下文限制上存在差异。连接能返回文字后，还应验证一次实际工具任务。参考 OpenAI Compatible 配置文档，不要猜测高级参数。

使用 Claude 模型时，分清 API 与 CLI 登录

Anthropic 提供商使用 API Key 和 API 额度；Cline 文档也列出 Claude Code 提供商，通过本机已安装、已授权的 CLI 工作。两者配置与限制不同，具体支持范围以 Cline Anthropic / Claude Code 说明为准。

如果从未用过 CLI，先读 Claude Code 安装与第一次使用。不要为了接入插件复制登录令牌给未知服务，或把账号凭据填入不明中转站。

第一个任务：先计划，再修改

用 Plan 模式开始，给出明确范围：

代码
先阅读 README 和与价格汇总相关的代码。
说明如何运行项目、有哪些测试，以及空数组目前会如何处理。
暂时不要修改文件，不读取 .env，不安装依赖。

核对回答引用的文件与实际内容，再切换 Act 执行一个小任务：

代码
只修复价格汇总函数的空数组边界，并补充对应测试。
遵循现有风格，不修改无关文件，不升级依赖。
运行项目已有的测试命令，列出修改文件和验证结果。

每次批准前看清文件路径与命令。任务结束后自己检查 Git diff 和测试输出，不把“已完成”的回复当作验收依据。

如果想让 Cline 使用额外服务，继续看 Cline MCP 配置与实际使用。连接 MCP 与选择模型是两件事：模型能聊天，不代表 MCP 已连接。

失败时先看错误属于哪一层

表现

优先排查

401 / 认证失败

Key 是否填在正确提供商、是否已失效

403 / 无权限

模型授权、项目权限、服务或地区限制

404 / 模型不存在

Base URL、模型 ID、旧模型是否已下线

429 / 请求受限

速率、并发、额度；按服务返回的提示等待或调整

能聊天，工具调用失败

模型工具能力、插件版本、兼容接口实现

MCP 启动失败

服务环境、可执行程序、参数与 MCP 日志

连续失败时，先保存不含密钥的错误信息，缩小为一个最小请求。不要直接开启全部自动批准，或随意放宽文件权限，这些操作通常解决不了认证和模型问题。

下一步按你的需求继续

希望比较替代插件，可以看 Cline、Continue、Kilo Code 与 GitHub Copilot 选型。如果准备用 AI 帮忙做上传功能，Cloudflare R2 预签名上传与 CORS 排查提供了能逐层检查的例子：让助手根据明确的接口约束工作，比只说“修一下跨域”更容易得到可靠结果。

历史原文：仅用于保留旧评论上下文

下面这段来自 2024 年原文，模型名与赠金额度已经过时，不是当前配置或价格建议。保留它，是为了让引用这段文字的历史评论仍能定位到原句。

Model 可以填入 Grok-2-1212，API KEY 通过这里获取，当前 Grok 免费开放，有 25 美金的免费额度，近乎于免费

请使用上文当前配置入口，并以账号控制台显示的模型、额度和价格为准。