Instalátor CodeGym: co dělá s vaším počítačem

Instalátor CodeGym chce administrátorská práva a nainstaluje do počítače zhruba deset programů. Zpozornět v tu chvíli je normální a správné. Každý, komu záleží na vlastním počítači, má právo se zeptat: co přesně s ním ten program chce dělat?

Tento článek na to odpovídá úplně a bez příkras. Co se instaluje, kam se to ukládá, na co nesaháme, jaká data se shromažďují a jak to všechno vrátit zpět.

Pokud instalátor používat nechcete, nepoužívejte ho. Kurz se dá absolvovat i bez něj: v lekcích se všechno potřebné instaluje ručně krok za krokem. Instalátor vám jen ušetří rutinu.

1. K čemu je dobrý

Kurz potřebuje docela dost nástrojů: samotný Claude Code, vývojové prostředí, jazyky, nástroje pro sestavení. Každý se instaluje po svém, každý má vlastní nastavení a část z nich je ještě potřeba navzájem propojit a přihlásit se do nich.

Projít tím ručně se dá, jenže je to několik hodin práce, při které se snadno udělá chyba a pak dlouho hledáte, proč něco nejde spustit. Instalátor udělá totéž na jedno spuštění. Nuda, ale předvídatelná.

2. Co se instaluje

Níže je úplný seznam toho, co se v počítači objeví.

Claude Code a hlasové zadávání

Claude Code CLI - hlavní nástroj kurzu, právě ten AI agent. Instaluje se oficiálním instalátorem Anthropic z webu claude.ai, vždy v nejnovější verzi.

Handy - nástroj pro rozpoznávání řeči. Díky němu můžete agentovi úkoly diktovat, místo abyste je psali. Spolu s ním se stáhne model pro rozpoznávání Parakeet V3 (asi 456 MB) - běží přímo na vašem počítači, bez internetu.

Dva pluginy pro Claude Code - superpowers a frontend-design z oficiálního marketplace Anthropic.

Vývojová prostředí

IntelliJ IDEA - hlavní vývojové prostředí kurzu. Dostane tři pluginy: podporu Pythonu, plugin CodeGym (odesílání úloh ke kontrole) a plugin Claude Code (panel agenta přímo v IDE).

Visual Studio Code - druhé prostředí, instaluje se vedle, abyste si mohli vybrat. Dostane dva pluginy ze stejné sady: CodeGym (beta verze) a oficiální Claude Code.

Jazyky a nástroje

Node.js 24 - běží na něm projekty kurzu a kontrola výsledku.
Python 3.14 - pro skripty a část úloh.
Java 25 (Eclipse Temurin) - základ platformy CodeGym.
Gradle 9.5.1 - sestavování projektů v Javě.
Git - ukládá historii projektu, budete ho potřebovat dál v kurzu. Na Windows se s ním nainstaluje i Git Bash.

Nastavení a přihlášení

Soubor s nastavením přístupu k AI serveru kurzu, konfigurace pluginů CodeGym a výukový profil Claude Code: pravidla práce agenta, pomocné postupy a šablony pro hry a webové projekty. Všechno je už pro vás vyplněné - žádné klíče zadávat ani se přihlašovat nemusíte.

Rozdíly mezi systémy

Na macOS instalátor nainstaluje i Homebrew (správce balíčků), pokud ho nemáte - přes něj se instalují Git, Python a VS Code.

Na Linuxu se přidávají repozitáře Node.js, Pythonu a Microsoftu (pro VS Code). Na Debianu se Python 3.14 nenainstaluje - instalátor vám to v přehledu na rovinu napíše a nainstalovat ho budete muset ručně.

3. Kam se všechno ukládá

Instalátor nerozhazuje soubory po celém systému. Všechno leží na předvídatelných místech - když se později budete chtít podívat, co kam přibylo, najdete to bez pátrání.

Programy

Systém	Kam
Windows	`Program Files`, `C:\Gradle`
macOS	`/Applications`, `/opt`
Linux	`/opt`

Tři adresáře v domovské složce

.claude-codegym - výukový profil Claude Code: nastavení, pravidla práce agenta, pomocné postupy.

.codegym - nastavení pro přihlášení do pluginů CodeGym a dva spouštěcí příkazy (o nich níže).

.codegym-backups - zálohy souborů, které instalátor změnil, a k tomu záznam změn. Uchovává se posledních 10 spuštění nebo 30 dní.

