OpenCode Nasıl Kullanılır? Terminal AI Kodlama Ajanı Rehberi

OpenCode, terminalⁱbilgisayarında yazıyla komut verdiğin siyah ekran üzerinde çalışan, açık kaynaklı bir AI kodlama ajanı. ChatGPT'ye "şu kodu düzelt" demek yerine, OpenCode doğrudan kod dosyalarını açıp değişikliği kendisi yapıyor — senin onayınla. Ücretsiz başlıyor, kendi API anahtarınla kullanabilirsin.

Bu rehber sıfırdan başlıyor: terminali hiç açmamış olsan bile adım adım götürüyoruz.

Başlamadan Önce: Terminal Nedir ve Nasıl Açılır?

Terminalⁱbilgisayarınla metin yazarak konuştuğun program; fare yerine klavye kullanılır, her bilgisayarda yüklü olarak gelir. Grafik arayüzü olmadığı için ilk bakışta korkutucu görünüyor ama bu rehberdeki komutları kopyala-yapıştır yaparak ilerleyebilirsin.

Mac'te terminali açmak:

1. Klavyede Cmd + Boşluk tuşlarına bas — arama çubuğu açılır
2. "Terminal" yaz, Enter'a bas
3. Beyaz veya siyah arka planlı bir pencere açıldı — bu terminal

Windows'ta terminali açmak:

1. Başlat menüsüne sağ tıkla
2. "Windows Terminal" veya "PowerShell" seç

[mindi_yorum]
💰 OpenCode'u kendi API anahtarınla kullanmak ücretsiz — sadece kullandığın modelin maliyetini ödersin. Anahtarın yoksa Zen'deki ücretsiz modellerle hiç ödeme yapmadan başlayabilirsin; sabit paket istersen Go ilk ay $5, sonra $10/ay.
🟢 Terminale hiç girmemiş biri bile bu rehberi takip edebilir. Komutları birebir kopyalamak yeterli.
🟡 macOS'un varsayılan terminali bazen görseli bozuyor. Sorun yaşarsan aşağıdaki adımı uygula.

📚

dilersen opencode türkçe resmi kurulum rehberine de buradan ulaşabilirsin.
opencode.ai/docs/tr#kurulum →

---

Adım 1: Daha İyi Bir Terminal Kur (Önerilen)

OpenCode'un arayüzü renkleri ve ikonları kullandığı için macOS'un standart terminali bazen bozuk görüntüler. Bunu çözmek için ücretsiz bir terminal uygulaması kurman yeterli.

En kolay seçenek — WezTerm:

1. wezterm.org adresine git
2. "Download" butonuna tıkla, işletim sistemini seç
3. İndirilen dosyayı aç, kur
4. Bundan sonra terminal dediğimiz yerde WezTerm'i kullan

Windows kullanıyorsan bu adımı atlayabilirsin, Windows Terminal yeterli.

---

Adım 2: OpenCode'u Kur

Terminali açtıktan sonra aşağıdaki komutu olduğu gibi kopyalayıp yapıştır ve Enter'a bas:

curl -fsSL https://opencode.ai/install | bash

Ekranda bir şeyler kayacak, bu normal — OpenCode yükleniyor. Bitince şunu yaz:

opencode --version

Ekranda bir versiyon numarası çıktıysa kurulum başarılı.

Mac'te curl komutu çalışmıyorsa HomebrewⁱMac'te uygulama kurmayı kolaylaştıran paket yöneticisi ile dene:

brew install anomalyco/tap/opencode

Node.js yüklüyse (her iki sistemde çalışır):

npm install -g opencode-ai

[mindi_yorum]
🟢 Kurulum gerçekten tek komut. Çoğu kullanıcı 2 dakikada bitiriyor.
🟡 "curl: command not found" hatası alırsan npm yolunu dene — ikisi de aynı sonucu veriyor.
🔵 Windows kullanıyorsan en sorunsuz deneyim için WSLⁱWindows içinde Linux çalıştıran araç önerilir. Ama bu rehberdeki npm komutu WSL olmadan da çalışır.

---

Adım 3: API Anahtarını Ayarla

OpenCode bir yapay zeka modeliⁱChatGPT veya Claude gibi; soruları anlayan ve cevaplayan sistem ile çalışmak zorunda. Bunun için iki yol var:

