Gemini CLI - macOS

本页介绍 Gemini CLI 在 macOS 上的安装与接入思路。由于 Gemini CLI 的不同版本在认证方式上差异较大，请先确认你当前版本是否支持自定义兼容网关。

环境准备

开始前请确认：

• 系统为 macOS
• 已安装 Node.js 与 npm
• 已在 LuminaToken 控制台创建 API Key

安装 Gemini CLI

请以你当前所使用的 Gemini CLI 官方安装方式为准。安装完成后，先确认 CLI 能正常运行，再进行网关配置。

安装验证的通用思路是：

gemini --version

如果你的命令名不同，请以该工具实际可执行文件为准。

接入 LuminaToken 的建议方式

当你的 Gemini CLI 版本支持 OpenAI 兼容或自定义 provider 时，建议按下面的原则配置：

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

常见做法包括：

• 在工具配置文件中填写兼容网关地址
• 或通过环境变量提供 API 地址与认证信息

推荐的环境变量组织方式

如果你的当前版本支持从环境变量读取 OpenAI 兼容配置，可以参考下面这种写法：

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

请注意：

• 上面是“支持 OpenAI 兼容配置时”的常见思路，不代表所有 Gemini CLI 版本都使用这两个变量名。
• 如果你的版本使用别的变量名，请保持值不变，只调整变量名称。

写入 ~/.zshrc 持久化

如果你确认当前版本支持相关环境变量，可将它们写入 ~/.zshrc：

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

保存后执行：

source ~/.zshrc

验证

建议按这个顺序验证：

1. gemini --version，确认 CLI 已安装。
2. 检查环境变量或配置文件是否生效。
3. 发起一次最小请求，确认请求可以通过 LuminaToken 返回结果。

如果工具支持打印当前 provider 或 endpoint，也可以一并检查。

版本差异提醒

Gemini CLI 的生态与版本分布较复杂，因此本页重点提供的是“接入思路”和“值应该填什么”：

• 网关地址填 https://api.luminatoken.cc/v1
• 认证信息填 LuminaToken API Key

至于具体字段名、配置文件路径和命令参数，应以你当前版本实际支持内容为准。

常见问题

已安装，但不支持自定义网关

这种情况下，说明你当前版本更偏原生认证路径。建议：

• 查看当前版本官方说明是否支持自定义 provider
• 或优先使用 Claude Code、Codex 作为主接入工具

已支持兼容网关，但仍然请求失败

• 检查 Base URL 是否为 https://api.luminatoken.cc/v1
• 检查 API Key 是否复制完整
• 检查账户余额是否充足

下一步

• 如果你希望获得更稳定的工程化接入体验，建议优先阅读 Claude Code 概览 或 Codex 概览。