Gemini怎么在Windows上配置环境变量？API密钥设置教程【介绍】

配置Gemini CLI在Windows上调用API这事儿，说白了就是得把两个核心的环境变量伺候好——服务地址和密钥，缺一不可。稍微哪个没到位，你运行任何命令，系统要么直接“温馨”提示你“API key not found”，要么冷冰冰地甩一句“connection refused”。所以，动手前先心里有数：这事儿还真得较真。

先确认基石：Node.js与Gemini CLI已到位

打开PowerShell（普通用户身份运行就行，不用非得管理员），先跑两个命令探探路：

node --version——如果返回的是v18.x或v20.x，那说明Node.js这块儿没问题；

gemini --version——要是系统提示“command not found”，那就别往下走了，说明Gemini CLI还没全局装好，或者PATH环境变量没配置。先回退，执行 npm install -g @google/gemini-cli 并把路径整利索。

密钥是通行证：获取并认真核实

访问UniVibe控制台或letaicode.cn，进入「API密钥」页面，点“创建新密钥”，复制那串格式为sk-开头、至少32位的字符串。

这一步是绝对不能省的——Gemini CLI自己不会检查密钥格式对不对，错误的密钥只会默不作声地潜伏，等你执行命令时才暴露。所以，复制完最好再瞄一眼。

设置环境变量：让系统记住你的密钥

这里给两种方案，习惯命令行的用第一种，喜欢图形界面的用第二种。

在PowerShell里逐行执行：

$env:GOOGLE_GEMINI_BASE_URL = "https://letaicode.cn/gemini"

$env:GEMINI_API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

然后，要把这两个变量“刻”进系统里，继续执行：

[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", $env:GOOGLE_GEMINI_BASE_URL, "User")

[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", $env:GEMINI_API_KEY, "User")

完成后，关掉当前PowerShell窗口，重新打开一个全新的。跑两个命令验证一下：

echo $env:GEMINI_API_KEY——应该直接显示你设置的密钥（不带引号）；

echo $env:GOOGLE_GEMINI_BASE_URL——应该返回 https://letaicode.cn/gemini。

右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。在“用户变量”区域，点击“新建”，分别添加这两个变量：

• 变量名：GOOGLE_GEMINI_BASE_URL，变量值：https://letaicode.cn/gemini
• 变量名：GEMINI_API_KEY，变量值：粘贴你的sk-密钥

全部点“确定”保存。

最后一步：检验成果

在全新打开的PowerShell里，依次执行：

gemini config get apiKey——如果看到你密钥的前8位加上星号（比如 sk-abcde***），说明配置已被Gemini CLI成功识别；

gemini chat "hi"——要是AI直接回复你了，恭喜，三个核心要素（环境变量、网络通路、密钥）全部就绪，就可以开始愉快地玩耍了。