--- title: "Yapılandırma ve özelleştirme" description: "İş akışınıza uyacak şekilde Verdent özelleştirme" --- Verdent for VS Code, geliştirme iş akışınıza, kodlama tercihlerinize ve ekip standartlarınıza uyum sağlamak için kapsamlı yapılandırma seçenekleri sunar. Ayarları VS Code'in yerel ayarlar arayüzü üzerinden yapılandırın, klavye kısayollarını özelleştirin ve özel davranışlar için kurallar ve alt aracılar oluşturun. ### Neler öğreneceksiniz - Verdent için VS Code uzantı ayarlarını yapılandırma - Verimli iş akışı için klavye kısayollarını özelleştirme - Kişiselleştirilmiş aracı davranışı için Rules oluşturma ve yönetme - Özel görevler için özel alt aracılar oluşturma ### Ön koşullar - Verdent for VS Code yüklü ve kimlik doğrulaması yapılmış - VS Code ayarlarına erişim (`Cmd+,` veya `Ctrl+,`) - Kural dosyaları için temel JSON bilgisi (isteğe bağlı) --- ## VS Code uzantı ayarları Verdent for VS Code ayarlarına, yapılandırma türüne ve kapsamına bağlı olarak birden fazla konumdan erişilir. ### Ayarlara erişim **Uzantı ayarları (VS Code yerel):** 1. VS Code Ayarları'nı açın: `Cmd+,` (macOS) veya `Ctrl+,` (Windows/Linux) 2. Ayarlar arama çubuğunda "Verdent" aratın 3. Uzantı ayarlarını değiştirin (örneğin `verdent.enableCheckpoints`) **Verdent'a özel ayarlar:** Aşağıdakilere erişmek için Verdent üst çubuğundaki **Settings** düğmesine tıklayın: - **Rules** - User Rules, Project Rules, Plan Rules - **MCP Servers** - Model Context Protocol yapılandırmaları - **Subagents** - Özel alt aracı yönetimi **Sohbet içi kontroller:** Birçok ayar, Verdent panelinin altındaki Input Box'tan doğrudan değiştirilebilir: - **Switch Permission** - Manual Accept, Auto-Run, Plan, Skip Permissions - **Switch Mode** - Agent, Plan, Chat modları - **Switch/Customize AI Model** - Performance, Balance, Efficiency ön ayarları - **Think Hard Mode** - Karmaşık akıl yürütme için maksimum düşünme bütçesi - **Add Context** - @-bahsetmeleriyle dosya ekleme - **Add Images or Files** - Ekran görüntüsü veya belge ekleme - **Add Subagent** - Özel alt aracılara devretme Ayar değişiklikleri, VS Code'ün yeniden başlatılmasını gerektirmeden anında etkili olur. --- ## Mevcut uzantı ayarları Verdent for VS Code, VS Code'in ayarlar arayüzü üzerinden yapılandırılabilen **2 temel uzantı ayarı** sunar: | Ayar | Tür | Varsayılan | Açıklama | | --------------------------- | --------- | ------- | -------------------------------------------------------------------------------------------------------------------------- | | `verdent.enableCheckpoints` | `boolean` | `true` | Uzantının görevler boyunca çalışma alanının kontrol noktalarını git kullanarak kaydetmesini sağlar. Büyük çalışma alanlarında performansı etkileyebilir. | | `verdent.enableProxy` | `boolean` | `true` | Ağ bağlantıları için proxy desteğini etkinleştirir. Kurumsal güvenlik duvarları veya proxy sunucuları arkasındaki kullanıcılar için gereklidir. | Bunlar Verdent için VS Code uzantı ayarlarının tamamıdır. Ek yapılandırma seçenekleri (Rules, Subagents, MCP Servers) uzantının üst çubuğundaki Verdent Settings menüsü üzerinden yönetilir. --- ## Input Box kontrolleri referansı Verdent panelinin altındaki Input Box, yapılandırma kontrollerine hızlı erişim sağlar: | Kontrol | Amaç | Seçenekler | | ----------------------------- | ------------------------------------- | ------------------------------------------------------------------ | | **Add Context** | @-bahsetmeleriyle dosya ekleme | @dosyaadı, @klasöradı | | **Add Images or Files** | Ekran görüntüsü veya belge ekleme | Görsel, PDF, metin dosyası yükleme | | **Add Subagent** | Özel aracılara devretme | @Verifier, @Explorer, @Code-reviewer, özel alt aracılar | | **Switch Mode** | Yürütme modunu değiştirme | Agent Mode, Plan Mode, Chat Mode | | **Switch/Customize AI Model** | Model ön ayarı veya belirli model seçme | Performance (1-2x maliyet), Balance (1x maliyet), Efficiency (0.3x maliyet) | | **Think Hard Mode** | Genişletilmiş akıl yürütmeyi etkinleştirme | Karmaşık sorunlar için aç/kapat | | **Switch Permission** | İzin düzeyini değiştirme | Manual Accept (varsayılan), Auto-Run, Plan, Skip Permissions | ### İzin modları - Her işlem onay gerektirir - Tam görünürlük ve kontrol - Öğrenme, tanımadığınız kod tabanları, üretim kodu için idealdir - Komutlar onay gerektirir, dosya işlemleri otomatiktir - Daha az izin istemi - Güvenilir projeler, hızlı prototipleme için idealdir - Salt okunur analiz ve planlama - Planlama sırasında kod değişikliği yok - Karmaşık değişiklikler, mimari kararlar için idealdir - Onay istemleri olmadan tam özerklik - En hızlı yürütme ama en yüksek risk - Otomatik ortamlar, CI/CD için idealdir ### Model ön ayarları - **Maliyet:** 1x temel - **Modeller:** Claude-4.5-sonnet - **İdeal kullanım:** Genel geliştirme, günlük kodlama, özellik uygulama - **Maliyet:** Balance temelinin 1-2 katı - **Modeller:** Claude-4.5-sonnet-1m (1M token bağlam) - **İdeal kullanım:** Karmaşık mimari, büyük kod tabanları, 200k token'ı aşan görevler - **Maliyet:** Sonnet'ten 3,2 kat daha verimli (%70 kredi tasarrufu) - **Modeller:** Claude-4.5-haiku - **İdeal kullanım:** Hızlı düzeltmeler, basit görevler, rutin işlemler --- ## Klavye kısayolu özelleştirme ### Varsayılan kısayollar **Birincil kısayol:** - **macOS:** `Cmd+L` - Verdent panelini aç/odakla - **Windows/Linux:** `Ctrl+L` - Verdent panelini aç/odakla - Komut: `verdent.addToChat` - Command Palette ve Editor Context üzerinden çalışır Bu, kodlama akışınızı kesintiye uğratmadan VS Code içinde herhangi bir yerden Verdent'e hızlıca erişmek için temel kısayoldur. **Ek komutlar:** Command Palette üzerinden kullanılabilir (varsayılan kısayollar özelleştirilebilir): - `verdent.addFeedBack` - Geri bildirim sağlama - `verdent.addTerminalOutputToChat` - Terminal çıktısını Verdent'e ekleme - `verdent.addToChatBySearch` - Aramayla Verdent'e ekleme - `verdent.centerButtonClicked` - User Center - `verdent.historyButtonClicked` - Project History - `verdent.mcpButtonClicked` - MCP Server ekleme - `verdent.openInNewTabByParams` - Yeni sekmede açma - `verdent.plusButtonClicked` - New Session - `verdent.rulesButtonClicked` - Rules Settings - `verdent.SettingClicked` - Settings Menu - `verdent.subagentButtonClicked` - Add Subagent ### Kısayolları özelleştirme Tüm Verdent klavye kısayolları, VS Code'in standart tuş atama sistemi kullanılarak özelleştirilebilir. Çoğu kullanıcı için önerilir - kısayolları yönetmek için görsel arayüz. `Cmd+K Cmd+S` (macOS) veya `Ctrl+K Ctrl+S` (Windows/Linux) tuşlarına basın Verdent komutlarını filtrelemek için arama kutusuna "Verdent" yazın Herhangi bir komutun yanındaki kalem simgesine tıklayın, istediğiniz tuş kombinasyonuna basın ve kaydetmek için Enter'a basın Gelişmiş kullanıcılar için - doğrudan JSON yapılandırması, sürüm kontrolüne uygun. `Cmd+Shift+P` (macOS) veya `Ctrl+Shift+P` (Windows/Linux) tuşlarına basın "Preferences: Open Keyboard Shortcuts (JSON)" yazın ve seçin ```json macOS { "key": "cmd+shift+v", "command": "verdent.addToChat" } ``` ```json Windows/Linux { "key": "ctrl+shift+v", "command": "verdent.addToChat" } ``` **Özelleştirme kapsamı:** - Tüm Verdent komutları yeniden atanabilir - Aynı komuta birden fazla kısayol atanabilir - Varsayılan kısayollar kaldırılabilir - Değişiklikler VS Code Settings Sync ile makineler arasında senkronize edilir ### Platforma özel kısayollar Verdent, VS Code'in platforma özel klavye kurallarını izler: | Platform | Değiştirici tuş düzeni | | ----------------- | --------------------------------------------------- | | **macOS** | birincil kısayollar için `Cmd`, alternatif için `Option` | | **Windows/Linux** | birincil kısayollar için `Ctrl`, alternatif için `Alt` | **Yaygın düzenler:** - Ayarlar: `Cmd+,` (macOS) - `Ctrl+,` (Windows/Linux) - Command Palette: `Cmd+Shift+P` (macOS) - `Ctrl+Shift+P` (Windows/Linux) - Klavye kısayolları: `Cmd+K Cmd+S` (macOS) - `Ctrl+K Ctrl+S` (Windows/Linux) --- ## Özel talimatlar ve kişilikler Verdent for VS Code, yapay zeka davranışını özelleştirmek için iki sistemi destekler: tercihler ve yönergeler için **Rules** ve özel görev kişilikleri için **Subagents**. ### Rules sistemi Rules, Verdent'in kodlama oturumları sırasında nasıl davrandığını ve yanıt verdiğini tanımlar. Rules, Markdown dosyalarında saklanır ve konuşmalar boyunca sürekli uygulanır. #### Üç tür kural **1. User Rules (VERDENT.md):** - **Konum:** `~/.verdent/` (global yapılandırma dizini) - **Kapsam:** Tüm projelerdeki tüm konuşmalara uygulanır - **Amaç:** Kişisel kodlama tercihleri, iletişim tarzı, dokümantasyon standartları **2. Project Rules (AGENTS.md):** - **Konum:** Proje kök dizini veya çalışma alanı - **Kapsam:** Yalnızca mevcut projeye uygulanır - **Sürüm kontrolü:** Ekip genelinde standartlar için git'e işlenebilir - **Amaç:** Projeye özel kodlama standartları, mimari kalıplar, test gereksinimleri **3. Plan Rules (plan_rules.md):** - **Konum:** `~/.verdent/` (global yapılandırma dizini) - **Kapsam:** Tüm projelerde Plan Mode kullanılırken uygulanır - **Amaç:** Plan içeriğini, biçimini ve ayrıntı düzeyini özelleştirme #### Kural oluşturma ve düzenleme Verdent üst çubuğundaki **Settings** düğmesine tıklayın ve açılır menüden **Rules**'u seçin İhtiyacınıza göre **User Rules**, **Project Rules** veya **Plan Rules** seçin Kural dosyaları VS Code düzenleyicisinde açılır. Açık, yönlendirici talimatlar yazmak için Markdown biçimlendirmesini kullanın Dosyayı kaydedin. Kurallar mevcut ve gelecekteki oturumlarda anında uygulanır - yeniden başlatma gerekmez **Örnek User Rules:** ```markdown # Code Style Preferences - Always use functional React components with hooks - Prefer TypeScript over JavaScript - Add JSDoc comments for all exported functions - Provide explanations before showing code ``` **Örnek Project Rules:** ```markdown ## Testing instructions - Run `pnpm turbo run test --filter ` to run all checks - Fix test and type errors until suite is green - Add or update tests for code changes ## PR instructions - Title format: [] - Always run `pnpm lint` and `pnpm test` before committing ``` #### Kural depolama ve uygulama | Kural türü | Konum | Kapsam | Sürüm kontrolü | | ------------- | -------------------------- | ------------------------ | ------------------------------------- | | User Rules | `~/.verdent/VERDENT.md` | Tüm projeler | Kişisel, paylaşılmaz | | Project Rules | `<project>/AGENTS.md` | Mevcut proje | Ekip tutarlılığı için işlenebilir | | Plan Rules | `~/.verdent/plan_rules.md` | Tüm projeler (Plan Mode) | Kişisel, paylaşılmaz | **Yapılandırma önceliği:** Kurallar çakıştığında Verdent şu öncelik sırasını uygular: 1. **Project Rules (AGENTS.md)** - En yüksek öncelik (projeye özel) 2. **User Rules (VERDENT.md)** - Global kullanıcı tercihleri 3. **Varsayılan davranış** - Verdent'in yerleşik varsayılanları <Tip> Projeye özel kodlama standartlarını tüm ekibinizle paylaşmak için AGENTS.md'yi sürüm kontrolüne işleyin. Her ekip üyesinin çalışma alanı, VERDENT.md aracılığıyla bireysel tercihlerini korurken otomatik olarak proje kurallarını izler. </Tip> --- ## Subagents Subagents, belirli görevleri ele almak için özel sistem istemlerine ve izole bağlam pencerelerine sahip özel yapay zeka aracılarıdır. ### Yerleşik alt aracılar Verdent, yapılandırma gerektirmeden hemen kullanılabilen üç varsayılan alt aracı içerir: <Tabs> <Tab title="@Verifier"> - Hızlı kod kontrolleri ve doğrulama - Tam inceleme olmadan hızlı doğrulama - Kullanım: Hızlı tutarlılık kontrolleri, sözdizimi doğrulaması, commit öncesi kontroller </Tab> <Tab title="@Explorer"> - Hızlı kod tabanı keşfi ve gezinme - Dosyaları hızlıca bulur ve kod tabanı sorularını yanıtlar - Kullanım: Tanımadığınız kod tabanlarını keşfetme, bileşen bulma, yapıyı anlama </Tab> <Tab title="@Code-reviewer"> - Anında kod kalitesi değerlendirmesi - Güvenlik, sürdürülebilirlik ve performanstaki sorunları belirler - Kullanım: Commit öncesi incelemeler, güvenlik denetimleri, performans optimizasyonu </Tab> </Tabs> ### Özel alt aracılar oluşturma <Steps> <Step title="Subagent Settings'e erişin"> Verdent üst çubuğunda **Settings** → **Subagents**'a tıklayın </Step> <Step title="Yeni alt aracı oluşturun"> Yeni bir alt aracı oluşturun veya `~/.verdent/subagents/` dizinine giderek YAML frontmatter içeren bir markdown dosyası oluşturun </Step> <Step title="Alt aracı davranışını tanımlayın"> Alt aracının kişiliğini, yorumlama tarzını ve görevlere yaklaşımını belirleyen bir sistem istemi yazın </Step> <Step title="Çağrı politikasını belirtin"> Alt aracının ne zaman kullanılması gerektiğini tanımlayın (katı veya esnek çağrı) </Step> </Steps> **Alt aracı dosya biçimi:** ```markdown --- name: security-reviewer description: Security-focused code review specialist --- # System Prompt You are a security-focused code reviewer. When analyzing code: - Prioritize security vulnerabilities (SQL injection, XSS, auth flaws) - Use skeptical, critical tone - assume code is vulnerable until proven otherwise - Provide specific remediation steps with code examples - Reference OWASP Top 10 and security best practices - Never approve code with unresolved security issues Invocation policy (strict): Only run security-reviewer if user explicitly requests it. When to use the security-reviewer agent: - User requests security review of authentication/authorization logic - User asks to audit code for vulnerabilities - User needs security assessment before deployment When NOT to use: - General code review without security focus - Opening or reading files without analysis ``` ### Alt aracıları yönetme Aşağıdakiler için **Settings → Subagents** üzerinden erişin: - **Edit:** Sistem istemlerini, araç izinlerini, yapılandırmaları değiştirme - **Copy:** Varyasyonlar veya şablonlar için alt aracıları çoğaltma - **Delete:** Kullanılmayan alt aracıları kaldırma - **Enable/Disable:** Silmeden kullanılabilirliği değiştirme ### Alt aracıları kullanma **Yerleşik alt aracılar:** - @-bahsetmeleriyle referans verin: `@Verifier`, `@Explorer`, `@Code-reviewer` - Uygun görev türleri algılandığında otomatik olarak çağrılır **Özel alt aracılar:** - Input Box'taki **Add Subagent** düğmesine tıklayın - Açılır menüden seçin - Ana aracı uygun görevleri otomatik olarak devreder ### Subagent ile Rules karşılaştırması | Yön | Rules | Subagents | | ---------------- | ---------------------------- | --------------------------------- | | **Ne zaman uygulanır** | Sürekli, her yanıtta | Belirli görevler için talep üzerine | | **Bağlam** | Paylaşılan ana bağlam penceresi | İzole edilmiş ayrı bağlam | | **Davranış** | Tercihler ve yönergeler | Göreve özel davranışsal kişilikler | | **Çağrı** | Her zaman aktif | Otomatik veya manuel devretme | | **Amaç** | NEYİ tercih ettiğinizi tanımlar | Görevleri KİMİN ve NASIL ele aldığını tanımlar | **Örnek iş akışı:** 1. **User Rule:** "Tüm yeni fonksiyonlar için birim testleri oluştur" 2. **Ana aracı:** Test oluşturma ihtiyacını algılar 3. **Test Generator alt aracısına devreder:** Özel kapsamlı test yaklaşımı 4. **Alt aracı:** İzole bağlamla eksiksiz test paketi oluşturur 5. **Ana aracı:** Sonuçları alır ve bağlam kirliliği olmadan devam eder <Tip> Alt aracıları ekip üyeleriyle paylaşmak için Settings → Subagents'taki **Copy** düğmesini kullanın veya alt aracı markdown dosyalarını doğrudan `~/.verdent/subagents/` dizininden paylaşın. </Tip> --- ## SSS (Sıkça sorulan sorular) <Accordion title="Yapılandırma değişiklikleri ne zaman etkili olur?"> Çoğu Verdent ayarı yeniden başlatma gerektirmeden anında uygulanır: - **İzin modları:** Input Box üzerinden anında değiştirin - **Model ön ayarları:** Bir sonraki isteğe uygulanır - **Kural dosyaları:** Yeni konuşmalara uygulanır (kaydetme yeniden yüklemeyi tetikler) - **Subagents:** Oluşturulduktan hemen sonra kullanılabilir - **Klavye kısayolları:** VS Code içinde kaydedildikten sonra uygulanır **İstisna:** VS Code uzantı ayarları (`verdent.enableCheckpoints` gibi) anında etkili olur ancak tam uygulama için dosyaların veya oturumların yeniden açılmasını gerektirebilir. </Accordion> <Accordion title="Rules ile Subagents arasındaki fark nedir?"> **Rules**, global olarak NEYİ tercih ettiğinizi tanımlar: - Tüm konuşmalara sürekli uygulama - Kodlama standartları, iletişim tarzı, tercihler - Markdown dosyalarında saklanır (VERDENT.md, AGENTS.md, plan_rules.md) - Arka planda her zaman aktif **Subagents**, belirli görevleri KİMİN ve NASIL ele aldığını tanımlar: - Belirli görev türleri için talep üzerine çağrı - Özel sistem istemlerine sahip özel davranışsal kişilikler - İzole bağlam pencereleri (ana bağlamı kirletmez) - Otomatik olarak veya @-bahsetmeleriyle manuel olarak devredilir **Örnek:** Bir kural "Yeni fonksiyonlar için birim testleri oluştur" der. Bir Test Generator alt aracısı, kapsamlı test metodolojisiyle gerçek test oluşturmayı ele alır. </Accordion> <Accordion title="Aynı anda birden fazla izin modu kullanabilir miyim?"> Hayır, izin modları birbirini dışlar - aynı anda yalnızca BİRİNİ kullanabilirsiniz: - **Manual Accept** - Varsayılan, maksimum kontrol - **Auto-Run** - Güvenilir projeler için akıcı - **Plan** - Salt okunur planlama modu - **Skip Permissions** - Tam özerklik Input Box'taki **Switch Permission** düğmesi üzerinden modları anında değiştirebilirsiniz. Çoğu kullanıcı görev bağlamına göre modlar arasında geçiş yapar (örneğin karmaşık özellikler için Plan Mode, hızlı düzeltmeler için Auto-Run). </Accordion> <Accordion title="Görevim için doğru model ön ayarını nasıl seçerim?"> Model ön ayarını görev karmaşıklığına ve bütçeye göre eşleştirin: **Efficiency kullanın (Sonnet'ten 3,2 kat daha verimli):** - Hızlı hata düzeltmeleri ve basit kod üretimi - Rutin işlemler ve yüksek frekanslı görevler - Hızın derinlikten daha önemli olduğu durumlar **Balance kullanın (1x temel) - Varsayılan:** - Genel geliştirme ve günlük kodlama - Özellik uygulama ve kod incelemeleri - Çoğu senaryo için dengeli performans **Performance kullanın (0,5x verimlilik, 2x maliyet):** - Karmaşık mimari kararlar - Kapsamlı bağlam gerektiren büyük kod tabanları (200k+ token) - Karmaşık hata ayıklama ve yeniden düzenleme **Profesyonel ipucu:** Çoğu kullanıcı Balance'ı varsayılan olarak tutar ve yalnızca bağlam sınırlarına ulaştığında veya derin akıl yürütmeye ihtiyaç duyduğunda Performance'a geçer. </Accordion> --- ## Ayrıca bakınız <CardGroup cols={2}> <Card title="Plan öncelikli iş akışları" icon="sitemap" href="/docs/verdent-for-vscode/configuration/plan-workflows"> Yapay zeka destekli görev planlama ve onay iş akışlarını yapılandırın </Card> <Card title="Yapılandırma optimizasyonu" icon="sliders" href="/docs/verdent-for-vscode/configuration/tuning"> Hız, maliyet ve performans optimizasyonu için ayarları ince ayarlayın </Card> </CardGroup>