Nejlepší nastavení Claude Code pro 2026 (návod na 30 minut)

Každé nastavení Claude Code, které jsem kdy viděl, spadá do jednoho ze dvou selhání. První je holý default: žádný CLAUDE.md, žádné skilly, výzvy k potvrzení u každého příkazu a uživatel přemýšlející, proč Claude pořád zapomíná, jak se jeho projekt builduje. Druhé je překonfigurovaný stroj: 40 skillů, 9 MCP serverů, CLAUDE.md dlouhý jako seminárka a kontextové okno napůl spotřebované ještě před prvním promptem.

Dobré nastavení leží někde mezi tím a jeho vybudování zabere zhruba 30 minut, pokud jdeš po vrstvách v pořadí závislostí. Na tom pořadí záleží. Skilly předpokládají fungující instalaci. Rozhodnutí o oprávněních závisí na tom, jaké MCP servery používáš. Rozdělení na projekt vs. globál dává smysl, teprve když víš, co vlastně rozděluješ. Tohle je návod, který dáváme novým lidem v SkillProof první den, zbavený chyb, které jsme za posledních šest měsíců udělali sami.

Vrstva 1: instalace a přihlášení, pět minut

Tohle jsi pravděpodobně už udělal, takže to zkrátím.

npm install -g @anthropic-ai/claude-code
cd your-project
claude

Při prvním spuštění tě /login provede přihlášením. Máš dvě cesty k platbě: předplatné Claude (Pro nebo Max), nebo API klíč s platbou za token. Pokud s Claudem kóduješ denně, předplatné vychází skoro vždy levněji; platba za API u náročných agentních session naskakuje rychleji, než lidé čekají. Pokud jsi v týmu, ověř, jestli firma nemá Claude for Work místo, než začneš pálit osobní API klíč.

