Skip to content

Gemini CLI配置教程 ​

安装并配置 Gemini CLI 工具,连接 Coding Flow 平台。

Gemini CLI 是 Google 官方提供的终端 AI 助手工具。本教程将引导你完成安装和配置。

开始前请先完成 Node.js 环境安装教程。

你需要准备

  • 一个可用的 API Key(形如:sk-******)
  • 一个可访问的 服务地址(Base URL)(通常由部署方/网关提供)

本站通用服务地址

第一步:安装 Gemini CLI ​

Windows
npm install -g @google/gemini-cli
Linux
sudo npm install -g @google/gemini-cli
macOS(npm)
sudo npm install -g @google/gemini-cli
macOS(Homebrew)
brew install gemini-cli

验证安装

安装完成后,输入以下命令检查,如果显示版本号,说明安装成功了!

Bash
gemini --version

第二步:创建配置文件 ​

设置环境变量让 Gemini CLI 连接到 Coding Flow 平台。需要设置三个变量:

  • GOOGLE_GEMINI_BASE_URL — 服务地址
  • GEMINI_API_KEY — 你的 API Key
  • GEMINI_MODEL — 使用的模型

临时设置(当前会话) ​

Windows
$env:GOOGLE_GEMINI_BASE_URL = "https://api.codingflow.ai"
$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GEMINI_MODEL = "gemini-3-pro-preview"
Linux
export GOOGLE_GEMINI_BASE_URL="https://api.codingflow.ai"
export GEMINI_API_KEY="YOUR_API_KEY"
export GEMINI_MODEL="gemini-3-pro-preview"
macOS
export GOOGLE_GEMINI_BASE_URL="https://api.codingflow.ai"
export GEMINI_API_KEY="YOUR_API_KEY"
export GEMINI_MODEL="gemini-3-pro-preview"

永久设置 ​

Windows
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.codingflow.ai", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "YOUR_API_KEY", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [System.EnvironmentVariableTarget]::User)
Linux
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.codingflow.ai"' >> ~/.bashrc
echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.bashrc
echo 'export GEMINI_MODEL="gemini-3-pro-preview"' >> ~/.bashrc
source ~/.bashrc
macOS
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.codingflow.ai"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
echo 'export GEMINI_MODEL="gemini-3-pro-preview"' >> ~/.zshrc
source ~/.zshrc

重要提示

请将 YOUR_API_KEY 替换为在 Coding Flow平台 申请的 API Key。

以上配置参数说明

  • GOOGLE_GEMINI_BASE_URL: 模型提供者的 API 地址,固定设置为 https://api.codingflow.ai/v1。
  • GEMINI_API_KEY: 认证密钥,此处为 YOUR_API_KEY。
  • GEMINI_MODEL: 模型名称。

第三步:开始使用 ​

Bash
gemini