Inštalátor CodeGym: čo robí s vaším počítačom

Inštalátor CodeGym žiada administrátorské práva a nainštaluje do počítača približne desiatku programov. Byť v tej chvíli ostražitý je normálne a správne. Každý, komu záleží na vlastnom počítači, má právo sa opýtať: čo presne s ním tento program chce urobiť?

Tento článok na túto otázku odpovedá úplne a bez prikrášľovania. Čo sa inštaluje, kam sa to ukladá, čoho sa nedotýkame, aké údaje sa zbierajú a ako to celé vrátiť späť.

Ak inštalátor používať nechcete, nepoužívajte ho. Kurz sa dá prejsť aj bez neho: v prednáškach sa všetko potrebné inštaluje ručne, krok za krokom. Inštalátor vás len zbaví rutiny.

1. Načo je dobrý

Kurz potrebuje dosť veľa nástrojov: samotný Claude Code, vývojové prostredie, jazyky, nástroje na zostavenie. Každý sa inštaluje inak, každý má vlastné nastavenia a niektoré treba ešte navzájom prepojiť a prihlásiť sa do nich.

Ručne sa to celé zvládnuť dá, ale je to niekoľko hodín práce, pri ktorej sa ľahko pomýlite a potom dlho hľadáte, prečo sa niečo nespustí. Inštalátor urobí to isté jediným spustením. Nuda, zato predvídateľná.

2. Čo sa inštaluje

Nižšie je úplný zoznam toho, čo sa objaví vo vašom počítači.

Claude Code a hlasový vstup

Claude Code CLI - hlavný nástroj kurzu, samotný AI agent. Inštaluje sa oficiálnym inštalátorom Anthropic zo stránky claude.ai, vždy v najnovšej verzii.

Handy - nástroj na rozpoznávanie reči. Vďaka nemu môžete agentovi zadávať úlohy hlasom a nemusíte ich písať. Spolu s ním sa stiahne model rozpoznávania Parakeet V3 (asi 456 MB) a ten beží priamo vo vašom počítači, bez internetu.

Dva pluginy pre Claude Code - superpowers a frontend-design z oficiálneho marketplace spoločnosti Anthropic.

Vývojové prostredia

IntelliJ IDEA - hlavné prostredie kurzu. Spolu s tromi pluginmi: podpora Pythonu, plugin CodeGym (odosielanie úloh na kontrolu) a plugin Claude Code (panel agenta priamo v prostredí).

Visual Studio Code - druhé prostredie, nainštaluje sa popri prvom, aby ste si mohli vybrať. S dvoma pluginmi z tej istej sady: CodeGym (beta verzia) a oficiálny Claude Code.

Jazyky a nástroje

Node.js 24 - na ňom bežia projekty kurzu a kontrola výsledku.
Python 3.14 - na skripty a časť úloh.
Java 25 (Eclipse Temurin) - základ platformy CodeGym.
Gradle 9.5.1 - zostavovanie Java projektov.
Git - ukladanie histórie projektu, v kurze ho budete potrebovať neskôr. Vo Windows sa spolu s ním nainštaluje aj Git Bash.

Nastavenia a prihlásenie

Súbor s nastaveniami prístupu k AI serveru kurzu, konfigurácia pluginov CodeGym a kurzový profil Claude Code: pravidlá práce agenta, pomocné postupy a šablóny pre hry a webové projekty. Všetko je už vyplnené za vás, takže nemusíte zadávať kľúče ani sa prihlasovať.

Rozdiely medzi systémami

Ak v macOS nemáte nainštalovaný Homebrew (správca balíkov), inštalátor nainštaluje aj ten, pretože cez neho sa inštalujú Git, Python a VS Code.

V Linuxe sa pridajú repozitáre Node.js, Pythonu a Microsoftu (pre VS Code). V Debiane sa Python 3.14 nenainštaluje: inštalátor to v správe otvorene uvedie a nainštalovať ho budete musieť ručne.

3. Kam sa všetko ukladá

Inštalátor nerozhadzuje súbory po celom systéme. Všetko leží na predvídateľných miestach - keď budete neskôr chcieť zistiť, čo kde skončilo, nájdete to bez dlhého hľadania.

Programy

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

Tri adresáre v domovskom priečinku

.claude-codegym - kurzový profil Claude Code: nastavenia, pravidlá práce agenta, pomocné postupy.

.codegym - nastavenia na prihlásenie do pluginov CodeGym a dva spúšťacie príkazy (o nich nižšie).

.codegym-backups - záložné kópie súborov, ktoré inštalátor zmenil, a k tomu denník zmien. Uchovávajú sa kópie z posledných 10 spustení alebo za posledných 30 dní.

