Docs 快速开始

Gemini CLI 配置教程

安装并配置 Gemini CLI 工具,连接 Forest API 平台使用 Gemini 模型。

Gemini CLI 是 Google 官方命令行工具,可在终端中直接使用 Gemini 模型进行 AI 编程辅助。本教程将引导你完成安装和配置。
开始前请先完成 Node.js 环境安装教程

第一步:安装 Gemini CLI

打开终端(Windows 使用 PowerShell 或 CMD),运行以下命令:

npm install -g @google/gemini-cli

如果在 macOS / Linux 上遇到权限问题,可以使用 sudo:

sudo npm install -g @google/gemini-cli

验证安装

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

gemini --version

如果显示版本号,说明 Gemini CLI 已经成功安装。

第二步:设置环境变量

为了让 Gemini CLI 连接到 Forest API 平台,需要设置以下环境变量:

GEMINI_API_KEY — 你的 API Key
GEMINI_BASE_URL — 服务地址(可选,部分版本支持)

临时设置(当前会话)

Windows (PowerShell):

$env:GEMINI_API_KEY = "YOUR_API_KEY"

macOS / Linux:

export GEMINI_API_KEY="YOUR_API_KEY"

永久设置

Windows (PowerShell):

[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "YOUR_API_KEY", [System.EnvironmentVariableTarget]::User)

macOS (zsh):

echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc source ~/.zshrc

Linux (bash):

echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.bashrc source ~/.bashrc

请将 YOUR_API_KEY 替换为在 控制台 页面中复制的 API Key。

第三步:配置 API 地址

Gemini CLI 支持通过配置文件指定自定义 API 地址。在项目根目录或 home 目录创建 ~/.gemini/config.json

{ "apiKey": "YOUR_API_KEY", "baseUrl": "https://forestapi.com" }

请将 YOUR_API_KEY 替换为你的实际 API Key。

第四步:开始使用

配置完成后,在任意项目目录运行:

gemini

Gemini CLI 会启动交互式会话,你可以直接输入问题或代码相关的请求。