Claude Code

/doctor v Claude Code

Něco nefunguje a nevíte proč? Jeden příkaz prohlédne celé nastavení a řekne vám, co opravit.

Autor: Jindřich Fáborský · 17 let v marketingu · 2 000+ hodin vibe codingu · 180+ projektů

Prohlídka Claude Code: příkaz /doctor zkontroluje instalaci a nastavení

První pomoc

Jeden příkaz zkontroluje celé nastavení.

Rychlá odpověď

Co je /doctor v Claude Code?

/doctor je prohlídka vašeho Claude Code. Podle dokumentace Anthropicu zkontroluje instalaci, nastavení a rozšíření a navrhne opravy, které po vašem souhlasu sám udělá.

Když se Claude Code vůbec nespustí, napište do terminálu claude doctor. Jen vypíše diagnózu a nic nemění.

Kde začít

/doctor, nebo claude doctor?

Rozhoduje jediná věc: jestli se Claude Code vůbec spustí.

Claude Code běží, ale zlobí

Napište /doctor přímo do Claude Code, v terminálu i v aplikaci.

Claude Code se nespustí

Spusťte v terminálu claude doctor. Vypíše, co je špatně, a obvykle i opravu.

Terminál příkaz claude nezná

Pak nepomůže ani doctor. Nejdřív opravte cestu k programu, postup najdete v první pomoci níž.

Reálný výpis

Takhle vypadá diagnóza z claude doctor

Tohle vypsal claude doctor na Macu, na kterém tenhle web vzniká. Našel dvě varování. Klikněte na kterýkoli blok výpisu a uvidíte, co znamená.

Terminál · claude doctor

❯ claude doctor

Claude Code doctor

Častý nález, když jste Claude Code kdysi instalovali přes npm. Je v počítači dvakrát: stará verze přes npm a nová nativní. Terminál pak může spouštět tu starou, i když jste aktualizovali.

Co /doctor zkontroluje

Co všechno /doctor uvnitř Claude Code zkontroluje

Jde hlouběji než výpis v terminálu: kromě instalace projde i rozšíření, CLAUDE.md a spotřebu.

Instalacedvojí instalace, PATH, stará verze
Nastavenírozbité soubory s nastavením
Rozšířenínepoužívané skills a MCP servery (napojení na nástroje)
CLAUDE.mdduplicity a přebujelé instrukce
Oprávněnízbytečné dotazy na schválení
Spotřebaco vám ujídá limit (od verze 2.1.305)

Nejdřív ukáže, pak se zeptá

Nálezy vypíše, ke každému navrhne opravu a čeká na vaše „ano“. Pouštějte ho po větší aktualizaci nebo když přidáte nové skills a MCP servery. U oblastí jako CLAUDE.md nebo skills se vyplatí návrh přečíst, ať víte, co mizí.

Pro pokročilé: /doctor prompt-audit

Místo celé prohlídky projde jen vaše instrukce (CLAUDE.md, skills a další konfiguraci) a hledá zastaralé nebo protichůdné pokyny. Hodí se, když máte nastavení nabobtnalé z mnoha měsíců práce. Přehled všech příkazů je v oficiální dokumentaci.

První pomoc

Nejčastější problémy a jak je opravit

Hlášky, na které začátečníci s Claude Code narážejí, a co s nimi udělat.

command not found: claude

Terminál nevidí, kam se Claude Code nainstaloval. Otevřete nový terminál, jinak doplňte ~/.local/bin do PATH. Tady nepomůže ani claude doctor, terminál ho nenajde. Postup krok za krokem je v průvodci jak nainstalovat Claude Code.

Auto-update failed · Run claude doctor

Spusťte claude update, ukáže skutečnou chybu. Když se přeruší spojení nebo selže ověření verze, příkaz zopakujte.

Claude nenajde soubory, @ nic nenabízí

Nejede přibalené vyhledávání (ripgrep). claude doctor to ukáže na řádku Search, oficiální návod na opravu je v dokumentaci.

