国内使用 Gemini CLI 常见登录授权失败：安装与排错指南

Gemini CLI在国内用起来总爱闹脾气，登录授权失败就像家门口的快递柜突然抽风，明明密码输对了，死活不给开箱。这玩意儿在国外跑得欢，到了咱这儿水土不服，问题多半出在网络环境和配置环节。

有人刚装好就卡在登录环节，命令行里蹦出个"403 forbidden"，活像被门卫大爷拦在小区外头。八成是网络抽风，试试换个梯子节点，香港新加坡的线路通常比较稳。别用那些免费通道，跟早高峰挤地铁似的，谁都走不动道。

配置文件藏着不少坑。那个藏在用户目录下的.gemini文件夹，有时候权限设得跟防贼似的，自家程序都读不了。右键属性把读写权限勾上，跟给自家孩子发零花钱似的痛快点儿。API密钥填错位更是常见，明明复制了二十个字符，粘贴完只剩十九个，跟冬天晒被子突然少只袜子似的邪门。

环境变量没配置好比忘带钥匙还闹心。系统变量里得添上GEMINI_API_KEY这条，Windows用户容易在用户变量和系统变量之间犯迷糊，就跟分不清生抽老抽似的。Mac和Linux用户也别偷懒，.bashrc或者.zshrc里不加export，重启终端立马现原形。

遇到报错先看日志，Gemini CLI的报错信息比老中医的把脉还准。连着-v参数运行，能把网络请求的底裤都扒出来。有时候错误码EL401不是真没权限，是服务器那边在维护，跟早餐铺子突然歇业两天一个道理。