Cara Menginstal Apidog CLI dengan Agen Coding AI

Anda sudah memiliki agen pengodean AI terbuka. Agen ini mengedit file Anda, menjalankan pengujian Anda, dan membaca output terminal Anda. Jadi, mengapa Anda akan menginstal alat baris perintah secara manual, menyalin perintah npm dari tab dan menempelkannya satu per satu?

Anda tidak perlu melakukannya. Apidog CLI adalah paket npm bernama apidog-cli yang menjalankan skenario pengujian API yang Anda bangun di Apidog, langsung dari terminal. Menginstalnya adalah urutan singkat perintah shell, langkah autentikasi, dan jalankan pertama. Itu adalah jenis pekerjaan mekanis yang dilakukan dengan baik oleh agen seperti Claude Code, Cursor, Windsurf, atau GitHub Copilot dalam mode agen. Anda menjelaskan tujuannya, agen menjalankan perintah yang sebenarnya, dan Anda memeriksa pekerjaannya.

Panduan ini menunjukkan alur kerja tersebut dari awal hingga akhir. Anda akan melihat prompt yang tepat untuk diberikan kepada agen Anda, perintah yang akan dijalankannya, dan cara memverifikasi setiap langkah alih-alih hanya mempercayai kata agen. Hasil akhirnya adalah bagian yang sepadan dengan penyiapan: setelah CLI terinstal dan terautentikasi, agen Anda dapat menjalankan pengujian Apidog-nya sendiri, di dalam loop-nya sendiri atau di CI, dan membaca hasil lulus atau gagal. Untuk mengikuti panduan ini, Anda memerlukan akun Apidog dengan setidaknya satu proyek. Unduh Apidog terlebih dahulu jika Anda belum memilikinya.

Mengapa membiarkan agen melakukan instalasi

Tidak ada yang berubah dari perintah instalasi ketika agen menjalankannya. Ini adalah perintah npm install -g apidog-cli@latest yang sama dengan yang akan Anda ketik sendiri. Yang berubah adalah siapa yang mengetiknya dan siapa yang membaca outputnya.

Agen bagus dalam hal ini karena tiga alasan konkret. Agen dapat menjalankan perintah, membaca status keluar dan teks yang dicetak, dan memutuskan langkah selanjutnya dari apa yang benar-benar dilihatnya, sehingga "perintah tidak ditemukan" tidak akan macet seperti yang terjadi dalam lingkaran salin-tempel. Agen sudah memiliki shell Anda, versi Node Anda, dan PATH Anda di depannya, sehingga menyesuaikan perbaikan dengan mesin Anda alih-alih perbaikan umum. Dan agen melakukan bagian-bagian yang membosankan, memeriksa Node terlebih dahulu, memverifikasi versi setelah instalasi, mengonfirmasi autentikasi, tanpa Anda harus mengawasi setiap baris.

Apa yang Anda butuhkan sebelum memulai

CLI dikirimkan sebagai paket npm, jadi satu-satunya dependensi sistem adalah runtime Node.js. Tiga hal harus benar:

1. Node.js dan npm terinstal. Paket ini diinstal melalui npm dan berjalan di Node. Rilis LTS saat ini adalah pilihan aman di setiap mesin pengembang.
2. Akun Apidog dengan akses proyek. CLI tidak menyimpan pengujiannya sendiri. CLI menjangkau proyek Apidog Anda dan menjalankan skenario yang ada di sana, jadi Anda memerlukan akun yang dapat melihat setidaknya satu proyek.
3. Skenario pengujian untuk dijalankan. Runner menjalankan skenario, bukan permintaan lepas. Buat satu di aplikasi Apidog terlebih dahulu: rangkai beberapa permintaan, tambahkan asersi, dan simpan. Jika Anda baru menulis pemeriksaan terhadap respons, Asersi API: panduan praktis membahasnya.

