CodeGym yükleyicisi: bilgisayarınızda ne yapıyor

CodeGym yükleyicisi yönetici hakları istiyor ve bilgisayarınıza on kadar program kuruyor. Bu anda tedirgin olmanız normal, hatta doğru bir refleks. Makinesine özen gösteren herkesin şunu sormaya hakkı var: bu program onunla tam olarak ne yapmaya niyetli?

Bu makale o soruyu eksiksiz ve süslemeden cevaplıyor. Neler kuruluyor, nereye yerleşiyor, nelere dokunmuyoruz, hangi veriler toplanıyor ve bunların hepsi nasıl geri alınır.

Yükleyiciyi kullanmak istemiyorsanız kullanmayın. Kursu onsuz da tamamlayabilirsiniz: derslerde gereken her şeyin elle, adım adım nasıl kurulacağı anlatılıyor. Yükleyici sizi sadece rutin işten kurtarıyor.

1. Neden gerekli

Kurs epeyce araç gerektiriyor: Claude Code'un kendisi, bir IDE, diller, derleme araçları. Her biri kendine göre kuruluyor, her birinin kendi ayarları var, bir kısmının da birbirine bağlanması ve hesaba giriş yapması gerekiyor.

Bunların hepsini elle yapmak mümkün, ama bu birkaç saatlik bir iş. Hata yapmak kolay, sonra da bir şeyin neden çalışmadığını uzun uzun aramanız gerekebilir. Yükleyici aynı işi tek çalıştırmada yapıyor. Sıkıcı ama öngörülebilir.

2. Neler kuruluyor

Aşağıda bilgisayarınızda nelerin olacağının tam listesi var.

Claude Code ve sesli giriş

Claude Code CLI - kursun ana aracı, yani yapay zekâ ajanının ta kendisi. Anthropic'in claude.ai sitesindeki resmi yükleyicisiyle kuruluyor, her zaman en son sürüm.

Handy - konuşma tanıma aracı. Görevleri ajana yazmak yerine sesle dikte etmeniz için gerekli. Onunla birlikte Parakeet V3 tanıma modeli de indiriliyor (yaklaşık 456 MB). Model sizin bilgisayarınızda, internetsiz çalışıyor.

Claude Code için iki eklenti - Anthropic'in resmi eklenti pazarından (marketplace) superpowers ve frontend-design.

Geliştirme ortamları

IntelliJ IDEA - kursun ana IDE'si. Üç eklentiyle birlikte geliyor: Python desteği, CodeGym eklentisi (görevleri kontrole göndermek için) ve Claude Code eklentisi (doğrudan IDE içinde bir ajan paneli).

Visual Studio Code - ikinci IDE, dilerseniz onu tercih edebilmeniz için IDEA'nın yanına kuruluyor. Aynı setten iki eklentiyle: CodeGym (beta sürümü) ve resmi Claude Code uzantısı.

Diller ve araçlar

Node.js 24 - kursun projeleri ve sonuç kontrolü bunun üzerinde çalışıyor.
Python 3.14 - betikler ve görevlerin bir kısmı için.
Java 25 (Eclipse Temurin) - CodeGym platformunun temeli.
Gradle 9.5.1 - Java projelerini derlemek için.
Git - projenin geçmişini saklar, kursun ilerleyen bölümlerinde lazım olacak. Windows'ta onunla birlikte Git Bash da kuruluyor.

Ayarlar ve giriş

Kursun yapay zekâ sunucusuna erişim ayarlarını içeren bir dosya, CodeGym eklentilerinin yapılandırması ve Claude Code için bir kurs profili: ajanın çalışma kuralları, yardımcı çalışma teknikleri, oyunlar ve web projeleri için hazır şablonlar. Hepsi sizin için önceden doldurulmuş, anahtar girmeniz ya da giriş yapmanız gerekmiyor.

Sistemler arasındaki farklar

macOS'ta Homebrew (paket yöneticisi) kurulu değilse yükleyici onu da kuruyor, çünkü Git, Python ve VS Code onun üzerinden kuruluyor.

Linux'ta Node.js, Python ve Microsoft (VS Code için) depoları ekleniyor. Debian'da Python 3.14 kurulmuyor. Yükleyici bunu raporda açıkça söylüyor, Python'u elle kurmanız gerekecek.

