接入指南

Gemini CLI

Google 出品的命令行 AI 代理，走 Gemini 原生协议；设好环境变量，就能把请求转到 XylemNode。

安装并验证

推荐用 npm 全局安装；macOS 可以用 Homebrew，临时试用也可以用 npx 免安装运行。装完运行版本号确认命令可用。

# npm（推荐，全平台）
npm install -g @google/gemini-cli

# macOS Homebrew
brew install gemini-cli

# 免安装临时运行
npx @google/gemini-cli

# 验证
gemini --version

设置环境变量

Gemini CLI 通过环境变量接入自定义服务，设三项：接口地址、API Key、默认模型。接口地址填服务域名即可。

# Windows（PowerShell / CMD）
setx GOOGLE_GEMINI_BASE_URL "https://api.xylemnode.com"
setx GEMINI_API_KEY "sk-你的密钥"
setx GEMINI_MODEL "gpt-5.6-sol"

# macOS / Linux
export GOOGLE_GEMINI_BASE_URL="https://api.xylemnode.com"
export GEMINI_API_KEY="sk-你的密钥"
export GEMINI_MODEL="gpt-5.6-sol"

03
或写进 .env 文件
不想设系统变量，也可以把这几项放进 .env 文件，Gemini CLI 启动时会自动加载。用户级全局复用，项目级只对该项目生效。
Windows
%USERPROFILE%\.gemini\.env
macOS / Linux
~/.gemini/.env
项目级
<项目根目录>/.gemini/.env
```
GOOGLE_GEMINI_BASE_URL=https://api.xylemnode.com
GEMINI_API_KEY=sk-你的密钥
GEMINI_MODEL=gpt-5.6-sol
```
04
启动并测试
重开终端后运行 gemini。也可以用 -m 临时指定模型，用 -p 做一次非交互验证。
```
gemini

# 临时指定模型 / 非交互验证
gemini -m gpt-5.6-sol -p "只回复 OK"
```

常见问题

Gemini CLI 明明设了环境变量，却还在走 Google 账号登录？反过来也切不回去？

它的取用顺序是这么定的：首次启动引导你网页登录，之后凭据缓存在本地、不再提示；而只要环境或 .env 里存在 GEMINI_API_KEY，它就直接用这把 key，连登录选项都不展示。所以两个方向的症状各有各的解——想走中转却仍在用 OAuth，多半是 key 没被进程看到（用 setx 写入后没重开终端最常见）；想切回 Google 账号却切不动，就得先把 GEMINI_API_KEY 从环境和 .env 里清掉，再清掉本地缓存凭据。顺带一句：用 cc-switch 配过 Gemini 的，它走的也是环境变量那条路，会把 CLI 固定在 API 模式，卸载 cc-switch 并不会自动恢复。