---
title: Sık sorulan sorular
description: Verdent for VS Code hakkında sık sorulan sorular
---



Verdent'in özellikleri, yetenekleri ve kullanımıyla ilgili sık sorulan soruların yanıtları.

---

## Başlangıç

<Tip>
Gelişmiş özelliklere geçmeden önce Hızlı Başlangıç kılavuzunu tamamlayın; bu kılavuz, dokümanlar boyunca karşınıza çıkan temel kavramları kapsar.
</Tip>

---

## Sık karşılaşılan sorunlar (ilk 4)

<Accordion title="Verdent for VS Code'da neden oturum açamıyorum?">
**En yaygın neden:** Proxy yapılandırması sorunu

**Çözüm:**
1. VS Code Ayarları'nı açın (macOS'ta `Cmd+,` veya Windows/Linux'ta `Ctrl+,`)
2. "useProxy" veya "verdent.enableProxy" araması yapın
3. Proxy ayarını açıp kapatın (mevcut durumunun tersi)
4. Tekrar oturum açmayı deneyin

**Açıklama:** Kurumsal bir güvenlik duvarının arkasındaysanız proxy ayarını etkinleştirmeniz gerekebilir. Ev ağındaysanız devre dışı bırakmayı deneyin.
</Accordion>

<Accordion title="Ücretsiz deneme kredilerimi neden almadım?">
**Hata:** Ücretsiz deneme kredileri alınamadı veya ücretsiz deneme erişimi reddedildi

**Neden:** Kayıt sırasında bir hizmet şartları ihlali tespit edildi

**Çözüm:** Ücretsiz deneme erişiminizle ilgili yardım için support@verdent.ai ile iletişime geçin. Destek ekibi hesabınızı inceleyip sorunu çözmenize yardımcı olacaktır.
</Accordion>

<Accordion title="Kaydım neden başarısız oldu?">
**Hata:** Hesap kaydı reddedildi veya kısıtlandı

**Neden:** Kayıt, Verdent'in hizmet şartlarını ihlal etti ve bu da erişim kısıtlamasına yol açtı

**Çözüm:** Yardım için support@verdent.ai ile iletişime geçin. Destek ekibi kaydınızı inceleyip sorunu çözmenize ilişkin yönlendirme sağlayabilir.
</Accordion>

<Accordion title="Claude, GPT veya Gemini modellerini neden bulamıyorum?">
**Sorun:** Model seçim menüsünde belirli yapay zeka modellerini bulamıyorsunuz

**Neden:** Model sağlayıcılarının konuma dayalı kısıtlamaları

**Açıklama:** Bazı yapay zeka modeli sağlayıcılarının (Anthropic, OpenAI, Google) bölgesel kısıtlamaları vardır ve belirli modellerin belirli coğrafi konumlarda kullanılmasını engeller. Böyle bir durumda:
- Kısıtlanan modeller model seçim menünüzde görünmez
- Mevcut diğer tüm modelleri kesintisiz kullanmaya devam edebilirsiniz
- Aboneliğinize veya kredilerinize hiçbir etkisi olmaz

**Mevcut modelleri kontrol edin:** Bölgenizde hangi modellerin kullanılabilir olduğunu görmek için https://www.verdent.ai/regions adresini ziyaret edin

**Not:** Bölgesel kısıtlamalar Verdent tarafından değil, yapay zeka modeli sağlayıcıları tarafından belirlenir. Verdent bu kısıtlamaları geçersiz kılamaz.
</Accordion>

---

<Accordion title="Visual Studio Code nedir?">
Visual Studio Code, Microsoft tarafından geliştirilen ücretsiz, açık kaynaklı bir kod düzenleyicidir. Birden fazla programlama dilini destekleyen, hafif ama güçlü bir geliştirme ortamıdır ve hata ayıklama, sözdizimi vurgulama, akıllı kod tamamlama ve entegre sürüm kontrolü gibi özellikler sunar. Verdent, doğrudan Visual Studio Code'a bir uzantı olarak entegre olur ve mevcut iş akışınıza yapay zeka destekli kodlama yetenekleri ekler.
</Accordion>

<Accordion title="Verdent for VS Code nedir?">
Verdent, doğal dil sohbetleri aracılığıyla kod üretimi, yeniden düzenleme, hata ayıklama ve proje gezintisinde yardımcı olan, Visual Studio Code için bir yapay zeka kodlama asistanı uzantısıdır.

