Relace Claude Code: pokračovat, vyčistit, nebo začít znovu

Večer zavřete terminál a zdá se, že celý rozhovor s agentem zmizí spolu s oknem. Hodina diskuse, odhalené chyby, vysvětlený kontext úlohy - to všechno jako by se ztratilo.

Neztratí se to. Rozhovor se sám zapisuje na disk, zatímco pracujete, a jedním příkazem se otevře zpátky.

Nejjednodušší je představit si relace jako hotel. Složka projektu je budova, každý rozhovor je pokoj a klíče od všech pokojů visí na tabuli za recepcí. Večer odejdete, ale pokoj za sebou nepálíte: klíč se vrátí na tabuli, věci zůstávají uvnitř. Ráno stačí recepčnímu říct, který pokoj potřebujete.

Přirovnání má svou hranici a je dobré ji hned vytyčit: v pokojích bydlí rozhovory, ne kód. Kód je samotná budova, společná pro všechny hosty.

Níže se dozvíte, co je to relace, tři způsoby, jak se do ní vrátit, k čemu je rozhovoru jméno a proč je na novou úlohu lepší otevřít nový rozhovor místo pokračování ve starém.

Co je to relace

Relace je uložený rozhovor s agentem, vázaný na složku projektu. Zapisuje se na disk nepřetržitě, zatímco pracujete: nic se speciálně neukládá, jako v textovém editoru.

Do relace se nedostávají jen repliky. Kromě vašich zpráv a odpovědí agenta v ní leží i volání nástrojů a jejich výsledky: které soubory otevíral, co vrátily spuštěné příkazy, jaké úpravy provedl. Proto po návratu do starého rozhovoru dostanete ne převyprávění, ale celý obraz najednou.

Dál dvě upřesnění, která odstraní polovinu zmatku.

Obsah jednoho rozhovoru se nepřenáší do jiného. Probírali jste něco před měsícem v jiné relaci - v této její repliky nejsou, i kdyby šlo o stejný projekt. Každá relace zná jen svou vlastní historii.

Relace není druhé místo, kde leží kód. Soubory projektu žijí na disku samy o sobě. Jeden projekt si klidně vystačí s desítkou relací a kód mají všechny společný - ten, co je právě teď ve složce.

Na schématu jsou vidět obě myšlenky najednou: složka je jedna, relací v ní je několik, každá si drží svou historii a soubory dole jsou společné. Otevřít druhou relaci ke stejnému projektu neznamená kopii kódu, ale prostě další rozhovor o něm.

Jak se vrátit k práci

Vstupů jsou tři a volba mezi nimi závisí na tom, jestli si pamatujete, který konkrétní rozhovor potřebujete.

V tabulce se snadno přehlédne jedna věc: horní dva řádky začínají na claude, spodní lomítkem. Ten rozdíl není kosmetický. Horní dva se zadávají v terminálu ve chvíli, kdy agent ještě není na obrazovce - přepínač je tam součástí samotného spouštěcího příkazu. Jedním úkonem tedy agenta spustíte i řeknete mu, který rozhovor má otevřít:

claude              # spuštění s čistým listem
claude --continue   # spuštění rovnou do včerejšího rozhovoru
claude --resume     # spuštění s výběrem rozhovoru ze seznamu

/resume funguje naopak, zevnitř: agent je už otevřený, píšete do jeho vstupního řádku a přepnete na jiný rozhovor, aniž byste se vraceli do terminálu.

V praxi je rozdíl jednoduchý. claude --continue znamená "včera jsem tu pracoval, chci pokračovat": agent tiše otevře poslední rozhovor v aktuální složce. claude --resume znamená "rozhovorů je víc, nechte mě vybrat".

Seznam ukazuje jeden řádek na rozhovor: jméno, pokud jste ho zadali, nebo automatický nadpis, dobu od poslední aktivity, větev a velikost. Pokud je řádků moc, dají se v nich hledat prostě tím, že začnete psát, a seznam lze i rozšířit za hranice aktuální složky: Ctrl+A ukáže rozhovory ze všech projektů na tomhle počítači.

Spolu s rozhovorem se vrátí i všechno, co v něm bylo: celá historie včetně volání nástrojů a jejich výsledků. Zpravidla se zachová i model, pokud se jeho dostupnost a nastavení nezměnily. Pokračovat můžete přesně od místa, kde jste skončili.

K čemu je relaci jméno

Dokud je rozhovor jeden, jméno nepotřebujete. Jakmile jsou tři, seznam se změní v hádanku: dva začínají stejně a u třetího vůbec není jasné, o čem je.

Jméno lze zadat dvěma způsoby:

claude -n feedback-form   # při spuštění
/rename feedback-form     # v už otevřené relaci

Pokud jméno nezadáte, Claude Code si sám vymyslí krátký nadpis podle vaší první zprávy. Funguje také jako orientační bod: podle něj relaci v seznamu poznáte a otevřete. Vlastní jméno je prostě přesnější - automatický nadpis popisuje první větu, ne úlohu jako celek.

Upřímně řečeno, na začátku rozhovoru se jméno vymýšlí zřídka: ještě nevíte, v co naroste. Polovina relací začíná jako "mrknu na jeden řádek" a část z nich se nečekaně promění v práci na půl dne.

