Gemini CLI 部署指南

资源	地址
Gemini CLI 官方文档	geminicli.com/docs

📋 前置要求

请先安装 Node.js 18+（nodejs.org）。

关于 Gemini CLI

Gemini CLI 是 Google 出的命令行 AI 编程助手，由 Gemini 系列模型驱动。本指南教你把它接到卡皮巴拉中转服务。

部署路径： 安装 CLI ➜ 配置密钥 ➜ 开始使用

---

🚀 用 CC-Switch 一键配置（推荐）

前置条件：先装 Gemini CLI

无论用不用 CC-Switch，Gemini CLI 工具本身需要先装好：

npm install -g @google/gemini-cli

验证：

gemini --version

配置步骤

1. 添加卡皮巴拉配置到 CC-Switch

1. 打开 CC-Switch 应用
2. 点击顶部 「Gemini」 标签页
3. 点击右上角橙色 「+」 按钮添加新配置

2. 填写配置信息

字段	填写内容
提供商名称	自定义，比如「卡皮巴拉」
Base URL	https://ai.bututrip.fun
API Key	你在卡皮巴拉创建的 Gemini 专用密钥
Model	选择可用的 Gemini 模型，如 gemini-2.0-flash 或 gemini-1.5-pro
安全设置	按需调整

填完点 「保存」。

💡 提示

• CC-Switch 会自动写入 ~/.gemini/.env 和 ~/.gemini/settings.json 两个文件
• 可以同时保存多个不同提供商，随时切换

3. 启用配置

1. 在配置列表里找到刚创建的「卡皮巴拉」
2. 点击右侧的 「当前使用」
3. 该配置变成绿色「当前使用」状态
4. 重启 Gemini CLI 让新配置生效

4. 系统托盘快速切换

1. 右键点击系统托盘里的 CC-Switch 图标
2. 在菜单选 Gemini 分类
3. 直接点要切换的配置，立即生效

⚠️ 注意事项

• 在卡皮巴拉创建密钥时，务必选择 Gemini 类型
• Gemini 密钥与 Claude Code、Codex 密钥都不通用
• 切换后必须重启 Gemini CLI 才能生效

---

⌨️ 手动命令行配置

不用 CC-Switch 也行，跟着平台步骤来。

🖥️ Windows

第一步：全局安装 Gemini CLI

PowerShell：

npm install -g @google/gemini-cli

第二步：创建配置目录

在用户目录下新建文件夹：

%USERPROFILE%\.gemini\

第三步：创建 .env 文件

在 .gemini 文件夹下新建 .env，内容：

GOOGLE_GEMINI_BASE_URL=https://ai.bututrip.fun
GEMINI_API_KEY=把你在卡皮巴拉创建的 Gemini 密钥粘贴在这里
GEMINI_MODEL=gemini-2.0-flash

第四步：创建 settings.json 文件

在同一目录下新建 settings.json：

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

第五步：启动

gemini

---

🍏 macOS

第一步：全局安装 Gemini CLI

npm install -g @google/gemini-cli

第二步：创建配置目录

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

第三步：写入 .env 文件

cat > .env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://ai.bututrip.fun
GEMINI_API_KEY=把你在卡皮巴拉创建的 Gemini 密钥粘贴在这里
GEMINI_MODEL=gemini-2.0-flash
EOF

第四步：写入 settings.json

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

第五步：启动

gemini

---

🐧 Linux

第一步：全局安装 Gemini CLI

sudo npm install -g @google/gemini-cli

第二步：创建配置目录

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

第三步：写入 .env 文件

cat > .env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://ai.bututrip.fun
GEMINI_API_KEY=把你在卡皮巴拉创建的 Gemini 密钥粘贴在这里
GEMINI_MODEL=gemini-2.0-flash
EOF

第四步：写入 settings.json

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

第五步：启动

gemini

---

常见问题

API Key 在哪里获取？

登录卡皮巴拉管理页面，在密钥管理中创建一个 Gemini 类型的专用令牌。

Gemini 密钥可以和 Claude Code / Codex 共用吗？

不可以。三种工具各自需要独立类型的密钥：

• Claude Code → Claude 类型密钥
• Codex → Codex 类型密钥
• Gemini CLI → Gemini 类型密钥

请在卡皮巴拉管理页面为 Gemini CLI 单独创建对应类型的密钥。

配置文件放在哪？

• Windows: %USERPROFILE%\.gemini\
• macOS / Linux: ~/.gemini/

里面有两个文件：.env（API Key 和地址）和 settings.json（认证类型设置）。

改完配置 Gemini CLI 没反应？

• 完全退出当前 Gemini 进程，重新执行 gemini 才会读新配置
• 检查 .env 里 GOOGLE_GEMINI_BASE_URL 是不是 https://ai.bututrip.fun
• 检查 GEMINI_API_KEY 是不是 Gemini 类型的密钥

报错连接不上？

参考 常见问题排查。