**Temel yetenekler:**
- Dosya araçları aracılığıyla kod üretimi ve değişikliği
- Özel alt aracılarla kod tabanı keşfi
- Bash entegrasyonu aracılığıyla komut yürütme
- Kurallar ve MCP sunucuları aracılığıyla özel genişletilebilirlik
</Accordion>

<Accordion title="Sistem gereksinimleri nelerdir?">
**Minimum gereksinimler:**
- Visual Studio Code 1.90.0 veya üzeri
- Etkin Verdent aboneliği
- İnternet bağlantısı

**Platform desteği:** macOS, Windows, Linux, WSL
</Accordion>

<Accordion title="Kurulumdan sonra Verdent'i kullanmaya nasıl başlarım?">
1. Verdent uzantısını VS Code marketplace'ten kurun
2. İstendiğinde Verdent hesabınızla oturum açın
3. Herhangi bir kod dosyası veya proje açın
4. Chat View'ı açın ve Verdent ile konuşmaya başlayın

**İlk görev önerisi:** Verdent'ten proje yapınızı açıklamasını veya belirli bir dosyayı incelemesini isteyin.
</Accordion>

<Accordion title="Visual Studio Code sürümümü nasıl kontrol ederim?">
Visual Studio Code'u açın ve **Help** → **About** seçeneğine gidin (macOS'ta **Code** → **About Visual Studio Code**). Sürüm numarası iletişim kutusunda görüntülenir. Verdent, Visual Studio Code 1.90.0 veya üzeri sürümü gerektirir.

Komut satırı üzerinden de kontrol edebilirsiniz:
```bash
code --version
```
</Accordion>

<Accordion title="Krediler nedir?">
Verdent ürünleri genelinde kredilerin ortak tanımı, fiyatlandırma kademeleri ve kullanımının temelleri için [Krediler ve planlar](/docs/account-billing/credits-and-plans) sayfasına bakın.
</Accordion>

<Accordion title="Kredilerim biterse ne olur?">
Ortak hesap politikası ve kurtarma seçenekleri için [Kredileriniz biterse ne olur](/docs/account-billing/run-out-of-credits) sayfasına bakın.
</Accordion>

<Accordion title="Verdent resimlerimi harici sunuculara yükler mi?">
Pano aracılığıyla yapıştırılan veya dosya yoluyla referans verilen resimler, sohbet oturumunuz içinde işlenir. Resimler kalıcı olarak saklanmaz ve yeni bir sohbet başlattığınızda temizlenir. Dosya yolu referansları, resmi yüklemeden yerel olarak okur.
</Accordion>

<Accordion title="Plan Mode nedir?">
Plan Mode, Verdent'in dosyaları değiştirmeden veya komut yürütmeden kodu analiz ettiği, araştırma yaptığı ve ayrıntılı uygulama planları oluşturduğu salt okunur bir yürütme modudur. Bir plan oluşturduktan sonra Verdent iki seçenek sunar: **Edit** (değişiklik talep edip planı iyileştirmek için) veya **Start Building** (Agent Mode'a geçip yürütmeye başlamak için). Aracı, yürütmeden önce belirsizliği ortadan kaldırmak için açıklayıcı sorular sorabilir. Bu mod, değişikliklere geçmeden önce yaklaşımı gözden geçirmek istediğiniz karmaşık görevler için idealdir ve beklentilerinizle Verdent'in önerdiği çözüm arasında uyum sağlar.
</Accordion>

<Accordion title="Plan Mode dosyalarıma gerçekten kod yazar mı?">
**Hayır.** Plan Mode kesinlikle salt okunurdur:

- Verdent dosyaları okuyabilir, kod arayabilir ve kod tabanınızı analiz edebilir
- Plan Mode sırasında **hiçbir dosya yazma, düzenleme veya silme işlemi** gerçekleşmez
- Planlar yalnızca Chat View'da görüntülenir
- Kod yürütme yalnızca siz açıkça onayladıktan ve Agent Mode'a geçtikten sonra başlar

**Güvenlik garantisi:** Plan Mode kodunuzu yanlışlıkla değiştiremez. Güvenli keşif ve strateji geliştirme için tasarlanmıştır.
</Accordion>

<Accordion title="Plan Mode ile Agent Mode arasında nasıl geçiş yaparım?">
**Geçiş, Input Box aracılığıyla anlıktır:**

