Apidog CLI Claude Kodunda Nasıl Kullanılır

Claude Code bir döngü içinde çalışır: dosyaları düzenler, terminalde komutlar çalıştırır, çıktıyı okur ve sonraki adımı belirler. API testleriniz bu döngüde değilse, bir GUI arkasında kalır ve yalnızca biri manuel olarak çalıştırdığında devreye girer. apidog-cli ile Apidog senaryolarını terminalden çalıştırabilir, Claude Code'un düzenle-test et-düzelt akışına dahil edebilirsiniz.

Apidog'u bugün deneyin

Çözüm, proje kurallarınıza ekleyeceğiniz kısa bir yapılandırma bloğudur. Apidog içinde oluşturduğunuz test senaryolarını terminalden çalıştıran npm paketi apidog-cli'dir. CLI yüklendikten ve Claude Code'a tanıtıldıktan sonra temsilci, Apidog senaryosunu birim testleriniz gibi çalıştırabilir: komutu tetikler, çıkış kodunu okur ve test başarısızsa kodu düzeltir.

Bu kılavuz Claude Code'a özgü kurulumu kapsar:

• CLAUDE.md dosyasına eklenecek yapılandırma
• apidog run komutunun Claude Code izin modeliyle çalıştırılması
• CLI çıktısının düzenle-test et-düzelt döngüsünde kullanılması

Henüz CLI kurulumunu yapmadıysanız önce yapay zeka kodlama aracısı ile Apidog CLI kurulum kılavuzunu izleyin. Bu makale, apidog --version komutunun sürüm numarası döndürdüğünü ve Apidog hesabında kimlik doğrulamasının tamamlandığını varsayar.

Hangi Claude Code?

Buradaki araç, terminalinizde veya masaüstü uygulamasında çalışan Anthropic Claude Code CLI'dır. Depoyu okuyabilir, dosyaları düzenleyebilir ve izin modunuza göre kabuk komutları çalıştırabilir.

Bu, Claude sohbet uygulaması veya basit bir API çağrısı değildir. Bir depoda aşağıdaki komutu çalıştırdığınızda düzenlemeler ve terminal komutları önerebilen etkileşimli bir araç görüyorsanız doğru yerdesiniz:

claude

Terminal komutlarınız Claude Code slash komutlarında ve proje kural dosyalarında yer alır. Apidog CLI komutunu eklemeniz gereken yer bu kural dosyasıdır: CLAUDE.md.

Claude Code, proje kurallarını oturum başlangıcında okur. Böylece tek seferlik “testleri çalıştır” isteğini, temsilcinin gerektiğinde kendi başına uygulayabileceği kalıcı bir kurala dönüştürebilirsiniz.

Adım 1: Apidog bloğunu CLAUDE.md dosyasına ekleyin

Claude Code her oturumun başında CLAUDE.md dosyalarını okur. Bu dosya, Codex için kullanılan AGENTS.md dosyasının Claude Code karşılığıdır. Anthropic belgelerine göre Claude Code, AGENTS.md yerine CLAUDE.md okur. Başka araçlar için bir AGENTS.md kullanıyorsanız, mevcut dosyayı @AGENTS.md ile içe aktarabilirsiniz.

Apidog CLI'yı Codex'te yapılandırdıysanız, yaklaşım aynıdır; yalnızca dosya adı değişir.

Deponun kök dizinine bir CLAUDE.md dosyası yerleştirin. Claude Code şu konumları da destekler:

• ./CLAUDE.md
• ./.claude/CLAUDE.md
• ~/.claude/CLAUDE.md — kişisel varsayılanlar için

Claude Code, başlatıldığı dizinden yukarı doğru dizin ağacını tarar ve bulduğu CLAUDE.md dosyalarını yükler. Depo kökündeki bir dosya, tüm proje oturumlarına uygulanır.

Dosyaya şu bloğu 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.

Komutu yalnızca sohbet içinde belirtmek yerine CLAUDE.md dosyasına yazın. Sohbette verdiğiniz senaryo kimliği oturum sona erdiğinde kaybolabilir. CLAUDE.md içindeki komut ise ekipteki herkes ve her Claude Code çalıştırması için kalıcı olur.

Adım 2: Komutu Apidog'dan alın

<senaryo_id> ve <ortam_id> değerlerini tahmin etmeyin.

1. Apidog'da test senaryonuzu açın.
2. CI/CD sekmesine gidin.
3. Oluşturulan apidog run ... komutunu kopyalayın.
4. Komuttaki gerçek senaryo kimliğini ve ortam kimliğini CLAUDE.md içindeki bloğa yapıştırın.

Apidog'un oluşturduğu komutta senaryo kimliği, ortam kimliği ve -r cli raporlayıcısı hazır bulunur.

-r cli raporlayıcısı, adım adım sonuçları ve özeti doğrudan terminale yazar. Claude Code bu çıktıyı okuyarak sonraki işlemini belirleyebilir.

