跳转到主要内容

准备环境

安装 Gemini CLI,并在 APIONE 控制台 创建 API Key。选择支持 Gemini 协议的模型,复制其实际模型 ID。

Windows 安装

在 PowerShell 中安装并检查版本。
PowerShell 安装 Gemini CLI 后显示 added 12 packages

Windows PowerShell 安装 Gemini CLI 的输出示例。

图中已显示 added 12 packages。安装后运行 gemini --version,确认命令可用,再继续配置。

配置认证和地址

在 ~/.gemini/.env 中加入以下内容(路径中的 ~ 表示用户目录):
将两个占位符替换为自己的密钥和模型 ID。这里填写站点根地址,由客户端拼接 API 版本和模型路径。 启动 gemini,选择 API Key 认证。若已有 settings.json,可在保留其他设置的基础上合并:

验证请求

收到回复后,再测试读取一个测试项目的文件。普通对话成功不代表工具调用已经验证,应分别检查。

常见问题

  • 仍弹出 Google 登录:检查当前认证模式是否为 API Key。
  • 404:确认最终路径没有重复的 /v1beta,并确认模型支持 Gemini 协议。
  • 工具调用报错:检查模型能力和 CLI 版本,保留错误信息排查;不要直接套用其他服务商的本地补丁。
  • 环境变量未生效:关闭旧进程,从加载配置的新终端启动。
配置字段以 Gemini CLI 官方说明 为准。
返回集成目录 · 模型选择 · 错误排查