**Plan Mode'a girmek için:**
- Input Box'ta **Switch Mode** düğmesine tıklayın
- Açılır menüden **Plan Mode**'u seçin
- VEYA "Switch to Plan Mode" deyin

**Plan Mode'dan çıkmak için:**
- Input Box'ta **Switch Mode** düğmesine tıklayın
- Açılır menüden **Agent Mode**'u seçin
- VEYA bir planı inceledikten sonra **Start Building**'i seçin

**Mod kalıcılığı:**
- Mod seçimi mevcut oturum içinde korunur
- Yeni oturumlar varsayılan Agent Mode'da başlar
- İstediğiniz zaman serbestçe mod değiştirebilirsiniz

**Tipik iş akışı:** Plan Mode → inceleme → Agent Mode → yürütme → bir sonraki karmaşık özellik için tekrar Plan Mode.
</Accordion>

<Accordion title="Temiz bir bağlamla yeni bir sohbeti nasıl başlatırım?">
Üst çubuktaki "New Session" düğmesine tıklayın. Bu, mevcut sohbet geçmişini temizler ve Verdent'e bir sonraki göreviniz için temiz bir bağlam penceresi sağlar.
</Accordion>

<Accordion title="Verdent'i aynı anda birden fazla projede kullanabilir miyim?">
Evet, her VS Code penceresi bağımsız çalışır. Verdent'i birden fazla projede açık tutabilirsiniz ve her biri kendi ayrı sohbet bağlamını korur.
</Accordion>

<Accordion title="Verdent; GitHub, GitLab, Bitbucket ve diğer Git platformlarıyla çalışır mı?">
Evet. Verdent standart Git komutlarını kullanır, bu nedenle barındırma platformundan bağımsız olarak herhangi bir Git deposuyla çalışır. Pull request oluşturmak için Verdent, GitHub gerektiren `gh` CLI'ını kullanır, ancak diğer tüm Git işlemleri evrensel olarak çalışır.
</Accordion>

---

## Araçlar ve yetenekler

<Accordion title="Verdent hangi dosya formatlarıyla çalışabilir?">
**Desteklenenler:** Aşağıdakiler dahil tüm metin tabanlı dosya formatları:
- Kaynak kod (JavaScript, Python, TypeScript, Java, Go vb.)
- Yapılandırma dosyaları (JSON, YAML, TOML, XML, ENV)
- Dokümantasyon (Markdown, HTML, LaTeX)
- Derleme dosyaları (package.json, Makefile, requirements.txt)

