Gemini CLI

通过 API易 使用 Gemini CLI 进行 AI 辅助编程，支持代码生成、代码审查、智能问答等功能

​

概述

Gemini CLI 是 Google 官方推出的命令行工具，允许您在终端中直接与 Gemini AI 模型交互。通过 API易 中转，您可以：

• 🚀 在终端中快速调用 Gemini 模型
• 💻 进行 AI 辅助编程和代码生成
• 🔍 代码审查和优化建议
• 📝 技术问答和文档生成
• 🌐 跨平台使用（Linux、macOS、Windows）

为什么选择 API易？

通过 API易 使用 Gemini CLI，您可以享受更稳定的网络连接、更优惠的价格，以及 7×24 小时技术支持。

​

快速开始

​

前置要求

• Node.js >= 18.0.0
• npm 或 yarn 包管理器
• API易 账号和 API Key

​

第一步：安装 Gemini CLI

npm

# 检查 Node.js 版本
node --version  # 需要 >= 18

# 全局安装 Gemini CLI
npm install -g @google/gemini-cli

# 验证安装
gemini --version

​

第二步：获取 API易 密钥

1. 注册/登录 API易

   访问 api.apiyi.com 注册或登录您的账号

2. 创建 API Key

   进入后台「令牌管理」页面（api.apiyi.com/token），点击「创建新令牌」

3. 复制密钥

   复制生成的 API Key（格式：sk-***），妥善保存

​

第三步：配置环境变量

重要配置：GOOGLE_GEMINI_BASE_URL 必须设置为 https://api.apiyi.com，不能有多余的路径（如 /v1 或 /gemini），否则会导致连接失败。

Zsh (macOS/Linux)

# 编辑 .zshrc 文件
nano ~/.zshrc

# 添加以下环境变量
export GOOGLE_GEMINI_BASE_URL="https://api.apiyi.com"
export GEMINI_API_KEY="sk-your-api-key"  # 替换为你的 API易 密钥

# 保存后重新加载配置
source ~/.zshrc

​

第四步：初始化和测试

1. 启动 Gemini CLI

   gemini
   

2. 首次认证

   在交互界面中输入：

   /auth
   

   选择：Gemini API Key (AI Studio)

3. 测试连接

   # 简单测试
   gemini "Hello, 测试连接是否正常"
   
   # 编程相关测试
   gemini "解释一下 React Hooks 的使用方法"
   gemini "编写一个 Python 函数来计算斐波那契数列"
   

​

核心功能

​

代码生成

函数生成

gemini "用 Python 写一个快速排序算法，包含详细注释"

输出示例：

