Gemini Cli （Google）配置安装

Claude Code 是 Anthropic 官方 CLI 工具，强大的 AI 编程助手。本教程将引导你完成安装和配置。

开始前请先完成 [Node.js 环境安装教程](http://chintao.cn:10086/doc/1/)。

### 第一步：安装 Gemini Cli

打开终端（Windows 使用 PowerShell 或 CMD），运行以下命令：

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

这个命令会从 npm 官方仓库下载并安装最新版本的 Gemini CLI。

> 如果在 macOS / Linux 上遇到权限问题，可以使用 sudo：
 ```
sudo npm install -g @google/gemini-cli
 ```

#### 验证安装

安装完成后，输入以下命令检查是否安装成功：

```
gemini --version
```

如果显示版本号，恭喜你！Gemini 已经成功安装了。

### 第二步：设置环境变量

为了让 Gemini 连接到 Chintao 中转服务，需要设置两个环境变量：

*   `GOOGLE_GEMINI_BASE_URL` — API 网关地址
*   `GEMINI_API_KEY` — 你的 API Key

#### 临时设置（当前会话）

Windows

```
$env:GOOGLE_GEMINI_BASE_URL = "https://www.chintao.cn"
$env:GEMINI_API_KEY = "YOUR_API_KEY"
```

Mac/Linux

```
export GOOGLE_GEMINI_BASE_URL="https://www.chintao.cn"
export GEMINI_API_KEY="YOUR_API_KEY"
```

#### 永久设置

Windows方法1：环境变量

```
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://www.chintao.cn", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "YOUR_API_KEY", [System.EnvironmentVariableTarget]::User)
```
Windows方法2：独立配置文件【推荐】
配置位置：```C:\Users\{你的用户名}\.gemini\.env```

```
GOOGLE_GEMINI_BASE_URL=https://www.chintao.cn
GEMINI_API_KEY=粘贴为你的API密钥
GEMINI_MODEL=gemini-3-pro-preview
```

```C:\Users\{你的用户名}\.gemini\settings.json```

```
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
```

Mac方法1：zsh

```
echo 'export GOOGLE_GEMINI_BASE_URL="https://www.chintao.cn"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc
```

Mac方法2：独立配置文件【推荐】
配置位置：`~/.gemini/.env` 或 `.gemini/.env`
```.env
GOOGLE_GEMINI_BASE_URL=https://www.chintao.cn
GEMINI_API_KEY=粘贴为你的API密钥
GEMINI_MODEL=gemini-3-pro-preview
```

```~/.gemini/settings.json
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
```

> 请将 `YOUR_API_KEY` 替换为在 [控制台](http://chintao.cn/console/token) 页面中复制的任意 API Key。

### 第三步：开始使用

现在你可以开始使用 Gemini了！

```
gemini
```

启动后，Gemini 会分析当前目录的代码，并提供智能编程辅助。

更多使用说明请参考 [Anthropic 官方文档](https://docs.anthropic.com/claude/docs)。