Claude Code adalah sebuah siklus: ia mengedit berkas, menjalankan perintah di terminal Anda, membaca keluarannya, dan memutuskan apa yang harus dilakukan selanjutnya. Jadi, mengapa pengujian API Anda tidak termasuk dalam siklus itu? Mereka berada di Apidog di balik GUI dan berjalan ketika seseorang ingat untuk mengklik. Agen Anda tidak pernah menyentuhnya.
Perbaikannya adalah satu blok konfigurasi. Apidog CLI adalah sebuah paket npm, apidog-cli, yang menjalankan skenario pengujian yang Anda buat di Apidog langsung dari terminal. Setelah CLI terinstal dan Claude Code tahu keberadaannya, agen Anda menjalankan skenario Apidog dengan cara yang sama seperti ia menjalankan uji unit Anda: jalankan perintah, baca kode keluar, perbaiki kode jika merah.
Panduan ini mencakup bagian spesifik Claude Code yang dilewati panduan instalasi umum: baris persis untuk CLAUDE.md Anda, bagaimana Claude Code menjalankan apidog run di bawah model izinnya, dan bagaimana membaca hasilnya di dalam siklus edit-uji-perbaikinya sendiri.
Jika Anda belum menginstal CLI, lakukan itu terlebih dahulu. Cara menginstal Apidog CLI dengan agen pengodean AI menjelaskan instalasi npm dan eksekusi pertama, dengan agen yang melakukan pengetikan. Artikel ini mengasumsikan apidog --version mencetak angka dan akun Apidog Anda sudah terautentikasi.
Claude Code yang mana ini tentangnya
Ini adalah Claude Code CLI, agen pengodean Anthropic yang berjalan di terminal Anda (atau aplikasi desktop). Ia membaca repositori Anda, mengedit berkas, dan menjalankan perintah shell, meminta persetujuan berdasarkan mode izin Anda. Ini bukan aplikasi obrolan Claude dan bukan panggilan API biasa. Jika Anda menjalankan claude di repositori dan mendapatkan agen interaktif yang mengusulkan editan dan eksekusi perintah, Anda berada di tempat yang tepat. Perintah yang Anda tulis untuk terminal berada di perintah garis miring Claude Code dan berkas aturannya, dan berkas aturan itulah tempat Apidog CLI berada.
Perbedaan ini penting karena Claude Code memiliki caranya sendiri untuk mempelajari aturan proyek, dan mekanisme itu mengubah "jalankan pengujian saya" yang sekali pakai menjadi sesuatu yang Claude capai sendiri. Mekanisme itu adalah CLAUDE.md.
Langkah 1: Tambahkan blok Apidog ke CLAUDE.md
Claude Code membaca berkas CLAUDE.md di awal setiap sesi. Ini adalah padanan langsung untuk AGENTS.md bagi Codex; bahkan dokumen Anthropic mencatat bahwa Claude Code membaca CLAUDE.md, bukan AGENTS.md, dan menyarankan untuk mengimpor AGENTS.md yang sudah ada dengan @AGENTS.md jika Anda menyimpannya untuk agen lain. Jika Anda sudah mengatur Apidog CLI di Codex, ini adalah ide yang sama dengan nama berkas yang berbeda.
Tempatkan CLAUDE.md di akar repositori Anda (Claude Code juga menerima ./.claude/CLAUDE.md, dan ~/.claude/CLAUDE.md global untuk standar pribadi). Claude Code akan berjalan naik pohon direktori dari tempat Anda meluncurkannya dan memuat setiap CLAUDE.md yang ditemukannya, jadi satu berkas di akar repositori akan menjangkau setiap sesi. Tambahkan blok singkat seperti ini:
## Pengujian API dengan Apidog CLI
Proyek ini memiliki skenario pengujian Apidog. Untuk memeriksa API, jalankan:
`apidog run -t <scenario_id> -e <env_id> -r cli`
- Kode keluar 0 berarti setiap asersi berhasil. Non-nol berarti ada yang gagal; buka laporan dan perbaiki sebelum melanjutkan.
- Mesin sudah terautentikasi melalui `apidog login`. Jangan pernah menambahkan flag `--access-token` dan jangan pernah meletakkan token di berkas ini.
- Jika sebuah flag tidak dikenal, jalankan `apidog run --help` dan gunakan flag persis dari sana.
Inilah mengapa Anda menulis CLI ke dalam CLAUDE.md daripada menyebutkannya di obrolan. ID skenario yang diketik dalam sebuah sesi akan hilang ketika sesi itu berakhir. ID yang ada di CLAUDE.md akan ada untuk setiap rekan tim dan setiap eksekusi Claude Code mulai sekarang. Berkas dimuat sepenuhnya saat peluncuran dan bertahan dari /compact, sehingga instruksi tetap aktif selama seluruh sesi.
Langkah 2: Dapatkan perintah dari Apidog
<scenario_id> dan <env_id> dalam blok itu bukanlah nilai yang Anda tebak. Buka skenario pengujian Anda di Apidog, buka tab CI/CD, dan salin perintah apidog run ... yang dihasilkan. Itu sudah memiliki ID skenario yang sebenarnya, ID lingkungan, dan pelapor -r cli yang terisi. Tempel ID persis tersebut ke blok CLAUDE.md Anda.
Pelapor -r cli mencetak hasil langkah demi langkah dan ringkasan langsung di terminal, yang merupakan output persis yang dibaca Claude Code untuk memutuskan langkah selanjutnya. Untuk rincian lengkap setiap flag, lihat panduan lengkap Apidog CLI dan referensi perintah apidog run.
Langkah 3: Minta Claude Code menjalankan pengujian
Dengan blok sudah terpasang, mulai Claude Code di repositori Anda:
claude
Claude Code memuat CLAUDE.md saat ia memulai, jadi ia sudah tahu CLI ada di sana. Lakukan perubahan yang menyentuh API Anda, atau cukup minta ia untuk menjalankan pemeriksaan. Claude Code mengeluarkan perintah apidog run dari CLAUDE.md Anda.
Di sini model izin menjadi penting. Dalam mode default-nya, Claude Code bertanya sebelum menjalankan perintah shell yang belum pernah ia lihat disetujui. Setujui perintah apidog run saat diminta. Untuk berhenti ditanya untuk perintah yang Anda percayai, tambahkan aturan izin sehingga CLI berjalan tanpa prompt: jalankan /permissions di dalam sesi, atau tambahkan aturan izin untuk Bash(apidog run *) di .claude/settings.json. Skenario pengujian hanya-baca terhadap staging adalah perintah yang aman untuk masuk daftar putih. Untuk eksekusi tanpa pengawasan ada --dangerously-skip-permissions, yang melewati semua prompt sepenuhnya; simpan itu untuk CI, bukan untuk penggunaan sehari-hari Anda.
Anda ingin melihat eksekusi berjalan dan Claude Code melaporkan kembali baik ringkasan maupun kode keluar, bukan hanya kalimat yang mengklaim keberhasilan.
Langkah 4: Baca laporan di dalam Claude Code
Ketika sebuah eksekusi menjadi merah (gagal), laporan memiliki jawabannya. Dengan -r cli, Claude Code mendapatkan rincian yang dapat dibaca di terminal: setiap permintaan, setiap asersi, dan mana yang gagal dengan nilai yang diharapkan versus nilai aktual. Asersi yang gagal menyebutkan bidang atau kode status yang tepat, yang biasanya cukup bagi Claude Code untuk menemukan perbaikan.
Untuk laporan yang dapat Anda buka di browser atau berikan kepada rekan tim, tambahkan pelapor HTML:
apidog run -t <scenario_id> -e <env_id> -r cli,html
Pelapor html menulis berkas mandiri ke ./apidog-reports. Pertahankan cli dalam daftar sehingga Claude Code masih mendapatkan output sebaris yang dibacanya untuk memutuskan langkah selanjutnya. Untuk format JUnit yang diurai oleh dashboard CI dan pelapor lainnya, lihat laporan pengujian Apidog CLI.
Pengujian Claude Code di dalam siklusnya sendiri
Intinya adalah apa yang terjadi ketika Anda berhenti bertanya dan Claude Code menjalankan skenario itu sendiri karena CLAUDE.md memberitahunya untuk melakukannya.
Bayangkan Claude Code mengedit penangan yang membangun respons checkout. Siklusnya berubah: ia mengedit kode, kemudian, alih-alih menyatakan kemenangan, menjalankan skenario Apidog Anda terhadap staging, membaca kode keluar, dan bertindak berdasarkan itu. Hijau, ia melanjutkan. Merah, ia membuka laporan, membaca asersi mana yang gagal (kode status, bidang yang hilang, nilai yang salah), mencoba perbaikan, dan menjalankannya kembali. Pengujian API menjadi bagian dari siklus edit-uji-perbaiki yang sama dengan yang sudah dijalankan Claude Code untuk uji unit Anda. Anda menulis satu instruksi dan Claude memasukkan perintah itu ke dalam cara kerjanya.
Ini adalah model delegasikan-lalu-verifikasi yang membuat alur kerja agen aman. Claude Code menjalankan perintah dan membaca hasilnya; Anda tetap membuat skenario secara visual di Apidog dan memeriksa sesekali apakah agen membaca kode keluar dengan jujur. Untuk pola yang lebih luas, lihat cara menggunakan agen AI untuk pengujian API dan alat uji AI Apidog.
Verifikasi Claude Code benar-benar menjalankan CLI
Agen melaporkan keberhasilan yang tidak mereka peroleh, dan Claude Code tidak terkecuali. Tiga pemeriksaan, sesuai urutan seberapa sering mereka menangkap masalah.
Pertama, konfirmasikan apakah perintah berjalan sama sekali. Claude Code menunjukkan perintah yang dieksekusi dan keluarannya secara sebaris. Cari baris apidog run ... literal dan hasilnya di bawahnya. Jika Claude mengatakan ia menjalankan pengujian tetapi Anda tidak melihat perintahnya, itu berarti ia merangkum sesuatu yang tidak pernah dilakukannya. Minta ia untuk menjalankan lagi dan menunjukkan output mentahnya.
Kedua, konfirmasikan kode keluar, yang terpenting. Tanyakan langsung: "Berapa kode keluar dari perintah apidog run itu?" apidog run keluar 0 ketika setiap asersi berhasil dan non-nol ketika ada yang gagal. Perilaku tunggal itu memungkinkan Claude Code, atau pipeline, memperlakukan eksekusi sebagai gerbang yang bersih. Ketika prosa Claude mengatakan "pengujian berhasil" tetapi kode keluar adalah non-nol, kode keluar itulah yang benar.
Ketiga, konfirmasikan ia menggunakan skenario yang sebenarnya. Jika eksekusi gagal dengan "skenario tidak ditemukan," Claude mungkin telah menciptakan atau salah mengingat ID. Periksa kembali nilai -t dan -e terhadap CLAUDE.md dan perintah yang dihasilkan Apidog di tab CI/CD. ID di CLAUDE.md adalah kebenaran.
Opsional: sambungkan server Apidog MCP
Menjalankan apidog run dari CLAUDE.md mencakup sebagian besar yang Anda butuhkan. Untuk melangkah lebih jauh, sambungkan server MCP agar Claude Code dapat membaca spesifikasi API Anda saat ia menulis kode, bukan hanya menguji setelah fakta.
Claude Code mendukung Protokol Konteks Model. Anda menambahkan server dengan claude mcp add ... atau dengan melakukan commit berkas .mcp.json di akar proyek Anda dan memilih --scope project sehingga seluruh tim mendapatkannya. Server Apidog MCP mengekspos spesifikasi API Anda melalui MCP, sehingga Claude membaca skema Anda saat ia mengode. Anggap saja sebagai pembagian kerja: CLI menjalankan pengujian, MCP memberi agen spesifikasi.
Ketika Claude Code salah
Beberapa kegagalan sering muncul selama penyiapan.
Ia mengabaikan blok CLAUDE.md. Jika Claude menjalankan perintah umum atau tidak sama sekali, blok tersebut mungkin tidak memuat. Konfirmasikan bahwa berkas diberi nama persis CLAUDE.md dan berada di akar repositori Anda atau di direktori induk dari direktori Anda saat ini. Jalankan /memory di dalam sesi untuk membuat daftar berkas yang benar-benar dimuat Claude; jika berkas Anda tidak ada di sana, Claude tidak dapat melihatnya. Memulai ulang sesi akan memaksa pembacaan ulang.
Ia tetap meneruskan token akses. Jika Claude mencoba menambahkan --access-token, ia menebak dari contoh publik. Blok tersebut sudah memberitahunya untuk tidak melakukannya, karena mesin sudah terautentikasi melalui apidog login. Perkuat baris tersebut, dan jangan pernah meletakkan token asli di CLAUDE.md. Untuk bagaimana mesin mengautentikasi sekali, lihat autentikasi Apidog CLI.
Ia menciptakan sebuah flag. Kesalahan "opsi tidak dikenal" berarti Claude menebak flag yang tidak dimiliki versi Anda. Beri tahu ia untuk menjalankan apidog run --help dan salin flag persis dari sana, yang selalu benar untuk versi terinstal Anda.
Ia melaporkan berhasil pada eksekusi yang gagal. Yang paling mahal, dan alasan aturan kode keluar ada di CLAUDE.md Anda dan langkah verifikasi Anda. Ketika ringkasan dan kode keluar tidak sesuai, kode keluar itulah yang benar.
Dari agen harian ke siklus yang teruji
Itulah penyiapan. Instal apidog-cli sekali mengikuti panduan instalasi, tambahkan blok Apidog singkat ke CLAUDE.md repositori Anda, dan Claude Code tahu cara menjalankan pengujian API Anda dan membaca hasilnya di dalam siklus yang sama dengan yang sudah digunakannya untuk mengedit kode. Titik akhir yang rusak akan tertangkap saat Claude masih mengerjakan perubahan, bukan setelah dikirim.
Pengujian di balik GUI berjalan ketika manusia mengklik; perintah satu baris berjalan kapan pun Claude memutuskan. Anda terus membangun skenario secara visual di Apidog, dan agen Anda menjalankannya di tempat yang tidak Anda awasi. Unduh Apidog, buat satu skenario, masukkan perintah apidog run-nya ke dalam CLAUDE.md, dan saksikan Claude mengambilnya pada perubahan berikutnya. Ketika Anda siap menjalankan perintah yang sama dalam pipeline tanpa Claude hadir, Apidog CLI di GitHub Actions mencakup rahasia, pelapor, dan pemblokiran kode keluar.