Mimo nich: samotný Claude Code sa inštaluje do ~/.local/bin a model rozpoznávania reči do dátového priečinka aplikácie Handy.

Čo sa mení v systémových nastaveniach

Premenná PATH - aby sa príkazy kurzu dali spúšťať z terminálu. Vo Windows sa úprava zapisuje do registra, v macOS do súboru .zprofile, v Linuxe do /etc/profile.d/codegym.sh a .profile.

V macOS a Linuxe sú naše riadky ohraničené značkami # CODEGYM START a # CODEGYM END. Vidno ich na prvý pohľad a zrušenie zmien odstráni práve tieto riadky, bez toho, aby sa dotklo vašich nastavení.

Register Windows - tri záznamy, nie viac: cesta ku Gradle, cesta k príkazom kurzu a prijatie licenčnej zmluvy IntelliJ IDEA.

4. Dva príkazy: claude a claude-native

Toto je dôležitý detail a oplatí sa o ňom vedieť vopred.

Kurz má vlastné nastavenia Claude Code: pripojenie k serveru kurzu, pravidlá práce agenta, postavy kurzu. Miešať ich s vašimi osobnými nastaveniami sa nesmie, preto sme ich oddelili.

claude - spustí Claude Code s profilom kurzu. Tento príkaz používate v kurze.

claude-native - spustí váš osobný Claude Code, akoby sme tu vôbec neboli. Vaše vlastné nastavenia, váš účet.

Funguje to takto: oba príkazy sú malé skripty v priečinku .codegym/bin, ktoré spúšťajú ten istý skutočný Claude Code, len ho nasmerujú na rôzne priečinky s nastaveniami. Sám mám oba po ruke: kurzový na prácu v kurze, svoj na všetko ostatné.

Váš osobný profil Claude Code inštalátor nečíta, nemení ani nemaže. Ak ste ho mali, zostane presne taký, aký bol.

Jedna praktická poznámka: príkazy sa objavia až v novom okne terminálu. Ak hneď po inštalácii napíšete claude v okne, ktoré už bolo otvorené, také okno o týchto príkazoch ešte nevie. Stačí otvoriť nové.

5. Čo nerobíme

Toto je asi najdôležitejšia časť. Inštalátor je napísaný podľa zásady "neuškodiť" a z nej vyplýva toto.

Neodstraňujeme ani neprepisujeme to, čo už máte nainštalované. Ak máte v počítači Javu, Python, Node alebo Git v inej verzii, zostanú na svojom mieste. Verzia pre kurz sa nainštaluje vedľa nich.

Nesiahame na správcov verzií. Ak pracujete cez nvm, pyenv, sdkman alebo asdf, inštalátor ich nechá na pokoji a v správe vás upozorní, že nainštaloval verziu vedľa nich. Pokaziť vám pyenv je to posledné, čo chceme.

Nepreinštalovávame to, čo už je v správnej verzii. Opakované spustenie nepokazí to, čo je nainštalované: inštalátor skontroluje každý nástroj a hotové preskočí.

Nesiahame na IntelliJ IDEA, ktorú sme neinštalovali my. Ak máte IDEA z JetBrains Toolbox, necháme ju tak, pre kurz nainštalujeme samostatnú a povieme vám o tom.

Neprepisujeme vaše súhlasy. Ak ste už licenciu IDEA prijali alebo ste si nastavili zber štatistík, tieto nastavenia ostanú také, aké ste si zvolili.

Nezasahujeme do automatického spúšťania, služieb ani systémových politík. Inštalátor sa nepridáva do automatického spúšťania, nevytvára služby ani úlohy v Plánovači úloh, neinštaluje certifikáty, nesiaha na firewall, hosts ani DNS.

Nerozširujeme oprávnenia AI agenta. Kurzový profil neruší žiadne obmedzenia Claude Code: agent pracuje s bežnými nastaveniami zabezpečenia a o povolenie žiada rovnako ako vždy.

6. Aké údaje sa zbierajú

Váš osobný kľúč

Pri sťahovaní sa do archívu zapíše osobný prístupový kľúč, ktorý je naviazaný na váš účet. Cez neho sa pluginy CodeGym a Claude Code prihlasujú do účtu samy, preto nemusíte kľúče zadávať ručne. Do denníka sa nedostane: maskuje ho ten istý filter ako heslá. A práve tento kľúč je dôvod, prečo archív neodporúčame dávať iným.

Denník inštalácie

Počas inštalácie sa vedie podrobný denník: ktoré kroky prebehli, čo už v počítači bolo, čo sa podarilo a čo nie. Tento denník zostáva u vás na disku. Nikam neodchádza.

