Çok-Ajan Orkestrasyon Primitifleri
Claude Agent SDK'da subagent'lar üç yoldan tanımlanır: query() opsiyonlarına programatik agents parametresiyle, .claude/agents/ altında markdown dosyalarıyla, ya da tanım gerektirmeyen yerleşik general-purpose subagent ile. Resmi dokümantasyon faydayı dört maddede sabitliyor: context isolation, parallelization, specialized instructions/knowledge ve tool restrictions — Claude Code'un kendi "Task tool" mimarisinin SDK'ya taşınmış hali.
OpenAI Agents SDK iki çekirdek deseni ayırıyor: "agents as tools" (yönetici ajan uzman ajanları araç gibi çağırır, sahiplik kendisinde kalır) ve "handoffs" (konuşma tamamen devredilir). İkisi birleştirilebilir; ayrıca "orchestrating via code" ile "orchestrating via LLM" ayrımı da dokümante.
Fark: Claude tarafı izolasyon+paralelliğe, OpenAI tarafı handoff-mı-araç-mı ikilemine odaklanıyor. Seçim, ekibin zihin modeline yakın duruyor.
MCP Native Desteği ve Kurumsal Yönetim
Her iki SDK da MCP'yi birinci sınıf ele alıyor — bu, iki tarafın ayrıştığı değil, buluştuğu nokta. Claude Agent SDK'da MCP sunucuları üç yoldan bağlanır: yerel process, HTTP ya da SDK içinde çalışan in-process sunucu; .mcp.json'dan otomatik yüklenebilir. Bağlantı zamanlaması (ilk tur bekleme, tool listesi cache'i) ayrıntılı dokümante.
OpenAI Agents SDK dört transport sunar: Hosted MCP, Streamable HTTP, HTTP+SSE, stdio. Resmi güvenlik uyarısı: yalnız güvenilen sunuculara bağlan, least-privilege kimlik bilgisi kullan, token'ı URL'e değil header'a koy. README'de "Tools: functions, MCP, hosted tools" açıkça listeleniyor.
Kurumsal MCP yönetimi tarafında Anthropic'in resmi "Control MCP server access for your organization" dokümanı net bir politika seti tanımlıyor: managed-mcp.json ile sabit sunucu kümesi dayatıp münhasır kontrol kurabilir, managedMcpServers managed-setting'i ile kullanıcılar kendi sunucularını korurken onlara sunucu sağlayabilir, allowedMcpServers/deniedMcpServers ile onaylı-katalog politikası uygulayabilirsin. OpenAI Agents SDK'da ayrı, isimlendirilmiş bir kurumsal MCP-yönetim paneli görülmedi.
Dil/SDK Kapsamı ve Model Bağımsızlığı
Claude Agent SDK resmi olarak Python ve TypeScript'te dağıtılıyor; başka bir dilden aynı ajan döngüsünü sürmek için resmi yol CLI'yi subprocess olarak -p --output-format json ile çalıştırmaktan geçiyor — resmi SDK değil ama desteklenen headless köprü var. Model tarafında SDK, Claude Code CLI'yi sardığı için birinci-parti destek Anthropic modelleri + Amazon Bedrock (resmi /setup-bedrock sihirbazı, model pinleme) ile sınırlı.
OpenAI Agents SDK'nın ana geliştirmesi Python'da; ayrı bir JS/TS repo'su paralel sürdürülüyor. Python paketi "provider-agnostic" — Responses/Chat Completions API'lerini desteklediği gibi, üçüncü-parti adaptörlerle (LiteLLM) 100'den fazla LLM'i destekliyor. Model belirtilmezse varsayılan gpt-5.6-luna, reasoning.effort="none".
Sonuç: dil kapsamı benzer; model bağımsızlığında OpenAI resmi olarak daha esnek — Claude Agent SDK, Claude Code mimarisini "satın almanın" bedeli olarak Anthropic'e daha bağlı kalıyor.
Gözlemlenebilirlik ve Trace Altyapısı
OpenAI Agents SDK'nın somut kurumsal avantajlarından biri: yerleşik, varsayılan açık tracing. LLM generation'ları, tool çağrılarını, handoff'ları ve guardrail olaylarını otomatik toplayıp "Traces dashboard" üzerinden debug/izleme sunuyor. Tek kısıt: Zero Data Retention (ZDR) politikası altındaki organizasyonlarda tracing devre dışı kalıyor.
Claude Agent SDK tarafında gözlemlenebilirlik birinci-parti: resmi "Observability with OpenTelemetry" dokümantasyonu, SDK'nın sardığı Claude Code CLI'sinin OpenTelemetry ile enstrümante olduğunu ve trace, metrik ve log olaylarını OTLP kabul eden herhangi bir backend'e aktarabildiğini anlatıyor. Üç sinyalin ayrı anahtarı var — OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_TRACES_EXPORTER (trace için ek olarak CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1) — ve telemetri CLAUDE_CODE_ENABLE_TELEMETRY=1 verilene kadar kapalı. Yanıt akışından okunan token/maliyet verisi de duruyor: TS'te modelUsage, Python'da model_usage + total_cost_usd.
Sonuç: fark "veri var mı" değil, panonun nerede durduğu. OpenAI hazır görsel panoyu kutudan veriyor; Claude Agent SDK trace/metrik/olayı OTel ile senin APM'ine akıtıyor, panoyu sen seçiyorsun.
Kurumsal Dağıtım, İzin Modeli ve Hata Toleransı
Claude Agent SDK, Amazon Bedrock için resmi ve ayrıntılı dokümante edilmiş bir yol sunuyor: /setup-bedrock sihirbazı, ortam değişkeni kurulumu, takım için model pinleme. OpenAI Agents SDK'nın resmi dokümanlarında birinci-parti Azure/Bedrock kurulum sayfası bulunamadı; resmi yol önce SDK'nın yerleşik provider entegrasyon noktalarından geçiyor, bunlar yetmediğinde Any-LLM/LiteLLM gibi üçüncü-parti adaptörlere geçiliyor.
İzin tarafında Claude Agent SDK sırası net: hooks, deny, ask, permission mode, allow, canUseTool — hooks tehlikeli işlemleri önceden engelleyebiliyor, hassas eylemde insan onayı zorunlu kılabiliyor. OpenAI Agents SDK guardrail modeli input/output/tool guardrails üçlüsü; ayrıca beta'da "Sandbox Agents" modele GitHub repo veya S3/Azure Blob'dan başlayan kalıcı workspace sunuyor.
Hata toleransında Claude Agent SDK oturum kalıcılığı disk-tabanlı otomatik; continue/resume/fork var. OpenAI'nin RunState'i duraklatılmış run'ları serileştirip insan onayından sonra devam ettiriyor — human-in-the-loop için ayrı bir birincil-sınıf yapı.
Dokümantasyon, Sürüm Kadansı ve Vaka Örnekleri
Sürüm kadansı ölçülebilir bir olgunluk göstergesi. Claude Agent SDK Python paketi 23 Eylül'de v0.2.159'a ulaştı (bundled CLI'yi 2.1.281'e güncelleyen sürüm), TS tarafı 0.3.281'de; OpenAI Agents SDK Python tarafı 17 Eylül'de v0.22.3'te, JS/TS 0.18.0'da. OpenAI'nin resmi sürümleme sayfası "0.Y.Z" formunda kaldığını ve "hâlâ hızla evrildiğini" belirtiyor — iki taraf da 1.0 öncesi, CI'da sürüm pinlemeyi zorunlu kılıyor.
Popülerlikte GitHub verisi net: openai-agents-python 29.670 yıldızla claude-agent-sdk-python'ın (8.156 yıldız) önünde — kısmen erken doğuşundan (Mart 2025'e karşı Haziran 2025) kaynaklanıyor olabilir.
Resmi "üretim vaka çalışması" ekseninde ikisi de zayıf: Claude'un ajan çözümleri sayfası müşteri logoları listeliyor ama SDK'ya özgü değil; iki tarafın resmi dokümantasyonu da SDK'ya özel, adlandırılmış bir üretim vaka sayfasına yönlendirmiyor.