Gemini CLI - Windows / Linux

本页介绍 Gemini CLI 在 Windows 与 Linux 上的接入思路。由于不同版本对自定义兼容网关的支持程度不同，请先确认你当前版本是否具备该能力。

通用准备

开始前请确认：

• 已安装 Gemini CLI
• 已在 LuminaToken 控制台创建 API Key
• 已确认当前版本支持自定义 provider 或 OpenAI 兼容接入

安装完成后，先执行：

gemini --version

Windows PowerShell

如果当前版本支持通过环境变量接入兼容网关，可以先在 PowerShell 中临时设置：

$env:OPENAI_BASE_URL="https://api.luminatoken.cc/v1"
$env:OPENAI_API_KEY="你的API_Key"

这组变量名是 OpenAI 兼容场景中的常见写法；若你的版本使用别名，请保留值不变，替换变量名即可。

Linux bash

如果当前版本支持环境变量方式，可在 bash 中设置：

export OPENAI_BASE_URL=https://api.luminatoken.cc/v1
export OPENAI_API_KEY=你的API_Key

如需持久化，可写入 ~/.bashrc：

export OPENAI_BASE_URL=https://api.luminatoken.cc/v1
export OPENAI_API_KEY=你的API_Key

然后执行：

source ~/.bashrc

验证

建议依次检查：

1. gemini --version
2. 环境变量或配置文件是否正确读取
3. 最小请求是否能返回结果

如果你当前版本支持查看 endpoint 或 provider 的命令，可以优先使用它确认请求没有走错地址。

版本差异说明

这类 CLI 的差异点通常在于：

• 是否支持 OpenAI 兼容协议
• 是否支持自定义 Base URL
• API Key 字段名是什么

但只要你的版本支持兼容接入，LuminaToken 侧的核心值始终一致：

• Base URL：https://api.luminatoken.cc/v1
• API Key：LuminaToken 控制台创建的 Key

排查建议

版本本身不支持兼容网关

此时不建议继续硬配，优先查看该版本官方文档，或改用 Claude Code、Codex 作为主接入工具。

环境变量设置了但请求没有走 LuminaToken

• 检查是否还有其他 provider 配置覆盖
• 检查变量名是否与当前版本匹配
• 检查是否在新终端里重新加载过 shell 配置

请求报认证错误

• 检查 API Key 是否正确
• 检查账户余额
• 检查 Base URL 是否指向 /v1

下一步

• 如果你要稳定完成代码级工作，建议优先看 Claude Code 概览 与 Codex 概览。