Anda juga memerlukan agen pengodean AI dengan izin untuk menjalankan perintah shell. Claude Code, agen Cursor, Cascade Windsurf, dan mode agen GitHub Copilot semuanya memenuhi syarat. Satu hal yang perlu dikonfirmasi sebelum Anda memulai adalah bahwa agen Anda diizinkan untuk menjalankan perintah di terminal Anda, tidak hanya menyarankannya. Jika agen hanya dapat mencetak perintah untuk Anda tempel, Anda masih dapat mengikuti panduan ini, Anda hanya perlu menjadi orang yang menekan Enter.

Langkah 1: Minta agen memeriksa lingkungan

Mulai dengan membiarkan agen mengonfirmasi Node hadir, sehingga agen tahu apakah bisa diinstal sama sekali. Prompt seperti ini berfungsi:

Periksa apakah Node.js dan npm terinstal di mesin ini. Jalankan node -v dan npm -v dan beritahu saya versinya. Jika salah satunya hilang, beritahu saya, jangan coba instal Node sendiri.

Agen akan menjalankan:

node -v
npm -v

Agen harus melaporkan dua nomor versi kepada Anda. Pemeriksaan Anda: baca versi yang dicetak. Jika agen mengklaim Node terinstal tetapi tidak menunjukkan string versi kepada Anda, mintalah agen untuk menempelkan output perintah mentah. Alasan baris "jangan instal Node sendiri" dalam prompt adalah karena menginstal runtime adalah keputusan yang lebih besar dan spesifik mesin yang ingin Anda buat secara sengaja, bukan sesuatu yang harus diserahkan secara buta. Jika Node hilang, instal dari nodejs.org sendiri, lalu lanjutkan.

Langkah 2: Minta agen menginstal CLI

Setelah Node dikonfirmasi, serahkan instalasi:

Baca https://apidog.com/apidog-cli-installation-guide.md dan ikuti instruksinya.

Agen akan menjalankan perintah instalasi.

Flag -g menempatkan biner apidog di PATH global Anda alih-alih di node_modules satu proyek. Tag @latest menarik versi terbaru yang diterbitkan, yang Anda inginkan untuk instalasi pertama. Ketika npm selesai, biner diberi nama apidog, jadi setiap perintah dari sini dimulai dengan apidog.

Kemudian agen akan memverifikasi:

apidog --version
apidog --help

Pemeriksaan Anda: ini adalah verifikasi terpenting dalam seluruh proses, karena ini adalah tempat termudah bagi agen untuk mengklaim keberhasilan yang tidak didapatkannya. Pastikan apidog --version mencetak nomor versi yang sebenarnya, bukan "perintah tidak ditemukan" yang dilewati agen. Output --help harus mencantumkan apidog run dan opsinya. Jika Anda menginginkan satu baris yang dapat Anda jalankan sendiri untuk mengonfirmasi biner dan runtime di belakangnya keduanya berhasil dipecahkan, mintalah agen untuk menjalankan ini dan menempelkan hasilnya:

node -v && apidog --version && which node && which apidog

Jika setiap baris mengembalikan versi atau jalur, instalasi bersih. Jika agen melaporkan masalah, penyebab paling umum adalah direktori bin global tidak ada di PATH Anda; bagian pemecahan masalah di dekat akhir membahasnya.

Jika Anda lebih suka agen tidak mengubah paket global Anda, suruh agen untuk menggunakan npx sebagai gantinya. npx apidog-cli --version mengambil paket, menjalankannya, dan tidak meninggalkan apa pun di PATH Anda, yang cocok untuk mesin bersama atau runner CI ephemeral. Untuk mesin yang Anda gunakan setiap hari, instalasi global lebih sederhana dan lebih cepat pada panggilan berulang.

Langkah 3: Minta agen melakukan autentikasi, tetapi Anda yang menangani token

CLI menjalankan skenario dari akun Anda, jadi CLI harus membuktikan bahwa ia diizinkan untuk melakukannya. Itu dilakukan dengan token akses. Ini adalah satu-satunya langkah yang tidak sepenuhnya Anda delegasikan, karena token adalah rahasia dan Anda tidak ingin token ditempelkan ke transkrip obrolan, file log, atau di mana pun agen mungkin mengulanginya.

