小蓝中转站使用文档

常见问题 (FAQ) ​

首次配置可先看 Windows 快速接入 或 macOS 快速接入。

身份与鉴权 (Auth) ​

为什么我的 Key 一直提示无效？ ​

先查最常见的三件事：

  • 复制时是否带入了前后空格、换行或隐藏字符
  • 自己写脚本时是否漏掉了 Authorization: Bearer ...
  • 控制台里这把 Key 是否已禁用、余额不足或命中限制

很多桌面客户端会自动补 Bearer，所以“图形界面能用、自己写 curl 报错”的根因，往往就是 Header 少写了这一层。

怎么监控我的账单和消耗？ ​

登录 小蓝中转站控制台，首页 Dashboard 和日志面板可以看到精确到每一条请求的调用记录、Token 消耗和计费明细。

想把 Claude Code、Codex、Cherry Studio 的消耗分开看，最省事的做法就是给每个工具单独建一把 Key。

节点与连通性 ​

为什么打开模型广场或控制台一片空白？ ​

常见原因：

  • 浏览器插件拦截脚本或请求
  • 浏览器缓存异常
  • 当前网络把控制台静态资源拦了

先关掉广告拦截、脚本拦截类插件，再用无痕窗口重开一次。
如果无痕正常、普通窗口异常，问题大概率就在浏览器缓存或扩展。

接口端点 (Endpoint) 到底填什么？ ​

支持 OpenAI 兼容接口的工具，Base URL 一般填：

txt
https://xiaolan.ainb.plus/v1

但不是所有工具都这样。Claude Code 和 Gemini CLI 是两个最容易填错的例外，具体见下面的 Base URL 要不要加 /v1。

工具应该去哪里下载？ ​

优先走官方入口，后面排障最容易对得上。

常用下载入口：

国内网络环境下第一次装 Node.js，优先看中文站或镜像归档，通常比直接开英文官网更省时间。

终端与环境变量 ​

npm install 卡在 idealTree 动不了？ ​

这类问题多数不是 小蓝中转站 接口故障，而是 npm 下载源太慢或缓存状态不干净。

先切国内镜像：

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

再确认：

bash
npm config get registry

输出 https://registry.npmmirror.com/ 后，再重新执行安装命令。

如果还是卡住：

bash
# 清理 npm 缓存，排除缓存索引异常
npm cache clean --force

然后换一个新终端重试。

安装 Claude Code 前还要装什么？ ​

要先看你走哪条安装路线。

走 npm 安装 时，node 和 npm 就是硬前置：

bash
node -v
npm -v

走 原生安装脚本 / Homebrew / WinGet 时，Node.js 不是 Claude Code 唯一前置；但后面还要继续装 Codex、Gemini CLI、其他 npm CLI 时，提前把 Node.js 和 npm 装好会更省事。

git 则很值得一起准备：

bash
git --version

原因不是“为了多装一个软件”，而是：

  • Claude Code、Codex 处理项目时会读取仓库状态、diff 和分支历史
  • Windows 上装了 Git for Windows 后，还会附带 Git Bash，很多 Bash 风格命令更顺手
  • 就算新版本 Claude Code 在 Windows 上没有 Git Bash 也能退回 PowerShell，装好 Git 之后，很多教程和脚本仍然更容易对齐

Windows 新手直接先把 PowerShell 执行策略、Git、Node.js 跑通，再装 Claude Code 最省事：

  1. Windows 快速接入
  2. Windows Node 安装

Claude Code 为什么能装上，但还是走官方登录？ ​

这通常不是“Claude Code 不支持网关”，而是当前终端根本没读到你刚写的变量。

先检查：

bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY
echo $ANTHROPIC_MODEL

Windows PowerShell：

powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY
echo $env:ANTHROPIC_MODEL

如果这些值在当前窗口里都为空，Claude Code 当然会继续走自己的默认登录流程。

Claude Code 看不到模型列表怎么办？ ​

先确认两层：

  1. 这把 Key 是否真有对应模型权限
  2. 是否已经打开 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Claude Code 官方当前支持在 ANTHROPIC_BASE_URL 指向网关时，请求网关的 /v1/models，把识别到的模型加入 /model 选择器。
这个发现功能不是默认强制开启的，所以你明明接到了网关，也不一定会自动看到所有模型。

如果模型广场里有、/model 里没有，先直接用完整模型名测试：

bash
claude --model 从模型广场复制的模型名

分组到底怎么选？ ​

