无需海外服务器与代理：手把手用 XAI Control 分发 Google Gemini Code Assist

Posted October 6, 2025 by XAI 技术团队 ‐ 10 min read

Google Gemini Code Assist 是 Google Cloud 推出的一款强大的 AI 编程助手，深度集成于各类 IDE 中。通常，使用它需要在 IDE 中配置 Google Cloud 认证，但其开放的 API 架构为我们提供了更灵活的解决方案：在线注册 XAI Control 即刻拥有一个自己专属的中转服务，使用您自己的 Google 账号来驱动它。

本指南基于官方 Gemini CLI 与我们自研的 gemini-cloud 转换服务，带你在不搭建代理的前提下，稳定享受 Gemini Code Assist 的强大功能，并获得 XAI Control 带来的密钥安全管理、成本控制与统一入口等优势。

提示：如果你更偏好 API Key 接入 的方式（无需官方账号登录），请参考工具推荐：
• Claude Code（API Key 接入）
• Gemini CLI（API Key 接入）

先决条件

在开始之前，请确保您已具备：

一个 Google 账号，并已开通 Gemini 或 Gemini Code Assist 访问权限。
一个 XAI Control 账户：如果还没有，请访问 a.xaicontrol.com 免费注册，并阅读说明文档 xaixapi.com/docs/products/xai-control。
本地已安装 Node.js（用于安装 Gemini CLI）与 Google Cloud SDK（用于登录与获取凭证）：如未安装请先完成「步骤一」。

步骤一：安装必要工具

A. 安装 Node.js 环境

Gemini CLI 是一个基于 Node.js 的命令行工具，因此需要先安装其运行环境。

MacOS 安装方法

方法一：使用 Homebrew（推荐）

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

方法二：官网下载

访问 https://nodejs.org/
下载适合 macOS 的 LTS (长期支持) 版本。
打开下载的 .pkg 文件，按照安装程序指引完成安装。

Windows 安装方法

方法一：官网下载（推荐）

访问 https://nodejs.org/
点击 "LTS" 版本进行下载。
下载完成后双击 .msi 文件，按照安装向导完成安装，保持默认设置即可。

方法二：使用包管理器

# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs

验证 Node.js 安装

node --version
npm --version

B. 安装 Gemini CLI（官方）

现在可以安装 Google 官方的 Gemini CLI。

MacOS 安装

方法一：使用 Homebrew（推荐）

brew install gemini-cli

方法二：使用 npm

npm install -g @google/gemini-cli

Windows 安装

打开 PowerShell (建议以管理员身份运行)，运行：

npm install -g @google/gemini-cli

Linux 安装

npm install -g @google/gemini-cli

验证安装

gemini --version

如果显示版本号，说明 Gemini CLI 已成功安装。

C. 安装 Google Cloud SDK（gcloud）

Google Cloud SDK (gcloud) 用于获取 Google 账号的认证令牌。

MacOS 安装

使用 Homebrew（推荐）

brew install --cask google-cloud-sdk

Windows 安装

访问 https://cloud.google.com/sdk/docs/install 下载并安装。

Linux 安装

# 下载并执行安装脚本
curl https://sdk.cloud.google.com | bash

# 重启 shell
exec -l $SHELL

# 初始化 gcloud
gcloud init

验证安装

gcloud --version

步骤二：获取 GEMINI_REFRESH_TOKEN（刷新令牌）

刷新令牌相当于你的 Google 账号长效授权，可用来代表你访问 Code Assist API（服务端会自动换取短期 access token）。

通过 Application Default Credentials（推荐）

在终端中执行以下命令，它会打开浏览器进行认证：
```
gcloud auth application-default login
```
在浏览器中登录您的 Google 账号并授权。
认证成功后，gcloud 会将凭证保存到本地配置文件中。

查看并提取 refresh token：

# MacOS/Linux
cat ~/.config/gcloud/application_default_credentials.json

# Windows (PowerShell)
Get-Content $env:APPDATA\gcloud\application_default_credentials.json

在输出的 JSON 中找到 refresh_token 字段并复制其值。这就是本文后续会用到的 GEMINI_REFRESH_TOKEN。

步骤三：在 XAI Control 中配置 Provider（把刷新令牌托管给平台）

将步骤二得到的 GEMINI_REFRESH_TOKEN 安全托管到 XAI Control，平台即可代你完成令牌换取、续期与用量治理。

登录控制台：a.xaicontrol.com
进入「模型服务商」→「新增 Provider Key」
表单建议如下：
- Name（可选）：My-Gemini-Token
- Level：1（或任意正整数，便于分组/分流）
- Provider：http://172.31.88.86:7795（我们的云托管 gemini-cloud provider，必须填写该地址）
- SecretKey：粘贴步骤二获取的 GEMINI_REFRESH_TOKEN
提交保存。

说明：gemini-cloud 是我们开源/托管的 Code Assist 兼容中间层，负责把刷新令牌转换为可用的 access token，并对请求做必要字段补全。默认请使用我们云托管的 Provider 地址 http://172.31.88.86:7795；如需自建请联系我们获取指引。

