# Hızlı başlangıç kılavuzu (/tr/docs/verdent-for-vscode/getting-started/quick-start)

> Verdent'i dakikalar içinde kullanmaya başlayın



Bu hızlı başlangıç kılavuzu, 15 dakikadan kısa sürede Verdent'in Plan-Verify-Code iş akışını kullanmanızı sağlayacak. Uzantıyı yükleyecek, ilk görevinizi tamamlayacak ve Verdent for VS Code ile çalışırken temel iş akışını anlayacaksınız.

### Neler öğreneceksiniz [#neler-öğreneceksiniz]

* Verdent for VS Code'u marketplace'ten yükleme
* Kimlik doğrulama yapma ve kurulumunuzu doğrulama
* İlk yapay zeka destekli görevinizi tamamlama
* Yürütme modlarını anlama (Manual Accept, Auto-Run, Plan Mode)
* Günlük kodlama için temel özellikleri kullanma

### Ön koşullar [#ön-koşullar]

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

* Sisteminizde Visual Studio Code yüklü olmalı
* Etkin bir internet bağlantısı
* Aktif bir Verdent abonelik hesabı (veya 7 günlük ücretsiz denemeyle başlayın)

***

## Adım 1: Verdent'i yükleyin [#adım-1-verdenti-yükleyin]

