Claude Code ile kod bilmeden tek sayfalık site yapıp GitHub Pages'te yayınlama

Bir kahve dükkânın, atölyen ya da kişisel işin için basit bir sayfa istiyorsun ama kod bilmiyorsun. Bu rehberde Claude Code'a Türkçe tarif ederek tek sayfalık bir site yaptıracak, git komutlarını ona çalıştıracak ve siteyi GitHub Pages ile yayına alacaksın.

Baştan dürüst olalım: Claude Code ücretsiz değil. Anthropic'in kurulum belgesine göre Pro, Max, Team, Enterprise ya da Console hesabı gerekir; ücretsiz claude.ai planı Claude Code'u kapsamaz. GitHub tarafı ise ücretsiz hesapla çalışır.

Başlamadan önce gerekenler

• Ücretli bir Claude planı (Pro ya da üstü) veya Console hesabı.
• Ücretsiz bir GitHub hesabı.
• Bilgisayarında Git. Terminalde git --version yazınca bir sürüm numarası görmelisin. Windows'ta Git for Windows kur; içinde, GitHub'a bağlanırken tarayıcıdan giriş yapmanı sağlayan Git Credential Manager da gelir (GitHub belgesi).

1. Claude Code'u kur

Terminali aç ve sistemine uygun resmî komutu yapıştır (resmî hızlı başlangıç):

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell (satırın başında PS C:\ görürsün):

irm https://claude.ai/install.ps1 | iex

Komut indirirken ilerleme göstermez; bitince yeni bir terminal penceresi aç ve şunu yaz:

claude --version

Bir sürüm numarası görüyorsan kurulum tamam. Terminalle uğraşmak istemiyorsan Anthropic'in masaüstü uygulaması da Claude Code'u terminalsiz kullanmanı sağlar; bu rehber terminal yolunu anlatıyor ama aşağıdaki istemleri orada da yazabilirsin.

2. Proje klasörünü aç ve Claude Code'u başlat

Masaüstünde boş bir klasör oluştur, örneğin kose-kahve. Terminalde o klasöre geç ve Claude Code'u başlat:

cd Desktop/kose-kahve
claude

İlk açılışta giriş ister; tarayıcıda açılan pencereden Claude hesabınla giriş yap. Bir kez giriş yaptıktan sonra tekrar sormaz.

3. Siteyi Türkçe tarif et

Claude Code'un istem satırına ne istediğini açık açık yaz. Örnek istem:

Kahve dükkânım için tek sayfalık bir site yap. Dükkânın adı Köşe Kahve.
Bölümler: kısa bir karşılama yazısı, 5 içecekten oluşan menü (fiyat yazma),
adres, çalışma saatleri ve tıklayınca arayan bir telefon bağlantısı.
Her şey tek bir index.html dosyasında olsun, dış kütüphane kullanma,
telefonda düzgün görünsün.

Dosyanın adının index.html olması önemli: GitHub Pages sitenin giriş dosyası olarak index.html, index.md ya da README.md arar.

Claude Code dosyayı yazmadan önce değişikliği gösterip onay isteyebilir; uygunsa Yes de.

4. Bak, beğenmediğini söyle

Klasördeki index.html dosyasına çift tıkla; tarayıcıda açılır. Beğenmediğin yeri yine Türkçe yaz:

Arka planı koyu kahverengi yap, başlığı büyüt, menüyü iki sütuna böl.

Dosyayı Claude Code düzeltir, sen tarayıcıda sayfayı yenileyip bakarsın. Memnun kalana kadar tekrarla.

5. GitHub'da boş bir depo aç

1. GitHub'da sağ üstteki + simgesine tıkla, New repository seç.
2. Depo adını yaz, örneğin kose-kahve.
3. Görünürlüğü Public seç. Ücretsiz hesapta Pages için depo herkese açık olmak zorunda.
4. README, lisans ya da .gitignore ekleme. GitHub'ın belgesine göre boş depo, ilk gönderimde çıkacak hataları önler.
5. Depoyu oluştur ve sayfadaki https://github.com/KULLANICI/kose-kahve.git adresini kopyala.

6. Gönderimi Claude Code'a yaptır

Claude Code'a şunu yaz (adresi kendininkiyle değiştir):

Bu klasörü git deposu yap, ilk commit'i at ve
https://github.com/KULLANICI/kose-kahve.git adresine main dalı olarak gönder.

Claude Code genelde şu komutları çalıştırır; her birini onayından geçirir:

git init -b main
git add .
git commit -m "İlk site"
git remote add origin https://github.com/KULLANICI/kose-kahve.git
git push -u origin main

GitHub'ın belgesi Windows için son satırı -u olmadan (git push origin main) gösterir; ikisi de aynı dalı gönderir. İlk gönderimde GitHub girişi için tarayıcı penceresi açılabilir; GitHub hesabınla onayla.

7. Pages'i aç

GitHub belgesindeki yol:

1. Deponun sayfasında Settings'e tıkla.
2. Sol menüde Pages'i seç.
3. Build and deployment altında Source için Deploy from a branch seç.
4. Dal olarak main, klasör olarak /(root) seç.
5. Save'e bas.

Siten https://KULLANICI.github.io/kose-kahve/ adresinde açılır. GitHub'a göre değişikliklerin yayına girmesi push'tan sonra 10 dakikayı bulabilir.

8. Sonra güncellemek

Klasörde Claude Code'u yeniden aç, ne değişecekse yaz, ardından "değişiklikleri commit edip GitHub'a gönder" de. Pages yeni hâli kendisi yayına alır.

Sık hatalar

• claude bulunamadı diyor: Kurulumdan sonra yeni terminal açmadın ya da kurulum klasörü PATH'e eklenmedi. Yeni pencere aç; olmuyorsa kurulum sorunları sayfasına bak.
• "The token '&&' is not a valid statement separator": CMD komutunu PowerShell'e yapıştırdın. PowerShell'de irm komutunu kullan.
• Giriş yapıyorum ama Claude Code çalışmıyor: Ücretsiz Claude planı Claude Code'u kapsamaz; Pro ya da üstü gerekir.
• Push reddedildi: Depoyu README ile oluşturduysan GitHub'daki dosya yerelde yoktur. Claude Code'a "uzak depodaki değişiklikleri çekip birleştir, sonra gönder" de.
• Pages menüsü yayın yapmıyor: Ücretsiz hesapta depo Private ise Pages çalışmaz; Settings'ten depoyu Public yap.
• Sayfa 404 veriyor: Dosyanın adı index.html değil ya da kök klasörde değil. Yayın klasörünü /(root) seçtiğinden emin ol. Değişiklik yeniyse 10 dakika bekle.
• Her şeyi herkes görür: Depo herkese açık olduğu için içine parola, API anahtarı ya da müşteri bilgisi koyma. GitHub'ın sınırlarına göre Pages, e-ticaret gibi ticari işlem siteleri için ya da parola ve kart bilgisi toplamak için kullanılmamalı; tanıtım sayfası için uygundur.

Takılırsan @jarvisasistan'a DM at ya da WhatsApp'tan yaz; hangi adımda ne yazdığını gönder, birlikte çözelim.