İçeriğe atla
← Hazır setler ve kurulum rehberleri

Kurulum rehberi · son kontrol 17 Ekim 2026

Yapay zeka kodlama kotan bitince işine devam ettiren alternatif ortam

Kodlama asistanının kotası dolunca projeni ayrı bir Git dalında OpenCode ile sürdürürsün: Gemini API anahtarını bağlarsın (OpenCode belgesi bu girdiyi ayrıca anlatmaz, listede görünmesi beklenir), küçük bir görev yaptırıp değişikliği kendin gözden geçirirsin.

Resmî belgelerden düzenlendi. Her adımın dayanağı altında yazılı.

Ne elde edersin

Projenin ayrı bir dalında çalışan, bağladığın sağlayıcının modelini kullanan ve değişiklikleri sana gösteren bir kodlama ortamı.

Nasıl çalışır

Sen başlatırsın. Aracı sen terminalden açarsın ve her değişikliği sen onaylarsın. Arka planda kendiliğinden çalışan bir şey kurulmaz.

Nerede çalışır

Windows · macOS · Linux

Maliyet neye bağlı

API kullanımı · Ücret yok · Kurulum hizmeti

Kime uygun

  • Kodlama asistanının kullanım kotası bitince işi durdurmak istemeyenler
  • Terminalde komut çalıştırmaktan çekinmeyen, projesi Git ile izlenen geliştiriciler ve küçük ekipler

Kime uygun değil

  • Müşteriye ait gizli kodu ya da kişisel veriyi ücretsiz katmandaki bir modele göndermek isteyenler: ücretsiz katman verini ürün geliştirmede kullanabilir (bkz. adım 3)
  • Önceki asistandaki sohbet geçmişinin ve aynı başarının taşınmasını bekleyenler: asistan değişince geçmiş sohbet taşınmaz
  • GitHub Models ücretsiz seçenek diye arayanlar: hizmet Temmuz 2026'da kapatıldı, bu rehberde seçenek değildir
  • Kotayı birden çok hesap, VPN ya da ücretsiz kotaları havuzlayan yönlendirici araçlarla aşmak isteyenler: bu rehber bunu önermez; sağlayıcıların şartları buna izin vermeyebilir

Sistem nasıl bağlanıyor

Projenin ayrı dalı → OpenCode → Gemini API anahtarı (OpenCode belgesi Google AI Studio girdisini ayrıca anlatmaz; listede görünmesi beklenir, görünmezse alternatif sağlayıcı) → o gün listede görünen model → proje talimatı → küçük görev → diff ve proje kontrolleri.

  • OpenCode gerekli

    Terminalde çalışan, bağladığın modelle kodu okuyup değiştiren ajan

    Araç rehberi

  • Google AI Studio / Gemini API gerekli

    Model sağlayıcısı: API anahtarı ve ücretsiz katman burada

    Araç rehberi

  • Freebuff isteğe bağlı

    Alternatif hazır araç (sınırlı katman)

    Alternatif: API anahtarı almadan reklamlı bir araçla denemek istersen

    Araç rehberi

  • OpenRouter isteğe bağlı

    Alternatif model sağlayıcısı

    Alternatif: Tek anahtarla birçok modeli denemek istersen

    Araç rehberi

Araçlar arası bağlantılar

  • OpenCode Gemini API · API ile otomatik · HTTPS isteği; API anahtarı /connect ile girilir ve yerel auth.json dosyasında saklanır · izin: Anahtar sahibinin kotası kadar model çağrısı
  • Proje dosyaları OpenCode · Dosya ile · Proje klasörü; talimatlar AGENTS.md dosyasından okunur

Başlamadan önce

Bilgisayar ve yazılım

  • İşletim sistemi: Windows, macOS, Linux
  • Git: kurulu, projen bir Git deposu
  • Node.js ve npm: OpenCode npm paketi olarak kurulur; Node.js'i resmî indirme sayfasından kur ve npm --version ile npm'in çalıştığını gör
  • Modern bir terminal uygulaması: OpenCode terminal arayüzü için gerekli; Windows'ta belge WSL kullanmanı önerir