**Desteklenmeyenler:** İkili dosyalar (resimler, videolar, PDF'ler, derlenmiş ikili dosyalar, Office belgeleri)

**Geçici çözüm:** İkili dosyalara kodda referans verilebilir ancak değişiklikler için harici araçlar gerekir.
</Accordion>

<Accordion title="Verdent en iyi hangi programlama dillerini destekler?">
**Mükemmel destek:**
- JavaScript, TypeScript, Python, React, Vue, Angular
- Node.js, Go, Java/Spring, C#/.NET
- Swift, Kotlin, Flutter

**Çok iyi destek:** Rust, C/C++, Ruby, R

**İyi destek:** PHP, Assembly, Julia

Yaygın diller, kapsamlı eğitim verileri sayesinde daha güçlü desteğe sahiptir.
</Accordion>

<Accordion title="Verdent dosyaları nasıl okur ve değiştirir?">
Üç dosya işlemi aracı:
- **file_read:** Tam dosyaları veya belirli satır aralıklarını okur
- **file_edit:** Belirli metin kalıplarını değiştirir (hedefli değişiklikler)
- **file_write:** Yeni dosyalar oluşturur veya dosyaları tamamen yeniden yazar

**En iyi uygulama:** Değişiklikler için `file_edit`, yalnızca yeni dosyalar için `file_write` kullanın.
</Accordion>

<Accordion title="Komut yürütme nedir?">
Testleri çalıştırma, paket kurma veya derleme komutlarını yürütme gibi işlemler dahil, Verdent aracılığıyla terminal komutlarını veya kabuk betiklerini çalıştırmaktır. Komut yürütme, istenmeyen sistem değişikliklerini önlemek için çoğu İzin Modunda onay gerektirir.
</Accordion>

<Accordion title="Verdent terminalimde komut yürütebilir mi?">
Evet, `bash` aracını kullanarak. Verdent terminal komutlarını şunlarla çalıştırabilir:
- Maksimum zaman aşımı: 120 saniye (2 dakika)
- `&&` ile komut zincirleme
- Çapraz platform desteği (Unix'te bash, Windows'ta PowerShell)

**Güvenlik:** Komutlar sizin kullanıcı izinlerinizle yürütülür. Yürütmeden önce gözden geçirmek için Manual Accept Mode'u kullanın.
</Accordion>

<Accordion title="Bash komutları ne kadar süre çalışabilir?">
**Maksimum zaman aşımı:** 120 saniye (2 dakika)

2 dakikayı aşan komutlar otomatik olarak sonlandırılır. Daha uzun işlemler için şunları değerlendirin:

**Alternatifler:**
- Daha küçük komutlara bölün: `bash("task1") && bash("task2")`
- Daha küçük işlemlere bölün
- Arka planda çalıştırın ve sonuçları ayrı kontrol edin
</Accordion>

<Accordion title="Multipass Generate-Test-Repair Cycle nedir?">
Kodun kapsamlı testleri geçene kadar üretildiği, test edildiği ve onarıldığı yinelemeli bir doğrulama sürecidir. Verdent otomatik olarak testleri çalıştırır, hataları analiz eder, sorunları düzeltir ve kod doğru çalışana kadar birden fazla geçişte yeniden test eder. Bu, yalnızca öneriler değil, üretime hazır kod sunar. Her sonuç, tam olarak neyin değiştiğini gösteren ayrıntılı özetler ve kod farkları içerir.
</Accordion>

<Check>
Multipass test döngüleri, kod geçene kadar otomatik olarak kodu düzeltir ve yeniden test eder; Verdent üretime hazırlığı bu şekilde sağlar.
</Check>

---

## Alt aracılar ve yürütme

<Accordion title="Alt aracılar nedir ve ne zaman kullanmalıyım?">
Alt aracılar, belirli görevler için yalıtılmış bağlam pencerelerine sahip özelleşmiş yapay zeka aracılarıdır.

**Yerleşik alt aracılar:**
- **@Explorer:** Kod tabanı aramaları, mimari sorular
- **@Verifier:** Hızlı doğrulama kontrolleri
- **@Code-reviewer:** Güvenlik ve kalite incelemeleri

**Ne zaman kullanılır:** Ana sohbet bağlamından tasarruf etmek için araştırma, doğrulama veya inceleme görevlerini devredin.

**Özel alt aracılar nasıl oluşturulur:**

`~/.verdent/subagents/` içinde bir markdown dosyası oluşturun:

```markdown
---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]
```

**Kullanım senaryoları:** Alana özgü uzmanlık (finans, sağlık), ekip iş akışları, teknoloji uzmanları.
</Accordion>

<Accordion title="Bağlam kirliliği nedir?">
Bağlamdaki önceki eylemler ve bilgilerin, gelecekteki görevleri etkileyen istenmeyen davranış kalıpları oluşturmasıdır. Örneğin, kodu sürekli güncelleyip ardından dağıtıyorsanız, aracı yalnızca deneme yapıyor olsanız bile tüm kod güncellemelerini anında dağıtımla ilişkilendirmeye başlayabilir. Alt aracılar, yalıtılmış bağlam pencereleriyle çalışarak bağlam kirliliğini önler; her özelleşmiş görevin temiz bir bağlamla başlamasına olanak tanır ve farklı türdeki işler arasında çapraz kirlenmeyi engeller.
</Accordion>

<Accordion title="Şu anda hangi yürütme modunda olduğumu nasıl anlarım?">
Verdent panelinin altındaki giriş kutusuna bakın. "Switch Permission" düğmesi mevcut modunuzu gösterir (ör. "Manual", "Auto", "Plan"). Mod değiştirmek için tıklayabilirsiniz.
</Accordion>

<Accordion title="Auto-Run Mode ile Manual Accept Mode arasındaki fark nedir?">
**Auto-Run Mode:**
- Dosya işlemleri onay olmadan otomatik yürütülür
- Komutlar yine de izin gerektirir
- Güvenilir kod tabanları için daha hızlı iş akışı
- Sürüm kontrolü olan bireysel projeler için en iyisidir

**Manual Accept Mode:**
- Korumalı her işlemi gözden geçirip onaylayın
- Paylaşılan kod tabanları veya üretim için daha güvenlidir
- Yürütmeden önce tam olarak neyin çalışacağını görün

Ayarlar veya komut paleti aracılığıyla mod değiştirin.
</Accordion>

<Accordion title="Güvenli işlemler nedir?">
Değişiklik yapmadan yalnızca veri okuyan işlemler: dosya okumaları ve web aramaları. Bunlar Auto-Run Mode'da otomatik olarak onaylanırken, dosya düzenlemeleri ve komut yürütme güvenlik için yine de onay gerektirir.
</Accordion>

<Accordion title="Aynı anda birden fazla izin modu kullanabilir miyim?">
Hayır, izin modları birbirini dışlar; aynı anda yalnızca BİR tane 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 aracılığıyla anında mod değiştirebilirsiniz. Çoğu kullanıcı görev bağlamına göre modlar arasında geçiş yapar (ör. karmaşık özellikler için Plan Mode, hızlı düzeltmeler için Auto-Run).
</Accordion>

<Accordion title="Explorer aracını mı yoksa dosyaları doğrudan yüklemeyi mi kullanmalıyım?">
Ana bağlamı tüketmeden keşif ve arama görevleri için Explorer aracını kullanın. Dosyaları yalnızca değiştirmeniz gerektiğinde @-bahsetmeleriyle doğrudan yükleyin. Explorer, "şunları yapan tüm dosyaları bul..." soruları için idealdir; @-bahsetmeleri ise "bu belirli dosyayı güncelle" görevleri içindir.
</Accordion>

<Accordion title="Projem için özel alt aracılar oluşturabilir miyim?">
Evet! `~/.verdent/subagents/` içinde özel alt aracılar oluşturun:

```markdown
---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]
```

**Kullanım senaryoları:** Alana özgü uzmanlık (finans, sağlık), ekip iş akışları, teknoloji uzmanları.
</Accordion>

<Accordion title="Çok adımlı bir görevin ortasında Verdent'i durdurabilir miyim?">
Evet. Yürütmeyi istediğiniz zaman kesebilirsiniz. Verdent üzerinde çalıştığı mevcut adımı tamamlayıp ardından durur. O ana kadarki ilerleme korunur. Yapılanları gözden geçirebilir, ayarlamalar yapabilir ve ya devam edebilir ya da farklı bir yaklaşım seçebilirsiniz.
</Accordion>

<Accordion title="Uzun bir görevde Verdent'in şu anda ne yaptığını nasıl anlarım?">
Yapılacaklar listesini izleyin. Herhangi bir anda "devam ediyor" olarak işaretlenmiş bir öğeyle gerçek zamanlı durumu gösterir. Etkin öğe, Verdent'in şu anda tam olarak ne üzerinde çalıştığını gösterir. Tamamlanan öğeler bitti olarak işaretlenir ve bekleyen öğeler geriye kalanları gösterir.
</Accordion>

<Accordion title="Verdent değişikliklerimi otomatik olarak commit eder mi?">
Hayır. Verdent yalnızca siz açıkça istediğinizde commit oluşturur. Değişikliklerin ne zaman commit edileceği konusunda tam kontrol sizdedir. Hazır olduğunuzda "Tüm değişiklikleri hazırla ve bir commit oluştur" demeniz yeterlidir.
</Accordion>

<Accordion title="Verdent sormadan uzak depolara push eder mi?">
Hayır. Verdent uzak depolara yalnızca siz açıkça istediğinizde push eder. Tüm Git işlemleri (commit, push, merge, rebase) güvenlik için açık talimatınızı gerektirir.
</Accordion>

---

## Özelleştirme ve entegrasyon

<Accordion title="Verdent'in davranışını ekibim için nasıl özelleştiririm?">
Üç özelleştirme yöntemi:

1. **VERDENT.md:** Kişisel genel tercihler (`~/.verdent/VERDENT.md`)
2. **AGENTS.md:** Projeye özgü ekip standartları (proje kökü, sürüm kontrolü altında)
3. **plan_rules.md:** Plan Mode çıktı formatı (`~/.verdent/plan_rules.md`)

AGENTS.md, ekip tutarlılığı için VERDENT.md'yi geçersiz kılar.
</Accordion>

<Accordion title="Yapılandırma değişiklikleri ne zaman geçerli olur?">
Çoğu Verdent ayarı yeniden başlatma gerektirmeden hemen uygulanır:

- **İzin modları:** Input Box aracılığıyla anında geçiş
- **Model ön ayarları:** Bir sonraki istekte uygulanır
- **Kural dosyaları:** Yeni sohbetlere uygulanır (kaydetme yeniden yüklemeyi tetikler)
- **Alt aracılar:** Oluşturulduktan hemen sonra kullanılabilir
- **Klavye kısayolları:** VS Code'da kaydedildikten sonra uygulanır

**İstisna:** VS Code uzantı ayarları (örneğin `verdent.enableCheckpoints`) hemen geçerli olur ancak tam uygulama için dosyaları veya oturumları yeniden açmanız gerekebilir.
</Accordion>

<Accordion title="MCP nedir ve nasıl kullanılır?">
Model Context Protocol (MCP), Verdent'i harici araçlar ve hizmetlerle genişletir:

**Yapılandırma:** Settings → MCP Servers aracılığıyla `~/.verdent/mcp.json`

**Yetenekler:**
- Veritabanı bağlantıları (PostgreSQL, MySQL, MongoDB)
- Bulut hizmetleri (AWS, Azure, GCP)
- Proje yönetimi araçları (Jira, Linear)
- CI/CD pipeline'ları (Jenkins, GitHub Actions)

**Durum:** MCP entegrasyon dokümanları geliştirilme aşamasında. Kurulum yardımı için support@verdent.ai ile iletişime geçin.
</Accordion>

---

## En iyi uygulamalar ve performans

<Tip>
Tüketim kalıplarını takip etmek ve iş akışınızı verimlilik için optimize etmek amacıyla User Center'da kredi kullanımını izleyin.
</Tip>

<Accordion title="Token nedir?">
Bağlam pencereleri için ölçü birimidir. Token'lar, yapay zeka modelinin işlediği metin parçalarını (kelimeler, kelimelerin parçaları veya karakterler) temsil eder. Bağlam sınırları karakter veya kelimelerle değil token'larla ölçülür ve tipik sohbetler binlerce token tüketir.
</Accordion>

<Accordion title="Bağlam penceremde neler sayılır?">
Oturumunuzdaki her şey: sohbetteki tüm mesajlar, bağlama yüklenen dosya içerikleri, araç çıktıları (grep/arama sonuçları, dosya okumaları), sistem istemleri ve talimatları ve MCP sunucu tanımları. Bunların her biri toplam bağlam kapasitenizden token tüketir.
</Accordion>

<Accordion title="200K ile 1M bağlam pencereleri arasındaki fark nedir?">
Standart modeller (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2), çoğu görev için yeterli olan `200K` token'lık bağlam pencerelerine sahiptir. Claude Sonnet 4.5, `1000+` dosyalara sahip büyük kod tabanları, karmaşık çok dosyalı yeniden düzenleme veya uzun geliştirme oturumları için genişletilmiş `1M` token'lık bağlam (5 kat daha büyük) sunar. `1M` bağlam, giriş `200K` token'ı aştığında otomatik olarak etkinleşir veya açıkça seçilebilir.
</Accordion>

<Accordion title="Bağlama güvenle kaç dosya yükleyebilirim?">
Sabit bir dosya sınırı yoktur; dosya boyutlarına ve toplam token sayısına bağlıdır. `200K` bağlamlar için `20+` büyük dosyayı (her biri `>1000` satır) yüklemekten kaçının. Mevcut görevinizle doğrudan ilgili dosyalara odaklanın. `@-mentions` seçici kullanın ve çok sayıda örnek dosya yüklemek yerine `AGENTS.md` dokümantasyonundan yararlanın. `1M` bağlamla dosya seçimi çok daha az kritik hale gelir.
</Accordion>

<Accordion title="Bağlam sınırlarına yaklaştığımı nasıl anlarım?">
Belirtiler arasında daha yavaş yanıt süreleri, birkaç saat çalışan oturumlar veya çok sayıda büyük dosyanın yüklenmesi yer alır. Oturum uzunluğunuzu ve dosya sayınızı izleyin. Performans düşüşü fark ettiğinizde, mevcut görevinizi tamamlayın, ilerlemenizi commit edin ve temiz bağlamla yeni bir oturum başlatın.
</Accordion>

<Accordion title="Bağlam penceresi tükenmesini nasıl önlerim?">
**Stratejiler:**
1. **Stratejik dosya okuma:** Büyük dosyalar için satır aralıkları kullanın
2. **Alt aracılara devredin:** Arka plan araştırması için Explorer/Verifier
3. **Okumadan önce arayın:** İlgili dosyaları belirlemek için `grep_file` kullanın
4. **İşlemleri bölün:** Çok adımlı görevleri takip etmek için `todo_update` kullanın

**Genel kural:** 500 satırı aşan dosyalar için satır aralıkları kullanılmalıdır.
</Accordion>

<Accordion title="Bağlamı manuel olarak mı sıfırlamalıyım yoksa Verdent bunu otomatik mi yapar?">
Bağlamı sıfırlamak için yeni bir oturumu manuel olarak başlatmanız gerekir; Verdent bağlamı otomatik olarak temizlemez. En iyi uygulama: atomik bir iş birimini tamamladıktan, test ettikten ve sürüm kontrolüne commit ettikten sonra sıfırlayın. `1M` token'lık bağlamlar için sıfırlamalar çok daha seyrek gerekir.
</Accordion>

<Accordion title="Bağlamı sıfırlamak işimi kaybeder mi?">
Hayır; bağlamı sıfırlamak yalnızca sohbet geçmişini ve bellekten yüklenen dosyaları temizler. Asıl kod değişiklikleriniz, commit'leriniz ve dosya değişiklikleriniz korunur. Güvenlik için bağlamı sıfırlamadan önce işinizi her zaman sürüm kontrolüne commit edin. Sıfırla → yeni oturum başlat → bir sonraki görevde çalışmaya devam et.
</Accordion>

<Accordion title="İstemlerim ne kadar belirli olmalı?">
Belirsizliği ortadan kaldıracak kadar belirli olun ancak bariz ayrıntıları aşırı açıklamayın. Şunları ekleyin: tam dosya yolları, uygulama yaklaşımı, beklenen sonuçlar ve kısıtlamalar. Kötü: "Kodu düzelt" - çok belirsiz. İyi: "Geçersiz e-posta formatlarını reddetmek için `ContactForm.js` içindeki e-posta alanına giriş doğrulaması ekle" - net kapsam ve hedef. Tereddüt ederseniz, daha fazla belirlilik yönünde hata yapın.
</Accordion>

<Accordion title="@-bahsetmeleri ile otomatik dosya yükleme arasındaki fark nedir?">
Verdent, istemlerde adıyla belirtilen dosyaları ve aynı dizindeki ilgili dosyaları otomatik olarak yükler. `@-mentions` (`@filename.js`) bir dosyanın bağlamda olduğunu açıkça garanti eder; bu, sıkı şekilde bağlı dosyalarla çalışırken, bir dosyadaki kalıpları başka birine uygulamak için referans verirken veya büyük kod tabanlarında otomatik algılamanın bağlamı kaçırabileceği durumlarda kritiktir. Verdent'ten "şununla aynı kalıbı izle..." demesini isterken tam kod referansı sağlamak için her zaman `@-mentions` kullanın.
</Accordion>

<Accordion title="Bir oturum sırasında her istemde proje bağlamını tekrarlamam gerekir mi?">
Hayır; Verdent bir oturum içinde sohbet bağlamını korur, bu nedenle daha önce tartışılan mimari ayrıntıları veya kuralları tekrarlamanız gerekmez. Ancak kritik kısıtlamalar için veya oturumlar uzadığında (`100+` mesaj), önemli bağlamı yeniden belirtin. Daha iyi yaklaşım: teknoloji yığını, kodlama standartları ve kalıplar gibi kalıcı bağlamı belgelemek için proje kuralları (`AGENTS.md`) kullanın; böylece bunları hiç tekrarlamanız gerekmez.
</Accordion>

<Accordion title="Verdent istemimi doğru anlamaz veya izlemezse ne yapmalıyım?">
Yinelemeli iyileştirme kullanın: çıktıyı gözden geçirin, neyin yanlış olduğunu belirleyin, ardından bir takip isteminde düzeltmeler sağlayın. Örnek: "Doğrulama mantığı iyi ama manuel kontroller yerine Joi şema doğrulaması kullan. `ProductController.js` içindeki doğrulama kalıbıyla eşleştir." Ayrıca açıklama da isteyebilirsiniz: "Context API yerine neden Redux kullandın?" ardından anladığınıza göre iyileştirin. Aynı istemi tekrarlamayın; neyin başarısız olduğuna göre ayarlayın.
</Accordion>

<Accordion title="Normal mod yerine ne zaman Plan Mode'u kullanmalıyım?">
Plan Mode'u şunlar için kullanın: büyük yeniden düzenlemeler veya mimari değişiklikler, yürütmeden önce kapsamı gözden geçirmek istediğiniz çok dosyalı değişiklikler, gereksinimlerden emin olmadığınız karmaşık görevler veya uygulamadan önce Verdent'in size açıklayıcı sorularla görüşme yapmasını istediğiniz durumlar. Şunlar için Plan Mode'u atlayın: basit, iyi tanımlanmış görevler, hızlı hata düzeltmeleri veya rutin işlemler. Plan Mode ek yük getirir ancak karmaşık işlerde maliyetli hataları önler.
</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 değer) - Varsayılan:**
- Genel geliştirme ve günlük kodlama
- Özellik uygulaması 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)
- Sofistike hata ayıklama ve yeniden düzenleme

