Documentation Index
Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt
Use this file to discover all available pages before exploring further.
一、产品简介
Gemini CLI 是 Google 官方推出的命令行 AI 编程工具,允许你在终端中直接与 Gemini 系列模型交互。通过 GravitexAI 中转后,你可以:终端直接调用
在终端中快速调用 Gemini 3.5 / 3.1 / 2.5 等模型
AI 辅助编程
代码生成、代码审查、单元测试自动化
智能问答
技术问题解答、架构设计、错误排查
文档生成
README、API 文档、JSDoc 注释自动生成
通过 GravitexAI 中转后,你可以享受国内优化网络、统一的 API Key 管理,以及与 Claude、GPT 等模型的一站式聚合接入。
二、前置要求
- Node.js ≥ 18.0.0
- npm 或 yarn 包管理器
- 在 GravitexAI 控制台 获取的 API Key(格式如
sk-xxxxxxxxxx)
三、快速开始
第一步:安装 Gemini CLI
第二步:获取 GravitexAI API Key
登录 GravitexAI 控制台
访问 maas.gravitex.ai 注册或登录账号。
创建 API Key
进入「密钥管理」页面,点击「创建新令牌」。
第三步:配置环境变量
- Zsh (macOS / Linux)
- Bash (Linux)
- PowerShell (Windows)
- CMD (Windows)
第四步:初始化与测试
四、推荐模型(经 GravitexAI 使用)
GravitexAI 已对接最新的 Gemini 全系列模型,可在 CLI 中直接调用:Gemini 3.x 系列(推荐)
| 模型 ID | 适用场景 | 特点 |
|---|---|---|
| gemini-3.5-flash ⭐ | 高吞吐对话、低延迟工具调用 | 最新快速版本,速度最优 |
| gemini-3.1-pro-preview | 复杂推理、高质量代码生成 | 新一代核心智能模型 |
| gemini-3.1-flash-lite-preview | 高并发批量任务 | 高性价比快速版本 |
| gemini-3.1-flash-image-preview | 图像理解 / 文生图 | 多模态增强版本 |
| gemini-3-pro-image-preview | 高质量文生图 | 图像能力强化版本 |
| gemini-3-flash-preview | 多轮对话、工具调用 | 平衡速度与质量 |
推荐配置:
- 复杂编程任务、架构设计:gemini-3.1-pro-preview
- 日常代码生成、问答:gemini-3.5-flash
- 批量处理、快速迭代:gemini-3.1-flash-lite-preview
五、核心功能
1. 代码生成
- 函数生成
- 项目脚手架
- 单元测试
2. 代码审查
3. 技术问答
4. 文档生成
六、交互式命令
在 Gemini CLI 交互模式下,可使用以下指令:| 命令 | 说明 | 示例 |
|---|---|---|
/auth | 重新认证 | /auth |
/model | 切换模型 | /model gemini-3.1-pro-preview |
/clear | 清除对话历史 | /clear |
/help | 显示帮助信息 | /help |
/exit | 退出 CLI | /exit 或 Ctrl+C |
/save | 保存对话到文件 | /save conversation.txt |
七、高级用法
1. GitHub Actions 集成(自动化代码审查)
2. 批处理脚本
八、常见问题
连接失败或认证错误?
连接失败或认证错误?
检查清单:
-
环境变量是否正确:
确保输出为:
GOOGLE_GEMINI_BASE_URL:https://api.gravitex.ai(不要带/v1或其他路径)GEMINI_API_KEY: 以sk-开头的完整密钥
-
重新加载环境变量:
- 重启终端:完全关闭并重新打开终端窗口。
- 验证 API Key:登录 GravitexAI 控制台 确认 Key 是否有效且余额充足。
如何切换不同的 Gemini 模型?
如何切换不同的 Gemini 模型?
方式一:交互模式下使用 方式二:命令行直接指定
/model 命令如何保存对话历史?
如何保存对话历史?
方法一:使用 方法二:重定向输出
/save 命令Node.js 版本不满足要求怎么办?
Node.js 版本不满足要求怎么办?
推荐使用 nvm 管理 Node.js 版本:
为什么响应速度慢?
为什么响应速度慢?
可能原因和解决方案:
- 网络问题:GravitexAI 提供国内优化节点,正常情况下响应较快。可在 GravitexAI 控制台 查看实时状态。
- 模型选择:使用
gemini-3.5-flash或gemini-3.1-flash-lite-preview可获得更快响应。 - Token 限制:减少单次请求的复杂度和上下文长度。
如何在 Windows 上使用?
如何在 Windows 上使用?
推荐使用 PowerShell:
- 从 Node.js 官网 下载并安装 Node.js
- 以管理员身份打开 PowerShell
- 设置环境变量:
- 重启 PowerShell
- 运行
npm install -g @google/gemini-cli安装
九、最佳实践
提示词优化
明确具体
❌ “优化这段代码”✅ “优化这段代码的性能,重点关注循环效率和内存使用”
提供上下文
❌ “这个函数有什么问题?”✅ “这是一个处理用户登录的函数,当前遇到异步错误,帮我找出问题”
分步骤请求
❌ “帮我完成整个项目”✅ “第一步:设计数据库模型;第二步:创建 API 路由;第三步:…”
要求示例
❌ “解释闭包”✅ “解释 JavaScript 闭包,并给出 3 个实际应用场景和代码示例”
推荐工作流
十、参考链接
- Gemini CLI 官方文档:https://ai.google.dev/gemini-api/docs/cli
- GravitexAI 控制台:https://maas.gravitex.ai
- 模型广场:https://maas.gravitex.ai/#/models
- 快速开始:/cn/quickstart