Gemini CLI
本地运行
Gemini
CLI 工具
Google 官方命令行工具，基于 Gemini 模型，响应迅速，支持多模态理解与 1M token 上下文窗口。
安装方式
推荐
通过 npm 安装
全局安装，随时通过 gemini 命令启动。
npm install -g @google/gemini-cli
免安装体验
不想全局安装，也可以直接用 npx 运行：
npx @google/gemini-cli
系统要求
软件依赖
Node.js 18 或更高版本、npm
账号
个人 Google 账号（免费额度）或 Gemini API Key（付费额度）
环境变量配置
Gemini CLI 支持通过 GEMINI_API_KEY 跳过 Google 账号登录，直接用 API Key 鉴权；配合 GOOGLE_GEMINI_BASE_URL 可将请求指向中转地址 https://ai.kedang.net。将下方的 <你的 API Key> 替换为实际密钥。
临时配置（仅当前会话）
关闭终端后失效，适合临时测试。
macOS / Linux
export GOOGLE_GEMINI_BASE_URL="https://ai.kedang.net" export GEMINI_API_KEY="<你的 API Key>"
Windows（PowerShell）
$env:GOOGLE_GEMINI_BASE_URL="https://ai.kedang.net" $env:GEMINI_API_KEY="<你的 API Key>"
永久配置
写入 Shell 配置文件或系统环境变量，新开终端后自动生效。
macOS / Linux
编辑 Shell 配置文件
在 ~/.zshrc 或 ~/.bashrc 末尾追加：
export GOOGLE_GEMINI_BASE_URL="https://ai.kedang.net" export GEMINI_API_KEY="<你的 API Key>"
保存后执行 source ~/.zshrc（按实际文件替换）使其立即生效。
Windows
系统环境变量
「系统属性」→「环境变量」→「用户变量」中新建：
变量名
GOOGLE_GEMINI_BASE_URL
变量值
https://ai.kedang.net
变量名
GEMINI_API_KEY
变量值
<你的 API Key>
保存后需要重新打开终端 / PowerShell 窗口才会生效。
开始使用
gemini
首次启动会引导使用个人 Google 账号登录，免费额度为每分钟 60 次、每天 1000 次请求。
故障排除
免费额度不够用
可在设置中切换为 Gemini API Key 模式，按量计费，不受每日 1000 次限制。
登录页无法打开
确认终端可以正常打开默认浏览器，或改用 gemini --no-browser 走手动授权流程。