Bayrakların ayrıntıları için şu kaynaklara bakın:

• Eksiksiz Apidog CLI kılavuzu
• apidog run komut referansı

Adım 3: Claude Code'un testi çalıştırmasını sağlayın

CLAUDE.md dosyasını ekledikten sonra depoda Claude Code'u başlatın:

claude

Claude Code başlangıçta CLAUDE.md dosyasını yükler. API'nizi etkileyen bir değişiklik yaptığında veya siz kontrolü çalıştırmasını istediğinizde, dosyada tanımladığınız apidog run komutunu kullanabilir.

İzinleri yapılandırın

Varsayılan modda Claude Code, daha önce onaylanmamış bir kabuk komutunu çalıştırmadan önce izin ister. İlk çalıştırmada apidog run komutunu onaylayın.

Komutun tekrar tekrar onay istememesi için bir izin kuralı ekleyin:

• Oturum içinde /permissions komutunu çalıştırın.
• Alternatif olarak .claude/settings.json dosyasına Bash(apidog run *) için izin kuralı ekleyin.

Staging ortamına karşı çalışan salt okunur bir test senaryosu, izin listesine eklemek için uygun bir komuttur.

--dangerously-skip-permissions seçeneği tüm izin uyarılarını atlar. Bunu günlük geliştirme yerine denetimsiz CI çalıştırmaları için kullanın.

Claude Code'un testi gerçekten çalıştırdığını doğrulamak için yalnızca “testler başarılı” özetine güvenmeyin. Terminalde hem apidog run ... komutunu, hem test özetini, hem de çıkış kodunu kontrol edin.

Adım 4: Raporu Claude Code içinde okuyun

Bir test çalıştırması başarısız olduğunda gerekli bilgi CLI raporundadır. -r cli ile terminalde şunları görürsünüz:

• Her istek
• Her onaylama
• Başarısız durum kodları
• Beklenen ve gerçek alan değerleri

Bu çıktı, Claude Code'un hatalı alanı veya davranışı belirlemesine ve düzeltme denemesine yardımcı olur.

Tarayıcıda açabileceğiniz veya ekip arkadaşlarınızla paylaşabileceğiniz bir rapor üretmek için HTML raporlayıcıyı da ekleyin:

apidog run -t <senaryo_id> -e <ortam_id> -r cli,html

html raporlayıcısı bağımsız rapor dosyasını ./apidog-reports konumuna yazar. Claude Code'un terminal çıktısını okumaya devam etmesi için raporlayıcı listesinde cli seçeneğini koruyun.

JUnit ve diğer raporlayıcılar için Apidog CLI test raporları kılavuzuna bakın.

Claude Code'un düzenle-test et-düzelt döngüsü

Asıl değer, Claude Code'un siz her seferinde istemeden testi çalıştırabilmesidir.

Örneğin Claude Code'un ödeme yanıtı oluşturan bir işleyiciyi düzenlediğini düşünün. Akış şu hale gelir:

1. Kod değişikliğini yapar.
2. Apidog senaryosunu staging ortamında çalıştırır.
3. Çıkış kodunu ve CLI raporunu okur.
4. Test başarılıysa sonraki göreve geçer.
5. Test başarısızsa hata veren onaylamayı inceler.
6. Durum kodu, eksik alan veya yanlış değer için düzeltme uygular.
7. Senaryoyu yeniden çalıştırır.

Bu sayede API testleri, birim testlerinizle aynı düzenle-test et-düzelt döngüsünün parçası olur.

Bu yaklaşım, aracı iş akışlarında kullanılan delege et-doğrula modelidir:

• Claude Code komutu çalıştırır ve çıktıyı okur.
• Siz Apidog'da senaryoları görsel olarak yönetirsiniz.
• Çıkış kodu, test sonucunun güvenilir kaynağı olarak kalır.

Daha geniş yaklaşım için şu kaynaklara bakın:

• API testi için yapay zeka ajanları
• Apidog AI test donanımı

Claude Code'un CLI'ı gerçekten çalıştırdığını doğrulayın

Ajanların test çalıştırmadan başarılı olduklarını söylemesi mümkündür. Aşağıdaki üç kontrolü uygulayın.

1. Komutun çalıştırıldığını kontrol edin

Claude Code çalıştırdığı komutları ve çıktılarını satır içinde gösterir. Şunları arayın:

apidog run ...

Komutun altında test çıktısı görünmelidir. Claude “testleri çalıştırdım” diyorsa ancak komut görünmüyorsa, ham çıktıyı göstermesini ve komutu yeniden çalıştırmasını isteyin.

2. Çıkış kodunu kontrol edin

Şu soruyu doğrudan sorun:

Bu apidog run komutunun çıkış kodu neydi?

apidog run davranışı nettir:

• 0: Tüm onaylamalar başarılı.
• Sıfır olmayan değer: En az bir onaylama başarısız.

