Back to docs
Usage setup

Make Claude usage work on Mac

Blume detects whether Claude Code is signed out or macOS blocked the credential read, then shows only the relevant fix. This guide explains both paths for independent troubleshooting.

macOS Claude Code 3–5 min setup

Check whether Claude Code is signed in

Open Terminal and ask Claude Code for its authentication status:

Terminal 
claude auth status --text

If Claude Code says you are not logged in, sign in before changing any Keychain permissions:

Terminal 
claude auth login

Blume checks this automatically

You do not need to diagnose the credential state yourself. Blume uses the result of the Keychain read to select one of these paths and displays only that path in the app.

Login required

No Claude Code credentials found

Run claude auth login, complete the CLI sign-in, then return to Blume and refresh Usage. You do not need to change Keychain Access for this message.

Keychain access required

Credentials could not be read from macOS Keychain

Claude is signed in, but macOS did not let Blume read the credential. Follow the Keychain Access steps below.

Allow Blume in Keychain Access

Follow this section only when Blume explicitly reports a Keychain read problem. Add Blume to the Access Control list for the Claude Code-credentials item. If several items begin with that name, grant access on each one.

What changes

Blume appears in the list of applications allowed to access the Claude Code credential item. This does not change your Claude account or sign you in.

  1. Find the Claude credential

    Open Keychain Access, search for claude, and select Claude Code-credentials. If several items begin with that name, repeat these steps for each one.

    Search for claude in Keychain Access and select Claude Code-credentials.

  2. Open Get Info

    Right-click Claude Code-credentials and choose Get Info.

    Right-click the item and choose Get Info.

  3. Open Access Control

    In the credential details window, switch to the Access Control tab.

    Open Access Control and use the plus button to add Blume.

  4. Add Blume and save

    Under Always allow access by these applications, press +, select Blume, then click Save Changes.

    Blume should appear in the always-allowed applications list before saving.

Finish in Blume

Return to Blume, open Usage, and refresh the Claude Code provider. A successful connection shows your account and usage windows instead of repair instructions.

References

Anthropic keeps the Claude Code install and authentication details in their own docs. Use those as the source of truth when commands or account behavior change.