跳转到主要内容

​
概览

Google Gemini CLI 是一个用于与 Gemini 模型交互的命令行工具。LemonData 提供了一个兼容的端点，允许您使用 Gemini CLI 访问 300 多个模型。

​
系统要求

  • Node.js: 20.0+ 版本
  • OS: Windows 10/11, macOS 10.15+, Ubuntu 20.04+ 或 Debian 10+

​
安装

npm install -g @google/gemini-cli
验证安装： 
gemini --version

​
配置

​
第 1 步：获取您的 API Key

  1. 登录 LemonData 控制台
  2. 导航至 API Keys
  3. 创建并复制您的 API key（格式：sk-...）

​
第 2 步：设置环境变量

临时（当前会话）： 
export GEMINI_API_KEY="sk-your-lemondata-key"
export GOOGLE_GEMINI_BASE_URL="https://api.lemondata.cc"
永久配置： 添加到您的 shell 配置文件中： 
echo 'export GEMINI_API_KEY="sk-your-lemondata-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.lemondata.cc"' >> ~/.bashrc
source ~/.bashrc
配置完成后请重启终端以使更改生效。
已知限制：在某些情况下，如果存在缓存的 Google 会话，Gemini CLI 可能不会遵循 GOOGLE_GEMINI_BASE_URL。如果您遇到连接问题，请尝试清除 CLI 缓存或启动新的终端会话。

​
基本用法

从您的项目目录启动 Gemini CLI： 
cd your-project
gemini
首次运行时，您需要：
  1. 选择主题
  2. 确认安全声明
  3. 信任工作目录

​
可用模型

模型描述
gemini-2.5-pro功能最强大的 Gemini 模型
gemini-2.5-flash快速、高效，适用于大多数任务
gemini-2.0-flash上一代版本，稳定

​
常用命令

提问： 
> What is the best way to structure a React app?
分析代码： 
> Explain the code in src/main.ts
生成代码： 
> Create a Python function to parse JSON files
审查更改： 
> Review the recent git changes and suggest improvements

​
验证配置

# 检查环境变量
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

# 测试连接
gemini

​
故障排除

  • 验证 GOOGLE_GEMINI_BASE_URL 已设置为 https://api.lemondata.cc
  • 注意：Gemini 端点不需要 /v1 后缀
  • 检查网络连接
  • 验证 GEMINI_API_KEY 环境变量已设置
  • 检查 Key 是否以 sk- 开头
  • 确保 Key 在 LemonData 控制台中处于激活状态

​
最佳实践

始终从项目根目录运行 Gemini CLI，以便更好地理解上下文。
仅信任您拥有的目录。Gemini CLI 可以读取和修改文件。
在提交到项目之前，务必审查 AI 生成的代码。