Hesaplar

  • Google hesabı (Google AI Studio'da Gemini API anahtarı için) — OpenCode'a bağlayacağın model sağlayıcısı; Türkiye bu hizmetin kullanılabildiği ülkeler listesinde. Ücretsiz katman var; 18 yaş ve üzeri, profesyonel ya da iş amaçlı kullanım şartı. Ücretsiz katmanda gönderdiğin içerik Google tarafından ürün geliştirmede kullanılabilir. Ücretli katman faturalama hesabı ister.

Adım adım kurulum

Hangisini yapmak istiyorsun?

İşaretlediğin adımlar yalnız bu tarayıcıda kalır; kurulumun çalıştığını doğrulamaz. 0/8 adımı bitirdin.

  1. 1. adım · Terminalde

    Projenin ayrı bir dalını aç

    Ne için: Değişiklikleri ayrı bir dalda topla; vazgeçersen dalı atabil. Dal klasörü kopyalamaz: aynı çalışma klasörünü kullanır.

    1. Terminalde projenin klasörüne gir. Önce git status ile durumu gör. Kaydedilmemiş değişikliğin varsa aşağıdaki iki komutla kaydet (commit). Bunlar yeni dala taşınmasın diye önemlidir. .env gibi dosyaların .gitignore içinde olduğunu kontrol et; git add -A hepsini ekler.
    2. Proje yeni git init ile oluşturulduysa da bir kez ilk kaydı (commit) yap; kaydı olmayan depoda dal açmak anlamlı olmaz.
    3. Aşağıdaki komutla yeni bir dal aç. Araç .env gibi ortam dosyalarına ve git'in izlemediği dosyalara da dokunabilir; dal bunları korumaz.
    4. Tam izolasyon istersen projenin klasörünü ayrı bir yere kopyalayıp orada çalış. Denemeyi nasıl geri alacağın 6. adımda.
    Windows · macOS · LinuxKlasör: Projenin ana klasörü
    › git status
    Windows · macOS · LinuxKlasör: Projenin ana klasörü
    › git add -A
    Windows · macOS · LinuxKlasör: Projenin ana klasörü
    › git commit -m "deneme oncesi"
    Windows · macOS · LinuxKlasör: Projenin ana klasörü
    › git switch -c opencode-deneme

    Doğru yaptığını şuradan anlarsın

    • Terminal yeni dala geçtiğini yazar.
    Takılırsan: bu adıma özgü sorunlar
    • Git, bu klasör bir depo değil diyor
      Proje klasöründe olduğundan emin ol. Proje Git ile izlenmiyorsa git init ile depo oluştur ve ilk kaydı (commit) yap, ya da klasörün bir kopyasında çalış.
    Dayanak: Git: switch komutu, Git: status komutu, Git: add komutu, Git: commit komutu, Git: restore komutu, Git: clean komutu, Git: branch komutu
  2. 2. adım · Terminalde

    OpenCode'u sürüme sabit kur

    Ne için: Terminalde çalışan kodlama ajanı hazır olsun.

    1. Windows'ta belge WSL kullanmanı önerir; WSL açıksa komutu orada çalıştır. Aynı komut Windows terminalinde de belgede listelidir.
    2. Aşağıdaki komutla 1.19.3 sürümünü kur. Bu komut OpenCode'un 1. sürüm hattını kurar; ana sayfada anılan 2. sürüm hattı ayrı bir pakettir ve aynı opencode komutunu kullandığı için ikisini birlikte kurma.
    3. Kurulumdan sonra projenin klasöründe opencode yaz ve arayüzün açıldığını gör.
    4. npm komutu bulunamıyorsa Node.js kurulu değildir; ön koşuldaki Node.js bağlantısından kur, terminali kapatıp açtıktan sonra yeniden dene.
    Windows · macOS · LinuxKlasör: Herhangi bir klasör
    › npm install -g opencode-ai@1.19.3

    Sürüm sabit (17 Ekim 2026 itibarıyla). Yeni sürüme geçmeden önce üreticinin belgesine bak.

    Windows · macOS · LinuxKlasör: Projenin ana klasörü
    › opencode

    Doğru yaptığını şuradan anlarsın

    • Terminal arayüzü açılır.
    Takılırsan: bu adıma özgü sorunlar
    • npm komutu bulunamadı
      Node.js kurulu değil ya da terminal eski. Node.js'i resmî indirme sayfasından kur, terminali yeniden aç ve npm --version komutuyla kontrol et.
    • opencode komutu bulunamadı
      Terminali kapatıp yeniden aç; npm'in genel paket klasörünün PATH'te olduğunu kontrol et.
    • Daha önce başka bir yöntemle ya da 2. sürüm hattıyla kurulum yapılmış
      OpenCode belgesi, kurulum yöntemlerinin 2. sürümle çakışabileceğini söyler; önce eskisini kaldır, sonra tek hat kur.
    Dayanak: OpenCode: giriş ve kurulum, OpenCode: npm paket kaydı, Node.js: indirme sayfasıBu adımda yardım al →
  3. 3. adım · Tarayıcıda

    Gemini API anahtarını al ve OpenCode'a bağla

    Ne için: OpenCode kodu okuyup yazacak modele erişsin.

    Burada sen kontrol edersin; sistem bu adımı senin onayın olmadan ilerletmemeli.

    1. Önce şunu bil: Gemini API'nin ücretsiz katmanında gönderdiğin kod ve yanıtlar Google tarafından ürün geliştirmede kullanılabilir, insan gözden geçirmesine girebilir (model bazında fiyat sayfasındaki 'Used to improve our products' satırına bak; ek şartlar ücretsiz hizmette hassas veri göndermemeni söyler). Müşteri kodu, gizli anahtar ya da kişisel veri içeren dosyaları bu katmanda kullanma.
    2. Google AI Studio'nun API anahtarları sayfasında oturum aç ve bir anahtar oluştur. Anahtarı kimseyle paylaşma, depoya koyma.
    3. OpenCode arayüzünde /connect yaz ve listeden Vertex AI değil, düz Google/Gemini girdisini seç. OpenCode belgesinde AI Studio için ayrı bir bölüm yok (yalnız Vertex AI var); girdinin listede Google ya da Gemini adıyla görünmesi beklenir, bu belgeden çıkarımdır. Ardından anahtarı yapıştır.
    4. Belgeye göre anahtar ~/.local/share/opencode/auth.json dosyasında saklanır (yol Linux/macOS biçimindedir; yerel Windows'ta konum belgede belirtilmemiş). O dosyayı hiçbir depoya ekleme.
    5. Kotayı çoğaltmak için ikinci hesap ya da VPN kullanma: limitler proje başınadır ve bu rehber kota aşmayı önermez.

    Doğru yaptığını şuradan anlarsın

    • Bağlantı hata vermeden tamamlanır.
    • /models listesinde bağladığın sağlayıcının modelleri görünür (belgeye göre modeller /models ile seçilir).
    Takılırsan: bu adıma özgü sorunlar
    • AI Studio sayfası ülkende açılmıyor ya da erişim engeli çıkıyor
      Resmî ülke listesinde Türkiye yer alır; yine de açılmıyorsa Google'ın bu sayfadaki olası nedenler listesine bak ve başka bir sağlayıcıya geçme yolunu kullan (7. adım).
    • /connect listesinde Google bulunmuyor
      Aramaya google yaz; OpenCode sağlayıcı listesini Models.dev'den alır ve orada ad Google'dır (Vertex AI değil). Hâlâ yoksa OpenCode sürümünü kontrol et.
    • /connect listesinde yalnız Vertex AI görünüyor
      Vertex AI başka bir Google Cloud hizmetidir. Aramaya gemini ya da google yaz; düz Google/Gemini girdisi çıkmıyorsa OpenCode sürümünü kontrol et, yoksa bu rehberin ana yolu çalışmaz demektir ve alternatif sağlayıcılara bak.
    Dayanak: Gemini API: API anahtarı, Gemini API: ek kullanım şartları, OpenCode: sağlayıcılar, Gemini API: kullanılabildiği bölgeler, Gemini API: istek limitleriBu adımda yardım al →
  4. 4. adım · Terminalde

    O gün erişilebilir bir model seç

    Ne için: Ücretsiz katmanda gerçekten çağırabileceğin bir model seçilsin.

    1. OpenCode arayüzünde /models yaz ve bağladığın sağlayıcının modellerinden birini seç.
    2. Gemini fiyat sayfasında ücretsiz katmanda ücretsiz görünen modelleri kontrol et; bazı modeller ücretsiz katmanda yoktur (örneğin Gemini 3.1 Pro Preview). Listede olmayan ya da hata veren modeli kullanma.
    3. OpenCode belgesi kod yazma ve araç çağırmada iyi olan modelin az sayıda olduğunu söyler; ilk görevde sonucu mutlaka gözle kontrol et.

    Doğru yaptığını şuradan anlarsın

    • Seçtiğin modelin adı arayüzde görünür; belgeye göre model /models ile seçilir.
    Takılırsan: bu adıma özgü sorunlar
    • Seçilen modelde izin ya da kota hatası alıyorum
      Modelin ücretsiz katmanda sunulduğunu fiyat sayfasından kontrol et; başka bir model seç.
    Dayanak: OpenCode: modeller, Gemini API: fiyatlandırma ve ücretsiz katmanBu adımda yardım al →
  5. 5. adım · Terminalde

    Proje talimatını ve izin ayarını kur

    Ne için: Araç projenin kurallarını bilsin ve onay almadan dosya silip komut çalıştırmasın.

    1. Projende zaten bir AGENTS.md varsa OpenCode onu okur. Yoksa ve bir CLAUDE.md varsa, belge onun yedek olarak okunduğunu söyler; ikisi de varsa yalnız AGENTS.md kullanılır.
    2. Hiçbiri yoksa OpenCode'da /init yaz; araç projeyi inceleyip bir AGENTS.md oluşturur. Oluşan dosyayı oku ve yanlışları düzelt.
    3. Proje kökünde opencode.json dosyası aç ve dosya düzenleme ile komut çalıştırmanın onay istemesini yaz (örnek aşağıda). Belgeye göre varsayılan davranış tüm işlemlere onaysız izin vermektir.
    opencode.json · json
    {
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

    Biçim resmî yapılandırma sayfasındaki izin örneğinden alındı.

    Doğru yaptığını şuradan anlarsın

    • Proje kökünde AGENTS.md ve opencode.json bulunur.
    • Araç dosya düzenlerken ve komut çalıştırırken sana sorar.
    Takılırsan: bu adıma özgü sorunlar
    • Araç projedeki kuralları dikkate almıyor
      AGENTS.md dosyasının proje kökünde olduğunu ve OpenCode'u o klasörden açtığını kontrol et.
    Dayanak: OpenCode: kurallar (AGENTS.md), OpenCode: yapılandırma ve izinlerBu adımda yardım al →
  6. 6. adım · Terminalde

    Küçük bir görev ver, değişikliği ve kontrolleri gözden geçir

    Ne için: Aracın projende işe yarayıp yaramadığını düşük riskle gör.

    Burada sen kontrol edersin; sistem bu adımı senin onayın olmadan ilerletmemeli.

    1. Küçük ve sınırlı bir iş iste, örneğin tek bir dosyadaki metin hatasını düzeltmek ya da tek bir küçük fonksiyona test eklemek.
    2. Araç izin istedikçe neyi yapacağını oku, onayla ya da reddet.
    3. İş bitince aşağıdaki iki komutla bak: git status yeni oluşan dosyaları, git diff mevcut dosyalardaki değişikliği gösterir. Anlamadığın ya da istemediğin değişiklik varsa geri al.
    4. Projenin kendi kontrol komutlarını (test, kod denetimi, derleme) çalıştır ve sonucu gör. Başarısız olan olursa aracı değil önce değişikliği incele.
    5. Denemeden vazgeçersen 1. adımda kaydettiklerin korunur, silinen yalnız aracın yaptıkları olur. Kaydettiysen önce eski dalına dön: git switch - bir önceki dala döner, adı unuttuysan git branch ile listele. Sonra git branch -D opencode-deneme ile dalı sil (bulunduğun dalı silemezsin).
    6. Dikkat: git branch -D, o dalda kaydedip başka yere birleştirmediğin her şeyi siler.
    7. Kaydetmediysen projenin ana klasöründe git restore . komutu kaydedilmemiş değişiklikleri kalıcı siler ve geri getirilemez; önce git diff ile bak. Önceden git add yaptıysan git restore --staged . gerekir. Yeni dosyalar için git clean -n -d yalnız listeler, hiçbir şey silmez; listede kendi dosyan varsa dokunma, aracın dosyalarını elle sil.
    Windows · macOS · LinuxKlasör: Projenin ana klasörü
    › git status
    Windows · macOS · LinuxKlasör: Projenin ana klasörü
    › git diff

    Doğru yaptığını şuradan anlarsın

    • git status yeni ve değişen dosyaları listeler; git diff değişen satırları gösterir.
    • Projenin kendi kontrolleri geçer ya da hatayı sen görürsün.
    Takılırsan: bu adıma özgü sorunlar
    • Araç beklenmedik dosyaları değiştirdi
      Kaydettiysen git switch - ile eski dala dön (adı unuttuysan git branch), sonra git branch -D opencode-deneme; bu dalda kaydedip birleştirmediğin her şey gider. Kaydetmediysen projenin ana klasöründe git restore . komutu kaydedilmemiş değişiklikleri kalıcı siler; önce git diff'e bak. Yeni dosyalar kalır: git clean -n -d yalnız listeler, silmez. Dal silmek ya da dönmek kaydedilmemiş değişiklikleri kendiliğinden geri almaz.
    Dayanak: Git: status komutu, Git: diff komutu, Git: switch komutu, Git: restore komutu, Git: clean komutu, Git: branch komutu, OpenCode: yapılandırma ve izinlerBu adımda yardım al →
  7. 7. adım · Terminalde

    Kota dolunca ne olur ve başka sağlayıcıya nasıl geçilir

    Ne için: Kota hatasını tanı ve çalışmayı izinli başka bir yolla sürdür.

    1. Gemini tarafında limitler proje başınadır; günlük istek kotası Pasifik saatiyle gece yarısı sıfırlanır. Güncel limitleri AI Studio'da gör. Sınırı aşınca bir hız sınırı hatası alırsın.
    2. Hata gelince bekleyebilir ya da kendi hesabına açtığın başka bir izinli sağlayıcıya geçebilirsin: /connect ile onu ekle, /models ile modelini seç. OpenRouter :free modellerinde gizli kod gönderme: eğitimden çıkış ayarı istisnaları ve OpenRouter'ın kendi politikasını kapsamaz.
    3. Aynı kota için ikinci hesap ya da VPN kullanma. Kotası bitti diye gizli kodu daha gevşek şartlı bir sağlayıcıya göndermeye de kalkma.

    Doğru yaptığını şuradan anlarsın

    • Hata mesajında kota ya da hız sınırı ifadesi görürsün.
    • Başka sağlayıcıyı /connect ile ekleyip /models ile model seçebilirsin.
    Takılırsan: bu adıma özgü sorunlar
    • Birkaç istekten sonra hız sınırı hatası alıyorum
      Dakika ya da günlük sınırı aşmış olabilirsin; AI Studio'daki limitlerine bak ve bekle ya da başka bir model seç.
    Dayanak: Gemini API: istek limitleri, OpenCode: sağlayıcılar, OpenRouter: istek sınırları, OpenRouter: gizlilik ve kayıt tutmaBu adımda yardım al →
  8. 8. adım · Terminalde

    Kısa yol: Freebuff'ı sınırlı katmanla dene

    Ne için: API anahtarı almadan hazır bir araçla kodlamayı dene.

    1. Önce proje dalını aç (1. adım). Aşağıdaki komutla 0.2.29 sürümünü kur.
    2. Bu araçla gizli ya da müşteri kodunu kullanma: Freebuff mesajlarını, ajan izlerini ve dosyalarını hizmeti çalıştırmak için kullanır, reklamları kişiselleştirmek için analiz edebilir; bir modelin ya da özelliğin notu yapay zeka eğitimini de söyleyebilir.
    3. Türkiye tam erişim listesinde olmadığı için sınırlı erişim katmanı gelir: README günlük 5 saat (VPN ya da proxy ile 4 saat) yazar. Aracın başlangıçta gösterdiği oturum sınırlarını ve veri notunu oku.
    4. Hesap ya da giriş gerekip gerekmediği kaynaklarda net yazılmıyor (README anahtar, abonelik ve kredi gerekmediğini söyler; ürün sayfasında oturum aç bağlantısı var). Araç ne isterse onu oku.
    Windows · macOS · LinuxKlasör: Herhangi bir klasör
    › npm install -g freebuff@0.2.29

    Sürüm sabit (17 Ekim 2026 itibarıyla). Yeni sürüme geçmeden önce üreticinin belgesine bak.

    Doğru yaptığını şuradan anlarsın

    • Proje klasöründe freebuff yazınca araç açılır ve oturum sınırlarını gösterir.
    Takılırsan: bu adıma özgü sorunlar
    • Araç günlük sürenin dolduğunu söylüyor
      Sınırlı katmanın günlük süresi dolmuştur; ertesi gün dene ya da ana yoldaki Gemini API bağlantısına dön.
    Dayanak: Freebuff: README, Freebuff: tam erişim ülke listesi (kaynak kod)

Kurulum çalışıyor mu? Şunlara bak

  • OpenCode'da /connect ile sağlayıcıyı bağladıktan sonra /models listesinde onun modelleri çıkar. Google/Gemini girdisi görünmüyorsa ana yol çalışmaz; alternatif sağlayıcıya bak.
  • Verdiğin küçük görevden sonra git status ve git diff değişikliği gösterir; projenin kendi kontrolleri sonucu bildirir.
  • Kota ya da hız sınırı hatasında izinli başka sağlayıcıya /connect ve /models ile geçebilirsin.

Neye para ödenir

Kalemler ayrıdır ve toplam değildir; hangilerinin sana gerektiği kurduğun yola bağlıdır. Fiyatlar değişir, her kalemin kaynağına bak.

  • API kullanımıModel kullanımı, ücretsiz katman

    Bazı modeller ücretsiz katmanda ücretsiz listelenir; limitler proje başınadır. Fiyat sayfası ücretsiz katmanda içeriğin ürün geliştirmede kullanılabildiğini söyler; model bazında 'Used to improve our products' satırına bak. kaynak

  • API kullanımıModel kullanımı, ücretli katman

    Gemini API ancak faturalama hesabı bağlı bir bulut projesi üzerinden ücretli sayılır; fiyatı Google'ın sayfasından bak. kaynak

  • Ücret yokİstemci (OpenCode)

    Yazılım MIT lisanslı ve ücretsiz; model ücreti ayrıdır. kaynak

  • Kurulum hizmetiKurulum desteği

    İstersen sağlayıcı bağlama, proje talimatı ve izin ayarında yardım alabilirsin; kapsam görüşmeyle belli olur.

Kaynaklar

Kendin kurabilirsin; takıldığın adımı birlikte yapalım

İstediğin adımları işaretle. İstek formuna sistemin adı ve seçtiğin adımlar görünür bir özet olarak geçer; sen değiştirebilirsin. Şifre ya da API anahtarı paylaşmana gerek yok.

Yardım istediğin adımlar
Kurulum ihtiyacımı görüşelim Sağlayıcı seçimi, OpenCode kurulumu, proje talimat dosyası, izin ayarları ve kota dolunca başka sağlayıcıya geçiş düzeni için yardım alınabilir. Kesin kapsam ve fiyat görüşmede belli olur.

Başka bir yol arıyorsan

Rehber ücretsiz ve üyeliksiz; buradaki adımları kendin uygulayabilirsin. Bir noktada profesyonel destek istersen ihtiyacına uygun yolu seç. Rehberdeki sıralama bundan etkilenmez.