Skip to content

LLM credentials

Mate is bring-your-own-key (BYOK): it never charges for LLM usage. You supply an API key from your own account, and requests are billed there at the provider’s rates.

This is the Add your LLM key item on the workspace Home checklist. You can also reach it any time under Settings → LLM key.

Key provider Where to get a key Notes
OpenRouter openrouter.ai/keys Routes to many models through one key.
Anthropic direct console.anthropic.com/settings/keys Direct access to Claude models.
OpenAI-compatible platform.openai.com/api-keys OpenAI, or any OpenAI-compatible provider. Optional Base URL: the root of the API, such as https://api.mistral.ai/v1. Must be https://; empty means https://api.openai.com/v1.

Claude subscription (OAuth) tokens, such as sk-ant-oat… values or CLAUDE_CODE_OAUTH_TOKEN, are not supported and are rejected in agent env. Use an Anthropic API key.

Not every key kind runs every agent backend (claude-code, codex, omp, opencode). The table is in Models and BYOK.

  1. Select the provider under Key provider (OpenRouter is preselected). For OpenAI-compatible keys, enter the Base URL if it is not OpenAI’s.
  2. Paste the key into the API key field. Keys must be between 20 and 500 characters.
  3. Click Save key.

Mate verifies the key with the provider before storing it:

  • Valid: the key is saved.
  • Rejected by the provider: the key is not stored and you get an inline error.
  • Provider unreachable: the key is saved unverified, with a warning, so a transient outage does not block setup. If it later turns out to be wrong, your first job fails — re-check the key.

Mate encrypts the key at rest. It is not retrievable after submission.

Open Settings → LLM key, paste the new key, and click Replace key. Submitting a new key overwrites the previous one. Only owners and managers can change the key; one key serves the whole workspace.

Next: Create your first agent