Verdent Docs
Yapılandırma

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+, 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:

AyarTürVarsayılanAçıklama
verdent.enableCheckpointsbooleantrueUzantı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.enableProxybooleantrueAğ 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:

KontrolAmaçSeçenekler
Add Context@-bahsetmeleriyle dosya ekleme@dosyaadı, @klasöradı
Add Images or FilesEkran görüntüsü veya belge eklemeGörsel, PDF, metin dosyası yükleme
Add SubagentÖzel aracılara devretme@Verifier, @Explorer, @Code-reviewer, özel alt aracılar
Switch ModeYürütme modunu değiştirmeAgent Mode, Plan Mode, Chat Mode
Switch/Customize AI ModelModel ön ayarı veya belirli model seçmePerformance (1-2x maliyet), Balance (1x maliyet), Efficiency (0.3x maliyet)
Think Hard ModeGenişletilmiş akıl yürütmeyi etkinleştirmeKarmaşık sorunlar için aç/kapat
Switch Permissionİzin düzeyini değiştirmeManual 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.

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:

PlatformDeğiştirici tuş düzeni
macOSbirincil kısayollar için Cmd, alternatif için Option
Windows/Linuxbirincil 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 committing

Kural depolama ve uygulama

Kural türüKonumKapsamSürüm kontrolü
User Rules~/.verdent/VERDENT.mdTüm projelerKişisel, paylaşılmaz
Project Rules<project>/AGENTS.mdMevcut projeEkip tutarlılığı için işlenebilir
Plan Rules~/.verdent/plan_rules.mdTü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ı

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 SettingsSubagents'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 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önRulesSubagents
Ne zaman uygulanırSürekli, her yanıttaBelirli görevler için talep üzerine
BağlamPaylaşılan ana bağlam penceresiİzole edilmiş ayrı bağlam
DavranışTercihler ve yönergelerGöreve özel davranışsal kişilikler
ÇağrıHer zaman aktifOtomatik veya manuel devretme
AmaçNEYİ tercih ettiğinizi tanımlarGö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

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.


Ayrıca bakınız