🔥 Gemini CLI:Google 官方开源,103k Stars,终端里直接调 Gemini 3,不注册也能用
项目地址:https://github.com/google-gemini/gemini-cli | ⭐ 103k+ | 🛠 TypeScript | 📜 Apache 2.0
老实说,现在终端里的 AI 工具已经多到选不过来了。Claude Code、OpenHands、Warp — 每个都要搞一套 API Key、注册、配置。Google 这回直接端了个狠货出来:Gemini CLI,一个开源的终端 AI Agent,装了就能用,连 API Key 都不一定要填。
一、安装:四选一,挑顺手的
别整那些花里胡哨的,安装就一行:
# 最省事,不用装直接跑
npx @google/gemini-cli
# 或者装到全局
npm install -g @google/gemini-cli
# macOS/Linux 用户
brew install gemini-cli
# 不想装 Node?用 Anaconda
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli
装完直接 gemini 回车,它会自动走 OAuth 登录流程,浏览器弹个窗确认就行。60 次/分钟、1000 次/天的免费额度,个人用基本够了。
二、三种认证方式
Google 给了三条路,看你的场景选:
# 1️⃣ 个人 Google 账号(最推荐,免费额度够用)
# 直接 gemini 回车 → 浏览器点同意就行
gemini
# 2️⃣ API Key(需要指定模型时用)
export GEMINI_API_KEY="你的key"
gemini -m gemini-2.5-flash
# 3️⃣ Vertex AI(企业生产环境)
export GOOGLE_API_KEY="***"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini
三、核心用法
最骚的操作是它可以直接当脚本用,不用交互模式:
# 交互模式,当前目录上下文
gemini
# 带多个目录
gemini --include-directories ../lib,../docs
# 指定模型
gemini -m gemini-2.5-flash
# 非交互模式,适合 CI/CD
gemini -p "给我总结这个项目今天改了什么"
# JSON 输出,适合脚本解析
gemini -p "分析这个项目的架构" --output-format json
非交互模式可以直接塞进 GitHub Actions 或者定时任务。比如每天自动 review PR:
gemini -p "Review the changes in this PR, list potential issues" --output-format json
四、MCP 扩展 + GitHub Action
踩过的坑都是泪 — 很多 CLI 工具的扩展性就是个摆设。Gemini CLI 支持 MCP(Model Context Protocol),配置在 ~/.gemini/settings.json 里:
{
"mcpServers": {
"github": { "command": "npx", "args": ["@github/mcp"] },
"slack": { "command": "npx", "args": ["@slack/mcp"] }
}
}
然后在终端里直接:
> @github 列出我开的 PR
> @slack 把今天的 commit 总结发到 #dev 频道
更狠的是 GitHub Action 集成,自动 review PR、打标签、处理 issue:
name: AI Code Review
on: [pull_request]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: google-github-actions/run-gemini-cli@v1
with:
prompt: "Review this PR for bugs and security issues"
五、总结
npx 一键跑,连 Node 都不用装全局别问我怎么知道的 — 我已经把每天的代码 review 扔给 Gemini CLI 了,省出来的时间摸鱼真香。