Programul de instalare CodeGym: ce face cu computerul dumneavoastră

Programul de instalare CodeGym cere drepturi de administrator și pune pe computer vreo zece programe. E normal să aveți rezerve în acel moment, ba chiar e bine. Oricine are grijă de calculatorul lui are dreptul să întrebe: ce anume urmează să-i facă acest program?

Articolul de față răspunde complet la întrebare, fără înfrumusețări. Ce se instalează, unde ajunge, ce nu atingem, ce date se colectează și cum se anulează toate acestea.

Dacă nu vreți să folosiți programul de instalare, nu-l folosiți. Cursul se poate parcurge și fără el: în lecții, tot ce vă trebuie se instalează de mână, pas cu pas. Programul de instalare doar vă scutește de munca de rutină.

1. La ce folosește

Cursul are nevoie de destul de multe instrumente: Claude Code propriu-zis, un mediu de dezvoltare, limbaje, utilitare de build. Fiecare se instalează în felul lui, fiecare are setările lui, iar unele trebuie și conectate între ele și autentificate.

Puteți face toate astea de mână, dar înseamnă câteva ore de muncă în care e ușor să greșiți și apoi să căutați mult de ce nu pornește ceva. Programul de instalare face același lucru dintr-o singură rulare. Plictisitor, dar previzibil.

2. Ce se instalează

Mai jos e lista completă cu tot ce va apărea pe computer.

Claude Code și dictarea vocală

Claude Code CLI - instrumentul principal al cursului, agentul AI despre care e vorba. Se instalează cu programul oficial de instalare al Anthropic de pe claude.ai, mereu în ultima versiune.

Handy - un utilitar de recunoaștere a vorbirii. Vă permite să-i dictați sarcinile agentului cu vocea, în loc să le tastați. Odată cu el se descarcă modelul de recunoaștere Parakeet V3 (aproximativ 456 MB), iar modelul rulează pe computerul dvs., fără internet.

Două plugin-uri pentru Claude Code - superpowers și frontend-design din marketplace-ul oficial al Anthropic.

Medii de dezvoltare

IntelliJ IDEA - mediul principal al cursului. Se instalează împreună cu trei plugin-uri: suportul pentru Python, plugin-ul CodeGym (pentru trimiterea sarcinilor la verificare) și plugin-ul Claude Code (panoul agentului direct în IDE).

Visual Studio Code - al doilea mediu, instalat alături, dacă îl preferați. Cu două plugin-uri din același set: CodeGym (versiune beta) și extensia oficială Claude Code.

Limbaje și utilitare

Node.js 24 - pe el rulează proiectele cursului și verificarea rezultatului.
Python 3.14 - pentru scripturi și o parte din sarcini.
Java 25 (Eclipse Temurin) - baza platformei CodeGym.
Gradle 9.5.1 - build-ul proiectelor Java.
Git - păstrează istoricul proiectului, vă va trebui mai departe în curs. Pe Windows, odată cu el se instalează și Git Bash.

Setări și autentificare

Un fișier cu setările de acces la serverul AI al cursului, configurația plugin-urilor CodeGym și profilul de curs pentru Claude Code: regulile de lucru ale agentului, tehnici ajutătoare și șabloane pentru jocuri și proiecte web. Totul e deja completat pentru dvs. - nu trebuie să introduceți chei și nici să vă autentificați.

Particularitățile fiecărui sistem

Pe macOS, dacă nu aveți instalat Homebrew (managerul de pachete), programul de instalare îl pune și pe el, fiindcă prin el se instalează Git, Python și VS Code.

Pe Linux se adaugă depozitele Node.js, Python și Microsoft (pentru VS Code). Pe Debian, Python 3.14 nu e instalat automat - raportul vă spune asta deschis, iar instalarea va trebui făcută manual.

3. Unde ajunge totul

Programul de instalare nu împrăștie fișiere prin tot sistemul. Totul stă în locuri previzibile - dacă vreți mai târziu să vedeți ce și unde a ajuns, găsiți totul fără să scotociți.

Programele

Sistem	Unde
Windows	`Program Files`, `C:\Gradle`
macOS	`/Applications`, `/opt`
Linux	`/opt`

Trei directoare în folderul personal

.claude-codegym - profilul de curs pentru Claude Code: setări, regulile de lucru ale agentului, tehnici ajutătoare.

.codegym - setările de autentificare pentru plugin-urile CodeGym și două comenzi de pornire (despre ele, mai jos).

