Kurulum rehberi · macOS

Claude Hub'ı kendi Mac'ine kur

Birden çok Claude hesabını, bütün Claude Code oturumlarını ve senden bekleyen işleri tek pencereden yöneten yerel uygulama. Kurulum beş adım; önce hiçbir şeye dokunmayan bir denetim neyin eksik olduğunu söyler.

Adımlara geç Ne gerekiyor?

Sunucu gerekmez Veriler senin Mac'inde Tek komutla kaldırılır

$ ./install.sh --check
Claude Hub ön denetim
Bu adım hiçbir şey kurmaz ve değiştirmez.

  [tamam] macOS XX.Y
  [tamam] Node.js vXX.Y.Z (…/bin/node)
  [tamam] npm
  [tamam] Claude Code (~/.local/bin/claude)
  [tamam] Xcode komut satırı araçları
  [tamam] git
  [tamam] Yazma izni: ~/claudecode/claude-hub
  [tamam] Yazma izni: ~/.claude-hub
  [tamam] Yazma izni: ~/Library/LaunchAgents
  [tamam] Yazma izni: ~/Applications
  [tamam] Yazma izni: ~/.local/bin

Hazır: kuruluma geçilebilir.
$

./install.sh --check çıktısının Türkçe satırları. Betik her satırı Türkçe ve İngilizce yazar. XX.Y ve …/bin yer tutucudur; sende kendi Mac'inin sürümü ve Node yolu yazar.

Kısaca

Hub neler yapar

Hub, Mac'indeki Claude Code'u kullanır. Her şey kendi Mac'inde döner.

Birden çok hesap, tek pencere

Her Claude hesabının kotası ve sıfırlanma saati yan yana görünür.

Limit dolunca devam

Bir hesabın limiti dolunca açık oturum sıradaki hesapla kaldığı yerden sürer.

Bütün oturumlar tek listede

Hangi hesapta başladığı fark etmez; oturumlar, hafıza ve ayarlar ortaktır.

Senden bekleyenler

İzin, soru ve mesajlar Takip'te, cevap önerisiyle. Gönderme her zaman senin onayınla.

İşler, ayrı çalışma kopyasında

"Şunu yap" de; iş yapılır, kontrol edilir, senin onayınla ana dala ya da canlıya çıkar.

Kendi Mac'inde, kapalı

Hub yalnız 127.0.0.1:7788'i dinler. Otonom işler kapalı alanda çalışır, gizli klasörleri okuyamaz.

Başlamadan

Gerekenler

Dördü zorunlu, Chrome isteğe bağlı. Ön denetim (./install.sh --check) hepsine tek tek bakar.

zorunlu

macOS 13 ya da yeni

Mac uygulaması en az macOS 13 ister. Windows ve Linux için kurulum yok.

Nasıl: Sistem Ayarları > Genel > Yazılım Güncelleme

zorunlu

Node.js 20 ya da yeni

Hub bir Node uygulamasıdır; npm de Node ile gelir. Bu sürüm Node 26 ile denendi.

Nasıl: nodejs.org LTS paketi ya da brew install node

zorunlu

Claude Code

Hub tam olarak ~/.local/bin/claude yolunu çalıştırır.

Nasıl: Anthropic'in Claude Code kurulum sayfasındaki yerel (native) kurulum. npm ya da Homebrew ile kurduysan claude install yerel sürümü kurar.

zorunlu

Xcode komut satırı araçları

Mac uygulaması derlenir (swiftc), işler git kullanır.

Nasıl: xcode-select --install

zorunlu

Bir Claude hesabı

Claude Code ile giriş yapabilen bir hesap. Oturumlar bu hesapla çalışır.

Sonra: Hub'dan istediğin kadar hesap eklersin.

isteğe bağlı

Google Chrome

Her hesabın girişi kendi Chrome profilinde açılır, tarayıcıdaki diğer hesaplar karışmaz.

Yoksa: giriş varsayılan tarayıcıda açılır.

Desteklenen tek sistem macOS. Windows ve Linux için kurulum betiği yok.

Kurulum

Beş adımda kurulum

Komutları Terminal uygulamasına yapıştır. Her kutunun sağındaki düğme komutu kopyalar.

Gerekenleri kur
Yukarıdaki dört zorunlu parçayı kur. Emin değilsen 3. adımdaki ön denetim neyin eksik olduğunu söyler.
Hub klasörünü Mac'ine al
<depo-adresi> yerine Hub'ı seninle paylaşan kişinin verdiği adresi yaz. Kurduktan sonra klasörü taşıma; taşırsan kurulumu yeniden çalıştır.
```
git clone <depo-adresi> ~/claudecode/claude-hub
```
Ön denetimi çalıştır
Hiçbir şey kurmaz, hiçbir şeyi değiştirmez. Eksik olanı Türkçe ve İngilizce yazar, her birinin yanında ne yapacağını söyler.
```
cd ~/claudecode/claude-hub && ./install.sh --check
```
Kur
Önce aynı denetimi yapar; eksik varsa durur ve hiçbir şeye dokunmaz. Sonra:
```
./install.sh
```
- paketleri kurar (npm install),
- arka plan servisini açar (~/Library/LaunchAgents/local.claude-hub.plist; oturum açınca kendiliğinden başlar),
- ~/Applications/Claude Hub.app uygulamasını derler,
- ~/.local/bin/claude-hub komutunu koyar.
Aç
Spotlight'ta "Claude Hub" ya da komutla. Uygulama ilk açılışta bildirim izni ister; izin verirsen onay bekleyen işler Mac bildirimi olarak gelir.
```
claude-hub open
```

