客户端接入
Gemini CLI 接入
Gemini CLI 通过 Gemini 原生协议接入 Lumoswitch。配置 API 必须启用 Gemini 输出，目标模型需要支持 Gemini CLI 使用的流式响应和函数调用。
直接启动
export GEMINI_API_KEY="your-lumoswitch-access-key" GEMINI_MODEL="your-client-facing-model-name" GOOGLE_GEMINI_BASE_URL="https://api.lumoswitch.com" && \
export GEMINI_CLI_SYSTEM_SETTINGS_PATH="$HOME/.gemini/lumoswitch-system-settings.json" && \
node -e 'const fs=require("node:fs"),path=require("node:path"),p=process.env.GEMINI_CLI_SYSTEM_SETTINGS_PATH;fs.mkdirSync(path.dirname(p),{recursive:true});fs.writeFileSync(p,JSON.stringify({security:{auth:{selectedType:"gemini-api-key",enforcedType:"gemini-api-key"}}},null,2)+"\n",{mode:0o600})' && \
gemini --model "your-client-facing-model-name"Gemini CLI 首次运行时，即使发现 API Key 也可能显示认证方式选择。上述命令使用官方的 GEMINI_CLI_SYSTEM_SETTINGS_PATH 创建 Lumoswitch 专用设置文件，固定并强制使用 gemini-api-key，因此不会进入 Google 登录流程。它不修改用户现有的 ~/.gemini/settings.json，Access Key 仍只存在于当前 shell 环境。
此命令需要 Node.js；它也是 Gemini CLI 的安装前置条件。Base URL 必须使用站点根地址，不要添加 OpenAI-compatible 的 /v1。
参考：Gemini CLI 认证 和 配置参考。