Cline 接入 Gemini CLI 教程：免费用 Gemini 2.5 Pro 写代码

Google 近期推出的 Gemini CLI 让开发者可以免费使用 Gemini 2.5 Pro 等强大模型。把它和 VS Code 里的 Cline 插件搭配起来，你就能在编辑器里直接调用 Gemini 的能力——写代码、查资料、做重构，一气呵成。下面一步步带你完成配置。

Gemini CLI 与 Cline 是什么

Gemini CLI 是 Google 官方提供的命令行工具，开发者可以通过终端直接与 Gemini 系列模型对话。它最吸引人的地方在于：个人开发者可以免费使用 Gemini 2.5 Pro 这样的高性能模型，不需要绑定信用卡，也不需要申请 API Key。

Gemini 2.5 Pro 是 Google DeepMind 于 2025 年推出的旗舰级多模态大语言模型，属于 Gemini 系列的最新迭代。它在代码生成、数学推理、长上下文理解等基准测试中表现突出，支持高达 100 万 token 的上下文窗口，意味着它可以一次性处理整个代码库级别的内容。相比 OpenAI 的 GPT-4o 和 Anthropic 的 Claude 3.5 Sonnet，Gemini 2.5 Pro 在编程任务上的竞争力非常强，尤其在多步骤推理和复杂代码重构场景中优势明显。Google 将其免费开放给个人开发者使用，被普遍认为是与 OpenAI、Anthropic 争夺开发者生态的重要策略。

Cline 是 VS Code 上非常受欢迎的 AI 编程助手插件，支持接入多种 AI 模型。最近 Cline 新增了对 Gemini CLI 的原生支持，用户只需登录 Google 账户，就能在 Cline 中免费调用 Gemini 2.5 Pro，不需要额外配置密钥。

Cline（前身为 Claude Dev）是一款开源的 VS Code AI 编程助手插件，其核心设计理念是「AI Agent」——不仅能对话，还能主动读写文件、执行终端命令、浏览网页。它通过抽象的 Provider 接口层支持多种后端模型，包括 OpenAI、Anthropic Claude、Google Gemini、本地 Ollama 模型等。Cline 与 GitHub Copilot 的定位有所不同：Copilot 侧重于行内代码补全，而 Cline 更像一个能执行复杂多步骤任务的自主编程代理，适合处理跨文件重构、项目脚手架搭建、自动化调试等场景。

两者结合的好处很明显：在 VS Code 里就能用上 Gemini 2.5 Pro 的全部能力，而且完全免费。

安装 Gemini CLI 并完成登录认证

安装 Gemini CLI

打开终端，运行官方提供的安装命令完成 Gemini CLI 的安装。安装结束后，需要进行 Google 账户登录认证。

Gemini CLI 采用 OAuth 2.0 协议进行身份认证，这是 Google 服务的标准认证方式。执行登录命令后，CLI 会在本地启动一个临时 HTTP 服务器并打开浏览器，引导用户完成 Google 账户授权。授权成功后，OAuth token 会被安全存储在本地配置目录中。Cline 插件正是复用了这个本地存储的 token 来调用 Gemini API，因此用户无需手动复制粘贴任何 API Key。这种设计既简化了配置流程，也避免了密钥泄露的安全风险。

解决网络代理问题

登录时如果长时间卡住没有反应，大概率是网络代理没配置好。你需要：

1. 检查终端的代理设置是否正确（确认 http_proxy 和 https_proxy 环境变量）
2. 确保代理能正常访问 Google 服务
3. 配置好代理后重新执行登录命令

登录成功后，Gemini CLI 就准备就绪了，接下来去 VS Code 里配置 Cline。

在 Cline 中配置 Gemini CLI Provider

安装或更新 Cline 插件

打开 VS Code，在扩展市场搜索 Cline 并安装。如果之前已经装过，记得更新到最新版本，老版本可能还不支持 Gemini CLI。

设置 Provider 为 Gemini CLI

