常见问题

账号与 Key

211API 的 Key 和官方 Key 有什么区别？

211API 的 Key 在控制台创建，以 sk- 开头，用于走 211API 的中转通道；它不是 Anthropic / OpenAI / Google 的官方 Key，二者不通用。配置时请务必使用 211API 控制台创建的 Key。

一个 Key 可以同时给多个工具用吗？

可以。同一个 API Key 可同时配置到 Claude Code、CodeX、Gemini CLI，由 211API 统一路由，用量逐条可查。

Key 泄露了怎么办？

立即在控制台吊销该 Key 并新建一个。建议为不同环境使用不同 Key，并为 Key 设置额度上限。

接入与报错

401 鉴权失败

确认环境变量里填的是 211API 控制台创建的 Key，而不是各厂商官方 Key；再确认接口地址没有多余的路径后缀（Claude Code 用根地址，CodeX / Gemini CLI 用 /v1 地址）。

提示模型不存在

配置中的模型名需与 211API 控制台「模型列表」完全一致，注意大小写与后缀。

连接超时

检查接口地址是否误带多余路径后缀，并保持终端代理设置与系统网络环境一致。

Windows 环境变量不生效

setx 写入后需要重开终端才会生效；PowerShell 会话内可用 $env:变量名 回读确认。

计费

费用如何计算？

按实际 Token 消耗 × 模型刊例价 × 渠道倍率计费，倍率全部公开，最低按官方刊例价 5% 计费。详见价格方案。

在哪里看用量？

211API 控制台可实时查看每次调用的去向、Token 消耗与倍率明细，以及当前余额、充值与消费记录。

余额不足会怎样？

服务会暂停，充值后立即恢复。建议在控制台为 Key 设置额度提醒，避免中断正在进行的任务。

环境与安装

npm 安装很慢或失败？

切换国内镜像后重试：

npm config set registry https://registry.npmmirror.com
npm config get registry   # 验证

Node.js 版本过低怎么办？

三大工具都需要 Node.js 18+。Windows 重新下载最新 LTS 安装包覆盖安装；macOS 用 brew upgrade node；Linux 推荐用 nvm 管理多版本。

环境变量设置后不生效？

Windows 重开终端（setx 只对 新窗口生效）；macOS / Linux 执行 source ~/.zshrc 或 source ~/.bashrc。

网站访问

控制台打开白屏？

多半是广告过滤插件（AdBlock、uBlock Origin、AdGuard 等）误拦截。把 www.211api.com 加入插件白名单后刷新页面；也可强制刷新（Windows：Ctrl + Shift + R，macOS：Cmd + Shift + R）。

获取帮助

接入中遇到鉴权、模型或额度问题，在 211API 控制台 提交排查 —— 7×24 小时监控，一对一人工服务，专业运营团队会尽快响应。