3. Her şey nereye yerleşiyor

Yükleyici dosyaları sisteme gelişigüzel dağıtmıyor. Her şey öngörülebilir yerlerde duruyor: sonradan neyin nereye gittiğine bakmak isterseniz, didik didik aramadan bulursunuz.

Programlar

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

Ana klasörünüzde üç dizin

.claude-codegym - Claude Code'un kurs profili: ayarlar, ajanın çalışma kuralları, yardımcı çalışma teknikleri.

.codegym - CodeGym eklentilerine giriş ayarları ve iki başlatma komutu (bunlara aşağıda değineceğiz).

.codegym-backups - yükleyicinin değiştirdiği dosyaların yedekleri ve bir değişiklik günlüğü. Son 10 çalıştırma ya da son 30 gün saklanıyor.

Ayrıca: Claude Code'un kendisi ~/.local/bin dizinine, konuşma tanıma modeli ise Handy'nin veri klasörüne kuruluyor.

Sistem ayarlarında neler değişiyor

PATH değişkeni - kursun komutları terminalden çalışsın diye. Windows'ta değişiklik kayıt defterine, macOS'ta .zprofile dosyasına, Linux'ta ise /etc/profile.d/codegym.sh ve .profile dosyalarına yazılıyor.

macOS ve Linux'ta bizim satırlarımız # CODEGYM START ve # CODEGYM END işaretleri arasına alınıyor. Bunları gözle görebilirsiniz, geri alma işlemi de tam olarak bu satırları siliyor, sizin ayarlarınıza dokunmadan.

Windows kayıt defteri - üç girdi, fazlası değil: Gradle'ın yolu, kurs komutlarının yolu ve IntelliJ IDEA lisans sözleşmesinin kabulü.

4. İki komut: claude ve claude-native

Bu, önceden bilmeye değer önemli bir ayrıntı.

Kursun kendi Claude Code ayarları var: kurs sunucusuna bağlantı, ajanın çalışma kuralları, kursun karakterleri. Bunlar sizin kişisel ayarlarınızla karışmamalı, bu yüzden ikisini birbirinden ayırdık.

claude - Claude Code'u kurs profiliyle başlatır. Kurs için çalışırken kullandığınız komut bu.

claude-native - kişisel Claude Code'unuzu başlatır, sanki biz hiç yokmuşuz gibi. Kendi ayarlarınız, kendi hesabınız.

İşleyişi şöyle: iki komut da .codegym/bin klasöründeki küçük betikler. İkisi de aynı gerçek Claude Code'u başlatıyor, ama onu farklı ayar klasörlerine yönlendiriyor. Ben ikisini de elimin altında tutuyorum: kursunkini kurs çalışmaları için, kendiminkini geri kalan her şey için.

Yükleyici kişisel Claude Code profilinizi okumaz, değiştirmez ve silmez. Daha önce bir profiliniz varsa, olduğu gibi kalır.

Pratik bir not: komutlar yeni bir terminal penceresinde görünür. Kurulumdan hemen sonra, zaten açık olan bir pencereye claude yazarsanız, o pencere bu komutlardan henüz haberdar değildir. Yeni bir pencere açmanız yeterli.

5. Neleri yapmıyoruz

Belki de en önemli bölüm bu. Yükleyici "zarar verme" ilkesiyle yazıldı ve bundan çıkanlar şunlar.

Bilgisayarınızda zaten kurulu olanı silmiyor ve üzerine yazmıyoruz. Bilgisayarınızda Java, Python, Node veya Git'in başka bir sürümü varsa yerinde kalır. Kurs için gereken sürüm onun yanına kurulur.

Sürüm yöneticilerine dokunmuyoruz. nvm, pyenv, sdkman veya asdf kullanıyorsanız yükleyici bunlara dokunmaz, sadece raporda bir sürümü yanına kurduğunu bildirir. Sizin pyenv kurulumunuzu bozmak isteyeceğimiz en son şey.

Gereken sürümde zaten kurulu olanı yeniden kurmuyoruz. Yükleyiciyi tekrar çalıştırmak kurulu olanı bozmaz: yükleyici her aracı kontrol eder ve hazır olanları atlar.

