在 Windows 11 装好 Gemini CLInpx 试跑还是全局装完整安装指南【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cliGemini CLI 把 Gemini 模型直接搬进终端你能用它问代码、改文件、跑 shell 命令。本文只讲 Windows 11 上的安装和使用读完后你能在 PowerShell 里敲起 gemini完成认证并跑通第一个任务。先说一条高频报错打开 PowerShell 敲下 gemini回你一句gemini: The term gemini is not recognized九成是装法选错了或者装完没重开终端。下面按最省事的路径走一遍。一分钟跑起来最省事的是全局安装一条命令npm install -g google/gemini-cli它把包装进 npm 全局目录并注册 gemini 命令装完开新终端就能直接敲。注意官方要求 Windows 11 24H2 和 Node.js 20.0.0不达标会跑不起来。装好后执行gemini它启动交互式会话首次会让你选认证方式个人 Google 账户或 API key。两种安装姿势怎么选对比项npx 快速跑npm 全局安装命令npx google/gemini-clinpm install -g google/gemini-cli适合谁只想试一次、看看效果每天在项目里用它干活命令生命周期关掉终端就失效所有终端长期可用是否写入 PATH否是取舍零安装但每次启动要重新拉包多一步安装换来随时可用一句话先 npx 试水顺手了再全局装。Windows 11 专属注意点系统版本官方推荐 Windows 11 24H2老版本容易出终端渲染问题。终端选择PowerShell 即可Windows Terminal 或 PowerShell 7 的渲染和配色更好。PATH 不自动刷新安装或改过环境变量后必须重开终端窗口老窗口里白敲。凭据和配置位置API key 用 PowerShell 环境变量设置持久化可写到%USERPROFILE%\.gemini\.env配置含主题在%USERPROFILE%\.gemini\settings.json项目级配置放在项目根目录的.gemini\settings.json。命令不识别三步定位现象装完执行 gemini提示gemini: The term gemini is not recognized。原因要么你只是用 npx 临时跑、压根没全局装要么 npm 全局路径不在系统 PATH 里。解决npm config get prefix它打印 npm 全局安装的前缀目录。确认这个路径在系统 PATH 中不在就手动加上然后重开终端再试。认证没生效现象gemini 能启动却停在认证界面或提示没有可用 key。原因环境变量只在当前 PowerShell 窗口有效开了新窗口就丢了。解决在要用的窗口里重新设置$env:GEMINI_API_KEYYOUR_GEMINI_API_KEY再执行 gemini选 Use Gemini API key 即可继续。装完怎么验证随手跑两条gemini --version能打印版本号说明装好了。gemini --help它列出全部命令和参数后面用不熟时随时回来查。版本能打印、PATH 不再报错剩下的就是开新终端跑 gemini把第一个任务丢给它。【免费下载链接】gemini-cliAn open-source AI agent that brings the power of Gemini directly into your terminal.项目地址: https://gitcode.com/GitHub_Trending/gemi/gemini-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考