GEMINI CLI

Gemini CLI - macOS 安装配置

在 macOS 上安装 Gemini CLI，并通过配置文件连接千模岛 API。

#前置要求

Node.js 18 或更高版本
可用的千模岛 API Key
从模型广场选择一个可用的 Gemini 模型

#步骤 1：安装 Node.js

#方法一：使用 Homebrew（推荐）

brew install node

#方法二：使用 nvm

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载配置
source ~/.zshrc # 如果使用 zsh
source ~/.bashrc # 如果使用 bash

# 安装 Node.js LTS
nvm install --lts
nvm use --lts

#方法三：使用官方安装包

访问 https://nodejs.org
下载 macOS Installer（.pkg）。
运行安装程序并按默认设置完成安装。

#验证安装

node --version
npm --version

#步骤 2：全局安装 Gemini CLI

# 全局安装
npm install -g @google/gemini-cli

# 验证安装
gemini --version

#步骤 3：配置 Gemini CLI

#3.1 创建 .gemini 文件夹

mkdir -p ~/.gemini
cd ~/.gemini

#3.2 创建 .env 文件

也可以在 ~/.gemini 目录中手动创建 .env：

GOOGLE_GEMINI_BASE_URL=https://www.qianmodao.com
GEMINI_API_KEY=sk-your-api-key
GEMINI_MODEL=<从模型广场选择的模型名称>

#3.3 创建 settings.json 文件

也可以在同一目录中手动创建 settings.json：

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

chmod 600 ~/.gemini/.env ~/.gemini/settings.json

#步骤 4：启动 Gemini CLI

gemini

# 启动后输入
你好，请介绍一下你自己

能够正常返回内容，即表示 API 地址、密钥和模型配置已经生效。

#常用命令

# 进入交互模式
gemini

# 非交互式提示
gemini -p "创建一个React组件"

# 分析代码文件
gemini -p "分析 file.js 并指出可以改进的地方"

# 查看帮助
gemini --help

#故障排除

#问题：命令未找到

npm config get prefix
which gemini
echo $PATH

#问题：API 连接失败

cat ~/.gemini/.env

#问题：权限错误

sudo npm install -g @google/gemini-cli

#问题：M1/M2 芯片兼容性

Apple Silicon 设备应优先使用原生 arm64 版本的 Node.js。

#下一步

获取 API 密钥：访问千模岛 API 控制台获取你的 Gemini CLI 专用令牌。