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-cliLinux
sudo npm install -g @google/gemini-climacOS(npm)
sudo npm install -g @google/gemini-climacOS(Homebrew)
brew install gemini-cli验证安装
安装完成后,输入以下命令检查,如果显示版本号,说明安装成功了!
Bash
gemini --version第二步:创建配置文件
设置环境变量让 Gemini CLI 连接到 Coding Flow 平台。需要设置三个变量:
GOOGLE_GEMINI_BASE_URL— 服务地址GEMINI_API_KEY— 你的 API KeyGEMINI_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 ~/.bashrcmacOS
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