Cline은 루프입니다: 변경 사항을 계획하고, 파일을 편집하고, 명령을 실행하고, 출력을 읽고, 다음에 무엇을 할지 결정합니다. 그렇다면 왜 API 테스트는 그 루프에 포함되지 않습니까? API 테스트는 GUI 뒤의 Apidog에 앉아 누군가가 클릭하기를 기다리고 있습니다. 당신의 에이전트는 결코 API 테스트를 건드리지 않습니다.
해결책은 하나의 구성 블록입니다. Apidog CLI는 apidog-cli라는 npm 패키지로, Apidog에서 구축한 테스트 시나리오를 터미널에서 직접 실행합니다. CLI가 설치되고 Cline이 해당 존재를 알게 되면, 당신의 에이전트는 유닛 테스트를 실행하는 것과 동일한 방식으로 Apidog 시나리오를 실행합니다: 명령을 실행하고, 종료 코드를 읽고, 빨간색으로 돌아오면 코드를 수정합니다.
아직 CLI를 설치하지 않았다면 먼저 설치하십시오. AI 코딩 에이전트를 사용하여 Apidog CLI를 설치하는 방법은 Cline이 직접 입력하면서 npm 설치, 인증 및 첫 실행 과정을 안내합니다. 이 문서는 apidog --version이 숫자를 출력하고 Apidog 계정이 인증되었다고 가정합니다.
어떤 Cline에 대한 이야기인가요
Cline은 VS Code 확장 프로그램으로 실행되는 오픈 소스 자율 코딩 에이전트입니다 (JetBrains 빌드 및 CLI도 있습니다). 리포지토리를 읽고, 계획 모드에서 계획을 세운 다음, 실행 모드로 전환하여 파일을 편집하고 셸 명령을 실행하며, 자동 승인 설정에 따라 승인을 요청합니다. 호스팅된 챗봇이 아닙니다. 모델은 사용자의 컴퓨터에서 코드베이스에 대해 실행됩니다. VS Code에 Cline 패널이 열려 있고 작업하는 동안 차이점과 터미널 출력을 보여주고 있다면 제대로 된 위치에 있는 것입니다. Cline 사용법은 설치 및 모델 선택의 기본 사항을 다룹니다.
이러한 구별이 중요한 이유는 Cline이 프로젝트 규칙을 학습하는 자체적인 방식을 가지고 있으며, 이 메커니즘은 일회성 “내 테스트 실행”을 Cline이 스스로 찾아 실행하는 것으로 바꾸기 때문입니다. 이 메커니즘이 바로 .clinerules/ 디렉터리입니다.
1단계: .clinerules에 규칙 추가 (채팅 알림 아님)
Cline은 작업을 시작하기 전에 작업 공간 루트에 있는 .clinerules/ 디렉터리에서 프로젝트 규칙을 로드합니다. 이 폴더 안에 있는 모든 .md 및 .txt 파일을 읽어 세션 동안 사용하는 지시문 세트로 결합합니다. 원한다면 단일 .clinerules 파일을 사용할 수도 있지만, 규칙이 많아질수록 디렉터리가 더 잘 확장됩니다. 이 내용은 Cline 규칙 참조에 설명되어 있습니다.
리포지토리 루트에 .clinerules/apidog.md와 같은 파일을 다음 짧은 블록으로 생성합니다:
# API testing with Apidog
- To test the API, run the Apidog CLI, not curl or ad-hoc scripts.
- Command: apidog run -t <scenario_id> -e <env_id> -r cli
- The scenario ID and environment ID come from Apidog's CI/CD tab. Use those exact values.
- Exit code 0 means every assertion passed. Non-zero means a failure; the exit code is the source of truth, not your summary.
- The machine is already authenticated via `apidog login`. Never add --access-token and never put a token in this file.
- If a flag is unknown, run `apidog run --help` and use the exact flag from there.
이것이 바로 CLI를 채팅에서 언급하는 대신 .clinerules/에 작성하는 이유입니다. Cline 메시지에 입력된 시나리오 ID는 작업이 끝나면 사라집니다. .clinerules/apidog.md에 있는 시나리오 ID는 리포지토리를 체크아웃하는 모든 팀원과 앞으로의 모든 Cline 작업에 사용됩니다. 파일은 버전 관리되므로 규칙이 코드와 함께 이동합니다.
2단계: Apidog에서 명령어 가져오기
추측한 명령어가 아닌 실제 apidog run 명령어가 필요합니다. Apidog에서 테스트 시나리오를 열고, CI/CD 탭으로 이동하여 생성된 명령어를 복사합니다. 다음과 같습니다:
apidog run -t 8291 -e 42 -r cli
-t 값은 테스트 시나리오 ID이고 -e는 환경 ID입니다. 이 값들이 .clinerules/apidog.md에 속해야 하는 정확한 값입니다. Cline이 항상 올바른 ID를 갖도록 이 값들을 규칙 블록에 붙여넣으십시오. 모든 플래그 세트에 대해서는 apidog run 명령어 참조를 확인하십시오.
3단계: Cline에게 테스트 실행시키기
규칙이 준비되면 Cline 패널에서 작업을 시작합니다. Cline은 시작할 때 .clinerules/를 로드하므로 CLI가 있음을 이미 알고 있습니다. API에 영향을 미치는 변경 사항을 만들거나 단순히 검사를 실행하도록 요청합니다:
Run the Apidog test scenario and tell me the result.
Cline은 단계를 계획한 다음, 규칙에 따라 apidog run 명령을 실행하기 위해 실행 모드로 전환합니다. 먼저 얼마나 많이 요청하는지는 승인 설정에 따라 달라집니다. Cline은 각 명령을 평가하고 안전하거나 승인이 필요한 것으로 표시합니다. 스테이징 환경에 대한 읽기 전용 테스트 시나리오는 안전하다고 간주하는 명령 유형입니다. 자동 승인 설정이 안전한 명령 실행을 허용하는 경우, apidog run은 프롬프트 없이 실행됩니다. 그렇지 않은 경우, Cline은 일시 중지하고 묻습니다. 승인하고, 향후 시나리오를 스스로 실행하도록 하려면 `execute-safe-commands`에 대한 자동 승인을 켜십시오. -r cli 리포터는 터미널에 단계별 결과와 요약을 바로 출력하며, 각 요청과 어설션이 발생하는 것을 볼 수 있습니다.
4단계: Cline 내에서 보고서 읽기
실행이 실패하면 보고서에 답이 있습니다. -r cli를 사용하면 Cline은 터미널 출력 패널에서 각 요청, 각 어설션, 그리고 어떤 것이 실패했는지, 예상 값과 실제 값과 함께 읽기 쉬운 분석을 얻습니다. 실패한 어설션은 정확한 필드 또는 상태 코드를 지정하며, 이는 일반적으로 Cline이 다음 실행에서 수정 사항을 찾는 데 충분합니다.
브라우저에서 열거나 팀원에게 전달할 수 있는 보고서의 경우, HTML 리포터를 추가하십시오:
apidog run -t 8291 -e 42 -r cli,html
html 리포터는 자체 포함된 파일을 ./apidog-reports에 작성합니다. Cline이 다음 단계를 결정하기 위해 읽는 인라인 출력을 계속 얻도록 목록에 cli를 유지하십시오. JUnit 형식 CI 대시보드 파서를 포함한 모든 플래그 및 리포터에 대해서는 완전한 Apidog CLI 가이드 및 Apidog CLI 테스트 보고서 가이드를 참조하십시오.
자체 루프 내에서 Cline 테스트
보상은 당신이 요청을 멈추고 Cline이 .clinerules/에서 지시한 대로 시나리오를 스스로 실행할 때 발생합니다.
Cline이 결제 응답을 생성하는 핸들러를 편집하는 상황을 상상해 보세요. 루프가 변경됩니다: 코드를 편집한 다음, 성공을 선언하는 대신 스테이징 환경에 대해 Apidog 시나리오를 실행하고, 종료 코드를 읽고, 이에 따라 행동합니다. 녹색이면 다음으로 넘어갑니다. 빨간색이면 보고서를 열어 어떤 어설션이 실패했는지(상태 코드, 누락된 필드, 잘못된 값) 확인하고, 수정 시도 후 다시 실행합니다. API 테스트는 Cline이 유닛 테스트를 실행하는 것과 동일한 편집-테스트-수정 루프의 일부가 됩니다. 당신은 하나의 지시를 작성했고 Cline은 그 명령을 이미 작동하는 방식에 통합했습니다.
이것은 모든 에이전트 워크플로우를 안전하게 만드는 위임-후-검증 모델입니다. Cline은 명령을 실행하고 결과를 읽습니다. 당신은 Apidog에서 시각적으로 시나리오를 계속 작성하고 에이전트가 종료 코드를 정직하게 읽는지 스팟 체크합니다. 더 넓은 패턴에 대해서는 API 테스트에 AI 에이전트를 사용하는 방법과 Apidog AI 테스트 하네스를 참조하십시오.
Cline이 실제로 CLI를 실행하는지 확인
에이전트는 얻지 못한 성공을 보고하며, Cline도 예외는 아닙니다. 문제가 얼마나 자주 발생하는지에 따라 세 가지 확인 사항이 있습니다.
첫째, 명령이 실행되었는지 확인하십시오. Cline은 실행한 명령과 그 출력을 작업 보기에서 인라인으로 보여줍니다. 리터럴 apidog run ... 줄과 그 아래 결과를 찾으십시오. Cline이 테스트를 실행했다고 말하지만 명령을 볼 수 없다면, 그것은 전혀 하지 않은 것을 요약한 것입니다. 다시 실행하고 원시 출력을 보여달라고 요청하십시오.
둘째, 중요한 종료 코드를 확인하십시오:
What was the exit code of that apidog run command?
apidog run은 모든 어설션이 통과하면 0으로 종료하고, 무엇이든 실패하면 0이 아닌 값으로 종료합니다. 이 단일 동작은 Cline 또는 파이프라인이 실행을 깔끔한 게이트로 처리할 수 있게 합니다. Cline의 설명이 “테스트 통과”라고 말하지만 종료 코드가 0이 아니면 종료 코드가 옳습니다.
셋째, 실제 시나리오를 사용했는지 확인하십시오. 실행이 “시나리오를 찾을 수 없음”으로 실패하면 Cline이 ID를 생성했거나 잘못 기억했을 수 있습니다. .clinerules/apidog.md에 있는 -t 및 -e 값과 Apidog의 CI/CD 탭에서 생성된 명령을 다시 확인하십시오. 규칙 파일의 ID가 진실입니다.
선택 사항: Apidog MCP 서버 연결
.clinerules/에서 apidog run을 실행하는 것으로 대부분의 필요한 작업을 처리할 수 있습니다. 한 가지 방법이 더 있습니다.
Cline은 모델 컨텍스트 프로토콜을 완벽하게 지원합니다. VS Code 확장 프로그램에서 Cline 패널의 MCP 서버 아이콘을 클릭하고, 구성(Configure)을 열고, MCP 서버 구성(Configure MCP Servers)을 클릭하여 cline_mcp_settings.json을 엽니다. mcpServers 객체 아래에 서버를 추가하십시오. Cline MCP 문서에 설명된 대로 JSON을 수동으로 편집하지 않고도 Cline 내부의 MCP 마켓플레이스를 통해 서버를 설치할 수도 있습니다. Apidog MCP 서버는 MCP를 통해 API 사양을 노출하므로 Cline은 코드를 작성하는 동안 스키마를 읽을 수 있으며, 단순히 나중에 읽는 것이 아닙니다. CLI는 테스트를 실행하고, MCP는 에이전트에 사양을 제공합니다.
Cline은 대화형 확장 프로그램이므로 헤드리스 러너가 제공하는 것과 같은 비대화형 테스트 모드가 내장되어 있지 않습니다. Cline 없이 파이프라인에서 apidog run을 실행하려면 GitHub Actions의 Apidog CLI에서 비밀, 리포터, 종료 코드 게이팅을 다루고, Apidog CLI CI/CD 파이프라인 가이드에서 더 넓은 설정을 다룹니다.
Cline이 잘못되었을 때
설정 중에 몇 가지 실패가 자주 나타납니다.
규칙 파일을 무시합니다. Cline이 일반 명령을 실행하거나 아무것도 실행하지 않는 경우, 규칙이 로드되지 않을 수 있습니다. 폴더 이름이 정확히 .clinerules이고 작업 공간 루트에 있는지, 그리고 내부 파일이 .md 또는 .txt로 끝나는지 확인하십시오. 새 작업을 시작하면 Cline이 규칙을 강제로 다시 로드합니다.
어쨌든 액세스 토큰을 전달합니다. Cline이 --access-token을 추가하려고 시도한다면, 공개 예제에서 추측하는 것입니다. 기계가 apidog login을 통해 이미 인증되었으므로 규칙은 그렇게 하지 말라고 이미 알려줍니다. 해당 줄을 강화하고, 실제 토큰을 .clinerules/에 절대 넣지 마십시오. 인증이 실제로 어떻게 작동하는지에 대해서는 Apidog CLI 인증 가이드를 참조하십시오.
플래그를 만듭니다. “알 수 없는 옵션” 오류는 Cline이 당신의 버전에는 없는 플래그를 추측했음을 의미합니다. apidog run --help를 실행하도록 지시하고 거기서 정확한 플래그를 복사하십시오. 이 플래그는 설치된 버전에 대해 항상 올바릅니다.
실패한 실행에 대해 통과를 보고합니다. 가장 비용이 많이 드는 문제이며, 종료 코드 규칙이 .clinerules/ 파일과 확인 단계 모두에 있는 이유입니다. 요약과 종료 코드가 일치하지 않으면 종료 코드가 우선합니다.
일상적인 에이전트에서 테스트된 루프로
그것이 설정입니다. 설치 가이드에 따라 apidog-cli를 한 번 설치하고, 리포지토리의 .clinerules/ 디렉터리에 짧은 Apidog 규칙을 추가하면, Cline은 이미 코드를 편집하는 데 사용하는 동일한 루프 내에서 API 테스트를 실행하고 결과를 읽는 방법을 알게 됩니다. 깨진 엔드포인트는 변경 사항이 배포된 후가 아니라 Cline이 아직 작업을 하는 동안 잡히게 됩니다.
GUI 뒤의 테스트는 사람이 클릭할 때 실행됩니다. 한 줄짜리 명령은 Cline이 결정할 때마다 실행됩니다. 당신은 Apidog에서 시각적으로 시나리오를 계속 구축하고, 당신의 에이전트는 당신이 보지 않는 곳에서 시나리오를 실행합니다. Apidog를 다운로드하고, 하나의 시나리오를 구축하고, 해당 apidog run 명령을 .clinerules/apidog.md에 넣고, 다음 변경 시 Cline이 이를 어떻게 인식하는지 지켜보십시오.