← 返回 Blog
UseAIAPIAI API3min

Google 亲手把 Claude Code 卷死了？Gemini CLI 保姆级安装教程：从 npm 一键装上手到 100 万 token 上下文跑起来

这篇文章不打算纠结 "谁赢谁输"—— 工具的本质从来不是竞技场。但 Gemini CLI 确实给国内开发者提供了一条值得认真对待的备选出路。下面这份保姆级教程，从安装到实战，全程不带废话。

GeminiGemini CLI 安装教程

Gemini CLI 保姆级安装教程：从一键安装到 1M Token 上下文实战

先说背景。过去一年，国内开发者使用 Claude Code 的心态，用四个字概括就是：悬而未决。今天流水线跑得好好的，明天可能弹出一个实名认证窗口就彻底卡死；身边越来越多的人陆续收到风控通知，辛苦搭建的工作流说断就断。有人自嘲是 "AI 难民"—— 明明花了钱买了订阅，但使用权随时可能被收回，这种 "失控感" 比花钱本身更让人难受。

就在这个节骨眼上，谷歌推出了 Gemini CLI。这款工具于 2025 年 6 月 25 日由谷歌官方发布，采用 Apache 2.0 开源协议，直接将 Gemini 2.5 Pro 搬进了终端，还提供了每分钟 60 次、每天 1000 次的免费额度，以及 1M token 的超大上下文窗口。到 2026 年 4 月，子代理（subagents）功能正式落地，内置通用助手、命令行帮助、代码库调查员等专用智能体，每个都独立享有 1M token 上下文。这一套组合拳打出来，网上真有人问："谷歌这是亲手把 Claude Code 卷死了？"

这篇文章不打算纠结 "谁赢谁输"—— 工具的本质从来不是竞技场。但 Gemini CLI 确实给国内开发者提供了一条值得认真对待的备选出路。下面这份保姆级教程，从安装到实战，全程不带废话。

一、准备工作：只需安装 Node.js

Gemini CLI 的唯一硬要求是 Node.js 18 及以上版本（实际推荐 20 及以上）。

Node.js 是一个免费、开源、跨平台的 JavaScript 运行时环境，能够让开发人员创建服务器、Web 应用、命令行工具和脚本。你可以通过以下步骤检查并安装：

打开终端输入以下命令查看当前 Node.js 版本：

bash

运行

node -v

如果版本低于 18，建议前往 Node.js 官方网站（https://nodejs.org）下载最新的 LTS 版本，整个安装过程只需两三分钟。

这正是它与 Claude Code 最显著的区别 —— 不需要每月支付 20 美元订阅费，不需要海外手机号接收验证码，也不需要折腾虚拟信用卡。那些 Claude Code 用户耳熟能详的 "闯关流程"，Gemini CLI 一概没有。

二、一行命令，全局安装

打开终端，输入以下命令即可全局安装 Gemini CLI：

bash

运行

npm install -g @google/gemini-cli

Mac 用户如果遇到权限提示，可以在命令前加上 sudo：

bash

运行

sudo npm install -g @google/gemini-cli

安装完成后，输入以下命令验证是否成功：

bash

运行

gemini --version

如果能看到版本号输出，就说明 Gemini CLI 已经成功安装到你的电脑上了。整个过程不到 30 秒。

三、首次启动：一键授权即可使用

这是最关键的一步。在终端输入以下命令启动 Gemini CLI：

bash

运行

gemini

CLI 会自动弹出一个浏览器页面，提示你使用谷歌账号登录。选择你要使用的账号，点击 "Allow" 授权即可。授权完成后，关闭浏览器页面，CLI 会自动回到终端界面，你会看到类似这样的提示符：

plaintext

What would you like me to help with?

恭喜你，你的终端 AI 编程助手已经正式上线了。

免费额度与上下文窗口详解

使用个人谷歌账号登录，你将获得免费版的所有权益：每天 1000 次调用、每分钟 60 次调用，接入的是 Gemini 2.5 Pro 模型，上下文窗口高达 1,048,576 tokens（1M）。

1M token 是什么概念？GPT-4o 的公开上下文窗口是 128K，Claude 基础档是 200K，Gemini 直接提供了 7-8 倍的容量，能够一次性 "吞下" 整个中等规模的代码仓库（几百个文件、数万行代码）—— 不需要手动拆分，不需要挑拣关键文件，也不用担心跨文件依赖被切碎。

有评测显示，在 1M token 输入范围内，Gemini 对特定函数调用链的检索召回率接近 99%。这意味着你可以直接问 "这个页面的性能瓶颈在哪"，它会自己跨文件追踪定位问题。

反观 Claude Code Pro，每月 20 美元的订阅，活跃开发者几个小时就能把额度用干；真正能当主力使用的 Max 5x 档，每月需要 100 美元。而 Gemini CLI 直接把这条门槛拉到了零。

四、核心功能介绍

1. 导入本地文件：@符号交互

在 CLI 对话中输入 @符号，会自动弹出文件选择器，你可以点选想要让 AI 分析的文件。如果你用过 Claude Code 的 / 命令体系，会发现这套交互范式在 2026 年已经高度趋同，学习成本几乎为零。