步骤四：配置 Gemini CLI 指向中继服务（最关键）

Gemini CLI 的 Code Assist 模式默认直连 Google。要通过中继服务（托管或自建 gemini-cloud）转发，只需把 CLI 的「Code Assist 接入点」改为你的中继地址。

环境变量名称以官方源码为准：CODE_ASSIST_ENDPOINT（推荐默认：https://api.xaicontrol.com）另外，为了让 CLI 向中继网关完成鉴权，需要设置： GOOGLE_GENAI_USE_GCA=true 与 GOOGLE_CLOUD_ACCESS_TOKEN（填你的 XAI API Key）。

macOS / Linux

临时设置（仅当前会话，推荐）：

export CODE_ASSIST_ENDPOINT="https://api.xaicontrol.com"
export GOOGLE_GENAI_USE_GCA=true
export GOOGLE_CLOUD_ACCESS_TOKEN="你的 XAI API Key"

永久设置：

# zsh（macOS 默认）
echo 'export CODE_ASSIST_ENDPOINT="https://api.xaicontrol.com"' >> ~/.zshrc
echo 'export GOOGLE_GENAI_USE_GCA=true' >> ~/.zshrc
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的 XAI API Key"' >> ~/.zshrc
source ~/.zshrc

# bash
echo 'export CODE_ASSIST_ENDPOINT="https://api.xaicontrol.com"' >> ~/.bash_profile
echo 'export GOOGLE_GENAI_USE_GCA=true' >> ~/.bash_profile
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的 XAI API Key"' >> ~/.bash_profile
source ~/.bash_profile

Windows（PowerShell）

临时设置（仅当前窗口，推荐）：

$env:CODE_ASSIST_ENDPOINT = "https://api.xaicontrol.com"
$env:GOOGLE_GENAI_USE_GCA = "true"
$env:GOOGLE_CLOUD_ACCESS_TOKEN = "你的 XAI API Key"

永久设置（用户级）：

[System.Environment]::SetEnvironmentVariable("CODE_ASSIST_ENDPOINT", "https://api.xaicontrol.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GENAI_USE_GCA", "true", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_CLOUD_ACCESS_TOKEN", "你的 XAI API Key", [System.EnvironmentVariableTarget]::User)

可选：若希望在非交互脚本中强制使用「登录 Google（GCA）」的 Code Assist 模式，可设置：

export GOOGLE_GENAI_USE_GCA=true

说明：Code Assist 模式不使用 GEMINI_API_KEY。如你更偏好「Gemini API Key（AI Studio）」方式，请改看「工具」文档：/docs/tools/gemini-cli/。小贴士：XAI API Key 可在注册成功邮件（主题“Welcome to XAI - Your Account is Ready!”）或控制台个人中心获取。

步骤五：开始使用！

🎉 恭喜！所有配置均已完成。现在您可以像使用官方服务一样在终端中与 Gemini 交互了。

示例 1：进入交互模式（首次会引导登录 Google）

gemini

You: >> 用 Python 写一个快速排序算法

示例 2：非交互模式提问

gemini -p "解释一下什么是递归"

示例 3：包含特定目录上下文

gemini --include-directories ./src,./lib

只要 CODE_ASSIST_ENDPOINT 指向 https://api.xaicontrol.com，gemini 的请求就会由该中继稳定转发至 Google Code Assist。

为什么选择这种方式？

统一管理：在 XAI Control 配置管理 a.xaicontrol.com 统一管理 OpenAI、Anthropic、Gemini 等多家模型密钥。
分配账户：在 XAI Control 用户管理 m.xaicontrol.com 给成员/项目分配独立额度与权限。
安全可靠：原始 Google 凭证不落本地，平台侧零信任加密存储，降低泄露风险。
成本与权限控制：精细化控制额度、可用模型与速率限制，沉淀用量审计。
高可用性：享受托管中继的熔断/切换与密钥轮换能力，稳定可依赖。

无需海外服务器与代理：手把手用 XAI Control 分发 Google Gemini Code Assist

先决条件

步骤一：安装必要工具

A. 安装 Node.js 环境

MacOS 安装方法

Windows 安装方法

验证 Node.js 安装

B. 安装 Gemini CLI（官方）

MacOS 安装

Windows 安装

Linux 安装

验证安装

C. 安装 Google Cloud SDK（gcloud）

MacOS 安装

Windows 安装

Linux 安装

验证安装

步骤二：获取 GEMINI_REFRESH_TOKEN（刷新令牌）

通过 Application Default Credentials（推荐）

步骤三：在 XAI Control 中配置 Provider（把刷新令牌托管给平台）

步骤四：配置 Gemini CLI 指向中继服务（最关键）

macOS / Linux

Windows（PowerShell）

步骤五：开始使用！

示例 1：进入交互模式（首次会引导登录 Google）

示例 2：非交互模式提问

示例 3：包含特定目录上下文

相关资源

为什么选择这种方式？