应用配置
Gemini CLI 配置
在 Gemini CLI 中使用 smai.ai
简介
Gemini CLI 是 Google 推出的命令行工具，支持在终端中与 Gemini 模型进行交互。
一键配置
推荐
登录 smai.ai，进入「平台接入」页面，点击 Gemini CLI 卡片即可自动完成配置。
轻松一键配置
推荐使用开源工具 CC Switch 进行图形化配置管理。
CC Switch 是一个用于图形化管理 Claude Code、Codex、Gemini CLI 多配置文件的工具，可以帮助用户在不同的配置文件之间快速切换，无需手动编辑配置文件。
安装 CC Switch
打开 CC Switch 下载页面，滑到页面底部下载对应系统的安装包：
| 系统 | 下载文件 |
|---|---|
| Windows | CC-Switch-Setup.msi |
| macOS | CC-Switch-macOS.zip |
| Debian/Ubuntu | CC.Switch_x.x.x_amd64.deb |
| Arch Linux | 使用 yay cc-switch 命令安装 |
| 其他 Linux | CC.Switch_x.x.x_amd64.AppImage |
如果安装遇到问题，可以联系客服进行辅助安装。
打开 CC Switch
安装完成后打开 CC Switch 应用。
配置 Gemini CLI
点击「Gemini CLI」选项卡，依次配置以下内容：
环境变量 env：
GOOGLE_GEMINI_BASE_URL=https://api.smai.ai
GEMINI_API_KEY=sk-xxxxxxx
GEMINI_MODEL=gemini-3-pro-previewconfig.json：
{
"ide": {
"hasSeenNudge": true
},
"maxRetries": 3,
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
},
"timeout": 30000
}重要
务必将 sk-xxxxxxx 替换为您自己的 smai.ai 密钥。
点击保存即可完成配置。
多 Key 管理
如果您有多个 API Key：
- 点击右上角的「添加服务商」
- 参考以上方式输入您的 Key，点击保存
- 点击「切换此 Key」后重启终端即可使用
手动配置步骤
安装 Gemini CLI
npm install -g @google/gemini-cli配置环境变量
设置 API 端点和密钥：
export GEMINI_API_KEY="sk-your-api-key"
export GOOGLE_GEMINI_BASE_URL="https://api.smai.ai"端点格式
根据 CLI 版本，可能需要调整端点格式。
开始使用
gemini chat推荐模型
| 用途 | 推荐模型 |
|---|---|
| 代码生成 | gemini-3-pro |
| 多模态任务 | gemini-3-pro-image-preview |
| 快速任务 | gemini-2.0-flash |