Pluginul CodeGym în IntelliJ IDEA pentru cursul Claude Code

1. Un singur curs, două locuri de lucru

În browser e comod să începeți: deschideți pagina, citiți lecția, rezolvați prima sarcină. Agentul e și acolo - Claude Code e integrat direct în panoul din browser, așa că puteți lucra la sarcini împreună cu el din prima zi. Limitările sunt două: totul rămâne în browser, iar pentru fiecare sarcină se creează un proiect separat.

IDEA e un instrument profesional în care aveți totul la îndemână deodată: codul, enunțul, terminalul și agentul într-o singură fereastră, iar proiectul stă pe discul dumneavoastră. La început poate părea că folosiți o unealtă mult prea mare pentru o treabă mică. După câteva sarcini veți constata că fără IDE e deja incomod. Eu m-aș muta imediat: e mai ieftin să vă obișnuiți cu un instrument de lucru adevărat cât timp sarcinile sunt simple.

Dacă nu ați folosit programul de instalare: instalați pluginurile manual

Programul de instalare de la nivelul 1 a adăugat deja pluginurile CodeGym și Claude Code și a configurat autentificarea în cont. Dacă l-ați rulat, puteți sări peste această secțiune. Nu mai știți dacă l-ați rulat sau nu? Deschideți lista de pluginuri: dacă CodeGym și Claude Code sunt deja acolo, totul e în regulă, mergeți mai departe.

1. Instalați pluginul CodeGym. În Windows și Linux deschideți File → Settings → Plugins, în macOS - IntelliJ IDEA → Preferences → Plugins. În fila Marketplace tastați în căutare CodeGym și apăsați Install. Nu reporniți încă IDEA: instalați mai întâi al doilea plugin.
2. Instalați pluginul oficial Claude Code. Fără să închideți Marketplace, tastați în căutare Claude Code, alegeți Claude Code [Beta] și apăsați Install. După ce ambele pluginuri sunt instalate, reporniți IDEA.
3. După instalare, apăsați Sign in din bara de sus a pluginului. Pe site-ul CodeGym deschideți secțiunea Setări → Securitate și autentificare, copiați cheia secretă și lipiți-o în fereastra de autentificare din IDEA.

După autentificare, pluginul CodeGym descarcă proiectul cursului și puteți deschide sarcinile direct în IDEA.

2. Unde se află lista de sarcini

În bara verticală din partea stângă a ferestrei IDEA, apăsați Tasks. Se deschide lista sarcinilor disponibile.

Găsiți cardul sarcinii de care aveți nevoie și apăsați pe el. În fereastra care apare, alegeți Open.

În plugin sunt disponibile toate sarcinile de pe site. Dacă ați rezolvat deja o sarcină pe site, iar soluția a trecut cu succes verificarea, codul dumneavoastră se încarcă în proiectul din IDEA.

La început, fereastra sarcinii pare supraîncărcată. Ca să porniți, aveți nevoie de exact două lucruri:

• Condition - enunțul sarcinii: ce trebuie făcut și ce cerințe trebuie îndeplinite;
• arborele proiectului din stânga - fișierele sarcinii cu care lucrați. Pot fi de tipuri diferite și pot avea nume diferite: de exemplu, index.html, Main.java sau altceva - căutați-l pe cel cerut în enunț, nu un nume cu care sunteți obișnuit.

Logica e simplă: citiți mai întâi Condition, apoi găsiți fișierul potrivit în arborele proiectului și treceți la rezolvarea sarcinii.

3. Agentul vede fișierele, dar nu vede enunțul

Când deschideți o sarcină, pluginul îi descarcă fișierele pe disc. Claude Code lucrează cu fișiere, așa că vede arborele de foldere, codul și restul fișierelor sarcinii - cu condiția să fie pornit în folderul potrivit (despre asta e secțiunea următoare).

Însă enunțul și cerințele se află în panoul Condition. Agentul nu vede automat acest panou. A înțelege ce cere sarcina și a identifica cerințele face parte din învățarea dumneavoastră, iar prin acest pas e important să treceți singur.

Tentația e de înțeles: să copiați enunțul în chat și să lăsați agentul să descifreze singur ce se cere de la dumneavoastră. Nu copiați enunțul întreg. Ați sări peste cea mai importantă etapă - citirea enunțului, găsirea esențialului și înțelegerea cerințelor.

Citiți mai întâi enunțul în întregime și lămuriți-vă ce se cere. Abia după aceea puteți copia în chatul cu agentul doar fragmentele importante. Și mai bine, descrieți scopul și cerințele cu propriile cuvinte. Așa veți înțelege cu adevărat sarcina, iar Claude Code va rămâne un ajutor, nu un înlocuitor al învățării.

4. Fiecare sarcină e un proiect separat

Mai întâi lucrul principal, ca să citiți mai departe liniștit: nu va trebui să urmăriți folderele de unul singur. Agentul observă când lucrează la altă sarcină decât trebuie, vă spune asta și vă propune să treacă în folderul potrivit - iar dacă îi permiteți, trece singur.

