常用客户端配置（PC）¶

本页汇总了常见桌面端客户端的配置说明，你可以根据自己使用的平台跳到对应小节。

开始前请确认

配置所有客户端之前，请先完成：

不要直接使用内置 Gemini 提供方

若客户端内置「Gemini 官方」或其他预设提供方，请 不要直接选用，而是新建自定义提供方，并手动填写 Base URL 与模型名。

Cherry Studio（推荐）¶

Windows / macOS，功能完善，适合作为日常桌面客户端。

配置要点：

详细配置截图：

Cherry Studio 配置 1 Cherry Studio 配置 2 Cherry Studio 配置 3 Cherry Studio 配置 4 Cherry Studio 配置 5

额外补充说明：由于 Cherry Studio 迟迟未更新支持 Gemini3（11 月 28 日），导致可能图片上传/文件上传有一定问题，我们的 API 是支持的，但应用会提示无法上传，可以自行在设置中进行开启，具体流程如下图所示：

Cherry Studio 配置 5

此时再次进行尝试，是能够正常上传图片/文件使用的。

Windows / macOS，功能完善，适合作为日常桌面客户端。

配置要点：

下载地址：https://github.com/Chevey339/kelivo/releases，如果你访问不了 Github，那么可以使用https://www.123865.com/s/pwOxjv-RqgKH该地址进行下载，此处的安装包可能不是最新版。
新建一个「自定义服务商」，选 Gemini 格式
API 主机填：https://hk.12ai.org/v1beta
API Key 填：你的 sk- 密钥

详细配置截图：

Kelivo 配置 1 Kelivo 配置 2 Kelivo 配置 3 Kelivo 配置 4 Kelivo 配置 5

Chatbox 内置的 Gemini 提供方无法获取当前可用模型，因此需要手动添加：

Chatbox 配置 1 Chatbox 配置 2 Chatbox 配置 3 Chatbox 配置 4

关于 Chatbox 报错

Chatbox 在模型测试或工具调用时可能会报错，只要实际对话能正常进行即可；不能对话时请将报错信息反馈给我。

通过环境变量配置方式使用 Gemini CLI：

GEMINI_MODEL=gemini-3-pro-preview
GOOGLE_GEMINI_BASE_URL=https://hk.12ai.org
GEMINI_API_KEY=sk-xxx  # 换成你自己的密钥

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

cd yourproject
gemini

首次启动会读取上述配置文件，输入 hi 测试是否能正常响应。

可视化配置工具

如果你觉得纯命令行配置不够直观，也可以使用
https://github.com/office-sec/AionUi 提供的可视化配置工具。

均为开源插件，直接在 VS Code 中插件商店下载即可。

这些工具会在每次对话中发起多条请求，非常适合使用 Token 计费模型：

注意按次计费模型

若使用按次计费模型（带 -c 后缀），IDE 助手每次「对话」都会消耗多次请求，很容易导致次数卡迅速用完。

RooCode 示例

重要提醒

对于本地部署或其他酒馆客户端：