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

# Gemini CLI

Gemini CLI 是 Google 官方推出的代理式编程工具，通过本地终端使用，支持 Gemini 3，支持查询和编辑大型代码库，支持从图像或 PDF 生成应用程序，并自动化复杂的工作流程。

开始前需要确保终端已经安装过 [Node.js 18 或更高版本](https://nodejs.org/zh-cn/download/)。

安装完成后，打开终端，执行以下命令安装 Claude Code：

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

安装完成后，运行如下指令配置通过极客智坊模型代理在国内使用 Gemini：

```bash theme={null}
export GOOGLE_GEMINI_BASE_URL="https://geekai.co/api"
export GEMINI_API_KEY="<YOUR_GEEKAI_API_KEY>"
```

> 直接执行 `export` 只能当前会话生效，如果想要永久生效，可以将上述命令添加到 `~/.bashrc` 或 `~/.zshrc` 文件中，然后执行 `source ~/.bashrc` 或 `source ~/.zshrc` 来使更改生效。

记得将 `<YOUR_GEEKAI_API_KEY>` 替换为您的[极客智坊 API 密钥](https://geekai.co/user/api_keys)，如果 Base URL 使用的是海外入口，则需要前往[极客智坊海外版](https://geekai.dev/user/api_keys)获取 API KEY。

对个人开发者而言，API KEY 使用默认均衡配置即可，如果你的项目比较大，或者想要更快地响应速度，可以到 [API Keys](https://geekai.co/user/api_keys) 管理页面通过编辑 KEY 的线路为高可用来实现更快更稳定的响应速度：

![切换极客智坊 API KEY 调度策略](https://static.geekai.co/storage/2025/07/26/image-20250726123753201.png)

如果你对价格敏感，还可以切换到低价线路，但是稳定性会有所下降。

配置完成后保存文件，即可在终端进入项目目录输入 `gemini` 命令来启动 Gemini CLI：

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

![首次使用 Gemini CLI](https://static.geekai.co/storage/2025/11/27/image-20251127141940635.png)

Gemini CLI 不需要做任何配置，当进入正式交互界面后，你就可以直接与 Gemini 进行对话，获取代码建议或解决编程问题：

![通过极客智坊模型代理服务使用 Gemini CLI 进行编码](https://static.geekai.co/storage/2025/11/27/image-20251127142239041.png)

目前 Gemini CLI 默认使用的是 Gemini 2.5 Pro 模型，如果你想要使用最新的 Gemini 3 Pro Preview 模型，可以通过 `/settings` 命令进入设置界面，并开启 Preview features：

```bash theme={null}
/settings
```

![开启 Gemini CLI 使用 Genini 3 Pro Preview](https://static.geekai.co/storage/2025/11/27/image-20251127142600180.png)

该功能默认是关闭的，选中后 Enter 即可开启在 Gemini CLI 中使用 Gemini 3 Pro Preview 模型进行交互，接下来，你还可以通过 `/model` 命令进一步切换不同的 Gemini 模型：

```bash theme={null}
/model
```

![切换 Gemini CLI 使用不同 Gemini 模型](https://static.geekai.co/storage/2025/11/27/image-20251127143601470.png)