Claude Code kursu için IntelliJ IDEA'da CodeGym eklentisi

1. Tek kurs, iki ortam

Başlamak için tarayıcı rahattır: sayfayı açarsınız, dersi okursunuz, ilk görevi yaparsınız. Ajan orada da var - Claude Code doğrudan tarayıcı paneline bağlı, yani görevleri ilk günden onunla birlikte çözebilirsiniz. İki kısıtlama var: her şey tarayıcıda kalıyor ve her görev için ayrı bir proje açılıyor.

IDEA ise her şeyin aynı anda elinizin altında olduğu profesyonel bir araç: kod, görev tanımı, terminal ve ajan tek pencerede, proje de sizin diskinizde duruyor. İlk başta basit işler için fazla ağır bir araç kullanıyormuşsunuz gibi gelebilir. Birkaç görev sonra IDE olmadan çalışmanın artık zahmetli geldiğini fark edeceksiniz. Ben olsam hemen IDEA'ya geçerdim: görevler henüz basitken gerçek bir çalışma aracına alışmak daha kolay olur.

Yükleyiciyi kullanmadıysanız: eklentileri elle kurun

1. seviyedeki yükleyici CodeGym ve Claude Code eklentilerini zaten ekledi ve hesabınıza girişi de ayarladı. Yükleyiciyi çalıştırdıysanız bu bölümü atlayabilirsiniz. Çalıştırıp çalıştırmadığınızı hatırlamıyor musunuz? Eklenti listesini açın: CodeGym ve Claude Code zaten oradaysa her şey yolunda, okumaya devam edin.

1. CodeGym eklentisini kurun. Windows ve Linux'ta File → Settings → Plugins, macOS'ta IntelliJ IDEA → Preferences → Plugins yolunu açın. Marketplace sekmesinde arama kutusuna CodeGym yazın ve Install düğmesine tıklayın. IDEA'yı henüz yeniden başlatmayın: önce ikinci eklentiyi kurun.
2. Resmi Claude Code eklentisini kurun. Marketplace sekmesini kapatmadan arama kutusuna Claude Code yazın, Claude Code [Beta] öğesini seçin ve Install düğmesine tıklayın. İki eklenti de kurulduğunda IDEA'yı yeniden başlatın.
3. Kurulumdan sonra eklentinin üst çubuğundaki Giriş yap düğmesine tıklayın. CodeGym sitesinde Ayarlar → Güvenlik ve giriş bölümünü açın, gizli anahtarı kopyalayın ve IDEA'daki giriş penceresine yapıştırın.

Giriş yaptıktan sonra CodeGym eklentisi kurs projesini indirir ve görevleri doğrudan IDEA'da açabilirsiniz.

2. Görev listesi nerede

IDEA'nın soldaki dikey panelinde Tasks düğmesine tıklayın. Mevcut görevlerin listesi açılır.

İhtiyacınız olan görev kartını bulun ve üzerine tıklayın. Açılan pencerede Aç seçeneğini seçin.

Sitedeki tüm görevler eklentide de mevcut. Bir görevi sitede zaten çözdüyseniz ve görev kontrolden başarıyla geçtiyse, kodunuz IDEA'daki projeye yüklenir.

Görev penceresi ilk başta kalabalık görünür. Başlangıçta size tam olarak iki şey lazım:

• Condition - görev tanımı: ne yapmanız ve hangi gereksinimleri karşılamanız gerektiği;
• soldaki proje ağacı - üzerinde çalıştığınız görev dosyaları. Bu dosyalar farklı türlerde olabilir ve farklı adlar taşıyabilir: örneğin index.html, Main.java ya da başka bir ad - alışık olduğunuz adı değil, görev tanımının istediği dosyayı arayın.

Mantık basit: önce Condition bölümünü okuyun, sonra proje ağacında doğru dosyayı bulun ve görevi çözmeye koyulun.

3. Ajan dosyaları görür, görev tanımını görmez

Bir görevi açtığınızda eklenti onun dosyalarını diske indirir. Claude Code dosyalarla çalışır, bu yüzden klasör ağacını, kodu ve görevin diğer dosyalarını görür - doğru klasörde başlatılmış olması şartıyla (bunu bir sonraki bölümde ele alıyoruz).

