Windows 配置指南

1. 打开配置目录

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

按下键盘上的 Win + R 键打开“运行”窗口。
输入以下内容并回车：

%userprofile%\.gemini

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

2. 创建配置文件

在打开的文件夹中：

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

选择访问线路

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

适用于：大部分国内用户，无需代理

# 这里的 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

适用于：国内直连不稳定时使用，需要自己挂代理

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

# 中转服务地址（CF 加速）
GOOGLE_GEMINI_BASE_URL=https://api.aicodewith.com/gemini_cli

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

不确定选择哪个线路？查看线路选择指南了解详情。

支持的模型列表

系列	模型名称	说明
Pro 3	`gemini-3-pro-high`	深度思考模式
Pro 3	`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 文件夹中：

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

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

4. 验证配置

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

gemini

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

Windows 配置