vs코드에서 클로드코드 구동하기

한줄 요약

gpters 스터디 1주차 실습으로, Claude Code에서 커스텀 서브 에이전트 2개를 만들어 AX 사례 문서를 체계적으로 분석하고 재사용 가능한 자동화 템플릿을 구축했습니다.

이런 분들께 도움돼요

Claude Code로 처음 자동화를 시도하는 비개발자
반복되는 문서 분석 작업을 효율화하고 싶은 분
서브 에이전트 개념이 궁금하고 실습해보고 싶은 분

소개: 시도하고자 했던 것과 그 이유

문제 상황 (Before)

gpters 스터디에 참여하기 전까지는 AX 사례 문서들을 분석할 때 하나씩 수동으로 읽으면서 정리했습니다.

각 문서를 일일이 열어서 내용 파악
중요한 패턴이나 인사이트를 놓치기 쉬움
일관성 있는 관점으로 분석하기 어려움
다음에 비슷한 분석이 필요할 때 처음부터 다시 시작

시작하게 된 계기

gpters 20기 프리랜서 자동화 스터디 1주차 과제로 시작했습니다.

가장 놀라웠던 점은 Claude Code가 VSCode 안에서 바로 작동한다는 사실을 알게 된 것이었습니다. 별도의 터미널이나 웹 인터페이스가 아닌, 제가 평소 쓰던 에디터 안에서 AI와 협업할 수 있다는 게 신기했습니다.

진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?

사용한 도구

도구명: Claude Code (VSCode Extension)
모델: Claude Sonnet 4.5
핵심 기능: /subagent-creator 명령어로 커스텀 서브 에이전트 생성

AI와 협업한 과정

1️⃣ 서브 에이전트 생성 (Step 2)

상황: AX 사례 문서를 두 가지 관점에서 분석하고 싶었습니다.

이렇게 요청했어요:

/subagent-creator 를 이용하여 두 서브 에이전트를 생성합니다
Agent 1: ax-prompt-finder
description: 프롬프트 개선 패턴을 AX 사례에서 병렬 검색
tools: Read, Grep
model: haiku
현재 프롬프트를 분석해야 합니다.
AX 사례에서 비슷한 의도 찾기
실제로 작동한 프롬프트 추출
"왜 효과적인가" 설명
Agent 2: ax-case-finder
description: 현재 상황과 비슷한 AX 사례 병렬 검색
tools: Read, Grep
model: haiku
현재 문제를 분석해야 합니다.
키워드로 AX 사례 검색
"막혔던 순간과 해결" 매칭
실제 해결 방법 추출

결과:

.claude/agents/ax-prompt-finder.md 생성
.claude/agents/ax-case-finder.md 생성

두 개의 전문 분석 에이전트가 자동으로 생성되었습니다.

2️⃣ 서브 에이전트 병렬 실행 (Step 3)

상황: 5개의 AX 사례 문서를 두 가지 관점으로 동시 분석하고 싶었습니다.

이렇게 요청했어요:

gpters-w1-practice\gpters_aicase_ax 해당 경로의 5개의 문서 인사이트를 파악한 다음, 인사이트를 추려내 문서화를 목표합니다.
main-agent가 전체 문서를 읽고 맥락을 이해합니다.
아래 에이전트를 병렬로 호출하여 내용을 파악합니다:
@agent-ax-case-finder
@agent-ax-prompt-finder
결과값을 다음 경로에 문서화를 해주세요:
ax-prompt-finder의 결과: ax-prompt-effective-patterns.md
ax-case-finder의 결과: ax-case-analysis-7cases.md

결과: 2개의 서브 에이전트가 동시에 작동하면서:

프롬프트 패턴 분석 문서 자동 생성
사례별 해결 방법 분석 문서 자동 생성

느낀 점: 두 가지 관점의 분석이 동시에 진행되는 게 신기했습니다. 마치 두 명의 전문 분석가가 각자의 관점으로 문서를 읽고 보고서를 작성해주는 느낌이었습니다.

인상적이었던 순간

"오!" 했던 순간:

VSCode 안에서 Claude Code가 바로 작동한다는 걸 알았을 때가 가장 놀라웠습니다.

웹 브라우저를 왔다갔다 하거나, 별도의 CLI 툴을 켤 필요 없이, 제가 코드를 작성하는 바로 그 공간에서 AI와 대화하며 작업할 수 있다는 점이 실용적으로 느껴졌습니다.

막혔던 순간과 해결

문제: 크게 막힌 부분은 없었습니다.

이유: 스터디에서 제공한 프롬프트 문서(w1-step-2-gen-sub-agent.md, w1-step3-use-subagent.md)를 그대로 따라가니 순조롭게 진행되었습니다.

