Ultraplan beta

Ultraplan beta: Planı bulutta hazırlayın, terminalde veya web'de çalıştırın

Ultraplan, Claude Code'un araştırma önizlemesi (research preview) aşamasındaki bir özelliğidir. Claude Code v2.1.91 veya daha yeni bir sürüm gerektirir. Davranış ve yetenekler geri bildirimlere göre değişebilir.

Ultraplan, yerel CLI oturumunuzdaki bir planlama görevini, Claude Code on the web oturumuna (plan modunda çalışan) aktarır. Claude planı bulutta hazırlarken siz terminalde çalışmaya devam edersiniz. Plan hazır olduğunda, tarayıcınızda açarak belirli bölümlere yorum ekleyebilir, revizyon isteyebilir ve planın nerede çalıştırılacağını seçebilirsiniz.

Bu özellik, terminalin sunduğundan daha zengin bir inceleme yüzeyi istediğinizde kullanışlıdır:

• Hedefli geri bildirim (Targeted feedback): Planın tamamına yanıt vermek yerine, bireysel bölümlere yorum yapabilirsiniz.
• Eller serbest planlama (Hands-off drafting): Plan uzaktan oluşturulur, böylece terminaliniz diğer işler için boş kalır.
• Esnek çalıştırma (Flexible execution): Planı onaylayarak web üzerinde çalıştırabilir ve bir pull request açabilir veya planı terminalinize geri gönderebilirsiniz.

Ultraplan, bir Claude Code on the web hesabı ve bir GitHub deposu gerektirir. Anthropic'in bulut altyapısında çalıştığı için Amazon Bedrock, Google Cloud Vertex AI veya Microsoft Foundry kullanılırken kullanılamaz. Bulut oturumu, hesabınızın varsayılan bulut ortamında (default cloud environment) çalışır. Henüz bir bulut ortamınız yoksa, ultraplan ilk başlatıldığında otomatik olarak bir tane oluşturur.

Ultraplan'ı CLI'den başlatmak (Launch ultraplan from the CLI)

Yerel CLI oturumunuzdan ultraplan'ı üç şekilde başlatabilirsiniz:

1. Komut: /ultraplan komutunu ve ardından isteminizi çalıştırın.
2. Anahtar kelime: Normal bir istemin içine ultraplan kelimesini herhangi bir yere ekleyin.
3. Yerel plandan: Claude yerel bir planı tamamlayıp onay iletişim kutusunu gösterdiğinde, "No, refine with Ultraplan on Claude Code on the web" seçeneğini seçerek taslağı buluta gönderin.

Örneğin, bir servis geçişini planlamak için:

/ultraplan migrate the auth service from sessions to JWTs

Komut ve anahtar kelime yolları, başlatmadan önce bir onay iletişim kutusu açar. Yerel plan yolu bu iletişim kutusunu atlar çünkü bu seçim zaten onay işlevi görür.

Not: Remote Control etkinse, ultraplan başladığında bağlantısı kesilir çünkü her iki özellik de claude.ai/code arayüzünü kullanır ve aynı anda yalnızca biri bağlı kalabilir.

Bulut oturumu başlatıldıktan sonra, CLI'nizin istem girişi, uzak oturum çalışırken bir durum göstergesi gösterir:

/tasks komutunu çalıştırın ve ultraplan girişini seçerek oturum bağlantısı, ajan etkinliği ve bir "Stop ultraplan" eylemi içeren detay görünümünü açın. Durdurma işlemi bulut oturumunu arşivler ve göstergeleri temizler; terminalinize hiçbir şey kaydedilmez.

Planı tarayıcıda incelemek ve revize etmek (Review and revise the plan in your browser)

Durum ◆ ultraplan ready olarak değiştiğinde, planı claude.ai üzerinde görüntülemek için oturum bağlantısını açın. Plan, özel bir inceleme görünümünde görünür:

• Satır içi yorumlar (Inline comments): Herhangi bir pasajı vurgulayın ve Claude'un ele alması için bir yorum bırakın.
• Emoji tepkileri (Emoji reactions): Tam bir yorum yazmadan bir bölümü onaylamak veya endişe belirtmek için emoji ile tepki verin.
• Anahat kenar çubuğu (Outline sidebar): Planın bölümleri arasında gezinin.