Ověř to něčím triviálním („co dělá tenhle repozitář?") a potvrď, že Claude umí číst tvoje soubory. To je celá vrstva. Všechno pod ní je místo, kde se nastavení skutečně rozcházejí.

Vrstva 2: CLAUDE.md, který si zaslouží své tokeny

CLAUDE.md je markdown soubor, který Claude načte do kontextu na začátku každé session v daném projektu. Každé session, ať už je obsah relevantní, nebo ne. Tohle chování při načítání určuje úplně všechno, co do něj patří.

Co tam patří: fakta platná pro téměř každou session. Build a testovací příkazy. Dvouvětá verze tvé architektury. Konvence, které Claude soustavně kazí, dokud mu to neřekneš (pořadí importů, formát commitů). Kde jsou pohřbená těla: deprecated modul, na který nikdo nemá sahat, konfigurační soubor, co vypadá nepoužívaný, ale není.

Co tam nepatří: procedurální znalosti, které potřebuješ jen občas. Jak napsat databázovou migraci. Tvůj release checklist. Firemní styl pro e-maily zákazníkům. Každá z těch věcí se týká tak 5 % session, a v CLAUDE.md za ně platíš i ve zbylých 95 %. Tenhle materiál chce být skill (další vrstva), který se načte jen po aktivaci.

Naše pravidlo po testování na vlastním repozitáři: pokud má tvůj CLAUDE.md přes 60 řádků, něco z něj má vypadnout. Náš začínal na 400 řádcích, protože jsme ho brali jako dokumentaci. Claude ho poslouchal hůř, ne líp, protože signál se utopil. Zhuštěná verze, zhruba 50 řádků příkazů a tvrdých omezení, se dodržuje skoro pokaždé.

Napiš první verzi za deset minut a přestaň. Budeš ji ladit celé týdny, jak budeš chytat Claudovy opakované chyby; ta iterace je ta skutečná metoda. Plné zpracování, včetně antipatternů, které vidíme v souborech od čtenářů, je v našem průvodci CLAUDE.md.

Vrstva 3: skilly, vrstva, kterou většina lidí přeskočí

Tohle je vrstva, která odděluje nastavení od instalace, a je to ta, kterou většina lidí nikdy nezapne. Skill je složka se souborem SKILL.md, který Claudovi vysvětlí způsob práce. Stojí zhruba 100 tokenů metadat, když nečinný, a plné instrukce načte, jen když úkol odpovídá jeho popisu. Jednou nainstalovaný platí navždy, napříč všemi session.

Lidé tuhle vrstvu přeskakují z racionálního důvodu: zhruba polovina komunitních skillů na GitHubu selže hned při první instalaci. Víme to, protože instalovat a testovat je přesně náš byznys. Každý skill v katalogu SkillProof projde čistou instalací a kontrolou spouštění, pak reálné úkoly proti baseline bez skillu, teprve pak dostane verdikt. Z 73 skillů, které jsme dosud otestovali, jich prošlo 35.

Pro vývojářské nastavení je tu prvních pět k instalaci, se skóre z našich testů:

1. Test-Driven Development, 9,6. Vynucuje přísný cyklus red-green-refactor: nejdřív padající test, pak minimální implementace, pak úklid. V naší session se třemi featurami cyklus nikdy nepřeskočil, ani když jsme se ho snažili přemluvit.
2. Systematic Debugging, 9,6. Nahrazuje opravy metodou pokus-omyl smyčkou hypotéza-test-ověření. Dohledal příčinu race condition, kterou Claude předtím třikrát „opravil" hádáním.
3. Frontend Design, 9,6. Největší rozdíl před/po, jaký jsme u jakéhokoli skillu naměřili. Stejné zadání landing page, spuštěné dvakrát: baseline vyprodukovala neonový gradient a všechno na střed, verze se skillem měla skutečnou typografickou škálu a paletu, která působila jako vybraná.
4. Memory Management, 9,2. Dává Claudovi trvalou paměť napříč session. Za týden testování spolehlivě vybavoval rozhodnutí a preference projektu a přesnost vybavování zůstávala i s rostoucím úložištěm.
5. Webapp Testing, 8,8. Claude řídí tvou aplikaci ve skutečném prohlížeči přes Playwright a hlásí, co je rozbité. Odhalil regresi, kterou naše unit testy propásly.

První dva pocházejí ze sbírky Superpowers od Jesse Vincenta (/plugin marketplace add obra/superpowers-marketplace, pak /plugin install superpowers). Frontend Design je součástí oficiálního repozitáře skillů od Anthropicu a kopíruje se přímo do ~/.claude/skills/. Přesné kroky, včetně chyb, které lidem sežerou první hodinu, jsou v průvodci instalací. Po instalaci restartuj Claude Code a otestuj každý trigger tak, že o práci požádáš, aniž bys jmenoval skill. Pokud se nic viditelně nezmění, skill se nespouští, a nainstalovaný skill, který se nikdy nespustí, je jen složka.

Pokud tvá práce míří jinam, náš seznam nejlepších skillů pro kódování řadí celou kategorii, průběžně aktualizovaný o nové testy.

Vrstva 4: MCP servery, jen ty, které opravdu použiješ

MCP servery napojují Claude na věci mimo repozitář: tvou databázi, issue tracker, živý prohlížeč. Jsou mocné a jsou nejdražší položkou v tvém kontextovém rozpočtu. Každý připojený server vloží definice svých nástrojů do každé session, ať se použijí, nebo ne, a jeden ukecaný server dokáže stát víc trvalých tokenů než 50 nainstalovaných skillů dohromady. Změřili jsme to v průvodci náklady na tokeny a čísla nám změnila způsob, jak konfigurujeme vlastní stroje.

Laťka pro MCP server by proto měla být vysoká: zaslouží si místo, jen pokud Claude potřebuje dosáhnout na něco, na co jinak nedosáhne. Tři obvykle tenhle test u vývojářů přežijí:

Databázový server (Postgres nebo cokoli používáš). Claude, který píše dotazy proti tvému skutečnému schématu místo odhadnutého, je jiný produkt. Tohle je pro většinu týmů jednoznačně nejhodnotnější MCP připojení.

Automatizace prohlížeče (Playwright MCP), pokud vydáváš UI a nepoužíváš vlastní setup skillu Webapp Testing. Vidět vykreslenou stránku vždycky porazí odvozování z JSX.

Tvůj issue tracker, ale jen pokud v Claude Code opravdu pracuješ ticket po ticketu. Pokud do Linearu jen mrkneš dvakrát denně, stačí prohlížeč a tokeny za to nestojí.

Všimni si, co chybí: GitHub MCP server. gh CLI dělá totéž, Claude ho už umí používat a stojí nula trvalého kontextu. Tenhle vzorec substituce se dá zobecnit. Než přidáš jakýkoli server, zeptej se, jestli ti stejný dosah zdarma nedá CLI nástroj, který Claude umí zavolat. A pokud váháš, jestli problém potřebuje MCP vůbec, nebo jen skill, rozhodovací pravidlo je v skilly vs. MCP: skilly mění, co Claude umí dělat, MCP mění, na co dosáhne.

Vrstva 5: oprávnění a bezpečnostní nastavení, která stojí za změnu

Výchozí zážitek s oprávněními je výzva u téměř každého příkazu, což lidi naučí klikat „povolit" mechanicky. To je nejhorší možný výsledek: veškeré tření, žádná bezpečnost. Opraví to dvě změny.

Zaprvé, dej na allowlist příkazy, které bys stejně schválil. V .claude/settings.json:

{
  "permissions": {
    "allow": [
      "Bash(npm test:*)",
      "Bash(npm run lint:*)",
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(git log:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  }
}

Zadruhé, všimni si deny bloku, protože ten lidi přeskakují nejčastěji. Claude nemá co dělat ve tvém .env a deny pravidlo z toho udělá vlastnost systému místo naděje. Pokud spouštíš MCP servery nebo skilly od třetích stran, na tomhle záleží ještě víc, protože škodlivá instrukce nemůže vynést to, co harness nesmí číst. Náš bezpečnostní průvodce pokrývá stránku auditu.

K --dangerously-skip-permissions: název flagu je upřímný. Uvnitř jednorázového kontejneru bez přihlašovacích údajů je to fajn způsob, jak pustit dlouhý neasistovaný běh. Na tvém notebooku, s tvými SSH klíči a přihlášenými session v prohlížeči, je to způsob, jak skončit jako hlavní postava postmortemu. Používáme ho v CI sandboxech a nikde jinde.

Projekt vs. globál: kam co patří

Všechno výše existuje na dvou úrovních a jejich zaměňování je nejčastější zmatek v konfiguraci, jaký vídáme. Rozdělení:

Část	Globální (~/.claude/)	Per-projekt (.claude/ v repozitáři)
CLAUDE.md	Tvůj osobní styl: délka odpovědí, jazyky, otravy	Build příkazy, architektura, konvence projektu (commituj)
Skilly	Všechno obecné: debugování, TDD, psaní	Jen týmově specifické workflow
Nastavení	Tvůj osobní allowlist	Týmový allowlist a deny pravidla (commituj)
settings.local.json	—	Tvoje úpravy jen pro tento stroj (gitignore)
MCP servery	Servery, které používáš všude	.mcp.json projektu, aby měl celý tým stejná připojení

Princip: cokoli, co by potřeboval kolega, patří do repozitáře, cokoli, co je o tobě, patří do globálu. Výplata se ukáže, když někdo nový naklonuje projekt a Claude už zná build příkazy a konvence, s připraveným připojením na databázi. Jejich vrstva 2 a polovina vrstvy 4 přijdou zdarma.

Moje nastavení po šesti měsících

Co skutečně přežilo na mém stroji, pro srovnání: 54řádkový projektový CLAUDE.md, devět skillů, dva MCP servery (Postgres a Playwright) a výše uvedený blok oprávnění. Setup session se cítí stejně jako před šesti měsíci; rozdíl je ve všem, co jsem smazal.

Odebrání mě naučilo víc než přidávání:

Odebral jsem GitHub MCP server. Čtyři měsíce jsem ho držel ze setrvačnosti. Definice jeho nástrojů stály tisíce trvalých tokenů na session a gh dělal tu samou práci. Nic se nezhoršilo. Tohle jedno smazání zaplatilo čas na napsání tohoto článku.

Odebral jsem memory MCP server ve prospěch skillu Memory Management. Server byl další proces, o který se musím starat, a další přihlašování, které musím udržovat. Skill dělá tu práci v obyčejných souborech, které si sám umím přečíst a upravit. Když paměť zlobí, otevřu markdown a opravím ho, což jsem s neprůhledným úložištěm nikdy nemohl.

Zkrátil jsem CLAUDE.md ze 400 řádků na 54. Dlouhá verze četla jako dobrá dokumentace a fungovala jako šum. Dodržování pravidel, na kterých záleželo, vzrostlo, když zmizela ta, na kterých nezáleželo. Teď na každý řádek pohlížím jako na nájem.

Odinstaloval jsem 19 z 28 skillů. Většina byly instalace typu „mohlo by se hodit", které se v reálné práci nikdy nespustily. Líné načítání znamená, že stojí málo, ale překrývající se popisy způsobily dva skutečné konflikty spouštění a audit, který je odhalil, byl zdlouhavý. Devět skillů, které se spouštějí týdně, porazí 28, která většinou ne.

Vrátil jsem zpět plošné pravidlo Bash(*) allow. Přidal jsem ho v týdnu s deadlinem a držel ho příliš dlouho. Ten den, kdy Claude sebevědomě spustil destruktivní migraci proti vývojové databázi, která se ukázala být míň zahoditelná, než bylo označeno, jsem vrátil výzvy pro cokoli, co zapisuje.

Vzorec napříč všemi pěti: odebrání jsem nikdy nelitoval. Přidání jsem litoval často.

Časté chyby prvního týdne

Pět věcí, které dělá skoro každý první týden, abys je mohl přeskočit:

1. Psaní 500řádkového CLAUDE.md první den. Ještě nevíš, co Claude ve tvém repozitáři kazí. Začni s 15 řádky a rozšiřuj podle pozorovaných selhání.
2. Instalace každého zajímavého MCP serveru. Každý zatíží každou session. Začni s nulou a přidávej jeden, když narazíš na zeď, kterou řeší.
3. Spuštění --dangerously-skip-permissions na hlavním stroji, protože výzvy otravovaly. Místo toho dej na allowlist bezpečné příkazy; zabije to 90 % výzev bez toho rizika.
4. Instalace skillů bez ověření, že se spouštějí. Polovina hodnoty skillu umírá ve vágním poli popisu. Otestuj každý přirozeným požadavkem, bez jmenování skillu.
5. Držení konfigurace mimo repozitář. Pokud projektový CLAUDE.md a settings.json nejsou commitnuté, každý kolega si tvoje nastavení špatně poskládá z paměti.

Údržba: co projít po každém vydání Claude

Nastavení vyladěné pro jednu verzi modelu se s časem rozjíždí od té další. Po každém významném vydání Claude věnuj 20 minut čtyřem kontrolám.

Znovu přečti svůj CLAUDE.md a smaž pravidla, která nový model už nepotřebuje. Upgrady modelu pravidelně zastarají instrukce; pravidlo „vždycky spusť linter", které jsi napsal před rokem, teď může být výchozí chování, za jehož opakování platíš tokeny.

Znovu otestuj spouštění skillů. Shoda triggeru je chování modelu, ne shoda klíčových slov, takže popis, který spolehlivě fungoval na jednom modelu, může u dalšího ztichnout. Náš katalog po velkých vydáních znovu testuje top skilly a stránky jednotlivých skillů nesou aktuální verdikt.

Znovu změř svou kontextovou zátěž. Nová vydání někdy mění, jak se počítají nebo cachují definice nástrojů MCP. Nástroje z našeho seznamu efektivních skillů jsou tam, kam posíláme lidi, kteří chtějí zauditovat, co jim skutečně žere rozpočet; několik skillů v té kategorii existuje přesně pro tuhle kontrolu.

A zkontroluj changelog kvůli změnám v modelu oprávnění, než nastavení tvého týmu potichu začne znamenat něco jiného. Zabere to pět minut a nás to už dvakrát zachránilo.

Časté dotazy

Je 30 minut reálných, upřímně?

Pro vrstvy 1 až 5 tak, jak jsou napsané, ano, měřili jsme to s novými kolegy. Co trvá déle, je ladění: tvůj CLAUDE.md dosáhne stabilní podoby po dvou až třech týdnech chytání Claudových opakovaných chyb. Počítej s 30 minutami na sestavení a pár minutami ladění denně první dva týdny.

Potřebuju vůbec MCP servery?

Spousta dobrých nastavení běží s nulou. Pokud tvá práce žije v repozitáři (kód, testy, dokumentace), pokryjí to skilly plus CLI nástroje. MCP se vyplatí, když Claude potřebuje živý přístup k něčemu vnějšímu, a databáze je nejčastější skutečný případ. V pochybnostech začni bez a přidej server, jakmile poprvé narazíš na zeď.

Má být CLAUDE.md globální, nebo per-projekt?

Obojí, s různým obsahem. Globální (~/.claude/CLAUDE.md) nese tvé osobní preference a platí všude. Per-projekt nese build příkazy a konvence a patří do gitu, aby ho sdílel celý tým. Chyba je dávat fakta o projektu do globálního souboru, kde znečišťují session všech ostatních projektů.

Kolik skillů je moc?

Z hlediska tokenů je strop vysoký: i 50 skillů stojí jen pár tisíc tokenů trvalých metadat. Praktický strop je nižší, protože skilly s překrývajícími se popisy si začnou konkurovat o stejné triggery. My běžíme na devíti. Nad 15 by ses měl spíš zbavovat toho, co se měsíc nespustilo, než přidávat další.

Můžu vrstvu oprávnění přeskočit, když pracuju v sandboxu?

Pokud je sandbox opravdu zahoditelný, žádné přihlašovací údaje, žádné připojené svazky, na kterých ti záleží, pak ano, a --dangerously-skip-permissions existuje přesně pro tenhle případ. Tahle vrstva záleží na strojích se skutečnými tajemstvími. Většina lidských „sandboxů" je notebook s produkčními AWS klíči v dotfilu, což sandbox není.