中文Tutorial

Gemini CLI 使用教程 2026：终端开发工作流完整指南

面向开发者的 Gemini CLI 使用教程，包含安装、命令示例、与 Claude Code 和 Codex CLI 的对比，以及成本控制建议。

Crazyrouter Team

March 20, 2026 / 510 views

Crazyrouter

Read the docs Check live pricing Open image tool Create account

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：

bash

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 示例#

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 示例#

javascript

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 工作流，按量计费和模型路由通常更合理。