Phase 00: Setup & Tooling

Düzenleyici Kurulum

Type: Build

Languages: --

Prerequisites: Phase 0, Lesson 01

Time: ~20 minutes

Öğrenme Hedefleri

• Python, Jupyter, linting ve uzaktan SSH için gerekli uzantılarla VS Code yükleyin
• AI iş akışları için format-on-save, tip kontrolü ve notbuk çıkışını kaydırmayı yapılandır
• Uzaktan GPU makinelerindeki kodları yerel gibi düzenlemek ve hata işlemleri için Uzaktan SSH ayarlayın
• Editör alternatiflerini (Cursor, Windsurf, Neovim) ve AI çalışması için onların pazarlamalarını değerlendirmek

Sorun

Python yazmak, not defterleri çalıştırmak, eğitim döngüslerini düzeltmek ve GPU kutularına SSH koymak için binlerce saatinizi editörünüzün içinde geçireceksiniz. Yanlış yapılandırılmış bir editör her oturumunu sürtüşmeye dönüştürür: otomatik tamamlanmaz, tip ipucuları yoktur, iç çizgi hataları yoktur, manuel biçimlendirme ve çılgın bir terminal iş akışı.

Doğru ayarlama 20 dakika alır, atlamak her gün 20 dakika alır.

Anlaşım

Bir AI mühendislik editörü kurulması beş şeye ihtiyaç duyar:

graph TD
    L5["5. Remote Development<br/>SSH into GPU boxes, cloud VMs"] --> L4
    L4["4. Terminal Integration<br/>Run scripts, debug, monitor GPU"] --> L3
    L3["3. AI-Specific Settings<br/>Auto-format, type checking, rulers"] --> L2
    L2["2. Extensions<br/>Python, Jupyter, Pylance, GitLens"] --> L1
    L1["1. Base Editor<br/>VS Code — free, extensible, universal"]

Yapın

Adım 1: VS Kodunu Kur

VS Code önerilen düzenleyici. Ücretsiz, her işletim sisteminde çalışır, birinci sınıf Jupyter notebook desteğine sahiptir ve uzantı ekosisteminin AI çalışması için ihtiyacınız olan her şeyi kapsar.

İndir code.visualstudio.com- Evet .

Terminalden kontrol edin:

bashCopycode --version

• EğercodemacOS'ta bulunmuyor, VS Code aç, bas Cmd+Shift+P, "Shell Komutu" yazın ve "PATH'de 'kod' komutu yükleyin" seçin.

İkinci Adım: Gerekli Ekstensiyonları Kur