.codegym-backups - copii de rezervă ale fișierelor pe care le-a modificat programul de instalare, plus un jurnal al modificărilor. Se păstrează ultimele 10 rulări sau 30 de zile.

Separat de ele, Claude Code propriu-zis se instalează în ~/.local/bin, iar modelul de recunoaștere a vorbirii - în folderul de date al Handy.

Ce se schimbă în setările sistemului

Variabila PATH - ca să puteți rula comenzile cursului din terminal. Pe Windows modificarea se face în registry, pe macOS - în fișierul .zprofile, pe Linux - în /etc/profile.d/codegym.sh și .profile.

Pe macOS și Linux, rândurile noastre sunt încadrate de marcajele # CODEGYM START și # CODEGYM END. Se văd imediat, iar anularea șterge exact aceste rânduri, fără să vă atingă propriile setări.

Registry-ul Windows - trei intrări, nu mai mult: calea către Gradle, calea către comenzile cursului și acceptarea acordului de licență IntelliJ IDEA.

4. Două comenzi: claude și claude-native

E un detaliu important, pe care e bine să-l știți dinainte.

Cursul are propriile setări Claude Code: conexiunea la serverul cursului, regulile de lucru ale agentului, personajele cursului. Nu trebuie amestecate cu setările dvs. personale, așa că le-am separat.

claude - pornește Claude Code cu profilul cursului. Pe aceasta o folosiți la curs.

claude-native - pornește Claude Code-ul dvs. personal, ca și cum noi n-am fi aici. Setările dvs., contul dvs.

Funcționează așa: ambele comenzi sunt scripturi mici din folderul .codegym/bin, care pornesc același Claude Code real, dar îi indică foldere de setări diferite. Eu le țin pe amândouă la îndemână: pe cea de curs - pentru lecții, pe a mea - pentru tot restul.

Programul de instalare nu citește, nu modifică și nu șterge profilul dvs. personal de Claude Code. Dacă îl aveați, rămâne exact cum era.

O observație practică: comenzile apar într-o fereastră de terminal nouă. Dacă imediat după instalare tastați claude într-o fereastră deja deschisă, ea încă nu știe de aceste comenzi - deschideți pur și simplu una nouă.

5. Ce nu facem

Probabil că e secțiunea cea mai importantă. Programul de instalare e scris după principiul "în primul rând, să nu faci rău", iar de aici decurg următoarele.

Nu ștergem și nu suprascriem ce aveți deja instalat. Dacă pe computer există Java, Python, Node sau Git în altă versiune, acestea rămân pe loc. Versiunea pentru curs se instalează alături.

Nu ne atingem de managerele de versiuni. Dacă lucrați cu nvm, pyenv, sdkman sau asdf, le lăsăm în pace, iar în raport vă avertizăm că am pus o versiune alături. Să vă stricăm pyenv-ul e ultimul lucru pe care ni-l dorim.

Nu reinstalăm ce e deja în versiunea potrivită. O rulare repetată nu strică ce e instalat: programul de instalare verifică fiecare instrument și sare peste ce e deja gata.

Nu ne atingem de o IntelliJ IDEA care nu e a noastră. Dacă aveți IDEA din JetBrains Toolbox, o lăsăm în pace - instalăm una separată pentru curs și vă spunem asta.

Nu suprascriem acordurile pe care le-ați dat. Dacă ați acceptat deja licența IDEA sau ați setat colectarea statisticilor, aceste setări rămân ale dvs.

Nu umblăm la pornirea automată, la servicii și la politicile de sistem. Programul de instalare nu se adaugă la pornirea automată, nu creează servicii sau sarcini programate, nu instalează certificate, nu atinge firewall-ul, fișierul hosts sau DNS-ul.

Nu extindem permisiunile agentului AI. Profilul de curs nu ridică niciuna dintre restricțiile Claude Code - agentul lucrează cu setările obișnuite de securitate și cere permisiunea la fel ca întotdeauna.

6. Ce date se colectează

Cheia dvs. personală

La descărcare, în arhivă se scrie o cheie personală de acces, legată de contul dvs. Prin ea, plugin-urile CodeGym și Claude Code se conectează singure la cont, de aceea nici nu trebuie să introduceți chei de mână. În jurnal nu ajunge - o maschează același filtru care maschează și parolele. Tot ea e motivul pentru care arhiva nu trebuie dată altora.

Jurnalul de instalare

În timpul instalării se ține un jurnal detaliat: ce pași s-au executat, ce exista deja pe computer, ce a reușit și ce nu. Acest jurnal rămâne pe discul dvs. Nu pleacă nicăieri.

