LinkAGI

Gemini CLI 中转站 · LinkAGI 实操

Gemini CLI 国内接入
地址、认证、模型一次配好

LinkAGI 提供 Gemini 兼容路由。API 根地址填写 https://api.linktoagi.com，Key 使用 GEMINI_API_KEY，认证方式选择 Gemini API Key。

复制完整配置查看 Gemini 模型
Base URL根地址，不加 /v1
协议路由/v1beta/models/...
认证方式Gemini API Key

8 分钟完成 Gemini CLI 接入

先安装 CLI，再创建用户级 .env。模型名称必须与 LinkAGI 模型广场显示完全一致。

1. 安装并检查版本

npm install -g @google/gemini-cli
gemini --version

如果命令不存在，关闭终端后重开，并检查 npm 全局安装路径。

2. 创建配置目录

# macOS / Linux / WSL
mkdir -p ~/.gemini

# Windows PowerShell
New-Item -ItemType Directory -Force $HOME\.gemini

后续的 .env 与 settings.json 都放在这个目录。

# ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL="https://api.linktoagi.com"
GEMINI_API_KEY="sk-替换成你创建的API Key"
GEMINI_MODEL="gemini-3.1-pro"

示例模型 gemini-3.1-pro 在 2026-07-23 的 LinkAGI 公开模型列表中可见。可用状态会变化，使用前仍应从模型广场复制当前模型名。

把认证方式固定为 Gemini API Key

只写 Key 还不够。Gemini CLI 如果仍保留其他登录方式，可能不会走你刚配置的中转地址。

// ~/.gemini/settings.json
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
01

完全重启

关闭终端、VS Code 或 Cursor 后重新打开。

02

启动 Gemini

进入项目目录执行 gemini。

03

认证异常时

输入 /auth，重新选择 Gemini API Key。

用路由检查定位 401 和 404

先证明请求能到 LinkAGI，再检查 Key、模型和 Gemini CLI 本身，避免把多个问题混在一起。

# 只检查 Gemini 路由是否到达鉴权层，不消耗模型额度
curl -i "https://api.linktoagi.com/v1beta/models/gemini-3.1-pro:generateContent" \
  -X POST \
  -H "content-type: application/json" \
  -d '{}'
2026-07-23 实测

无 Key POST 到上述 v1beta 路由返回 JSON 401，说明请求已到鉴权层。真实请求还需要有效 Key、正确分组、余额和当时可用的模型。

401 Invalid token

确认 GEMINI_API_KEY 已被当前进程读取，并在 /auth 中选择 Gemini API Key。

404 Invalid URL

Base URL 应使用根地址，不要手动添加 /v1、/v1beta 或完整模型路径。

模型不可用 / 403

从模型广场复制精确 ID，并确认令牌分组为 Gemini 或支持该模型的分组。

429 / 5xx / timeout

降低并发，先用短提示验证；结合 LinkAGI 使用日志、公告和实时号池状态判断。

LinkAGI 模型广场筛选 Gemini 模型与可用分组
在模型广场按 Gemini 筛选，复制当前模型名并查看分组与实时价格。

先选模型，再创建令牌

Gemini 模型可能有 Pro、Flash、Lite、图像或不同预览版本。模型名、协议能力和分组并不完全相同，首次接入不要直接沿用旧配置。

打开模型广场

LinkAGI 在 Gemini CLI 场景中解决什么

国内统一入口

用同一控制台管理 Gemini、GPT 和 Claude 类模型，减少多套账号与账单切换。

人民币按量计费

输入、输出、分组和实际扣费可在模型广场与使用日志中核对。

配置支持

文档给出具体 Base URL、文件位置和错误码排查，仍有问题可联系人工客服。

先用短提示完成第一次调用

创建 Gemini 分组 Key，复制实时模型名，然后在使用日志中核对 Token 与扣费。

注册 LinkAGI