概述
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
第二步:获取 API易 密钥
1
注册/登录 API易
访问
api.apiyi.com 注册或登录您的账号2
创建 API Key
进入后台「令牌管理」页面(
api.apiyi.com/token),点击「创建新令牌」3
复制密钥
复制生成的 API Key(格式:
sk-***),妥善保存第三步:配置环境变量
- Zsh (macOS/Linux)
- Bash (Linux)
- PowerShell (Windows)
- CMD (Windows)
第四步:初始化和测试
1
启动 Gemini CLI
2
首次认证
在交互界面中输入:选择:Gemini API Key (AI Studio)
3
测试连接
核心功能
代码生成
- 函数生成
- 完整项目脚手架
- 单元测试
代码审查
技术问答
文档生成
交互式命令
在 Gemini CLI 交互模式下,可以使用以下命令:| 命令 | 说明 | 示例 |
|---|---|---|
/auth | 重新认证 | /auth |
/model | 切换模型 | /model gemini-pro |
/clear | 清除对话历史 | /clear |
/help | 显示帮助信息 | /help |
/exit | 退出 CLI | /exit 或 Ctrl+C |
/save | 保存对话到文件 | /save conversation.txt |
支持的模型
通过 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 扩展:GitHub Actions 集成
自动化代码审查:批处理脚本
创建自动化脚本:常见问题
连接失败或认证错误?
连接失败或认证错误?
检查清单:
-
环境变量是否正确:
确保输出为:
GOOGLE_GEMINI_BASE_URL:https://api.apiyi.com(不要有 /v1 或其他路径)GEMINI_API_KEY:sk-开头的完整密钥
-
重新加载环境变量:
- 重启终端:完全关闭并重新打开终端窗口
- 验证 API Key:登录 API易 后台确认 Key 是否有效且余额充足
如何切换不同的 Gemini 模型?
如何切换不同的 Gemini 模型?
在交互模式下使用 或在命令行直接指定:
/model 命令:如何保存对话历史?
如何保存对话历史?
方法一:使用 方法二:重定向输出方法三:使用会话管理
/save 命令Node.js 版本不满足要求怎么办?
Node.js 版本不满足要求怎么办?
推荐使用 nvm 管理 Node.js 版本:
为什么响应速度慢?
为什么响应速度慢?
可能原因和解决方案:
- 网络问题:API易 提供国内优化节点,通常响应很快
- 模型选择:使用
gemini-2.5-flash或gemini-2.5-flash-lite获得最快响应 - Token 限制:减少单次请求的复杂度
- 并发请求:避免同时发送大量请求
如何在 Windows 上使用?
如何在 Windows 上使用?
推荐使用 PowerShell:
- 安装 Node.js(从官网下载安装包)
- 以管理员身份运行 PowerShell
- 设置环境变量:
- 重启 PowerShell
- 安装和使用 Gemini CLI
最佳实践
提示词优化
明确具体
❌ “优化这段代码”✅ “优化这段代码的性能,重点关注循环效率和内存使用”
提供上下文
❌ “这个函数有什么问题?”✅ “这是一个用于处理用户登录的函数,目前遇到异步错误,帮我找出问题”
分步骤请求
❌ “帮我完成整个项目”✅ “第一步:设计数据库模型;第二步:创建 API 路由;第三步:…”
要求示例
❌ “解释闭包”✅ “解释 JavaScript 闭包,并给出 3 个实际应用场景和代码示例”
工作流建议
1
问题定义
清晰描述要解决的问题或实现的功能
2
获取方案
使用 Gemini CLI 生成初步解决方案或代码
3
审查优化
要求 AI 审查自己生成的代码,找出潜在问题
4
迭代改进
根据反馈逐步优化,直到满足需求
5
文档补充
生成必要的注释和文档
价格说明
使用 API易 调用 Gemini 模型的费用取决于您选择的模型和使用量。查看详细价格
查看所有 Gemini 模型的详细定价和性价比对比
API易 提供充值优惠:充值越多,加赠比例越高(10%-22%)。首次充值还可获得额外加赠。查看 充值活动详情。
相关资源
获取帮助
技术支持
添加微信:8765058技术咨询、使用指导
邮件咨询
客服邮箱:[email protected]商务合作:[email protected]