Buat token itu sendiri terlebih dahulu. Buka aplikasi atau konsol web Apidog, klik avatar pengguna Anda, buka Account Settings, lalu API Access Token, dan buat yang baru. Salin ke tempat yang aman dan perlakukan seperti kata sandi, karena siapa pun yang memegangnya dapat menjalankan skenario sebagai Anda.

Kemudian berikan prompt kepada agen tanpa pernah menempatkan token di prompt:

Saya akan mengautentikasi Apidog CLI sendiri sehingga token tidak masuk ke obrolan ini. Beri tahu saya perintah apidog login yang tepat untuk dijalankan, lalu setelah saya mengonfirmasi bahwa saya telah menjalankannya, jalankan apidog whoami untuk memverifikasi CLI sudah terautentikasi dan tunjukkan hasilnya.

Anda menjalankan perintah login di terminal Anda sendiri:

apidog login --with-token YOUR_ACCESS_TOKEN

Biarkan agen menjalankan verifikasi:

apidog whoami

Pemeriksaan Anda: apidog whoami harus mencetak akun Anda. Jika berhasil, autentikasi telah diatur. Alasan untuk menjaga token di tangan Anda adalah kebersihan operasional yang sederhana: token yang masuk ke jendela konteks agen dapat berakhir di log atau transkrip yang disimpan. Perintah login menyimpannya secara lokal di mesin Anda, sehingga agen tidak perlu melihat string mentah untuk menjalankan pengujian setelahnya. Untuk CI, aturannya sama tetapi lebih ketat, yang dibahas di bagian terakhir.

Langkah 4: Minta agen melakukan uji coba pertama

Sekarang beralih dari "terinstal" ke "benar-benar berjalan". Perintah intinya adalah apidog run, yang mengarah ke skenario berdasarkan ID-nya.

Cara terbersih untuk mendapatkan perintah yang benar adalah dengan membiarkan Apidog membuatnya untuk Anda. Buka skenario pengujian di Apidog, beralih ke tab CI/CD, pilih opsi baris perintah, dan Apidog menghasilkan perintah apidog run lengkap dengan ID skenario, ID lingkungan, dan token akses yang sudah terisi. Salin itu, dan Anda memiliki titik awal yang terjamin valid. Ini terlihat seperti ini:

apidog run --access-token YOUR_ACCESS_TOKEN -t 605067 -e 1629989 -n 1 -r cli

Berikut adalah fungsi setiap bagian. --access-token mengautentikasi jalankan. -t menamai skenario pengujian berdasarkan ID (605067 adalah placeholder; milik Anda akan berbeda). -e memilih lingkungan yang akan dijalankan, seperti dev atau staging. -n 1 menjalankan skenario sekali. -r cli menulis laporan yang dapat dibaca ke terminal Anda.

Karena Anda sudah masuk, Anda dapat memberikan ID kepada agen tanpa token dan membiarkannya berjalan:

Jalankan skenario pengujian Apidog saya dengan CLI. Saya sudah terautentikasi, jadi jangan berikan token akses. Gunakan: apidog run -t 605067 -e 1629989 -n 1 -r cli. Tunjukkan output lengkapnya dan beritahu saya kode keluarnya.

Agen akan menjalankan skenario dan melaporkan kembali eksekusi langkah demi langkah dan ringkasannya. Pemeriksaan Anda: minta kode keluar secara eksplisit, karena itulah sinyal yang menjadi sandaran semua hal selanjutnya. apidog run keluar 0 ketika setiap asersi lolos dan kode bukan nol ketika ada yang gagal. Perilaku tunggal itu yang memungkinkan sebuah pipeline, atau agen, memperlakukan jalankan sebagai gerbang lulus atau gagal yang bersih tanpa kabel tambahan. Jika agen mengatakan "pengujian lulus" tetapi kode keluarnya bukan nol, itu salah, percayai kodenya, bukan tulisannya.

