gemini-cli

环境要求

• Node.js 与 npm 环境（使用 npx / npm 安装方式时需要）
• macOS 或 Linux 系统（使用 Homebrew 安装时需要）
• macOS 系统（使用 MacPorts 安装时需要）
• 受限环境可选择 Anaconda 环境，在其中通过 npm 安装
• 个人 Google 账号（可享受免费额度，具体认证方式见官方文档）

安装与启动步骤

1. 1免安装快速试用

   不安装任何依赖，直接用 npx 拉取并运行 Gemini CLI，适合先体验功能。

   npx @google/gemini-cli

   复制

2. 2npm 全局安装

   适合已装好 Node.js/npm 的用户，全局安装后可在任意目录调用 gemini 命令。

   npm install -g @google/gemini-cli

   复制

3. 3Homebrew 安装

   macOS 或 Linux 用户可用 Homebrew 安装，命令由官方 README 直接给出。

   brew install gemini-cli

   复制

4. 4MacPorts 安装

   仅限 macOS，使用 MacPorts 包管理器安装，需要 sudo 权限。

   sudo port install gemini-cli

   复制

5. 5Anaconda 环境安装

   受限环境下先创建并激活新的 conda 环境，再在该环境内用 npm 全局安装。

   npm install -g @google/gemini-cli

   复制

6. 6配置认证

   首次使用需要完成认证，README 未给出具体命令，请按官方认证文档操作。

7. 7查阅配置与快捷键

   需要自定义设置或提升操作效率时，查阅官方配置指南与键盘快捷键文档。

如何确认成功

执行 npx @google/gemini-cli 或 gemini 后能进入终端交互界面并发送提问，即说明运行成功。

常见问题

注意事项

• README 未列出推荐系统配置与详细安装说明，请以官方安装文档为准。
• 首次运行必须完成认证配置，认证命令与参数见官方 Authentication Setup 文档。
• Anaconda 安装方式需先自行创建并激活一个 conda 环境后再执行 npm 安装。
• 项目采用 Apache 2.0 开源协议。