Skip to main content

概述

Gemini CLI 是一个运行在终端里的 AI 助手。 它适合代码分析、文件处理、调研和命令行协作。

推荐接入方式

Gemini CLI 的常规登录流程主要面向 Google 登录、Gemini API Key 或 Vertex AI。 如果你要接入 HubTo,建议使用 hubtoai 自动写入 Gemini CLI 所需的本地配置。 完整用法请参见 通过 CLI 快速使用 HubTo

安装

你可以使用 npm 全局安装:
也可以直接通过 npx 运行:

通过 hubtoai 配置

不安装,直接运行:
如果你已经全局安装 hubtoai,也可以运行:
完成浏览器登录后,重启 Gemini CLI,让新配置生效。

基本用法

安装并认证后,直接运行:
你可以让它解释文件、分析代码、生成内容,或者在终端里处理多步骤任务。

使用建议

  • 优先通过 hubtoai 配置,避免手动维护环境变量
  • 如果你同时使用 Claude Code、Codex 或 OpenCode,可以在同一次 hubtoai login 中选择多个目标
  • 配置后先运行一个小任务,确认 Gemini CLI 可以正常返回

常见问题

配置后没有生效

请重启 Gemini CLI,并运行:
确认 gemini 已显示为 configured。

需要排查链路

运行:
确认 HubTo 登录、模型接口和本地配置都正常。

下一步