Skip to content
kndlkndlkndl

Add your Claude credential

Save your Claude setup token on the Hub once, so every Session you start runs on your own Claude subscription, on any Runner.

You need one to start a Session. A Runner has no Claude credential of its own, so without yours, New Session asks you to add it.

What you need

Section titled “What you need”
  • A Claude subscription (Pro, Max, Team or Enterprise), and Claude Code on any machine.
  • The Hub’s secrets key, HUB_SECRETS_KEY, which whoever runs the Hub sets up: see Use variables and secrets.

The Hub takes setup tokens only, not Anthropic API keys (#334).

Add it

Section titled “Add it”

  1. On any machine with Claude Code, make a token:

    Terminal window
    claude setup-token

    Sign in in the browser it opens. It prints a token starting sk-ant-oat, valid for a year. Copy all of it.

  2. In kndl, press your name at the bottom of the sidebar, then Account.

    The Account page: the Claude section with a Setup token field and Save, and the CLI tokens list.

  3. Under Claude, paste the token, and press Save.

The Hub checks the token with Anthropic before it stores it, at no cost. Once saved, the page shows its last 4 characters and when you added it, never the token itself. Claude Code learns your plan from Anthropic, so there’s nothing to pick.

If Anthropic rejects it, nothing is stored, and the Hub says why. Make a new token and try again: see A Claude credential can’t be saved.

What it’s used for

Section titled “What it’s used for”

Only the Sessions you start run on your token, with their subagents, and only you prompt them. Others with access to the Repo watch. See Several people, one Session.

Your token is in the Claude Code process of each of your awake Sessions, in its Sandbox, so code running there can read it. Start Sessions on Repos you trust. See the security model.

Replace or remove it

Section titled “Replace or remove it”
  • Press Replace to paste a new token, such as when the old one expires.
  • Press Remove to take it off the Hub.

Either way, your awake Sessions go to sleep, each saying why. A replaced token reaches a Session when you next wake it. After a remove, your Sessions can’t wake until you add a token again.

Neither revokes the old token with Anthropic.

Next steps

Section titled “Next steps”
Work in a SessionStart a Session on your token, and drive it.
Security modelWhere your token goes, and who can read it.

kndl is an independent project. It is not affiliated with or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic, PBC. About kndl