Gemini CLI 安装教程

什么是 Gemini CLI？

Gemini CLI 是 Google 推出的 AI 命令行工具，提供强大的 AI 编程辅助功能。

---

前置准备

在开始之前，请确保已安装 Node.js 18 或更高版本。

• 如果尚未安装，请查看 Node.js 安装教程

---

第一步：安装 Gemini CLI

使用 npm 进行安装：

npm install -g @google/gemini-cli

---

第二步：配置环境变量

1. 创建配置文件

创建或编辑 ~/.gemini/.env 文件：

# macOS/Linux
mkdir -p ~/.gemini
nano ~/.gemini/.env

# Windows
mkdir %USERPROFILE%\.gemini
notepad %USERPROFILE%\.gemini\.env

2. 填写环境变量

GOOGLE_GEMINI_BASE_URL=https://ai.gaoxiao888.com/gemini
GEMINI_API_KEY=你的APIKey
GEMINI_MODEL=gemini-3-pro-preview

注意：将 你的APIKey 替换为你在官网生成的实际 API Key。

---

第三步：配置 settings.json

1. 创建配置文件

创建或编辑 ~/.gemini/settings.json 文件：

# macOS/Linux
nano ~/.gemini/settings.json

# Windows
notepad %USERPROFILE%\.gemini\settings.json

2. 填写配置内容

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

---

第四步：启动 Gemini CLI

在终端中执行：

gemini

---

解决 401 错误

如果出现 401 认证错误：

1. 在 Gemini CLI 中输入：

/auth

2. 按提示填写你的 API Key

---

常见问题

1. 找不到配置文件

确保配置文件路径正确：

• macOS/Linux：~/.gemini/
• Windows：%USERPROFILE%\.gemini\

2. 401 认证错误

解决方法：

• 检查 .env 文件中的 API Key 是否正确
• 在 CLI 中运行 /auth 命令重新配置
• 确保 API Key 没有多余的空格

3. 无法连接

确认：

• Base URL 配置正确：https://ai.gaoxiao888.com/gemini
• 网络连接正常
• 无需使用代理或 VPN

4. 模型不可用

检查：

• 模型名称是否正确：gemini-3-pro-preview
• API Key 是否有权限使用该模型

---

获取 API Key

1. 访问 https://ai.gaoxiao888.com
2. 注册并登录
3. 使用兑换码激活
4. 在控制台生成 API Key

---

配置文件位置总结

文件	路径	说明
.env	~/.gemini/.env	环境变量配置
settings.json	~/.gemini/settings.json	基础设置

---

下一步

• 返回 主页 查看其他教程
• 查看 Claude Code 教程 了解更多功能