Ama görev tanımı ve gereksinimler Condition panelinde durur. Ajan bu paneli kendiliğinden görmez. Görevin ne anlattığını kavramak ve gereksinimleri ayıklamak öğrenmenizin bir parçası ve bu adımı kendi başınıza atmanız önemli.

Bunun cazip gelmesi anlaşılır: görev tanımını sohbete yapıştır, sizden ne istendiğini ajan kendisi çözsün. Görev tanımını olduğu gibi kopyalamayın. En önemli aşamayı atlamış olursunuz: tanımı okumak, asıl meseleyi bulmak ve gereksinimleri anlamak.

Önce görev tanımını baştan sona okuyun ve anlayın. Ondan sonra ajanla sohbete yalnızca önemli parçaları kopyalayabilirsiniz. Daha da iyisi, amacı ve gereksinimleri kendi cümlelerinizle anlatın. Böylece görevi gerçekten kavrarsınız, Claude Code da öğrenmenin yerine geçen bir şey değil, bir yardımcı olarak kalır.

4. Her görev ayrı bir proje

Önce en önemlisi, geri kalanını rahat okuyabilmeniz için: klasörleri tek başınıza takip etmek zorunda kalmayacaksınız. Ajan yanlış görev üzerinde çalıştığını fark eder, bunu size söyler ve doğru klasöre geçmeyi önerir - izin verirseniz kendisi geçer.

Aşağıda elle yapma yolu var: aynı şeyi IDEA'nın kendi araçlarıyla nasıl yapacağınız. Bu yol, aslında neler olup bittiğini anlamak ve ipucuna bağımlı kalmamak için gerekli.

Şimdi kursun yapısıyla ilgili en önemli nokta. Buradaki her görev ayrı bir projedir. Ortak bir projenin içindeki bir dosya değil, bağımsız bir proje: kendi klasörü, kendi dosyaları, .claude içinde ajan için kendi kuralları. Kursta kaç görev varsa o kadar proje var.

Eklenti, her görev için ayrı bir pencere açmanız gerekmesin diye hepsini tek bir codegym-project ağacına yerleştirir. Aşağı yukarı şöyle görünür:

codegym-project/
└── src/tr/codegym/claude/course/level01/     # kurs seviyesi
    ├── task05/                # görev = ayrı bir proje
    │   ├── .claude/           # bu görev için ajan kuralları
    │   └── arkanoid.html      # görev dosyası
    └── task09/                # başka görev = başka proje
        ├── .claude/           # onun kendi kuralları var
        ├── arkanoid.html      # görev dosyaları, birden fazla olabilir
        ├── clicker.html
        └── tictactoe.html

Bu neden önemli. Normalde proje ağacı tek bir projedir: içindeki dosyalar birbiriyle bağlantılıdır ve ajanın hepsini birlikte görmesi faydalıdır. Ajanı kökte başlatırsınız, proje kurallarını okur, komşu dosyaları görür - ve bunların hepsi sizin işinize yarar.

Burada bu alışkanlık sizi yanıltır. Ağaç bir tane, ama içinde görev sayısı kadar proje var ve bunların birbiriyle hiçbir bağlantısı yok: task09, task05 hakkında hiçbir şey bilmez ve her görevin kendi .claude kuralları vardır. Ajan için proje kökü "sizin projeniz" değil, birbirine yabancı projelerin durduğu bir depo. Komşu görevlerde işe yarar bir bağlam yok, ihtiyacınız olan görevin kurallarını da ajan oradan ancak kısmen ve gecikmeli alır: görevin talimatları ve skills ancak ajan o görevin dosyalarını açtığında yüklenir, görevin ayarları ise hiç yüklenmez.

Buradan hemen kavranması gereken bir sonuç çıkıyor: ajan, nereden başlatıldıysa orayı görür. claude komutunu proje kökünde yazarsanız bütün kurs görüş alanına girer: başka görevler, başka kod, başka kurallar. Ajan ihtiyaç duyduğu dosyayı yüzlerce alakasız dosya arasında arar, en kötü durumda da komşu bir görevin dosyasını düzenler.

