AI 工具配置教程
Gemini CLI配置
获取 API Key 后，按照你的操作系统选择对应步骤完成配置。
步骤 1: 验证是否安装 Node.js
Gemini Cli 基于 Node.js 运行，请先确认已安装 Node.js（建议 LTS 版本）。
打开终端
windows用户（win+R）输入 cmd 回车
分别执行
node -v
npm -v
查看是否有版本号，如果没有显示版本号的可以参考 node 安装教程 进行安装
步骤 2：安装 Gemini CLI
Windows（PowerShell，无需 sudo）
npm install -g @google/gemini-climacOS / Linux / WSL2
sudo npm install -g @google/gemini-cli验证安装：
gemini --version步骤 3：配置环境变量
如果使用CC Switch的可以跳转 CC Switch 配置
将下方变量中的占位符替换为你的实际信息：
YOUR_API_KEY→ 你的 API Key
Windows（PowerShell）
临时生效（仅当前终端会话有效）：
$env:GOOGLE_GEMINI_BASE_URL = "https://token.firstpy.com"
$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GEMINI_MODEL = "gemini-2.5-pro"永久生效（推荐）：
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://token.firstpy.com", "User")
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "YOUR_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", "User")设置后需重新打开终端窗口。
macOS / Linux / WSL2
将以下内容追加到 ~/.bashrc 或 ~/.zshrc：
export GOOGLE_GEMINI_BASE_URL="https://token.firstpy.com"
export GEMINI_API_KEY="YOUR_API_KEY"
export GEMINI_MODEL="gemini-2.5-pro"然后使配置立即生效：
source ~/.bashrc # 或 source ~/.zshrc步骤 4：验证环境变量
Windows
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODELmacOS / Linux / WSL2
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL步骤 5：开始使用
gemini常见问题
Q：环境变量设置后不生效？
重新打开一个终端窗口，或执行 source ~/.bashrc。
Q：Windows 安装时提示权限错误？
以管理员身份运行 PowerShell 后重试。
Q：macOS / Linux 安装时提示权限错误？
命令前加 sudo，或使用 nvm 安装 Node.js（nvm 安装的 npm 无需 sudo）。
Q：提示认证失败或 API Key 无效？
检查 GEMINI_API_KEY 是否正确填写，以及 GOOGLE_GEMINI_BASE_URL 是否包含多余的斜杠或路径。