Yapılandırma ve özelleştirme
İş 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+,veyaCtrl+,) - 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):
- VS Code Ayarları'nı açın:
Cmd+,(macOS) veyaCtrl+,(Windows/Linux) - Ayarlar arama çubuğunda "Verdent" aratın
- 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
- Komut:
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ğlamaverdent.addTerminalOutputToChat- Terminal çıktısını Verdent'e eklemeverdent.addToChatBySearch- Aramayla Verdent'e eklemeverdent.centerButtonClicked- User Centerverdent.historyButtonClicked- Project Historyverdent.mcpButtonClicked- MCP Server eklemeverdent.openInNewTabByParams- Yeni sekmede açmaverdent.plusButtonClicked- New Sessionverdent.rulesButtonClicked- Rules Settingsverdent.SettingClicked- Settings Menuverdent.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.
Klavye kısayollarını açın
Cmd+K Cmd+S (macOS) veya Ctrl+K Ctrl+S (Windows/Linux) tuşlarına basın
Verdent araması yapın
Verdent komutlarını filtrelemek için arama kutusuna "Verdent" yazın
Kısayolu düzenleyin
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.
Command Palette'i açın
Cmd+Shift+P (macOS) veya Ctrl+Shift+P (Windows/Linux) tuşlarına basın
Keybindings JSON'ı açın
"Preferences: Open Keyboard Shortcuts (JSON)" yazın ve seçin
Özel tuş atamasını ekleyin
{
"key": "cmd+shift+v",
"command": "verdent.addToChat"
}{
"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
Rules Settings'e erişin
Verdent üst çubuğundaki Settings düğmesine tıklayın ve açılır menüden Rules'u seçin
Kural türünü seçin
İhtiyacınıza göre User Rules, Project Rules veya Plan Rules seçin
Markdown'da düzenleyin
Kural dosyaları VS Code düzenleyicisinde açılır. Açık, yönlendirici talimatlar yazmak için Markdown biçimlendirmesini kullanın
Kaydedin ve uygulayın
Dosyayı kaydedin. Kurallar mevcut ve gelecekteki oturumlarda anında uygulanır - yeniden başlatma gerekmez
Örnek User Rules:
# 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:
## Testing instructions
- Run `pnpm turbo run test --filter <project_name>` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes
## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committingKural 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:
- Project Rules (AGENTS.md) - En yüksek öncelik (projeye özel)
- User Rules (VERDENT.md) - Global kullanıcı tercihleri
- Varsayılan davranış - Verdent'in yerleşik varsayılanları
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.
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:
- 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
- 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
- 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
Özel alt aracılar oluşturma
Subagent Settings'e erişin
Verdent üst çubuğunda Settings → Subagents'a tıklayın
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
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
Çağrı politikasını belirtin
Alt aracının ne zaman kullanılması gerektiğini tanımlayın (katı veya esnek çağrı)
Alt aracı dosya biçimi:
---
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 analysisAlt 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ışı:
- User Rule: "Tüm yeni fonksiyonlar için birim testleri oluştur"
- Ana aracı: Test oluşturma ihtiyacını algılar
- Test Generator alt aracısına devreder: Özel kapsamlı test yaklaşımı
- Alt aracı: İzole bağlamla eksiksiz test paketi oluşturur
- Ana aracı: Sonuçları alır ve bağlam kirliliği olmadan devam eder
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.
SSS (Sıkça sorulan sorular)
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.
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.
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).
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.