---
title: Gemini CLI 使用教程
sidebarTitle: Gemini CLI
description: 安装 Gemini CLI，配置无限星河AI Gemini 地址、API Key 和模型并完成终端验证。
---

Gemini CLI 是 Google 推出的终端 AI 编程工具，可以读取项目、修改文件和运行命令。它需要使用 Gemini 类型的模型。

## 安装 Gemini CLI

先安装 Node.js 20 或更高版本，再执行：

```bash
npm install -g @google/gemini-cli
```

## 配置模型

Windows PowerShell：

```powershell
$env:GEMINI_API_KEY = "你的_API_Key"
$env:GOOGLE_GEMINI_BASE_URL = "https://infistar.cc"
$env:GEMINI_API_KEY_AUTH_MECHANISM = "bearer"
$env:GEMINI_MODEL = "模型广场中的Gemini模型ID"
gemini
```

macOS 或 Linux：

```bash
export GEMINI_API_KEY="你的_API_Key"
export GOOGLE_GEMINI_BASE_URL="https://infistar.cc"
export GEMINI_API_KEY_AUTH_MECHANISM="bearer"
export GEMINI_MODEL="模型广场中的Gemini模型ID"
gemini
```

API 地址不要添加 `/v1` 或 `/v1beta`。

## 开始使用

第一次出现登录方式时，选择 **Gemini API Key**。然后输入：

```text
请只回复“配置成功”，不要读取或修改文件，也不要运行命令。
```

![Gemini CLI 终端界面](/images/tutorials/gemini-cli/gemini-cli-terminal.png)

## 保存配置

测试成功后，可以把下面内容保存到 `~/.gemini/.env`：

```dotenv
GEMINI_API_KEY=你的_API_Key
GOOGLE_GEMINI_BASE_URL=https://infistar.cc
GEMINI_API_KEY_AUTH_MECHANISM=bearer
GEMINI_MODEL=模型广场中的Gemini模型ID
```

不要把这个文件上传到 Git。

## 遇到问题

- **提示 401**：确认存在 `GEMINI_API_KEY_AUTH_MECHANISM=bearer`。
- **提示 404**：API 地址只填写 `https://infistar.cc`。
- **要求登录 Google**：重新启动并选择 **Gemini API Key**。
- **模型不可用**：选择模型广场中可用的 Gemini 原始模型 ID。