2. 子代理（Subagents）：处理复杂任务的核心武器

这是 2026 年 4 月推出的核心功能（v0.36 及以上版本支持）。Gemini CLI 内置了多个专用智能体，每个都有明确的职责分工：

表格

内置智能体主要职责
generalist通用多文件操作
cli_help解答 CLI 本身的文档相关问题
codebase_investigator架构分析、依赖追踪、根因排查

你还可以通过在项目级的.gemini/agents/目录下放置.md 定义文件，轻松扩展自定义智能体。

最关键的设计是：每个子代理都运行在独立的隔离环境中，完成任务后只把摘要结果返回给主会话，不会污染主上下文 —— 谷歌称之为解决 "上下文腐烂" 问题的方案。

而且每个子代理都独立享有约 1M token 的上下文窗口，相比 Claude Code 子代理大约 200K-400K 的窗口，Gemini 在 "大仓库全局扫描" 场景下具有明显的结构性优势。

3. 联网搜索（Search Grounding）

Gemini CLI 内置了谷歌搜索接地功能。当你问 "React 19 最新特性是什么" 这类需要最新信息的问题时，它会自动搜索最新的官方文档，而不是依赖训练数据中的过期知识。这对于需要跟进新技术栈的项目特别有用。

五、三组实测：1M Token 的真实体验

为了让大家直观感受 1M token 上下文的威力，我们做了三组实测：

第一组：长文档理解

将一份约 15 万 token（≈200 页）的技术白皮书完整喂入，要求提取其中两章的数据制作对比表格。Gemini 准确定位了所有关键数据点，表格格式无误，没有出现幻觉。而使用 128K 窗口的模型，需要先将文档切成 5 块分段处理，合并时经常出现跨章引用断裂的问题。

第二组：大代码库分析

将一个 8 万 token 的 Python 项目（47 个文件）整体喂入，Gemini 不仅画出了完整的依赖图，还指出了一个隐含的耦合问题 —— 两个模块没有直接 import，但通过共享全局配置文件产生了间接依赖，连代码审查者自己都没有注意到。而 128K 窗口的模型只能看到前 15 个文件，剩下 32 个文件的依赖关系完全丢失。

第三组：海量文档信息检索

将 10 份技术文档混合在一起（共约 60 万 token），在其中一份文档的第 47 段埋了一句 "项目代号 Phoenix，预算上限 480 万元"。让 Gemini 找出这句话，它不仅准确定位了位置，还给出了完整的上下文。这种 "大海捞针" 的能力在大型项目中价值极高。

六、关于网络的诚实提醒

这里需要特别说明：Gemini CLI 的登录授权和模型调用需要能够稳定访问谷歌的服务。也就是说，它并非完全没有门槛的 "免费午餐"。

但相比 Claude Code 在国内遇到的 "代理 + 海外号 + 实名认证 + 随时封号" 这套复杂流程，Gemini CLI 的解决方案要简单得多。首次登录通过谷歌 OAuth 授权完成后，后续只需确保终端流量能够正常访问即可。你可以通过设置环境变量来配置代理：

bash

运行

export HTTPS_PROXY=http://your-proxy-address:port
export HTTP_PROXY=http://your-proxy-address:port
gemini

如果你使用 API Key 模式而非账号 OAuth 模式，也可以通过更换 Base URL 的方式来解决网络问题。

七、谷歌真的 "卷死"Claude Code 了吗？

说 "卷死" 太过煽动。更准确的说法是：Gemini CLI 给开发者提供了一个真正零成本的优质选项。

我们来看硬数据 ——SWE-bench Verified 基准测试结果：

  • Claude Opus 4.6：80.8%
  • Gemini 2.5 Pro：63.8%

两者相差大约 17 个百分点。在复杂多文件重构和跨文件依赖追踪方面，Claude 的推理深度确实更胜一筹。

但在日常开发工作中，占比 80% 的任务 —— 单文件编辑、快速原型开发、代码库全局理解等，Gemini CLI 已经完全够用，而且是免费够用。

我个人的实用结论是：完全没必要二选一。用 Gemini CLI 处理日常任务和快速原型，把 Claude Code 留给需要最高推理精度的关键时刻 —— 一个免费干轻活，一个付费攻坚，这才是 2026 年终端 AI 编程最实在的配置。至于谁把谁卷死，那是厂商需要操心的事，对我们开发者来说，工具好用就行。

对于希望获得更稳定、更便捷 AI 服务的开发者来说，选择专业的 API 中转服务平台是一个不错的选择。UseAIAPI 提供包括 Gemini、Claude、ChatGPT、DeepSeek 在内的全球热门 AI 大模型一站式接入服务，无需复杂的账号注册和环境配置，一次配置即可灵活切换不同模型，满足各种开发和使用场景的需求。

价格方面，平台推出最低至官方价格 50% 的专属优惠，能够大幅降低高强度内容生成、复杂推理任务的使用成本。对于企业用户，UseAIAPI 还提供专业的企业级定制化服务，包括专属节点部署、SLA 服务等级保障和 7×24 小时技术支持，为团队协作和生产环境使用提供全方位保障。