VS Code · Chat & Copilot + Luma Cloud

Before you start

• Create a Luma Cloud API key in Dashboard → API and copy a model ID from the authenticated model catalog.
• Use a VS Code version with Custom Endpoint. Organization policy may restrict bring-your-own-key models.

Get an API key and a model ID →

Set up VS Code · Chat & Copilot

1. Open the native model manager

   Open the Command Palette with Cmd+Shift+P on macOS or Ctrl+Shift+P on Windows/Linux. Run Chat: Manage Language Models. This configures VS Code Chat itself; Continue, Cline, and other extensions have their own settings.

2. Add Luma Cloud

   Choose Add Models → Custom Endpoint and name the group Luma Cloud. Enter your API key in the prompt. Let VS Code retain the secret reference; do not paste the raw key into a project settings file.

3. Configure the model

   Choose Chat Completions. In the generated chatLanguageModels.json, set the model ID and full endpoint below. Retain the generated ${input:...} secret reference. Set input/output limits and tool/vision flags from the model's supported capabilities.

4. Select it in chat

   Save and choose the Luma Cloud model in a new chat. Agent mode requires tool calling. If the model is absent, reload VS Code and check the organization policy.

Provider

Custom Endpoint

API type

chat-completions

Model URL

https://api.lumaos.cloud/v1/chat/completions

Model ID

MODEL_ID_FROM_CATALOG

[
  {
    "name": "Luma Cloud",
    "vendor": "customendpoint",
    "apiKey": "${input:lumaCloudApiKey}",
    "apiType": "chat-completions",
    "url": "https://api.lumaos.cloud/v1"
  }
]

Reply with exactly: Luma Cloud connection works.

Check the connection

1. Send a short text request, then check Usage → API Wallet for Wallet usage, or subscription Usage for Builder keys. A populated model list alone does not confirm a successful response.
2. Before using an agent on your project, try one read-only file task in a disposable folder. Confirm the tool result and final answer, keeping action approval enabled.

For errors or a request that stops, see troubleshooting. A visible model list alone does not confirm that a chat or editing task can complete.

What to expect

• Current VS Code supports BYOK chat without a Copilot plan. Inline suggestions, semantic search, and embeddings have separate requirements.
• Agent Host BYOK is experimental. This guide does not replace its separate setup.
• The old customOAIModels setting is deprecated. For Responses, use the matching API type and /responses URL.

Troubleshooting VS Code · Chat & Copilot