Skip to content

Gemini CLI 部署指南

Gemini CLI 是 Google 推出的命令行 AI 工具。通过 HuHu API 中转,可以稳定访问 Gemini 系列模型。

安装 Gemini CLI

bash
npm install -g @google/gemini-cli

验证安装:

bash
gemini --version

配置 HuHu API

HuHu 提供 OpenAI 兼容接口,Gemini CLI 需通过以下方式配置使用 HuHu 中转:

使用环境变量

bash
export GEMINI_API_KEY=sk-your-token-here
export GEMINI_BASE_URL=https://www.huhu.asia/v1

持久化到 ~/.zshrc

bash
echo 'export GEMINI_API_KEY=sk-your-token-here' >> ~/.zshrc
echo 'export GEMINI_BASE_URL=https://www.huhu.asia/v1' >> ~/.zshrc
source ~/.zshrc

使用配置文件

~/.gemini/settings.json 中配置:

json
{
  "apiKey": "sk-your-token-here",
  "baseUrl": "https://www.huhu.asia/v1"
}

启动 Gemini CLI

bash
# 交互模式
gemini

# 单次问答
gemini "解释量子纠缠的基本原理"

# 处理文件
gemini "总结这个文件" < README.md

支持的 Gemini 模型

模型上下文特点
gemini-2.5-pro1M tokens最强推理,支持深度思考
gemini-2.5-flash1M tokens速度快,成本低
gemini-2.0-flash1M tokens均衡选择

代码分析示例

bash
# 进入项目目录
cd /your/project

# 启动 Gemini CLI
gemini

# 示例对话
> 分析当前项目的架构,找出潜在的性能问题
> 为 api/routes.go 中的每个函数生成测试用例
> 将这段 Python 代码翻译成 TypeScript

图像分析

Gemini 支持多模态输入,可以分析图像:

bash
# 分析本地图片
gemini "描述这张图片" --image ./screenshot.png

# 分析 URL 图片
gemini "这个 UI 设计有什么改进建议" --image https://example.com/ui.png

常见问题

Q: 提示模型不支持?

A: 确认 HuHu 平台已开通对应 Gemini 模型的访问权限。

Q: 如何使用 Gemini 的深度思考功能?

A: 使用 gemini-2.5-progemini-2.5-flash 模型,并在提示词中明确要求深度分析。

HuHu 使用文档