跳到主要内容

Gemini CLI Windows 使用指南

(一) 安装 Node.js 环境​

Windows 安装方法​

方法一：官网下载（推荐）

  1. 打开浏览器访问 https://nodejs.org/
  2. 点击 "LTS" 版本进行下载（版本号要大于18，推荐长期支持版本）
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs
Windows 注意事项
  • 建议使用 PowerShell 而不是 CMD
  • 如果遇到权限问题，尝试以管理员身份运行
  • 某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功​

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功了！

(二) 安装 Gemini CLI​

安装 Gemini CLI​

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

# 全局安装 Gemini CLI
npm install -g @anthropic-ai/claude-code
提示
  • 建议使用 PowerShell 而不是 CMD，功能更强大
  • 如果遇到权限问题，以管理员身份运行 PowerShell

验证安装​

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

gemini --version

(三) 配置 Gemini CLI​

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

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

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

{
  "CODE_ASSIST_ENDPOINT": "https://bytecatcode.org/",
  "GOOGLE_CLOUD_ACCESS_TOKEN": "你的API密钥",
  "GOOGLE_GENAI_USE_GCA": "true"
}

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

PowerShell 临时设置（当前会话）

$env:CODE_ASSIST_ENDPOINT = "https://bytecatcode.org/"
$env:GOOGLE_CLOUD_ACCESS_TOKEN = "你的API密钥"
$env:GOOGLE_GENAI_USE_GCA = "true"
备注

使用与 Claude Code 相同的 API 密钥即可。

PowerShell 永久设置（用户级）

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("CODE_ASSIST_ENDPOINT", "https://bytecatcode.org/", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_CLOUD_ACCESS_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GENAI_USE_GCA", "true", [System.EnvironmentVariableTarget]::User)

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

验证环境变量​

echo $env:CODE_ASSIST_ENDPOINT
echo $env:GOOGLE_CLOUD_ACCESS_TOKEN
echo $env:GOOGLE_GENAI_USE_GCA

(四) 开始使用 Gemini CLI​

启动 Gemini CLI​

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

gemini

基本使用​

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