--- title: "Hızlı başlangıç kılavuzu" description: "Verdent'i dakikalar içinde kullanmaya başlayın" --- Bu hızlı başlangıç kılavuzu, 15 dakikadan kısa sürede Verdent'in Plan-Verify-Code iş akışını kullanmanızı sağlayacak. Uzantıyı yükleyecek, ilk görevinizi tamamlayacak ve Verdent for VS Code ile çalışırken temel iş akışını anlayacaksınız. ### Neler öğreneceksiniz - Verdent for VS Code'u marketplace'ten yükleme - Kimlik doğrulama yapma ve kurulumunuzu doğrulama - İlk yapay zeka destekli görevinizi tamamlama - Yürütme modlarını anlama (Manual Accept, Auto-Run, Plan Mode) - Günlük kodlama için temel özellikleri kullanma ### Ön koşullar Başlamadan önce şunlara sahip olduğunuzdan emin olun: - Sisteminizde Visual Studio Code yüklü olmalı - Etkin bir internet bağlantısı - Aktif bir Verdent abonelik hesabı (veya 7 günlük ücretsiz denemeyle başlayın) --- ## Adım 1: Verdent'i yükleyin [Verdent uzantısı sayfasını](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) ziyaret edin ve **Install** düğmesine tıklayın. 1. Visual Studio Code'u açın 2. `Ctrl+Shift+X` tuşlarına basın (veya macOS'ta `Cmd+Shift+X`) 3. "Verdent" araması yapın 4. **Install** düğmesine tıklayın ```bash code --install-extension verdentai.verdent ``` --- ## Adım 2: Verdent'i kullanmaya başlayın Visual Studio Code'u proje klasörünüzde açın. Kenar çubuğundaki Verdent simgesine tıklayın veya `Ctrl+L` (Windows/Linux) / `Cmd+L` (macOS) tuşlarına basın. İstendiğinde Verdent hesabınızla kimlik doğrulaması yapmak için oturum açın. --- ## Adım 3: İlk göreviniz Verdent'in çalışma alanınızı nasıl anladığını gösteren basit, zarar vermeyen bir görevle başlayalım. **VS Code'da bir proje açın**, ardından Verdent giriş kutusunda şu istemlerden birini deneyin: ``` What kind of project is this? ``` Verdent çalışma alanınızın yapısını analiz edecek, önemli dosyaları okuyacak ve ne tür bir uygulama üzerinde çalıştığınızı açıklayacak. Bu, herhangi bir değişiklik yapmadan bağlam farkındalığını gösterir. **Şunları görmelisiniz:** - Verdent'in çalışma alanınızdaki dosyaları analiz etmesi - Proje türünüzün, teknolojilerinizin ve yapınızın bir özeti - Dosya değişikliği olmaması (salt okunur analiz) **Şu takip istemlerini deneyin:** ``` Explain what this project does ``` ``` What dependencies does this project have? ``` ``` Show me the main entry point of this application ``` Her istem, Verdent'in çalışma alanınıza erişebildiğini ve kod tabanınızı anladığını doğrulamanıza yardımcı olur. Bu keşif istemleri, tanımadığınız kod tabanlarını anlamak için idealdir. Verdent, bağlamı manuel olarak eklemenizi gerektirmeden dosyaları gerektiği gibi okur. --- ## Adım 4: İlk kod değişikliğinizi yapma Şimdi Verdent'in bir şeyler oluşturmasını sağlayalım. Şu basit görevi deneyin: ``` Create a hello_world.txt file with a greeting message ``` **Ne olur:** 1. **Verdent değişikliği önerir** Oluşturulacak dosyayı ve içeriğini gösteren bir önizleme görürsünüz 2. **İzin isteği** Auto Run Mode'da (varsayılan), Verdent dosyayı oluştururken otomatik onay verir 3. **Onaylarsınız** "Accept" düğmesine tıklayın veya değişikliği onaylayın 4. **Dosya oluşturulur** Verdent dosyayı oluşturur ve tamamlandığını onaylar **İzinleri anlama:** Manual Accept Mode, onayınız olmadan istenmeyen değişikliklerin yapılmamasını sağlar. Şunlar için izin istemleri görürsünüz: - Dosya düzenleme ve oluşturma - Komut yürütme - Araç kullanımı (her araç türünün ilk kullanımı) Bu, size tam kontrol sağlar ve Verdent'in farklı görevler için hangi işlemleri gerçekleştirdiğini öğrenmenize yardımcı olur. Manual Accept Mode, yeni kullanıcılar için önerilen başlangıç noktasıdır. Rahat hissettiğinizde farklı iş akışları için Auto-Run Mode'a veya Plan Mode'a geçebilirsiniz. --- ## Adım 5: Karmaşık görevler için Plan Mode'u kullanma Plan Mode, Verdent'in yürütmeden önce yaklaşımları gözden geçirebileceğiniz salt okunur planlama modudur. Hadi deneyelim: **Plan Mode'a geçin:** Giriş kutusundaki **Switch Mode** düğmesine tıklayın ve **Plan Mode** seçeneğini belirleyin **Bir planlama görevini deneyin:** ``` Suggest ways to build a website for my project ``` **Ne olur:** 1. **Verdent projenizi analiz eder** Dosyaları okur ve proje yapınızı ve gereksinimlerinizi anlar 2. **Ayrıntılı bir plan oluşturur** Hangi teknolojilerin kullanılacağını, hangi sayfaların oluşturulacağını ve web sitesinin nasıl yapılandırılacağını gösterir 3. **Değişiklik yapmaz** Plan Mode salt okunurdur. Siz açıkça onaylayana kadar Verdent dosyaları değiştiremez 4. **Etkileşimli netleştirme** Verdent, planı sonlandırmadan önce tasarım tercihleri, hedef kitle veya özellikler hakkında sorular sorabilir **Plan Mode'u neden kullanmalısınız:** - **Güvenli keşif** - Tanımadığınız kod tabanlarını yanlışlıkla değişiklik yapmadan anlayın - **Kod incelemesi** - Değişiklik yapmadan önce kaliteyi ve mimariyi analiz edin - **Stratejik planlama** - Karmaşık görevleri incelenebilir adımlara bölün - **Belirsizliği azaltma** - Verdent, belirsizliği ortadan kaldırmak için netleştirici sorular sorar Yürütmeye başlamadan önce yaklaşımı gözden geçirmek istediğiniz herhangi bir görev için Plan Mode'u kullanın. Verdent'in kod tabanınız hakkında nasıl düşündüğünü öğrenirken özellikle değerlidir. **Planı yürütmek için:** Planı gözden geçirdikten sonra Verdent iki seçenek sunar: - Değişiklik istemek veya netleştirici sorular sormak için **Edit** seçeneğini belirleyin - Agent Mode'a geçmek ve yürütmeye başlamak için **Start Building** seçeneğini belirleyin --- ## Adım 6: Yürütme modlarını anlama Verdent, farklı iş akışlarına uyacak şekilde birden fazla yürütme modu sunar: **İzin modları:** | Mod | Açıklama | Ne zaman kullanılır | | --------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | | **Manual Accept** | Her aracın ilk kullanımında izin ister | Maksimum kontrolle öğrenme ve genel geliştirme | | **Auto-Run** (varsayılan) | Güvenli işlemleri otomatik kabul eder (dosya okuma, web aramaları); dosya düzenlemeleri ve komutlar yine de onay gerektirir | Güvenilir projeler ve hızlı prototipleme | | **Plan Mode** | Dosya değişikliği olmadan analiz ve planlama için salt okunur mod | Karmaşık görevler ve kod incelemesi | | **Skip Permissions** | Tüm istemleri atlayan tam özerk çalışma | Otomatik test veya korumalı alanlar gibi izole, güvenli ortamlar | **Ek mod:** - **Think Hard Mode** - Karmaşık akıl yürütme ve mimari kararlar için maksimum düşünme bütçesi Skip Permissions Mode tüm güvenlik kontrollerini kaldırır. Yalnızca hataların sonuç doğurmadığı izole, tek kullanımlık ortamlarda kullanın. --- ## Temel eylemler Verdent for VS Code'da her gün kullanacağınız temel eylemler şunlardır: | Eylem | Nasıl erişilir | Açıklama | | ------------------ | ---------------------------------------- | --------------------------------------------- | | Verdent'i aç | `Cmd+L` / `Ctrl+L` veya kenar çubuğu simgesine tıklayın | Verdent panelini açar | | Yeni oturum | Üst çubukta "New Session" tıklayın | Temiz bağlamla yeni bir konuşma başlatın | | Bağlam ekle | "Add Context" düğmesine tıklayın | @-mention ile dosyalara referans verin | | Görsel ekle | "Add Images or Files" düğmesine tıklayın | Ekran görüntüleri, taslaklar veya diyagramlar yükleyin | | Mod değiştir | "Switch Mode" düğmesine tıklayın | Agent/Plan/Chat modları arasında geçiş yapın | | Model değiştir | Model seçiciye tıklayın | Performance/Balance/Efficiency hazır ayarlarını seçin | | Think Hard | "Think Hard Mode" düğmesine tıklayın | Karmaşık görevler için genişletilmiş akıl yürütmeyi etkinleştirin | | İzinleri değiştir | "Switch Permission" düğmesine tıklayın | İzin modunu değiştirin | | Geçmişi görüntüle | Üst çubukta "Project History" tıklayın | Geçmiş oturumlara göz atın | | Kullanıcı merkezi | Üst çubukta "User Center" tıklayın | Kredi bakiyenizi ve hesap bilgilerinizi kontrol edin | | Ayarlar | Üst çubukta "Settings" tıklayın | MCP sunucularını, alt aracıları, kuralları yapılandırın | --- ## Yeni başlayanlar için profesyonel ipuçları Değişiklik yapmadan önce Verdent'in kod tabanınızı anlamasına izin verin: ``` Analyze the database schema ``` ``` Explain the authentication flow ``` Bu, Verdent'in projeniz hakkındaki bağlamını oluşturur ve daha iyi öneriler yapmasına yardımcı olur. Şunun yerine: "hatayı düzelt" Şunu deneyin: "`LoginForm.tsx` dosyasındaki, kullanıcıların yanlış kimlik bilgileri girdikten sonra boş ekran görmesine neden olan oturum açma hatasını düzelt" Açık istemler daha doğru çözümlere ve daha az yinelemeye yol açar. Tam olarak anlamadığınız kodla çalışırken önce Plan Mode'u kullanın: ``` Refactor the authentication module to use async/await instead of callbacks ``` Planı gözden geçirin, netleştirici sorular sormak ve iyileştirmek için **Edit** seçeneğini belirleyin, ardından emin olduğunuzda **Start Building** seçeneğini belirleyin. Çok adımlı özellikler için kademeli çalışın: ``` 1. Create a new database table for user profiles ``` Ardından tamamlandıktan sonra: ``` 2. Create an API endpoint to get and update profiles ``` Bu, netliği korur ve her adımı doğrulamanıza olanak tanır. Gerektiğinde dosyalara açıkça referans verin: ``` @components/UserProfile.tsx refactor this component to use hooks ``` Bu, Verdent'in göreviniz için doğru bağlama odaklanmasını sağlar. Verdent üç yerleşik alt aracı içerir: - `@Explorer` - Hızlı kod tabanı keşfi ve dosya bulma - `@Verifier` - Hızlı kod doğrulama ve kontroller - `@Code-reviewer` - Kapsamlı güvenlik ve kalite incelemesi Örnek: ``` @Explorer find all API endpoints in this project ``` --- ## Sık karşılaşılan sorunlar **Çözüm:** VS Code'u yeniden başlatın. Hâlâ eksikse, Uzantılar panelinde (`Cmd+Shift+X` / `Ctrl+Shift+X`) kurulumu doğrulayın ve "Verdent" öğesinin listede göründüğünü onaylayın. **Çözüm:** 1. İnternet bağlantısının etkin olduğunu doğrulayın 2. Güvenlik duvarı/proxy ayarlarının Verdent hizmetlerine HTTPS'ye izin verdiğini kontrol edin 3. User Center'da kalan krediniz olduğunu onaylayın 4. Bağlantıyı test etmek için daha basit bir istem deneyin **Çözüm:** "Switch Permission" düğmesini kullanarak Auto-Run Mode'a geçin. Bu, güvenli okuma işlemlerini otomatik olarak onaylarken dosya düzenlemeleri ve komutlar için yine de onay ister. --- ## Yardım alma - **Discord topluluğu**: https://discord.com/invite/NGjXEZcbJq - Gerçek zamanlı destek sunan aktif topluluk - **Dokümantasyon**: Bu dokümantasyondaki diğer kılavuzlara göz atın - **Geri bildirim**: Sorunları bildirmek veya iyileştirmeler önermek için Verdent'in üst çubuğundaki Feedback düğmesini kullanın --- ## SSS Verdent panelinin altındaki giriş kutusuna bakın. "Switch Permission" düğmesi mevcut modunuzu görüntüler (örneğin, "Manual", "Auto", "Plan"). Modları değiştirmek için tıklayabilirsiniz. Standart kredi tabanlı istekler bakiyeniz sıfıra ulaştığında durur. Devam etmek için bir sonraki faturalandırma döngüsü yenilemenizi bekleyin veya tek seferlik ek kredi yüklemesi satın alın. Evet, her VS Code penceresi bağımsız çalışır. Verdent'i birden fazla projede açık tutabilirsiniz ve her biri kendi ayrı konuşma bağlamını korur. Üst çubuktaki "New Session" düğmesine tıklayın. Bu, mevcut konuşma geçmişini temizler ve bir sonraki göreviniz için Verdent'e yeni bir bağlam penceresi verir. --- ## Sonraki adımlar Verdent'i yüklediniz, ilk görevinizi tamamladınız ve temel iş akışını öğrendiniz. İşte bundan sonra gidebileceğiniz yerler: Alt aracıları, çoklu aracı mimarisini ve bağlam yönetimini anlayın Çok adımlı görevler, büyük kod tabanları ve sürüm kontrolü için adım adım kılavuzlar