Troubleshooting

Run clauded status first; most problems are already spelled out on that screen. For anything else, see the table.

Symptom	What to do
Claude Code reports connection refused	The background service is not running: clauded status starts it for you, or click "Start" in the GUI
Works in the terminal, not in the editor	clauded ide install, then restart the editor; the Home tab's "Editor integration" also names the cause
"This device has been removed"	The device was removed from the account — run clauded login to bind it again
"No account assigned"	Your subscription has not been assigned a dedicated account yet; wait for the console notification or ask your admin. Nothing is wrong on your machine
"Bound account temporarily unavailable"	The gateway is reassigning your account. Just wait — there is nothing to do
Desktop app certificate error	clauded cert install (asks for administrator approval once)
It says claude cannot be found	With the system preference nothing is downloaded: switch with clauded config claude source managed, or install a copy yourself
Only the web version works	Your own account is a free-tier one — the CLI, editors and desktop app require a paid account
Nothing connects right after an update	An update stops the old background service; run clauded status or clauded once to bring the new one up
The GUI will not open on Linux	There is no Linux build of the GUI; use the command line
Installed, but the command is not found	Open a new terminal; if it persists, run ~/.local/bin/clauded install to add it to your PATH

Still stuck

Turn logging on, reproduce the problem, and send us the log together with your status output:

clauded log on
# reproduce the problem
clauded status
clauded log off

The log is at ~/.clauded/logs/daemon.log. Per-request logging records full request and response bodies, so check the file before sharing it, and run clauded log off when you are done.