Yol A — Kendi API anahtarın varsa (Anthropic, OpenAI vb.)

Terminale gir ve şunu yaz:

opencode

Arayüz açılınca /connect yaz ve Enter'a bas. Sağlayıcılar listesi gelecek — örneğin Anthropic'i seç, API anahtarınıⁱşifreye benzer, sağlayıcının sitesinden aldığın uzun bir kod; başkasıyla paylaşma yapıştır.

Yol B — API anahtarın yoksa: önce ücretsiz modeller

Cebinden hiç para çıkmadan başlayabilirsin. OpenCode Zen kataloğunda giriş de çıkış da $0 olan sekiz model duruyor: DeepSeek V4 Flash Free, MiMo-V2.5 Free, Laguna S 2.1 Free, Ling-3.0-tiny Free, LongCat-2.0 Free, North Mini Code Free, Nemotron 3 Ultra Free ve Big Pickle adında gizli bir model.

1. /connect komutunu çalıştır
2. Listeden "OpenCode Zen" seç
3. Yönlendirdiği sayfada hesap aç, API anahtarını kopyala
4. Anahtarı yapıştır, sonra /models yazıp adında "Free" geçen modellerden birini seç

Bir uyarı: bu modeller sınırlı süre için ücretsiz ve bedeli veri. Sağlayıcı, ücretsiz dönem boyunca gönderdiğin içeriği modeli iyileştirmek için kullanabiliyor. Öğrenirken ve deneme projelerinde sorun değil; müşteri kodu ya da özel bir projede ücretli modele geç.

Yol C — Sabit aylık ücret istersen: Go planı

Ücretsiz modeller yetmiyorsa Go var: ilk ay $5, sonrasında $10/ay. DeepSeek V4, Qwen3.8 Max, GLM-5.2, Kimi K3 ve MiniMax dahil 18 model geliyor, kendi API anahtarına gerek kalmıyor. Kullanım dolar bazlı sınırlı: 5 saatte $12, haftada $30, ayda $60. Sınırı doldurursan ücretsiz modellerle devam edebiliyorsun.

Ekip, Go planını özellikle yurt dışındaki kullanıcılar için istikrarlı global erişim sağlasın diye tasarladığını söylüyor — Türkiye'den bakınca bu iyi haber.

---

Adım 4: İlk Kullanım — Walkthrough

Bu bölümde sıfırdan gerçek bir projede OpenCode'u kullanacaksın. Kodlama bilmen gerekmiyor — sadece adımları takip et.

4.1 Proje Klasörüne Git

Terminalde önce üzerinde çalışmak istediğin klasöre gitmen gerekiyor. cd komutu "change directory"ⁱklasör değiştir anlamına gelir:

cd Masaüstü/benim-projem

Klasör adını kendi projenin adıyla değiştir. Masaüstü'ndeyse cd Masaüstü yeterli.

Artık OpenCode'u başlatabilirsin:

opencode

Karşına renkli bir arayüz gelecek. Sol tarafta konuşma alanı, sağda dosyalar. Bu OpenCode'un TUIⁱterminal kullanıcı arayüzü; fareyle değil klavyeyle gezilen ekran ekranı.

4.2 Projeyi Tanıt

OpenCode'a projenin ne olduğunu öğretmek için şunu yaz:

/init

Enter'a bas. OpenCode klasörü tarar, dosyaları inceler ve AGENTS.md adında bir dosya oluşturur. Bu dosya OpenCode'un "proje defteri" — her oturumda oradan okuyacak, sıfırdan başlamayacak.

İpucu: AGENTS.md dosyasını daha sonra açıp içine projeyle ilgili notlar ekleyebilirsin: "Bu React projesi", "Türkçe yorum yaz", "Bootstrap kullanıyoruz" gibi. Ne kadar doldurursan OpenCode o kadar isabetli iş çıkarır.

4.3 Plan Modu — Önce Göster, Sonra Yap

OpenCode'un en güvenli özelliği: bir şey yapmadan önce ne yapacağını söylemesi.

Tab tuşuna bas — sağ altta "Plan" yazısı çıkacak. Bu modda OpenCode hiçbir dosyaya dokunmuyor, sadece planı anlatıyor.

Şimdi bir şey iste. Örneğin:

Giriş sayfasındaki butonu kırmızıdan maviye değiştir

