Gemini CLI安装步骤与常见错误

在 PowerShell 中使用 npx 安装 google-gemini-cli（详解与常见错误）

逐步说明如何在 Windows PowerShell 中创建目录、处理执行策略限制并使用 npx 安装 github:google-gemini/gemini-cli。包含命令修正与两个备用安装方式。

准备工作

以下示例在 Windows PowerShell 环境下执行。若使用 PowerShell 7（pwsh），命令等效。

步骤

1. 在目标磁盘建立文件夹

   示例：在 D 盘建立 gemini-cli-projects 文件夹并进入该目录。

   D:
   mkdir gemini-cli-projects
   cd gemini-cli-projects

2. 使用命令行运行以下脚本（一次性临时使用，不会将脚本安装到电脑中。）

   npx https://github.com/google-gemini/gemini-cli

   若提示需要安装包，输入 y 确认后回车。

3. 使用命令行运行以下脚本（全局安装） 

   npm install -g @google/gemini-cli

4. 若遇到 PowerShell 脚本被阻止的错误

   错误示例：

   .....cannot be loaded because running scripts is disabled on this system.
   For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.

   解决方案 A（临时，仅当前会话生效，安全）：

   Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

   解决方案 B（永久，仅针对当前用户）：

   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

   说明：方案 A 推荐用于一次性操作；方案 B 适合频繁使用脚本的开发者。

5. 执行时的确认提示示例

   当 npx 检测到需下载并运行远程包时，会提示：

   Need to install the following packages:
   github:google-gemini/gemini-cli
   Ok to proceed? (y)

   输入 y 并回车以继续安装。

6. 登录或授权流程

   若安装或运行流程内部要求授权（例如 login with Google），会弹出浏览器页面进行账号验证。按提示完成即可。