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. Kendi anahtarın yoksa Go planı 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 (önerilen başlangıç)

OpenCode'un kendi planını kullanabilirsin:

1. /connect komutunu çalıştır
2. Listeden "OpenCode" seç
3. Yönlendirdiği sayfada hesap aç, ödeme bilgisi ekle
4. Sana verilen API anahtarınıⁱOpenCode'un sana özel ürettiği erişim kodu yapıştır

İlk ay $5, sonrası $10/ay. Düzenli kullanmayacaksan kendi Anthropic anahtarını almak uzun vadede daha ekonomik.

---

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

---

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 →