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 chat时才给你好看。】
这一步是绝对不能省的——Gemini CLI自己不会检查密钥格式对不对,错误的密钥只会默不作声地潜伏,等你执行命令时才暴露。所以,复制完最好再瞄一眼。
设置环境变量:让系统记住你的密钥
这里给两种方案,习惯命令行的用第一种,喜欢图形界面的用第二种。
方法一:PowerShell命令行写入(推荐,一劳永逸)
在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直接回复你了,恭喜,三个核心要素(环境变量、网络通路、密钥)全部就绪,就可以开始愉快地玩耍了。