Ak sa niečo pokazí, pošlete ho sami, keď sa tak rozhodnete. Vo Windows leží v dočasnom priečinku (%TEMP%\codegym-install.log), v macOS a Linuxe vedľa samotného inštalátora ako súbor install.log.

Heslá a kľúče sa do denníka nedostanú: pred zápisom prejde každý riadok filtrom, ktorý tokeny a heslá nahradí značkou [SECRET]. Obsah vašich konfiguračných súborov sa tam tiež nezapisuje, iba názvy parametrov.

Ak niekedy pribudne automatické odosielanie hlásení o chybách, dáme vám o tom vedieť vopred a budete ho môcť vypnúť.

Denník kurzových relácií

Samostatná vec, o ktorej treba hovoriť na rovinu.

Kurzový profil Claude Code má nastavené vedenie pracovného denníka. Keď riešite úlohu kurzu, v priečinku projektu sa vytvorí súbor .codegym/cc-transcript.txt a do neho sa zapisuje priebeh práce: vaše požiadavky agentovi, začiatky jeho odpovedí, ktoré súbory agent menil, ktoré príkazy spúšťal.

Načo to je: podľa tohto denníka platforma kontroluje riešenie úlohy. Je to váš "zošit s postupom" - vidno v ňom nielen výsledok, ale aj to, ako ste sa k nemu dopracovali. Znie to trochu znepokojivo, chápem. Lenže bez denníka platforma vidí iba to, čo vyšlo na konci.

Čo je dôležité vedieť:

denník leží v priečinku vášho projektu, môžete si ho otvoriť a prečítať;
sám sa nikam neodosiela - v súboroch, ktoré denník vedú, nie je ani jedno sieťové volanie;
heslá a kľúče sa v ňom maskujú rovnako ako v denníku inštalácie;
vedie sa iba v kurzovom profile. Spustite claude-native a denník sa zapisovať nebude.

Cez aký server ide práca s AI

Ešte jeden fakt, ktorý je lepšie otvorene povedať, než zamlčať.

CodeGym hradí prístup k AI, ktorý v kurze dostávate, a ten funguje cez náš server llm.codegym.cc. To znamená, že požiadavky na model a jeho odpovede fyzicky prechádzajú infraštruktúrou CodeGym.

Takto funguje bezplatný prístup pre študentov. Ak potrebujete pracovať priamo so svojím osobným účtom, práve na to slúži príkaz claude-native.

7. Ako to overiť a ako to vrátiť späť

Článku nemusíte veriť na slovo. Inštalátor má režimy, v ktorých si všetko môžete pozrieť vopred a potom to aj vrátiť späť.

Pozrieť sa bez inštalácie

Prepínač --dry-run (vo Windows -DryRun) spustí inštalátor v režime "iba ukázať". Vypíše úplný zoznam toho, čo by urobil - ktoré súbory by stiahol, kam by ich uložil, čo by zapísal do PATH - a skončí bez toho, aby niečo nainštaloval.

Úprimne povedané, úplne "nič nemeniacim" sa tento režim nazvať nedá. Prepíše súbor denníka z predchádzajúceho spustenia, vytvorí pomocné priečinky a vyčistí zastarané záložné kópie. Nenainštaluje sa pritom ani jeden program a nastavenia ani PATH sa nezmenia.

Nemeniť PATH

Prepínač --minimal (vo Windows -Minimal) nainštaluje všetky programy, ale nezapíše cesty do systémových nastavení. Namiesto toho vypíše riadky, ktoré si pridáte sami. Režim pre tých, ktorí majú prostredie nastavené po svojom (ak si nie ste istí, či ho potrebujete, tak ho nepotrebujete).

Vo Windows tento režim zatiaľ nefunguje úplne: cesta k príkazom kurzu sa do používateľskej premennej PATH predsa len pridá. Zmena je vratná, ale prepínač zatiaľ nerobí celkom to, čo sľubuje. Vieme o tom, opravíme to.

Vrátiť zmeny späť

Prepínač --rollback (vo Windows -Rollback) vráti nastavenia, ktoré inštalátor zmenil: PATH, profilové súbory shellu, konfigurácie, záznamy v registri. Každá zmena sa zapisuje do denníka operácií a vrátenie postupuje presne podľa neho.

Ďalšia poistka: ak ste súbor po inštalácii upravovali, vrátenie sa ho nedotkne. Namiesto toho vás upozorní a ukáže, kde leží záložná kópia.

Čo vrátenie nerobí: neodinštaluje nainštalované programy. IntelliJ IDEA, Java, Node a ostatné zostanú na svojom mieste. Inštalátor namiesto toho vypíše ich zoznam s pripravenými príkazmi na odinštalovanie a o tom, čo odstrániť, rozhodnete vy.

