Ana içeriğe geç
Studio kurulum rehberleri Web sitem yok

Studio'yu ücretsiz bir Cloudflare hesabına kurun

Web siteniz, alan adınız ve barındırmanız yok mu? Studio, size ait ücretsiz bir Cloudflare hesabında çalışabilir. Paylaşım bağlantılarınız bu durumda şuna benzer bir adreste yer alır: snaps.yourname.workers.dev

En iyi
Web sitesi olmayan ya da web sitesi Wix, Squarespace veya Shopify üzerinde olan kişiler.
İhtiyacınız olanlar
Windows veya Mac için Maxisnap (Studio'su olan hesapla oturum açılmış); Cloudflare için bir e-posta adresi; Cloudflare depolamayı açmadan önce isterse diye bir kart veya PayPal; ve bilgisayarınızda bir yapay zeka kodlama asistanı ya da Node.js 20 veya daha yeni sürümün kurulu olduğu bir terminal.
Süre
İlk seferde yaklaşık 20 dakika.
Elde edeceğiniz
workers.dev ile biten bir adreste özel bir kitaplık ve markalı paylaşım bağlantıları. Kendi alan adınızı daha sonra hiçbir şey kaybetmeden ekleyebilirsiniz.
Maliyet
Studio, Cloudflare'in ücretsiz planında çalışacak şekilde tasarlanmıştır. Cloudflare, R2'nin güncel ücretsiz kullanım hakkını ve fiyatlarını yayımlar.

Bu yöntem nasıl çalışır

Ücretsiz bir Cloudflare hesabı oluşturur ve depolamasını açarsınız. Ardından bilgisayarınızdaki Claude Code, Codex veya Cursor gibi bir yapay zeka kodlama asistanı, Studio'nuzu oluşturmak için Studio paketindeki dağıtım aracını kullanır ve her değişiklikten önce size sorar.

Dağıtım aracı hesabınızda üç şey oluşturur: Studio uygulaması (Cloudflare buna Worker der), yakalamalarınız için depolama alanı (R2) ve kitaplığınız ile ekibiniz için küçük bir veritabanı (D1). Hesaptaki başka hiçbir şey değişmez. Terminalde rahat mısınız? Aynı aracı geliştirici rehberiyle kendiniz çalıştırın.

Cloudflare hesabınızı oluşturun

  1. Cloudflare'in kayıt sayfasını tarayıcınızda açın: dash.cloudflare.com/sign-up
  2. Her gün kontrol ettiğiniz bir e-posta adresi kullanın. İş adresi de olur. Güçlü bir parola seçin ve güvenli bir yerde saklayın.
  3. E-postanızı doğrulayın: Cloudflare bir bağlantı gönderir. Devam etmeden önce ona tıklayın, aksi hâlde bazı adımlar reddedilir. Gelmezse spam klasörünüze bakın.
  4. Cloudflare'in web sitesi ekleme sorularını atlayabilirsiniz. Bir web sitesine ihtiyacınız yok.
Ekranda göreceğiniz Cloudflare'in kayıt sayfası e-posta adresinizi ve bir parola ister. Ardından Cloudflare önce ne yapmak istediğinizi sorabilir; bunu atlayabilirsiniz.

Depolamayı açın

Ekran görüntüleriniz ve videolarınız Cloudflare R2'de saklanır. Hesabınız için bir kez açın:

  1. Cloudflare panelinde Storage & databases → R2 → Overview sayfasını açın.
  2. R2'yi hesabınıza eklemek için Cloudflare'in ödeme işlemini tamamlayın. Cloudflare isterse bir kart veya PayPal ekleyin.

Studio paneliniz ne kadar depolama kullandığınızı gösterir. Cloudflare'in Ekim 2026'da okunan R2 belgeleri, R2'ye başlamanın ücretsiz olduğunu, aylık ücretsiz kullanımın dahil olduğunu ve kullanımınız için aylık olarak faturalandırıldığınızı belirtir.

Ekranda göreceğiniz Cloudflare'in R2 genel bakış sayfası: R2'yi hesabınıza eklemek için bir düğme ve Cloudflare isterse bir kart veya PayPal formu.

Studio'yu bilgisayarınıza indirin

  • Windows'ta: Maxisnap'te Ayarlar → Hesap → Maxisnap Studio kurulum sihirbazını açın, “Başlayın” düğmesine, ardından “Paneli indir” düğmesine tıklayın. Maxisnap, Studio ZIP dosyasını İndirilenler klasörünüze kaydeder ve o klasörü açar.
  • Mac'te: Maxisnap'te Settings → Welcome & Help → Studio Setup Guide bölümünü açın, “Get Started” düğmesine, ardından “Download Dashboard” düğmesine tıklayın. Maxisnap, Studio ZIP dosyasını İndirilenler klasörünüze kaydeder.

ZIP dosyasını ayıklayın. Windows'ta dosyaya sağ tıklayın ve “Tümünü Ayıkla” seçeneğini seçin. Mac'te dosyaya çift tıklayın.

Logonuzu ve renklerinizi en baştan kullanmak ister misiniz? “Maxisnap Studio - Start Here.html” dosyasına çift tıklayın, markalamanızı tasarlayın ve “Lock in my branding” düğmesine tıklayın. Asistanınız bunu kullanır. Ya da bu adımı atlayın ve markalamayı daha sonra panelinizde Branding bölümünden değiştirin.

Ekranda göreceğiniz Ayıklanmış Studio klasörü: üç klasör (cloudflare, docs ve snaps), Start Here sayfası ve yapay zeka asistanları için yönergeler.

İşi yapay zeka asistanınıza devredin

  1. Yapay zeka kodlama asistanınızı açın: Claude Code, Codex, Cursor veya bilgisayarınızda komut çalıştırabilen başka bir asistan.
  2. Hazır yönergeleri yapay zeka asistanı rehberinden kopyalayın, açılı parantezler içindeki satırı Studio klasörünüzle değiştirin ve yapıştırın.
  3. Web siteniz olmadığını ve Studio'nun ücretsiz Cloudflare sürümünü istediğinizi söyleyin. Asistan, Studio klasörünüzdeki yönerge dosyasını okur ve her adımı yapmadan önce açıklar.

Hazır yönergeleri alın.

Dağıtım aracı için bilgisayarınızda Node.js 20 veya daha yeni bir sürüm gerekir; asistanınız bunun kurulu olup olmadığını kontrol edebilir. Yönergeler, asistanınıza bir şey oluşturmadan önce size sormasını, hesabınızda zaten bulunan hiçbir şeyi silmemesini veya üzerine yazmamasını söyler.

Asistanınız istediğinde bir Cloudflare anahtarı oluşturun

Dağıtımın, Studio'nuzu hesabınızda oluşturmak için izne ihtiyacı var. Bu izni bir Cloudflare API token'ı ile verirsiniz; bu token yalnızca bu iş için bir parola gibi işlev görür.

  1. Cloudflare'de My Profile → API Tokens bölümünü açın, “Create Token” düğmesine tıklayın ve özel bir token oluşturmayı seçin.
  2. Şu dört izni ekleyin: Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit ve D1 Edit.
  3. “Continue to summary” düğmesine, ardından “Create Token” düğmesine tıklayın. Cloudflare token'ı yalnızca bir kez gösterir; bu yüzden hemen kopyalayın.
  4. Asistanınız istediğinde token'ı sohbete değil, terminale kendiniz yapıştırın.

Cloudflare'in API Tokens sayfasını açın.

Studio'nuz çalışmaya başladıktan sonra token'ı silebilirsiniz. Studio'nuz çalışmaya devam eder; daha sonra güncellemek veya kaldırmak için aynı izinlere sahip yeni bir token gerekir.

Ekranda göreceğiniz Cloudflare'in token sayfası: her izin için bir satır ve altta bir “Continue to summary” düğmesi.

Studio'nuzun adresini seçin

  1. Asistanınıza küçük harf, rakam ve tire içeren bir Studio adı söyleyin. Varsayılan ad snaps'tir.
  2. Cloudflare hesabınızın henüz bir workers.dev adı yoksa plan bir ad ister ve asistanınız size sorar. Bu ad hesaptaki her şey tarafından paylaşılır ve sonradan değiştirmesi zordur; bu yüzden şirketinizin adı iyi bir seçimdir.

Adresiniz şuna benzeyecek: snaps.yourcompany.workers.dev

Kendi alan adınızı daha sonra hiçbir şey kaybetmeden ekleyebilirsiniz.

Planı kontrol edin, ardından Studio'nuzu oluşturun

Siz evet demeden hiçbir şey oluşturulmaz. Asistanınız önce planı çalıştırır ve size gösterir. “Will create” bir Worker, bir R2 kovası ve bir D1 veritabanını listeler; workers.dev adınız yeniyse onu da listeler. “Will not touch” ise hesaptaki diğer her şeyi listeler.

  1. Plan doğru göründüğünde asistanınıza devam etmesini söyleyin. Studio'nuzun oluşturulması yaklaşık bir dakika sürer.
  2. Dağıtım yarıda kalırsa, aynı komut yeniden çalıştırıldığında hiçbir şeyi iki kez oluşturmadan kaldığı yerden devam eder.
Ekranda göreceğiniz Asistanınız planı gösterir: Studio adresi, ardından “Will create” ve “Will not touch”.

Yönetici anahtarınızı kaydedin

  1. İş bittiğinde dağıtım, Studio'nuzun adresini ve Yönetici anahtarını yalnızca bir kez gösterir. Anahtarı parola yöneticiniz gibi güvenli bir yerde saklayın. Panelinizde onunla oturum açarsınız ve ona sahip olan herkes Studio'nuzu kullanabilir.
  2. Dağıtım ayrıca cloudflare klasörüne deployment.json adlı bir dosya yazar. Bu dosyayı saklayın, çünkü Studio'nuzu daha sonra güncellerken veya kaldırırken bu dosya kullanılır.

Maxisnap'i bağlayın ve deneyin

  • Windows için Maxisnap: Ayarlar → Hesap → Maxisnap Studio kurulum sihirbazını açın, “Başlayın” düğmesine tıklayın, ardından “Maxisnap'ı bağlayın” başlıklı 4. adıma gelene kadar “İleri” düğmesine tıklayın. Studio'nuzun adresini ve anahtarını yapıştırın, “Bağlantıyı test et” düğmesine, ardından “İleri” düğmesine, son sayfada da “Bitir ve Kaydet” düğmesine tıklayın. Hem kurulumda gösterilen Yönetici anahtarı hem de panelinizdeki People & access bölümünden alınan bir yükleme kodu çalışır.
  • Mac için Maxisnap: Settings → Welcome & Help → Studio Setup Guide bölümünü açın ve “I already have a dashboard” seçeneğini seçin. Studio'nuzun adresini ve anahtarını yapıştırın, “Test Connection” düğmesine, ardından “Next” düğmesine, sonra da “Finish & Save” düğmesine tıklayın.

Bir şey yakalayın ve düzenleyicide “Yükle” düğmesine tıklayın. Windows'ta Ctrl+Alt+7 bir bölgeyi yakalar ve hemen yükler. Paylaşım bağlantısı panonuza kopyalanır.

Windows için Maxisnap ve Mac için Maxisnap, her yüklemeyi Cloudflare'deki bir Studio'ya tek bir istekte gönderir ve Studio bunu dosya başına 25 MB'a kadar kabul eder.

Sonraki adımlar: ekibinizi panelde People & access altından ekleyin (herkes kendi kodunu ve rolünü alır) ve logonuzu veya renklerinizi istediğiniz zaman Branding altından değiştirin.

Bir şeyler ters giderse

Cloudflare önce e-postanızı doğrulamanızı istiyor

Cloudflare needs you to verify your email address first. Check your inbox for Cloudflare’s email, click the link, then try again.

Kaydolduğunuzda Cloudflare'in gönderdiği e-postayı açın ve bağlantısına tıklayın. Gelen kutunuzda yoksa spam klasörünüze bakın. Ardından aynı adımı yeniden deneyin.

Cloudflare yeni hesabınızı hâlâ inceliyor

Cloudflare is still reviewing this new account. This usually clears within a day; try again later.

Cloudflare, bazı yeni hesaplar herhangi bir şey oluşturabilmeden önce onları kontrol eder. Kurulumunuzda bir sorun yok. Bekleyin, ardından yeniden deneyin; daha önce oluşturulmuş her şey korunur.

Depolama açık değil

R2 storage is not turned on for this Cloudflare account yet.

2. adımdaki gibi Cloudflare panelinde R2'yi açın, ardından asistanınızdan planı yeniden çalıştırmasını isteyin.

Cloudflare bir kart veya PayPal istiyor

Bu beklenen bir durumdur. Cloudflare, ücretsiz kullanım hakkının sınırları içinde kalsanız bile R2'yi açmadan önce bir kart veya PayPal isteyebilir. Studio paneliniz ne kadar depolama kullandığınızı gösterir; böylece takip edebilirsiniz.

Studio adı zaten kullanımda

A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.

Asistanınıza başka bir ad söyleyin, örneğin snaps-yourcompany. Bir depolama ya da veritabanı adı alınmışsa dağıtım aracı sıradaki boş adı kendisi seçer.

workers.dev adı alınmış

That workers.dev name is taken. Pick another one.

O adı başka biri zaten kullanıyor. Şirket adınıza bir sözcük ekleyerek deneyin, örneğin yourcompany-studio. Bu ad, bu Cloudflare hesabındaki her adresin parçası olur; bu yüzden ileride de kullanmaktan memnun olacağınız bir ad seçin.

Cloudflare bir adımı reddetti

Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.

Token'da bir izin eksik. 5. adımdaki izinlerle yeni bir token oluşturun ve asistanınız istediğinde onu yeniden terminale yapıştırın.

Kurulum yarıda kaldı

Asistanınızdan aynı dağıtım komutunu yeniden çalıştırmasını isteyin. Komut kaldığı yerden devam eder ve hiçbir şeyi iki kez oluşturmaz.

Yeni adresiniz henüz açılmıyor

Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.

Her şey oluşturuldu; Cloudflare adresi hâlâ etkinleştiriyor. Birkaç dakika bekleyin, ardından adresi yeniden açın.

Yönetici anahtarınızı kaybettiniz

Asistanınız yeni bir anahtar belirleyebilir. Bunun için şu komutu, Studio paketinizin cloudflare klasöründen, terminaldeki bir Cloudflare token'ıyla çalıştırır. Komut yeni anahtarı yalnızca bir kez gösterir; ardından Maxisnap'i bu anahtarla yeniden bağlayın.

node deploy/cli.mjs update --record deployment.json --yes --new-admin-key

Büyük videolar yüklenmiyor

Windows için Maxisnap ve Mac için Maxisnap, her yüklemeyi Cloudflare'deki bir Studio'ya tek bir istekte gönderir ve Studio bunu dosya başına 25 MB'a kadar kabul eder.

Kayıtları bu boyutun altında tutun ya da yüklemeden önce kırpın.

Maxisnap anahtarın doğru olmadığını söylüyor

Anahtarı kaydettiğiniz yerden, başında ve sonunda boşluk olmadan yeniden kopyalayın. Adresi de kontrol edin; bu, kurulumda size gösterilen adrestir ve şununla başlar: https://.

Paylaşım bağlantıları “Error 1027” gösteriyor

Studio'nuz Cloudflare'in ücretsiz planının günlük istek sınırına ulaştı. Sınır, UTC gece yarısı sıfırlanır. Bir paylaşım bağlantısını açmak yaklaşık iki istek kullanır.

Hâlâ yardıma mı ihtiyacınız var?

Bize e-posta gönderin; bir kişi, genellikle bir iş günü içinde size geri yazar. Bu bilgiler, size tek seferde yanıt vermemize yardımcı olur:

  • Seçtiğiniz kurulum seçeneği ve bulunduğunuz adım.
  • Ekranın bir ekran görüntüsü, varsa hata mesajının tamamıyla birlikte.
  • Studio'nuzun nereye kurulacağı: yeni ya da mevcut bir Cloudflare hesabı veya web barındırma şirketinizin adı.
  • Maxisnap sürümünüz: Windows'ta Ayarlar, ardından Hakkında; Mac'te Maxisnap altında, ardından About Maxisnap.

Lütfen Yönetici anahtarınızı, bir Cloudflare anahtarını veya bir parolayı göndermeyin. Size yardım etmemiz için bunlara ihtiyacımız yok.

Diğer kurulum rehberleri