Add your Claude key
Lyra writes on your own Claude account, so every post runs on your key and you stay in control of cost. Your credential is validated before it is saved, stored encrypted, and never marked up. You add it during onboarding and can change it any time in Settings > API keys.
You add one Claude credential. You can also add an optional Gemini key for banners, covered in Banner images.
Choose a credential type
Lyra accepts either of two Claude credentials. Pick the one that matches how you use Claude.
| Credential | Starts with | Best for |
|---|---|---|
| Anthropic API key | sk-ant-api | Anyone with an Anthropic Console account |
| Claude Code OAuth token | Generated by claude setup-token | People on a Claude subscription |
Only one credential is active at a time. Adding a new one immediately invalidates the previous credential.
Option 1: Anthropic API key
- Go to the Anthropic Console.
- Create an API key. It starts with
sk-ant-api. - In Lyra, paste the key into the Claude credential field during onboarding, or in Settings > API keys.
- Lyra validates the key and saves it encrypted.
Option 2: Claude Code OAuth token
If you use a Claude subscription, you can authorize Lyra with a Claude Code token instead of an API key.
- Run the token command locally:
claude setup-token- Copy the token it prints.
- Paste it into the Claude credential field in Lyra.
- Lyra validates and saves it.
Why your own key
- At cost. Runs bill directly to your account. Lyra never marks up usage.
- In your control. You set the budget on your Anthropic account and can rotate the key any time.
- Encrypted at rest. Lyra stores your credential encrypted and validates it before every save.
Change or rotate your key
- Go to Settings > API keys.
- Enter the new key or token.
- Save. The previous credential is invalidated immediately.
When your key stops working
A key can stop working without you touching it: revoked, rotated, or expired. When Anthropic refuses a website's key, Lyra stops on that website instead of starting runs that cannot begin. Nothing waiting to be written is lost, and every other website carries on, each on its own key.
You get an email when it happens, and a Key refused chip appears at the top of the dashboard. Open it for two ways out:
- Add a working key takes you to Settings > API keys. Save a working key and Lyra starts again.
- Check the key again is for when you already fixed it on your Anthropic account. She checks the key and starts back up without you pasting anything.
What's next
- Banner images: Add a Gemini key for hero images.
- Configure your website: Set your focus, keywords, and links.
- Settings: Manage keys and other workspace settings.
Troubleshooting
Issue: My key is rejected
Symptoms: Lyra will not save the credential.
Diagnosis: The key is mistyped, expired, or of the wrong type.
Resolution: Confirm an API key starts with sk-ant-api and copy it fresh from the Anthropic Console. For a Claude Code token, run claude setup-token again and paste the new value.
Issue: The dashboard shows Key refused
Symptoms: A Key refused chip appears at the top of the dashboard, and nothing new starts on that website.
Diagnosis: Anthropic turned down the website's Claude key. It may have been revoked, rotated, or expired.
Resolution: Click the chip, then Add a working key, or fix the key on your Anthropic account and click Check the key again. See When your key stops working.
Issue: Runs stop with a rate limit
Symptoms: Posts pause and a run reports a rate limit.
Diagnosis: Your Claude account hit its rate limit.
Resolution: Lyra paces herself and hibernates the project briefly, then resumes on her own. To raise the ceiling, adjust the limits on your Anthropic account.