**Pro 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ütme gerektiğinde Performance'a geçer.
</Accordion>

---

## Sorun giderme

<Accordion title="Güvenlik duvarı veya bağlantı sorunlarını nasıl giderebilirim?">
Verdent yapay zeka hizmetlerine bağlanamıyorsa şu yaygın sorunları kontrol edin:

**Temel bağlantıyı test edin:**
- Etkin bir internet erişiminiz olduğunu doğrulayın
- Giden bağlantıların çalıştığını doğrulamak için diğer HTTPS hizmetlerine erişmeyi deneyin

**Kurumsal/işletme ortamları:**
- Verdent'in API uç noktalarını beyaz listeye almak için ağ yöneticinizle iletişime geçin
- Giden HTTPS trafiğinin güvenlik duvarınızdan geçmesine izin verildiğinden emin olun
- Proxy sunucularının API isteklerini geçirmek üzere doğru yapılandırıldığını kontrol edin
- SSL/TLS denetimi Verdent uç noktaları için istisnalar gerektirebilir

**Yaygın belirtiler:**
- Uzantı takılıyor veya zaman aşımına uğruyor gibi görünür
- Doğru kimlik bilgilerine rağmen kimlik doğrulama hataları

Güvenlik duvarı yapılandırmasından sonra sorunlar devam ederse, beyaz listeye alınacak belirli uç nokta ayrıntıları için Verdent desteğiyle iletişime geçin.
</Accordion>

