Skip to main content

Add a model account

Add a model account when your organization has none that works, or needs more room to run tasks. A model account is an API key Jaah stores, or a Subscription (OAuth) a person signs in to on a node. See How model accounts work for which to choose.

Who can do this: adding accounts needs permission to add them. Without it, Add account doesn't appear. While your organization awaits approval, Add account is turned off and says why.

Add it​

The New account form: Provider, Authentication, API key, Advanced, Cancel and Add

  1. In the sidebar, select Directory, then AI Accounts.
  2. Select Add account, at the right end of the tabs. The New account form opens beside the list.
  3. Pick the Provider: the agent this account runs, for example Claude Code. You can't change it later.
  4. Pick the Authentication, when the provider offers both: API key or Subscription (OAuth). You can't change it later.
  5. For an API key, paste it in API key. It's stored and never shown again. For a subscription, pick the Node the sign-in runs on. When a node shares its sign-ins with other nodes, Node is under Advanced instead.
  6. Open Advanced for the rest, all optional:
    • Name: the label the account shows everywhere. Left blank, the account shows its slug, a short code Jaah picks for it. You can change the name later.
    • Owner, if the form shows it: Organization or Personal.
    • Description, if the form shows it: a note shown when the account is open in the list.
    • Auto-assign, if the form shows it: on, the account runs tasks that allow any provider; off, only tasks that pick its provider.
    • Max runners, if the form shows it: the most runners the account may run at once. Blank means your organization's Concurrent runners setting for a subscription, and no limit for an API key.
  7. Select Add for an API key, or Authenticate for a subscription.

An API-key account is ready at once. Select Cancel to close the form without adding anything.

Finish a subscription sign-in​

After Authenticate, the provider's page opens in a new tab once the node has its link. If the browser blocks the tab, select Authenticate again, or Copy link to open it elsewhere:

  1. Authorize in the browser. Paste the code the browser shows into Authorization code, then select Confirm. The button turns into Close; the sign-in carries on if you close the page.
  2. If it shows a one-time code instead, copy it with Copy code and enter it where the link asks. The page says Waiting for you to authorize… until you do.
  3. Wait for Account added and enabled. The page then closes itself.

If the provider or authentication you need isn't offered, it's not on your plan. Ask to change your plan.

Check it works​

The account appears in the list with its round mark. ● means it's available. A new subscription shows — for its quota until the first reading comes in.