# Gemini CLI + Luma Cloud

Gemini CLI's documented connection uses Google services rather than a generic OpenAI-compatible provider.

API connection: No direct connection. Instructions checked: 2026-09-28. Client capabilities and versions may vary; follow the verification steps below.

This is an API setup guide. SuperGPT desktop installation and sign-in are separate; use a customer API key for the client described here.

## Before you start

- Use a client with a documented OpenAI-compatible custom provider for direct Luma API access.

## Setup

1. **Check the supported connection**
   Gemini CLI documents Google sign-in, a Gemini API key, and Vertex AI. GOOGLE_GEMINI_BASE_URL changes the destination of Gemini-format requests; it does not turn them into Chat Completions or Responses.

2. **Use a compatible agent**
   Choose OpenCode, Aider, or another client in this directory for Luma. Keep your Google login and Gemini CLI settings unchanged.

## Verify

- No direct Luma setup is claimed for Gemini CLI. Verify the alternative client using its own guide.

## Limits

- Do not enter a Luma key as GEMINI_API_KEY or assume that an OpenAI-compatible URL supports Gemini's API format.

- Luma does not document a Gemini/Vertex endpoint. A separate translator would need its own compatibility testing.

## Troubleshooting

### GOOGLE_GEMINI_BASE_URL points to Luma but requests fail

The setting changes where Gemini-format requests go; it does not translate them into Chat Completions. Restore the override you added and use a documented OpenAI-compatible client for Luma.

### GEMINI_API_KEY rejects the Luma key

These keys belong to different services. Keep your Google credentials in Gemini CLI and enter the Luma portable key only in a compatible client's own configuration.

### A Google sign-in or Gemini model picker succeeds

That verifies the Google connection, not Luma billing or API access. For a Luma test, follow the OpenCode or Aider guide and check the matching named key in the Luma dashboard.

## Official client documentation

- [Gemini CLI: authentication methods](https://geminicli.com/docs/get-started/authentication/)

- [Gemini CLI: base URL configuration](https://geminicli.com/docs/reference/configuration/)