Giriş
OpenCode açık kaynaklı bir AI kodlama ajanıdır. Terminal tabanlı bir arayüz, masaüstü uygulaması veya IDE uzantısı olarak mevcuttur.

Başlayalım.
Ön koşullar
OpenCode’u terminalinizde kullanmak için ihtiyacınız olacak:
-
Şu gibi modern bir terminal emülatörü:
-
Kullanmak istediğiniz LLM sağlayıcılarının API anahtarları.
OpenCode’u kurmanın en kolay yolu kurulum betiğidir.
curl -fsSL https://opencode.ai/install | bashAyrıca aşağıdaki komutlarla da yükleyebilirsiniz:
-
Node.js’yi kullanma
npm install -g opencode-aibun install -g opencode-aipnpm install -g opencode-aiyarn global add opencode-ai -
Homebrew’u macOS ve Linux’ta kullanma
Terminalbrew install anomalyco/tap/opencodeEn güncel sürümler için OpenCode tap’ini kullanmanızı öneririz. Resmi
brew install opencodeformülü Homebrew ekibi tarafından korunur ve daha sık güncellenir. -
Paru’yu Arch Linux’ta kullanma
Terminalsudo pacman -S opencode # Arch Linux (Stable) paru -S opencode-bin # Arch Linux (Latest from AUR)
Windows
-
Chocolatey Kullanımı
Terminalchoco install opencode -
Scoop Kullanımı
Terminalscoop install opencode -
NPM kullanarak
Terminalnpm install -g opencode-ai -
Mise Kullanımı
Terminalmise use -g github:anomalyco/opencode -
Docker’ı kullanma
Terminaldocker run -it --rm ghcr.io/anomalyco/opencode
OpenCode’un Bun kullanılarak Windows’a yüklenmesine yönelik destek şu anda devam etmektedir.
İkili dosyayı Releases’dan da alabilirsiniz.
OpenCode ile herhangi bir LLM sağlayıcısının API anahtarlarını yapılandırarak kullanabilirsiniz.
LLM sağlayıcılarını kullanmaya yeni başlıyorsanız, OpenCode Models kullanmanızı öneririz. OpenCode ekibi tarafından test edilmiş ve doğrulanmış modellerin seçilmiş bir listesidir.
-
TUI’de
/connectkomutunu çalıştırın, OpenCode’u seçin ve opencode.ai/auth’ye gidin./connect -
Oturum açın, fatura ayrıntılarınızı ekleyin ve API anahtarınızı kopyalayın.
-
API anahtarınızı yapıştırın.
┌ API key │ │ └ enter
Alternatif olarak diğer sağlayıcılardan birini seçebilirsiniz. Daha fazla bilgi.
Artık bir sağlayıcı yapılandırdığınıza göre, üzerinde çalışmak istediğiniz bir projeye gidebilirsiniz.
cd /path/to/projectVe OpenCode’u çalıştırın.
opencodeDaha sonra aşağıdaki komutu çalıştırarak proje için OpenCode’u başlatın.
/initBu, OpenCode’un projenizi analiz etmesini ve bir AGENTS.md proje kökünde dosyası oluşturmasını sağlayacaktır.
Bu, OpenCode’un proje yapısını ve kullanılan kodlama kalıplarını anlamasına yardımcı olur.
Artık projeniz üzerinde çalışmak için OpenCode’u kullanmaya hazırsınız. Dilediğiniz soruyu sorabilirsiniz.
AI kodlama ajanını kullanmaya yeniyseniz aşağıdaki örnekler yardımcı olabilir.
OpenCode’dan kod tabanını size açıklamasını isteyebilirsiniz.
How is authentication handled in @packages/functions/src/api/index.tsKod tabanının üzerinde çalışmadığınız bir kısmı varsa bu yararlı olur.
OpenCode’dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de öncelikle ondan bir plan oluşturmasını istemenizi öneririz.
-
Bir plan oluşturun
OpenCode, değişiklik yapma özelliğini kapatan bir _Plan modu_\na sahiptir. Bu modda, özelliğin nasıl uygulanacağını önerir.
Tab tuşunu kullanarak buna geçin. Bunun için sağ alt köşede bir gösterge göreceksiniz.
Plan moduna geç<TAB>Şimdi ne yapmasını istediğimizi anlatalım.
When a user deletes a note, we'd like to flag it as deleted in the database. Then create a screen that shows all the recently deleted notes. From this screen, the user can undelete a note or permanently delete it.OpenCode’un isteğinizi anlaması için yeterli ayrıntı verin. Ekibinizdeki junior bir geliştiriciyle konuşur gibi yazmak genelde iyi sonuç verir.
-
Planı yineleyin
Size bir plan sunduğunda ona geri bildirimde bulunabilir veya daha fazla ayrıntı ekleyebilirsiniz.
We'd like to design this new screen using a design I've used before. [Image #1] Take a look at this image and use it as a reference.OpenCode verdiğiniz görselleri tarayıp prompt’a ekleyebilir. Bunu bir görseli terminale sürükleyip bırakarak yapabilirsiniz.
-
Özelliği oluşturun
Planı yeterli bulduğunuzda Tab tuşuna tekrar basarak _Build modu_\na dönün.
Terminal<TAB>Ardından değişiklikleri yapmasını isteyin.
TerminalSounds good! Go ahead and make the changes.
Daha basit değişikliklerde, önce planı incelemeden OpenCode’dan doğrudan değişiklik yapmasını isteyebilirsiniz.
We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.tsOpenCode’un doğru değişiklikleri yapması için yeterli ayrıntı verdiğinizden emin olun.
Diyelim ki OpenCode’dan bazı değişiklikler yapmasını istediniz.
Can you refactor the function in @packages/functions/src/api/index.ts?Ama istediğinin bu olmadığını anlıyorsun. /undo komutunu kullanarak değişiklikleri geri alabilirsiniz.
/undoOpenCode değişiklikleri geri alır ve orijinal mesajınızı tekrar gösterir.
Can you refactor the function in @packages/functions/src/api/index.ts?Buradan komut isteminde ince ayar yapabilir ve OpenCode’dan tekrar denemesini isteyebilirsiniz.
Veya /redo komutunu kullanarak değişiklikleri yeniden yapabilirsiniz.
/redoİşte bu kadar! Artık OpenCode’u kullanma konusunda profesyonelsiniz.
Kendinize göre uyarlamak için tema seçebilir, tuş atamalarını özelleştirebilir, kod biçimlendirici ayarlayabilir, özel komutlar oluşturabilir veya OpenCode config ile oynayabilirsiniz.