<Accordion title="AGENTS.md kurallarım uygulanmıyor. Neden?">
**Kontrol edin:**
- **Konum:** Dosya proje kök dizininde
- **Sözdizimi:** Geçerli Markdown
- **Belirlilik:** Kurallar yönlendirici olmalı ("Şunu her zaman kullan...", "Şunu yapmaya çalış..." değil)
- **Temiz test:** Uygulamayı test etmek için yeni bir sohbet başlatın

**Öncelik:** AGENTS.md, projeye özgü davranış için VERDENT.md'yi geçersiz kılar.
</Accordion>

<Accordion title="'file_edit failed to find exact match' hatalarını nasıl düzeltirim?">
**Nedenler:**
- Metin son okumadan bu yana değişti
- Boşluk farklılıkları (boşluk yerine sekme)
- Dize dosyada benzersiz değil

**Çözümler:**
- Mevcut içeriği almak için dosyayı tekrar okuyun
- Benzersizlik için daha büyük bağlam dizesi sağlayın
- Birden fazla aynı dize için `replace_all=true` kullanın
- file_path'in doğru olduğunu doğrulayın
</Accordion>

<Accordion title="Özel alt aracım neden otomatik olarak çağrılmıyor?">
**Kontrol edin:**
- **Konum:** Dosya `~/.verdent/subagents/[name].md` içinde
- **Çağırma politikası:** Katı politika açık @-bahsetme gerektirir
- **YAML frontmatter:** Geçerli sözdizimi
- **"When to use" yönergeleri:** İstek kalıbınızla eşleşir

**Test:** Alt aracının çalıştığını doğrulamak için açık @-bahsetme kullanın: `@your-subagent do task`
</Accordion>

---

## Ayrıca bakın

<CardGroup cols={2}>
  <Card title="Araç referansı" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Tüm araç yetenekleri
  </Card>
  <Card title="Sorun giderme" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/common-issues">
    Yaygın sorunlar ve çözümler
  </Card>
</CardGroup>