Kontrol tarihi 7 Kasım 2026. Burada ele alınan iki istemci sürüm kaydı da 6 Kasım tarihlidir. Bunlar çalışma zamanı güncellemeleridir; yeni model duyurusu veya her kurulum ve hesap için aynı destek anlamına gelmez.
Mühendislikte başarı hangi katmanda oluştu? Komutun kabulü, oturumun sürmesi, aracın bitmesi ve çıktının bağımsız doğrulanması farklı olaylardır. Resmî belgeler ve tamamen sentetik yerel dosyalarla kabul yöntemini gösteriyoruz. Eğitim betiği üretim MCP istemcisi değildir; gerçek hizmetlere bağlanmaz.
1. Güncellemeler gerçekte neyi değiştiriyor?
Claude Code 2.1.319 kaydı terminal MCP tasks desteğini, izin istemini beklemek yerine çağrıyı reddeden ayarı ve arka plan değişikliklerini listeler. O sürüm kaydına dayanıyoruz; her arayüzde ilk çıkış tarihi veya her aracın süreç kapandıktan sonra süreceği garantisi çıkarmıyoruz.
Aynı günün Codex CLI 0.167.0 kaydı bağlı arka uçlar, sağlayıcı değişiminden sonra sohbet görünürlüğü, ağ onaylarının ömrü ve sıkıştırmada başarısız yanıtların hesabını kapsar. Bunlar kurtarma ve tanıyı iyileştirir; görünür sohbet, ortam ve uzak görevin kayıpsız döndüğünü göstermez.
| Güncelleme işareti | Kontrol etmeye yardımcı olduğu şey | Ayrıca kanıtlanması gereken |
|---|---|---|
| Claude Code MCP tasks | Sunucu kabulü, arka plan durumu ve sonuç teslimi | Gerekli görevler bitti, dosya doğru, iptal etkili |
| İzin gerektiren çağrıyı reddedip turu sürdürme | Ret kaydı ve başka işin sürmesi | Reddedilen zorunlu adımın başarısı |
| Codex sağlayıcı / arka uç değişimi | Geçmiş görünürlüğü, hedef oturum ve sürdürme durumu | Ortam, izin, fatura ve dosyaların eşleşmesi |
| Sıkıştırma ve ağ onayı düzeltmeleri | Saklanan hatalar, istek bitişi ve onay durumu | İşin başarısı veya uzak etkilerin geri alınması |
Bu rehber istemci/araç yaşam döngüsünü API konuşma saklaması, model sıralaması ve abonelik alımından ayırır. Odak, asenkron iş, reddedilen çağrı veya başarısız sürdürme olduğunda dış iş akışının doğru sonucu korumasıdır.
2. Üç farklı arka plan mekanizmasını ayırın
Claude, yavaş normal MCP çağrısının otomatik arka plana taşınmasını sunucunun yönettiği MCP task mekanizmasından ayırır. Ana konuşma çağrısı varsayılan iki dakikadan sonra arka plana geçebilir; sunucu görevi ise kabul edilince döner. İkisinde de sonuçtan önce kimlik gelebilir ama çıkış ve kurtarma sınırları farklıdır.
| Tür | Önce dönen şey | Oturumdan çıkış sınırı |
|---|---|---|
| Normal uzun MCP çağrısı | Yerel izlenen arka plan çağrısı / görev kimliği | Devam garantisi yoktur; iptal sunucunun hiçbir şey yapmadığını göstermez |
| Sunucunun yönettiği MCP task | Sunucunun kabul ettiği görev | Uzak sunucu sürebilir; stdio süreci ve sunucu uygulaması ayrı kontrol edilir |
| Codex asenkron hook | Bir arka plan hook çağrısı | Oturum sonu bitmemiş hook işlerini iptal eder, teslim edilmemiş çıktıyı atar |
Codex arka plan hook mekanizması ayrıdır. Bitince bilgisi daha sonraki güvenli noktada modele gelir; onu tetikleyen işlemi engelleyemez, onaylayamaz veya değiştiremez. İşlem öncesi kontrol gerekiyorsa sonradan gelen asenkron rapor değil, uygun senkron politika gerekir.
Görevin sahibini, kimin durum sorgulayacağını, kimin iptal edeceğini ve sonucun nereye gideceğini kaydedin. Asıl sunucu, oturum veya çağrı bağlantısı olmayan kimlik, yanlış görevi sorgulamaya ya da sonuç gelmedi diye yeniden göndermeye yol açabilir.
3. Ret, exit 0 ve başarılı sürdürme farklıdır
Sürümdeki permissions.denyInsteadOfPrompting ayarı, izin istemini bekleyecek çağrıyı reddeder ve tur sürer. Sürmek izin vermek veya aracın başarılı olması değildir. Reddedilen zorunlu adım, meşru alternatif açıkça onaylanıp kaydedilmedikçe engelli kalır.
Codex queue ile --resume başka bir tuzaktır. Güncel başvuru kaynağı, sürdürme başarısız olduğunda uyarı basıp yine başarılı çıkılabileceğini belirtir. Yalnızca exit 0 kontrolü, sıraya alınan mesajı sürdürülen işle karıştırır. Bu her CLI için değil, bu komuta özgü belgelenmiş davranıştır.
Tersine, istemcinin sıfır dışı çıkışı uzak görevin durduğunu veya geri alındığını kanıtlamaz. Bu istemci zincirinin kabulü geçemeyeceğini gösterir. Yan etkili isteği tekrarlamadan önce uzak sonucu ve dosyaları uzlaştırın.
| İşaret | Neyi gösterebilir? | Tek başına neyi göstermez? |
|---|---|---|
| client_exit_code = 0 | Komut kendi kurallarına göre normal çıktı | Sürdürme, tüm zorunlu işlerin başarısı veya dosya doğrulaması |
| Zorunlu görev denied | Gerekli çağrı reddedildi | Politikayı aşma veya adımı atlama izni |
| Görev completed | Görev son durum bildirdi | Doğru dönüş, dosyalar ve iş kontrolleri |
| Bağımsız doğrulama geçti | Belirtilen girdilerde belirtilen kontroller geçti | Bütün gelecek girdiler ve diğer arayüzlerin güvenilirliği |
4. Tamamen çevrimdışı yedi senaryo hazırlayın
Yeni boş alıştırma dizini ve Python 3.10 veya üstünü kullanın. Aşağıdakini prepare_fixture.py olarak kaydedin. Mevcut dizin altında lifecycle-demo ile sabit metin oluşturur; hesap ayarlarını okumaz, Claude, Codex, MCP veya ağ isteği başlatmaz.
fixture.json bizim eğitim biçimimizdir; herhangi bir sağlayıcının olay şeması değildir. Her senaryoda bir zorunlu görev ve önceden belirlenmiş expected sınıfı bulunur. Gerçek entegrasyonda zorunlu küme güvenilir planla tanımlanmalı; model başarısız adımı sessizce isteğe bağlı yapmamalıdır.
import hashlib
import json
from pathlib import Path
root = Path.cwd() / "lifecycle-demo"
(root / "artifacts").mkdir(parents=True, exist_ok=True)
content = b"synthetic report\n"
(root / "artifacts" / "report.txt").write_bytes(content)
artifact = {"path": "artifacts/report.txt", "sha256": hashlib.sha256(content).hexdigest()}
def case(name, state, expected, artifacts=None, resume=False, resumed=False, exit_code=0):
return {
"case": name,
"client_exit_code": exit_code,
"continuation_required": resume,
"continuation_state": "resumed" if resumed else "not_resumed",
"tasks": [{"task_id": "t1", "required": True, "state": state}],
"artifacts": artifacts or [],
"expected": expected,
}
fixtures = [
case("queue_ack_only", "queued", "NOT_RESUMED", resume=True),
case("background_running", "running", "PENDING"),
case("denied_turn_continues", "denied", "BLOCKED"),
case("completed_without_artifact", "completed", "UNVERIFIED"),
case("resumed_and_verified", "completed", "VERIFIED", [artifact], True, True),
case("client_failed", "completed", "FAILED", [artifact], exit_code=3),
case("wrong_digest", "completed", "UNVERIFIED", [{"path": artifact["path"], "sha256": "0" * 64}]),
]
(root / "fixture.json").write_text(json.dumps(fixtures, indent=2) + "\n", encoding="utf-8")
print(root)
python3 prepare_fixture.pyYedi senaryo; kuyruk onayı, süren arka plan işi, ret sonrası devam, dosyasız tamamlanma, doğrulanmış sürdürme, istemci hatası ve özet uyuşmazlığıdır. Bunlar sentetik girdidir; yedi model çağrısı veya sağlayıcı güvenilirliği istatistiği değildir.
5. Durum ve dosya kontrolünü kabul kapısına dönüştürün
Sonraki dosyayı lifecycle-demo/verify_lifecycle.py olarak kaydedin. Önce istemci ve sürdürmeyi, sonra zorunlu görevleri, en son dosya yolu ve SHA-256 değerini denetler. Sıra bilinçlidir: tam dosya başarısız sürdürmeyi silemez; tamamlanma bildirimi dosyanın yerini tutmaz.
import argparse
import hashlib
import json
from pathlib import Path
ROOT = Path(__file__).resolve().parent
def classify(case):
exit_code = case.get("client_exit_code")
if type(exit_code) is not int:
return "UNVERIFIED"
if exit_code != 0:
return "FAILED"
if case.get("continuation_required") is True and case.get("continuation_state") != "resumed":
return "NOT_RESUMED"
required = [task for task in case.get("tasks", []) if task.get("required") is True]
if not required:
return "UNVERIFIED"
states = {task.get("state") for task in required}
if "denied" in states:
return "BLOCKED"
if states & {"failed", "cancelled", "timed_out"}:
return "FAILED"
if states & {"queued", "running"}:
return "PENDING"
if states != {"completed"}:
return "UNVERIFIED"
artifacts = case.get("artifacts", [])
if not artifacts:
return "UNVERIFIED"
for artifact in artifacts:
relative = Path(artifact.get("path", ""))
if relative.is_absolute() or ".." in relative.parts:
return "UNVERIFIED"
path = (ROOT / relative).resolve()
if not path.is_relative_to(ROOT) or not path.is_file():
return "UNVERIFIED"
expected = artifact.get("sha256")
if not isinstance(expected, str) or len(expected) != 64:
return "UNVERIFIED"
if hashlib.sha256(path.read_bytes()).hexdigest() != expected:
return "UNVERIFIED"
return "VERIFIED"
def main():
parser = argparse.ArgumentParser()
parser.add_argument("--gate", action="store_true")
args = parser.parse_args()
fixtures = json.loads((ROOT / "fixture.json").read_text(encoding="utf-8"))
results = [{"case": item["case"], "status": classify(item)} for item in fixtures]
print(json.dumps(results, indent=2))
if any(result["status"] != item["expected"] for result, item in zip(results, fixtures)):
return 1
if args.gate and any(result["status"] != "VERIFIED" for result in results):
return 2
return 0
if __name__ == "__main__":
raise SystemExit(main())
Buradaki beklenen özet, hazırlık betiğindeki önceden sabit sentetik metinden gelir ve aynı baytları kontrol eder. Gerçek raporun özeti önceden bilinmeyebilir; bağımsız yapı, içerik veya test oracle gerekir. Modelin yeni dosyasını özetleyip aynı modele eşleşti dedirtmek içerik doğruluğunu kanıtlamaz.
Bu küçük betik sunucu sorgulama, izin kararı veya gerçek protokol kimlik doğrulaması uygulamaz. Gerçek olayları uyarlamadan kaynak ve yapıyı doğrulayın, kontrollü kayda eşleyin; son durumun aynı run, session, server ve task ile ilişkili olduğundan emin olun. Rastgele günlükte completed sözcüğü güvenilir son olay değildir.
6. Önce regresyonu, sonra toplu kabul kapısını çalıştırın
Önce normal modu çalıştırın. Yedi sınıfı basıp fixture içindeki expected ile karşılaştırır. Yalıtılmış output alıştırma dizininde çalıştırdık; beklenen çıkış 0 oldu. Bu sıfır, doğrulayıcının başarılı ve başarısız örnekleri doğru tanıdığını ifade eder.
python3 lifecycle-demo/verify_lifecycle.py| case | Beklenen durum | Anlamı |
|---|---|---|
| queue_ack_only | NOT_RESUMED | Sürdürme gerekiyor ama kanıtlanmamış |
| background_running | PENDING | Zorunlu görev bitmemiş |
| denied_turn_continues | BLOCKED | Zorunlu görev reddedilmiş |
| completed_without_artifact | UNVERIFIED | Son durum teslimi kanıtlamıyor |
| resumed_and_verified | VERIFIED | Bu sentetik örnek kontrolleri karşılıyor |
| client_failed | FAILED | Bu istemci zinciri başarısız |
| wrong_digest | UNVERIFIED | Dosya beklenen baytlarla eşleşmiyor |
Sonra --gate çalıştırın. Herhangi bir senaryo VERIFIED değilse karışık küme 2 döndürüp durdurulur. Komutu yeşile çevirmek için başarısız senaryoları silmeyin; normal testteki sıfırı tüm işlerin tamamlandığı sanmayın.
python3 lifecycle-demo/verify_lifecycle.py --gateModlar, test programının doğruluğunu test edilen iş kümesinin serbest bırakılmasından ayırır. Üretim hattı kendi hata ve tekrar politikasını tanımlamalıdır. FAILED burada kabulün geçmediğini söyler; uzak etkilerin geri alındığını kanıtlamaz.
7. Ajandan tamamlandı sözü değil kanıt isteyin
Denetlenebilir sonuç sözleşmesi verin: gerçekten okunan girdiler, zorunlu görevlerin son durumu, çözülmeyen retler ve bağımsız açılabilen dosyalar. İstem gereksinimi aktarır; durumu çağıran sistem ve güvenilir araçlar doğrular. Modele JSON doldurtmak izin veya tamamlanma mekanizması değildir.
RUN_ID: lifecycle-demo-v1
INPUT_FILES: lifecycle-demo/fixture.json, lifecycle-demo/artifacts/report.txt
OUTPUT_DIR: lifecycle-demo/artifacts
Yalnızca verilen sentetik veriyi kontrol et. Ağ, gerçek CLI ve gerçek araçları yeniden deneme yok.
Her case için kuyruk onayı, çalışma, ret, hata, tamamlanma ve doğrulanmış dosyayı ayır.
client_exit_code 0 değerini başarılı sürdürme veya teslim sayma.
Zorunlu adım reddedilirse engeli ve eksik kanıtı koru. Politikayı değiştirme, adımı sessizce isteğe bağlı yapma.
Her case durumunu, kanıt konumunu ve bilinmeyenleri raporla. Doğrulanamayan alanları bilinmeyen bırak.
Yalnızca gerçekten var olan ve bağımsız kontrolden geçen çıktılara teslim edildi de.Run ID, asıl task ID, girdi sürümü ve zorunlu adımlar kontrollü kalıcı kayıtta tutulmalıdır. Yeni çalışma, eski başarılı dosyayı kendi başarı kanıtı olarak kullanmamalıdır. İçerik, zaman ve görev ilişkisi eşleşmelidir.
8. Aynı görevi sürdürmek yeni sohbet açmak değildir
Claude rehberine göre uzak MCP task çıkıştan sonra çalışabilir. İzlemek için sunucu adı ve bağlantısı eşleşen asıl oturuma dönün. Tek seferlik -p resume eski görevi izlemez; yeni oturum veya fork otomatik devralmaz. Stdio sunucusu istemciyle kapanabilir; sunucu görevi etiketi tek başına süreklilik garantisi değildir.
Codex 6 Kasım düzeltmesi sağlayıcı değişiminden sonra kayıtlı sohbetleri görünür tutar; sürdürme mümkün değilse dökümden yeni istem hazırlama yolu sunar. Geçmiş görünürlüğü bilgiyi geri getirir, bütün uzak tanıtıcıları, dosya durumunu ve izinleri değil. Eski işe devam etmeden veya kayıtlı yeni iş açmadan hedef ortamı kontrol edin.
HANDOFF_ID: lifecycle-handoff-v1
Asıl run, session, server/task kimliklerini ve doğrulanmış girdi sürümünü listele.
Geçmişin okunması, mesajın kuyruğa alınması, oturumun sürdürülmesi ve araç sonucunun alınmasını ayrı raporla.
Yeni sohbette eski arka plan görevinin sorgulanabildiğini varsayma. Yalnızca açıkça geri kurulan bağlantı ve izinleri kullan.
Eski işlemin sonucu bilinmiyorsa değişiklik yapabilecek eylemi tekrarlamadan sunucu kayıtlarıyla dosyaları uzlaştır.
Sonraki adımları devam, bekleme ve insan onayı olarak ayır; her biri için eksik kanıtı belirt.
Kimlik bilgisi, oturum belirteci veya arındırılmamış döküm yazma.Kontrollü devir, tamamlanan alt sonuçları, uzlaştırılacak uzak işlemleri ve ilk retleri korur. Yoksa yeni sohbet sadece “devam et” alıp sınırları kaybedebilir. Alternatif gerekirse plan değişikliğini ve yeni kabul koşullarını açık kaydedin.
9. Zaman aşımı, iptal ve bilinmeyen sonucu ayırın
Normal çağrının zaman aşımı, sunucu göreviyle bağlantı kaybıyla aynı gözlem değildir. Güncel Claude rehberi arka plan MCP tasks için varsayılan Claude Code süre sınırı koymaz. Çağıran kendi bekleme bütçesini ve yönlendirme yolunu belirlemelidir. Bütçenin bitmesi beklemeyi durdurur, uzak işi değil.
İptal çoğu zaman taleptir, sonuç kanıtı değildir. Claude, takip durduktan veya iptal istendikten sonra sunucunun yine bitirebileceğini, Esc tuşunun da arka plan görevini durdurmakla aynı olmadığını belirtir. Özellikle dışa aktarma, yazma veya gönderme gibi yinelenebilir işlemleri tekrarlamadan bilinmeyen sonucu uzlaştırın.
| Gözlem | Korunacak durum | Sonraki kanıt |
|---|---|---|
| Bekleme bütçesi bitti | Yerel bekleme zaman aşımı; uzak sonuç bilinmiyor | Asıl görev ve sunucu kayıtları |
| İptal gönderildi | İptal istendi, tamamlandığı bilinmiyor | İptal onayı veya son sonuç |
| Ortam değişiminden sonra görev yok | İlişki geri kurulmadı | Asıl sunucu, bağlantı ve oturum |
| Tur sürerken izin reddi | Zorunlu adım engelli | Meşru alternatif plan veya yeni yetkili kontrol |
| Tamamlanma bildirimi var, dosya yok | UNVERIFIED | Sonuç gövdesi, gerçek dosya ve bağımsız içerik kontrolü |
İdempotency anahtarları, tekrar sayısı ve tekilleştirme gerçek hizmete ve iş anlamına bağlıdır. Bu rehber bütün MCP sunucuları için evrensel güvenli tekrar düğmesi sunmaz; iptal örneklerinde gerçek ödeme, mesaj, hesap veya iş verisi kullanılmaz.
10. Sıkıştırılmış bağlam ve izin kayıtları da kurtarma kanıtıdır
Codex 0.167.0 sıkıştırma düzeltmesi başarısız yanıttan kalan çıktıyı ve token usage eksik yanıtları kapsar. Başarısız tur sıfır bağlam maliyeti demek değildir; eksik usage sıfırla doldurulmaz. Yalnızca son başarı cümlesini değil nedenleri, gözlenen yan etkileri ve bitmemiş adımları koruyun.
İzin ve ağ onayı yürütmeyi kontrol eder. Codex, sandbox sınırını ne zaman onay gerektiğinden ayırır; arka plan bilgisi işlem öncesi iznin yerine geçmez. Uzun hedef daha geniş erişim vermez, mevcut sınırı korur.
Kısıtları devir özetine sıkıştırırken yasakları, retleri ve bilinmeyen sonuçları saklayın. Özet sonraki turun anlamasına yardım eder ama yeni yetki kaynağı değildir. İnsan kararı gerekiyorsa özetteki “devam” bu koşulu sessizce kaldıramaz.
11. Kabulden serbest bırakmaya kontrol akışı
Bu, rehberin normalleştirilmiş kabul akışıdır; sağlayıcının iç durum makinesi değildir. Ret, süren iş veya doğrulanamayan sonuç, sorumlusuyla birlikte korunmalı; yeşil sonuç için günlükler birleştirilmemelidir.
- Run ve zorunlu görevleri kaydet
- Kabul ile sürdürmeyi ayır
- Gerçek araç son durumlarını kontrol et
- Retleri ve bilinmeyenleri koru
- Bağlı dosyaları bağımsız doğrula
- Tüm zorunlu koşullar geçince serbest bırak
12. Çelişkili bayrak ve uyumluluğu tahmin etmeyin
İki güncel OpenAI sayfası çelişiyor: 6 Kasım changelog codex agents --no-daemon yazarken CLI kaynağı birleşimi desteklenmiyor diyor. Bunu çözülmemiş belge farkı olarak kaydediyoruz; kopyalanabilir komut vermedik ve hangi tarafın doğru olduğunu söylemek için CLI çalıştırmadık.
Codex CLI 0.167.0 sürüm notları · Codex CLI komut başvuru kaynağı
Claude tarafında da sürüme bağlı farklar var. 2.1.319 kaydı feature-flag alınmadan MCP tasks kullanımından söz eder; güncel MCP rehberi flag/sağlayıcı koşulları içerir ve ortam tablosu daha eski asgari sürüm listeler. Tek sayfadan bütün arayüzlere uyumluluk sözü çıkarmayın.
Claude Code 2.1.319 sürüm notları · Claude MCP arka plan çağrıları ve sunucu görevleri · Claude Code ortam değişkenleri
permissions.denyInsteadOfPrompting davranışı sürüm kaydında var ama incelenen settings reference içinde özel giriş bulamadık. Yalnızca belirtilen reddet-ve-devam davranışını tartışıyor; tam ayar şeması tahmin etmiyor, kullanıcı ayarını değiştirmiyor, daha geniş izin önermiyoruz.
Claude Code 2.1.319 sürüm notları · Claude Code ayar başvuru kaynağı
Bare otomatik keşfi atlar ama açıkça eklenmiş her MCP task sonucunu bekletmez. Görev türü, arayüz ve güncel belgeye göre bekleme kuralını kontrol edin. Basitleştirilmiş başlatma modu bir tamamlanma kapısı değildir.
Claude MCP arka plan çağrıları ve sunucu görevleri · Claude Code etkileşimsiz ve bare modları
13. Gerçek mühendisliğe sınırları kaybetmeden ekleyin
Akışı gönderici, olay adaptörü, dosya doğrulayıcısı ve son kapı olarak ayırın. Gönderici kabulü, adaptör gerçek görev ilişkisiyle ret/hataları, doğrulayıcı dosyayı, kapı da çağıranın zorunlu koşullarını denetler.
Önce dış mantığı sentetik sınayın: sonuç sırasını değiştirin, bir görevi çalışır bırakın, zorunlu adımı reddedin, sürdürmeden kuyruk onayı verin ve dosya değiştirin. Erken tamamlanma olayı veya istemci çıkışı eksik koşulu aşmamalıdır.
Sonra zaten yetkili yalıtılmış ortamda gerçek protokol ve sürümü yan etkisiz araçlarla aynı kayıt biçiminde kontrol edin. Gerçekte yalnızca Python standart kitaplık fixture testi çalıştırıldı. Claude Code, Codex, MCP sunucusu veya iş işlemi yapılmadı; performans, hesap erişimi ya da üretim doğrulaması çıkarılamaz.
Son rapor hangi run içinde hangi kontrolün geçtiğini, bekleyen görevlerin sahibini ve bilinmeyenin nasıl uzlaştırılacağını göstermelidir. Böylece esnek arka plan yürütme, açık tamamlanma tanımı olan akışa dönüşür.
Araç veya plan seçmeden görev ilişkisi ve kabul kaydını saklayın. Satın alma sayfası güncel teslim ve hakları gösterir; gerçek arayüz, izin, bölge ve sürümü ayrıca doğrulayın.