Bizim kurmadığımız IntelliJ IDEA'ya dokunmuyoruz. IDEA'nız JetBrains Toolbox'tan geliyorsa ona dokunmayız, kurs için ayrı bir kopya kurarız ve bunu size söyleriz.

Verdiğiniz onayları değiştirmiyoruz. IDEA lisansını zaten kabul ettiyseniz ya da kullanım istatistikleri tercihinizi belirlediyseniz, bu ayarlar sizin seçtiğiniz gibi kalır.

Başlangıç öğelerine, hizmetlere ve sistem politikalarına karışmıyoruz. Yükleyici kendini başlangıçta çalışacak şekilde ayarlamaz, hizmet ya da zamanlanmış görev oluşturmaz, sertifika yüklemez, güvenlik duvarına, hosts dosyasına ve DNS'e dokunmaz.

Yapay zekâ ajanının yetkilerini genişletmiyoruz. Kurs profili Claude Code'un hiçbir kısıtlamasını kaldırmaz: ajan olağan güvenlik ayarlarıyla çalışır ve her zamanki gibi izin ister.

6. Hangi veriler toplanıyor

Kişisel anahtarınız

İndirme sırasında arşive, hesabınıza bağlı kişisel bir erişim anahtarı yazılır. CodeGym ve Claude Code eklentileri hesabınıza bu anahtarla kendiliğinden giriş yapar, anahtarları elle girmek zorunda kalmamanızın nedeni de bu. Anahtar günlüğe düşmez: onu da parolaları maskeleyen aynı filtre maskeler. Arşivi başkalarına vermemenizin nedeni de yine bu anahtar.

Kurulum günlüğü

Kurulum sırasında ayrıntılı bir günlük tutulur: hangi adımlar çalıştı, bilgisayarda neler zaten vardı, neler başarılı oldu, neler olmadı. Bu günlük sizin diskinizde kalır. Hiçbir yere gitmez.

Bir şey ters giderse, onu kendi kararınızla siz gönderirsiniz. Windows'ta geçici klasörde (%TEMP%\codegym-install.log), macOS ve Linux'ta ise yükleyicinin hemen yanında, install.log dosyasında durur.

Parolalar ve anahtarlar günlüğe düşmez: her satır yazılmadan önce, token'ları ve parolaları [SECRET] işaretiyle değiştiren bir filtreden geçer. Yapılandırma dosyalarınızın içeriği de oraya yazılmaz, yalnızca parametre adları yazılır.

Bir gün hata raporlarının otomatik gönderimi eklenirse, bunu önceden duyuracağız ve kapatmanın bir yolunu bırakacağız.

Kurs oturumlarının günlüğü

Bu ayrı bir konu ve bunu açıkça söylemek gerekiyor.

Claude Code'un kurs profili bir çalışma günlüğü tutacak şekilde ayarlanmıştır. Bir kurs görevi üzerinde çalıştığınızda proje klasöründe .codegym/cc-transcript.txt dosyası oluşturulur ve çalışmanın nasıl ilerlediği buraya kaydedilir: sizin ajana yazdığınız istekler, ajanın cevaplarının başlangıç kısmı, ajanın hangi dosyaları değiştirdiği ve hangi komutları çalıştırdığı.

Neden gerekli: platform görevin çözümünü bu günlüğe bakarak kontrol eder. Bu, sizin "çözüm yolu defteriniz": sadece sonucu değil, oraya nasıl ulaştığınızı da gösterir. Kulağa biraz tedirgin edici geliyor, farkındayım. Ama günlük olmadan platform yalnızca en sonda ortaya çıkanı görür.

Bilmeniz gerekenler:

günlük proje klasörünüzde durur, açıp okuyabilirsiniz;
kendiliğinden hiçbir yere gönderilmez - günlüğü tutan dosyalarda internete giden tek bir istek bile yok;
içindeki parolalar ve anahtarlar kurulum günlüğündeki gibi maskelenir;
yalnızca kurs profilinde tutulur. claude-native ile başlatırsanız günlük yazılmaz.

