OasisRelay使用文档

外观

🎹 八、Gemini CLI【官转】配置教程 ​

如何部署？ ​

🎹 使用 Gemini 仅需三步操作，无需繁琐折腾。

在教程开始前您需要满足以下要求 ​

  • 适用于 macOS 10.15+、Ubuntu 20.04+、Debian 10+、Windows 10/11。
  • Node.js 22+【必选】
  • Git 2.23+【必选】
  • ripgrep，用于增强文件搜索【可选】

1. 安装 Gemini 官方客户端 ​

bash
npm install -g @google/gemini-cli

2. 获取 API 令牌 ​

  1. 访问 OasisRelay 令牌管理。
  2. 点击“添加令牌”。
  3. 令牌分组选择“Gemini CLI 专用”（仅可选择此分组）。
  4. 令牌名称可以随意填写，例如 Gemini。
  5. 额度建议设置为无限额度。
  6. 其他选项保持默认。
  7. 点击确认，复制生成的令牌。

3. 配置客户端 ​

打开以下文件夹：

  • macOS/Linux：~/.gemini
  • Windows：C:\Users\[username]\.gemini

Windows 用户

首次安装时，需要进入自己的用户目录，并新建名为 .gemini 的文件夹。

3.1 创建 .env 文件 ​

在 .gemini 文件夹中创建 .env 文件，填写：

dotenv
GOOGLE_GEMINI_BASE_URL=https://us.oarel.com
GEMINI_API_KEY=sk-xxxxxxxxxxxxxxxx
GEMINI_MODEL=gemini-3.5-flash

请把 sk-xxxxxxxxxxxxxxxx 替换为刚才复制的令牌。 备用链接：https://buoasis.com

3.2 创建 config.json 文件 ​

在同一个 .gemini 文件夹中创建 config.json：

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

4. 启动 Gemini CLI ​

进入项目文件夹，在该目录打开终端并执行：

bash
cd your-project-folder
gemini

不习惯终端怎么办？ ​

可以在 Cursor 或 VS Code 中安装 Gemini 插件。

在编辑器中安装 Gemini 插件

常见问题 ​

启动时提示 API Key 错误怎么办？ ​

请确认 .env 中的 GEMINI_API_KEY 已正确填写，并且使用的是“Gemini CLI 专用”分组的令牌。

如何切换不同的模型？ ​

可以在 Gemini CLI 中使用命令切换，也可以在配置中指定模型名称，例如 gemini-pro 或 gemini-flash。

如何卸载 Gemini CLI？ ​

bash
npm uninstall -g @google/gemini-cli