İlk açılış

İlk hesabı eklemek

Terminalde claude ile zaten giriş yaptıysan o hesap Hub'da ana olarak görünür, başka bir şey gerekmez. Yeni ya da ikinci hesap için:

Hesap ekle

Üst şeritte Hesap ekle (⌘K paletinde de var). Kısa ad yaz; istersen e-postayı da.

Chrome penceresinde giriş

Ayrı bir Chrome penceresi açılır. Orada giriş yap ve izin ver. E-postayla gelen linke tıklama; 6 haneli kodu o pencereye yaz.

Hazır

Hub'daki pencere "Giriş tamam" der. Her hesap kendi girişini ~/.claude-hub/accounts/<kimlik> altında tutar; oturumlar, hafıza ve ayarlar ortaktır.

Giriş tamam: ad@sirket.com

Kişisel ve iş hesabı gibi istediğin kadar hesap ekleyebilirsin. Bir hesabın limiti dolunca açık oturum sıradakiyle devam eder. Görseldeki ad, e-posta ve kod örnektir.

Sade dille

İzinler: Anahtar Zinciri ve klasörler

Hub neye dokunur, neye dokunmaz. install.sh yönetici (sudo) izni istemez; yazdığı her şey senin kullanıcı klasöründe.

Anahtar Zinciri

Giriş bilgisini Claude Code kendisi saklar (macOS'ta Anahtar Zinciri'nde); Hub jetonu okumaz. Hub'ın kendi kasası (isteğe bağlı Cloudflare anahtarları gibi) da orada, claude-hub adıyla durur. macOS erişim için izin sorarsa (her Mac'te çıkmayabilir) Mac parolanı yazıp izin ver.

Hub'ın yazdığı klasörler

~/.claude-hub (hesaplar, ayarlar, kayıtlar; yalnız sen okuyabilirsin), ~/Library/LaunchAgents (servis dosyası), ~/Applications (uygulama), ~/.local/bin (komut) ve Hub klasörünün kendisi. Ön denetim hepsine yazılabildiğine bakar.

Projeler ve kapalı alan

Yeni projeler ~/claudecode altında açılır; otonom işlerin çalışma kopyaları ~/claudecode/_otonom altındadır. Otonom işler kapalı alanda (sandbox) çalışır: gizli klasörleri okuyamaz, yalnız izinli adreslere (paket depoları, GitHub, birkaç CDN) çıkar.

Ağ

Hub yalnız 127.0.0.1:7788'i dinler, dışarıdan açılmaz. Telefon portalı ve merkez isteğe bağlıdır; ayarlamazsan kapalı kalır.

İsteğe bağlı

Kişiye özel ayarlar

Hepsi boş kalabilir: boşsa o özellik kapalıdır, Hub yine açılır. Değeri ~/.claude-hub/settings.json içine yaz, sonra claude-hub restart. Ortam değişkeni ayardan önce gelir.

Ayar	Ortam değişkeni	Ne işe yarar	Boşsa
`phoneUrl`	`HUB_PHONE_URL`	Telefon bildiriminin dokunma linki (telefon portalı)	Merkez bağlıysa onun adresi; yoksa bildirim linksiz gider
`cagriDir`	`HUB_CAGRI_DIR`	Telefon çağrısı, bildirim konusu ve bekleyiş e-postası ayarlarının klasörü	`~/.claude/cagri`; klasör yoksa bu özellikler kapalı
`cfAccount`	`HUB_CF_ACCOUNT`	Önizleme yayını için kasadaki Cloudflare hesabının adı	Kasada tek hesap varsa o; hiç yoksa önizleme yayını kapalı, işler yine çalışır
(yalnız kurulumda)	`HUB_LABEL`	Arka plan servisinin adı (yalnız kurulum sırasında)	Yeni kurulumda `local.claude-hub`; eski kurulumun adı korunur

Takılırsan

Sık karşılaşılan hatalar

Ekranda gördüğün metne dokun; ne yapacağın açılır. Kırmızılar kurulumu durdurur, sarılar sonradan çıkar.

