귀하의 API 워크스페이스는 GUI에 있습니다. 귀하의 업무는 터미널에서 이루어집니다. 이 둘 사이의 각 컨텍스트 전환은 시간과 집중력을 소모하며, CI 파이프라인이나 AI 에이전트 세션에서는 GUI는 선택 사항조차 아닙니다. Apidog CLI는 이 간극을 메웁니다. 이미 열려 있는 셸 프롬프트에 Apidog 플랫폼 전체, 즉 테스트, 엔드포인트, 스키마, 환경, 모의 기대치, 문서를 제공합니다.
무엇보다 먼저 솔직한 정의를 내리겠습니다. Apidog CLI는 또 다른 curl이 아닙니다. 일회성 GET을 실행하고 JSON을 눈으로 확인하고 싶다면, curl과 HTTPie가 이미 그 역할을 잘 수행하고 있으며, 터미널 및 TUI REST 클라이언트 총정리 글에서 상호작용적인 측면을 다루고 있습니다. Apidog CLI는 API 워크스페이스 자체를 위한 클라이언트입니다. 스크립트나 에이전트가 호출할 수 있는 명령을 통해 구축한 테스트 시나리오를 실행하고, API 계약을 읽고 업데이트하며, 프로젝트 안팎으로 스펙을 이동시킵니다.
여기서 "터미널에 상주한다"는 의미
터미널 HTTP 도구는 한 번에 하나의 요청을 처리합니다. Apidog CLI는 프로젝트 수준에서 작동합니다. 그 명령 표면은 40개 이상의 그룹에 걸쳐 있으며, 다섯 가지 작업으로 묶입니다.
| 작업 | 명령 |
|---|---|
| 테스트 실행 | run, test-scenario, test-suite, test-case, test-data, test-report |
| 계약 관리 | endpoint, schema, folder, common-parameter, response-component, security-scheme |
| 문서 및 모의 배포 | doc, docs-site, shared-doc, mock |
| 구성 및 연결 | environment, variables, vault, database-connection, websocket, socketio |
| 팀으로 운영 | branch, merge-request, runner, scheduled-task, audit-log, import, export |
모든 명령은 --help를 지원하며, 출력은 구조화된 JSON이며, 대부분의 응답에는 다음에 무엇을 실행해야 하는지 알려주는 agentHints.nextSteps가 포함되어 있습니다. 마지막 세부 사항은 사소하게 들릴 수 있습니다. 이는 도구가 느껴지는 방식을 바꿉니다. CLI는 워크플로우를 외웠다고 가정하는 대신 안내합니다.
한 번의 명령으로 설치
CLI는 npm 패키지(apidog-cli)로 제공되며 macOS, Linux 및 Windows에서 실행됩니다. Node.js 16 이상이 필요합니다.
npm install -g apidog-cli
apidog --version
그런 다음 API 액세스 토큰으로 로그인합니다. Apidog 앱에서 토큰을 가져오세요. 아바타를 클릭하고 계정 설정을 연 다음 API 액세스 토큰 아래의 토큰을 복사합니다.
apidog login --with-token <YOUR_TOKEN>
토큰은 ~/.apidog/config.toml에 저장되므로, 저장소나 로그에 노출되지 않도록 주의하십시오. CI에서는 대신 시크릿을 사용하여 --access-token으로 실행 시마다 전달하십시오. 네 가지 전역 플래그가 대부분의 컨텍스트를 커버합니다: --project는 프로젝트를 선택하고, --branch는 브랜치를 선택하며, --access-token은 저장된 로그인을 재정의하고, --api-base-url은 CLI를 자체 호스팅 Apidog 배포 지점으로 연결합니다. Apidog CLI 인증 가이드는 CI를 위한 토큰에 대해 자세히 설명합니다.
시각적으로 구축한 테스트 실행
다음은 CLI가 구축된 워크플로우입니다. Apidog의 시각적 편집기에서 테스트 시나리오를 작성합니다. 연결된 요청, 하나의 응답에서 추출되어 다음으로 삽입되는 변수, 상태 및 본문에 대한 어설션. 그런 다음 셸이 있는 모든 곳에서 실행합니다.
# 이 명령을 시나리오의 CI/CD 탭에서 ID를 포함하여 복사하세요
apidog run -t <scenario_id> -e <env_id> -r cli
모든 어설션이 통과하면 명령은 0으로 종료하고, 실패하면 0이 아닌 값으로 종료하므로 파이프라인은 추가적인 접착제 없이 이를 기반으로 합니다. 동일한 시나리오를 개발, 스테이징 또는 프로덕션 환경으로 지정하려면 -e를 전환하십시오. CSV 또는 JSON 파일을 제공하면 모든 행에 대해 시나리오를 반복합니다. 이는 데이터 기반 테스트가 단계를 복제하지 않고 작동하는 방식입니다. 처음부터 시작하는 경우, 단계별 REST API 가이드는 설치부터 첫 번째 성공적인 실행까지 안내합니다.
보고서는 네 가지 형식으로 나옵니다. cli는 터미널에 단계별 결과를 출력하고, html, json, junit은 대시보드 및 CI 아티팩트용으로 apidog-reports/에 저장됩니다. -r cli,junit처럼 자유롭게 조합할 수 있습니다. 테스트 보고서 가이드는 각 형식의 모양을 보여줍니다.
노트북에 의존하지 않는 실행의 경우, runner 및 scheduled-task 명령은 자체 호스팅 러너 및 예약된 실행을 관리하며, 이는 Apidog에서 API 테스트 예약의 기반이 되는 동일한 메커니즘입니다.
앱을 열지 않고 API 계약 관리
이것은 다른 터미널 테스트 도구가 가지고 있지 않은 부분입니다. 테스트를 실행하는 동일한 CLI는 API 정의 자체를 읽고 쓸 수 있습니다:
apidog endpoint list --project <project_id>
apidog schema get <schema_id>
apidog environment list
apidog mock list
엔드포인트, 데이터 스키마, 폴더, 환경, 변수, 보안 스키마, 재사용 가능한 구성 요소는 모두 쿼리 및 편집 가능합니다. mock 명령은 모의 서버가 반환하는 고정된 요청-응답 쌍인 모의 기대치를 관리합니다. doc 및 docs-site 명령은 게시된 문서를 다룹니다. WebSocket 및 Socket.IO 엔드포인트는 자체 그룹을 가지며, database-connection은 테스트 시나리오가 읽는 데이터베이스 구성을 다룹니다.
가져오기 및 내보내기는 중요한 형식을 지원합니다: OpenAPI 3.x 및 Swagger 2.0 (대부분의 도구 체인이 표준화하는 사양), 그리고 Postman 컬렉션. 이는 CLI를 마이그레이션 스크립트의 가교로 만듭니다. 한 시스템에서 스펙을 가져와 Apidog으로 푸시하고 전체 교환을 버전 관리합니다.
apidog import openapi.json --project <project_id>
apidog export --format openapi
AI 에이전트가 구동할 수 있도록 구축됨
2026년 CLI 릴리스는 한 가지 아이디어에 집중합니다: AI 코딩 에이전트가 사람만큼 안전하게 API 워크스페이스를 운영할 수 있어야 한다는 것입니다. 네 가지 요소가 이를 가능하게 합니다.
첫째, 구조화된 출력입니다. 모든 명령은 에이전트가 구문 분석할 수 있는 JSON을 반환하며, agentHints.nextSteps는 각 결과 후 무엇을 해야 하는지, 오류 복구 방법까지 알려줍니다.
둘째, 게시된 입력 스키마입니다. apidog cli-schema list 및 apidog cli-schema get은 모든 쓰기 명령이 기대하는 정확한 JSON 형식을 노출하며, apidog cli-schema validate는 프로젝트에 영향을 주기 전에 페이로드를 검증합니다. 안전한 쓰기 절차는 항상 동일합니다: 스키마를 가져와서 JSON을 생성하고, 유효성을 검증한 다음, create 또는 update를 실행합니다.
셋째, 패키지화된 기술입니다. skill 명령은 CLI의 작동 지식을 에이전트가 직접 로드할 수 있는 형태로 제공합니다. 이것이 우리가 Apidog CLI 스킬을 구축한 이유입니다. 자체 측정 결과, CLI 스키마를 통해 작업하는 에이전트는 페이로드를 추측하는 에이전트보다 약 30% 적은 도구 호출과 25% 적은 토큰을 사용했습니다. 이 수치는 이 분석에서 자세히 설명되어 있습니다.
넷째, 권한 게이트입니다. 기본적으로, AI 소스에서 브랜치로의 쓰기는 사람이 외부 AI 편집 권한(Apidog 클라이언트 2.8.32 이상, 프로젝트 설정, 기능 설정, AI 기능 설정 아래)을 활성화할 때까지 차단됩니다. 다른 방법은 AI 브랜치를 사용하는 것입니다. 이는 에이전트가 필요한 리소스를 가져오고 편집한 후, 검토를 위해 병합 요청으로 결과를 다시 제출하는 격리된 브랜치입니다. 건드리지 않은 AI 브랜치는 24시간 후에 자동 보관되므로, 실험이 쌓이지 않습니다. 에이전트가 초안을 작성하더라도 API 계약은 검토 가능하게 유지됩니다.
Apidog CLI가 아닌 것
솔직한 정보로 도구를 선택하는 것이 나중에 단점을 발견하는 것보다 낫기 때문에, 세 가지 한계를 명확하게 설명합니다.
이는 상호작용적인 요청 클라이언트가 아닙니다. 임시 POST를 입력하고 응답을 예쁘게 출력하는 명령은 없습니다. curl, HTTPie 및 TUI 클라이언트가 그 역할을 담당하며, 더 잘합니다.
오픈 소스가 아닙니다. 패키지는 독점이며, npm이 유일한 설치 채널이며, --help 이상의 작업을 하려면 Apidog 계정이 필요합니다. 무료 티어는 여기에 설명된 전체 워크플로우를 포함하지만, 감사 가능한 라이선스가 필수 요구사항이라면 오픈 소스 러너가 솔직한 추천입니다.
독립형이 아닙니다. CLI는 플랫폼의 터미널 부분입니다. 시나리오, 엔드포인트 및 환경은 로컬 파일이 아닌 Apidog 프로젝트에 있습니다. 이는 설계, 테스트, 모의 및 문서 전반에 걸쳐 단일 진실 공급원을 확보하기 위한 대가입니다.
터미널 도구 상자에서의 위치
다른 러너들과 비교하면, 작성 방식에 차이가 있습니다. Newman과 Postman CLI는 Postman에서 작성된 컬렉션을 실행하고, Hurl과 Bruno는 텍스트 파일로 작성된 테스트를 실행합니다. Apidog CLI는 계약, 모의 및 문서를 포함하는 시각적 편집기에서 작성된 시나리오를 실행합니다. Apidog CLI와 Newman 비교에서 더 자세히 다루고 있으며, 전체 분야는 최고의 터미널 기반 API 테스트 도구 총정리에서 순위가 매겨져 있습니다.
대부분의 팀을 위한 작업 설정: 임시 호출에는 curl 또는 xh를 기억력에 유지하고, CI에서는 apidog run이 스위트를 실행하게 하십시오. GitHub Actions 가이드에는 복사하여 붙여넣을 수 있는 파이프라인이 포함되어 있습니다.
자주 묻는 질문
Apidog CLI는 무료로 사용할 수 있나요? 네. npm에서 무료로 패키지를 설치할 수 있으며, Apidog의 무료 티어는 시나리오 구축 및 CLI를 통한 실행을 포함합니다. 유료 플랜은 기본적인 CLI 액세스가 아닌 팀 규모 기능을 추가합니다.
curl 또는 HTTPie를 대체하나요? 아니요, 그리고 대체하려 하지도 않습니다. 이 도구들은 임시 요청을 보내고, Apidog CLI는 저장된 테스트 시나리오를 실행하고 프로젝트 리소스를 관리합니다. 대부분의 터미널은 두 가지 모두를 사용하게 됩니다.
CI에서 완전히 헤드리스로 실행될 수 있나요? 네. CI 시크릿의 --access-token으로 인증하고, 시나리오 ID와 함께 apidog run을 실행하고, 종료 코드를 기반으로 빌드를 제어하십시오. 러너에 데스크톱 앱은 필요하지 않습니다.
어떤 형식으로 가져오고 내보낼 수 있나요? OpenAPI 3.x, Swagger 2.0, 그리고 Postman 컬렉션을 양방향으로 지원합니다. 이는 마이그레이션과 통합을 모두 포함합니다.
AI 에이전트가 어떻게 안전하게 사용할 수 있나요? 스키마-유효성 검사-쓰기 절차와 권한 게이트를 통해 가능합니다. cli-schema validate는 잘못된 페이로드가 도착하기 전에 감지하고, AI 브랜치는 에이전트 편집을 사람이 병합할 때까지 격리합니다. 에이전트 내에서 작동하는 모습은 Claude Code에서 Apidog CLI를 사용하는 방법에서 확인하십시오.
터미널은 이미 테스트가 실행되고 에이전트가 작업하는 곳입니다. API 클라이언트를 그곳에 두면 마지막 컨텍스트 전환을 없앨 수 있습니다. Apidog 다운로드, npm에서 CLI 설치, 그리고 하나의 시나리오를 처음부터 끝까지 실행하십시오. run을 넘어설 준비가 되면 Apidog CLI 페이지에서 전체 명령 참조를 확인할 수 있습니다.