Gemini CLI 原生接口接入：认证模式、版本路径与环境变量

三条认证路线不能混配

Gemini CLI 官方文档区分 Google 账户登录、Gemini API Key 与 Vertex AI 认证。 如果要指向一个 Gemini 兼容地址，本页讨论 Gemini API Key 路线；它不是 OpenAI Chat Completions 客户端，不能只换成 /v1 就假设请求结构一致。

首先向实际服务方确认是否接收原生 Gemini 请求、支持哪个 API 版本和模型名。Google 登录与企业项目权限的问题，不应通过随意追加第三方密钥解决；Vertex 使用的项目与认证变量也不属于本页示例。

地址覆盖只作用于对应模式

官方配置规范确认，GOOGLE_GEMINI_BASE_URL 在 gemini-api-key 认证模式下覆盖 Gemini API 地址，GOOGLE_GENAI_API_VERSION 覆盖 SDK 使用的版本。地址须为有效 URL，非本地地址要求 HTTPS。

以下根地址按原生协议展示，仅为占位示例，不存在已提供的真实接口。版本和模型也必须按真实服务规格重新确认，不能靠示例推断支持情况。

export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://80321.cn"
export GOOGLE_GENAI_API_VERSION="v1beta"

首次启动 gemini 后，官方流程要求选择 Use Gemini API key。 只改地址但继续使用另一种认证模式，不能证明覆盖已生效。

从设置来源排除旧值

持久配置位于 ~/.gemini/settings.json；项目 .gemini/settings.json 可以覆盖用户值，系统设置又有更高约束。命令行参数也参与解析。 排查时先记录哪些层存在，而不是删除全部设置来“重装”。

Gemini CLI 还会加载环境文件，扩展也可能携带自己的环境配置。 因此换一个终端并不总能排除旧变量。检查变量名与来源即可，不把 Key 的值打印到日志，也不要将环境文件作为问题附件上传。

用一个非交互请求检查模型

官方 -p/--prompt 进入非交互模式，-m/--model 选择模型。 取得正式服务参数后，最小验证可采用下面的未执行形式：

gemini -m YOUR_MODEL_ID -p "只返回 OK，不读取文件、不执行命令"

先判断认证模式是否正确，再看服务端返回。认证错误核对凭证与请求方式；模型错误核对标识和可访问范围；路径错误核对根地址与 API 版本的组合。客户端能启动，不表示请求已经到达预期上游。

兼容范围只按实际验收扩大

简单文本回答通过后，才能逐项检查流式输出、工具调用与上下文行为。不要把代理层返回的普通聊天 JSON 当作 Gemini 原生响应，也不要用无限重试掩盖格式不匹配。保留必要的错误类型和脱敏请求路径，避免泄露项目内容。本文核对了配置文档，没有安装客户端或完成真实服务联通验证。