
Gemini CLI 使用教程 2026:终端开发工作流完整指南
Gemini CLI 使用教程 2026:终端开发工作流完整指南#
什么是 Gemini CLI?#
很多人搜 Gemini CLI 使用教程,其实不是想看一篇泛泛而谈的介绍,而是想知道三件事:它到底能不能融入日常开发、和 Claude Code / Codex CLI 比起来怎么样、以及值不值得长期用。
Gemini CLI 本质上是把 Gemini 模型能力放进终端工作流里。对于开发者来说,这种形态很重要,因为真正的开发工作不是在聊天框里完成的,而是在 shell、git、日志、脚本、容器和远程服务器里完成的。
如果你经常做下面这些事,Gemini CLI 才值得认真看:
- 在终端里快速解释报错
- 扫描项目结构并总结模块关系
- 写 shell 脚本、正则、SQL、迁移脚本
- 辅助代码重构和文档生成
- 在 CI 或 devcontainer 里复用同一套 AI 工作流
Gemini CLI vs 其他工具#
| 工具 | 优势 | 适合人群 | 缺点 |
|---|---|---|---|
| Gemini CLI | 上手快,适合 Google 生态 | 已经在用 Gemini 的开发者 | 某些复杂编码场景不如 Claude 稳 |
| Claude Code | 代码理解和终端协作体验强 | 重度编程用户 | 成本更高 |
| Codex CLI | OpenAI 生态兼容性好 | GPT 工作流用户 | 对代理和终端治理要自己补齐 |
| Cursor | IDE 体验成熟 | 编辑器重度用户 | 不够 shell-first |
我的看法很直接:如果你本来就是终端党,Gemini CLI 值得试;如果你追求最强代码修复体验,Claude Code 往往更稳;如果你想保留多模型切换空间,就不要把整个流程绑死在单一厂商上。
如何使用 Gemini CLI#
安装思路#
不同版本的安装命令可能会更新,但通用原则不变:
- 安装官方 CLI 或兼容包
- 配置 API Key
- 先做一次最小可行测试
- 再接入你的项目工作流
cURL 测试示例#
如果你想先验证接口是否可用,可以直接用 Crazyrouter 的统一接口做 smoke test:
curl https://crazyrouter.com/v1/chat/completions -H "Authorization: Bearer YOUR_CRAZYROUTER_API_KEY" -H "Content-Type: application/json" -d '{
"model": "gemini-3-pro-preview",
"messages": [
{"role": "user", "content": "请总结一个 Node.js 项目的目录结构审查清单"}
]
}'
Python 示例#
from openai import OpenAI
client = OpenAI(
api_key="YOUR_CRAZYROUTER_API_KEY",
base_url="https://crazyrouter.com/v1"
)
resp = client.chat.completions.create(
model="gemini-3-pro-preview",
messages=[
{"role": "system", "content": "你是一个严谨的开发助手。"},
{"role": "user", "content": "为一个 FastAPI 项目生成日志排查 checklist。"}
],
temperature=0.2,
)
print(resp.choices[0].message.content)
Node.js 示例#
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.CRAZYROUTER_API_KEY,
baseURL: "https://crazyrouter.com/v1",
});
const response = await client.chat.completions.create({
model: "gemini-3-pro-preview",
messages: [
{ role: "system", content: "你是资深 DevOps 工程师。" },
{ role: "user", content: "写一个用于清理过期 Docker 镜像的脚本方案。" },
],
});
console.log(response.choices[0].message.content);
如果你准备把 Gemini CLI 真正用于生产开发流程,我建议把它放在这些环节里,而不是无脑全覆盖:
- 日常报错解释
- 文档生成
- Shell 脚本草稿
- 配置文件审查
- 中等复杂度代码修改建议
真正高风险的重构、数据库迁移、权限逻辑改动,还是应该保留人工审查和测试。
价格拆解#
开发者最容易忽略的一点是:CLI 工具看起来像订阅产品,实际消耗逻辑更像 API 产品。
| 方案 | 成本特点 | 适合谁 |
|---|---|---|
| 官方 Gemini 订阅 | 固定月费,适合个人 | 个人日常使用 |
| 直接 API 调用 | 按量计费 | 应用接入、脚本自动化 |
| Crazyrouter 统一路由 | 一套 Key 多模型 | 团队、多模型对比、成本治理 |
如果你只是自己在本机用,订阅模式很省心;如果你要做团队内工具、自动化脚本、CI 工作流,按量计费和模型路由通常更合理。
FAQ#
Gemini CLI 适合开发者吗?#
适合,尤其适合习惯在终端里完成大量工作的开发者。
Gemini CLI 和 Claude Code 怎么选?#
如果你更看重代码质量和复杂仓库理解,Claude Code 通常更强;如果你更看重 Gemini 生态和上手门槛,Gemini CLI 很值得试。
Gemini CLI 可以接 Crazyrouter 吗?#
如果你的工具链支持 OpenAI-compatible 或可配置 base URL,那么完全可以通过 Crazyrouter 统一接入不同模型。
Gemini CLI 值得长期用吗?#
值得,但前提是你清楚它适合哪些任务,不要把所有高风险改动都交给它。
总结#
这篇 Gemini CLI 使用教程 的核心不是教你背命令,而是帮你判断它在真实开发工作流里的位置。Gemini CLI 适合终端党,也适合作为多模型工具链的一部分,但最稳的做法仍然是保留模型切换空间、日志监控和人工复核。
If you want one API key for Claude, Gemini, OpenAI, GLM, Qwen, and more, start at Crazyrouter and check the live pricing at crazyrouter.com/pricing.


