小蓝中转站使用文档

接入 Gemini CLI ​

Gemini CLI 当前版本更适合按官方 Gemini 变量接入 小蓝中转站 网关。

这里不是填写 Google 官方控制台里的 Key，而是让 Gemini CLI 读取 Gemini API 变量，把请求发到 小蓝中转站 的 Gemini 兼容入口。配置完成后，终端里的 gemini 会把请求发往 https://xiaolan.ainb.plus，再由 CLI 自动补上 Gemini API 的实际路径。

开始前先检查 ​

这些命令用于确认本机能安装和运行 Gemini CLI：node 和 npm 用来安装 CLI，git 供工具读取项目仓库，npm registry 用来判断下载源是否适合国内网络。

bash
node -v
npm -v
git --version
npm config get registry

npm 下载慢时：

bash
npm config set registry https://registry.npmmirror.com

方式一：使用 CC-Switch ​

使用 CC-Switch 可以通过图形界面管理配置：

这种方式适合不想手动维护环境变量的用户。保存配置后，重新打开终端再启动 Gemini CLI。

  1. 打开 CC-Switch。
  2. 切到 Gemini 标签页，建立新配置。
  3. 填入核心参数：
    • Gemini API Base URL / Base URL：https://xiaolan.ainb.plus
    • API Key：小蓝中转站控制台创建的 Key
    • Model：从模型广场复制模型名。
  4. 保存配置并应用。
  5. 在终端重新唤醒 Gemini CLI。

Gemini CLI 会自己继续拼接 /v1beta/models/... 这类 Gemini API 路径，所以这里只填根地址。手动补 /v1 后，请求路径通常会拼错，常见现象是工具启动后直接报 endpoint 错误或返回 404。

模型怎么选 ​

Gemini CLI 适合长上下文、总结和代码理解任务。第一次测试先选轻量模型确认链路；处理长文档或大项目时，再切换到长上下文模型。

第一次接入时，建议把这三个概念分开看：

  • Key 分组：决定这把 Key 能走哪些可用渠道
  • 模型权限：决定这把 Key 能调用哪些模型
  • GEMINI_MODEL / --model / /model：决定 Gemini CLI 当前会话实际请求哪个模型

选择顺序：

  1. 在模型广场复制 Gemini 或长上下文模型名。
  2. 确认 Key 的分组和模型权限包含该模型。
  3. 在 CC-Switch 或 CLI 配置里填入完整模型名。

如果你已经改了 GEMINI_MODEL，但当前会话仍然总是走旧模型，优先检查当前项目目录里是不是还有额外的 .gemini 配置覆盖默认值。

常见切法：

bash
# 这一次启动临时使用某个模型
gemini --model 从模型广场复制的模型名

进入 Gemini CLI 后，也可以直接输入：

txt
/model

/model 更适合在当前会话里临时切换；GEMINI_MODEL 更适合给终端环境设置默认模型。

方式二：手动写入环境变量 ​

手动方式适合长期固定使用同一套 小蓝中转站 配置的终端环境。

1. 安装 Gemini CLI

Gemini CLI 官方提供的常见安装方式比多数 CLI 更丰富：

  1. npx 直接运行，不落全局安装
  2. npm 全局安装
  3. Homebrew 安装
  4. MacPorts 安装

官方入口：

只想临时试一次时，先用 npx。准备长期使用时，再安装到全局。

方式一：npx（不需要先全局安装）

bash
npx @google/gemini-cli

方式二：npm 全局安装

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

macOS 上用浏览器安装 Node.js 的机器，执行这一步时更常见的写法是：

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

终端出现钥匙图标或 Password: 提示后，密码不会显示任何字符，直接输入完成后按回车即可。

方式三：Homebrew（macOS / Linux）

bash
brew install gemini-cli
gemini --version

方式四：MacPorts（macOS）

bash
sudo port install gemini-cli
gemini --version

2. 写入请求端点 这里使用 Gemini CLI 当前版本支持的官方变量，把请求转到 小蓝中转站 的 Gemini 兼容入口。

临时生效（当前终端窗口）：

bash
# Gemini API 根地址，Gemini CLI 会在后面继续拼接 /v1beta/models/... 路径
export GOOGLE_GEMINI_BASE_URL="https://xiaolan.ainb.plus"

# 小蓝中转站控制台创建的 Gemini CLI 专用 Key
export GEMINI_API_KEY="sk-你的专属Key"

# 模型名以模型广场为准，直接复制完整名称
export GEMINI_MODEL="从模型广场复制的模型名"

如果需要持久化，把上面三行追加到 ~/.zshrc 或 ~/.bashrc，并执行 source 重载。

如果你更习惯用 Gemini CLI 自己的设置文件，也可以留意它的设置覆盖层。当前官方文档提供了用户级和项目级设置文件思路：

  • 用户级：主目录下的 Gemini 设置文件
  • 项目级：当前仓库里的 .gemini/ 设置

如果你已经写了环境变量，却发现某个项目里仍然总是走旧模型或旧配置，优先检查当前项目目录里是不是还有一份 .gemini 配置把默认值覆盖掉了。

3. 启动并测试

bash
gemini

为什么这里不是 OPENAI 变量 ​

Gemini CLI 当前官方文档使用的是 GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY、GEMINI_MODEL 这一组变量，而不是 OPENAI_BASE_URL。

原因很简单：Gemini CLI 自己走的是 Gemini API 协议。把 GOOGLE_GEMINI_BASE_URL 指向 https://xiaolan.ainb.plus 后，CLI 会继续拼接 Gemini API 的请求路径；小蓝中转站 则在这个入口上统一鉴权、计费和转发。

所以这里虽然仍然使用 小蓝中转站控制台创建的 Key，但变量名要跟 Gemini CLI 当前版本的官方约定保持一致。这样后续升级 CLI 时，配置也更稳。

最小验证 ​

先建一个测试目录：

bash
mkdir -p ~/gemini-xiaolan-test
cd ~/gemini-xiaolan-test
gemini

进入后发送：

txt
用一句话介绍当前目录。

能正常回复，再切换到真实项目。

第一次真正算接通时，通常要同时满足：

  1. gemini 命令能正常启动
  2. 不会要求你回到别的 Provider 或旧登录流程
  3. 发一句短消息后能正常返回
  4. 当前模型确实是你刚写进去或刚切换的那一个

这一步走通后，再切到真实项目目录会更稳。

使用建议 ​

  1. 为 Gemini CLI 单独创建 Key，便于在日志中统计消耗。
  2. 接入后先用轻量模型发送“你好”，确认网络和鉴权正常。
  3. 遇到 400 报错时，先检查模型名称和 Key 权限。模型名以模型广场为准。
  4. 修改变量后新开终端窗口，再执行 echo $GOOGLE_GEMINI_BASE_URL、echo $GEMINI_API_KEY 和 echo $GEMINI_MODEL。
  5. 如果某个项目里改了模型却总不生效，检查当前目录有没有额外的 .gemini 配置覆盖默认值。
  6. Windows PowerShell 持久化变量：
powershell
# Gemini API 根地址，不要加 /v1
[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://xiaolan.ainb.plus", "User")

# 小蓝中转站控制台创建的 Gemini CLI 专用 Key
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "sk-你的专属Key", "User")

# 模型名以模型广场为准
[Environment]::SetEnvironmentVariable("GEMINI_MODEL", "从模型广场复制的模型名", "User")

写完后关闭当前 PowerShell，重新打开。

小蓝中转站使用文档

© 2026 小蓝中转站