💡 Tip: 프롬프트 문서를 준비해두면 누구나 쉽게 따라할 수 있습니다. 이번 실습의 핵심은 "좋은 프롬프트는 재사용 가능한 자산"이라는 점입니다.

결과와 배운 점

Before vs After

항목

Before

After

분석 방식

수동으로 문서 하나씩 읽고 정리

서브 에이전트 2개가 병렬로 자동 분석

일관성

주관적, 놓치는 부분 많음

체계적인 2가지 관점 유지

재사용성

매번 처음부터 다시 시작

에이전트 템플릿 보유 (다른 문서에도 적용 가능)

결과물

커스텀 서브 에이전트 2개
- ax-prompt-finder.md - 프롬프트 패턴 분석 전문
- ax-case-finder.md - 사례 해결 방법 추출 전문
분석 문서 2개
- ax-prompt-effective-patterns.md - 효과적인 프롬프트 패턴 정리
- ax-case-analysis-7cases.md - 7가지 사례별 인사이트

배운 점과 나만의 꿀팁

효과적이었던 것

Claude Code는 VSCode 안에서 작동한다
- 별도 툴이 아닌 에디터 통합이라 훨씬 자연스러움
- 파일 경로, 코드 맥락을 바로 이해함
프롬프트는 재사용 가능한 템플릿이다
- 한 번 잘 만들어두면 비슷한 작업에 계속 쓸 수 있음
- 서브 에이전트 = 특정 작업에 특화된 AI 워커
문서로 남기면 팀과 공유 가능
- .claude/agents/ 폴더에 저장되어 버전 관리 가능
- 다른 사람도 동일한 분석 품질 유지 가능

이렇게 하면 안 돼요 (주의사항)

서브 에이전트에 너무 많은 역할 주지 않기
- 한 에이전트는 한 가지 관점만 (Single Responsibility)
- 역할이 명확해야 재사용성이 높아짐
프롬프트 문서를 건너뛰지 않기
- 급하다고 바로 구현하려 하지 말고, 프롬프트부터 정리
- 문서화가 곧 자동화의 시작

과정 중 시행착오

처음에는 "서브 에이전트"라는 개념이 생소했지만, 실제로는:

특정 작업에 특화된 프롬프트 템플릿
필요한 도구(tools)만 선택적으로 사용
haiku 같은 빠르고 가벼운 모델 선택 가능

결국 "작업을 작은 단위로 나누고, 각 단위에 맞는 전문 워커를 만드는 것"이라는 걸 이해했습니다.

앞으로의 계획

다음 단계

다른 유형의 문서 분석에 적용
- gpters 게시글 분석
- 기술 문서 요약
- 고객 피드백 분류

다른 업무에 적용한다면?

주간 리포트 자동 생성
회의록 요약 및 액션 아이템 추출
코드 리뷰 자동화

도움이 필요한 부분

더 복잡한 워크플로우 (3개 이상 에이전트 연결)
외부 API 연동 (Notion, Slack 등)

재사용 가능한 프롬프트

프롬프트 1: 서브 에이전트 생성

/subagent-creator 를 이용하여 [작업 목적]을 위한 서브 에이전트를 생성합니다

---
name: [에이전트-이름]
description: [에이전트가 하는 일 한 문장]
tools: [필요한 도구들, 예: Read, Grep, Edit]
model: [haiku/sonnet/opus - 작업 복잡도에 따라]
---

[에이전트가 수행할 구체적 작업 단계]
1. 첫 번째 단계
2. 두 번째 단계
3. 세 번째 단계

OUTPUT: [원하는 출력 형식]

커스터마이징 포인트:

[작업 목적]: 문서 분석, 코드 리뷰, 요약 등
[에이전트-이름]: kebab-case로 작성 (예: report-generator)
tools: Read(읽기), Grep(검색), Edit(수정), Write(생성), Bash(실행) 중 필요한 것만
model:
- haiku - 빠르고 가벼운 작업 (검색, 분류)
- sonnet - 표준 작업 (분석, 요약)
- opus - 복잡한 작업 (심층 분석, 코드 생성)

프롬프트 2: 서브 에이전트 병렬 실행

[작업 대상 경로/파일]을 분석합니다.

main-agent가 전체 맥락을 파악한 후,
아래 에이전트를 병렬로 호출합니다:
- @agent-[첫번째-에이전트]
- @agent-[두번째-에이전트]

결과를 다음 경로에 문서화해주세요:
- [첫번째-에이전트]: [출력-파일-경로-1].md
- [두번째-에이전트]: [출력-파일-경로-2].md