Zvlášť: samotný Claude Code se instaluje do ~/.local/bin a model pro rozpoznávání řeči do datové složky Handy.

Co se mění v systémovém nastavení

Proměnná PATH - aby se příkazy kurzu daly spouštět z terminálu. Na Windows se úprava zapisuje do registru, na macOS do souboru .zprofile, na Linuxu do /etc/profile.d/codegym.sh a .profile.

Na macOS a Linuxu jsou naše řádky ohraničené značkami # CODEGYM START a # CODEGYM END. Jsou vidět na první pohled a vrácení změn odstraní právě tyto řádky, aniž by sáhlo na vaše nastavení.

Registr Windows - tři položky, nic víc: cesta ke Gradlu, cesta k příkazům kurzu a přijetí licenční smlouvy IntelliJ IDEA.

4. Dva příkazy: claude a claude-native

Tohle je důležitý detail a vyplatí se o něm vědět předem.

Kurz má vlastní nastavení Claude Code: připojení k výukovému serveru, pravidla práce agenta, postavy kurzu. Míchat je s vaším osobním nastavením nejde, proto jsme je od sebe oddělili.

claude - spustí Claude Code s profilem kurzu. S tím pracujete v kurzu.

claude-native - spustí váš osobní Claude Code, jako bychom tu vůbec nebyli. Vaše vlastní nastavení, váš účet.

Funguje to takhle: oba příkazy jsou malé skripty ve složce .codegym/bin, které spouštějí jeden a tentýž skutečný Claude Code, jen mu předávají různé složky s nastavením. Sám mám po ruce oba: kurzový na práci v kurzu, svůj na všechno ostatní.

Váš osobní profil Claude Code instalátor nečte, nemění ani nemaže. Pokud jste ho měli, zůstane přesně takový, jaký byl.

Jedna praktická poznámka: příkazy se objeví až v novém okně terminálu. Když hned po instalaci napíšete claude do okna, které už bylo otevřené, takové okno o těchto příkazech ještě neví - prostě otevřete nové.

5. Co neděláme

Tohle je asi nejdůležitější část. Instalátor je napsaný podle zásady "neuškodit" a z ní plyne následující.

Nemažeme ani nepřepisujeme to, co už máte nainstalované. Pokud je v počítači Java, Python, Node nebo Git v jiné verzi, zůstanou na svém místě. Verze pro kurz se nainstaluje vedle.

Nesaháme na správce verzí. Pokud používáte nvm, pyenv, sdkman nebo asdf, instalátor je nechá být a v přehledu vás upozorní, že nainstaloval verzi vedle. Rozbít někomu pyenv je to poslední, co chceme.

Nepřeinstalováváme to, co už je ve správné verzi. Opakované spuštění nic z nainstalovaného nerozbije: instalátor každý nástroj zkontroluje a hotové přeskočí.

Nesaháme na IntelliJ IDEA, kterou jsme neinstalovali my. Pokud máte IDEA z JetBrains Toolbox, necháme ji být - nainstalujeme pro kurz samostatnou a řekneme vám to.

Nepřepisujeme vaše souhlasy. Pokud jste už licenci IDEA přijali nebo nastavili sběr statistik, tato nastavení zůstanou vaše.

Nelezeme do automatického spouštění, služeb ani systémových zásad. Instalátor se nezapisuje do automatického spouštění, nevytváří služby ani úlohy plánovače, neinstaluje certifikáty, nesahá na firewall, hosts ani DNS.

Nerozšiřujeme oprávnění AI agenta. Výukový profil neruší žádná omezení Claude Code - agent pracuje s běžným nastavením zabezpečení a žádá o povolení stejně jako vždycky.

6. Jaká data se shromažďují

Váš osobní klíč

Při stahování se do archivu zapíše osobní přístupový klíč, svázaný s vaším účtem. Pomocí něj se pluginy CodeGym a Claude Code přihlašují k účtu samy, a proto nemusíte žádné klíče zadávat ručně. Do záznamu se klíč nedostane - maskuje ho stejný filtr jako hesla. A právě kvůli němu byste archiv neměli dávat dalším lidem.

Záznam instalace

Během instalace se vede podrobný záznam: které kroky proběhly, co už v počítači bylo, co se povedlo a co ne. Tento záznam zůstává u vás na disku. Nikam se neposílá.