A ešte jeden úprimný detail: inštalátory Javy, Node a Pythonu vo Windows si zapisujú cesty samy, mimo nášho denníka operácií. Tieto záznamy vrátenie zrušiť nedokáže.

Vo Windows inštalátor sám vypíše hotový príkaz na vrátenie zmien na konci inštalácie. Spustíte ho takto:

Otvorte PowerShell ako správca: kliknite pravým tlačidlom na ikonu PowerShellu a zvoľte "Spustiť ako správca".
Prejdite do priečinka inštalátora.
Spustite príkaz:

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

Pozrieť sa, čo sa urobilo

Na konci inštalátor vypíše správu: zoznam krokov a pri každom stav - hotovo, preskočené, varovanie, chyba alebo "urobte ručne". Neúspechy sa neskrývajú: ak sa niečo nenainštalovalo, bude to tam napísané priamo aj s dôvodom.

Všetko, čo inštalátor nedokázal urobiť sám, sa zhromaždí v samostatnom bloku "Dokončiť ručne" s konkrétnymi príkazmi.

8. Čo budete musieť urobiť ručne

Niektoré veci sa zautomatizovať jednoducho nedajú.

Povolenia pre Handy. Pri prvom spustení si systém vypýta prístup k mikrofónu (v macOS navyše aj k "Prístupnosti"). Bez toho hlasový vstup fungovať nebude. Povolenia môže udeliť iba človek, žiadny program to za vás neurobí.

Možné okná IntelliJ IDEA pri prvom spustení. Inštalátor licenciu prijme vopred, ale ak sa licenčné okno predsa len objaví, prijmite ju.

9. Časté otázky

Ako dlho trvá inštalácia?

20-40 minút, stiahne sa asi gigabajt. Najviac času zaberie IntelliJ IDEA a model rozpoznávania reči.

Načo sú potrebné administrátorské práva?

Programy sa inštalujú do systémových priečinkov (Program Files, /opt, /Applications) a bez administrátorských práv sa tam zapisovať nedá. Nastavenia a profil sa pritom ukladajú do vášho používateľského priečinka a naďalej patria vám.

Môžem inštalátor spustiť dvakrát?

Áno, nič sa nepokazí. Čo je už nainštalované, sa preskočí. Proti náhodnému dvojitému spusteniu je aj ochrana: druhá inštancia zistí, že inštalácia už prebieha, a jednoducho sa zavrie.

Čo sa stane s mojimi nastaveniami Claude Code?

Nič. Kurzový profil leží v samostatnom priečinku, ten váš osobný sa nečíta ani nemení. Na osobnú prácu je tu príkaz claude-native.

Systém pri spustení zobrazí upozornenie. Je to normálne?

Áno. Takto operačné systémy reagujú na každý program stiahnutý z internetu, pretože náš inštalátor zatiaľ nemá podpisový certifikát. Vo Windows kliknite na "Ďalšie informácie" a potom na "Spustiť aj tak". Ak macOS hlási, že nedokáže overiť vývojára, kliknite na súbor pravým tlačidlom, vyberte "Otvoriť" a potom to ešte raz potvrďte.

Inštalátor zo súborov odstraňuje označenie "stiahnuté z internetu". Prečo?

Inak systém zablokuje spustenie pribalených súborov a inštalácia sa preruší v polovici. Vo Windows sa to robí pre rozbalený priečinok, v macOS ide o zrušenie karantény Gatekeeper pre ten istý priečinok. Označenie sa odstraňuje iba zo súborov samotného inštalátora, ostatných vašich súborov sa inštalátor nedotýka.

Prečo sa archív nesmie dávať iným?

Sú v ňom vaše osobné prihlasovacie údaje. Kto archív dostane, bude môcť pracovať pod vaším účtom. Odkaz na stiahnutie dávať môžete: každý dostane vlastný archív.

Niečo sa pokazilo. Čo robiť?

Pozrite si správu na konci a súbor install.log: vidno v nich, na ktorom kroku sa to pokazilo a prečo. Ak to nie je jasné, pošlite tento súbor podpore. Je to bežný postup, nie krajné riešenie.

10. Ak nechcete inštalovať všetko naraz

Inštalátor nie je povinný krok kurzu, ale spôsob, ako ušetriť čas. Všetko, čo robí, je krok za krokom rozobraté v prednáškach: Claude Code sa nainštaluje jedným príkazom, nastavenia sa skopírujú ako jeden súbor.

Ostatné nástroje pribúdajú podľa potreby a vo chvíli, keď ich budete potrebovať, už budete chápať, načo sú. Tak si ich aj lepšie zapamätáte, než keby to bol zoznam na desať riadkov.