Dacă ceva nu merge cum trebuie, îl trimiteți chiar dvs., numai dacă așa hotărâți. Pe Windows se află în folderul temporar (%TEMP%\codegym-install.log), pe macOS și Linux - lângă programul de instalare, în fișierul install.log.

Parolele și cheile nu ajung în jurnal: înainte de scriere, fiecare rând trece printr-un filtru care înlocuiește token-urile și parolele cu marcajul [SECRET]. Nici conținutul fișierelor dvs. de configurare nu se scrie acolo - doar numele parametrilor.

Dacă vom introduce vreodată trimiterea automată a rapoartelor de eroare, vă vom anunța dinainte și vă vom lăsa o cale de a o dezactiva.

Jurnalul sesiunilor de curs

Un lucru aparte, despre care trebuie vorbit direct.

Profilul de curs pentru Claude Code e configurat să țină un jurnal de lucru. Când rezolvați o sarcină a cursului, în folderul proiectului se creează fișierul .codegym/cc-transcript.txt, în care se notează mersul lucrului: cererile dvs. către agent, începutul răspunsurilor agentului, ce fișiere a modificat agentul, ce comenzi a rulat.

La ce folosește: pe baza acestui jurnal, platforma verifică rezolvarea sarcinii. E "caietul dvs. de lucru", cu tot mersul rezolvării - din el reiese nu doar rezultatul, ci și cum ați ajuns la el. Sună cam neliniștitor, înțeleg. Numai că fără jurnal platforma vede doar ce a ieșit la final.

Ce e important de înțeles:

jurnalul stă în folderul proiectului dvs., îl puteți deschide și citi;
nu e trimis nicăieri de la sine - fișierele care țin jurnalul nu fac nicio conexiune la internet;
parolele și cheile din el sunt mascate la fel ca în jurnalul de instalare;
se ține doar în profilul de curs. Porniți claude-native și jurnalul nu se mai scrie.

Prin ce server trec cererile către AI

Încă un fapt pe care e mai important să-l spunem deschis decât să-l trecem sub tăcere.

Accesul la AI de care beneficiați în curs e plătit de CodeGym și merge prin serverul nostru, llm.codegym.cc. Asta înseamnă că cererile către model și răspunsurile trec fizic prin infrastructura CodeGym.

Așa funcționează accesul gratuit pentru studenți. Dacă vreți să lucrați direct cu contul dvs. personal, exact pentru asta există comanda claude-native.

7. Cum verificați și cum anulați

Nimeni nu vă obligă să credeți articolul pe cuvânt. Programul de instalare are moduri care vă permit să vedeți dinainte ce se va întâmpla și să anulați ulterior modificările.

Să vedeți, fără să instalați nimic

Flag-ul --dry-run (pe Windows -DryRun) pornește programul de instalare în modul "doar arată". Va afișa lista completă cu tot ce ar face - ce fișiere ar descărca, unde le-ar pune, ce ar adăuga în PATH - și se va încheia fără să instaleze nimic.

O precizare cinstită: nu se poate spune că modul acesta nu atinge absolut nimic. Suprascrie fișierul jurnal al rulării anterioare, creează folderele de lucru și curăță copiile de rezervă învechite. Totuși nu se instalează niciun program, iar setările și PATH-ul rămân neschimbate.

Fără modificări în PATH

Flag-ul --minimal (pe Windows -Minimal) instalează toate programele, dar nu scrie căile în setările sistemului - în schimb, afișează rândurile pe care le adăugați dvs. E un mod pentru cei care și-au configurat mediul după gustul lor (dacă nu știți sigur că vă trebuie, înseamnă că nu vă trebuie).

Pe Windows, modul acesta nu funcționează încă pe deplin: calea către comenzile cursului tot se adaugă în PATH-ul utilizatorului. Modificarea e reversibilă, dar deocamdată flag-ul nu face chiar ce promite. Știm asta și o vom repara.

Anularea modificărilor

Flag-ul --rollback (pe Windows -Rollback) restaurează setările modificate de programul de instalare: PATH, fișierele de profil ale shell-ului, configurațiile, intrările din registry. Fiecare modificare e înregistrată în jurnalul operațiilor, iar rollback-ul merge strict după el.

O protecție în plus: dacă ați editat un fișier după instalare, rollback-ul nu-l atinge, ci vă anunță și vă arată unde se află copia de rezervă.

Ce nu face rollback-ul: nu dezinstalează programele instalate. IntelliJ IDEA, Java, Node și celelalte rămân pe loc. În schimb, programul de instalare afișează lista lor cu comenzi gata făcute pentru dezinstalare - ce eliminați decideți dvs.

