🤖 Gemini CLI:103k Stars,Google 官方出的 AI 终端助手,npx @google/gemini-cli 就能用
项目地址:google-gemini/gemini-cli | ⭐ 103,916 Stars | 🛠 TypeScript | 作者:Google Gemini
老实说,一个带 AI 的终端工具能冲到 103k Stars,肯定不是花架子。Gemini CLI 是 Google 官方出的开源 AI Agent,直接在你的终端里跑 Gemini 3 模型,1M token 上下文窗口,还带 Google Search 接地、文件操作、MCP 扩展 这些硬核功能。
最骚的是——它有免费 tier,个人 Google 账号就能用,60 请求/分钟,每天 1000 次,完全不花钱。
一、安装:比装个 npm 包还简单
别整那些花里胡哨的,一行命令搞定:
# 不安装,直接跑
npx @google/gemini-cli
# 想全局装也行
npm install -g @google/gemini-cli
# macOS/Linux 用户
brew install gemini-cli
装完之后跑 gemini,浏览器会弹出 Google 登录授权,完了就能直接聊。
二、三种认证方式,总有一种适合你
1. OAuth 登录(推荐) — 个人 Google 账号,免费 tier 直接怼:
gemini
# 浏览器自动弹出,登录即用
2. API Key — 想选特定模型或者要更高的限额:
export GEMINI_API_KEY="你的key" # 从 https://aistudio.google.com/apikey 获取
gemini
3. Vertex AI — 企业级场景:
export GOOGLE_API_KEY="你的key"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini
三、核心操作
最常用的几个命令:
# 在当前目录启动
gemini
# 指定模型
gemini -m gemini-2.5-flash
# 非交互模式,适合脚本集成
gemini -p "解释一下这个项目的架构"
# JSON 输出
gemini -p "列出所有 API 端点" --output-format json
项目根目录放个 GEMINI.md 就能自定义 Agent 的行为——比如告诉它你的代码规范、项目约定,每次对话自动加载。
MCP 也是原生支持的:
gemini --mcp-servers '{"my-server": {"command": "node", "args": ["server.js"]}}'
四、和同类工具比怎么样?
踩过的坑都是泪。我用过 Claude Code、OpenCode、DeepSeek TUI 这些终端 Agent。Gemini CLI 的优势很明显:
要说缺点嘛…Gemini 的中文理解偶尔会飘,写中文注释的时候建议英文提问。