Konsolity CLI kurulumu
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
- Hesabınızdan onaylanan bir kodla makineyi etkinleştirin.
- Kapsamını seçin: sunucular, parçacıklar, komut kuralları.
- Komutları keşfedin, Claude Code bağlayın veya hizmet olarak çalıştırın.