Konsolity CLI kurulumu

Güncellenme: 10 Kasım 2026

Konsolity CLI, bir sunucuya veya grafik arayüzü olmayan bir makineye kurulan konsolity komutudur. Hesabınızdan etkinleştirildikten sonra kasanızdaki sunuculara, parçacıklara ve oturumlara ona verdiğiniz kapsam dahilinde erişim sağlar ve Claude ajanları (örneğin Claude Code) için yerel bir MCP sunucusu görevi görür. Komut satırındaki Claude Code gibi çalışır: kurun, bir kodla bir kez etkinleştirin, ardından kullanın.

Gerekli plan

Konsolity CLI, Studio planına ve onun ücretsiz denemesine özeldir. Konsolity sunucusu, makinenin her çağrısında planı kontrol eder: plan yoksa her komut “Abonelik gerekli” yanıtını verir. Makine listesi ve iptal etme, plan olmasa bile her zaman kullanılabilir.

Makineyi seçme

Sunucularınıza SSH ile ulaşabilen herhangi bir bilgisayar: bir yönetim sunucusu, küçük bir sanal makine, bir Mac mini, bir geliştirme iş istasyonu, bir CI çalıştırıcısı. Makinenin hiçbir gelen bağlantı noktasına ihtiyacı yoktur, yalnızca api.konsolity.com adresine giden HTTPS erişimi gerekir.

Sistem Mimariler Biçimler
Linux (Debian, Ubuntu, Fedora, RHEL ve türevleri, arşiv aracılığıyla her dağıtım) x64, arm64 betik, .deb, .rpm, .tar.gz
macOS (Intel ve Apple silicon) mimari başına bir arşiv (x64, arm64), Developer ID ile imzalı ve noter onaylı ikili dosya · macOS 11 veya üstü betik, Homebrew, .tar.gz
Windows x64 PowerShell betiği, .zip

Linux ve macOS: kurulum betiği

En basit yol. Betik sistemi ve mimariyi algılar, doğru dosyayı indirir, SHA-256 özetini ve yayıncının Ed25519 imzasını doğrular, ardından dosyayı kurar:

curl -fsSL https://konsolity.com/cli/install.sh | sh

Betiği çalıştırmadan önce okumak için:

curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh

Özet veya imza eşleşmezse betik hiçbir şey kurmadan durur.

Linux: .deb paketi (Debian, Ubuntu)

Mimarinize uygun paketi indirin, ardından:

sudo apt install ./konsolity_<version>_amd64.deb

arm64 üzerinde (Raspberry Pi 4 veya 5, Graviton veya Ampere sunucuları) konsolity_<version>_arm64.deb dosyasını alın. Güncellemeler daha sonra apt üzerinden yapılır.

Linux: .rpm paketi (Fedora, RHEL, Rocky, Alma)

sudo dnf install ./konsolity-<version>.x86_64.rpm

arm64 üzerinde dosya adı .aarch64.rpm ile biter. Güncellemeler daha sonra dnf üzerinden yapılır.

Linux: .tar.gz arşivi

Diğer tüm dağıtımlar için arşiv yalnızca ikili dosyayı içerir:

tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity

ARM bir makinede amd64 yerine arm64 yazın.

macOS: Homebrew

brew install konsolity/tap/konsolity

Güncellemeler daha sonra brew upgrade konsolity ile yapılır. Kurulum betiği ve konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) arşivi de çalışır.

Windows: PowerShell

PowerShell'de (yönetici hakları gerekmez):

irm https://konsolity.com/cli/install.ps1 | iex

Betik, Linux'takiyle aynı denetimleri yapar, konsolity.exe dosyasını profilinize kurar ve kullanıcı PATH değişkenine ekler. Kullanmak için yeni bir terminal açın.

Windows: .zip arşivi

konsolity_<version>_windows_amd64.zip arşivi konsolity.exe dosyasını içerir. Dosyayı seçtiğiniz bir klasöre çıkarın, ardından bu klasörü PATH değişkeninize ekleyin.

İndirilen dosyayı doğrulama

Her sürüm, imzalı https://konsolity.com/cli/latest.json bildirimiyle tanımlanır: sürüm, dosya listesi (sistem, mimari, biçim, adres, SHA-256 özeti) ve yayıncının Ed25519 imzası. Betikler ve konsolity update, özeti veya imzası eşleşmeyen bir dosyayı reddeder. Elle indirdiğiniz bir paketi kendiniz doğrulamak için:

curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb

macOS'ta shasum -a 256, Windows'ta Get-FileHash konsolity_<version>_windows_amd64.zip kullanın. Gösterilen özet, bildirimdekiyle tam olarak aynı olmalıdır.

Kurulumu doğrulama

konsolity version

Komut sürümü, sistemi ve mimariyi gösterir.

Güncelleme

konsolity update

konsolity update bildirimi okur, yeni sürümün özetini ve imzasını doğrular, ardından ikili dosyayı değiştirir. konsolity komutu apt, dnf veya Homebrew ile kurulduysa, dosyayı kendisi değiştirmek yerine sizi bu paket yöneticisine yönlendirir.

systemd hizmeti kuruluysa sudo konsolity update çalıştırın: komut /usr/local/bin/konsolity dosyasını günceller, ardından hizmeti yeniden başlatır. konsolity-update.timer zamanlayıcısı bunu günde iki kez kendiliğinden de yapar.

Sonraki adımlar

  1. Hesabınızdan onaylanan bir kodla makineyi etkinleştirin.
  2. Kapsamını seçin: sunucular, parçacıklar, komut kuralları.
  3. Komutları keşfedin, Claude Code bağlayın veya hizmet olarak çalıştırın.