Skip to main content
Connect OverControl to Claude Code and use Lume models directly inside your coding workflow. Claude Code speaks Messages, so you connect it with a base URL, your API key, and a Lume model for each alias it already uses.
This guide covers Claude Code in the terminal, using a settings file.

​
Before you start

You need:

Open the API dashboard

Create and manage the API key you will use with Claude Code.

​
1. Install Claude Code

Install Claude Code from npm. You need Node.js 18 or newer.

​
2. Open the settings file

Claude Code reads the connection from:
On Windows that file is:
Create the file if it is not there. It applies to every project. Keep the key out of a settings file you commit.

​
3. Configure OverControl

Copy this into the settings file. Replace your OverControl API key with your key. The key needs the scope messages:create, and it starts with oc_sk_.
Keep your API key private. Never expose it in screenshots, logs, public configuration files, or source-control repositories.

​
4. Verify the connection

Open a project and start Claude Code. Close an existing session first if the settings file was already open.
If Claude Code asks whether to use this API key, confirm it. Then send a simple task:
If Claude Code returns a response using the selected Lume model, the integration is ready.

​
Working with Claude Code

Once connected, Claude Code can use OverControl while helping you:
  • understand unfamiliar code;
  • explain files and functions;
  • plan implementations;
  • debug issues;
  • review or refactor code;
  • write tests;
  • draft technical documentation;
  • reason about architecture.
Claude Code can also inspect files, propose edits, and run commands as part of a task. A thinking block can stay on the request. The reply that comes back is the text. Migrate from Anthropic is the same Messages client.
Review file changes and terminal commands before approving them, especially when working with sensitive projects or production systems.

​
Choose a model

Claude Code picks a model through the alias on the session. Use Lume 3.5 Max when the task needs more reasoning, for debugging, architecture, or a longer chain of steps. The Opus alias is already that ID. To use it for the usual session, set ANTHROPIC_DEFAULT_SONNET_MODEL to lume-3.5-max. A session on Sonnet or Opus takes text. An image or a PDF in that session needs lume-omni. You only need to change the model ID. The Base URL and API key remain the same. Compare Lume models

​
Troubleshooting

Check that your OverControl API key was copied correctly and has not been revoked.You can create or manage keys from the API dashboard.
Confirm that the Base URL is:
Leave /v1 off the end. Also check your network connection and API key.
Make sure the model ID is entered exactly as documented.
View available models
Close every Claude Code window, open a new terminal, and run claude again. Confirm the JSON has no missing or extra commas.
Check your selected model, API key, available quota or balance, and API usage in the OverControl dashboard.

​
Next steps

AI coding tools

Return to the AI coding tools overview.

Models

Choose the Lume model for your coding workflow.

Integrations

Explore all supported integrations.