# Sorun giderme (/tr/docs/verdent-for-vscode/help-support/common-issues)

> Yaygın sorunlar, tanılama ve çözümler



### Neler öğreneceksiniz [#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 [#hızlı-tanılama]

<Tabs>
  <Tab title="Hizmet hataları (en yaygın)">
    ### "Service is experiencing high traffic. Please try again later!" [#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ı [#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 [#verdent-for-vs-codea-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ı [#ü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 [#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) [#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](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ı [#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ı [#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 [#araca-özgü-sorunlar]

<Tabs>
  <Tab title="file_edit hataları">
    ### 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ı [#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 [#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ı [#alt-aracı-ve-yapılandırma-sorunları]

<Tabs>
  <Tab title="Alt aracı çağrılmıyor">
    ### 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ışı [#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 [#agentsmd-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ı [#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 [#bilinen-sorunlar-ve-geçici-çözümler]

<Tabs>
  <Tab title="İkili dosyalar">
    ### İkili dosya sınırlamaları [#i̇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 [#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ı [#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 [#ek-yardım-alma]

### Destek kanalları [#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 [#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 [#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>