Claude Code
Run bots on Claude Code with your own Claude sign-in, and add more than one Claude account.
Claude is a trademark of its owner. Murage isn't affiliated with Anthropic.
When to use it
- You already pay for Claude and want your bots to use it.
- You want the widest set of Murage features on one engine: handing off work, connected apps, the built-in browser, computers, your phone and pictures.
- You want to run several Claude accounts side by side, for example a personal and a work account.
Install and sign in
Step 1
Find the engine
Open SettingsModels & enginesEngines and find Claude.
You're done when: you can see the Claude row and its status line.
Step 2
Install it
If it says Not detected, press Install Claude Code on the card. That's one press. Murage downloads Claude Code's own build from Anthropic, checks it, and installs it for you, and the card counts up as it goes ("Downloading … of … MB"). Nothing opens in Terminal, there's no line to paste, and you don't need Node.js or npm.
Claude's own installers still work if you'd rather install it yourself: curl -fsSL https://claude.ai/install.sh | bash on a Mac, Ubuntu or WSL, irm https://claude.ai/install.ps1 | iex in Windows PowerShell, Homebrew (brew install --cask claude-code) and WinGet (winget install Anthropic.ClaudeCode).
You're done when: the download has finished and the card shows Sign in to Claude Code.
Step 3
Sign in
If the status says Detected · sign-in required, press Sign in to Claude Code on the same card. Choose Open sign-in and finish Claude's own sign-in in your browser. Murage shows "Waiting for you in the browser" until you do, then "Signed in to" and your account. You can also ask Ember in chat on your computer to sign you in, and it gives you the same button. Then Murage checks that Claude gives a real reply.
Don't paste your Claude password into Murage. The sign-in happens in Claude Code itself.
You're done when: you finished Claude's sign-in.
Step 4
Check again
Back in Murage, choose Check again.
You're done when: the status reads Detected · signed in.
What works
- Tools: all of Murage's tools, including handing work to other bots, memory search, your own MCP servers, connected apps, the built-in browser, cloud and local computers, this computer (with your approval) and a USB-connected Android phone.
- Pictures you attach go straight to the model.
- Model picking: Claude's own models, the Flux Router tiers, models from an Anthropic key in SettingsModels & engines, and local models that pass Murage's test for Claude-style tools.
- Effort: low, medium, high, xhigh and max in Bot settingsModel.
- Messages while it works: you can keep typing while a Claude Code bot is mid-turn. Your message reaches it before its next step.
- Engine commands: type
/to see Claude Code's own commands next to Murage's. Commands that only make sense in a terminal are hidden.
More than one Claude account
Murage can keep several Claude accounts, each in its own configuration folder. Your default Claude login is left exactly as it is.
Step 1
Open the Claude card
Open SettingsModels & enginesEngines and scroll to Claude accounts in the Claude card.
You're done when: you can see Claude accounts and Add Claude account.
Step 2
Add the account
- Choose Add Claude account.
- Enter an Account name. Leave Configuration directory (optional) blank for a new, separate folder, or type an absolute or
~/path. Existing credentials are never moved or copied. - Choose Create account.
You're done when: the new account is created.
Step 3
Sign in to the new account
Open Sign-in instructions for the new account and choose Copy sign-in command for it. Run it in your terminal (PowerShell on Windows) and finish Claude's sign-in yourself. Murage doesn't sign in for you.
You're done when: you finished Claude's sign-in yourself.
Step 4
Refresh the accounts
Choose Refresh accounts.
You're done when: the account says Signed in.
Step 5
Pick the account for a bot
Pick the account in a bot's model list. Existing bots keep the account they had.
You're done when: the bot uses the account you picked.
Account changes are only allowed when no work is running. Removing an account takes it out of Murage but doesn't revoke its login or delete its files. An account that bots or past conversations use can't be removed.
Claude on Windows: the Murage helper
On Windows, Claude starts through a small helper program that ships inside Murage, murage-browser-host.exe. Some antivirus tools treat a program they have not seen before as suspect and move it to quarantine the first time it runs. When that happens, a Claude bot stops with the message below. Fuigo and Codex keep working in the meantime, so nothing else in your workspace is waiting on it.
You see
Claude needs Murage's Windows helperDo this
The full message reads "Claude needs Murage's Windows helper (murage-browser-host.exe) to start. If your antivirus moved it to quarantine, restore it, or reinstall Murage. Then send your message again."
- Open your antivirus's quarantine or protection history and restore
murage-browser-host.exe. Most tools let you mark it as allowed at the same time, so it is not taken again on the next update. - If you cannot find it there, reinstall Murage from the same download. The installer puts the helper back.
- Send your message again.
Known limits
- Plan limits. Your Claude plan's usage limits apply. Murage can't raise them.
- Voice needs its own keys. A Claude subscription doesn't pay for voice calls. Voice needs Flux Router credits or your own voice keys.
- Local models need a test. Local models only appear for Claude Code after they pass the Claude (messages) check in SettingsModelsLocal models.
- Permission prompts. If you've set Claude Code to skip its own permission prompts, Murage won't offer it control of this computer, because it can't ask you first.
Troubleshooting
You see
Claude needs you to sign in. Open engine setup to continue.Do this
Run claude auth login in a terminal, then choose Check again.
You see
claude CLI not foundDo this
Claude Code isn't installed where Murage looks. Install it, restart Murage, or choose Set CLI… and pick the claude program yourself.
You see
The selected model provider could not authenticate. Review its saved connection in Settings.Do this
The bot is using a model from a saved key or Flux Router, and that key failed. Check it in SettingsModels & engines.
You see
401 UnauthorizedDo this
The sign-in expired. Sign in again with claude auth login.
You see
A second account says Sign-in requiredDo this
Run that account's own sign-in command from Sign-in instructions, not the plain claude auth login, so the login lands in the right folder.