Yapay zekâ trafiği hangi sunucudan geçiyor

Susmak yerine açıkça söylemeyi daha önemli bulduğumuz bir gerçek daha.

Kursta kullandığınız yapay zekâ erişiminin ücretini CodeGym ödüyor ve bu erişim bizim sunucumuz llm.codegym.cc üzerinden çalışıyor. Yani modele gönderdiğiniz istekler ve modelin cevapları fiziksel olarak CodeGym altyapısından geçiyor.

Öğrencilere ücretsiz erişim bu şekilde işliyor. Doğrudan kendi kişisel hesabınızla çalışmak istiyorsanız, claude-native komutu tam da bunun için var.

7. Nasıl kontrol edilir, nasıl geri alınır

Bu makaleye körü körüne inanmak zorunda değilsiniz. Yükleyicinin, önceden bakmanızı ve sonradan geri almanızı sağlayan modları var.

Hiçbir şey kurmadan bakmak

--dry-run bayrağı (Windows'ta -DryRun) yükleyiciyi "yalnızca göster" modunda çalıştırır. Yükleyici yapacağı her şeyin tam listesini yazdırır (hangi dosyaları indireceğini, nereye koyacağını, PATH'e ne ekleyeceğini) ve hiçbir şey kurmadan kapanır.

Dürüst olmak gerekirse, bu moda "hiçbir şeye dokunmayan" demek tam olarak doğru olmaz. Önceki çalıştırmanın günlük dosyasının üzerine yazar, kendi çalışma klasörlerini oluşturur ve eskimiş yedekleri temizler. Ama hiçbir program kurulmaz, ayarlarınız ve PATH değişmez.

PATH'e dokunmamak

