Gemini CLI 配置教程
安装并配置 Gemini CLI 工具,连接 Forest API 平台使用 Gemini 模型。
Gemini CLI 是 Google 官方命令行工具,可在终端中直接使用 Gemini 模型进行 AI 编程辅助。本教程将引导你完成安装和配置。
开始前请先完成 Node.js 环境安装教程。
开始前请先完成 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 会启动交互式会话,你可以直接输入问题或代码相关的请求。