Proto je jednodušší tohle. Krátkou návštěvu nechte být, automatický nadpis stačí. Zjistili jste, že jste uvízli na dýl - /rename za chodu. Skončili jste - /clear se jménem: úloha je za vámi a jak ji nazvat, už není otázka.

Nová úloha - nový rozhovor

Během práce je hlavní otázka jen jedna: je to pořád ta samá úloha? Dokud ano, pokračujete. Změnila se - otevřete čistý list. Zní to jako formalita, ale právě tady se rozhovory nejčastěji mění ve zmatek.

Pokušení je pochopitelné: agent už projekt zná, tak proč začínat znovu. Ale rozhovor, do kterého se nahrnuly tři úlohy za sebou, se chová předvídatelně špatně:

• táhne rozhodnutí ze staré úlohy do nové. Hodinu zpátky jste se dohodli na jednom postupu, teď děláte jiný - a on si pamatuje první dohodu a vrací se k ní;
• vyplouvají nápady, které jste už zavrhli. Zavrhli jste je v jiné úloze, ale pro něj je to jeden proud;
• zároveň opravuje i to, co patřilo k předchozí práci. Ptali jste se na formulář a dostali jste navíc i úpravy v platbě;
• změny se promíchají. V jednom rozhovoru úpravy ke dvěma tématům a pak je těžké rozeznat, co k čemu patřilo;
• rozhovor se v seznamu nedá najít. Je o všem najednou, tedy o ničem.

Odtud jednoduché pravidlo: rozhovor žije přesně tak dlouho, dokud pomáhá jedné úloze. Úloha skončí a končí i on. Relace je tady spotřební materiál, ne něco, co se šetří.

Čistý list lze začít dvěma způsoby a rozdíl mezi nimi je menší, než se zdá.

Teď k /clear, protože právě u ní lidé nejčastěji znejistí. Příkaz vypadá jako smazání, ale funguje jako přepnutí: rozhovor nemaže, jen ho odloží stranou a otevře prázdný. Odložený rozhovor zůstává v seznamu a otevře se přes /resume přesně tak, jak jste ho opustili.

Má nepovinný argument - jméno. /clear feedback-form podepíše odcházející rozhovor v seznamu, abyste ho pak poznali. Vteřina práce, a hledání je pak výrazně snazší.

Má to i druhou stranu. Pokud už rozhovor jméno má - přes -n při spuštění nebo /rename za chodu - holý /clear předá toto jméno novému rozhovoru a další úloha skončí podepsaná jménem té předchozí. S argumentem zůstane jméno u starého rozhovoru a nový začne bez jména.

Podívejte se na horní řádek. V tomhle spuštění je aktivní rozhovor jeden, před příkazem i po něm. /clear neotevírá druhou relaci vedle první: vymění aktivní rozhovor za čistý a předchozí odsune dolů, do seznamu. Vrátit se do něj lze jen vědomě, přes /resume.

Nová relace se od /clear liší tím, že obvykle znamená i jinou práci: jiný projekt, jinou složku, jiný den. /clear vás nedostane ven ze současného adresáře ani ze současného spuštění - otevře čistý list tam, kde právě stojíte.

Je tu ještě /compact. Ten příkaz není o změně úlohy, ale o délce rozhovoru: sbalí už řečené do stručného shrnutí a nechá vás ve stejné relaci. Rozebrat ho je lepší spolu s tím, jak funguje okno kontextu a co se stane, když dojde - to je samostatné téma.

Kde to všechno leží a jak dlouho se to uchovává

Rozhovory leží na vašem disku, ve služební složce Claude Code:

~/.claude-codegym/projects/

Znak ~ znamená domovskou složku uživatele. Ve Windows jí odpovídá %USERPROFILE%, takže učební cesta začíná %USERPROFILE%\.claude-codegym\projects\.

.claude-codegym je učební profil. Pokud je Claude Code spuštěný bez něj, standardní cesta vypadá jako ~/.claude/projects/. Uvnitř je podsložka pro každý projekt a v ní hlavní soubor pro každý rozhovor.

Rozhovory se neuchovávají navěky: zhruba po měsíci se staré automaticky odstraní, spolu s body návratu k nim, a lhůta se dá podle potřeby nastavit. Relace je tedy dobré místo pro práci na úloze a špatné pro dlouhodobou historii projektu. Čím se historie uchovává dlouhodobě, je samostatné velké téma.

Co to mění na práci

Pár závěrů, které se budou hodit hned zítra:

• relace je kontejner jedné úlohy, ne korespondence s agentem na celý život. Čím blíž ji k tomu držíte, tím míň se agent plete;
• rozhovor se ukládá sám, speciálně ukládat nemusíte nic. Zavřený terminál večer vás nic nestojí;
• relace jsou rozdělené podle složek. Spustili jste agenta ze složky projektu - jeho rozhovory máte po ruce; pokud je seznam prázdný, zkontrolujte složku: Ctrl+A ukáže rozhovory ze všech projektů a napoví, kam přejít;
• návratem do starého rozhovoru se vrací celý jeho kontext, včetně slepých uliček a zavržených nápadů. Někdy je rychlejší začít znovu než oživovat tříhodinovou diskusi;
• jedna složka a desítka relací v ní je normální pracovní obrázek, ne známka nepořádku.

Umístění souborů relací, obsah seznamu a doba uchovávání závisí na verzi Claude Code a nastavení, takže se u vás mohou od popsaného lišit.