Gemini CLI 安装步骤

Gemini CLI 是 Google 官方 AI 编程助手。本章介绍如何让它走NassaApi 中转站。

📋 前置要求

请先完成 Node.js 环境安装。

🚀 使用 CC-Switch 快速配置（推荐）

配置步骤

1. 启动 CC-Switch 并切换到 Gemini 标签
   • 点击顶部「Gemini」标签页
   • 点击右上角橙色「+」按钮添加新配置
2. 填写 Gemini 提供商配置
   • 提供商名称：自定义（如 my-proxy）
   • Base URL：https://api.nassaapi.xyz
   • API Key：粘贴您的专属 Key
   • Model：选择 Gemini 对应模型（如 gemini-3-pro-preview）
   • 点击「保存」按钮
3. 启用配置并使用
   • 找到刚创建的配置，点击「当前使用」
   • 重启 Gemini CLI

⌨️ 手动命令行配置

🖥️ Windows 安装流程教程

1️⃣ 全局安装 Gemini CLI

npm install -g @google/gemini-cli

2️⃣ 配置 Gemini CLI

⚠️ 重要提示

请将 GEMINI_API_KEY 替换为你的专属密钥！

2.1 创建 gemini 文件夹

路径：%USERPROFILE%\.gemini\

2.2 创建 .env 文件

GOOGLE_GEMINI_BASE_URL=https://api.nassaapi.xyz
GEMINI_API_KEY=sk-你的密钥
GEMINI_MODEL=gemini-3-pro-preview

2.3 创建 settings.json 文件

{
  "ide": { "enabled": true },
  "security": {
    "auth": { "selectedType": "gemini-api-key" }
  }
}

3️⃣ 启动 Gemini CLI

gemini

🍏 macOS 安装流程教程

1️⃣ 全局安装 Gemini CLI

npm install -g @google/gemini-cli

2️⃣ 配置 Gemini CLI

2.1 创建配置目录：

mkdir -p ~/.gemini
cd ~/.gemini

2.2 创建 .env 文件：

cat > .env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.nassaapi.xyz
GEMINI_API_KEY=sk-你的密钥
GEMINI_MODEL=gemini-3-pro-preview
EOF

2.3 创建 settings.json 文件：

cat > settings.json << 'EOF'
{
  "ide": { "enabled": true },
  "security": {
    "auth": { "selectedType": "gemini-api-key" }
  }
}
EOF

3️⃣ 启动 Gemini CLI

gemini

🐧 Linux 安装流程教程

1️⃣ 全局安装 Gemini CLI

sudo npm install -g @google/gemini-cli

2️⃣ 配置 Gemini CLI

步骤与 macOS 完全一致，参考上方即可。

3️⃣ 启动 Gemini CLI

gemini

🎉 部署完成！ 现在您可以使用 Gemini CLI 进行 AI 辅助编程了。

常见问题

API Key 在哪里获取？

登录 api.nassaapi.xyz → 令牌管理 → 创建新令牌（详见 创建专属 Key）。

配置文件位置

• Windows：%USERPROFILE%\.gemini\.env 与 settings.json
• macOS / Linux：~/.gemini/.env 与 ~/.gemini/settings.json

更多问题

请查阅 疑难杂症 或 常见问题 (FAQ)。