Když se něco pokazí, pošlete ho sami, podle vlastního rozhodnutí. Na Windows leží v dočasné složce (%TEMP%\codegym-install.log), na macOS a Linuxu vedle samotného instalátoru, v souboru install.log.

Hesla a klíče se do záznamu nedostanou: před zápisem projde každý řádek filtrem, který tokeny a hesla nahradí značkou [SECRET]. Obsah vašich konfiguračních souborů se tam také nezapisuje - jen názvy parametrů.

Pokud někdy přibude automatické odesílání hlášení o chybách, napíšeme o tom předem a necháme vám možnost ho vypnout.

Záznam výukových relací

Samostatná věc, o které je potřeba mluvit na rovinu.

Ve výukovém profilu Claude Code je nastavené vedení záznamu práce. Když řešíte úlohu kurzu, ve složce projektu se vytvoří soubor .codegym/cc-transcript.txt, do kterého se zapisuje průběh práce: vaše požadavky na agenta, začátky jeho odpovědí, které soubory měnil, které příkazy spouštěl.

K čemu to je: podle tohoto záznamu platforma kontroluje řešení úlohy. Je to váš "sešit s postupem řešení" - je z něj vidět nejen výsledek, ale i to, jak jste se k němu dopracovali. Zní to znepokojivě, chápu. Jenže bez záznamu platforma vidí jen to, co vzniklo na konci.

Co je důležité vědět:

záznam leží ve složce vašeho projektu, můžete ho otevřít a přečíst;
sám se nikam neodesílá - v souborech, které záznam vedou, není ani jeden požadavek do internetu;
hesla a klíče se v něm maskují stejně jako v záznamu instalace;
vede se jen ve výukovém profilu. Spusťte claude-native a záznam se nepíše.

Přes jaký server jde práce s AI

Ještě jeden fakt, který je poctivější říct, než zamlčet.

Přístup k AI v kurzu platí CodeGym a funguje přes náš server llm.codegym.cc. To znamená, že požadavky na model a jeho odpovědi fyzicky procházejí infrastrukturou CodeGym.

Tak funguje bezplatný přístup pro studenty. Pokud potřebujete pracovat přímo se svým osobním účtem, právě k tomu slouží příkaz claude-native.

7. Jak to ověřit a jak to vrátit zpět

Článku nemusíte věřit na slovo. Instalátor má režimy, ve kterých se můžete podívat předem a změny vrátit zpět.

Podívat se, aniž by se cokoli instalovalo

Přepínač --dry-run (na Windows -DryRun) spustí instalátor v režimu "jen ukázat". Vypíše úplný seznam toho, co by udělal (které soubory by stáhl, kam by je uložil, co by zapsal do PATH), a skončí, aniž by cokoli nainstaloval.

Poctivě řečeno: úplně "na nic nesahající" se tento režim nazvat nedá. Přepíše soubor záznamu z předchozího spuštění, vytvoří pomocné složky a pročistí zastaralé zálohy. Žádný program se přitom nenainstaluje, nastavení ani PATH se nemění.

Nesahat na PATH

Přepínač --minimal (na Windows -Minimal) nainstaluje všechny programy, ale nezapisuje cesty do systémového nastavení - místo toho vypíše řádky, které si přidáte sami. Režim pro ty, kdo mají prostředí nastavené po svém (pokud si nejste jistí, jestli ho potřebujete, tak ho nepotřebujete).

Na Windows tento režim zatím nefunguje úplně: cesta k příkazům kurzu se do uživatelské proměnné PATH přece jen přidá. Úprava je vratná, ale přepínač zatím nedělá úplně to, co slibuje. Víme o tom, opravíme to.

Vrátit změny zpět

Přepínač --rollback (na Windows -Rollback) vrátí nastavení, která instalátor změnil: PATH, soubory profilu shellu, konfigurace, položky v registru. Každá změna se zapisuje do záznamu operací a vrácení postupuje přesně podle něj.

Ochrana navíc: pokud jste soubor po instalaci upravovali, vrácení změn na něj nesáhne - dá vám vědět a ukáže, kde leží záloha.

Co vrácení změn nedělá: neodinstaluje nainstalované programy. IntelliJ IDEA, Java, Node a ostatní zůstanou na místě. Instalátor místo toho vypíše jejich seznam s připravenými příkazy pro odinstalaci - co odstranit, rozhodujete vy.

