Sıfırdan başlayın, bilgisayarınıza doğal dili anlayan, kod yazan ve otomatik çalışan Claude Code'u kurun ve ilk işlevsel ürününüzü oluşturmak için kullanın.
Başlarken
- Tamamen Yeni Başlayanlar: 1. ve 5. Bölümleri sırayla takip edin. İlk web aracınızı çalıştırdığınızda resmen başlamış olacaksınız.
- Hatalarla Karşılaştığınızda: Ekran görüntüsü alın ve Claude Code veya Doubao'ya verin. "Hangi adımda olduğumu ve hangi hatayı gördüğümü" açıklayın. Bu, kendi başınıza Google'da arama yapmaktan 10 kat daha verimlidir.
Bölüm 1: Temel Kavramlara Hakim Olmak
Canlı yayınları veya kılavuzları anlayamıyorsanız, bunun nedeni genellikle zeki olmamanız değil, terimlerin birbiriyle bağlantılı olmamasıdır. Bu bölüm, sürekli karşınıza çıkacak kelimeleri açıklıyor.
1.1 Üç Temel Kavram
1Model = Beyin (Sadece düşünür, eli ayağı yok)2Sohbet Robotu = Beyin + Ağız (Konuşabilir ama yapamaz)3Ajan = Beyin + Eller/Ayaklar + Alet Çantası (Konuşabilir ve yapabilir)
- Model: GPT, Claude, Gemini, DeepSeek, Doubao, Qwen, Kimi, GLM, MiniMax... bunlar modellerdir, yani "beyin."
- Sohbet Robotu: ChatGPT web, Doubao Uygulaması, DeepSeek diyalog kutusu. Sorarsın, cevap verir, ama işi kendin yapmak zorundasındır.
- Ajan: "Bana bir web sitesi kurmama yardım et" dersin, o da bilgisayarında klasörler oluşturur, kod yazar, çalıştırır ve hataları düzeltir, sonunda sana "bitti" der. Claude Code bir Ajan'dır.
Aynı model, farklı araçlarda çok farklı yeteneklere sahiptir. Aynı Claude modeli tarayıcıda sadece bir sohbettir, ancak Claude Code'da kendi başına kod yazabilir.
1.2 Token, Bağlam, Dizgin
- Token: AI'nın metni anlamak için kullandığı en küçük birim. 1 Çince karakter yaklaşık 1-2 Token'dır; 1 İngilizce kelime yaklaşık 1 Token'dır. Token'lar sizin "elektrik faturanızdır." Öğrenme aşamasında Token'lardan kAZanmayın.
- Bağlam: Bu konuşma turundaki her şey. AI'nın uzun süreli belleği yoktur; sadece "masasında" ne varsa ona başvurabilir.
- Bağlam Penceresi: Her modelin "masasının" boyutu. 2026'da ana akım modeller 1 milyon Token'a (yaklaşık 700-800 bin kelime) ulaştı.
- Bağlam Kirliliği: Aynı pencerede farklı şeyler hakkında konuşmak AI'nın kafasını karıştırır. Bir pencere bir görev içindir; yeni bir konu için yeni bir pencere açın.
- Dizgin / Bağlam Mühendisliği: Bir yazılım değil, AI'ya hakim olmak için bir dizi yöntemdir—bilgiyi nasıl organize edeceğiniz, bağlamı nasıl yöneteceğiniz, AI'ya nasıl rehberlik edeceğiniz ve sonuçları nasıl doğrulayacağınız. Claude Code harikadır çünkü Dizgin'i en olgun olanıdır.
1.3 Yetenek (Skill) Nedir?
Bir Yetenek, Claude için bir SOP El Kitabı'dır.
McDonald's Big Mac'leri dünyanın her yerinde aynı tadı verir çünkü her şubede bir usta aşçı vardır, her şubede bir SOP vardır. Bir Yetenek, Claude için bu SOP'dur—"önce ne yapılacağını, sonra ne yapılacağını, hangi araçların kullanılacağını ve başarının ne olduğunu" tanımlar.
- Bir kez yaz, tekrar tekrar kullan.
- Kendi SOP'unuzu yazmak, iş deneyiminizi Claude'a "öğretmek" gibidir; sizin "sanal çalışanınız" olur.
1.4 Üç Ödeme Yöntemi
En gerçekçi çözüm: Yerli model API'leri + tek tıkla geçiş için cc-switch kullanın. Detaylar Bölüm 3'te.
1.5 Kurulumdan Önce Bilinmesi Gereken Yardımcı Araçlar
1.6 MCP — Ajanlar için "Priz Standardı"
MCP, Model Context Protocol anlamına gelir.
Bunu bir priz standardı olarak düşünün—Ajanların çeşitli harici araçlara ve veri kaynaklarına (Feishu, veritabanları, tarayıcılar, Xiaohongshu, WeChat vb.) bağlanmasını sağlar.
Analoji:
- Bir USB portu, bilgisayarınıza çevre birimleri takmanızı sağlar; bir hoparlör takarsanız, bilgisayar "müzik çalma" yeteneği kazanır.
- MCP, Claude Code'a araçlar takmanızı sağlar; Tavily takarsanız, "gerçek zamanlı trendleri arama" yeteneği kazanır; xiaohongshu-mcp takarsanız, "Xiaohongshu'ya gönderi yapabilir".
Varsayılan olarak, Claude Code yalnızca ona verdiğiniz bilgileri işler ve internette aktif olarak arama yapmaz. Arama yapmak, veritabanlarını okumak veya harici API'leri çağırmak için MCP'ye ihtiyacınız vardır.
1.7 Çoklu Ortam — AI Sadece "Yazı Okumaktan" Daha Fazlasını Yapar
Ortam, bilgi türüdür. Metin bir ortamdır; görüntüler, ses ve video diğerleridir.
- Tek Ortamlı: Yalnızca metin işleyebilir.
- Çoklu Ortam: Metin, görüntü, ses, video, dosya ve ekranı aynı anda işleyebilir.
2026'da ana akım model desteği:
Giriş ≠ Çıkış
AI'nın bir ortamı "görebilmesi", onu "oluşturabileceği" anlamına gelmez.
- Görüntüler: Neredeyse tüm ana akım modeller görüntüleri görebilir; yalnızca bazıları onları çizebilir (GPT Image, Gemini, Doubao Seedance, Jimeng, Nano Banana vb.).
- Video: Gemini, Doubao ve Kimi video izleyebilir; ancak LLM'ler doğrudan video yapmaz; bunun için özel araçlar kullanırlar (Wan, Seaweed Dance, Jimeng).
Model Güçlü Yönleri:
Yeni başlayanlar için pratik tavsiye: Sadece yazmayın; ekran görüntülerini, kayıtları ve videoları doğrudan AI'ya atmayı öğrenin verimliliği artırmak için.
1.8 AI Araçları Manzarası (Kim Kimdir?)
Farklı araçlar hakkındaki kafa karışıklığını giderecek bir harita.
Ajan Araçları (İşinize yardımcı olur)
``text
Ajan Araçları
├── Komut Satırı (Terminal tabanlı, en güçlü)
│ ├── Claude Code —— Anthropic tarafından, şu anda en güçlüsü, bu kılavuzun yıldızı
│ └── Codex CLI —— OpenAI tarafından, açık kaynak
│
├── GUI (Görsel arayüz, kullanıcı dostu)
│ ├── Codex Desktop/Web —— OpenAI tarafından
│ ├── Claude Cowork —— Anthropic tarafından, teknik olmayan kullanıcılar için
│ ├── Trae Solo —— ByteDance tarafından, yerli, Kod ve MTC modlarına sahip
│ ├── WorkBuddy —— Tencent tarafından, yerli, geliştirici olmayan ofis işleri için
│ └── Kiro —— AWS tarafından, spesifikasyon odaklı IDE (VS Code çatalı)
│
├── Otonom (Arka planda çalışır)
│ ├── OpenClaw —— Eski adıyla Clawdbot, açık kaynak, WeChat/TG üzerinden uzaktan kontrol
│ └── Hermes —— Nous Research tarafından, açık kaynak, kalıcı bellek
│
└── İş Akışı Orkestrasyonu (Yapı taşı otomasyonu)
└── COZE —— ByteDance tarafından, sürükle-bırak iş akışları
``
Sohbet Robotu Araçları (Sizinle konuşur)
``text
Sohbet Robotu
├── Yurtdışı
│ ├── ChatGPT (GPT modeli)
│ ├── Claude.ai (Claude modeli)
│ ├── Gemini (Google modeli)
│ └── Grok (xAI/Elon Musk, X ile ilgili görevler için)
│
└── Yerli
├── Doubao (ByteDance)
├── DeepSeek (Yüksek maliyet-performans)
├── Qwen (Alibaba)
├── Kimi (Moonshot AI)
├── WeChat Yuanbao (Tencent, güçlü WeChat ekosistemi verileri)
└── GLM / Zhipu Qingyan (Zhipu AI)
``
Yorumlarda Sık Kullanılan "Argo" Terimler:
1.9 İlişkinin Tek Cümlelik Özeti
1Siz (İnsan)2 ↕ Doğal Dil3Claude Code (Ajan) —— MCP aracılığıyla harici araçlara bağlanır4 ↕ Çağrı5Model (Claude / GLM / MiniMax / Kimi…)6 ↕ Tüketir7Token (Elektrik faturası)
Bölüm 2: Ortamın Kurulması
Sırayla 4 şeyi kurun: Git → Node.js → VS Code → Claude Code.
2.1 Çip Türünü Onaylayın
- Mac: Apple Simgesi -> Bu Mac Hakkında. M1/M2/M3/M4 ARM'dir; Intel x86_64'tür.
- Windows: "Bu Bilgisayar"a sağ tıklayın -> Özellikler. Intel/AMD x86_64'tür.
2.2 Git'i Kurun
- Mac: Terminal'i açın, şunu yapıştırın:
/bin/zsh -c "$(curl -fsSL https://gitee.com/happyaicoder/HomebrewCN/raw/master/Homebrew.sh)".git --versionile doğrulayın. - Windows: https://git-scm.com/ adresinden indirin. Varsayılan ayarları kullanın.
2.3 Node.js'i Kurun (18+, 20 veya 22 önerilir)
- Mac: Şunu yapıştırın:
/bin/bash -c "$(curl -fsSL https://gitee.com/iamzhihuix/nvm-install-cn/raw/main/install.sh)".node -vile doğrulayın. - Windows: https://nodejs.org/ adresinden LTS sürümünü indirin. PowerShell'de
npm -vbaşarısız olursa, şunu çalıştırın:Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.
2.4 VS Code'u Kurun
https://code.visualstudio.com/ adresinden indirin. Windows'ta "Add to PATH" ve "Open with Code" seçeneklerini işaretleyin.
2.5 Claude Code'u Kurun
- Mac:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. İzin reddedilirsesudokullanın. - Windows: PowerShell'i Yönetici olarak çalıştırın, ardından:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com.
2.6 Sık Karşılaşılan Hata Giderme
Bölüm 3: Claude Code'u Yerli Modellerle Yapılandırma
Claude Code kabuktur; bir modele (beyne) ihtiyacı vardır. Resmi Claude modelleri yurtdışı kredi kartı gerektirir ve yasaklanma riski taşır. Yerli kullanıcılar için en gerçekçi çözüm, yerli modellerle cc-switch kullanmaktır.
3.1 Bir Model Seçin
Yeni Başlayanlar İçin Öneri: MiniMax Kodlama Planı (29 RMB/ay).
3.2 cc-switch'i Kurun
GitHub veya Gitee Aynası adresinden indirin.
3.3 API Anahtarı Alın (Örnek: MiniMax)
- MiniMax Platformu adresine kaydolun.
- Bir Kodlama Planı satın alın.
- Kodlama Planı Anahtarını (normal API Anahtarı değil) kopyalayın.
3.4 cc-switch'te Yapılandırın
- cc-switch'i açın, Claude simgesine tıklayın.
- +'ya tıklayın, sağlayıcıyı seçin (örn. MiniMax), Anahtarı yapıştırın ve Ekle'ye tıklayın.
- Farenizi modelin üzerine getirin ve "Etkinleştir"e tıklayın.
3.5 Doğrulayın
Terminalde claude yazın. Şunu sorun: "Sen hangi modelsin?" MiniMax/GLM cevabı verirse, hazırsınız.
Bölüm 4: Claude Code Temel İşlemleri
4.1 Başlatmanın İki Yolu
- Terminal: VS Code'da bir klasör açın, terminali açın,
claudeyazın. - Eklenti: VS Code'da Anthropic tarafından sağlanan "Claude Code" uzantısını kurun.
4.2 Temel Kısayollar
4.3 Üç Çalışma Modu
Plan modu çok önemlidir—Claude harekete geçmeden önce adımları düşünür. Karmaşık özellikler için kullanın.
4.4 Normal ve Derin Düşünme (ultrathink)
4.5 YOLO Modu (Eller Serbest)
Her dosya değişikliği için izin istemeyi atlar. Kullanım: claude --dangerously-skip-permissions.
4.6 Tercihler için CLAUDE.md
Proje kök dizininde bir CLAUDE.md dosyasına tercihlerinizi yazın (örn. "Yorumlar için Türkçe kullan").
Bölüm 5: Bir "Erken Okuma Aracı" Oluşturma
5.1 Dizin ve PRD Oluşturun
VS Code'da prd.md oluşturun ve mikrofon ses seviyesi bir eşiği aştığında emoji hayvanları oluşturan bir HTML/JS uygulaması için gereksinimleri yazın.
5.2 Uygulama
Terminalde claude --dangerously-skip-permissions çalıştırın ve şunu yazın: @prd.md bu özelliği uygula.
5.3 Sonuç
Bir tarayıcıda index.html dosyasını açın, mikrofon erişimine izin verin ve hayvanların görünmesi için konuşun.
Bölüm 6: İş Akışı Becerilerinde Ustalaşma
Yetenekler yeniden kullanılabilir SOP'lardır. Bir Yetenek, bir SKILL.md (yapılandırma), betikler ve şablonlar içerir.
6.2 npx skills Kullanma
Tek komutla yetenekleri kurun: npx skills add jimliu/baoyu-skills. Yeteneği ve hedefi seçin (Claude Code).
6.3 Yetenek Depoları
6.5 Özel Bir Yetenek Oluşturma: Otomatik-Resimleme
APImart'ın Nano Banana 2 API'sini kullanarak, yazdığınız her makale için 3 el çizimi tarzında illüstrasyon oluşturan bir yetenek yaratın.
6.6 Yetenek vs MCP vs Kancalar vs Eklenti
- Yetenek: Tarif (Aşçı için adımlar).
- MCP: Hizmetler (Mutfak için Su/Elektrik/Gaz).
Bölüm 7: Donanım ve Ağ
- Mac, birleşik bellek nedeniyle AI için daha iyidir, ancak Windows da gayet iyi çalışır.
- MCP veya görüntü oluşturma ile ilgili ağ hatalarıyla karşılaşırsanız, proxy'nizde (ör. clash.verge) TUN modunu kullanın.
Ek A: Komut Referansı
claude, /skills list, /clear, /compact, /doctor, /model.
Ek B: Sık Karşılaşılan Hatalar
Ek C: Terimler Sözlüğü
Son Sözler
Önce yola çıkın, sonra sürüş tekniklerinden bahsedin. 2-5. Bölümlerle başlayın. AI, 10x-100x verimlilik çarpanıdır. Bugün başlayın.
