İçeriğe geç
OpenCode
app.header.homeapp.header.docs

Giriş

opencode kullanmaya başlayın.

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

opencode TUI with the opencode theme

Başlayalım.

Ön koşullar

opencode’u terminalinizde kullanmak için ihtiyacınız olacak:

  1. Şu gibi modern bir terminal emülatörü:

  2. Kullanmak istediğiniz LLM sağlayıcılarının API anahtarları.

Kurulum

opencode’u kurmanın en kolay yolu kurulum betiğidir.

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

Ayrıca aşağıdaki komutlarla da yükleyebilirsiniz:

  • Node.js’yi kullanma

    Terminal window
    npm install -g opencode-ai

  • Homebrew’u macOS ve Linux’ta kullanma

    Terminal window
    brew install anomalyco/tap/opencode

    En güncel sürümler için opencode tap’ini kullanmanızı öneririz. Resmi brew install opencode formülü Homebrew ekibi tarafından korunur ve daha sık güncellenir.

  • Paru’yu Arch Linux’ta kullanma

    Terminal window
    sudo pacman -S opencode           # Arch Linux (Stable)
    paru -S opencode-bin              # Arch Linux (Latest from AUR)

Windows

  • Chocolatey Kullanımı

    Terminal window
    choco install opencode

  • Scoop Kullanımı

    Terminal window
    scoop install opencode

  • NPM kullanarak

    Terminal window
    npm install -g opencode-ai

  • Mise Kullanımı

    Terminal window
    mise use -g github:anomalyco/opencode

  • Docker’ı kullanma

    Terminal window
    docker 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.

Yapılandırma

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 Zen kullanmanızı öneririz. opencode ekibi tarafından test edilmiş ve doğrulanmış modellerin seçilmiş bir listesidir.

  1. TUI’de /connect komutunu çalıştırın, opencode’u seçin ve opencode.ai/auth’ye gidin.

    /connect

  2. Oturum açın, fatura ayrıntılarınızı ekleyin ve API anahtarınızı kopyalayın.

  3. 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.

Başlatma

Artık bir sağlayıcı yapılandırdığınıza göre, bir projeye gidebilirsiniz. üzerinde çalışmak istiyorsun.

Terminal window
cd /path/to/project

Ve opencode’u çalıştırın.

Terminal window
opencode

Daha sonra aşağıdaki komutu çalıştırarak proje için opencode’u başlatın.

/init

Bu, opencode’un projenizi analiz etmesini ve bir AGENTS.md dosyası oluşturmasını sağlayacaktır. proje kökü.

Bu, opencode’un proje yapısını ve kullanılan kodlama kalıplarını anlamasına yardımcı olur.

Kullanım

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.

Soru Sorma

opencode’dan kod tabanını size açıklamasını isteyebilirsiniz.

How is authentication handled in @packages/functions/src/api/index.ts

Kod tabanının üzerinde çalışmadığınız bir kısmı varsa bu yararlı olur.

Özellik Ekleme

opencode’dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de öncelikle ondan bir plan oluşturmasını istemenizi öneririz.

  1. 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.

    Sekme tuşunu kullanarak buna geçin. Bunun için sağ alt köşede bir gösterge göreceksiniz.

    <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.

    opencode verdiğiniz görselleri tarayıp prompt’a ekleyebilir. Bunu bir görseli terminale sürükleyip bırakarak yapabilirsiniz.

  2. 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.

  3. Özelliği oluşturun

    Planı yeterli bulduğunuzda Sekme tuşuna tekrar basarak _Build modu_na dönün.

    <TAB>

    Ardından değişiklikleri yapmasını isteyin.

    Sounds good! Go ahead and make the changes.

Değişiklik Yapma

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.ts

opencode’un doğru değişiklikleri yapması için yeterli ayrıntı verdiğinizden emin olun.

Değişiklikleri Geri Alma

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. Değişiklikleri geri alabilirsiniz /undo komutunu kullanarak.

/undo

opencode 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

Paylaşma

opencode ile yaptığınız görüşmeleri ekibinizle paylaşabilirsiniz.

/share

Bu, mevcut konuşmaya bir bağlantı oluşturacak ve bunu panonuza kopyalayacaktır.

İşte opencode’lu bir örnek konuşma.

Özelleştirme

İş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.