Ještě jeden poctivý detail: instalátory Javy, Node a Pythonu si na Windows zapisují své cesty samy, mimo náš záznam operací. Tyto zápisy vrácení změn obnovit nedokáže.

Na Windows instalátor sám vypíše hotový příkaz pro vrácení změn na konci instalace. Spustíte ho takto:

Otevřete PowerShell jako správce: klikněte pravým tlačítkem na ikonu PowerShellu a zvolte "Spustit jako správce".
Přejděte do složky instalátoru.
Spusťte příkaz:

powershell -NoProfile -ExecutionPolicy Bypass -File .\resources\Windows_install.ps1 -Rollback

Podívat se, co se udělalo

Na konci instalátor vypíše přehled: seznam kroků a u každého stav - hotovo, přeskočeno, varování, chyba nebo "udělejte ručně". Neúspěchy se neskrývají: pokud se něco nenainstalovalo, bude to tam napsané přímo, i s důvodem.

Všechno, co instalátor nezvládl sám, se sesbírá do samostatného bloku "Dokončit ručně" s konkrétními příkazy.

8. Co budete muset udělat ručně

Některé věci se automatizovat zkrátka nedají.

Oprávnění pro Handy. Při prvním spuštění se systém zeptá na přístup k mikrofonu (na macOS navíc i ke "Zpřístupnění"). Bez toho hlasové zadávání fungovat nebude. Oprávnění může udělit jen člověk - žádný program to za vás neudělá.

Možná okna IntelliJ IDEA při prvním spuštění. Instalátor licenci přijme předem, ale pokud se okno s licencí přesto objeví, přijměte ji.

9. Časté otázky

Jak dlouho instalace trvá?

20-40 minut, stahuje se zhruba gigabajt. Nejvíc času zabere IntelliJ IDEA a model pro rozpoznávání řeči.

Proč jsou potřeba administrátorská práva?

Programy se instalují do systémových složek (Program Files, /opt, /Applications) a bez administrátorských práv se tam zapisovat nedá. Nastavení a profil se přitom ukládají do vaší uživatelské složky a zůstávají vaše.

Můžu instalátor spustit dvakrát?

Můžete, nic se nerozbije. Co už je nainstalované, se přeskočí. Proti nechtěnému dvojímu spuštění existuje ochrana: druhá instance zjistí, že instalace už běží, a prostě se zavře.

Co se stane s mým nastavením Claude Code?

Nic. Výukový profil leží v samostatné složce, ten váš osobní se nečte ani nemění. Pro osobní práci je tu příkaz claude-native.

Systém při spuštění ukazuje varování. Je to normální?

Ano. Takhle operační systémy reagují na každý program stažený z internetu - náš instalátor zatím nemá podpisový certifikát. Na Windows klikněte na "Další informace" a pak na "Přesto spustit". Na macOS, pokud systém hlásí, že nemůže ověřit vývojáře, klikněte na soubor pravým tlačítkem, zvolte "Otevřít" a pak to ještě jednou potvrďte.

Instalátor ze souborů odstraňuje příznak "staženo z internetu". Proč?

Jinak systém zablokuje spouštění přibalených souborů a instalace se v půlce přeruší. Na Windows se to dělá pro rozbalenou složku, na macOS jde o zrušení karantény Gatekeeperu pro tutéž složku. Příznak se odstraňuje jen ze souborů samotného instalátoru, na vaše ostatní soubory instalátor nesahá.

Proč archiv nedávat dalším lidem?

Uvnitř jsou vaše osobní přihlašovací údaje. Kdo archiv dostane, bude moct pracovat pod vaším účtem. Odkaz ke stažení sdílet můžete - každý si stáhne vlastní archiv.

Něco se pokazilo. Co dělat?

Podívejte se na přehled na konci a do souboru install.log - je tam vidět, na kterém kroku a proč. Pokud to není jasné, pošlete tento soubor podpoře. Je to běžný postup, ne krajní řešení.

10. Pokud nechcete instalovat všechno najednou

Instalátor není povinný krok kurzu, ale způsob, jak ušetřit čas. Všechno, co dělá, je v lekcích rozebrané krok za krokem: Claude Code se instaluje jedním příkazem, nastavení se kopíruje jako jeden soubor.

Ostatní nástroje přibývají podle potřeby - ve chvíli, kdy je budete potřebovat, už budete chápat, k čemu jsou. Tak si je i líp zapamatujete než jako seznam o deseti řádcích.