Skip to content

Connecting your own API key

A minion thinks with Claude Code, and Claude Code needs access to Claude. One way to give it that is your own API key from Anthropic: you pay Anthropic directly for what the minion uses, and Minion Workspace doesn’t charge for it.

  • You create an API key on Anthropic’s site and paste it into the minion’s Brain tab in Minion Workspace.
  • Minion Workspace stores the key encrypted and never puts it on the minion. The minion gets a pass of its own instead, which only works through Minion Workspace and stops working when you disconnect.
  • Each time the minion’s Claude Code calls Claude, the request goes through Minion Workspace, which adds your key and passes the request on to Anthropic. The content of the conversation passes through Minion Workspace, but isn’t stored. What is kept is a usage record: when, which minion, which model, how many tokens and the estimated cost.
  • Anthropic bills you for the usage under your own agreement with them.

The details are in the Terms of Service (section 7.1) and the Privacy Policy (section 2.6).

  • An account on the Claude Console — Anthropic’s site for developers, at platform.claude.com. It used to be called the Anthropic Console.
  • Claude Code on the minion. If it isn’t there yet, the Brain tab installs it.

The names below are those on the Claude Console at the time of writing. If a screen looks different, see Anthropic’s own help: getting an API key and spend limits.

API usage is paid from credits you buy in advance. In the Claude Console, open Settings → Billing and press Buy credits. When the credits run out, Anthropic stops answering until you add more — and the minion’s work fails until then.

If you turn on auto-reload (buying credits automatically when the balance runs low), also set a spending limit below: with auto-reload, nothing else stops the spending.

Section titled “Make a workspace for your minions (recommended)”

The Claude Console has workspaces of its own — they have nothing to do with your workspaces in Minion Workspace. A workspace for your minions lets you give them a spending limit of their own, and see what they use apart from anything else you do with the API.

Open Settings → Workspaces, press Create workspace, give it a name such as “Minions” and create it. (Anthropic’s default workspace can’t have a spending limit of its own.)

Minion Workspace doesn’t keep a budget for your API key: the limit you set at Anthropic is what caps your bill. A minion works on its own, also when nobody is watching: routines and workflows run on schedule. If something goes wrong — a workflow repeating the same step, for example — the minion keeps using your key. Minion Workspace pauses a minion that uses a lot in a short time (below), but only a limit at Anthropic caps a whole month.

  • For the minions’ workspace: in Settings → Workspaces, select the workspace and open Spend limits. Set a monthly limit; you can also have Anthropic alert you when spending reaches part of it.
  • For your whole account: in Settings → Billing, under Spend limits, press Set limit (or Adjust limit).

When a limit is reached, Anthropic refuses requests until the next month, or until you raise the limit.

  1. Open Settings → API keys and press Create key.
  2. Give the key a name (the minion’s name works well) and choose the workspace you made for your minions, so that its limit applies. Using one key per minion lets you see each minion’s usage at Anthropic and stop one without the others.
  3. If you set an expiration date, the minion stops working when the key expires: connect a new key before then.
  4. Copy the key. It starts with sk-ant-, and the Claude Console shows it only once.
  1. In Minion Workspace, open the minion’s page and its Brain tab.
  2. Under Add a brain, find the card Claude Code with Your own API key (through the proxy) (the Proxy filter narrows the list down). If the card says Not installed, press Install first and wait until it finishes.
  3. Paste the key into the field (it shows ANTHROPIC_API_KEY) and press Connect. If your account uses two-step verification, you may be asked for a code from your authenticator app.
  4. Minion Workspace checks the key with Anthropic before it saves anything. The card then says Connected.

Connecting replaces what the minion used before: if it was on Minion AI, that is disconnected. While the key is connected, the minion uses it even if Claude Code is also signed in to a Claude plan.

MessageWhat it means
Anthropic did not accept this API key. Check the key you copied from the Claude Console.The key is wrong, incomplete or deleted. Copy it again, or create a new one. Nothing was saved
This API key is not allowed to use the API. Check the key’s workspace and organization in the Claude Console.Anthropic knows the key but won’t let it be used — for example, its workspace was archived. Create a key in a workspace that is in use. Nothing was saved
Connected with your own API key, but the key could not be checked with Anthropic right now. If the key is wrong, the minion will fail when it starts working.Anthropic couldn’t be reached, so the key was saved without the check. If the minion’s first work fails with an authentication error, connect again with the right key
Too many attempts. Wait a minute and try again.You tried to connect more than 5 times within a minute. Wait a minute, then try again

The check tells whether the key is valid, not whether there are credits left on it.

While the key is connected, the card shows Used by this minion this month (UTC): an amount in dollars and the number of requests since the 1st of the month (UTC).

The amount is an estimate at public list prices. The bill from Anthropic is what you actually pay; it can differ (discounts, taxes). For the exact figures, see the usage and billing pages of the Claude Console. The card’s Set a spending limit with Anthropic link opens the Claude Console.

New models can be used on the day Anthropic releases them. Until Minion Workspace adds a new model’s price, its usage is estimated at the highest price known for Anthropic’s models, so the estimate is on the high side for a while.

Besides the limit you set at Anthropic, Minion Workspace keeps two limits of its own for minions on your own API key. They are the same on every plan.

  • 20 requests a minute per minion. Requests beyond that are asked to wait. Claude Code waits and tries again by itself, so the work slows down for a moment instead of failing.
  • A pause for a minion that uses a lot in a short time: more than $20 within an hour (estimated at public list prices). See below.

When a minion is paused:

  • Minion Workspace sends nothing more to Anthropic for it, and it doesn’t start new work (routines, workflows, board tasks). Its conversations, run history and settings stay as they are.
  • You get a notice in Minion Workspace and by email.
  • The card on the Brain tab says: “This minion is paused because it used your API key unusually fast. Nothing is sent to the LLM until you resume it. Check that no routine or workflow is repeating the same work, then resume it.”

Check the minion’s routines and workflows — for example, whether a step keeps repeating the same work. When everything looks right, or the usage was intended (a big job), press Resume on the card. A pause doesn’t lift by itself.

If the card says “The Minion Workspace team has paused this minion’s LLM usage. Please contact support.”, the pause was set by the Minion Workspace team, for example over suspected misuse or a security issue. You can’t resume it yourself: please contact us. In rare cases, such as a security problem, Minion Workspace may also pause every connection made with users’ own API keys at once, as the Terms of Service allow.

Press Disconnect on the card. The minion’s pass stops working right away, and Minion Workspace deletes the key it stored. The same happens when you connect another key, switch the minion to Minion AI or delete the minion.

The key itself still works at Anthropic. If you no longer need it, delete it in the Claude Console (Settings → API keys).

The minion’s work fails with an authentication error — the key was deleted or expired at Anthropic. Create a new key and connect it.

The minion’s work fails saying the credit balance is too low — add credits in the Claude Console (Settings → Billing).

The minion’s work fails saying a usage limit was reached — a spending limit at Anthropic was reached. Raise it in the Claude Console, or wait for the next month.