Bu yüzden kural basit: ajanı, çözdüğünüz görevin klasöründe başlatın.

Ajan görev klasöründe nasıl başlatılır

1. Soldaki proje ağacında görevin klasörünü bulun.
2. Klasöre sağ tıklayın ve Open In - Terminal seçeneğini seçin. Doğrudan bu klasörde başlayan bir terminal sekmesi açılır.
3. claude yazın.

Fazladan bir adım gibi geliyor. Aslında tek bir sağ tık ve her görev için bir kez yapılıyor.

Bu tıklamanın arkasında sihir yok: IDEA seçilen klasöre giden cd komutunu sizin yerinize yazar. Aynısını zaten açık olan bir terminalde elle de yapabilirsiniz:

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

Bir tuzak var: IDEA proje ağacında paketi noktalarla ayrılmış tek bir satır olarak gösterir - tr.codegym.claude.course.level01 - oysa diskte bunlar iç içe klasörlerdir. Bu yolu ekrandan bakarak yazmanın anlamı yok, diskte öyle görünmüyor. Kopyalamak daha kolay: görev klasörüne sağ tık - Copy Path/Reference.

Bu birleştirmenin bir devamı var ve o artık zararsız değil. IDEA, içinde yalnızca bir klasör olan ve başka hiçbir şey bulunmayan her klasör zincirini tek satırda toplar. Şimdilik içinde .claude dışında hiçbir şey olmayan bir görevde bu klasör de aynı satıra girer. Görev klasörü gibi görünür, ama sağ tık zincirin en derindeki klasörüne uygulanır.

En güvenlisi birleştirmeyi tamamen kapatmaktır. Proje ağacının üstündeki üç nokta düğmesine tıklayın, Appearance menüsünü açın ve Compact Middle Packages işaretini kaldırın. Bundan sonra ağaçta her klasör ayrı bir satırda durur ve sağ tık tam hedeflediğiniz yere gelir.

Terminal zaten açıksa ve içindeki yol .claude ile bitiyorsa, cd .. komutuyla bir üst seviyeye çıkın ve ajanı ancak ondan sonra başlatın.

Sonraki göreve geçtiniz

Çalışma klasörü başlatma sırasında belirlenir ve sizinle birlikte kendiliğinden taşınmaz. Ama karmaşık bir şey yapmanız da gerekmiyor: ajan görevin değiştiğini fark eder ve yeni görevin klasörüne geçmeyi önerir.

Kendiniz yapmak isterseniz yeni görevin klasörüne geçin ve claude komutunu orada çalıştırın: aynı sağ tıkla ya da cd komutuyla. Yeni görev için ayrı bir terminal sekmesi de açabilirsiniz, o zaman ikisi de elinizin altında olur.

Ajan nerede olduğunu kendisi söyler

Bunu elle takip etmeniz gerekmiyor. Sohbetin altındaki durum satırında Claude Code'un kurs profili hangi görev üzerinde çalıştığını yazar: JR · claude.course · task02.

IDE'de başka bir görev açıksa aynı yerde sarı bir uyarı çıkar: IDE'de task01 açık. Bu, sizin bir dosyaya baktığınız, ajanın ise başka bir klasörde çalıştığı anlamına gelir. Böyle bir şey görürseniz durun ve tam olarak neyin uyuşmadığını bulun: ya ajan yanlış klasörde başlatıldı ya da siz yanlış görevin dosyasını açtınız.

Çalışma oturumlarının günlüğü

Ajanı tam da görev klasöründe başlatmak için bir neden daha var ve bunu açıkça söylemek gerekiyor.

Claude Code'un kurs profili bir çalışma günlüğü tutacak şekilde ayarlanmıştır. Siz görevi çözerken görevin klasöründe .codegym klasörü oluşur ve çalışmanın nasıl ilerlediği oraya kaydedilir: ajana yazdığınız istekler, ajanın cevaplarının başlangıç kısmı, hangi dosyaları değiştirdiği, hangi komutları çalıştırdığı.

