부록 D. 대체 코딩 에이전트 평가하기

코딩 에이전트의 모델 이름, 요금제, 내장 도구, 설정 형식은 빠르게 바뀐다. 특정 프로젝트의 JSON 설정이나 모델 식별자를 그대로 복사하면 설치가 실패하거나 권한·비용·보안 문제가 생길 수 있다.

비교 기준

기준	확인할 질문
작업 방식	터미널, 에디터, 웹 중 팀의 실제 흐름과 맞는가?
프로젝트 지침	저장소의 지침 파일과 코드 검토 규칙을 읽는가?
도구 연결	MCP·플러그인·권한이 필요한 업무에 맞는가?
데이터 처리	계정 유형·보존·학습·조직 제어 조건을 확인했는가?
검증	테스트·빌드·브라우저 확인을 실행하고 결과를 남기는가?
운영	실패 시 중단, 로그, 비용 한도, 승인 방식을 갖췄는가?

도입 실험

1. 공개 샘플 저장소나 비식별 프로젝트를 선택한다.
2. 같은 작은 작업을 기존 방식과 후보 도구에서 각각 수행한다.
3. 생성량이 아니라 테스트 통과, 수정 횟수, 검토 시간, 권한 위반 여부를 기록한다.
4. 자동 수정·외부 연결·배포는 사람 승인 없이 켜지 않는다.
5. 결과가 재현될 때만 실제 프로젝트 범위를 넓힌다.

설정을 다룰 때

공식 설치 문서와 현재 릴리스 노트를 먼저 확인한다. 모델 ID, 플러그인 이름, MCP 서버 주소, 환경변수 이름은 제공사 문서에 있는 값만 사용한다. API 키·토큰·고객 데이터는 설정 예시, 저장소, 화면 공유에 넣지 않는다.

인계 문서에 남길 것

도구와 계정 유형
허용 저장소·환경·데이터 범위
허용된 연결과 최소 권한
실행 전후 검증 명령과 기대 결과
사람 승인이 필요한 동작
문제 발생 시 중단·되돌리기 방법
공식 문서 URL과 마지막 검토일

좋은 도입은 최신 도구를 많이 연결하는 일이 아니라, 팀이 검토 가능한 작은 작업을 안전하게 반복하는 일이다.