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

현재 프롬프트를 분석해야 합니다.

1. AX 사례에서 비슷한 의도 찾기

2. 실제로 작동한 프롬프트 추출

3. "왜 효과적인가" 설명

Agent 2: ax-case-finder

• description: 현재 상황과 비슷한 AX 사례 병렬 검색

• tools: Read, Grep

• model: haiku

현재 문제를 분석해야 합니다.

1. 키워드로 AX 사례 검색

2. "막혔던 순간과 해결" 매칭

3. 실제 해결 방법 추출

결과:

• .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

결과물

1. 커스텀 서브 에이전트 2개

   • ax-prompt-finder.md - 프롬프트 패턴 분석 전문

   • ax-case-finder.md - 사례 해결 방법 추출 전문

2. 분석 문서 2개

   • ax-prompt-effective-patterns.md - 효과적인 프롬프트 패턴 정리

   • ax-case-analysis-7cases.md - 7가지 사례별 인사이트

배운 점과 나만의 꿀팁

효과적이었던 것

1. Claude Code는 VSCode 안에서 작동한다

   • 별도 툴이 아닌 에디터 통합이라 훨씬 자연스러움

   • 파일 경로, 코드 맥락을 바로 이해함

2. 프롬프트는 재사용 가능한 템플릿이다

   • 한 번 잘 만들어두면 비슷한 작업에 계속 쓸 수 있음

   • 서브 에이전트 = 특정 작업에 특화된 AI 워커

3. 문서로 남기면 팀과 공유 가능

   • .claude/agents/ 폴더에 저장되어 버전 관리 가능

   • 다른 사람도 동일한 분석 품질 유지 가능

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

1. 서브 에이전트에 너무 많은 역할 주지 않기

   • 한 에이전트는 한 가지 관점만 (Single Responsibility)

   • 역할이 명확해야 재사용성이 높아짐

2. 프롬프트 문서를 건너뛰지 않기

   • 급하다고 바로 구현하려 하지 말고, 프롬프트부터 정리

   • 문서화가 곧 자동화의 시작

과정 중 시행착오

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

• 특정 작업에 특화된 프롬프트 템플릿

• 필요한 도구(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

커스터마이징 포인트:

• [작업 대상 경로/파일]: 분석할 폴더나 파일 경로

• @agent-[이름]: 앞서 생성한 서브 에이전트 이름

• [출력-파일-경로]: 결과를 저장할 위치

도움 받은 글

참고한 자료

• gpters 스터디: w1-step-2-gen-sub-agent.md

• gpters 스터디: w1-step3-use-subagent.md

• Claude Code 공식 문서: Subagent Creator

관련 글

• gpters 20기 프리랜서 자동화 스터디 소개글

• Claude Code 시작 가이드