> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Gemini CLI 中使用

> 通过 hubtoai 将 HubTo 配置到 Gemini CLI，统一管理本地终端助手的认证与网关地址。

## 概述

Gemini CLI 是一个运行在终端里的 AI 助手。

它适合代码分析、文件处理、调研和命令行协作。

## 推荐接入方式

Gemini CLI 的常规登录流程主要面向 Google 登录、Gemini API Key 或 Vertex AI。

如果你要接入 HubTo，建议使用 `hubtoai` 自动写入 Gemini CLI 所需的本地配置。

完整用法请参见 [通过 CLI 快速使用 HubTo](/cn/usercases/hubto-cli)。

## 安装

你可以使用 `npm` 全局安装：

```bash theme={null}
npm install -g @google/gemini-cli
```

也可以直接通过 `npx` 运行：

```bash theme={null}
npx @google/gemini-cli
```

## 通过 hubtoai 配置

不安装，直接运行：

```bash theme={null}
npx hubtoai@latest login --target gemini
```

如果你已经全局安装 `hubtoai`，也可以运行：

```bash theme={null}
hubtoai login --target gemini
```

完成浏览器登录后，重启 Gemini CLI，让新配置生效。

## 基本用法

安装并认证后，直接运行：

```bash theme={null}
gemini
```

你可以让它解释文件、分析代码、生成内容，或者在终端里处理多步骤任务。

## 使用建议

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

## 常见问题

### 配置后没有生效

请重启 Gemini CLI，并运行：

```bash theme={null}
hubtoai status
```

确认 `gemini` 已显示为 configured。

### 需要排查链路

运行：

```bash theme={null}
hubtoai doctor
```

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

## 下一步

* 查看 hubtoai 用法：参见 [通过 CLI 快速使用 HubTo](/cn/usercases/hubto-cli)
* 获取 API Key：参见 [快速上手](/cn/quickstart)