---
title: "Sorun giderme"
description: "Yaygın sorunlar, tanılama ve çözümler"
---

### Neler öğreneceksiniz

Verdent for VS Code için yaygın sorun giderme prosedürleri, tanılama adımları ve bilinen sorunların geçici çözümleri.

<Info>
  Kullanıcıların en çok bildirdiği sorunlara yönelik ayrıntılı sorun giderme, destek verilerinden derleniyor. Bu sayfa genel tanılama prosedürleri sunar. Burada ele alınmayan belirli sorunlar için [support@verdent.ai](mailto:support@verdent.ai) ile iletişime geçin.
</Info>

---

## Hızlı tanılama

<Tabs>
  <Tab title="Hizmet hataları (en yaygın)">
    ### "Service is experiencing high traffic. Please try again later!"

    **Bu, kullanıcıların karşılaştığı en yaygın 1 numaralı hatadır.** Verdent hizmetinin geçici olarak aşırı yüklendiğini gösterir.

    **Ne zaman olur:**

    - Yoğun kullanım saatlerinde
    - Arka uç hizmetleri ağır yük altındayken
    - Geçici hizmet bozulması

    **Kurtarma adımları (sırasıyla):**

    <Steps>
      <Step title="Mesajı geri al" stepNumber={1}>
        Hata devam ederse en son mesajı geri alın:

        - Sohbet arayüzündeki geri al düğmesine tıklayın
        - Kısa bir bekleyişin ardından isteğinizi yeniden gönderin
      </Step>
      <Step title="Yeni oturum başlat" stepNumber={2}>
        Hatalar sürerse yeni bir oturum başlatın:

        - Üst çubuktaki "+" (Yeni oturum) düğmesine tıklayın
        - Bu, bağlamı ve araç onaylarını temizler
        - İsteğinizi temiz oturumda yeniden gönderin
      </Step>
      <Step title="Bekleyin ve yeniden deneyin" stepNumber={3}>
        30-60 saniye bekleyin ve isteğinizi tekrar deneyin. Çoğu hizmet sorunu hızla çözülür.
      </Step>
    </Steps>
    <Warning>
      Sorun birden fazla oturumda 5-10 dakikadan uzun sürerse [Verdent durum sayfasını](https://verdent.ai/status) kontrol edin veya [support@verdent.ai](mailto:support@verdent.ai) ile iletişime geçin.
    </Warning>
  </Tab>
  <Tab title="Kurulum ve yapılandırma">
    ### Kurulum ve yapılandırma sorunları

    **Sistem gereksinimleri:**

    - **VS Code sürümü:** 1.90.0 veya üzeri (gerekli)
    - **İnternet bağlantısı:** Etkin bağlantı gerekir
    - **Abonelik:** Etkin bir Verdent aboneliği

    **Temel tanılama kontrol listesi:**

    1. **VS Code sürümünü doğrulayın:** Help → About (1.90.0+ olmalı)
    2. **İnternet bağlantısını kontrol edin:** Verdent etkin bir bağlantı gerektirir
    3. **Aboneliği doğrulayın:** Verdent aboneliğinizin etkin olduğundan emin olun
    4. **VS Code'u yeniden başlatın:** Kurulum veya yapılandırma değişikliklerinden sonra
    5. **Eklenti durumunu kontrol edin:** View → Extensions → Verdent ("Enabled" göstermeli)

    **Temiz yeniden kurulum prosedürü:**

    <Steps>
      <Step title="Verdent'i kaldırın">
        View → Extensions → Verdent → Uninstall
      </Step>
      <Step title="VS Code'u yeniden başlatın">
        VS Code'u tamamen kapatıp yeniden açın
      </Step>
      <Step title="Verdent'i yeniden kurun">
        View → Extensions → "Verdent" araması yapın → Install
      </Step>
    </Steps>
    **Günlükleri kontrol edin:**

    - Output panelini açın: View → Output
    - Açılır listeden "Verdent" öğesini seçin
    - Hata mesajlarını veya yığın izlerini arayın

    <Info>
      Çoğu kurulum sorunu basit bir VS Code yeniden yüklemesi veya temiz yeniden kurulumla çözülür. Sorun devam ederse günlükleri kontrol edin ve günlük ayrıntılarıyla birlikte destekle iletişime geçin.
    </Info>
  </Tab>
  <Tab title="Kimlik doğrulama ve hesap">
    ### Verdent for VS Code'a giriş yapılamıyor

    **En yaygın neden:** Proxy yapılandırma sorunu

    **Çözüm:**

    <Steps>
      <Step title="VS Code ayarlarını açın">
        `Cmd+,` (macOS) veya `Ctrl+,` (Windows/Linux) tuşlarına basın
      </Step>
      <Step title="Proxy ayarını arayın">
        Ayarlar arama çubuğunda "useProxy" veya "verdent.enableProxy" araması yapın
      </Step>
      <Step title="Proxy durumunu değiştirin">
        Proxy ayarını açın/kapatın (mevcut durumun tersine)
      </Step>
      <Step title="Girişi yeniden deneyin">
        Verdent'e tekrar giriş yapmayı deneyin
      </Step>
    </Steps>
    <Info>
      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.
    </Info>
    ---

    ### Ücretsiz deneme kredileri alınmadı

    **Hata:** Ücretsiz deneme kredileri alınmadı veya ücretsiz deneme erişimi reddedildi

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

    **Çözüm:** Ücretsiz deneme erişiminizle ilgili yardım için [support@verdent.ai](mailto:support@verdent.ai) ile iletişime geçin. Destek ekibi hesabınızı inceleyecek ve sorunu çözmenize yardımcı olacaktır.

    ---

    ### Kayıt 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](mailto:support@verdent.ai) ile iletişime geçin. Destek ekibi kaydınızı inceleyebilir ve sorunu çözme konusunda yönlendirme sağlayabilir.

    ---

    ### Eksik modeller (Claude, GPT, Gemini)

    **Sorun:** Model seçiminde Claude, GPT veya Gemini modelleri bulunamıyor

    **Neden:** Model sağlayıcılarının konum tabanlı kısıtlamaları

    **Açıklama:** Bazı yapay zeka model sağlayıcılarının, belirli modellerin belirli coğrafi konumlarda kullanılabilir olmasını engelleyen bölgesel kısıtlamaları vardır. Bu durumda:

    - Kısıtlanan modeller model seçim menünüzde görünmez
    - Diğer tüm mevcut modelleri kesintisiz kullanmaya devam edebilirsiniz
    - Aboneliğiniz veya kredileriniz üzerinde herhangi bir etkisi olmaz

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

    <Note>
      Bölgesel kısıtlamalar Verdent tarafından değil, yapay zeka model sağlayıcıları (Anthropic, OpenAI, Google) tarafından belirlenir. Verdent bu kısıtlamaları geçersiz kılamaz.
    </Note>
  </Tab>
  <Tab title="Performans">
    ### Performans sorunları

    **Belirtiler:**

    - Yavaş yanıt süreleri
    - Bağlam penceresi dolu hataları
    - Araç yürütme zaman aşımları

    **Yaygın nedenler ve çözümler:**

    | Sorun             | Neden                        | Çözüm                                                              |
    | ----------------- | ---------------------------- | --------------------------------------------------------------------- |
    | Yavaş yanıtlar    | Büyük dosyaların okunması       | Satır aralıkları kullanın: `file_read("file.js", start_line=100, max_lines=50)` |
    | Bağlam dolu      | Uzun konuşma geçmişi    | Alt aracılara devredin veya yeni bir konuşma başlatın                       |
    | Araç zaman aşımları     | Uzun süren bash komutları   | Açık bir zaman aşımı ayarlayın veya daha küçük komutlara bölün                   |
    | Yüksek bellek kullanımı | Çok fazla paralel işlem | Eşzamanlı araç yürütmelerini sınırlayın                                      |

    <Tip>
      Ana bağlamı korumak için keşif görevlerini @Explorer alt aracısına devredin.
    </Tip>
  </Tab>
  <Tab title="Görüntü hataları">
    ### Görüntüyle ilgili hata mesajları

    **Yaygın görüntü işleme hataları için hızlı başvuru:**

    | Hata mesajı                  | Neden                                                                    | Çözüm                                                      |
    | ------------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------- |
    | **Unsupported Image Type**     | Yalnızca JPEG, PNG, GIF veya WebP görüntüleri desteklenir                        | Geri alın ve görüntü türünü desteklenen bir formata değiştirin     |
    | **Image Dimensions Too Large** | Görüntü genişliği veya yüksekliği 8000 pikseli aşamaz                          | Geri alın ve görüntü boyutlarını 8000×8000 veya daha küçüğe ayarlayın |
    | **Input Too Long**             | Girdi, modelin izin verilen maksimum uzunluğunu aşıyor                     | Girdinizi basitleştirin veya görüntü boyutunu küçültün                      |
    | **File Too Large**             | Görüntü boyutu 5 MB'ı aşamaz                                            | Geri alın ve sıkıştırılmış bir görüntü gönderin (en fazla 5 MB)              |
    | **Unreadable Image**           | Görüntü işlenemedi, dosya bozuk veya desteklenmeyen formatta olabilir | Geri alın ve görüntüyü geçerli bir dosyayla değiştirin             |
  </Tab>
</Tabs>

---

## Araca özgü sorunlar

<Tabs>
  <Tab title="file_edit hataları">
    ### file_edit hataları

    **Hata:** "Failed to find exact match"

    **Nedenler:**

    - Son file_read'den bu yana metin değişti
    - Boşluk farklılıkları (sekmeler ile boşluklar)
    - Dize dosyada benzersiz değil

    **Çözümler:**

    ```bash
    # 1. Read file again to get current state
    file_read("file.js")

    # 2. Use larger context string for uniqueness
    file_edit("file.js",
      old_string="function foo() {\n  return 42;\n}",
      new_string="...")

    # 3. For multiple identical strings, use replace_all
    file_edit("file.js", old_string="TODO", new_string="DONE", replace_all=true)
    ```

    <Warning>
      Mevcut duruma sahip olduğunuzdan emin olmak için düzenlemeden hemen önce dosyayı her zaman okuyun.
    </Warning>
  </Tab>
  <Tab title="bash hataları">
    ### bash komut hataları

    **Hata:** Komut zaman aşımı veya yürütme hatası

    **Maksimum zaman aşımı:** 120 saniye (2 dakika, kesin sınır)

    **Çözüm:** Uzun komutları daha küçük işlemlere bölün:

    ```bash
    # Instead of one long command, break into steps
    bash("step1")  # Completes in < 2min
    bash("step2")  # Completes in < 2min
    ```

    **Komut bulunamadı:**

    - Komutun var olup olmadığını kontrol edin: `bash("which command-name")`
    - Doğru yolu sağlayın veya önce ortamı etkinleştirin
    - Yürütülebilir dosyalar için tam yolları kullanın

    **İzin hataları:**

    - Komutlar kullanıcı izinleriyle yürütülür
    - `sudo` yalnızca gerekliyse ve Manual Accept Mode'da kullanın
    - Dosya/dizin izinlerini kontrol edin
  </Tab>
  <Tab title="Arama sorunları">
    ### Arama sonuç döndürmüyor

    **Sorun:** grep_file veya glob beklenen dosyaları bulamıyor

    **Desen söz dizimini kontrol edin:**

    ```bash
    # Wrong
    grep_file("*.ts")  # Missing ** for recursive

    # Correct
    grep_file("**/*.ts")  # Recursive search
    ```

    **Hariç tutmaları kontrol edin:**

    ```bash
    # Ensure not accidentally excluding target files
    glob("**/*.js", exclude=["**/dist/**", "**/node_modules/**"])
    ```

    **Büyük/küçük harf duyarlılığı:**

    ```bash
    # Use case-insensitive search if needed
    grep_content("pattern", case_insensitive=true)
    ```
  </Tab>
</Tabs>

---

## Alt aracı ve yapılandırma sorunları

<Tabs>
  <Tab title="Alt aracı çağrılmıyor">
    ### Alt aracı çağrılmıyor

    **Sorun:** Özel alt aracı otomatik olarak etkinleşmiyor

    **Kontrol listesi:**

    - Dosya konumu: `~/.verdent/subagents/[name].md`
    - `name` ve `description` ile geçerli YAML frontmatter
    - Çağırma politikası kullanımla eşleşiyor (strict, @-bahsetme gerektirir)
    - "When to use" yönergeleri istek deseniyle eşleşiyor
    - Markdown dosyasında söz dizimi hatası yok

    **Manuel olarak test edin:**

    ```
    @subagent-name perform task
    ```

    <Tip>
      Otomatik çağrımayı gidermeye başlamadan önce alt aracının çalıştığını doğrulamak için açık @-bahsetme kullanın.
    </Tip>
  </Tab>
  <Tab title="Yerleşik alt aracılar">
    ### Yerleşik alt aracı davranışı

    **Sorun:** @Explorer, @Verifier veya @Code-reviewer beklendiği gibi davranmıyor

    **Yaygın nedenler:**

    - İstek, alt aracının uzmanlığıyla eşleşmiyor
    - Alt aracı bağlamı dolu (nadir)
    - Ana konuşma bağlamı yönlendirmeyi etkiliyor

    **Çözüm:**

    - Belirli bir alt aracıyı zorlamak için açık @-bahsetme kullanın
    - İsteği alt aracının uzmanlığıyla eşleşecek şekilde yeniden ifade edin
    - Bağlam sorunsa yeni bir konuşma başlatın
  </Tab>
  <Tab title="AGENTS.md kuralları">
    ### AGENTS.md uygulanmıyor

    **Sorun:** Proje kuralları Verdent davranışını etkilemiyor

    **Tanılama:**

    1. **Konum:** Dosya proje kök dizininde olmalı
    2. **Söz dizimi:** Geçerli Markdown (söz dizimi hatalarını kontrol edin)
    3. **Belirlilik:** Kurallar yönlendirici olmalı: "Try to use X" değil "Always use X"
    4. **Test:** Yeni uygulamayı test etmek için yeni bir konuşma başlatın

    **Öncelik kontrolü:**

    ```markdown
    # In AGENTS.md (highest priority)
    - Use 4-space indentation

    # In VERDENT.md (lower priority)
    - Use 2-space indentation

    # Result: 4-space indentation (AGENTS.md wins)
    ```
  </Tab>
  <Tab title="MCP bağlantısı">
    ### MCP bağlantı hataları

    **Hata:** MCP sunucusuna bağlanılamıyor

    **Tanılama adımları:**

    1. **mcp.json'ı kontrol edin:** `~/.verdent/mcp.json` içinde geçerli JSON söz dizimi
    2. **Sunucu çalışıyor:** MCP sunucu sürecinin etkin olduğundan emin olun
    3. **Ağ:** Sunucu uç noktasına bağlantıyı doğrulayın
    4. **Kimlik doğrulama:** Kimlik bilgilerinin doğru olduğunu onaylayın
    5. **Günlükler:** Hata ayrıntıları için MCP sunucu günlüklerini kontrol edin

    **Yaygın çözümler:**

    - MCP sunucusunu yeniden başlatın
    - Bağlantı dizesi formatını doğrulayın
    - MCP trafiğine izin veren güvenlik duvarı kurallarını kontrol edin
    - API anahtarlarını veya belirteçleri doğrulayın
  </Tab>
</Tabs>

---

## Bilinen sorunlar ve geçici çözümler

<Tabs>
  <Tab title="İkili dosyalar">
    ### İkili dosya sınırlamaları

    **Sorun:** Görüntüler, PDF'ler ve derlenmiş ikili dosyalar düzenlenemiyor

    **Geçici çözüm:**

    ```bash
    # Use bash to call external tools
    bash("convert input.png -resize 50% output.png")
    bash("pdftotext document.pdf output.txt")
    ```

    <Info>
      İkili dosya değişiklikleri, bash komutları aracılığıyla çağrılan harici araçlar gerektirir.
    </Info>
  </Tab>
  <Tab title="Büyük dosyalar">
    ### Büyük dosya işleme

    **Sorun:** 10.000 satırın üzerindeki dosyalar bağlam sorunlarına neden olur

    **Geçici çözüm:**

    ```bash
    # Always use line ranges for large files
    file_read("large.log", start_line=1000, max_lines=100)

    # Search first to find relevant sections
    grep_content("ERROR", glob="large.log")
    ```

    <Tip>
      İlgili satır numaralarını bulmak için önce grep_content ile arama yapın, ardından yalnızca o belirli aralıkları okuyun.
    </Tip>
  </Tab>
  <Tab title="Platform farklılıkları">
    ### Platformlar arası komut farklılıkları

    **Sorun:** bash komutları Windows ile Unix arasında farklılık gösterir

    **Geçici çözüm:**

    ```bash
    # Use cross-platform tools when possible
    bash("npm run build")  # Works everywhere

    # Or conditional execution
    bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")
    ```

    **En iyi uygulama:** Platformlar arası uyumluluk için npm betiklerini kullanın.
  </Tab>
</Tabs>

---

## Ek yardım alma

### Destek kanalları

**Burada ele alınmayan belirli sorunlar için:**

- **E-posta:** [support@verdent.ai](mailto:support@verdent.ai)
- **Discord:** Gerçek zamanlı destek için [Verdent topluluğuna katılın](https://discord.com/invite/NGjXEZcbJq)
- **GitHub Issues:** Hataları bildirin veya özellik talep edin

**Sorunları bildirirken şunları ekleyin:**

1. Verdent sürümü (Extensions panelinden)
2. VS Code sürümü
3. İşletim sistemi
4. Hata mesajları (tam metin)
5. Yeniden oluşturma adımları
6. Beklenen ile gerçek davranış

---

### Tanılama bilgisi toplama

**Desteğin tanılamasına yardımcı olmak için:**

```bash
# VS Code version
bash("code --version")

# System info
bash("uname -a")  # Unix
bash("systeminfo")  # Windows

# Verdent logs location
# Check VS Code Output panel → Verdent
```

---

## Ayrıca bakın

<CardGroup cols={2}>
  <Card title="SSS" icon="circle-question" href="/docs/verdent-for-vscode/help-support/faqs">
    Sıkça sorulan sorular
  </Card>
  <Card title="Sınırlamalar" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/limitations">
    Bilinen sınırlamalar ve kısıtlamalar
  </Card>
</CardGroup>