Claude Code와 Cursor의 Subagent, Skill 기능 - AI 코딩 도구가 팀원처럼 일하기 시작했다
AI 코딩 도구가 단순한 자동완성을 넘어서 이제는 특정 역할을 맡아 스스로 작업을 수행하는 단계에 접어들었습니다. 코드 리뷰를 요청하면 실제로 리뷰어처럼 피드백을 주고, 테스트 코드 작성을 부탁하면 프로젝트 구조를 파악해서 적절한 테스트를 생성합니다. 이 변화의 중심에 있는 것이 바로 Subagent와 Skill 기능입니다. 오늘은 Claude Code와 Cursor에서 이 기능들이 어떻게 작동하고, 어떻게 활용하면 개발 생산성을 극대화할 수 있는지 함께 살펴보겠습니다.
Subagent는 특정 작업을 전문적으로 수행하도록 설계된 하위 에이전트입니다. 마치 팀에서 각자 전문 분야가 다른 동료들이 있는 것처럼, AI 코딩 도구 안에도 코드 리뷰 전문가, 테스트 작성 전문가, 문서화 전문가 등 역할이 분화된 에이전트들이 존재합니다. 메인 AI가 사용자의 요청을 받으면, 해당 작업에 가장 적합한 Subagent에게 작업을 위임하는 방식으로 동작합니다.
이 구조의 장점은 각 Subagent가 자신의 영역에 최적화된 컨텍스트와 프롬프트를 가지고 있다는 점입니다. 범용적인 AI에게 "코드 리뷰해줘"라고 요청하는 것과, 코드 리뷰에 특화된 에이전트에게 요청하는 것은 결과물의 품질에서 차이가 납니다. 코드 리뷰 Subagent는 보안 취약점, 성능 이슈, 코딩 컨벤션 위반 등을 체계적으로 점검하도록 훈련되어 있기 때문입니다.
Skill은 미리 정의된 작업 패턴을 실행하는 기능입니다. 슬래시 명령어 형태로 호출하는 경우가 많은데, 예를 들어 /commit이라고 입력하면 변경된 파일들을 분석해서 의미 있는 커밋 메시지를 자동으로 생성해줍니다. /review-pr은 풀 리퀘스트 전체를 검토하고 피드백을 제공합니다. Skill은 복잡한 프롬프트 없이도 한 단어로 전문적인 작업을 수행할 수 있게 해주는 단축키 같은 존재입니다.
개발자의 하루를 생각해보면, 실제로 새로운 기능을 구현하는 시간보다 부수적인 작업에 쓰는 시간이 더 많은 경우가 많습니다. 코드 리뷰를 기다리고, 테스트 코드를 작성하고, 문서를 업데이트하고, 커밋 메시지를 고민하는 시간들이 쌓이면 하루가 금방 지나갑니다. Subagent와 Skill은 바로 이런 반복적이고 시간 소모적인 작업들을 대폭 줄여줍니다.
특히 컨텍스트 스위칭 비용을 줄여주는 효과가 큽니다. 코드를 작성하다가 테스트를 작성하려면 머릿속에서 "구현 모드"에서 "테스트 모드"로 전환해야 하는데, 이 전환에는 생각보다 많은 에너지가 소모됩니다. 테스트 작성 Subagent에게 위임하면 개발자는 핵심 로직 구현에만 집중할 수 있고, 테스트는 백그라운드에서 생성됩니다.
코드 품질 측면에서도 일관성을 유지하기가 수월해집니다. 사람은 컨디션에 따라 코드 리뷰의 꼼꼼함이 달라지지만, Subagent는 항상 동일한 기준으로 검토합니다. 특히 팀에서 정한 코딩 컨벤션이나 아키텍처 원칙을 Subagent에 학습시켜두면, 모든 코드가 일관된 품질 기준을 통과하도록 관리할 수 있습니다.
Claude Code와 Cursor는 각각 다른 방식으로 Subagent와 Skill 기능을 구현하고 있습니다. Claude Code는 CLI 기반으로 동작하며 터미널 환경에서 강력한 기능을 제공합니다. Cursor는 VS Code 기반의 에디터로, GUI 환경에서 직관적인 사용 경험을 제공합니다.
| 특성 | Claude Code | Cursor |
|---|---|---|
| 환경 | CLI 기반, 터미널에서 동작 | GUI 기반, VS Code 포크 에디터 |
| Subagent 호출 | 자연어 명령 또는 Task 명령어 사용 | Composer 또는 Chat에서 @agent 멘션 |
| Skill 실행 | /commit, /review 등 슬래시 명령어 | Cmd+K 단축키 및 슬래시 명령어 |
| 커스터마이징 | CLAUDE.md 파일로 프로젝트별 설정 | .cursorrules 파일로 규칙 정의 |
| 강점 | 복잡한 멀티스텝 작업, 대규모 리팩토링 | 실시간 코드 편집, 인라인 수정 |
| 적합한 상황 | 자동화 파이프라인, 배치 작업, CI/CD 통합 | 일상적인 코딩 작업, 빠른 프로토타이핑 |
두 도구를 함께 사용하는 개발자들도 많습니다. 일상적인 코딩 작업은 Cursor의 직관적인 인터페이스로 처리하고, 대규모 리팩토링이나 복잡한 자동화 작업은 Claude Code의 강력한 CLI 기능을 활용하는 방식입니다. 중요한 것은 어떤 도구가 더 좋은가가 아니라, 각 도구의 강점을 이해하고 상황에 맞게 선택하는 것입니다.
커스터마이징 측면에서 두 도구 모두 프로젝트별 설정 파일을 지원합니다. Claude Code는 CLAUDE.md 파일에 프로젝트 컨텍스트, 코딩 규칙, 자주 사용하는 명령어 등을 정의할 수 있습니다. Cursor는 .cursorrules 파일에 비슷한 정보를 담을 수 있습니다. 이 설정 파일들을 잘 관리하면 팀 전체가 동일한 AI 경험을 공유할 수 있습니다.
Subagent와 Skill을 처음 사용한다면 작은 것부터 시작하세요. 가장 추천하는 시작점은 커밋 메시지 자동 생성입니다. /commit 명령어 하나로 변경 내용을 분석해 의미 있는 커밋 메시지를 만들어주는데, 이것만으로도 하루에 상당한 시간을 절약할 수 있습니다. 작은 성공 경험이 쌓이면 자연스럽게 더 복잡한 기능으로 확장하게 됩니다.
프로젝트 설정 파일을 초기에 잘 구성해두는 것이 중요합니다. AI가 프로젝트의 구조, 사용하는 기술 스택, 팀의 코딩 컨벤션을 이해하고 있으면 결과물의 품질이 크게 달라집니다. 예를 들어 테스트 프레임워크로 Jest를 사용한다는 정보를 설정 파일에 명시해두면, 테스트 생성 Subagent가 Jest 문법에 맞는 테스트 코드를 작성합니다.
반복적인 워크플로우를 발견하면 이를 Skill로 정의해보세요. 예를 들어 매번 새 기능을 시작할 때 "브랜치 생성 > 빈 테스트 파일 생성 > 기본 구조 스캐폴딩"을 반복한다면, 이 일련의 과정을 하나의 커스텀 Skill로 만들 수 있습니다. 처음에는 시간이 조금 걸리지만, 한번 만들어두면 이후로는 명령어 하나로 동일한 작업을 수행할 수 있습니다.
AI가 생성한 결과물을 맹목적으로 신뢰하지 않는 습관도 중요합니다. 코드 리뷰 Subagent가 "문제없음"이라고 판단해도 중요한 변경사항은 직접 한 번 더 확인하세요. AI는 훌륭한 첫 번째 방어선이지만, 최종 판단은 여전히 개발자의 몫입니다. 이 균형을 잘 유지하면 AI의 생산성 향상 효과를 누리면서도 코드 품질을 관리할 수 있습니다.
새로운 AI 코딩 도구를 도입하거나 기존 도구를 평가할 때, 아래 항목들을 점검해보시기 바랍니다.
이 체크리스트를 기반으로 무료 체험 기간을 활용해 실제 프로젝트에서 테스트해보는 것을 권장합니다.
AI 코딩 도구의 Subagent와 Skill 기능은 개발자가 반복적인 작업에서 벗어나 창의적인 문제 해결에 집중할 수 있게 해주는 강력한 도구입니다. 단순한 코드 자동완성을 넘어서, 이제 AI는 코드 리뷰어, 테스트 작성자, 문서 관리자 등 다양한 역할을 수행하는 가상의 팀원이 되어가고 있습니다.
Claude Code와 Cursor 모두 각자의 강점이 있으니, 여러분의 개발 환경과 워크플로우에 맞는 도구를 선택하시기 바랍니다. 중요한 것은 도구 자체가 아니라, 그 도구를 얼마나 효과적으로 활용하느냐입니다. 오늘 하나의 Skill만이라도 시작해보세요. 커밋 메시지 자동 생성부터 시작해서, 점차 더 복잡한 작업으로 확장해나가면 어느새 개발 생산성이 크게 달라져 있을 것입니다.
