Mr.Nine 的技术笔记

Appearance

安装与准备 ​

Gemini CLI 是 Google 官方的 AI 编程助手命令行工具，基于 Gemini 模型。

⚠️ 前置条件（必须满足） ​

在开始安装之前，请确保您已具备以下条件：

系统要求 ​

  • Node.js 20+ - 下载地址
  • CC Switch 桌面软件 - 安装说明
  • 代理工具（可选） - 网络受限时用于访问 Google 服务（如 Clash、v2rayN 等）

账号准备 ​

  • 官方登录方式：Google 账号
  • 自定义供应商方式：第三方 API 供应商的端点与密钥

网络环境 ​

  • 官方登录需可访问 accounts.google.com（OAuth 登录）和 generativelanguage.googleapis.com
  • 自定义供应商需可访问对应 API Endpoint
  • 或配置了可用的代理服务器

重要提醒

如果您无法满足上述任何一个条件，请先解决相关问题再继续安装。

快速安装 ​

1. 安装 Gemini CLI ​

bash
npm install -g @google/gemini-cli

或使用 npx 直接运行（无需安装）：

bash
npx @google/gemini-cli

2. 验证安装 ​

bash
gemini --version

安装成功标志

如果能正常输出版本号，说明 CLI 安装成功。接下来请在下方选择配置方式。

配置方式（通过 CC Switch） ​

以下两种方式都通过 CC Switch 桌面软件 操作：

  1. 打开 CC Switch，进入 Provider 管理页
  2. 点击「添加 Provider」，选择 Gemini
  3. 预设选择 Google Official，保存并启用
  4. CC Switch 写入 ~/.gemini/settings.json（设置 selectedType: "oauth-personal"）
  5. 首次运行 gemini 时会拉起浏览器，按提示完成 Google OAuth 登录
  6. 认证信息自动保存到 Gemini 凭据存储

配置文件写入位置：

文件说明
~/.gemini/settings.json设置 selectedType: "oauth-personal"，启用 OAuth 模式

免费额度

使用 Google OAuth 登录可享受 Gemini API 的免费额度，适合个人学习使用。

推荐使用

官方登录方式无需手动管理 API Key，认证信息由 CLI 自动维护，更加安全便捷。

启动 ​

完成上方任一配置方式后，启动 Gemini：

bash
gemini

可用模型 ​

模型特点
gemini-2.5-flash快速响应，适合日常任务
gemini-2.5-pro最新模型，能力最强
bash
# 指定模型
gemini -m gemini-2.5-pro "优化这个函数"

常用参数 ​

参数说明
-m指定模型

相关链接 ​