Gemini CLI 配置教程

不想手动改文件？

用 星芒AI管理工具 一键写入即可，下面的步骤是手动配置方式。

1. 安装 Gemini CLI

先完成 Node.js 安装，并确认 npm 源是官方源。然后：

npm install -g @google/gemini-cli

gemini --version

显示版本号即安装成功。

2. 修改配置文件

先关闭正在运行的 Gemini CLI。

打开配置目录：

Windows

按 Win + R，输入 %USERPROFILE%\.gemini 回车

macOS / Linux

~/.gemini

目录里要有两个文件，没有就新建；之前配置过的建议先备份。

settings.json

原样写入，不要改：

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

.env

换成你的密钥，模型名可以按需修改：

GOOGLE_GEMINI_BASE_URL=https://api.solov.cc
GEMINI_API_KEY=换成你在星芒AI创建的API密钥
GEMINI_MODEL=gemini-3.5-flash

模型名以 可用渠道 页面为准。

3. 启动

gemini

输入一个问题，AI 回复就说明配置成功：

调不通？

1. .env 文件名前面有个点，Windows 上新建时注意不要变成 .env.txt；
2. GOOGLE_GEMINI_BASE_URL 是否是 https://api.solov.cc；
3. 密钥是否完整、已启用，分组是否包含 Gemini 模型；
4. 是否已完全重启。

仍然报错，对照 错误码对照，或把完整报错文案发给客服。