CrazyrouterCrazyrouter
Login
Back to Blog
中文Tutorial

Gemini CLI 用户指南 - 在终端中使用 Google AI

完整指南讲解如何安装和配置 Gemini CLI，这是一款由 Google 提供的开源命令行 AI 工具。学习如何配置代理、使用内置工具，并通过 Gemini 2.5 Pro 实现工作流自动化。

C
Crazyrouter Team
January 24, 2026 / 942 views
Share:
Gemini CLI 用户指南 - 在终端中使用 Google AI
Crazyrouter
阅读完整文档打开 API Playground打开生图工具查看实时价格

Gemini CLI 是 Google 提供的开源命令行 AI 工具，可以将 Gemini 的能力直接带到你的终端中。它提供了一种轻量级方式访问 Gemini，实现从提示到模型的最直接路径。通过配置代理，即使在网络受限的环境中你也可以使用 Gemini CLI 服务。

为什么选择 Gemini CLI？#

  • 强大的 Gemini 2.5 Pro：可使用 100 万 token 的上下文窗口
  • 内置工具：Google Search grounding、文件操作、Shell 命令、网页抓取
  • 可扩展：支持 MCP（Model Context Protocol）进行自定义集成
  • 终端优先：专为在命令行工作的开发者设计
  • 开源：Apache 2.0 License

安装#

快速安装#

使用 npx 即刻运行（无需安装）#

bash
# Use official repository
npx https://github.com/google-gemini/gemini-cli

使用 npm 全局安装#

bash
npm install -g @google/gemini-cli

使用 Homebrew 安装（macOS/Linux）#

bash
brew install gemini-cli

系统要求#

  • Node.js 版本 20 或更高
  • macOS、Linux 或 Windows

配置代理#

设置环境变量#

在使用代理之前，先配置以下环境变量：

Linux / macOS#

bash
# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

cmd
set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

powershell
$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

提示：将这些环境变量添加到你的 .bashrc、.zshrc 或其他 shell 配置文件中，这样每次打开终端时都会自动生效。

快速开始#

基本用法#

在当前目录启动#

bash
gemini

包含多个目录#

bash
gemini --include-directories ../lib,../docs

使用指定模型#

bash
gemini -m gemini-2.5-flash

非交互脚本模式#

获取简单文本回复：

bash
gemini -p "Explain the architecture of this codebase"

获取结构化 JSON 输出：

bash
gemini -p "Explain the architecture of this codebase" --output-format json

快速示例#

启动新项目#

bash
cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

分析现有代码#

bash
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

主要功能#

代码理解与生成#

  • 查询并编辑大型代码仓库
  • 利用多模态能力，从 PDF、图像或草图生成新应用
  • 使用自然语言进行调试和问题排查

自动化与集成#

  • 自动化日常运维任务，例如查询 pull requests 或处理复杂 rebase
  • 通过 MCP servers 连接新的能力
  • 在脚本中以非交互方式运行，实现工作流自动化

高级功能#

  • 使用内置的 Google Search 获取实时信息
  • 会话检查点，用于保存和恢复复杂会话
  • 自定义上下文文件（GEMINI.md），根据你的项目调整行为

常用命令与示例#

探索代码仓库#

code
> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

处理现有代码#

code
> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

自动化工作流#

code
> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

系统交互#

code
> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

GitHub 集成#

使用 Gemini CLI GitHub Action 将 Gemini CLI 直接集成到你的 GitHub 工作流中：

  • Pull Request 审查：基于上下文的自动化代码审查与建议
  • Issue 分诊：根据内容分析自动为 GitHub issues 打标签并设定优先级
  • 按需帮助：在 issues 和 pull requests 中 @@gemini-cli，获取调试、解释或任务分配方面的帮助
  • 自定义工作流：构建自动化、定时及按需触发的工作流，以满足团队的特定需求

故障排查#

如果在使用过程中遇到问题，可以参考以下步骤：

1. 检查环境变量#

bash
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. 检查网络连接#

bash
curl -I https://crazyrouter.com/

3. 检查错误信息#

错误信息通常会指明问题所在。常见问题包括：

  • API key 格式无效
  • 网络连接问题
  • 代理配置不正确

4. SOCKS 代理格式#

如果使用 SOCKS 代理，请确保格式正确：

