TeamoRouter接入 Gemini CLI
Gemini CLI 是 Google 出品的开源 AI 编程 CLI(gemini 命令)。
一、准备:拿到 TeamoRouter API Key
访问 TeamoRouter 控制台 注册账号并创建一个 API Key(格式为 sk-teamo-...),复制备用。完整可用模型列表也在 Dashboard 里查看。
二、从现有安装中接入 TeamoRouter
把下面命令中的 <你的-TeamoRouter-key> 替换成你刚复制的 key,整段粘贴到终端执行:
mkdir -p ~/.gemini && cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.teamorouter.com
GEMINI_API_KEY=sk-teamo-<你的-TeamoRouter-key>
GEMINI_API_KEY_AUTH_MECHANISM=bearer
EOF
保存后无需重启终端或 source,下一次执行 gemini 命令即生效。
跑 gemini 命令时会出现「Get started」引导页,问你 「How would you like to authenticate for this project?」,提供三个选项:
- Sign in with Google
- Use Gemini API Key ← 必须选这个
- Vertex AI
按键盘 ↓ 键移动到 「Use Gemini API Key」,按 Enter 确认。此时Gemini会自动读取你已经配置好的TeamoRouter API Key,按 Enter 确认即可进入正常使用。
如果此前已经选了 OAuth 模式登录,执行下面命令重置:
rm ~/.gemini/settings.json
删除后下次启动
gemini会重新跑认证向导,再选 「Use Gemini API Key」 即可。
三、从零安装 Gemini CLI
安装 Gemini CLI
macOS 用户通过 Homebrew 安装:
brew install gemini-cli
也可以通过 npm 安装(跨平台通用):
npm install -g @google/gemini-cli
Windows 用户推荐 npm 方式(需先装 Node.js)。
配置 TeamoRouter 环境变量
参考上一节「从现有安装中接入 TeamoRouter」,编辑 ~/.gemini/.env 写入三行环境变量并填入你的 TeamoRouter key。之后执行 gemini 命令即可进入使用