Mai jos e varianta manuală: cum faceți același lucru cu instrumentele din IDEA. Vă e de folos ca să înțelegeți ce se întâmplă de fapt și să nu depindeți de sugestia agentului.

Acum faptul cel mai important despre cum e organizat cursul. Fiecare sarcină de aici e un proiect separat. Nu un fișier dintr-un proiect comun, ci un proiect de sine stătător: folderul lui, fișierele lui, regulile lui pentru agent în .claude. Câte sarcini are cursul, atâtea proiecte există.

Pluginul le pune pe toate într-un singur arbore, codegym-project, ca să nu fie nevoie să deschideți câte o fereastră separată pentru fiecare sarcină. Arată cam așa:

codegym-project/
└── src/ro/codegym/claude/course/level01/     # nivelul cursului
    ├── task05/                # sarcină = proiect separat
    │   ├── .claude/           # regulile agentului pentru această sarcină
    │   └── arkanoid.html      # fișierul sarcinii
    └── task09/                # altă sarcină = alt proiect
        ├── .claude/           # cu regulile ei proprii
        ├── arkanoid.html      # fișierele sarcinii, pot fi mai multe
        ├── clicker.html
        └── tictactoe.html

De ce contează. De obicei, arborele proiectului chiar e un singur proiect: fișierele din el sunt legate între ele, iar agentului îi e util să le vadă pe toate. Îl porniți în rădăcină, el citește regulile proiectului, vede fișierele vecine - și toate acestea lucrează în favoarea dumneavoastră.

Aici obișnuința vă joacă feste. Arborele e unul, dar conține atâtea proiecte câte sarcini sunt, iar între ele nu există nicio legătură: task09 nu știe nimic despre task05, iar fiecare sarcină are propriile reguli în .claude. Pentru agent, rădăcina proiectului nu e "proiectul dumneavoastră", ci un depozit de proiecte care n-au nimic în comun. În sarcinile vecine nu există context util, iar regulile sarcinii de care aveți nevoie agentul le va prelua de acolo doar parțial și nu imediat: instrucțiunile și skill-urile sarcinii se încarcă abia când deschide fișierele ei, iar setările ei nu se încarcă deloc.

De aici o consecință pe care merită s-o înțelegeți imediat: agentul vede ce se află acolo unde l-ați pornit. Dacă tastați claude în rădăcina proiectului, în câmpul lui vizual intră tot cursul: sarcini străine, cod străin, reguli străine. Agentul va căuta fișierul necesar printre sute de fișiere care nu au legătură cu sarcina, iar în cel mai rău caz va modifica un fișier dintr-o sarcină vecină.

Așa că regula e simplă: porniți agentul în folderul sarcinii pe care o rezolvați.

Cum porniți agentul în folderul sarcinii

1. Găsiți folderul sarcinii în arborele proiectului din stânga.
2. Faceți clic dreapta pe el și alegeți Open In - Terminal. Se deschide o filă de terminal care se află deja în acest folder.
3. Tastați claude.

Pare un pas în plus. În realitate e un singur clic dreapta și îl faceți o singură dată pentru fiecare sarcină.

În spatele acestui clic nu e nicio magie: IDEA pur și simplu tastează în locul dumneavoastră comanda cd până la folderul ales. Același lucru îl puteți face manual într-un terminal deja deschis:

cd src/ro/codegym/claude/course/level01/task09
claude

O capcană: în arborele proiectului, IDEA afișează pachetul pe un singur rând, cu puncte (ro.codegym.claude.course.level01), dar pe disc acestea sunt foldere imbricate. N-are rost să tastați calea așa cum o vedeți pe ecran, pe disc ea arată altfel. E mai simplu s-o copiați: clic dreapta pe folderul sarcinii - Copy Path/Reference.

Această comasare are o continuare, iar aceasta nu mai e inofensivă. IDEA strânge pe un singur rând orice lanț de foldere în care înăuntru se află doar un alt folder și nimic altceva. Într-o sarcină în care deocamdată nu există nimic în afară de .claude, și acest folder ajunge pe același rând. Arată ca folderul sarcinii, dar clicul dreapta pe el se aplică celui mai adânc folder din lanț.

Cel mai sigur e să dezactivați complet comasarea. Deasupra arborelui proiectului apăsați butonul cu trei puncte, deschideți Appearance și debifați Compact Middle Packages. După asta fiecare folder stă pe propriul rând în arbore, iar clicul dreapta nimerește acolo unde ați țintit.

Dacă terminalul e deja deschis și calea din el se termină cu .claude, urcați un nivel cu cd .. și abia apoi porniți agentul.

Ați trecut la sarcina următoare

Folderul de lucru se stabilește la pornire și nu vă urmează singur. Dar nici nu trebuie să faceți ceva complicat: agentul va observa că sarcina s-a schimbat și vă va propune să treacă în folderul ei.