code
socks5://<user>:<pass>@<proxy>:<port>

5. 提交 Bug#

使用内置命令报告问题：

bash
/bug

版本发布#

Preview#

新的 preview 版本会在每周二 UTC 23:59 发布：

bash
npm install -g @google/gemini-cli@preview

Stable#

新的 stable 版本会在每周二 UTC 20:00 发布：

bash
npm install -g @google/gemini-cli@latest

Nightly#

Nightly 版本会在每天 UTC 00:00 发布：

bash
npm install -g @google/gemini-cli@nightly

MCP Server 使用#

在 ~/.gemini/settings.json 中配置 MCP servers，为 Gemini CLI 扩展自定义工具：

text
> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

通过 Crazyrouter 的定价#

以折扣价格访问 Gemini 模型：

ModelInput PriceOutput Price
gemini-2.5-pro$0.625/1M tokens$2.50/1M tokens
gemini-2.5-flash$0.038/1M tokens$0.15/1M tokens
gemini-2.5-flash-lite$0.019/1M tokens$0.075/1M tokens

所有价格相较官方定价均包含 45% 的折扣。

相关资源#

需要帮助？请联系支持团队，或查阅 Crazyrouter documentation 以获取更多信息。

Implementation Guides

AuthenticationCreate and use API keys with the required authorization headers.Quick Start GuideMake the first Crazyrouter API call and validate your setup.Usage Logs and Cost MonitoringUse management APIs to query logs, quota, token usage, and dollar cost.Gemini Native FormatUse Gemini native generateContent requests through Crazyrouter.
Crazyrouter
阅读完整文档打开 API Playground打开生图工具查看实时价格

Available in other languages:

العربيةDanskDeutschEnglishEspañolFrançaisBahasa IndonesiaItaliano日本語Қазақша한국어Bahasa MelayuNederlandsNorskPolskiPortuguêsРусскийไทยTürkçeTiếng Việt

Topics

Tutorial

Related Posts

2026年最佳AI音乐生成器：Suno vs Udio vs Stable Audio 对比Tutorial

2026年最佳AI音乐生成器：Suno vs Udio vs Stable Audio 对比

选择合适的AI音乐生成器可能令人眼花缭乱。本指南对比了2026年可用的顶级AI音乐工具，包括 Suno AI、Udio 和 Stable Audio，并提供真实价格和API访问信息。

Jan 23
Claude Code 安装与使用指南 - AI 编程助手配置教程Tutorial

Claude Code 安装与使用指南 - AI 编程助手配置教程

完整指南，教你如何安装和配置 Claude Code 这一 AI 编程助手。学习如何安装 Node.js、配置 API Token，并在终端中开始与你的 AI 一起编程。

Jan 24
Claude是什么？Anthropic AI助手完整指南Tutorial

Claude是什么？Anthropic AI助手完整指南

"全面介绍Anthropic Claude AI助手，包括Claude Opus 4.5、Sonnet 4.5、Haiku 4.5各版本对比，API使用教程，定价分析和Crazyrouter接入指南。"

Mar 15
Gemini CLI 使用教程 2026：终端自动化与多环境协同Tutorial

Gemini CLI 使用教程 2026：终端自动化与多环境协同

面向开发者的 Gemini CLI 使用教程，覆盖安装思路、终端自动化、多环境协同、代码示例与成本规划。

Mar 25
GPT-image-2 实战：AI 面相分析 & 个人色彩诊断 — 两大爆款玩法一文搞定Tutorial

GPT-image-2 实战：AI 面相分析 & 个人色彩诊断 — 两大爆款玩法一文搞定

用 GPT-image-2 通过 Crazyrouter API 生成 AI 面相分析报告和个人色彩季节诊断图。附完整 Python、curl、Node.js 代码。

May 1
AI API 中转全指南：选型标准、架构设计与安全合规落地Tutorial

AI API 中转全指南：选型标准、架构设计与安全合规落地

AI API 中转不是简单代理，而是统一模型入口、路由、鉴权、限流、日志、计费和合规治理的基础层。本文从业务场景、架构设计、稳定性、成本、安全和30天落地路线图出发，说明如何选择 AI API 中转平台，如何避免单价便宜但系统成本更高，以及如何让多模型调用在生产环境中可观测、可切换、可审计。

Mar 18