Gemini CLI — Linux 安装配置

本指南帮助你在 Linux 上安装并配置 Google Gemini CLI，接入 TinyPx API 服务。

前置要求

• Linux 发行版（Ubuntu、Debian、Fedora、Arch 等）
• Node.js 20.0 或更高版本
• npm 包管理器

步骤 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（推荐，适用于所有发行版）

发行版仓库里的 Node 往往低于 20，用 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   # 需要 v20 或更高
npm --version

步骤 2：全局安装 Gemini CLI

npm install -g @google/gemini-cli

验证安装：

gemini --version

权限问题

如果遇到权限错误（EACCES），参考下方故障排除。

步骤 3：配置 Gemini CLI

重要提示

请把下方的 GEMINI_API_KEY 替换为你在 TinyPx API 控制台 生成的 Gemini CLI 专用 API 密钥。

3.1 创建 .gemini 文件夹

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

配置位置：~/.gemini/

3.2 创建 .env 文件

cat > ~/.gemini/.env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://ai.tinypx.cn
GEMINI_API_KEY=粘贴为 Gemini CLI 专用分组令牌 key
GEMINI_MODEL=填写该 Gemini CLI 分组支持的模型名
EOF

或手动创建 .env 文件：

GOOGLE_GEMINI_BASE_URL=https://ai.tinypx.cn
GEMINI_API_KEY=粘贴为 Gemini CLI 专用分组令牌 key
GEMINI_MODEL=填写该 Gemini CLI 分组支持的模型名

可用模型

具体可用模型请到 模型广场 查阅该 Gemini CLI 分组支持的 model 及价格。

3.3 创建 settings.json 文件

cat > ~/.gemini/settings.json << 'EOF'
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

注意

配置改动需要重启 Gemini CLI 才生效。

建议限制密钥文件权限：

chmod 600 ~/.gemini/.env

步骤 4：启动 Gemini CLI

gemini

开始使用 Gemini CLI：

• 超大上下文窗口：1M tokens
• Agent Mode 自动规划任务
• Google Search 实时联网

常用命令

# 启动交互式会话
gemini

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

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

# 查看帮助
gemini --help

故障排除

npm 权限错误（EACCES）

方法 1：修改 npm 全局目录（推荐）

# 创建全局目录
mkdir -p ~/.npm-global

# 配置 npm 使用新目录
npm config set prefix '~/.npm-global'

# 添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 重新安装
npm install -g @google/gemini-cli

方法 2：使用 sudo（不推荐）

sudo npm install -g @google/gemini-cli

命令未找到

npm config get prefix
echo $PATH

添加到 PATH：

# Bash
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

# Zsh
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.zshrc
source ~/.zshrc

API 连接失败

# 测试网络连接
curl -I https://ai.tinypx.cn

# 验证密钥配置
cat ~/.gemini/.env

# 确认设置文件
cat ~/.gemini/settings.json

SSL 证书错误

sudo apt update && sudo apt install ca-certificates  # Ubuntu/Debian
sudo dnf install ca-certificates                     # Fedora
sudo pacman -S ca-certificates                       # Arch

下一步

• Windows 安装指南
• macOS 安装指南
• Claude Code 配置
• Codex 配置

获取 API 密钥

访问 TinyPx API 控制台 获取你的 Gemini CLI 专用令牌。