TinyPx API 文档

主题

Gemini CLI — Windows 安装配置 ​

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

前置要求 ​

  • Windows 10 或更高版本
  • Node.js 20.0 或更高版本
  • npm 包管理器

步骤 1：安装 Node.js ​

方法一：官方安装包（推荐） ​

  1. 访问 nodejs.org
  2. 下载 LTS 版本的 Windows Installer（.msi）
  3. 运行安装程序，按默认设置完成安装

方法二：包管理器 ​

powershell
# Winget
winget install OpenJS.NodeJS.LTS

# Chocolatey
choco install nodejs-lts

# Scoop
scoop install nodejs-lts

验证安装 ​

powershell
node --version
npm --version

步骤 2：全局安装 Gemini CLI ​

powershell
npm install -g @google/gemini-cli

验证安装：

powershell
gemini --version

权限问题

如果遇到权限问题，请以管理员身份运行命令提示符或 PowerShell。

步骤 3：配置 Gemini CLI ​

重要提示

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

3.1 创建 .gemini 文件夹 ​

powershell
mkdir $env:USERPROFILE\.gemini
cd $env:USERPROFILE\.gemini

配置位置：%USERPROFILE%\.gemini\

3.2 创建 .env 文件 ​

用 PowerShell 生成无 BOM 的 .env：

powershell
$envContent = @"
GOOGLE_GEMINI_BASE_URL=https://ai.tinypx.cn
GEMINI_API_KEY=粘贴为 Gemini CLI 专用分组令牌 key
GEMINI_MODEL=填写该 Gemini CLI 分组支持的模型名
"@
[System.IO.File]::WriteAllText(
  (Join-Path $PWD ".env"),
  $envContent,
  [System.Text.UTF8Encoding]::new($false)
)

或手动创建 .env 文件：

ini
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 文件 ​

powershell
$settingsContent = @"
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
"@
[System.IO.File]::WriteAllText(
  (Join-Path $PWD "settings.json"),
  $settingsContent,
  [System.Text.UTF8Encoding]::new($false)
)

或手动创建 settings.json：

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

注意

必须使用 UTF-8 无 BOM 编码保存，否则 Gemini CLI 会报 JSON 解析错误。 配置改动需要重启 Gemini CLI 才生效。

步骤 4：启动 Gemini CLI ​

powershell
gemini

开始使用 Gemini CLI：

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

常用命令 ​

powershell
# 启动交互式会话
gemini

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

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

# 查看帮助
gemini --help

故障排除 ​

PowerShell 执行策略错误 ​

症状：运行 gemini 时提示「无法加载文件，因为在此系统上禁止运行脚本」

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

JSON 配置文件错误 ​

症状：提示 Unexpected token '' 或 is not valid JSON

原因：配置文件包含 BOM（字节顺序标记）字符

解决：用 PowerShell 重新创建无 BOM 的配置文件：

powershell
cd $env:USERPROFILE\.gemini
$settingsContent = @"
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
"@
[System.IO.File]::WriteAllText(
  (Join-Path $PWD "settings.json"),
  $settingsContent,
  [System.Text.UTF8Encoding]::new($false)
)

命令未找到 ​

powershell
npm config get prefix

添加到 PATH：

powershell
$npmPath = npm config get prefix
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$npmPath", "User")

API 连接失败 ​

powershell
# 检查密钥配置
Get-Content $env:USERPROFILE\.gemini\.env

# 确认设置文件
Get-Content $env:USERPROFILE\.gemini\settings.json

# 测试端点
curl -I https://ai.tinypx.cn

编码问题 ​

确保配置文件为 UTF-8 无 BOM：

powershell
$envContent = Get-Content .env -Raw
[System.IO.File]::WriteAllText(
  (Join-Path $PWD ".env"),
  $envContent,
  [System.Text.UTF8Encoding]::new($false)
)

下一步 ​

获取 API 密钥

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

官方 QQ 群 634534003 · 客服 QQ 179710692

Copyright © 2026 TinyPx API