进入 Cline 的设置界面，按以下步骤操作：

1. 点击 Cline 插件的设置按钮
2. 在 Provider（提供商）下拉菜单中选择 Gemini CLI
3. 其他配置项保持默认——因为你已经在终端完成了账户认证，Cline 会自动复用登录状态
4. 点击 Save 保存

手动选择 Gemini 2.5 Pro 模型

保存后，界面底部会显示当前使用的模型。这里有个容易踩的坑：Cline 有时不会默认选中 Gemini 2.5 Pro，而是选了其他版本。务必手动点击模型选择器，切换到 Gemini 2.5 Pro，确保用的是最强版本。

测试配置效果：发起第一次对话

发送测试消息

配置完成后，试着发一条消息验证是否正常工作。比如问一句"今天北京的天气怎么样"。

理解 Cline 的权限授权机制

Cline 对权限管理比较严格。当 AI 需要执行某些操作（比如访问天气网站获取数据）时，会先弹出授权请求：

"为了获取今天北京的天气，我需要访问一个天气网站，可以继续吗？"

你确认"可以"后，AI 才会执行。这个机制保证了安全性，防止 AI 在你不知情的情况下执行敏感操作。

切换到 Act 模式让 AI 主动执行

如果发现 Cline 只是给出建议但不主动执行操作，需要把模式切换为 Act Mode（执行模式）。在 Cline 界面中找到模式切换选项，点击切换即可。

Cline 提供两种工作模式：Plan Mode（规划模式）和 Act Mode（执行模式）。Plan Mode 下，AI 只会分析问题并给出建议方案，不会实际修改文件或执行命令，适合在不确定 AI 方案是否合理时先做评估。Act Mode 则赋予 AI 实际执行能力，它可以创建和编辑文件、运行终端命令、甚至通过无头浏览器访问网页获取信息。这种双模式设计体现了人机协作中「人类在环」（Human-in-the-Loop）的安全理念——即使在 Act Mode 下，每个敏感操作仍需用户逐一确认。

切换后 Cline 会自动执行查询任务并返回结果。在测试中，AI 成功获取了北京当天的天气信息并准确反馈，说明配置完全没问题。

使用过程中的注意事项

每次使用前确认模型版本

Cline 偶尔会自动切换模型版本。建议每次开始工作前看一眼底部的模型标识，确认是 Gemini 2.5 Pro，避免用了较弱的模型而不自知。

留意免费额度限制

Gemini CLI 虽然免费，但 Google 对免费用户有速率限制和每日配额。如果你高频使用，可能会遇到请求被限流的情况。遇到报错时稍等一会儿再试，通常很快就能恢复。

具体来说，Google 对 Gemini CLI 免费用户实施了多层限制机制：每分钟请求次数（RPM）、每日请求总量以及每分钟 token 吞吐量均有上限。这些限制通过 HTTP 429 状态码（Too Many Requests）返回。对于日常开发中的代码审查、小规模重构等任务，免费额度通常足够；但如果需要进行大规模批量处理或持续高频调用，则需要考虑升级到付费的 Google AI Studio API Key 方案，通过在 Cline 中切换到 Google Gemini Provider 并填入 API Key 即可解锁更高的调用限额。

保持网络代理稳定

正常使用的前提是能稳定访问 Google 服务。建议在代理配置中把 google.com、googleapis.com 等域名加入规则列表，避免连接中断影响使用体验。

总结：三步搞定免费 AI 编程助手

Cline 对 Gemini CLI 的原生支持，给开发者提供了一个零成本使用顶级 AI 模型的方案。整个配置流程可以概括为三步：

1. 安装 Gemini CLI 并登录 Google 账户
2. 在 Cline 中选择 Gemini CLI Provider 并保存
3. 手动切换到 Gemini 2.5 Pro 模型 开始使用

对于想体验 Gemini 2.5 Pro 又不想花钱的开发者来说，这是目前最简单、最实用的方式之一。赶紧动手试试吧。