分不清各分组的价格、地区或路由差异时，第一次先选 auto 或默认分组更稳。

这样做的好处是：

  • 先把真实链路跑通，不会一上来就被分组限制绊住
  • 更不容易把“权限不够”误判成“客户端配错”
  • 后面确认工具都能正常返回后，再按成本和模型类型慢慢收紧

想把日志、权限和额度拆清楚，给 Claude Code、Codex、Cherry Studio 分别建 Key 会更舒服。

Codex 要怎么装最省事？ ​

常见顺序：

  1. 已经装好 Node.js：直接 npm install -g @openai/codex@latest
  2. 常用 Homebrew：brew install --cask codex
  3. 不想走包管理器：去官方发布页下载对应系统压缩包

入口：

Gemini CLI 要怎么装最省事？ ​

只想先试一下时，优先：

bash
npx @google/gemini-cli

准备长期使用时，再装到全局：

bash
npm install -g @google/gemini-cli

macOS / Linux 常用 Homebrew 时，也可以：

bash
brew install gemini-cli

macOS 还支持 MacPorts：

bash
sudo port install gemini-cli

官方入口优先看：

Gemini CLI 版本更新很快。碰到变量名、安装方式或模型选择不一致时，优先回官方仓库和官方文档目录核对。

改了环境变量，但工具还是不走网关？ ​

先分两层看：

  • 终端有没有重读到新变量
  • 这个工具读的是不是你以为的那组变量

处理顺序：

  • Windows：完全关闭当前 PowerShell 窗口，再打开一个新窗口
  • macOS / Linux：执行 source ~/.zshrc、source ~/.bashrc，或重开终端
  • VSCode 内置终端：必要时直接重启 VSCode

再检查：

bash
echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Windows PowerShell：

powershell
echo $env:OPENAI_BASE_URL
echo $env:OPENAI_API_KEY
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

正在用 CC-Switch 时，还要额外留意旧环境变量冲突。CC-Switch 官方当前就把这类冲突列为高频问题：你以为已经切到了新配置，实际终端还在优先读以前手动写进去的旧变量。

Base URL 要不要加 /v1？ ​

大多数 OpenAI 兼容工具要加 /v1：

txt
https://xiaolan.ainb.plus/v1

比如：

  • Codex
  • OpenAI SDK
  • 各类直接填写 OpenAI Base URL 的脚本和客户端

但下面这些是例外：

Claude Code

txt
https://xiaolan.ainb.plus

Claude Code 走 Anthropic 协议变量，自己会继续拼 Anthropic 接口路径。这里再手动加 /v1，很容易把地址拼坏。

Gemini CLI

txt
https://xiaolan.ainb.plus

Gemini CLI 当前官方变量是 GOOGLE_GEMINI_BASE_URL，它会自己继续拼接 Gemini API 路径。这里再加 /v1，同样容易错。

Cherry Studio

txt
https://xiaolan.ainb.plus

Cherry Studio 常见填法也是根地址，再由客户端自己补兼容路径。它和很多“直接写 OpenAI Base URL 的工具”不完全一样。

API Key 要不要带 Bearer？ ​

看你在哪儿填。

图形客户端通常只需要填：

txt
sk-你的专属Key

自己写 curl 或代码时，要写完整 Header：

txt
Authorization: Bearer sk-你的专属Key

模型名从哪里复制？ ​

从 模型广场 复制。

不要从旧教程、论坛截图、别人的配置片段里抄模型名。最常见的问题不是工具不支持，而是你复制到的是过期模型名。

Cherry Studio 获取不到模型怎么办？ ​

先检查：

  1. 服务商类型是否选成 OpenAI 兼容
  2. API 地址是否填成 https://xiaolan.ainb.plus
  3. 保存后有没有点过 Check
  4. Key 是否有效
  5. 当前 Key 是否有模型权限

自动获取失败时，直接去模型广场手动复制模型名。

CC-Switch 去哪里下载？ ​

国内用户优先打开：

Windows 第一次安装优先选 .msi；没有安装权限或只想临时用，再选 Portable.zip。

macOS 当前官方文档已经明确写了签名和公证，正常情况下可以直接安装打开。

业务与对公 ​

你们可以开具正规发票吗？ ​

暂不支持。当前暂不支持业务合作、对公转账、开具发票或企业大额采购流程。普通充值、接入或账号问题可联系站长 QQ：1527997732。

小蓝中转站使用文档

© 2026 小蓝中转站