以下是整理的 macOS/Linux 与 Windows 双平台 Gemini CLI 安装指南文章Gemini CLI 安装配置指南Gemini CLI 是 Google 官方提供的命令行工具支持通过 API 密钥直接与 Gemini 模型交互。本文档将指导您在不同操作系统上完成安装与配置。系统要求操作系统版本要求macOS10.15 或更高版本Linux主流发行版如 Ubuntu 20.04、Debian 11、CentOS 7 等WindowsWindows 10版本 1809 / build 17763及以上一、安装 Gemini CLI无论使用何种操作系统均需通过 npm 全局安装官方包npminstall-ggoogle/gemini-cli确保已安装 Node.js建议版本 18 或更高。二、获取 API 密钥访问 [API 密钥管理页面]仪表板的「API密钥」界面创建并复制一个新的 API 密钥妥善保存后续配置需要使用三、配置环境变量Gemini CLI 需要通过环境变量获取 API 密钥和自定义 API 地址。macOS / Linux编辑用户配置文件通常为~/.zshrc或~/.bashrc在末尾添加以下内容# GEMINI Environment VariablesexportGOOGLE_GEMINI_BASE_URLhttps://api.aicodemirror.com/api/geminiexportGEMINI_API_KEY你的密钥保存后执行以下命令使配置生效source~/.zshrc# 若使用 zsh# 或source~/.bashrc# 若使用 bashWindows通过「控制面板」→「系统」→「高级系统设置」→「环境变量」添加以下两项变量名变量值GOOGLE_GEMINI_BASE_URLhttps://api.aicodemirror.com/api/geminiGEMINI_API_KEY你的密钥添加完成后需重启终端使配置生效。四、启动与初始化1. 启动 Gemini CLIgemini首次启动时会进入配置页面。2. 选择认证方式使用方向键选择Use Gemini API Key按下回车确认。五、可选配置开启 Preview Features进入 Gemini CLI 后输入/settings按提示开启预览功能。切换模型默认模型可能为旧版本建议切换至Gemini 3 Pro输入/quit退出重新运行gemini输入/model选择Gemini 3 Pro模型六、开始使用安装完成后您可以在任意项目目录中启动 Gemini CLI# 进入项目目录cdyour-project-folder# 启动 Gemini CLIgemini之后即可通过命令行与 Gemini 模型进行交互。常见问题Q启动时提示“command not found”A请检查 Node.js 是否安装以及 npm 全局安装路径是否在系统 PATH 中。QAPI 密钥无效或认证失败A请确认环境变量中的GEMINI_API_KEY与GOOGLE_GEMINI_BASE_URL已正确设置并重启终端。Q如何更新 Gemini CLIA执行npm update -g google/gemini-cli如需进一步帮助请联系技术支持。