跳到主要内容

Gemini CLI Windows 使用指南

推荐

建议使用 CC-Switch 可视化管理工具进行配置，无需手动编辑配置文件，一键完成 ByteCatCode 接入。

前置准备

请先完成 Node.js 环境安装，再继续以下步骤。

一、安装 Gemini CLI​

打开 PowerShell 或 CMD，运行以下命令：

npm i -g @google/gemini-cli@latest
提示
  • 建议使用 PowerShell 而不是 CMD，功能更强大
  • 如果遇到权限问题，以管理员身份运行 PowerShell

验证安装​

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

gemini --version

二、配置 Gemini CLI​

方法一（推荐）：通过文件设置​

编辑文件 ~/.gemini/settings.json 文件添加以下内容（如果没有该文件，请自行创建）：

Windows 下路径为： C:/Users/你的用户名/.gemini

{
  "GEMINI_API_KEY": "你的API密钥",
  "GOOGLE_GEMINI_BASE_URL": "https://bytecat.lamclod.cn/"
}
备选地址

如首选地址不可用，可替换为以下备选地址（注意保留尾斜杠）：

  • https://codecdn.bytecatcode.org/（国内可直连）
  • https://www.bytecatcode.org/（优选CF，可直连，也可挂代理）
  • https://code.bytecatcode.org/（需挂代理访问）

方法二：通过环境变量设置​

PowerShell 临时设置（当前会话）

$env:GEMINI_API_KEY = "你的API密钥"
$env:GOOGLE_GEMINI_BASE_URL = "https://bytecat.lamclod.cn/"
备注

使用 ByteCatCode 提供的对应API分组的令牌即可。

PowerShell 永久设置（用户级）

[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://bytecat.lamclod.cn/", [System.EnvironmentVariableTarget]::User)

设置后需要重新打开 PowerShell 窗口才能生效。

验证环境变量​

echo $env:GEMINI_API_KEY
echo $env:GOOGLE_GEMINI_BASE_URL

三、开始使用 Gemini CLI​

启动 Gemini CLI​

配置完成后，在 PowerShell 中输入以下命令启动：

gemini

基本使用​

  • 交互模式：直接输入 gemini 进入交互式对话
  • 指定项目：在项目目录下运行 gemini，会自动识别项目上下文
  • 退出程序：输入 exit 或按 Ctrl+C 退出