<Tabs>
  <Tab title="Visual Studio Code Marketplace">
    [Verdent uzantısı sayfasını](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) ziyaret edin ve **Install** düğmesine tıklayın.
  </Tab>

  <Tab title="Uzantılar paneli">
    1. Visual Studio Code'u açın
    2. `Ctrl+Shift+X` tuşlarına basın (veya macOS'ta `Cmd+Shift+X`)
    3. "Verdent" araması yapın
    4. **Install** düğmesine tıklayın
  </Tab>

  <Tab title="Komut satırı">
    ```bash
    code --install-extension verdentai.verdent
    ```
  </Tab>
</Tabs>

***

## Adım 2: Verdent'i kullanmaya başlayın [#adım-2-verdenti-kullanmaya-başlayın]

<Steps>
  <Step title="Visual Studio Code'u açın">
    Visual Studio Code'u proje klasörünüzde açın.
  </Step>

  <Step title="Verdent'e erişin">
    Kenar çubuğundaki Verdent simgesine tıklayın veya `Ctrl+L` (Windows/Linux) / `Cmd+L` (macOS) tuşlarına basın.
  </Step>

  <Step title="Oturum açın">
    İstendiğinde Verdent hesabınızla kimlik doğrulaması yapmak için oturum açın.
  </Step>
</Steps>

***

## Adım 3: İlk göreviniz [#adım-3-i̇lk-göreviniz]

Verdent'in çalışma alanınızı nasıl anladığını gösteren basit, zarar vermeyen bir görevle başlayalım.

**VS Code'da bir proje açın**, ardından Verdent giriş kutusunda şu istemlerden birini deneyin:

```
What kind of project is this?
```

Verdent çalışma alanınızın yapısını analiz edecek, önemli dosyaları okuyacak ve ne tür bir uygulama üzerinde çalıştığınızı açıklayacak. Bu, herhangi bir değişiklik yapmadan bağlam farkındalığını gösterir.

**Şunları görmelisiniz:**

* Verdent'in çalışma alanınızdaki dosyaları analiz etmesi
* Proje türünüzün, teknolojilerinizin ve yapınızın bir özeti
* Dosya değişikliği olmaması (salt okunur analiz)

**Şu takip istemlerini deneyin:**

```
Explain what this project does
```

```
What dependencies does this project have?
```

```
Show me the main entry point of this application
```

Her istem, Verdent'in çalışma alanınıza erişebildiğini ve kod tabanınızı anladığını doğrulamanıza yardımcı olur.

<Tip>
  Bu keşif istemleri, tanımadığınız kod tabanlarını anlamak için idealdir. Verdent, bağlamı manuel olarak eklemenizi gerektirmeden dosyaları gerektiği gibi okur.
</Tip>

***

## Adım 4: İlk kod değişikliğinizi yapma [#adım-4-i̇lk-kod-değişikliğinizi-yapma]

Şimdi Verdent'in bir şeyler oluşturmasını sağlayalım. Şu basit görevi deneyin:

```
Create a hello_world.txt file with a greeting message
```

**Ne olur:**

1. **Verdent değişikliği önerir** Oluşturulacak dosyayı ve içeriğini gösteren bir önizleme görürsünüz
2. **İzin isteği** Auto Run Mode'da (varsayılan), Verdent dosyayı oluştururken otomatik onay verir
3. **Onaylarsınız** "Accept" düğmesine tıklayın veya değişikliği onaylayın
4. **Dosya oluşturulur** Verdent dosyayı oluşturur ve tamamlandığını onaylar

**İzinleri anlama:**

Manual Accept Mode, onayınız olmadan istenmeyen değişikliklerin yapılmamasını sağlar. Şunlar için izin istemleri görürsünüz:

* Dosya düzenleme ve oluşturma
* Komut yürütme
* Araç kullanımı (her araç türünün ilk kullanımı)

Bu, size tam kontrol sağlar ve Verdent'in farklı görevler için hangi işlemleri gerçekleştirdiğini öğrenmenize yardımcı olur.

<Note>
  Manual Accept Mode, yeni kullanıcılar için önerilen başlangıç noktasıdır. Rahat hissettiğinizde farklı iş akışları için Auto-Run Mode'a veya Plan Mode'a geçebilirsiniz.
</Note>

***

## Adım 5: Karmaşık görevler için Plan Mode'u kullanma [#adım-5-karmaşık-görevler-için-plan-modeu-kullanma]

Plan Mode, Verdent'in yürütmeden önce yaklaşımları gözden geçirebileceğiniz salt okunur planlama modudur. Hadi deneyelim:

**Plan Mode'a geçin:**

Giriş kutusundaki **Switch Mode** düğmesine tıklayın ve **Plan Mode** seçeneğini belirleyin

**Bir planlama görevini deneyin:**

```
Suggest ways to build a website for my project
```

**Ne olur:**

1. **Verdent projenizi analiz eder** Dosyaları okur ve proje yapınızı ve gereksinimlerinizi anlar
2. **Ayrıntılı bir plan oluşturur** Hangi teknolojilerin kullanılacağını, hangi sayfaların oluşturulacağını ve web sitesinin nasıl yapılandırılacağını gösterir
3. **Değişiklik yapmaz** Plan Mode salt okunurdur. Siz açıkça onaylayana kadar Verdent dosyaları değiştiremez
4. **Etkileşimli netleştirme** Verdent, planı sonlandırmadan önce tasarım tercihleri, hedef kitle veya özellikler hakkında sorular sorabilir

**Plan Mode'u neden kullanmalısınız:**

* **Güvenli keşif** - Tanımadığınız kod tabanlarını yanlışlıkla değişiklik yapmadan anlayın
* **Kod incelemesi** - Değişiklik yapmadan önce kaliteyi ve mimariyi analiz edin
* **Stratejik planlama** - Karmaşık görevleri incelenebilir adımlara bölün
* **Belirsizliği azaltma** - Verdent, belirsizliği ortadan kaldırmak için netleştirici sorular sorar

<Tip>
  Yürütmeye başlamadan önce yaklaşımı gözden geçirmek istediğiniz herhangi bir görev için Plan Mode'u kullanın. Verdent'in kod tabanınız hakkında nasıl düşündüğünü öğrenirken özellikle değerlidir.
</Tip>

**Planı yürütmek için:**

Planı gözden geçirdikten sonra Verdent iki seçenek sunar:

* Değişiklik istemek veya netleştirici sorular sormak için **Edit** seçeneğini belirleyin
* Agent Mode'a geçmek ve yürütmeye başlamak için **Start Building** seçeneğini belirleyin

***

## Adım 6: Yürütme modlarını anlama [#adım-6-yürütme-modlarını-anlama]

Verdent, farklı iş akışlarına uyacak şekilde birden fazla yürütme modu sunar:

**İzin modları:**

| Mod                       | Açıklama                                                                                                                    | Ne zaman kullanılır                                              |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| **Manual Accept**         | Her aracın ilk kullanımında izin ister                                                                                      | Maksimum kontrolle öğrenme ve genel geliştirme                   |
| **Auto-Run** (varsayılan) | Güvenli işlemleri otomatik kabul eder (dosya okuma, web aramaları); dosya düzenlemeleri ve komutlar yine de onay gerektirir | Güvenilir projeler ve hızlı prototipleme                         |
| **Plan Mode**             | Dosya değişikliği olmadan analiz ve planlama için salt okunur mod                                                           | Karmaşık görevler ve kod incelemesi                              |
| **Skip Permissions**      | Tüm istemleri atlayan tam özerk çalışma                                                                                     | Otomatik test veya korumalı alanlar gibi izole, güvenli ortamlar |

**Ek mod:**

* **Think Hard Mode** - Karmaşık akıl yürütme ve mimari kararlar için maksimum düşünme bütçesi

<Warning>
  Skip Permissions Mode tüm güvenlik kontrollerini kaldırır. Yalnızca hataların sonuç doğurmadığı izole, tek kullanımlık ortamlarda kullanın.
</Warning>

***

## Temel eylemler [#temel-eylemler]

Verdent for VS Code'da her gün kullanacağınız temel eylemler şunlardır:

| Eylem             | Nasıl erişilir                                          | Açıklama                                                          |
| ----------------- | ------------------------------------------------------- | ----------------------------------------------------------------- |
| Verdent'i aç      | `Cmd+L` / `Ctrl+L` veya kenar çubuğu simgesine tıklayın | Verdent panelini açar                                             |
| Yeni oturum       | Üst çubukta "New Session" tıklayın                      | Temiz bağlamla yeni bir konuşma başlatın                          |
| Bağlam ekle       | "Add Context" düğmesine tıklayın                        | @-mention ile dosyalara referans verin                            |
| Görsel ekle       | "Add Images or Files" düğmesine tıklayın                | Ekran görüntüleri, taslaklar veya diyagramlar yükleyin            |
| Mod değiştir      | "Switch Mode" düğmesine tıklayın                        | Agent/Plan/Chat modları arasında geçiş yapın                      |
| Model değiştir    | Model seçiciye tıklayın                                 | Performance/Balance/Efficiency hazır ayarlarını seçin             |
| Think Hard        | "Think Hard Mode" düğmesine tıklayın                    | Karmaşık görevler için genişletilmiş akıl yürütmeyi etkinleştirin |
| İzinleri değiştir | "Switch Permission" düğmesine tıklayın                  | İzin modunu değiştirin                                            |
| Geçmişi görüntüle | Üst çubukta "Project History" tıklayın                  | Geçmiş oturumlara göz atın                                        |
| Kullanıcı merkezi | Üst çubukta "User Center" tıklayın                      | Kredi bakiyenizi ve hesap bilgilerinizi kontrol edin              |
| Ayarlar           | Üst çubukta "Settings" tıklayın                         | MCP sunucularını, alt aracıları, kuralları yapılandırın           |

***

## Yeni başlayanlar için profesyonel ipuçları [#yeni-başlayanlar-için-profesyonel-ipuçları]

<Accordion title="Keşif istemleriyle başlayın">
  Değişiklik yapmadan önce Verdent'in kod tabanınızı anlamasına izin verin:

  ```
  Analyze the database schema
  ```

  ```
  Explain the authentication flow
  ```

  Bu, Verdent'in projeniz hakkındaki bağlamını oluşturur ve daha iyi öneriler yapmasına yardımcı olur.
</Accordion>

<Accordion title="İsteklerinizde açık olun">
  Şunun yerine: "hatayı düzelt"

  Şunu deneyin: "`LoginForm.tsx` dosyasındaki, kullanıcıların yanlış kimlik bilgileri girdikten sonra boş ekran görmesine neden olan oturum açma hatasını düzelt"

  Açık istemler daha doğru çözümlere ve daha az yinelemeye yol açar.
</Accordion>

<Accordion title="Tanımadığınız kod için Plan Mode'u kullanın">
  Tam olarak anlamadığınız kodla çalışırken önce Plan Mode'u kullanın:

  ```
  Refactor the authentication module to use async/await instead of callbacks
  ```

  Planı gözden geçirin, netleştirici sorular sormak ve iyileştirmek için **Edit** seçeneğini belirleyin, ardından emin olduğunuzda **Start Building** seçeneğini belirleyin.
</Accordion>

<Accordion title="Karmaşık görevleri adımlara bölün">
  Çok adımlı özellikler için kademeli çalışın:

  ```
  1. Create a new database table for user profiles
  ```

  Ardından tamamlandıktan sonra:

  ```
  2. Create an API endpoint to get and update profiles
  ```

  Bu, netliği korur ve her adımı doğrulamanıza olanak tanır.
</Accordion>

<Accordion title="Bağlam için @-mention'lardan yararlanın">
  Gerektiğinde dosyalara açıkça referans verin:

  ```
  @components/UserProfile.tsx refactor this component to use hooks
  ```

  Bu, Verdent'in göreviniz için doğru bağlama odaklanmasını sağlar.
</Accordion>

<Accordion title="Özel görevler için alt aracıları kullanın">
  Verdent üç yerleşik alt aracı içerir:

  * `@Explorer` - Hızlı kod tabanı keşfi ve dosya bulma
  * `@Verifier` - Hızlı kod doğrulama ve kontroller
  * `@Code-reviewer` - Kapsamlı güvenlik ve kalite incelemesi

  Örnek:

  ```
  @Explorer find all API endpoints in this project
  ```
</Accordion>

***

## Sık karşılaşılan sorunlar [#sık-karşılaşılan-sorunlar]

<Tabs>
  <Tab title="Uzantı kenar çubuğunda görünmüyor">
    **Çözüm:** VS Code'u yeniden başlatın. Hâlâ eksikse, Uzantılar panelinde (`Cmd+Shift+X` / `Ctrl+Shift+X`) kurulumu doğrulayın ve "Verdent" öğesinin listede göründüğünü onaylayın.
  </Tab>

  <Tab title="İstemler yanıt almıyor">
    **Çözüm:**

    1. İnternet bağlantısının etkin olduğunu doğrulayın
    2. Güvenlik duvarı/proxy ayarlarının Verdent hizmetlerine HTTPS'ye izin verdiğini kontrol edin
    3. User Center'da kalan krediniz olduğunu onaylayın
    4. Bağlantıyı test etmek için daha basit bir istem deneyin
  </Tab>

  <Tab title="İzin istemleri çok sık geliyor">
    **Çözüm:** "Switch Permission" düğmesini kullanarak Auto-Run Mode'a geçin. Bu, güvenli okuma işlemlerini otomatik olarak onaylarken dosya düzenlemeleri ve komutlar için yine de onay ister.
  </Tab>
</Tabs>

***

## Yardım alma [#yardım-alma]

* **Discord topluluğu**: [https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq) - Gerçek zamanlı destek sunan aktif topluluk
* **Dokümantasyon**: Bu dokümantasyondaki diğer kılavuzlara göz atın
* **Geri bildirim**: Sorunları bildirmek veya iyileştirmeler önermek için Verdent'in üst çubuğundaki Feedback düğmesini kullanın

***

## SSS [#sss]

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

<Accordion title="Kredilerim biterse ne olur?">
  Standart kredi tabanlı istekler bakiyeniz sıfıra ulaştığında durur. Devam etmek için bir sonraki faturalandırma döngüsü yenilemenizi bekleyin veya tek seferlik ek kredi yüklemesi satın alın.
</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ı konuşma bağlamını korur.
</Accordion>

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

***

## Sonraki adımlar [#sonraki-adımlar]

Verdent'i yüklediniz, ilk görevinizi tamamladınız ve temel iş akışını öğrendiniz. İşte bundan sonra gidebileceğiniz yerler:

<CardGroup cols="2">
  <Card title="Temel kavramlar" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    Alt aracıları, çoklu aracı mimarisini ve bağlam yönetimini anlayın
  </Card>

  <Card title="Yaygın iş akışları" icon="code" href="/docs/verdent-for-vscode/common-workflows/multi-step-tasks">
    Çok adımlı görevler, büyük kod tabanları ve sürüm kontrolü için adım adım kılavuzlar
  </Card>
</CardGroup>