Ingin format laporan yang berbeda atau iterasi lebih banyak? Mintalah agen menjalankan apidog run --help, yang mencetak setiap flag yang didukung runner, termasuk pelapor lain dan opsi iterasi berbasis data. Untuk referensi flag lengkap dan contoh CI, panduan Apidog CLI lengkap mencakup masing-masing.

Manfaatnya: kini agen dapat menguji sendiri

Inilah mengapa penyiapan ini sepadan. Dengan CLI terinstal dan terautentikasi, menjalankan pengujian Apidog kini adalah satu perintah shell yang dapat dikeluarkan agen Anda kapan saja, dan membaca hasilnya. Itu melipat pengujian API ke dalam loop normal agen.

Bayangkan agen mengubah penangan yang menyentuh titik akhir. Alih-alih mengedit kode dan menyatakan kemenangan, agen dapat menjalankan skenario Apidog Anda terhadap lingkungan yang terpengaruh, membaca kode keluar, dan bertindak berdasarkan itu: hijau, agen melanjutkan; merah, agen membaca asersi yang gagal dalam laporan dan mencoba perbaikan. Pengujian menjadi bagian dari lingkaran umpan balik agen, sama seperti agen sudah menjalankan pengujian unit Anda. Untuk pandangan yang lebih luas tentang pola ini, cara menggunakan agen AI untuk pengujian API membahas di mana ia cocok dan di mana tidak.

Ini langsung berlanjut ke CI, di mana agen bahkan tidak hadir. Setelah Anda melihat perintah itu bekerja secara lokal, Anda dapat meminta agen menulis langkah pipeline yang menjalankannya di setiap dorongan. Mekanik itu, rahasia, pelapor, gerbang kode keluar, hidup di Apidog CLI di GitHub Actions.

Jika Anda ingin integrasi agen berjalan lebih dalam daripada menjalankan perintah shell, dua fitur Apidog menghubungkan agen ke spesifikasi dan skenario API Anda secara lebih langsung. Server Apidog MCP mengekspos spesifikasi API Anda ke alat pengodean AI melalui Model Context Protocol, sehingga agen dapat membaca skema Anda saat mengode. Dan Apidog CLI dengan Claude Skills mengemas alur kerja CLI ke dalam keterampilan yang dapat digunakan kembali, sehingga langkah menjalankan pengujian menjadi sesuatu yang dicapai Claude sendiri. Keduanya dibangun di atas apidog-cli yang sama yang baru saja Anda siapkan.

Dari instalasi yang didelegasikan ke loop yang diuji

Itulah seluruh jalurnya. Anda mengonfirmasi Node, agen menginstal apidog-cli dengan satu perintah npm, Anda memverifikasi dengan apidog --version, Anda mengautentikasi dengan token yang Anda pegang sendiri, dan agen menjalankan apidog run pertama saat Anda memeriksa kode keluarnya. Beberapa menit delegasikan-lalu-verifikasi, dan agen Anda sekarang dapat menjalankan pengujian API-nya sendiri.

Alasan mengapa ini penting sama dengan alasan mengapa gerbang pengujian apa pun penting, dengan satu tambahan. Pengujian yang terperangkap di balik GUI hanya berjalan ketika manusia mengklik. Perintah satu baris berjalan di setiap dorongan. Dan begitu perintah itu dalam jangkauan agen pengodean Anda, ia berjalan di dalam loop edit-uji-perbaiki agen itu sendiri, pada perubahan yang bahkan belum Anda tinjau. Anda terus membuat skenario secara visual di Apidog, dan baik pipeline maupun agen Anda menjalankannya di mana tidak ada manusia yang melihat.

Dari sini, arahkan perintah yang sama ke CI di Apidog CLI di GitHub Actions, atau baca referensi flag lengkap di panduan Apidog CLI lengkap.