Özet “testler geçti” dese bile çıkış kodu sıfır değilse, çalıştırma başarısızdır.

3. Gerçek senaryo kimliklerinin kullanıldığını kontrol edin

Çalıştırma senaryo bulunamadı hatası verirse Claude yanlış veya uydurulmuş kimlik kullanmış olabilir.

Şunları karşılaştırın:

• CLAUDE.md içindeki -t değeri
• CLAUDE.md içindeki -e değeri
• Apidog CI/CD sekmesinden kopyaladığınız komut

Kimlikleri tahmin etmek yerine her zaman Apidog tarafından oluşturulan komutu kullanın.

İsteğe bağlı: Apidog MCP sunucusunu bağlayın

CLAUDE.md üzerinden apidog run çalıştırmak çoğu kullanım senaryosu için yeterlidir. Bir sonraki adım olarak, Claude Code'un yalnızca test çalıştırmasını değil, kod yazarken API spesifikasyonunuzu da okuyabilmesini sağlayabilirsiniz.

Claude Code, Model Bağlam Protokolü'nü destekler. Bir MCP sunucusunu claude mcp add ... komutuyla ekleyebilir veya proje kökünde .mcp.json dosyası kullanabilirsiniz. --scope project seçeneği yapılandırmayı ekip genelinde paylaşmanızı sağlar.

Apidog MCP sunucusu, API spesifikasyonlarınızı MCP üzerinden sunar. Böylece Claude Code kod yazarken şemayı okuyabilir.

İş bölümünü şu şekilde düşünün:

• CLI: Testleri çalıştırır.
• MCP: Ajana API spesifikasyonunu sağlar.

Claude Code yanlış yaptığında

Kurulum sırasında aşağıdaki sorunlarla karşılaşabilirsiniz.

CLAUDE.md bloğu yok sayılıyor

Claude genel bir komut çalıştırıyorsa veya hiçbir komut çalıştırmıyorsa, dosya yüklenmemiş olabilir.

Kontrol edin:

1. Dosya adı tam olarak CLAUDE.md mi?
2. Dosya depo kökünde mi veya mevcut dizinin üst dizinlerinden birinde mi?
3. Oturum içinde /memory çalıştırdığınızda dosya listeleniyor mu?

Dosya listelenmiyorsa Claude Code onu göremez. Oturumu yeniden başlatmak dosyaların yeniden okunmasını sağlar.

Claude --access-token eklemeye çalışıyor

Claude genel örneklerden hareketle --access-token eklemeye çalışabilir. CLAUDE.md dosyanızda bu davranışı açıkça yasaklayın:

Makine `apidog login` aracılığıyla zaten kimliği doğrulanmıştır.
Asla `--access-token` bayrağı eklemeyin ve bu dosyaya asla jeton koymayın.

Gerçek bir erişim jetonunu hiçbir zaman CLAUDE.md dosyasına koymayın. Kimlik doğrulama akışı için Apidog CLI kimlik doğrulaması kılavuzuna bakın.

Claude geçersiz bir bayrak kullanıyor

“Bilinmeyen seçenek” hatası, yüklü CLI sürümünde bulunmayan bir bayrağın kullanıldığını gösterir.

Çözüm:

apidog run --help

Claude Code'un bayrakları tahmin etmek yerine bu çıktıyı kullanmasını isteyin.

Başarısız çalıştırma başarılı olarak raporlanıyor

Bu en maliyetli hatadır. Özet ile çıkış kodu çelişiyorsa çıkış kodunu esas alın.

Bu nedenle CLAUDE.md içinde şu kural bulunmalıdır:

Çı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.

Günlük bir ajandan test edilmiş bir döngüye

Kurulum özeti:

1. Kurulum kılavuzunu izleyerek apidog-cli paketini yükleyin.
2. Apidog'dan gerçek apidog run komutunu kopyalayın.
3. Komutu deponuzdaki CLAUDE.md dosyasına ekleyin.
4. Claude Code'un API testini çalıştırmasına izin verin.
5. CLI çıktısını ve çıkış kodunu doğrulayın.

Böylece bozuk bir uç nokta, dağıtımdan sonra değil, Claude Code değişiklik üzerinde çalışırken yakalanabilir.

GUI arkasındaki bir test yalnızca biri tıkladığında çalışır. Terminal komutu ise Claude Code karar verdiğinde çalışabilir. Senaryoları Apidog içinde görsel olarak oluşturmaya devam edin, apidog run komutunu CLAUDE.md dosyasına ekleyin ve API testlerini geliştirme döngünüze dahil edin.

Apidog'u indirin, bir senaryo oluşturun ve Claude Code yapılandırmanıza komutu ekleyin. Aynı komutu Claude Code olmayan bir CI işlem hattında çalıştırmak istediğinizde, GitHub Actions'ta Apidog CLI kılavuzu sırları, raporlayıcıları ve çıkış kodu denetimini kapsar.