Claude'dan yorumlarınızı ele almasını istediğinizde, planı revize eder ve güncellenmiş bir taslak sunar. Çalıştırma yerini seçmeden önce istediğiniz kadar yineleme yapabilirsiniz.

Çalıştırma yerini seçmek (Choose where to execute)

Plan doğru göründüğünde, tarayıcıdan Claude'un planı aynı bulut oturumunda uygulamasını mı yoksa bekleyen terminalinize mi geri göndermesini istediğinizi seçersiniz.

Web üzerinde çalıştırmak (Execute on the web)

"Approve Claude's plan and start coding" seçeneğini seçerek Claude'un planı aynı Claude Code on the web oturumunda uygulamasını sağlayın. Terminaliniz bir onay gösterir, durum göstergesi temizlenir ve çalışma bulutta devam eder. Uygulama tamamlandığında, diff'i inceleyin ve web arayüzünden bir pull request oluşturun.

Planı terminale geri göndermek (Send the plan back to your terminal)

"Approve plan and teleport back to terminal" seçeneğini tarayıcıda seçerek planı ortamınıza tam erişimle yerel olarak uygulayın. Bu seçenek, oturum CLI'nizden başlatıldığında ve terminal hala polling yapıyorsa görünür. Web oturumu arşivlenir, böylece paralel olarak çalışmaya devam etmez.

Terminaliniz, "Ultraplan approved" başlıklı bir iletişim kutusunda planı üç seçenekle gösterir:

• Implement here: Planı mevcut konuşmanıza enjekte edin ve kaldığınız yerden devam edin.
• Start new session: Mevcut konuşmayı temizleyin ve yalnızca planı bağlam olarak kullanarak sıfırdan başlayın.
• Cancel: Planı çalıştırmadan bir dosyaya kaydedin; Claude dosya yolunu yazdırır, böylece daha sonra geri dönebilirsiniz.

Yeni bir oturum başlatırsanız, Claude en üstte bir claude --resume komutu yazdırır, böylece önceki konuşmanıza daha sonra geri dönebilirsiniz.

İlgili kaynaklar (Related resources)

• Claude Code on the web: Ultraplan'ın üzerinde çalıştığı bulut altyapısı.
• Plan mode: Yerel bir oturumda planlamanın nasıl çalıştığı.
• Ultrareview: Birleştirme öncesi sorunları yakalamak için ultraplan'ın kod inceleme karşılığı.
• Remote Control: Kendi makinenizde çalışan bir oturumla claude.ai/code arayüzünü kullanma.

Örnek kullanım senaryosu

Bir e-ticaret uygulamasında kimlik doğrulama servisini session tabanlı yapıdan JWT tabanlı yapıya geçirmek istediğinizi düşünelim. Mevcut kod tabanınızda değişiklik yapmadan önce kapsamlı bir plan görmek ve ekibinizle paylaşmak istiyorsunuz.

1. Terminalinizde proje dizinindeyken şu komutu çalıştırın:

   /ultraplan migrate the auth service from sessions to JWTs
   

2. Onay iletişim kutusunda "Evet" seçeneğini seçin. Terminalinizde ◇ ultraplan göstergesi belirir ve Claude kod tabanınızı analiz etmeye başlar.
3. Bu sırada siz başka bir terminal sekmesinde çalışmaya devam edersiniz. Birkaç dakika sonra gösterge ◆ ultraplan ready olarak değişir.
4. /tasks komutunu çalıştırın, ultraplan girişini seçin ve oturum bağlantısını kopyalayın. Tarayıcınızda bu bağlantıyı açın.
5. Planı inceleyin. "Token refresh mekanizması" bölümünü vurgulayıp "Refresh token süresini 7 gün olarak ayarla" yorumunu ekleyin.
6. Claude yorumunuzu alır, planı revize eder ve güncellenmiş taslağı sunar. Her şey doğru görünüyor.
7. "Approve plan and teleport back to terminal" seçeneğini seçin. Terminalinizde "Ultraplan approved" iletişim kutusu açılır.
8. "Implement here" seçeneğini seçin. Plan mevcut konuşmanıza enjekte edilir ve Claude adım adım geçişi uygulamaya başlar. İlk olarak JWT kütüphanesini ekler, ardından login/logout endpoint'lerini günceller, son olarak middleware katmanını değiştirir.