def quick_sort(arr):
    """
    快速排序算法
    时间复杂度：平均 O(n log n)，最坏 O(n²)
    空间复杂度：O(log n)
    """
    if len(arr) <= 1:
        return arr

    pivot = arr[len(arr) // 2]
    left = [x for x in arr if x < pivot]
    middle = [x for x in arr if x == pivot]
    right = [x for x in arr if x > pivot]

    return quick_sort(left) + middle + quick_sort(right)

​

代码审查

# 审查代码质量
gemini "审查以下代码的性能问题和潜在 bug：
[粘贴你的代码]
"

# 安全审计
gemini "检查这段代码的安全漏洞，特别关注 SQL 注入和 XSS 攻击"

# 最佳实践建议
gemini "这段 React 组件有什么可以优化的地方？遵循最佳实践吗？"

​

技术问答

# 概念解释
gemini "解释一下 JavaScript 的闭包概念，并给出实际应用场景"

# 错误排查
gemini "为什么我的 Promise 没有被正确 resolve？"

# 性能优化
gemini "如何优化 React 组件的渲染性能？"

# 架构设计
gemini "微服务架构和单体架构的优缺点对比"

​

文档生成

# 生成 README
gemini "为我的 Node.js 库生成一个专业的 README.md，包括安装、使用示例、API 文档"

# API 文档
gemini "为这个 REST API 端点生成 OpenAPI 3.0 规范文档"

# 代码注释
gemini "为以下代码添加详细的 JSDoc 注释"

​

交互式命令

在 Gemini CLI 交互模式下，可以使用以下命令：

命令	说明	示例
/auth	重新认证	/auth
/model	切换模型	/model gemini-pro
/clear	清除对话历史	/clear
/help	显示帮助信息	/help
/exit	退出 CLI	/exit 或 Ctrl+C
/save	保存对话到文件	/save conversation.txt

模型切换：使用 /model 命令可以在不同的 Gemini 模型之间切换，如 gemini-3-pro-preview、gemini-2.5-flash、gemini-2.5-pro 等。

​

支持的模型

通过 API易，您可以使用以下最新 Gemini 模型：

​

Gemini 3 系列（推荐）

模型	适用场景	特点
gemini-3-pro-preview	高质量代码生成、复杂推理	🏆 性能最强，LMArena 排行榜全球第一
gemini-3-pro-preview-thinking	超复杂推理、算法设计	🧠 思维链输出，深度推理能力

​

Gemini 2.5 系列

模型	适用场景	特点
gemini-2.5-pro	专业级代码生成	⚡ 高性能，100 万上下文
gemini-2.5-flash	快速响应、日常开发	🚀 速度快，成本低
gemini-2.5-flash-lite	轻量级任务、批量调用	💰 超低成本，高频调用

推荐配置：

• 复杂编程任务、架构设计：gemini-3-pro-preview
• 日常代码生成、问答：gemini-2.5-flash
• 批量处理、快速迭代：gemini-2.5-flash-lite

查看完整模型列表

查看 API易 支持的所有 Gemini 模型、详细价格和性能对比

​

高级用法

​

VS Code 集成

在 VS Code 中使用 Gemini CLI 扩展：

{
  "gemini.apiKey": "sk-your-api-key",
  "gemini.baseUrl": "https://api.apiyi.com",
  "gemini.model": "gemini-3-pro-preview",
  "gemini.temperature": 0.7,
  "gemini.maxTokens": 4000
}

​

GitHub Actions 集成

自动化代码审查：

name: Gemini Code Review
on:
  pull_request:
    branches: [ main ]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - uses: actions/setup-node@v3
        with:
          node-version: '18'

      - name: Install Gemini CLI
        run: npm install -g @google/gemini-cli

      - name: Run Code Review
        env:
          GEMINI_API_KEY: \${{ secrets.GEMINI_API_KEY }}
          GOOGLE_GEMINI_BASE_URL: https://api.apiyi.com
        run: |
          gemini "审查这个 Pull Request 的代码质量、安全性和性能：
          $(git diff origin/main...HEAD)"

​

批处理脚本

创建自动化脚本：

#!/bin/bash

# 批量代码审查
for file in src/**/*.js; do
  echo "Reviewing $file..."
  gemini "审查文件 $file 的代码质量" < "$file"
done

# 生成项目文档
gemini "为整个项目生成技术文档大纲" < README.md

​

常见问题

连接失败或认证错误？

检查清单：

1. 环境变量是否正确：

   echo $GOOGLE_GEMINI_BASE_URL
   echo $GEMINI_API_KEY
   

   确保输出为：

   • GOOGLE_GEMINI_BASE_URL: https://api.apiyi.com（不要有 /v1 或其他路径）
   • GEMINI_API_KEY: sk- 开头的完整密钥

2. 重新加载环境变量：

   source ~/.zshrc  # 或 source ~/.bashrc
   

3. 重启终端：完全关闭并重新打开终端窗口

4. 验证 API Key：登录 API易 后台确认 Key 是否有效且余额充足

如何切换不同的 Gemini 模型？

在交互模式下使用 /model 命令：

/model gemini-3-pro-preview
/model gemini-3-pro-preview-thinking
/model gemini-2.5-flash

或在命令行直接指定：

gemini --model gemini-3-pro-preview "你的问题"
gemini --model gemini-2.5-flash "快速测试"

如何保存对话历史？

方法一：使用 /save 命令

/save conversation-2025-01-01.txt

方法二：重定向输出

gemini "你的问题" > output.txt
gemini "你的问题" | tee output.txt  # 同时显示和保存

方法三：使用会话管理

gemini --session my-project "继续之前的讨论"

Node.js 版本不满足要求怎么办？

推荐使用 nvm 管理 Node.js 版本：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装 Node.js 18+
nvm install 18
nvm use 18
nvm alias default 18

# 验证版本
node --version

为什么响应速度慢？

可能原因和解决方案：

1. 网络问题：API易 提供国内优化节点，通常响应很快
2. 模型选择：使用 gemini-2.5-flash 或 gemini-2.5-flash-lite 获得最快响应
3. Token 限制：减少单次请求的复杂度
4. 并发请求：避免同时发送大量请求

测试连接速度：

time gemini --model gemini-2.5-flash "Hello"

如何在 Windows 上使用？

推荐使用 PowerShell：

1. 安装 Node.js（从官网下载安装包）
2. 以管理员身份运行 PowerShell
3. 设置环境变量：
   [System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_BASE_URL', 'https://api.apiyi.com', 'User')
   [System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'sk-your-key', 'User')
   

4. 重启 PowerShell
5. 安装和使用 Gemini CLI

或使用 WSL（Windows Subsystem for Linux）获得更好的体验。

​

最佳实践

​

提示词优化

明确具体

❌ “优化这段代码”

✅ “优化这段代码的性能，重点关注循环效率和内存使用”

提供上下文

❌ “这个函数有什么问题？”

✅ “这是一个用于处理用户登录的函数，目前遇到异步错误，帮我找出问题”

分步骤请求

❌ “帮我完成整个项目”

✅ “第一步：设计数据库模型；第二步：创建 API 路由；第三步：…”

要求示例

❌ “解释闭包”

✅ “解释 JavaScript 闭包，并给出 3 个实际应用场景和代码示例”

​

工作流建议

1. 问题定义

   清晰描述要解决的问题或实现的功能

2. 获取方案

   使用 Gemini CLI 生成初步解决方案或代码

3. 审查优化

   要求 AI 审查自己生成的代码，找出潜在问题

4. 迭代改进

   根据反馈逐步优化，直到满足需求

5. 文档补充

   生成必要的注释和文档

​

价格说明

使用 API易 调用 Gemini 模型的费用取决于您选择的模型和使用量。

查看详细价格

查看所有 Gemini 模型的详细定价和性价比对比

API易 提供充值优惠：充值越多，加赠比例越高（10%-22%）。首次充值还可获得额外加赠。查看 充值活动详情。

​

相关资源

• Gemini CLI 官方文档
• API易 快速开始指南
• 模型推荐和价格对比
• 充值优惠活动
• API 使用手册

​

获取帮助

技术支持

添加微信：8765058

技术咨询、使用指导

邮件咨询

客服邮箱：[e-mail]

商务合作：[e-mail]

快速上手：按照本文的「快速开始」章节，5 分钟即可完成配置并开始使用 Gemini CLI！