코딩 에이전트에 저장소를 맡기기 전 확인할 권한·비밀값 체크리스트

코딩 에이전트에게 작업을 맡기면 코드만 고치는 게 아니라 명령을 실행하고, 패키지를 설치하고, 때로는 외부와 통신합니다. 저장소를 맡기기 전에 아래 항목을 점검해 보세요.

실행 권한

• 에이전트가 승인 없이 실행할 수 있는 명령과, 매번 확인을 받아야 하는 명령을 나눕니다. 삭제·배포·DB 변경처럼 되돌리기 어려운 명령은 확인 대상에 넣으세요.
• 가능하면 컨테이너나 별도 작업 공간처럼 격리된 환경에서 돌립니다.

비밀값

• .env 파일, 클라우드 자격 증명, 운영 DB 주소가 에이전트가 읽을 수 있는 위치에 있는지 확인합니다.
• 에이전트에게는 운영이 아닌 개발용 키를 주고, 권한도 필요한 만큼만 줍니다.
• 커밋 전에 비밀값 검사 도구를 돌려 실수로 들어간 키를 걸러 냅니다.

브랜치와 머지

• 기본 브랜치에 직접 푸시하지 못하게 보호 규칙을 걸고, 에이전트 작업은 별도 브랜치와 PR로 받습니다.
• CI와 사람 리뷰를 통과해야 머지되도록 합니다.

외부 자료

• 에이전트가 웹 페이지나 문서를 읽어 오는 경우, 그 안의 지시문을 따르게 만드는 공격(간접 프롬프트 인젝션)이 있을 수 있습니다. 외부 자료를 읽는 작업과 비밀값에 접근하는 작업은 나누는 편이 안전합니다.

기록

• 에이전트가 실행한 명령과 바꾼 파일을 나중에 확인할 수 있게 기록을 남깁니다. 문제가 생겼을 때 원인을 찾는 데 가장 먼저 필요한 자료입니다.

처음에는 권한을 좁게 주고, 믿을 만한 작업부터 범위를 넓혀 가는 방식을 권합니다.