--minimal bayrağı (Windows'ta -Minimal) tüm programları kurar ama sistem ayarlarına hiçbir yol yazmaz. Bunun yerine sizin kendiniz ekleyeceğiniz satırları yazdırır. Bu mod, ortamını kendine göre ayarlamış olanlar için (ihtiyacınız olup olmadığından emin değilseniz, yok demektir).

Windows'ta bu mod şu an tam çalışmıyor: kurs komutlarının yolu yine de kullanıcı PATH'ine ekleniyor. Değişiklik geri alınabilir, ama bayrak şimdilik vaat ettiğini tam olarak yapmıyor. Biliyoruz, düzelteceğiz.

Değişiklikleri geri almak

--rollback bayrağı (Windows'ta -Rollback) yükleyicinin değiştirdiği ayarları eski haline getirir: PATH, kabuk profili dosyaları, yapılandırmalar, kayıt defteri girdileri. Her değişiklik bir işlem günlüğüne yazılır ve geri alma tam olarak bu günlüğe göre yapılır.

Ek bir güvence: kurulumdan sonra bir dosyayı kendiniz düzenlediyseniz, geri alma o dosyaya dokunmaz. Bunun yerine size haber verir ve yedeğin nerede olduğunu gösterir.

Geri almanın yapmadığı şey: kurulan programları kaldırmaz. IntelliJ IDEA, Java, Node ve diğerleri yerinde kalır. Onun yerine yükleyici, bu programları kaldırmak için hazır komutlarla birlikte bir liste yazdırır. Neyin kaldırılacağına siz karar verirsiniz.

Açıkça söylenmesi gereken bir ayrıntı daha: Windows'ta Java, Node ve Python yükleyicileri kendi yollarını bizim işlem günlüğümüzü atlayarak kendileri ekler. Geri alma bu girdileri eski haline getiremez.

Windows'ta yükleyici, kurulumun sonunda hazır geri alma komutunu kendisi yazdırır. Komutu şöyle çalıştırırsınız:

PowerShell'i yönetici olarak açın: PowerShell simgesine sağ tıklayın, ardından "Yönetici olarak çalıştır" seçeneğini seçin.
Yükleyicinin klasörüne geçin.
Komutu çalıştırın:

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

Neler yapıldığını görmek

Yükleyici işini bitirince bir rapor yazdırır: adımların listesi ve her birinin durumu - tamamlandı, atlandı, uyarı, hata ya da "elle yapın". Başarısızlıklar gizlenmez: bir şey kurulamadıysa rapor bunu açıkça, nedeniyle birlikte yazar.

Yükleyicinin kendi başına yapamadığı her şey, somut komutlarla birlikte ayrı bir "Elle tamamlayın" bölümünde toplanır.

8. Elle yapmanız gerekenler

Bazı şeyler prensipte otomatikleştirilemez.

Handy için izinler. İlk çalıştırmada sistem mikrofon erişimi isteyecek (macOS'ta ayrıca "Erişilebilirlik" izni de). Bu izinler olmadan sesli giriş çalışmaz. İzni yalnızca bir insan verebilir, hiçbir program bunu sizin yerinize yapamaz.

İlk açılışta IntelliJ IDEA pencereleri çıkabilir. Yükleyici lisansı önceden kabul eder, ama lisans penceresi yine de açılırsa lisansı kabul edin.

9. Sık sorulan sorular

Kurulum ne kadar sürüyor?

20-40 dakika, yaklaşık bir gigabayt indiriliyor. Zamanın çoğu IntelliJ IDEA'ya ve konuşma tanıma modeline gidiyor.

Yönetici hakları neden gerekli?

Programlar sistem klasörlerine kuruluyor (Program Files, /opt, /Applications) ve yönetici hakları olmadan oraya yazılamıyor. Ayarlar ve kurs profili ise sizin kullanıcı klasörünüze yerleşiyor ve size ait kalıyor.

Yükleyiciyi iki kez çalıştırabilir miyim?

Evet, hiçbir şey bozulmaz. Kurulu olanlar atlanır. Yanlışlıkla iki kez başlatmaya karşı da bir koruma var: ikinci örnek, kurulumun zaten sürdüğünü görür ve kendini kapatır.

Claude Code ayarlarıma ne olacak?

Hiçbir şey. Kurs profili ayrı bir klasörde duruyor, sizin kişisel profiliniz okunmuyor ve değiştirilmiyor. Kendi işleriniz için claude-native komutu var.

Çalıştırırken sistem bir uyarı gösteriyor. Bu normal mi?

Evet. İşletim sistemleri internetten indirilen her programı böyle karşılar, bizim yükleyicimizin de henüz bir kod imzalama sertifikası yok. Windows'ta önce "Ek bilgi"ye, ardından "Yine de çalıştır"a tıklayın. macOS'ta sistem geliştiricinin doğrulanamadığını söylerse dosyaya sağ tıklayın, "Aç"ı seçin ve bir kez daha onaylayın.

Yükleyici dosyalardaki "internetten indirildi" işaretini kaldırıyor. Neden?

Aksi halde sistem paketteki dosyaların çalışmasını engeller ve kurulum yarıda kesilir. Windows'ta bu işlem arşivden çıkarılan klasör için yapılır, macOS'ta ise aynı klasörden Gatekeeper karantinası kaldırılır. İşaret yalnızca yükleyicinin kendi dosyalarından kaldırılır, yükleyici diğer dosyalarınızın hiçbirine dokunmaz.

Arşivi neden başkalarıyla paylaşmamalıyım?

İçinde kişisel giriş bilgileriniz var. Arşivi eline geçiren kişi sizin hesabınızla çalışabilir. İndirme bağlantısını paylaşmakta sorun yok: onu kullanan herkes kendi arşivini alır.

Bir şeyler ters gitti. Ne yapmalıyım?

Sondaki rapora ve install.log dosyasına bakın: hangi adımda ve neden takıldığı orada görünür. Yine anlaşılmıyorsa bu dosyayı destek ekibine gönderin. Bu, son çare değil, olağan yol.

10. Her şeyi bir anda kurmak istemiyorsanız

Yükleyici kursun zorunlu bir adımı değil, zaman kazanmanın bir yolu. Yaptığı her şey derslerde adım adım anlatılıyor: Claude Code tek bir komutla kuruluyor, ayarlar tek bir dosya kopyalanarak geliyor.

Diğer araçlar ihtiyaç duyuldukça ekleniyor ve onlara ihtiyaç duyduğunuzda ne işe yaradıklarını zaten anlamış oluyorsunuz. Bu şekilde on satırlık bir listeden çok daha iyi akılda kalıyorlar.