Üzerinde çalıştığınız bir görevin klasörü şöyle görünür:

task09/
├── .claude/                  # bu görev için ajan kuralları
├── .codegym/
│   ├── cc-transcript.txt     # çalışma günlüğü, düz metin
│   └── cc-transcript.json
├── arkanoid.html             # görevin kendi dosyaları
├── clicker.html
└── tictactoe.html

Bu ne işe yarar: platform görevin çözümünü bu günlüğe bakarak kontrol eder. Bu sizin "çözüm defteriniz" - ondan yalnızca sonuç değil, sonuca nasıl ulaştığınız da görülür. Kulağa biraz tedirgin edici geliyor, biliyorum. Ama günlük olmadan platform yalnızca sonunda ortaya çıkanı görür.

Günlük sizin diskinizde, görevin yanında kalır: dosyayı açıp okuyabilirsiniz. Ayrıca günlük, ajan nereden başlatıldıysa orada oluşur. Proje kökünden başlattıysanız günlük kökte olur, görev klasöründe olmaz. cd adımını atlamamak için bir neden daha.

5. Çözüm kontrole nasıl gönderilir

Çözümünüz hazır olduğunda görev penceresindeki Kontrol et düğmesine tıklayın. Eklenti çözümün güncel sürümünü CodeGym sunucusuna gönderir.

Kontrolden sonra sonuç aynı yerde, görev arayüzünde görünür. Bundan sonra iki ihtimal var:

• çözüm kabul edildi - gereksinimler karşılandı, görev tamamlanmış sayılır;
• çözüm kabul edilmedi - eklenti kontrol mesajını gösterir, ardından görev tanımına dönüp çözümü düzeltebilirsiniz.

Kabul edilmeyen bir deneme, projenin bozulduğu anlamına gelmez. Bu olağan bir geri bildirim. Mesajı okuyun, Condition bölümünü yeniden açın, çözümünüzle karşılaştırın ve anlaşılır tek bir maddeyi düzeltin. Hepsini birden değil, tek birini: böylece neyin işe yaradığını görürsünüz.

Çözümü istediğiniz kadar gönderebilirsiniz. Kontrol zaten bunun için var: bir deneme yaparsınız, sonucu alırsınız, düzeltirsiniz, yeniden gönderirsiniz.

6. Eklentinin bilmeye değer ayarları

Görev senkronizasyonu: site ve eklenti

Eklenti aktif kursun görevlerini gösterir, yani sitede sizin seçtiğiniz kursun. Orada birden fazla kursunuz olabilir, ama aktif olan her zaman tektir.

Görev listesi ve görevlerin durumları kendiliğinden güncellenir: yaklaşık beş dakikada bir ve her başarılı gönderimden sonra. Sitede çözdüğünüz bir görev eklentide zaten çözülmüş olarak görünür.

Hemen şimdi güncellemek için sağ üstteki avatarınıza tıklayın ve Görevleri senkronize et seçeneğini seçin. Aktif kursu değiştirdikten sonra bu adım şart: senkronize etmeden ya da IDEA'yı yeniden başlatmadan eklenti önceki kursun görevlerini göstermeye devam eder.

Eklentinin gezinme çubuğu nasıl kaldırılır

Tuhaf gelebilir ama sıra şöyle: önce çubuğu görünür hale getirmeniz gerekiyor. Çubuk yalnızca Beginner Mode kapalıyken görünür. Bu, eklentinin bazı özelliklerinin gizlendiği sadeleştirilmiş görünümüdür. Çubuğu kaldıran onay kutusu ise çubuğun kendisinde, dişli simgesinin altında durur.

1. Sağ üstteki avatarınıza tıklayın ve kapatmak için Ayarlar - Beginner Mode seçeneğini seçin.
2. Eklentinin üst kısmında bir gezinme çubuğu belirir. Çubuktaki Ayarlar (⚙️) simgesine tıklayın ve "Eklentinin gezinme çubuğunu göster" onay kutusunun işaretini kaldırın.

Ben kendi adıma onu hemen kaldırırım: ekrandaki yer birkaç düğmeden daha değerli.