docs

Windows 配置

在 Windows 上配置 Gemini CLI

ziyang

— 2 min read

Windows 配置指南

1. 打开配置目录

这是最快捷的方法，无需通过命令行寻找路径。

  1. 按下键盘上的 Win + R 键打开“运行”窗口。
  2. 输入以下内容并回车：
%userprofile%\.gemini

如果系统提示“找不到文件”或文件夹不存在，请先在一个任意位置打开 PowerShell 并运行 `mkdir ~/.gemini` 创建目录，或者手动在用户文件夹下新建 `.gemini` 文件夹。

2. 创建配置文件

在打开的文件夹中：

  1. 新建一个文本文件。
  2. 将其重命名为 .env（注意前面有点，且没有 .txt 后缀）。
  3. 使用记事本或你喜欢的编辑器打开它，写入以下内容：

选择访问线路

我们提供两个访问线路，请根据你的网络环境选择其中一个：

<Tabs items={['海外直连（推荐）', '国内线路（备用）']}>

适用于：大部分用户首选，通过 CF Tunnel 国内通常可直连，若不通可挂代理

# 这里的 Key 需要是在网站里面创建的 Key
GEMINI_API_KEY=your_api_key_here

# 中转服务地址（海外直连）
GOOGLE_GEMINI_BASE_URL=https://api.aicodewith.com/gemini_cli

# 模型名称，请从下方的支持列表中选择
GEMINI_MODEL=gemini-2.5-pro

适用于：海外直连不通且代理也不行时使用（链路较长：深圳→香港→日本）

# 这里的 Key 需要是在网站里面创建的 Key
GEMINI_API_KEY=your_api_key_here

# 中转服务地址（国内线路）
GOOGLE_GEMINI_BASE_URL=https://api.jiuwanliguoxue.com/gemini_cli

# 模型名称，请从下方的支持列表中选择
GEMINI_MODEL=gemini-2.5-pro

不确定选择哪个线路？查看 [线路选择指南](/docs/route-selection) 了解详情。

支持的模型列表

系列 模型名称 说明
Pro 3 gemini-3-pro-high 深度思考模式
gemini-3-pro-low 快速思考模式
Pro 2.5 gemini-2.5-pro 标准版本，平衡性能
gemini-2.5-pro-thinking 带推理过程输出
gemini-2.5-pro-nothinking 不显示推理过程
Flash 2.5 gemini-2.5-flash 快速响应版本
gemini-2.5-flash-thinking 带推理过程输出
gemini-2.5-flash-nothinking 不显示推理过程
gemini-2.5-flash-lite 极速轻量版本

3. 创建 settings.json 文件

在同样的 ~/.gemini 文件夹中：

  1. 新建一个文本文件。
  2. 将其重命名为 settings.json（注意没有 .txt 后缀）。
  3. 使用记事本或你喜欢的编辑器打开它，写入以下内容：
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

4. 验证配置

打开 PowerShell 或 CMD，输入以下命令：

gemini

如果看到交互界面并能正常回复，即表示配置成功！

Read more