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
# 检查 Node.js 版本
node --version # 需要 >= 18
# 全局安装 Gemini CLI
npm install -g @google/gemini-cli
# 验证安装
gemini --version
第二步:获取 API易 密钥
注册/登录 API易
访问 api.apiyi.com 注册或登录您的账号
创建 API Key
进入后台「令牌管理」页面(api.apiyi.com/token),点击「创建新令牌」
复制密钥
复制生成的 API Key(格式:sk-***),妥善保存
第三步:配置环境变量
重要配置 :GOOGLE_GEMINI_BASE_URL 必须设置为 https://api.apiyi.com,不能有多余的路径(如 /v1 或 /gemini),否则会导致连接失败。
Zsh (macOS/Linux)
Bash (Linux)
PowerShell (Windows)
CMD (Windows)
# 编辑 .zshrc 文件
nano ~/.zshrc
# 添加以下环境变量
export GOOGLE_GEMINI_BASE_URL = "https://api.apiyi.com"
export GEMINI_API_KEY = "sk-your-api-key" # 替换为你的 API易 密钥
# 保存后重新加载配置
source ~/.zshrc
# 编辑 .bashrc 文件
nano ~/.bashrc
# 添加以下环境变量
export GOOGLE_GEMINI_BASE_URL = "https://api.apiyi.com"
export GEMINI_API_KEY = "sk-your-api-key" # 替换为你的 API易 密钥
# 保存后重新加载配置
source ~/.bashrc
# 设置环境变量
$ env: GOOGLE_GEMINI_BASE_URL = "https://api.apiyi.com"
$ env: GEMINI_API_KEY = "sk-your-api-key"
# 永久保存(可选)
[ System.Environment ]::SetEnvironmentVariable( 'GOOGLE_GEMINI_BASE_URL' , 'https://api.apiyi.com' , 'User' )
[ System.Environment ]::SetEnvironmentVariable( 'GEMINI_API_KEY' , 'sk-your-api-key' , 'User' )
# 临时设置环境变量
set GOOGLE_GEMINI_BASE_URL = https ://api.apiyi.com
set GEMINI_API_KEY = sk - your - api - key
# 永久保存(需要管理员权限)
setx GOOGLE_GEMINI_BASE_URL "https://api.apiyi.com"
setx GEMINI_API_KEY "sk-your-api-key"
第四步:初始化和测试
首次认证
在交互界面中输入: 选择:Gemini API Key (AI Studio)
测试连接
# 简单测试
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 "创建一个 Express.js REST API 项目结构,包含用户认证和数据库配置"
gemini "为这个函数编写 Jest 单元测试:
function fibonacci(n) {
if (n <= 1) return n;
return fibonacci(n - 1) + fibonacci(n - 2);
}"
代码审查
# 审查代码质量
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
常见问题
检查清单 :
环境变量是否正确 :
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
确保输出为:
GOOGLE_GEMINI_BASE_URL: https://api.apiyi.com(不要有 /v1 或其他路径)
GEMINI_API_KEY: sk- 开头的完整密钥
重新加载环境变量 :
source ~/.zshrc # 或 source ~/.bashrc
重启终端 :完全关闭并重新打开终端窗口
验证 API Key :登录 API易 后台确认 Key 是否有效且余额充足
在交互模式下使用 /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 "继续之前的讨论"
推荐使用 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
可能原因和解决方案 :
网络问题 :API易 提供国内优化节点,通常响应很快
模型选择 :使用 gemini-2.5-flash 或 gemini-2.5-flash-lite 获得最快响应
Token 限制 :减少单次请求的复杂度
并发请求 :避免同时发送大量请求
测试连接速度 :time gemini --model gemini-2.5-flash "Hello"
推荐使用 PowerShell :
安装 Node.js(从官网下载安装包)
以管理员身份运行 PowerShell
设置环境变量:
[ System.Environment ]::SetEnvironmentVariable( 'GOOGLE_GEMINI_BASE_URL' , 'https://api.apiyi.com' , 'User' )
[ System.Environment ]::SetEnvironmentVariable( 'GEMINI_API_KEY' , 'sk-your-key' , 'User' )
重启 PowerShell
安装和使用 Gemini CLI
或使用 WSL (Windows Subsystem for Linux)获得更好的体验。
最佳实践
提示词优化
明确具体 ❌ “优化这段代码” ✅ “优化这段代码的性能,重点关注循环效率和内存使用”
提供上下文 ❌ “这个函数有什么问题?” ✅ “这是一个用于处理用户登录的函数,目前遇到异步错误,帮我找出问题”
分步骤请求 ❌ “帮我完成整个项目” ✅ “第一步:设计数据库模型;第二步:创建 API 路由;第三步:…”
要求示例 ❌ “解释闭包” ✅ “解释 JavaScript 闭包,并给出 3 个实际应用场景和代码示例”
工作流建议
获取方案
使用 Gemini CLI 生成初步解决方案或代码
审查优化
要求 AI 审查自己生成的代码,找出潜在问题
价格说明
使用 API易 调用 Gemini 模型的费用取决于您选择的模型和使用量。
查看详细价格 查看所有 Gemini 模型的详细定价和性价比对比
API易 提供充值优惠:充值越多,加赠比例越高(10%-22%)。首次充值还可获得额外加赠。查看 充值活动详情 。
相关资源
获取帮助
技术支持 添加微信:8765058 技术咨询、使用指导
快速上手 :按照本文的「快速开始」章节,5 分钟即可完成配置并开始使用 Gemini CLI!