Gemini CLI 接入 6星中转：先确认版本，再填根地址

等不及了，先看这张表

Gemini CLI 的手动配置比 Codex 和 Claude 更依赖版本能力。能一键导入时优先用一键导入；必须手动时，再按下面口径核对。

推荐路径

准备工作

• 已安装 Gemini CLI，并确认终端能执行 gemini 或对应启动命令。
• 已在 6星中转 创建 Gemini 相关模型可用的令牌。
• 已从 6星中转 模型广场复制当前可用的 Gemini 模型 ID。
• 本机网络能访问 https://www.6xin.cc。

安装和更新检查

先确认你运行的是预期的 Gemini CLI，而不是系统里残留的旧命令。

which gemini
gemini --version
gemini --help

一、确认当前版本能不能手动接入

不同版本读取配置的位置不同。先看版本、帮助和当前配置入口，不要直接复制别人的字段名。

gemini --version
gemini --help

二、字段应该填什么

字段名以你的 Gemini CLI 版本为准，但值按下面规则填写。Gemini 手动配置最容易错在地址路径和末尾斜杠。

三、常见配置形态

官方 Gemini CLI 会读取 settings 文件、环境变量、项目 .env 和命令行参数；配置优先级会影响最终生效结果。下面只展示要核对的“值”，字段名必须以你当前版本或 CC Switch 生成结果为准。

# 示例：不要原样复制字段名，按你的 Gemini CLI 版本改成实际名称
API_ENDPOINT_OR_BASE_URL="https://www.6xin.cc/"
GEMINI_API_KEY="sk-你的令牌"
GEMINI_MODEL="gemini-示例模型"

四、配置从哪里生效

当你明明改了配置但 Gemini CLI 仍然走旧地址时，通常是用户级、项目级、环境变量或启动参数发生覆盖。

五、先用 6星中转 接口直测

在 Gemini CLI 里排障前，先用 OpenAI 兼容接口确认令牌和模型本身可用。这里的 /v1 是接口直测路径，不代表 Gemini CLI 手动字段也要写 /v1。

curl "https://www.6xin.cc/v1/chat/completions" \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-示例模型",
    "messages": [
      {"role": "user", "content": "回复 OK"}
    ]
  }'

这一步成功，说明 6星中转 令牌、分组和模型基本可用；如果 Gemini CLI 仍失败，再看本地配置读取。

六、启动 Gemini CLI 验证

1. 关闭旧 Gemini CLI 终端。
2. 打开新终端，确认环境变量或配置文件已经生效。
3. 启动 Gemini CLI，只发送一句短问题，例如“回复 OK”。
4. 返回成功后，到 6星中转 用量日志按时间点核对记录。

七、失败时按这个顺序排查

错误现象速查

完成标准

恢复或切回默认

临时测试只改了当前终端环境变量时，关闭终端即可恢复。写入配置文件或 .env 时，删除 6星中转 相关字段后重新打开 Gemini CLI。

Gemini CLI 仍然不通时，提交这些定位信息

Gemini CLI 的配置方式会随版本和兼容层变化。排障时先证明当前版本支持自定义端点，再把字段值、配置来源和 6星中转 回证分开提交。

如果版本不支持手动端点，优先看 CC Switch 切换 Gemini CLI；如果错误码明确，继续按 FAQ 错误码速查 分流。