CLIProxyAPI 实战指南：配置 Google Pro 账号解锁满血 Gemini

2026-01-24 约 983 字预计阅读 2 分钟

CLIProxyAPI 是一个强大的代理服务器工具，它能为各种 AI 服务（Gemini, Claude, OpenAI 等）提供统一的 API 接口。本文将重点介绍如何通过 CLIProxyAPI 配置 Google Pro 账号，利用 OAuth 认证来无缝调用 Gemini 的高级模型。

1. 准备工作

在开始之前，请确保你已经编译或下载了 cli-proxy-api 的可执行文件。

2. 配置文件准备

首先，我们需要准备 config.yaml 配置文件。

# 服务器配置
host: ""           # 绑定所有接口，若需限制本地访问请填 "127.0.0.1"
port: 8317         # 代理服务器监听端口

# 认证目录 (OAuth 令牌将存储在这里)
auth-dir: "~/.cli-proxy-api"

# API 密钥 (客户端访问此代理服务时使用的密码)
api-keys:
  - "your-custom-secret-key-1"
  - "your-custom-secret-key-2"

3. Google 账号登录授权

这是最关键的一步。我们需要通过 OAuth 让 CLIProxyAPI 获得你 Google 账号的权限。

3.1 常用登录命令

基本登录：

./cli-proxy-api --login

指定 Google Cloud 项目 ID（推荐 Pro 用户）： 如果你有特定的付费 Google Cloud 项目，建议显式指定，以确保扣费和配额正确。

./cli-proxy-api --login --project_id your-project-id

无头模式（用于 SSH 远程服务器）： 如果服务器没有浏览器，使用此模式。它会生成一个 URL，你只需在本地浏览器打开并授权，然后将验证码贴回终端即可。

./cli-proxy-api --login --no-browser

3.2 认证流程解析

执行登录命令后，系统会引导你完成以下步骤：

启动本地服务：程序会在 8085 端口启动一个临时的 HTTP 服务用于接收回调。
浏览器授权：
- 会自动弹出 Google 登录页面。
- 请求权限包括 cloud-platform (云平台权限) 和 userinfo (用户信息)。
选择项目：
- 系统会列出你账号下所有的 Cloud 项目。
- Pro 用户提示：请务必选择你绑定的付费项目 ID，不要选择 gen-lang-client-* 这类免费/临时项目 ID，否则可能无法享受到 Pro 账号的高速率限制和模型访问权。

4. 验证与启动

4.1 检查认证文件

认证成功后，凭证会保存在你配置的 auth-dir 中：

ls -la ~/.cli-proxy-api/
# 应该能看到类似 [email protected] 的文件

4.2 启动代理服务

./cli-proxy-api

此时，服务将监听在 http://localhost:8317（默认），并 ready 接收请求。

5. API 调用示例

一旦服务启动，你就可以使用兼容 OpenAI 格式的客户端来调用 Gemini 模型了。

使用 Curl 测试：

curl http://localhost:8317/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-custom-secret-key-1" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [{"role": "user", "content": "Hello, who are you?"}]
  }'

6. 高级玩法

多账号自动轮询

CLIProxyAPI 支持登录多个 Google 账号。你只需运行多次 --login (指定不同的项目/账号) 即可。系统在运行时会自动在多个账号间进行负载均衡，有效利用配额。

模型别名

你可以在 config.yaml 中为长模型名设置短别名：

oauth-model-alias:
  gemini-cli:
    - name: "gemini-2.5-pro"
      alias: "g2.5p"
      fork: true

常见问题 (FAQ)

认证会过期吗？ OAuth 令牌通常会自动刷新，长期运行无需频繁重新登录。
如何区分免费和 Pro 通道？ 主要取决于你在登录步骤 3 中选择的 Project ID。使用绑定了 Billing 的 Project ID 即可走付费通道。
支持 API Key 吗？ 支持。除了 OAuth，你也可以在 config 中配置 gemini-api-key 来直接通过 API Key 使用，但 OAuth 通常更稳定且不仅限于 API Key 的限制。