Elinizde çalışan bir Codex görevi, devretmek istediğiniz bir hata düzeltmesi, kapsam ihtiyacı olan bir test paketi ve sürekli ertelediğiniz bir refaktör var. Dördü de birbirinden bağımsız. Aynı anda çalışmalarının önünde hiçbir engel yok; tek engel pratik olan: iki Codex oturumunu aynı çalışma kopyasına yönlendirin, birbirlerinin değişikliklerinin üzerine yazmaya başlarlar. İstediğiniz paralellik, istemediğiniz bir birleştirmeye dönüşür.
Birden fazla Codex görevini aynı anda çalıştırmak, açıp kapattığınız bir özellikten çok, kurduğunuz bir düzenek. Üç yol var: Codex'in bulut görevleri, birden fazla yerel CLI oturumu ve tek bir oturum içindeki alt ajanlar. Her biri gerçek bir eşzamanlılık sağlıyor ve her birinin, yazma işlemleri çakıştığı anda ortaya çıkan tek bir arıza modu var. Bu rehber üçünü de komutlarıyla birlikte adım adım ele alıyor, her adımda o arızayı isimlendiriyor ve sonunda bir görev panosunun devreye girdiği noktayı gösteriyor.
O görev panosu Sharkly. Codex zaten elinizde. Sharkly onun üstünde konumlanıyor: Codex'i bir Runtime olarak çalıştırıyor ve her paralel çalışmayı kendi yalıtılmış çalışma kopyasına, kendi log kaydına ve kendi inceleyicisine sahip bir Task'a dönüştürüyor. Makale önce manuel kurulumu ele alıyor, çünkü otomatikleştirmeden önce neyi otomatikleştirdiğinizi anlamanız gerekir.
Özet
Codex paralel ajanları, birden fazla Codex görevini tek tek yerine eşzamanlı olarak çalıştırmak demek. Bunu yapmanın üç yolu var: Codex bulut görevleri (OpenAI'ın dokümanlarına göre her biri yalıtılmış bir ortamda), birden fazla yerel codex CLI oturumu veya tek bir oturum içindeki alt ajanlar. Hepsini yöneten kural şu: her iş birimi için bir çalışma kopyası. Yani her göreve kendi git worktree'sini verin ki eşzamanlı düzenlemeler hiçbir zaman aynı dosyalara dokunmasın. Bu, birkaç göreve kadar sorunsuz ölçeklenir. Sonrasında hangi ajanın ne yaptığını takip etmek ve her sonucu ayrı ayrı incelemek darboğaza dönüşür; Sharkly'nin eklediği katman da tam olarak burasıdır.
Codex'i paralel çalıştırmanın üç yolu
Yöntemi, işin nerede çalıştığına ve ne kadarını görmeniz gerektiğine göre seçin; kulağa en güçlü geleni seçmeyin.
| Yöntem | Nasıl çalışır | Yalıtım | En uygun olduğu durum |
|---|---|---|---|
| Codex bulut görevleri | Her görev kendi bulut ortamında | Güçlü, görev başına | Devredilen, kendi kendine yeten ve sonradan incelediğiniz görevler |
| Birden fazla CLI oturumu | Makinenizde birkaç codex süreci |
Varsayılan olarak yok; paylaşılan çalışma kopyası | Canlı izlemek istediğiniz yerel işler |
| Tek oturumda alt ajanlar | Tek oturum, başlattığı iş parçacıklarını yönetir | Paylaşılan oturum dizini | Okuma ağırlıklı işler: keşif, triyaj, testler |
İş net bir kapsama sahipse ve sonradan kontrol etmek size uygunsa Codex bulut görevlerini kullanın. Her çalışmayı olurken yönlendirmek istiyorsanız yerel CLI oturumlarını kullanın. İş ağırlıklı olarak okumaktan ibaretse alt ajanları kullanın; çünkü başlatılan ajanlar tek bir çalışma dizinini paylaşır ve Codex alt ajan davranışına göre oturum hepsini bekler, ardından tek bir birleştirilmiş yanıt döndürür. Bu son yaklaşım paralel yazma için uygun değil: aynı anda kod düzenleyen ajanlar çakışma yaratır ve tek bir özet parça parça incelenemez.
Adım adım: birden fazla Codex görevini yerelde çakışma olmadan çalıştırma
Yerel yol, çoğu kişinin ilk başvurduğu ve ilk bozulan yol. İşte ayakta kalan kurulum.
1. Adım. Her göreve kendi çalışma kopyasını verin. git worktree, aynı depoyu arka planda kullanan, kendi dalına sahip ikinci bir çalışma dizinidir. Her görev için bir tane oluşturun:
git worktree add ../app-authfix -b fix/token-refresh
git worktree add ../app-tests -b test/checkout-coverage
git worktree add ../app-refactor -b refactor/api-client
Bunu atlarsanız ne olur: aynı klasördeki iki codex oturumu aynı dosyaları düzenler, sonraki yazma sessizce kazanır ve ikisi de başarılı olduğunu bildirir. Kaybı ya inceleme sırasında ya da üretimde fark edersiniz.
2. Adım. Her worktree için bir Codex oturumu başlatın. Her dizinde bir terminal açın ve Codex'i orada çalıştırın:
cd ../app-authfix && codex
Bunu atlarsanız ne olur: bağlamında dört farklı hedef taşıyan tek bir oturum aralarında savrulur ve hangi değişikliğin hangi göreve ait olduğunu takip edemez.
3. Adım. Klavye başında birine ihtiyaç duymayanları betikleştirin. Kendi kendine yeten bir görev için etkileşimsiz mod, hiçbir istem olmadan sonuna kadar çalışır:
cd ../app-tests && codex exec "add tests for the checkout flow until coverage passes"
Bunu atlarsanız ne olur: size hiç ihtiyacı olmayan oturumların başında oturup beklersiniz; bu da onları paralel çalıştırmanın anlamını ortadan kaldırır.
4. Adım. Bilinçli birleştirin, her seferinde tek bir dal. Her worktree bir daldır, dolayısıyla onları ayrı ayrı inceleyip birleştirin. Ajanların birbirlerinin işini birleştirmesine asla izin vermeyin. Bunu atlarsanız ne olur: üç dal aynı anda ana dala girer, birleştirme commit'inde bir çakışma ortaya çıkar ve artık bunun hangi ajanın değişikliğinden kaynaklandığını söyleyemezsiniz.
Sonrasında worktree'leri temiz bir şekilde budamanın ayrıntıları için kodlama ajanları için worktree'leri temizlik derdi olmadan yönetme yazısına bakın. Aynı worktree deseni birden fazla Claude Code ajanını çalıştırma için de geçerli; tasarımı gereği hiçbir çalışma zamanına bağlı değil.
Kendin-kur kurulumunun ölçeklenmeyi bıraktığı yer
Worktree'ler çakışmaları çözer. Her şeyi çözmezler ve duvar göründüğünden daha yakın.
Üç dört görevde kurulum ayakta kalır. Sekizde, terminal ızgarası artık bir çalışma alanı olmaktan çıkıp bir hafıza testine dönüşür. Arızalar dramatik değil; birikir:
- Haritayı kaybedersiniz. Hangi pencere kimlik doğrulama düzeltmesiydi? Hangisi bitti? Hangisi yirmi dakika önce başarısız oldu ve o zamandan beri boş bekliyor? Durum yalnızca kafanızda yaşıyor ve ekrandan kayıp gidiyor.
- İncelemenin tutunacak bir yeri yok. Her oturumun çıktısı, sonu gelmeyen bir terminal kaydı. Neye dokunduğuna, neyi çalıştırdığına ve nerede durduğuna dair görev bazlı bir kayıt yok; bu yüzden bir sonucu kabul edip diğerini temiz bir şekilde reddedemezsiniz.
- Hiçbir şey paylaşılmıyor. Bir ekip arkadaşı ilerlemeyi görmek istediği anda diff'leri Slack'te bir başlığa kopyalamaya başlıyorsunuz. İş gerçek ama görünmez.
Bunlar, her paralel ajan iş akışının vardığı aynı üç problem ve sayı arttıkça ekiplerin neden paralel kodlama ajanlarını yönetmek için özel araçlara yöneldiğinin sebebi. Yalıtım çözülmüş bir problem. Görünürlük ve inceleme değil; en azından bir terminal ızgarasıyla değil.
Bir görev panosunun kattıkları
İşte ajanın üstündeki katmanın yerini hak ettiği nokta burası. Sharkly'de bir Task, tek bir iş biriminin paylaşılan kaydıdır ve Codex görevlerini paralel çalıştırmak, Task'ları paralel çalıştırmaya dönüşür.
Her Task otomatik olarak yalıtılmış bir git worktree sahiplenir; böylece yalıtılmış worktree'lerde paralel ajanlar betikle kurduğunuz bir şey olmaktan çıkıp varsayılan haline gelir. Tek bir depoya karşı on Task, sıfır paylaşılan durum, elle yazılan tek bir git worktree add yok. Düzenlemeyi yapan Runtime hâlâ Codex; yalıtım onun etrafında sağlanıyor.
Asıl mesele iş bölümü. Ajanlar araştırır, yürütür, test eder ve raporlar. İnsanlar yön belirler, yetki verir ve sonucu kabul eder. Otomasyon, ekip muhakemesinin gerektiği yerde durur. Bu yüzden her çalışma; tetikleyicisini, araç çağrılarını ve nerede durduğunu içeren kendi yürütme kaydını tutar ve nihai sonucu terminalde kayıp gitmek yerine Task'a döner. Bağlam, ilerleme, engeller, sonuçlar ve insan incelemesi, talep anından sürüme kadar görünür kalır ve özetlerin özetini okumak yerine her birini ayrı ayrı incelersiniz. Bunun raporlama tarafı için AI kodlama ajanlarının tamamladığı işler nasıl takip edilir yazısına bakın.
Sharkly, Codex'in yerini almıyor. Zaten çalıştırdığınız ajanın etrafına paylaşılan görev, çalışma kopyası, bağlam ve inceleme katmanını ekliyor. Codex'i yalnızca tek oturum halinde çalıştırıyorsanız ona ihtiyacınız yok. Aynı kod tabanı üzerinde birkaç oturum çalıştırıp ipin ucunu kaçırıyorsanız, işte tam bu problem için tasarlandı. Yukarıdaki worktree kurulumunu elle de kurabilirsiniz ya da mevcut Codex görevlerinizi Sharkly üzerinden çalıştırıp durumu iş akışının sizin için tutmasını sağlayabilirsiniz.
Bugün hemen uygulayabileceğiniz bir kontrol listesi
- Görev başına bir git worktree, her biri kendi dalında. Hiçbir iki görev aynı çalışma kopyasını paylaşmaz.
- Worktree başına bir Codex oturumu; size ihtiyacı olmayan görevler için
codex exec. - Alt ajanları yalnızca okuma ağırlıklı işler için kullanın; eşzamanlı yazmaları ayrı çalışma kopyalarında tutun.
- Dalları her seferinde bir tane birleştirin ve her birini ana dala girmeden önce inceleyin.
- Hangi görevin hangisi olduğunu, her birinin neye dokunduğunu ve sonucunu, ekip arkadaşlarınızın görebileceği bir yerde kayıt altında tutun.
- Terminal ızgarası kafanızda tutamayacağınız hale geldiğinde, takibi ve incelemeyi bir görev panosuna taşıyın; böylece her çalışma sonucunu tek bir paylaşılan yere döndürsün.
SSS
Codex aynı anda birden fazla görev çalıştırabilir mi? Evet. OpenAI'ın dokümanlarına göre Codex bulut, görevleri yalıtılmış ortamlarda çalıştırır; yerelde de aynı anda birkaç codex oturumu açabilirsiniz. Kısıt Codex değil, çalışma kopyası: her yerel göreve kendi git worktree'sini verin ki düzenlemeleri çakışmasın.
Aynı anda kaç paralel Codex ajanı çalıştırabilirim? Makineniz ve model kotanız elverdiği kadar. Pratik üst sınır daha düşük: bir kişinin gerçekten inceleyebileceği eşzamanlı sonuç sayısı. Birkaç görevi geçtiğinizde sınır, hesaplama gücü değil takip ve inceleme olur.
Worktree şart mı, yoksa sadece daha fazla terminal mi açsam? Aynı dizinde daha fazla terminal, aynı dosyalara eşzamanlı yazma ve sessizce üzerine yazma anlamına gelir. Worktree'ler her oturuma kendi dizinini ve dalını verir; yerel paralelliği güvenli kılan da budur. Bkz. AI kodlama ajanları için git worktree'leri.
Codex alt ajanları ile paralel görevler arasındaki fark ne? Alt ajanlar tek bir oturum içinde çalışır, o oturumun çalışma dizinini paylaşır ve tek bir birleştirilmiş yanıt döndürür; bu da okuma ve triyaj için uygundur. Paralel görevler ise ayrı çalışma kopyalarına sahip ayrı çalışmalardır; eşzamanlı yazma ve bağımsız inceleme için istediğiniz de budur.
