跳到正文
funcoding.ai
← Gemini CLI

Gemini CLI · 快速上手

Gemini CLI 快速上手：安装、三种登录方式与常用操作

用 npx、npm 或 Homebrew 安装 Gemini CLI，选择 Google 账号、API Key 或 Vertex AI 登录，开始使用。

1 分钟读完

安装

需要 Node.js 20 或更高版本。任选一种方式：

Terminal window
# 不安装，直接运行
npx @google/gemini-cli


# npm 全局安装
npm install -g @google/gemini-cli


# Homebrew
brew install gemini-cli

安装后在项目目录运行：

Terminal window
gemini

三种登录方式

1. 用 Google 账号登录（推荐个人使用）

启动后选择 Login with Google，在浏览器完成授权。个人账号每分钟 60 次、每天 1000 次请求，不需要管理 API Key。

如果你有付费的 Gemini Code Assist 许可，还需要设置项目 ID：

Terminal window
export GOOGLE_CLOUD_PROJECT="你的项目 ID"

2. 使用 Gemini API Key

在 Google AI Studio 创建 Key 后：

Terminal window
export GEMINI_API_KEY="你的 API Key"
gemini

免费层同样有每天 1000 次请求，并且可以指定具体模型。

3. 使用 Vertex AI（企业）

Terminal window
export GOOGLE_API_KEY="你的 Google Cloud API Key"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

常用操作

  • 直接用自然语言描述任务，它会读文件、改代码、执行命令，关键操作前会请求确认
  • 在项目根目录放一个 GEMINI.md，写下项目说明和约定，每次会话都会读取
  • 用 @文件路径 把指定文件加入上下文
  • 用 !命令 直接执行 Shell 命令
  • 输入 /help 查看全部斜杠命令

非交互模式

在脚本里使用：

Terminal window
gemini -p "总结这个仓库的目录结构"