GEMINI CLI

Gemini CLI - Linux 安装配置

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

#前置要求

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

#步骤 1：安装 Node.js

#Ubuntu/Debian

sudo apt update && sudo apt install nodejs npm

#Fedora

sudo dnf install nodejs npm

#Arch Linux

sudo pacman -S nodejs npm

#使用 nvm（推荐，适用于所有发行版）

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

# 重新加载配置
source ~/.bashrc # 或 source ~/.zshrc

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

#验证安装

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 权限错误（EACCES）

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

#问题：命令未找到

which gemini
npm config get prefix
echo $PATH

#问题：API 连接失败

cat ~/.gemini/.env
curl -I https://www.qianmodao.com

#问题：SSL 证书错误

sudo apt update && sudo apt install ca-certificates
sudo dnf install ca-certificates

#下一步

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