Gemini CLI 配置

Gemini CLI 是 Google 推出的 AI 编程助手命令行工具，基于 Gemini 2.5 Pro。通过 Clauddy 可以直接使用。

前提条件

• 已在 Clauddy 创建 API 令牌（创建教程）
• 已安装 Node.js 18+（环境检查）

安装

macOS / Linux

npm install -g @google/gemini-cli

Windows (以管理员身份运行)

npm install -g @google/gemini-cli

验证安装：

gemini --version

配置方法

macOS / Linux

# 创建配置目录和文件
mkdir -p ~/.gemini

# 创建 .env 文件
cat > ~/.gemini/.env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://clauddy.com
GEMINI_API_KEY=sk-your-clauddy-token
EOF

# 创建 settings.json 文件
cat > ~/.gemini/settings.json << 'EOF'
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

Windows

# 创建配置目录
mkdir "$HOME\.gemini" -Force

# 写入 .env
@"
GOOGLE_GEMINI_BASE_URL=https://clauddy.com
GEMINI_API_KEY=sk-your-clauddy-token
"@ > "$HOME\.gemini\.env"

# 写入 settings.json
@"
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
"@ > "$HOME\.gemini\settings.json"

Windows 手动配置

如果您更习惯图形界面，也可以手动创建以下两个文件：

%USERPROFILE%\.gemini\.env

GOOGLE_GEMINI_BASE_URL=https://clauddy.com
GEMINI_API_KEY=sk-your-clauddy-token

%USERPROFILE%\.gemini\settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

配置文件说明

.env 文件：

变量	说明
GOOGLE_GEMINI_BASE_URL	Clauddy API 基础地址：https://clauddy.com
GEMINI_API_KEY	您在 Clauddy 创建的 API 令牌

settings.json 文件：

设置认证方式为 API Key 模式，跳过 Google OAuth 登录。

配置文件路径汇总

系统	路径
macOS / Linux	~/.gemini/.env 和 ~/.gemini/settings.json
Windows	%USERPROFILE%\.gemini\.env 和 %USERPROFILE%\.gemini\settings.json

启动使用

首次启动时，Gemini CLI 会读取配置目录中的文件：macOS / Linux 为 ~/.gemini/，Windows 为 %USERPROFILE%\.gemini\。

gemini

常见问题

参考 Gemini 常见问题。