$ ./install.sh --check
Claude Hub ön denetim
Bu adım hiçbir şey kurmaz ve değiştirmez.

  [tamam] macOS XX.Y
  [tamam] Node.js vXX.Y.Z (…/bin/node)
  [tamam] npm
  [tamam] Claude Code (~/.local/bin/claude)
  [EKSİK] Xcode komut satırı araçları yok (Mac uygulaması ve git için gerekli).
          Ne yapmalı: Terminalde çalıştır: xcode-select --install (Apple'ın penceresi açılır, kurulum birkaç dakika sürer).
  [tamam] git
  [tamam] Yazma izni: ~/claudecode/claude-hub
  [tamam] Yazma izni: ~/.claude-hub
  [tamam] Yazma izni: ~/Library/LaunchAgents
  [tamam] Yazma izni: ~/Applications
  [tamam] Yazma izni: ~/.local/bin

Eksik: 1. Kurulum başlamadı, hiçbir şey değiştirilmedi.
Eksikleri tamamlayıp ./install.sh'ı yeniden çalıştır.
$

Örnek: Xcode komut satırı araçları yokken ./install.sh --check çıktısının Türkçe satırları. Her eksiğin altında ne yapacağın yazar.

[EKSİK] Claude Code ~/.local/bin/claude yolunda yok

Anthropic'in Claude Code kurulum sayfasındaki yerel kurulumu kullan. npm ya da Homebrew ile kurduysan terminalde claude install yaz, sonra ls -l ~/.local/bin/claude ile yolu kontrol et.

[EKSİK] Node.js bulunamadı / sürümü eski

nodejs.org LTS paketini kur ya da brew install node, eskiyse brew upgrade node.

[EKSİK] Xcode komut satırı araçları yok

xcode-select --install yaz, Apple'ın penceresinde kurulumu bitir, sonra ./install.sh.

[EKSİK] Bu klasöre yazılamıyor

Klasörün sahibi sen olmalısın: Finder'da klasöre sağ tıkla > Bilgi Al > Paylaşım ve İzinler.

claude-hub: command not found

~/.local/bin yolda değil. ~/.local/bin/claude-hub open yaz ya da bu klasörü PATH'e ekle.

Claude Hub sunucusuna ulaşılamadı

claude-hub restart, sonra pencerede Cmd+R. Geçmezse claude-hub log ile kayda bak.

claude-hub status: çalışıyor ama cevap vermedi

Hub meşgul olabilir; biraz bekle. Geçmezse claude-hub log.

Giriş tamamlanmadı. Tekrar deneyebilirsin.

Yeniden Girişi başlat. E-postadaki linke tıklama; 6 haneli kodu Chrome penceresine yaz.

Node'u güncelledim ya da Hub klasörünü taşıdım, Hub açılmıyor

./install.sh'ı yeniden çalıştır: servis eski yolu tutuyor.

Cloudflare hesabı ayarlı değil, önizleme yayını kapalı

Hata değil: önizleme yayını isteğe bağlıdır. İş yine Hazır olur.

Vazgeçersen

Kaldırmak

Tek komut servisi ve uygulamayı kaldırır. Hesapların ve ayarların sen silene kadar durur.

claude-hub uninstall

claude-hub uninstall

Servisi durdurur ve servis dosyasını siler
~/Applications/Claude Hub.app uygulamasını siler
claude-hub komutunu siler
~/.claude-hub (hesap girişleri, ayarlar) kalır; yeniden kurarsan kaldığın yerden devam edersin
Claude Code'un kendi klasörü ~/.claude silinmez

Tamamen silmek

Hub klasörünü ve ~/.claude-hub'ı Finder'da çöpe at. Anahtar Zinciri'ndeki girişler kendiliğinden silinmez; istersen Anahtar Zinciri Erişimi uygulamasında "claude" diye arayıp silebilirsin.

Bu geri alınamaz: hesap girişleri ve Hub kayıtları gider.

İsteyene

Tek komutla kurulum

Yalnız bir öneri. Adımları tek satırda birleştirir; sen yapıştırıp çalıştırırsan çalışır.

git clone <depo-adresi> ~/claudecode/claude-hub && ~/claudecode/claude-hub/install.sh

Hub ya da kurulum betiği bu satırı senin yerine çalıştırmaz, kendiliğinden bir şey indirip çalıştırmaz. İnternetten gelen bir betiği okumadan çalıştırma.

Claude Hub'ı kendi Mac'ine kur

Hub neler yapar

Birden çok hesap, tek pencere

Limit dolunca devam

Bütün oturumlar tek listede

Senden bekleyenler

İşler, ayrı çalışma kopyasında

Kendi Mac'inde, kapalı

Gerekenler

macOS 13 ya da yeni

Node.js 20 ya da yeni

Claude Code

Xcode komut satırı araçları

Bir Claude hesabı

Google Chrome

Beş adımda kurulum

Gerekenleri kur

Hub klasörünü Mac'ine al

Ön denetimi çalıştır

Kur

Aç

İlk hesabı eklemek

Hesap ekle

Chrome penceresinde giriş

Hazır

İzinler: Anahtar Zinciri ve klasörler

Anahtar Zinciri

Hub'ın yazdığı klasörler

Projeler ve kapalı alan

Ağ

Kişiye özel ayarlar

Sık karşılaşılan hatalar

Kaldırmak

claude-hub uninstall

Tamamen silmek

Tek komutla kurulum