Makaleler
Deckhand'e giriş: Claude Code'u üçüncü taraf yapay zeka kontrol konsolunuz yapın
Deckhand, giriş kutusunun üstüne bir araç çubuğu ekleyen açık kaynaklı bir Claude Code eklentisidir: görevleri salt okunur olarak Codex, Cursor agent ve agy'ye devredip ikinci görüş alır, Sub5 ile alt ajanları paralel çalıştırır, ayrıca kullanım ölçümleri ve model geçişi sunar. Bu yazı kurulumu, her özelliğin kullanımını, veri akışını ve bilinen sınırlamaları anlatıyor.
· 5 dk okuma
Deckhand, giriş kutusunun üstüne bir araç çubuğu ekleyen bir Claude Code eklentisidir. Ana ajan yine Claude'dur; araç çubuğu görevi Codex, Cursor agent veya agy'ye salt okunur olarak verebilir, cevap geldikten sonra Claude onu inceler ve kullanıp kullanmayacağına karar verir.
Araç çubuğu ayrıca kullanım ölçümleri, model geçişi ve görevi birden çok alt ajana bölüp paralel işleten Sub5'i sunar. Terminalde de masaüstü uygulamasında da çalışır. Güncel sürüm 1.1.1, lisans MIT.
Açıklama: Deckhand, bu sitenin yazarı tarafından geliştirilmiştir.
Özelliklere genel bakış#
| Bölüm |
Özellik |
cL cS cA cR gF |
Görevi başka bir yapay zeka CLI'sine salt okunur olarak devreder, cevabı Claude inceler |
Sub5 |
Mevcut görevi en fazla 5 maddeye böler, alt ajanlar her biri kendi git worktree'sinde paralel işler |
O F S H |
Opus, Fable, Sonnet veya Haiku'ya geçiş yapar |
| Kullanım ölçümleri |
5 saatlik pencere, modele göre haftalık pencereler, tüm modeller toplamı için haftalık pencere, bağlam penceresi |
Recap |
Mevcut bağlamı yan panelde açıklar |
⚙ |
Ayarlar panelini açar |
Kurulum ve gereksinimler#
Claude Code içinde şunu çalıştırın:
/plugin marketplace add stephen-taipei/deckhand
/plugin install deckhand@deckhand
Araç çubuğu görünmüyorsa yeni bir oturum açın.
Gereksinimler:
- macOS veya Linux. Windows henüz test edilmedi.
- Eklenti hook modüllerini destekleyen bir Claude Code; 2.1.288 üzerinde test edildi.
- Python 3.9 veya üzeri.
- İsteğe bağlı: izleme özelliği için
gh; devretme düğmeleri için codex, Cursor agent veya agy CLI'si. Kurulu olmayan CLI'lerin düğmeleri gizlenir.
Devretme: salt okunur ikinci görüş#
Devretme düğmesine bastığınızda Deckhand görevi ilgili CLI'ye verir. Karşı taraf yalnızca okuyabilir, değiştiremez; cevabı yazıp Claude'a inceletmek üzere geri verir.
Varsayılan devretme hedefleri:
| Düğme |
CLI |
Model |
Effort |
cL |
Codex |
GPT-6 Luna |
max |
cS |
Codex |
GPT-6.1 Sol |
medium |
cA |
Codex |
GPT-6 Astra |
medium |
cR |
Cursor agent |
Grok 4.7 |
high |
gF |
agy |
Gemini 3.8 Flash |
high |
Etiketler, CLI'ler, model kimlikleri, effort ve adlar ayarlardan değiştirilebilir.
Salt okunur olma kuralını her CLI kendi bayrağı veya modu ile uygular:
- Codex:
-s read-only
- Cursor agent:
--mode ask
- agy: headless mod, araç çağrıları otomatik olarak reddedilir
Göndermeden önce Deckhand görev açıklamasını denetler; içinde token, anahtar veya parola varsa göndermeyi reddeder. Görev açıklaması ve cevap özel bir geçici klasörde saklanır ve 3 gün sonra silinir.
Devretme çalışırken kullanım çubuğunun üstünde bir satır daha belirir; etiketi, CLI'yi, modeli ve geçen süreyi gösterir. /delegates son 3 gündeki devretmeleri listeler; her cevap açılabilir, kopyalanabilir veya giriş kutusuna geri getirilebilir, ayrıca CLI'nin bildirdiği token sayısı da gösterilir.
Devretme, görev açıklamasını o CLI'nin arkasındaki hizmet sağlayıcıya gönderir.
Sub5: paralel alt ajanlar#
Sub5, mevcut görevi birbirinden bağımsız en fazla 5 maddeye böler; her madde bir alt ajan tarafından kendi git worktree'sinde işlenir. Hepsi bitince ana ajan sonuçları inceler, değişiklikleri birleştirir, worktree'leri ve dalları temizler.
git işlemlerini bin/sub5.py betiği yürütür; force kullanmaz, push yapmaz. Alt ajanların modeli, effort'u ve en fazla madde sayısı ayarlardan değiştirilebilir.
Bir çalıştırma yarıda kesilirse (tur durdurulursa, worker başarısız olursa, oturum kapanırsa) worktree'ler ve dallar geride kalabilir. /sub5-clean bu artıkları listeler; onayınızdan sonra yalnızca işlenmemiş değişikliği olmayan worktree'leri ve birleştirilmiş dalları kaldırır; son bir saat içinde kullanılanlar korunur.
Maddeler birbirine bağımlıysa Sub5 uygun değildir; paralel işlemek yalnızca birleştirme çakışmalarını artırır.
Model geçişi#
O F S H sırasıyla Opus, Fable, Sonnet ve Haiku'dur.
- Terminal: Mevcut oturumun modelini doğrudan değiştirir, mevcut effort seviyesi korunur.
- Masaüstü uygulaması: Claude Code, eklentilerin
/ ile başlayan istemler göndermesini kabul etmez, uygulama da oturumun kendi modelini değiştirmesine izin vermez; bu yüzden düğme /model claude-opus-5-5 gibi tam model kimliğini giriş kutusuna yazar. Enter'a bastığınızda geçiş yapılır, ardından Deckhand effort'u eski seviyesine geri ayarlar.
Kullanım ölçümleri#
5h: 5 saatlik pencere.
fb, sn, op: Hesabın sahip olduğu modellerin haftalık pencereleri.
7d: Tüm modellerin toplamı için haftalık pencere.
ctx: Bağlam penceresinin kullanım oranı.
Sayılar Claude uygulamasındaki kullanım kartıyla aynıdır ve aşağı yuvarlanır. Herhangi bir pencere uyarı eşiğini aştığında Deckhand bir kez bildirim verir; eşik ayarlardan değiştirilebilir.
Recap#
Recap, mevcut tüm bağlamı yan panelde sade bir dille açıklar; konuşmaya hiçbir şey eklemez.
İzleme ve koruma araçları#
| Araç |
Amaç |
/watch-deploy, watch_deploy |
PR'ı, CI çalıştırmasını veya bir URL'yi arka planda izler; üst üste N kez aynı sonuç gelirse otomatik durur |
| Yoklama koruması |
sleep yoklama döngülerini ve gh run watch gibi bloklayan beklemeleri engeller |
| İmza koruması |
commit ve PR komutlarından Co-Authored-By trailer'ını ve Claude Code alt bilgisini kaldırır |
/handoff, /handoff-in, /codex |
İşi Claude ile Codex arasında devreder |
translate |
Yerelleştirme çevirisini belirlenen devretme hedefine verir, varsayılan olarak kapalıdır |
search |
Belirlenen devretme hedefine kaynak göstererek web araması yaptırır, ardından Claude doğrular; varsayılan olarak kapalıdır |
Ayarlar#
Araç çubuğunun en sağındaki ⚙ simgesine tıklayın veya /deckhand komutunu çalıştırın; ayarlar paneli açılır. Panel Genel, Devretme, Çeviri ve arama, Sub5, Gelişmiş olmak üzere 5 sekmeye ayrılır. Ayarlar yerel olarak saklanır, JSON olarak dışa aktarılıp başka bir bilgisayarda içe aktarılabilir.
Arayüz English, 繁體中文, 简体中文, 日本語 ve 한국어 dillerini destekler; varsayılan olarak Claude Code'un language ayarını izler.
Veri akışı#
Bilgisayardan çıkan veri yalnızca şu üç türdendir:
- Devredilen görev açıklaması: Devretme düğmesine bastığınızda seçilen CLI'nin hizmet sağlayıcısına gönderilir.
- Kullanım okumaları: Claude Code üzerinden, mevcut oturumun kimlik bilgileriyle Anthropic'in kullanım uç noktası çağrılır.
- Elle çağırdığınız araçlar:
translate ve search belirlenen devretme hedefine gönderilir; izleme özelliği gh ile GitHub'u sorgular veya belirtilen URL'yi okur.
Bilinen sınırlamalar#
- Windows henüz test edilmedi.
- Masaüstü uygulamasındaki model düğmeleri tek tıkla geçiş yapamaz; giriş kutusunda Enter'a basmak gerekir.
- Devretmede durdurma düğmesi yoktur: Deckhand yalnızca devretmeyi çalıştıran Bash çağrısını gözlemler, iptal edemez.
- Devredilen görev açıklaması üçüncü taraf hizmet sağlayıcılara gönderilir.
Kaynak kodu ve tam belgeler GitHub üzerinde. Deckhand bağımsız olarak geliştirilmiş bir eklentidir, Anthropic ürünü değildir.