한 줄 정의

Coding Agent(코딩 에이전트)는 소프트웨어 작업을 맡아 코드베이스, 그러니까 프로젝트 파일 전체를 읽고 수정안을 만들며 필요한 명령을 실행하는 개발용 AI Agent야. 자동완성처럼 커서 옆에 코드 몇 줄을 추천하거나 Chat에서 답변만 받는 도구보다, 작은 작업 티켓을 받아 계획·수정·검증을 이어 가는 실행 구조에 가까워.

어떻게 작동하나

보통은 요청을 읽고, 저장소 파일과 설정을 살펴본 뒤, 바꿀 파일을 고르고, 테스트나 린트 같은 명령 결과를 다시 읽는 루프로 움직여. 이때 MCP 서버, API 문서, 프로젝트 규칙, 스킬 파일 같은 외부 Context가 들어오면 낡은 코드 예시를 덜 따라가게 돼. 도구마다 먼저 확인할 지점도 달라.

왜 중요한가

이 말을 알아두면 ‘AI가 코딩을 도와준다’는 말을 더 잘게 나눠 볼 수 있어. 단순 Chat 답변인지, 파일을 실제로 고치는지, 테스트를 돌리는지, 사람이 승인하기 전에 변경 사항을 보여주는지가 전부 다른 판단이야. Google은 Gemini Docs MCP와 Skills를 같이 쓴 자사 eval에서 96.3% pass rate와 정답당 63% 적은 토큰 사용을 적고 있어. 여기서 말하는 Skills는 Agent Skills처럼 에이전트가 작업 방식을 따라가게 하는 묶음에 가까워. 숫자 자체보다 중요한 건, 코딩 에이전트 품질이 모델 이름 하나가 아니라 최신 문서 경로, 실행 권한, 검증 루프에서 갈린다는 점이야.

주의해서 볼 점

  • 권한: 처음에는 읽기 전용이나 승인 모드로 시작할 수 있는지 봐야 해. 파일 수정, 명령 실행, 외부 API 호출 권한을 한 번에 열면 사고 범위가 커져.
  • 격리: 별도 브랜치나 worktree에서 움직이는지 확인해. 운영 브랜치에서 바로 고치게 두면 되돌리기가 어려워져.
  • 로그와 복구: 어떤 파일을 읽고, 어떤 명령을 실행했고, 어떤 diff를 만들었는지 남아야 해. 되돌리기 절차가 없으면 작은 자동화도 위험해져.
  • 테스트 루프: 린트, 단위 테스트, 빌드처럼 실제 제품 경로를 건드리는 검증이 이어져야 해. 에이전트가 실패했을 때 멈추고 물어보는지도 같이 봐야 해.
  • vendor eval: Google 같은 공급사 eval 숫자는 참고 자료야. 내 저장소의 문서 최신성, 권한 설계, 테스트 밀도와 맞지 않으면 같은 효과를 기대하기 어려워.