Preferați să o faceți singur? Mergeți în folderul noii sarcini și porniți claude acolo, cu același clic dreapta sau cu comanda cd. Puteți și să deschideți o filă de terminal separată pentru noua sarcină, ca să le aveți pe amândouă la îndemână.

Agentul vă spune singur unde se află

Nu e nevoie să urmăriți asta manual. În linia de stare de sub chat, profilul de curs pentru Claude Code arată la ce sarcină lucrează: JR · claude.course · task02.

Iar dacă în IDE aveți deschisă altă sarcină, tot acolo apare un avertisment galben care spune că în IDE e deschis task01. Înseamnă că dumneavoastră vă uitați la un fișier, iar agentul lucrează în alt folder. Dacă vedeți așa ceva, opriți-vă și lămuriți ce anume nu se mai potrivește: fie agentul e pornit în alt folder decât trebuie, fie ați deschis un fișier din altă sarcină.

Jurnalul sesiunilor de studiu

Mai există un motiv să porniți agentul chiar în folderul sarcinii, iar despre el trebuie să vorbim deschis.

În profilul de curs pentru Claude Code e configurată ținerea unui jurnal de lucru. Cât timp rezolvați sarcina, în folderul ei apare .codegym, unde se înregistrează desfășurarea lucrului: cererile dumneavoastră către agent, începutul răspunsurilor lui, ce fișiere a modificat, ce comenzi a rulat.

Așa arată folderul unei sarcini după ce ați lucrat în el:

task09/
├── .claude/                  # regulile agentului pentru această sarcină
├── .codegym/
│   ├── cc-transcript.txt     # jurnalul de lucru, text simplu
│   └── cc-transcript.json
├── arkanoid.html             # fișierele sarcinii propriu-zise
├── clicker.html
└── tictactoe.html

De ce e nevoie de el: pe baza acestui jurnal platforma verifică soluția sarcinii. E "caietul dumneavoastră cu rezolvarea" - din el se vede nu doar rezultatul, ci și cum ați ajuns la el. Sună neliniștitor, înțeleg. Numai că fără jurnal platforma vede doar ce a ieșit la final.

Jurnalul rămâne pe discul dumneavoastră, lângă sarcină: puteți deschide fișierul și îl puteți citi. Și apare acolo de unde a fost pornit agentul. Dacă l-ați pornit din rădăcina proiectului, acolo va ajunge și jurnalul, iar în folderul sarcinii nu va exista. Încă un motiv să nu săriți peste cd.

5. Cum trimiteți soluția la verificare

Când soluția e gata, apăsați butonul Verify din fereastra sarcinii. Pluginul trimite versiunea curentă a soluției pe serverul CodeGym.

După verificare, rezultatul apare tot acolo, în interfața sarcinii. Mai departe sunt două variante:

• soluție acceptată - cerințele sunt îndeplinite, sarcina e considerată rezolvată;
• soluție neacceptată - pluginul afișează mesajul verificării, după care vă puteți întoarce la enunț și puteți corecta soluția.

O încercare neacceptată nu înseamnă că proiectul e stricat. E un feedback obișnuit. Citiți mesajul, deschideți din nou Condition, comparați-l cu soluția și corectați un singur punct clar. Unul, nu toate deodată: așa se vede ce anume a ajutat.

Puteți trimite soluția de câte ori vreți. Pentru asta e verificarea: ați făcut o încercare, ați primit rezultatul, ați corectat, ați trimis din nou.

6. Setări ale pluginului pe care merită să le cunoașteți

Sincronizarea sarcinilor: site-ul și pluginul

Pluginul afișează sarcinile cursului activ - cel pe care l-ați ales pe site. Acolo puteți avea mai multe cursuri, dar activ e întotdeauna unul singur.

Lista de sarcini și stările lor se actualizează singure: cam o dată la cinci minute și după fiecare trimitere reușită la verificare. O sarcină rezolvată pe site apare în plugin deja rezolvată.

Ca să actualizați chiar acum, apăsați pe avatarul din dreapta sus și alegeți Sync tasks. După schimbarea cursului activ, acest pas e obligatoriu: până nu sincronizați sau nu reporniți IDEA, pluginul va afișa sarcinile cursului anterior.

Cum ascundeți bara de navigare a pluginului

Sună ciudat, dar ordinea e asta: mai întâi bara trebuie afișată. Ea apare doar când e dezactivat Beginner Mode - modul simplificat al pluginului, în care o parte din funcții sunt ascunse. Iar bifa care ascunde bara se află chiar pe bară, sub rotița dințată.

1. Apăsați pe avatarul din dreapta sus și alegeți Settings - Beginner Mode ca să-l dezactivați.
2. În partea de sus a pluginului apare bara de navigare. Pe această bară, apăsați Settings (⚙️) și debifați "Show plugin navigation bar".

Eu o ascund imediat: spațiul de pe ecran valorează mai mult decât câteva butoane.