Claude Code bir döngüdür: dosyaları düzenler, terminalinizde komutlar çalıştırır, çıktıyı okur ve ne yapacağına karar verir. Peki API testleriniz neden bu döngüde değil? Bir GUI'nin arkasında Apidog'da dururlar ve biri tıklamayı hatırladığında çalışırlar. Temsilciniz onlara asla dokunmaz.
Çözüm tek bir yapılandırma bloğudur. Apidog CLI, Apidog'da oluşturduğunuz test senaryolarını doğrudan bir terminalden çalıştıran bir npm paketi olan apidog-cli'dir. CLI yüklendikten ve Claude Code'un varlığını bildikten sonra, temsilciniz bir Apidog senaryosunu birim testlerinizi çalıştırdığı gibi çalıştırır: komutu tetikler, çıkış kodunu okur, kırmızıysa kodu düzeltir.
Bu kılavuz, genel yükleme kılavuzunun atladığı Claude Code'a özgü kısmı kapsar: CLAUDE.md dosyanız için tam satır, Claude Code'un izin modeli altında apidog run komutunu nasıl çalıştırdığı ve kendi düzenle-test et-düzelt döngüsü içinde sonucu nasıl okuyacağı.
CLI'yı henüz yüklemediyseniz, önce bunu yapın. Yapay zeka kodlama aracısı ile Apidog CLI nasıl kurulur, npm kurulumunu ve ilk çalıştırmayı, aracının yazarak nasıl yapıldığını açıklar. Bu makale, apidog --version komutunun bir sayı yazdırdığını ve Apidog hesabınızın kimlik doğrulamasının yapıldığını varsayar.
Hangi Claude Code'dan bahsediliyor
Bu, terminalinizde (veya masaüstü uygulamasında) çalışan Anthropic'in kodlama aracı olan Claude Code CLI'dır. Deponuzu okur, dosyaları düzenler ve izin modunuza göre onay isteyerek kabuk komutları çalıştırır. Bu, Claude sohbet uygulaması veya düz bir API çağrısı değildir. Bir depoda claude çalıştırıp düzenlemeler ve komut çalıştırmalar öneren etkileşimli bir aracı alırsanız, doğru yerdesiniz. Terminal için yazdığınız komutlar Claude Code slash komutlarınızda ve kural dosyasında bulunur ve Apidog CLI'ın ait olduğu yer bu kural dosyasıdır.
Bu ayrım önemlidir çünkü Claude Code'un proje kurallarını öğrenmek için kendi yöntemi vardır ve bu mekanizma, tek seferlik "testlerimi çalıştır" eylemini Claude'un kendi başına ulaşacağı bir şeye dönüştürür. Bu mekanizma CLAUDE.md'dir.
Adım 1: Apidog bloğunu CLAUDE.md dosyasına ekleyin
Claude Code, her oturumun başlangıcında CLAUDE.md dosyalarını okur. Bu, Codex için AGENTS.md'nin doğrudan karşılığıdır; aslında Anthropic'in belgeleri, Claude Code'un AGENTS.md yerine CLAUDE.md okuduğunu belirtir ve başka bir aracı için bir AGENTS.md tutuyorsanız, mevcut bir AGENTS.md dosyasını @AGENTS.md ile içe aktarmayı önerir. Apidog CLI'yı Codex'te zaten kurduysanız, bu farklı bir dosya adıyla aynı fikirdir.
Deponuzun kök dizinine bir CLAUDE.md yerleştirin (Claude Code ayrıca ./.claude/CLAUDE.md'yi ve kişisel varsayılanlar için genel bir ~/.claude/CLAUDE.md'yi de kabul eder). Claude Code, başlattığınız dizinden yukarı doğru dizin ağacını dolaşır ve bulduğu her CLAUDE.md dosyasını yükler, böylece depo kökündeki bir dosya her oturuma ulaşır. Şuna benzer kısa bir blok ekleyin:
## Apidog CLI ile API testi
Bu projenin Apidog test senaryoları vardır. API'yi kontrol etmek için şunu çalıştırın:
`apidog run -t <senaryo_id> -e <ortam_id> -r cli`
- Çıkış kodu 0, her onaylamanın başarılı olduğu anlamına gelir. Sıfır olmayan bir değer, bir şeylerin başarısız olduğu anlamına gelir; raporu açın ve devam etmeden önce düzeltin.
- Makine `apidog login` aracılığıyla zaten kimliği doğrulanmıştır. Asla `--access-token` bayrağı eklemeyin ve bu dosyaya asla bir jeton koymayın.
- Bir bayrak bilinmiyorsa, `apidog run --help` komutunu çalıştırın ve oradan tam bayrağı kullanın.
CLI'yi sohbette bahsetmek yerine CLAUDE.md'ye yazmanızın nedeni budur. Bir oturuma yazılan bir senaryo kimliği, oturum sona erdiğinde kaybolur. CLAUDE.md'deki bir senaryo, artık her takım arkadaşı ve her Claude Code çalıştırması için oradadır. Dosya başlangıçta tamamen yüklenir ve bir /compact komutuna dayanır, böylece talimat tüm oturum boyunca canlı kalır.
Adım 2: Komutu Apidog'dan alın
Bu bloktaki <scenario_id> ve <env_id> tahmin edeceğiniz değerler değildir. Apidog'da test senaryonuzu açın, CI/CD sekmesine gidin ve oluşturulan apidog run ... komutunu kopyalayın. Gerçek senaryo Kimliği, ortam Kimliği ve -r cli raporlayıcısı zaten doldurulmuş olacaktır. Bu tam kimlikleri CLAUDE.md bloğunuza yapıştırın.
-r cli raporlayıcısı, adım adım bir sonuç ve bir özet doğrudan terminalde yazdırır, bu da Claude Code'un bir sonraki adımına karar vermek için okuduğu çıktıdır. Her bayrağın tam dökümü için eksiksiz Apidog CLI kılavuzuna ve apidog run komut referansına bakın.
Adım 3: Claude Code'un testi çalıştırmasını sağlayın
Blok yerleştirildikten sonra, deponuzda Claude Code'u başlatın:
claude
Claude Code, başladığında CLAUDE.md'yi yükler, böylece CLI'ın orada olduğunu zaten bilir. API'nizi etkileyen bir değişiklik yapın veya sadece kontrolü çalıştırmasını isteyin. Claude Code, CLAUDE.md dosyanızdaki apidog run komutunu verir.
Burada izin modeli önemlidir. Varsayılan modunda, Claude Code, daha önce onaylanmadığını görmediği bir kabuk komutunu çalıştırmadan önce sorar. İstendiğinde apidog run komutunu onaylayın. Güvendiğiniz bir komut için tekrar sorulmamasını sağlamak amacıyla bir izin kuralı ekleyin, böylece CLI bir uyarı olmadan çalışır: oturum içinde /permissions komutunu çalıştırın veya .claude/settings.json dosyasına Bash(apidog run *) için bir izin kuralı ekleyin. Staging'e karşı salt okunur bir test senaryosu, izin verilecek güvenli bir komuttur. Denetimsiz çalıştırmalar için, uyarıları tamamen atlayan --dangerously-skip-permissions mevcuttur; bunu CI için saklayın, günlük kullanımınız için değil.
Yalnızca başarı iddiasında bulunan bir cümle yerine, çalıştırmanın yürütüldüğünü ve Claude Code'un hem özeti hem de çıkış kodunu raporladığını görmek istersiniz.
Adım 4: Raporu Claude Code içinde okuyun
Bir çalıştırma başarısız olduğunda (kırmızı yandığında), cevap rapordadır. -r cli ile Claude Code, terminalde okunabilir bir döküm alır: her istek, her onaylama ve beklenen ile gerçek değere göre hangisinin başarısız olduğu. Başarısız olan onaylama, tam alanı veya durum kodunu belirtir, bu da Claude Code'un düzeltmeyi bulması için genellikle yeterlidir.
Bir tarayıcıda açabileceğiniz veya bir takım arkadaşınıza verebileceğiniz bir rapor için HTML raporlayıcıyı ekleyin:
apidog run -t <scenario_id> -e <env_id> -r cli,html
html raporlayıcısı, ./apidog-reports konumuna bağımsız bir dosya yazar. Listede cli'yi tutun, böylece Claude Code, bir sonraki adımına karar vermek için okuduğu satır içi çıktıyı almaya devam eder. CI panolarının ayrıştırdığı JUnit formatı ve diğer raporlayıcılar için Apidog CLI test raporlarına bakın.
Claude Code'un kendi döngüsü içinde test etmesi
Önemli olan, siz sormayı bıraktığınızda ve Claude Code, CLAUDE.md kendisine söylediği için senaryoyu kendi başına çalıştırdığında ne olduğudur.
Claude Code'un bir ödeme yanıtı oluşturan bir işleyiciyi düzenlediğini hayal edin. Döngüsü değişir: kodu düzenler, ardından zafer ilan etmek yerine Apidog senaryonuzu staging ortamına karşı çalıştırır, çıkış kodunu okur ve buna göre hareket eder. Yeşilse, devam eder. Kırmızıysa, raporu açar, hangi onaylamanın başarısız olduğunu okur (durum kodu, eksik alan, yanlış değer), bir düzeltme dener ve tekrar çalıştırır. API testi, Claude Code'un birim testlerinizi zaten çalıştırdığı aynı düzenle-test et-düzelt döngüsünün bir parçası haline gelir. Tek bir talimat yazdınız ve Claude komutu zaten çalıştığı sisteme dahil etti.
Bu, herhangi bir aracı iş akışını güvenli hale getiren delege et-doğrula modelidir. Claude Code komutu çalıştırır ve sonucu okur; siz ise Apidog'da senaryoları görsel olarak yazmaya devam eder ve aracının çıkış kodlarını dürüstçe okuduğunu kontrol edersiniz. Daha geniş kalıp için API testi için yapay zeka ajanlarını nasıl kullanacağınıza ve Apidog AI test donanımına bakın.
Claude Code'un gerçekten CLI'yı çalıştırdığını doğrulayın
Ajanlar hak etmedikleri başarıları rapor eder ve Claude Code da bir istisna değildir. Sorunları ne sıklıkta yakaladıklarına göre sıralanmış üç kontrol.
İlk olarak, komutun çalışıp çalışmadığını onaylayın. Claude Code, yürüttüğü komutları ve çıktılarını satır içinde gösterir. Tam olarak apidog run ... satırını ve altında bir sonuç olup olmadığını arayın. Eğer Claude testleri çalıştırdığını söylüyor ancak siz komutu görmüyorsanız, hiç yapmadığı bir şeyi özetlemiştir. Tekrar çalıştırmasını isteyin ve ham çıktıyı göstermesini söyleyin.
İkinci olarak, önemli olan çıkış kodunu onaylayın. Doğrudan sorun: "Bu apidog run komutunun çıkış kodu neydi?" apidog run, her onaylama başarılı olduğunda 0 ile ve herhangi bir şey başarısız olduğunda sıfır olmayan bir değerle çıkar. Bu tek davranış, Claude Code'un veya bir işlem hattının çalıştırmayı temiz bir geçiş olarak ele almasını sağlar. Claude'un yazıları "testler geçti" dese de çıkış kodu sıfır değilse, doğru olan çıkış kodudur.
Üçüncü olarak, gerçek senaryoyu kullandığını onaylayın. Bir çalıştırma "senaryo bulunamadı" hatasıyla başarısız olursa, Claude bir kimlik uydurmuş veya yanlış hatırlamış olabilir. -t ve -e değerlerini CLAUDE.md ile ve Apidog'un CI/CD sekmesinde oluşturduğu komutla tekrar kontrol edin. CLAUDE.md'deki kimlikler gerçektir.
İsteğe Bağlı: Apidog MCP sunucusunu bağlayın
CLAUDE.md dosyasından apidog run komutunu çalıştırmak, ihtiyacınız olan çoğu şeyi karşılar. Bir adım daha ileri gitmek için, Claude Code'un kod yazarken API spesifikasyonunuzu okuyabilmesi, sadece sonradan test etmemesi için bir MCP sunucusu bağlayın.
Claude Code, Model Bağlam Protokolünü destekler. Bir sunucuyu claude mcp add ... ile veya proje kökünüze bir .mcp.json dosyası işleyerek ve --scope project seçeneğini belirterek eklersiniz, böylece tüm ekip buna sahip olur. Apidog MCP sunucusu, API spesifikasyonlarınızı MCP üzerinden yayınlar, böylece Claude kod yazarken şemanızı okur. Bunu bir iş bölümü olarak düşünün: CLI testleri çalıştırır, MCP ajana spesifikasyonu besler.
Claude Code yanlış yaptığında
Kurulum sırasında birkaç hata sıkça ortaya çıkar.
CLAUDE.md bloğunu yok sayar. Eğer Claude genel bir komut çalıştırıyorsa veya hiç çalıştırmıyorsa, blok yüklenmiyor olabilir. Dosyanın adının tam olarak CLAUDE.md olduğunu ve depo kökünüzde veya geçerli dizininizin bir üst dizininde bulunduğunu onaylayın. Claude'un gerçekten yüklediği dosyaları listelemek için oturum içinde /memory komutunu çalıştırın; eğer sizinki orada değilse, Claude onu göremez. Oturumu yeniden başlatmak yeni bir okuma yapılmasını sağlar.
Yine de bir erişim jetonu geçirir. Eğer Claude --access-token eklemeye çalışıyorsa, bunu genel örneklerden tahmin ediyordur. Blok zaten bunu yapmamasını söylüyor, çünkü makine apidog login aracılığıyla kimlik doğrulaması yapılmıştır. Satırı pekiştirin ve asla gerçek bir jetonu CLAUDE.md dosyasına koymayın. Makinenin bir kez nasıl kimlik doğrulaması yaptığını öğrenmek için Apidog CLI kimlik doğrulamasına bakın.
Bir bayrak uydurur. Bir "bilinmeyen seçenek" hatası, Claude'un sürümünüzde olmayan bir bayrağı tahmin ettiği anlamına gelir. Ona apidog run --help komutunu çalıştırmasını söyleyin ve oradan tam bayrağı kopyalayın, bu her zaman yüklü sürümünüz için doğrudur.
Başarısız bir çalıştırmayı başarılı olarak rapor eder. En maliyetli olanı ve çıkış kodu kuralının CLAUDE.md dosyanızda ve doğrulama adımınızda olmasının nedeni budur. Özet ve çıkış kodu uyuşmadığında, çıkış kodu geçerlidir.
Günlük bir ajandan test edilmiş bir döngüye
Kurulum bu şekildedir. Yükleme kılavuzunu takip ederek apidog-cli'yi bir kez yükleyin, deponuzun CLAUDE.md dosyasına kısa bir Apidog bloğu ekleyin ve Claude Code, API testlerinizi nasıl çalıştıracağını ve kodu düzenlemek için zaten kullandığı döngü içinde sonucu nasıl okuyacağını bilecektir. Bozuk bir uç nokta, Claude değişiklik üzerinde çalışırken yakalanır, dağıtımdan sonra değil.
Bir GUI'nin arkasındaki bir test, bir insan tıkladığında çalışır; tek satırlık bir komut ise Claude karar verdiğinde her zaman çalışır. Siz Apidog'da senaryoları görsel olarak oluşturmaya devam edin ve aracınız bunları siz izlemiyorken çalıştırır. Apidog'u indirin, bir senaryo oluşturun, apidog run komutunu CLAUDE.md dosyasına bırakın ve Claude'un bir sonraki değişiklikte onu nasıl ele aldığını izleyin. Claude'un mevcut olmadığı bir işlem hattında aynı komutu çalıştırmaya hazır olduğunuzda, GitHub Actions'ta Apidog CLI sırları, raporlayıcıları ve çıkış kodu denetimini kapsar.