Entegre terminalı VS Kodunda aç (` Ctrl+``) ve AI çalışması için önemli olan uzantıları yükle:

bashCopycode --install-extension ms-python.python
code --install-extension ms-python.vscode-pylance
code --install-extension ms-toolsai.jupyter
code --install-extension eamodio.gitlens
code --install-extension ms-vscode-remote.remote-ssh
code --install-extension ms-python.debugpy
code --install-extension ms-python.black-formatter
code --install-extension charliermarsh.ruff

Her birinin yaptığı:

Dosya code/.vscode/extensions.jsonBu ders, proje klasörünü açtığınızda, VS Code, bunları yüklemenizi isteyecektir.

Adım 3: Ayarları yapılandır

Ayarları code/.vscode/settings.jsonBu derste, ya da elle uygulayın.Settings > Open Settings (JSON)- Evet .

AI çalışması için ana ayarlar:

jsoncCopy{
    "python.analysis.typeCheckingMode": "basic",
    "editor.formatOnSave": true,
    "editor.rulers": [88, 120],
    "notebook.output.scrolling": true,
    "files.autoSave": "afterDelay"
}

Neden bunlar önemli:

• Type checking on basicÇekmeden önce yanlış argüman türlerini yakalar. Tensor şekli eşleşmezlikleri ve yanlış API parametreleri üzerinde debugging zaman tasarruf eder.
• Format on saveBir daha formate etmeyi düşünmeyin.
• Rulers at 88 and 120Siyah sarılır 88. 120 işaretçisi doküstrelerin ve yorumların çok uzun olduğunu gösterir.
• Notebook output scrollingEğitim döngüleri binlerce satır yazdırırır.
• Auto-save: Kaydetmeyi unutacaksınız. Eğitim senaryounuz eski kod çalıştırır. Otomatik kaydetme bunu önler.

Dördüncü Adım: Terminal Entegreasyonu

VS Code'un entegre terminali eğitim senaryolarını çalıştırmak, GPU'ları izlemek ve ortamları yönetmek için.

Doğru ayarlayın:

jsoncCopy{
    "terminal.integrated.defaultProfile.osx": "zsh",
    "terminal.integrated.defaultProfile.linux": "bash",
    "terminal.integrated.fontSize": 13,
    "terminal.integrated.scrollback": 10000
}

Kullanılabilir kısayollar:

Bölünmüş terminaller yararlıdır: biri senaryoyu çalıştırmak için, biri GPU ile izlemek için nvidia-smi -l 1veya watch -n 1 nvidia-smi- Evet .

Adım 5: Uzaktan Geliştirme (SSH GPU Kutusu)

Bu, AI çalışması için en önemli uzantı. Uzaylı makinelerde (bulut VM'ler, laboratuvar sunucular, Lambda, Vast.ai) eğitim süreceksiniz. Uzaylı SSH uzaylı dosya sistemini açmanıza, dosyaları düzenlemenize, terminalleri çalıştırmanıza ve her şey yerel gibi hata işlemlerini düzeltmenize olanak tanır.

Yapılandırma:

1. Uzak SSH uzantısını yükleyin (Adım 2'de yapıldı).
2. Basın Ctrl+Shift+P(veya Cmd+Shift+P), "Uzak-SSH: Host'a Bağlantı" türü.
3. Girin .user@your-gpu-box-ip- Evet .
4. VS Code, sunucu bileşenini uzaktan makineye otomatik olarak yükler.

Parolasız erişim için SSH anahtarlarını ayarlayın:

bashCopyssh-keygen -t ed25519 -C "your-email@example.com"
ssh-copy-id user@your-gpu-box-ip

Ev sahibi ekle ~/.ssh/configUyum için:

CopyHost gpu-box
    HostName 203.0.113.50
    User ubuntu
    IdentityFile ~/.ssh/id_ed25519
    ForwardAgent yes

Şimdi .Remote-SSH: Connect to Host > gpu-boxHemen bağlanır.

Alternatifler

Kursor

cursor.comBu, aynı ekstensiyon ekosistemini ve ayar biçimini kullanıyor. Cursor kullanıyorsanız, bu dersdeki her şey hala geçerlidir. Aynı şeyi ithal edin settings.jsonve extensions.json- Evet .

Rüzgar sürfi

windsurf.comAynı hikaye: aynı uzantılar, aynı ayar formatı, aynı Uzay SSH desteği.

Vim/Neovim

Eğer zaten Vim veya Neovim kullanıyorsanız ve bu konuda verimliyseniz, orada kalın.

• pyrightveya pylspTip kontrolü için (Mason veya manuel kurulum yoluyla)
• nvim-lspconfigDil sunucu entegrasyonu için
• jupyter-vimveya molten-nvimNot defteri gibi çalıştırmak için
• telescope.nvimDosya/simbol arama için
• none-ls.nvimŞartlama/kısaltma için siyah ve kargaşlı

Eğer Vim'i kullanmıyorsanız, şimdi başlamayın. Öğrenme eğriliği AI mühendisliği öğrenmekle rekabet edecek. VS Code kullanın.

Kullan

Bu ayarla günlük iş akışınız şöyle görünüyor:

1. Proje klasörünü VS Code'da açın (veya uzaktan SSH üzerinden GPU kutusuna bağlayın).
2. Otomatik tamamlama, yazma ipuçları ve iç hatalı hatalarla Python'u düzenleyicide yazın.
3. Jupyter defterlerini Jupyter uzantısı ile uyumlu çalıştır.
4. Eğitim senaryoları için entegre terminal kullanın.uv pip install, ve GPU izleme.
5. GitLens ile yapılan değişiklikleri, karar vermeden önce gözden geçirin.

Egzersizler

1. VS Kod ve 2. Adımda listelenen tüm uzantıları yükle
2. Kopyalayın .settings.jsonBu dersden VS Code yapılandırmalarına
3. Python dosyasını açın ve Pylance'de kaydetken tip ipuçlarını ve siyah biçimleri gösterildiğini doğrulayın
4. Uzaktan bir makineye erişimi varsa, Uzaktan SSH ayarlayın ve üzerinde bir klasör açın

Anahtar Terimler

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.