Încă un detaliu, spus cinstit: pe Windows, programele de instalare pentru Java, Node și Python își scriu singure căile, ocolind jurnalul nostru de operații. Aceste intrări rollback-ul nu le poate anula.

Pe Windows, programul de instalare afișează singur comanda de rollback gata pregătită la finalul instalării. O rulați așa:

Deschideți PowerShell ca administrator: clic dreapta pe pictograma PowerShell, apoi "Executare ca administrator".
Mergeți în folderul programului de instalare.
Rulați comanda:

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

Să vedeți ce s-a făcut

La final, programul de instalare afișează un raport: lista pașilor, fiecare cu un status - executat, omis, avertisment, eroare sau "faceți manual". Eșecurile nu sunt ascunse: dacă ceva nu s-a instalat, raportul o spune direct și dă motivul.

Tot ce n-a reușit să facă singur e adunat într-un bloc separat, "De terminat manual", cu comenzi concrete.

8. Ce va trebui să faceți de mână

Unele lucruri pur și simplu nu se pot automatiza.

Permisiunile pentru Handy. La prima pornire, sistemul va cere acces la microfon (pe macOS - și la "Accesibilitate"). Fără asta, dictarea vocală nu va funcționa. Permisiunea o poate acorda doar un om - niciun program nu o poate face în locul dvs.

Posibile ferestre IntelliJ IDEA la prima pornire. Programul de instalare acceptă licența dinainte, dar dacă fereastra licenței apare totuși, acceptați-o.

9. Întrebări frecvente

Cât durează instalarea?

20-40 de minute, se descarcă aproximativ un gigabyte. Cel mai mult timp se duce pe IntelliJ IDEA și pe modelul de recunoaștere a vorbirii.

De ce sunt necesare drepturile de administrator?

Programele se instalează în foldere de sistem (Program Files, /opt, /Applications), iar acolo nu se poate scrie fără drepturi de administrator. Setările și profilul, în schimb, ajung în folderul dvs. de utilizator și rămân ale dvs.

Pot rula programul de instalare de două ori?

Da, nu se strică nimic. Ce e deja instalat va fi omis. Există și o protecție împotriva unei rulări duble accidentale: a doua instanță vede că instalarea e deja în curs și pur și simplu se închide.

Ce se întâmplă cu setările mele Claude Code?

Nimic. Profilul de curs stă într-un folder separat, iar cel personal nu e nici citit, nici modificat. Pentru lucrul personal există comanda claude-native.

Sistemul afișează un avertisment la pornire. E normal?

Da. Așa reacționează sistemele de operare la orice program descărcat de pe internet, iar programul nostru de instalare nu are încă un certificat de semnare a codului. Pe Windows, apăsați pe linkul cu mai multe informații, apoi pe butonul care permite rularea oricum. Pe macOS, dacă sistemul spune că dezvoltatorul nu poate fi verificat, dați clic dreapta pe fișier, alegeți "Deschide", apoi confirmați încă o dată.

Programul de instalare scoate de pe fișiere marcajul "descărcat de pe internet". De ce?

Altfel sistemul blochează rularea fișierelor incluse, iar instalarea se întrerupe la jumătate. Pe Windows, asta se face pentru folderul dezarhivat, pe macOS - prin eliminarea carantinei Gatekeeper pentru același folder. Programul de instalare scoate marcajul doar de pe propriile fișiere și nu se atinge de celelalte fișiere ale dvs.

De ce nu trebuie să dați arhiva altora?

Înăuntru sunt datele dvs. personale de autentificare. Cine primește arhiva poate lucra din contul dvs. Linkul de descărcare îl puteți da mai departe - fiecare primește propria arhivă.

Ceva n-a mers bine. Ce fac?

Verificați raportul de la final și fișierul install.log - acolo se vede la ce pas și de ce. Dacă nu e clar, trimiteți fișierul echipei de suport. E calea obișnuită, nu o măsură extremă.

10. Dacă nu vreți să instalați totul deodată

Programul de instalare nu e un pas obligatoriu al cursului, ci o cale de a economisi timp. Tot ce face el e explicat pas cu pas în lecții: Claude Code se instalează cu o singură comandă, iar pentru setări e de ajuns să copiați un singur fișier.

Celelalte instrumente se adaugă pe măsură ce devin necesare - până atunci veți înțelege la ce vă folosesc. Așa le și rețineți mai bine decât dintr-o listă de zece rânduri.