从 0 到 1 速通 Gemini CLI：我整理的安装配置终极保姆教程来了

Gemini CLI 安装并不难真正容易卡住的是API Key、中转地址和模型 ID。这篇教程只走一条主线安装 Gemini CLI→ 获取 API Key→ 配置中转 API→ 启动验证→ 提交第一个任务Windows、macOS 和 Linux 都可以参考。PS:本文默认使用gemini-3.1-pro-preview 一、开始前先看Gemini CLI 是 Google 推出的开源命令行 AI 工具可以直接在终端中读取项目、分析代码、修改文件和执行任务。这篇教程适合第一次安装 Gemini CLI 的新手需要配置中转 API 的用户想在终端中使用 Gemini 分析或修改代码的开发者。⚠️ Gemini CLI 更新较快。如果升级后配置突然失效优先检查 CLI 版本、中转平台说明和模型 ID。⚙️ 二、准备环境开始前先确认以下条件Node.js 20 或更高版本Windows、macOS 或 Linux可正常使用的终端Gemini 中转 API Key稳定的网络连接。可以运行下面的命令检查 Node.js 版本node -v如果能够正常显示版本号即可继续安装。 三、安装 CLI长期使用推荐通过 npm 全局安装。1. npm 全局安装npm install -g google/gemini-cli安装完成后检查版本gemini --version能够正常显示版本号说明 Gemini CLI 已安装成功。2. npx 临时运行如果只想体验不想全局安装npx google/gemini-cli3. Homebrew 安装macOS / Linux 用户也可以运行brew install gemini-cli三种方式选择一种即可不需要重复安装。 四、获取密钥进入 LetAiCode 个人中心依次完成打开“接口密钥”→ 创建对应类型的密钥→ 复制 API Key后面配置时需要填写这串 API Key。⚠️ 不要在文章、截图或公开代码中展示真实密钥。⚙️ 五、配置 API长期使用推荐把配置写入.gemini目录临时测试可以使用终端环境变量。1. 创建.gemini目录Gemini CLI 的全局配置目录位于用户主目录下。WindowsC:\Users\你的用户名\.geminimacOS / Linux~/.gemini如果没有该目录需要手动创建。2. 创建.env在.gemini目录中新建.env文件写入GOOGLE_GEMINI_BASE_URLhttps://letaicode.cn/gemini GEMINI_API_KEYYOUR_API_KEY GEMINI_MODELgemini-3.1-pro-preview参数说明参数作用GOOGLE_GEMINI_BASE_URLGemini 中转 API 地址GEMINI_API_KEYLetAiCode 接口密钥GEMINI_MODEL默认使用的模型 ID将YOUR_API_KEY替换为刚刚创建的 API Key。本文默认使用gemini-3.1-pro-preview如果需要切换到另一个支持的模型将最后一行改为GEMINI_MODELgemini-3.5-flash3. 创建settings.json继续在.gemini目录中新建settings.json{ security: { auth: { selectedType: gemini-api-key } } }保存.env和settings.json然后重新打开终端。4. 可选临时设置如果只想临时测试可以直接在当前终端设置环境变量。macOS / Linuxexport GEMINI_API_KEYYOUR_API_KEY export GOOGLE_GEMINI_BASE_URLhttps://letaicode.cn/gemini export GEMINI_MODELgemini-3.1-pro-previewWindows PowerShell$env:GEMINI_API_KEYYOUR_API_KEY $env:GOOGLE_GEMINI_BASE_URLhttps://letaicode.cn/gemini $env:GEMINI_MODELgemini-3.1-pro-preview这种方式只对当前终端会话生效关闭终端后需要重新设置。✅ 六、启动验证先检查 Gemini CLI 是否安装成功gemini --version然后进入需要处理的项目目录运行gemini进入交互界面后可以提交一个简单任务请读取当前目录并概括项目结构如果能够正常读取目录并返回结果说明以下配置已经生效Gemini CLI 安装正常API Key 可以使用中转 API 地址正确模型 ID 配置有效。 七、常用命令1. 命令速查使用需求命令启动交互模式gemini查看版本gemini --version读取其他目录gemini --include-directories ../lib,../docs临时切换模型gemini -m gemini-3.5-flash直接提交任务gemini -p 解释这个代码库的架构输出 JSONgemini -p 解释这个代码库的架构 --output-format json使用-m指定模型只影响本次调用不会修改.env中的默认模型。2. 提示词示例使用场景可直接复制的提示词理解项目分析当前项目结构并说明主要目录的作用修改代码先分析需求并给出修改计划确认后再修改代码排查报错分析当前报错定位最可能的原因并给出验证步骤⚠️ 批量修改代码或文件前建议先确认操作范围并使用 Git 保存当前版本。✅ 八、完成检查Gemini CLI 的完整配置流程→ 安装 Node.js 20→ 安装 Gemini CLI→ 运行gemini --version→ 获取 API Key→ 创建.gemini目录→ 配置.env和settings.json→ 运行gemini→ 提交测试任务如果无法正常启动优先检查GEMINI_API_KEY是否填写正确GOOGLE_GEMINI_BASE_URL是否为正确的中转地址GEMINI_MODEL是否填写了当前支持的模型 ID修改配置后是否重新打开终端。当前可用模型gemini-3.1-pro-preview gemini-3.5-flash完成以上配置后就可以在终端中使用 Gemini CLI 分析项目、修改代码和排查问题。