Po přihlášení 403 Forbidden

Zkontrolujte, že máte aktivní placený tarif. Pak se odhlaste příkazem /logout, zavřete Claude Code, spusťte ho znovu a přihlaste se.

Claude Code zamrzl nebo je pomalý

Stiskněte Ctrl+C. Když to nepomůže, zavřete terminál a ve stejné složce spusťte claude --resume. Rozhovor se neztratí.

Další chyby při instalaci a přihlášení řeší oficiální návod Anthropicu.

Když nepomůže ani doctor

Co zkusit dál

Než začnete cokoliv přeinstalovávat, mrkněte na status.claude.com. Možná má Anthropic zrovna výpadek a na vašem počítači není co opravovat.

/statusverze, model, účet a připojení
/mcpkterý MCP server nejede, znovu ho připojí
claude --safe-modespustí bez rozšíření, ať víte, jestli to kazí některé z nich
/feedbacknahlásí chybu Anthropicu

Když si nevíte rady, zkopírujte přesné znění chyby do Claude nebo do ChatGPTu. Většinou rovnou dostanete opravu. Další každodenní příkazy najdete v průvodci základní příkazy Claude Code.

Chcete Claude Code rozjet bez zadrhnutí?

V kurzu AI First vás video „Jak začít s Claude Code“ provede instalací v aplikaci i v terminálu, nastavením oprávnění a CLAUDE.md. Pak už s ním stavíte weby, aplikace a nástroje, i když nejste programátoři.

24 hodin videí · 1 900+ absolventů · roční licence s aktualizacemi zdarma

FAQ

Časté otázky

Co dělá /doctor v Claude Code?+

Projde instalaci, nastavení, rozšíření (skills, MCP servery, pluginy) a soubory CLAUDE.md. Najde, co je rozbité nebo co vás brzdí, a navrhne opravy. Ty Claude provede, až když je odsouhlasíte.

Jaký je rozdíl mezi /doctor a claude doctor?+

/doctor píšete uvnitř běžícího Claude Code a umí věci i opravit. claude doctor píšete do obyčejného terminálu, když se Claude Code vůbec nespustí. Jen vypíše diagnózu instalace a nastavení.

Funguje /doctor i v aplikaci Claude?+

Ano. V desktopové aplikaci Claude napíšete do pole pro zprávu lomítko a /doctor vyberete ze seznamu příkazů, stejně jako v terminálu. Jen claude doctor je příkaz čistě pro terminál.

Smaže mi /doctor skills nebo CLAUDE.md?+

Jen když to odsouhlasíte. Nepoužívané skills a MCP servery nebo duplicity v CLAUDE.md vám navrhne vypnout či upravit a před každou změnou se zeptá. Návrh si přečtěte, ať víte, co mizí.

Musím umět pracovat s terminálem?+

Pro /doctor ne, ten napíšete přímo do Claude Code jako zprávu. Terminál potřebujete jen na claude doctor, když se Claude Code nespustí, a na opravy, které doctor navrhne. Ty stačí zkopírovat a vložit.

Claude Code píše „Auto-update failed · Run claude doctor“. Co s tím?+

Spusťte v terminálu claude update. Ukáže skutečnou chybu, kdežto claude doctor vám řekne jen to, že poslední aktualizace selhala. Když se přeruší spojení nebo selže ověření verze, příkaz zopakujte, případně to zkuste později.

Pomůže /doctor, když mi došel limit?+

Limit neobnoví, ten se řídí vaším tarifem. Od verze 2.1.305 ale /doctor na placených tarifech ukáže i tipy z příkazu /usage, tedy co vám spotřebu zvedá. Jak s limitem hospodařit, rozebíráme v průvodci o vytěžení předplatného.

Newsletter AI First — zdarma

To podstatné z AI a vibe codingu

Osobní výběr novinek, které sám používám a považuji za hodnotné.

Přihlášením souhlasíte se zpracováním osobních údajů podle našich zásad. Odhlásíte se kdykoli jedním klikem.