Gemini CLI 安装使用指南
Gemini CLI 是 Google 提供的命令行工具,让你可以在终端中使用 Gemini 大模型。
环境准备
- Go 1.21 或更高版本(可选,用于源码编译)
- 有效的 Google Cloud 账户
- Gemini API 访问权限
安装方法
方法一:使用包管理器(推荐)
# macOS brew install gemini-cliLinux (Snap)
sudo snap install gemini-cli
Windows (Chocolatey)
choco install gemini-cli
方法二:使用 npm
npm install -g @google/gemini-cli验证安装
gemini —version
方法三:源码编译
git clone https://github.com/google/gemini-cli.git
cd gemini-cli
go build -o gemini
sudo mv gemini /usr/local/bin/
认证配置
1. 获取 API Key
访问 Google AI Studio 创建 API Key。
2. 配置凭证
# 方式一:交互式配置 gemini config方式二:直接设置
gemini config set api_key YOUR_API_KEY
方式三:环境变量
export GEMINI_API_KEY=“YOUR_API_KEY” export GOOGLE_CLOUD_PROJECT=“your-project-id”
常用命令
基础对话
# 交互式模式 gemini chat单次查询
gemini ask “解释一下快速排序算法”
代码相关
# 代码生成 gemini code generate "Python HTTP server"代码审查
gemini code review ./src/main.go
单元测试生成
gemini test generate ./utils.py
文件处理
# 分析文件 gemini analyze ./document.pdf多文件上下文
gemini chat —context file1.py,file2.js
高级配置
# ~/.gemini/config.yaml
model: gemini-pro
temperature: 0.7
max_output_tokens: 2048
top_p: 0.95
timeout: 60
retry_attempts: 3
实用技巧
- 使用别名:在
.bashrc或.zshrc中添加alias g='gemini chat' - 管道输入:
cat file.py | gemini explain - 输出格式化:
gemini ask --format json "API design"