OpenCode hangi dosyaya bakacağını, ne değiştireceğini ve neden öyle yapacağını yazıyor. Planı oku, mantıklı geliyorsa devam et.

4.4 Build Modu — Değişikliği Uygula

Planı onayladıktan sonra tekrar Tab tuşuna bas — "Build" moduna geçtin. Şunu yaz:

Tamam, uygula.

OpenCode dosyalarda değişikliği yapıyor. Her değişikliği görebilirsin.

4.5 Beğenmediysen Geri Al

Yaptığı değişikliği beğenmediysen:

/undo

Her şey önceki haline döner. Birden fazla adımı geri almak için /undo komutunu tekrar çalıştır.

4.6 Dosya Referansı — Spesifik Bir Dosyayı Göster

Belirli bir dosya hakkında konuşmak istiyorsan @ kullan:

@index.html dosyasındaki başlığı büyüt

@ yazdıktan sonra dosya adını yazmaya başla — OpenCode otomatik öneri sunuyor, Tab ile seçebilirsin.

[mindi_yorum]
🟢 Plan → onayla → uygula akışı gerçekten sürpriz kodu önlüyor. Büyük değişikliklerde her zaman Plan modundan başla.
🟡 /init sonrası oluşan AGENTS.md çoğu zaman eksik kalıyor. "Bu proje ne yapar?" sorusunun cevabını dosyaya ekle — farkı hissediyorsun.
🔵 Küçük tek satır değişiklikler için Plan modunu atlayabilirsin. Ama yeni bir özellik ekliyorsan Plan şart.

---

Kısayollar ve Komutlar

OpenCode içinde kullanabileceğin komutlar:

Komut	Ne Yapar
/init	Projeyi analiz et, AGENTS.md oluştur
/undo	Son değişikliği geri al
/redo	Geri alınan değişikliği yeniden uygula
/share	Konuşmayı paylaşılabilir linke dönüştür
/connect	Yeni model veya API bağla
Tab	Plan ↔ Build modu geçişi
@dosya	Spesifik dosya referansı ekle
Ctrl+C	OpenCode'dan çık

---

Terminal Dışı Seçenekler

Rehber boyunca terminali kullandık ama OpenCode artık yalnızca terminalde çalışmıyor.

Masaüstü uygulaması macOS, Windows ve Linux için var, hâlâ beta. Her oturumu ayrı sekmede tutuyor; terminal komutlarıyla uğraşmadan aynı ajanı çalıştırıyorsun.

IDE eklentisi VS Code ve JetBrains tarafında çalışıyor — editörden çıkmadan ajanla konuşuyorsun.

Web arayüzü de mevcut, tarayıcıdan oturumlarına bakabiliyorsun.

Terminale ısınamadıysan masaüstü uygulamasıyla başla; komutların mantığı aynı, sadece görmesi daha kolay.

---

Yaygın Sorunlar

"Command not found" hatası: OpenCode kurulmamış veya PATHⁱterminalin program arayacağı klasörler listesi ayarı eksik. Terminali kapatıp açmayı dene, çalışmazsa npm komutuyla tekrar kur.

Ekran bozuk görünüyor: macOS'un standart terminali kullanıyorsundur. WezTerm veya Ghostty'yi kur, 1. adıma dön.

"Unauthorized" veya "Invalid API key" hatası: API anahtarını yanlış yapıştırmışsındır. /connect komutunu tekrar çalıştır.

Plan çok karmaşık geliyor: Görevi küçük parçalara böl. "Tüm siteyi yenile" yerine "sadece ana sayfanın rengini değiştir" daha iyi sonuç veriyor.

---

Sonuç

OpenCode, terminale alışkın olmayan biri için ilk bakışta karmaşık görünüyor — ama kurulumu ve ilk kullanımı düşündüğünden çok daha basit. Plan → onayla → uygula mantığıyla dosyalara güvenli biçimde dokunabiliyor, beğenmezsen tek komutla geri alabiliyorsun.

Başlamak için şu adımları takip et:

1. Terminali aç (Mac: Cmd+Boşluk → "Terminal")
2. curl -fsSL https://opencode.ai/install | bash komutunu çalıştır
3. /connect ile API anahtarını bağla
4. Proje klasörüne gidip opencode yaz
5. /init ile projeyi tanıt
6. Plan modunda ilk isteğini gir, sonucu gör

OpenCode'u keşfet →