# Claude Code + Luma Cloud

Direct connection needs Anthropic Messages compatibility, which is not a documented Luma API interface.

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

- For a direct Luma connection, choose a client that supports Chat Completions or Responses.

## Setup

1. **Understand the protocol**
   Claude Code treats ANTHROPIC_BASE_URL as an Anthropic-format endpoint and sends Messages requests. Pointing that setting at an OpenAI-compatible base URL does not translate the request.

2. **Choose a direct alternative**
   Use OpenCode, Aider, Cline, or another documented compatible client with a Luma API key. Keep your existing Claude Code login and configuration.

## Verify

- There is no direct Claude Code acceptance test in this guide. Follow the setup and verification steps for the compatible client you choose.

## Limits

- Luma's documented API does not include an Anthropic /v1/messages endpoint. This page does not provide an ANTHROPIC_BASE_URL configuration.

- A third-party protocol translator is a separate integration and requires its own authentication, tools, streaming, and usage validation.

## Troubleshooting

### Changing ANTHROPIC_BASE_URL returns 404

Claude Code is still sending Anthropic Messages. An OpenAI-compatible Base URL cannot change that protocol. Restore only the endpoint override you added, retaining your original Claude configuration and login.

### A Luma key is rejected as an Anthropic key

Do not replace your Anthropic credentials. Create a named Luma API key for a compatible client and follow that client's recipe. Paying for a Luma plan does not authenticate Claude Code to Anthropic.

### A plugin or MCP server offers Luma access

An MCP tool connection is not a replacement for Claude Code's primary model provider. Treat an external translator as a separate integration; this guide does not claim its tools, billing or streaming have been validated.

## Official client documentation

- [Claude Code: gateway protocol requirements](https://code.claude.com/docs/en/llm-gateway-protocol)

- [Claude Code: LLM gateways](https://code.claude.com/docs/en/llm-gateway)