常用客户端配置（PC）¶

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

Cherry Studio（推荐）¶

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

配置要点：

1. 下载地址：https://www.cherry-ai.com
2. 新建一个「自定义服务商」，选 Gemini 格式
3. API 主机填：https://agent.tweapi.com
4. API Key 填：你的 sk- 密钥

详细配置截图：

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

Kelivo（推荐）¶

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

配置要点：

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

详细配置截图：

Chatbox¶

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

1. 打开设置 → 模型提供方
2. 点击「添加」，新建一个提供方，API 主机填：https://agent.tweapi.com
3. API Key 填：你的 sk- 密钥
4. 手动添加模型名，例如：gemini-3-pro-preview
5. 保存并在模型列表中选中该模型

Gemini CLI（不推荐，兼容一般）¶

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

1. 创建配置目录：
2. Windows：C:\Users\你的用户名\.gemini
3. macOS / Linux：~/.gemini
4. 在该目录下创建 .env 文件，示例：

GEMINI_MODEL=gemini-3-pro-preview
GOOGLE_GEMINI_BASE_URL=https://agent.tweapi.com
GEMINI_API_KEY=sk-xxx  # 换成你自己的密钥

1. 在同一目录下创建 settings.json：

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

1. 进入你的项目目录并启动：

cd yourproject
gemini

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

Cline / RooCode / KiloCode 等 IDE 助手¶

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

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

• 模型名建议使用：gemini-3-pro-preview（不带 -c）
• Base URL：通常填 https://agent.tweapi.com/v1beta
• API Key：你的 sk- 密钥