클로드 코드 서브 에이전트가 내 삶을 바꿨다

Income stream surfers 구독자 130,000명

요약

이 영상에서는 Claude Code의 sub agents(하위 에이전트) 오케스트레이션 시스템을 소개합니다. 설계&SEO 에이전트를 활용해 10~15분 만에 50개의 SEO 랜딩 페이지를 생성한 실제 사례를 보여줍니다. sub agents를 통해 대형 컨텍스트 윈도우(200k)를 유지하면서 개별 작업을 분산하는 방법과, agents.md 파일을 활용한 에이전트 구성 방식을 설명합니다. 이를 통해 복잡한 개발 과제를 효율적으로 자동화하고, 자신만의 에이전트를 손쉽게 운영하는 방법을 배울 수 있습니다.

주요 키워드

Sub Agent Context Window Claude Code agents.md HighQ SEO 랜딩 페이지 플러그앤플레이 시스템 MVP 서비스 CLI 오케스트레이션

하이라이트

🔑 sub agents를 활용하면 하나의 200k 컨텍스트 윈도우로 세부 작업을 작은 에이전트에 분산시키며 전체 품질을 높일 수 있습니다.
⚡️ design & SEO agent 시스템을 사용해 10~15분 만에 50개의 SEO 최적화 랜딩 페이지를 동시에 생성했습니다.
🚀 라이브 스트리밍에서 3시간 이내에 SAS 프로젝트를 완성한 경험을 통해 sub agents의 강력함을 증명했습니다.
🌟 agents.md 파일을 임시로 이동·설정해 여러 프로젝트에 에이전트를 플러그앤플레이로 적용하는 방법을 안내합니다.
📌 HighQ 4.5를 활용해 10개의 하위 에이전트를 병렬로 실행함으로써 작업 속도를 더욱 끌어올렸습니다.
💡 직접 코드를 작성하면서도 여전히 sub agents를 지휘해 개발 효율을 극대화하는 새로운 워크플로우를 제안합니다.

용어 설명

Claude Code

Anthropic의 Claude 모델을 위한 코드 작성 및 자동화 도구 플랫폼입니다.

Sub Agent(하위 에이전트)

메인 에이전트가 특정 작업을 위임해 처리하는 개별 에이전트 단위입니다.

Context Window(컨텍스트 윈도우)

모델이 한 번에 처리할 수 있는 토큰(문맥) 범위로, 200k는 대용량 작업에 유리합니다.

agents.md

프로젝트에 정의된 에이전트 설정 파일로, 에이전트를 임포트·설정할 때 사용합니다.

HighQ

Anthropic의 고속 처리 Claude 모델 버전(4.5 등)으로, 대규모 병렬 작업에 최적화되어 있습니다.

CLI(Command Line Interface)

터미널에서 명령어를 입력해 시스템을 제어하는 인터페이스입니다.

간단한 인사와 함께 Claude Code sub agents 오케스트레이션 시스템을 설명합니다. 플러그앤플레이 방식으로 품질을 높이는 개념을 도입하며, 오늘 다룰 디자인&SEO 에이전트 예시를 예고합니다.

[00:00] Claude Code 에이전트 오케스트레이션 시스템을 소개합니다. 서브 에이전트를 사용해 Claude Code의 품질을 향상시키는 플러그 앤 플레이 시스템으로, 이 시스템 자체도 Claude Code로 제작되었습니다.

AI 보험 플랫폼 ‘Quotely’ 프로젝트에서 design & SEO 에이전트를 사용해 10~15분 만에 50개의 SEO 랜딩 페이지를 생성한 실무 예시를 소개합니다. 생성된 페이지가 헤더·푸터에 자동 삽입된 과정을 간략히 보여줍니다.

[00:26] 디자인 및 SEO 에이전트 시스템의 실제 사례를 소개합니다. AI 보험 플랫폼인 Quotely 프로젝트에서 모든 SEO 페이지를 10-15분 만에 동시에 생성한 사례를 보여줍니다.

터미널에서 cd, mkd, claude 명령어를 이용해 sub agents를 사용하며 컨텍스트 윈도우(200k)에 맞춰 다른 200k 에이전트를 조율하는 절차를 설명합니다. 매번 작은 단위로 작업을 분산해 개발을 단계별로 진행하는 방식을 안내합니다.

[01:37] agents.md 파일 없이도 서브 에이전트를 사용하는 방법을 실제 코드로 시연합니다. agentic-claude 디렉토리를 생성하고 에이전트 사용법을 설명합니다.

[02:03] 서브 에이전트 사용의 핵심 원칙을 설명합니다. 20만 컨텍스트 윈도우를 활용해 다른 에이전트들을 오케스트레이션하고, 코딩이 필요할 때마다 서브 에이전트를 사용하라고 조언합니다.

[02:37] 이전에는 불가능하다고 여겨졌던 일이 이제는 쉬워졌다고 강조합니다. 3시간 이내에 전체 SaaS 프로젝트를 라이브로 만드는 것이 가능하며, 아무것도 없는 상태에서 완전한 Stripe 시스템까지 구축할 수 있다고 설명합니다.

라이브 스트리밍을 통해 3시간 이내에 SAS 프로젝트를 완성한 경험을 공유합니다. sub agents를 사용하면 코드를 직접 작성하면서도 여전히 에이전트를 지휘해 대규모 개발 작업을 효율적으로 처리할 수 있음을 강조합니다.

[03:12] Claude Code를 사용해 3시간 만에 완전한 Stripe 결제 시스템을 구축한 경험을 소개하며, agents.md 없이 서브 에이전트를 활용하는 방법을 설명합니다.

[03:25] 개발자가 직접 오케스트레이터 역할을 하여 데이터베이스, Stripe CLI, Docker 등을 단계별로 Claude Code에 지시하는 서브 에이전트 활용법을 제시합니다.

[03:56] 이전에는 Claude Code의 안내가 필요했지만, 이제는 독립적으로 코딩할 수 있게 되었으며, 1% 컨텍스트로도 개발이 가능한 서브 에이전트의 진정한 장점을 강조합니다.

[04:24] 단일 200,000 컨텍스트 윈도우로 대부분의 개발을 처리할 수 있는 서브 에이전트의 핵심 이점을 설명하고, agents.md 파일 방식과의 차이점을 비교하기 시작합니다.

agents.md 파일을 임시로 이동해 Claude Code Agents Wizard V2를 프로젝트에 클론한 뒤 /agents 명령어로 에이전트를 불러오는 방법을 시연합니다. 이를 통해 플러그앤플레이처럼 에이전트를 손쉽게 관리·적용할 수 있음을 보여줍니다.

[04:53] Claude Code Agents Wizard V2를 사용하기 위해 claude.md 파일을 임시로 이동시키는 과정과 프로젝트 import 방법을 설명합니다.

[05:33] GLM 4.6 climb 프로젝트를 예시로 실제 설정 과정을 시연하며, git tree를 clone하고 agents 명령어를 테스트하는 실습 과정을 보여줍니다.

HighQ 4.5를 선택해 10개의 design 에이전트를 병렬로 띄워 50개의 SEO 랜딩 페이지 작업을 동시에 수행하는 과정을 설명합니다. 속도와 처리량을 극대화하는 설정 팁을 제공합니다.

[06:46] 에이전트를 생성한 후, 웹사이트 SEO 작업을 요청하는 간단한 과정을 보여줍니다.

[06:59] Haiku 3.5를 사용하여 빠른 속도로 50개의 SEO 랜딩 페이지 생성 작업을 시작합니다.

[07:22] 웨딩 교통 솔루션 등의 핵심 요소를 생성하고, 10개의 디자인 에이전트가 병렬로 작업합니다.

sub agents가 작업 방식을 완전히 바꿨다는 소감을 전하며, 아직 시도해보지 않은 이들에게 참여를 권장합니다. 이후 라이브 스트림 일정과 추가 콘텐츠 예고로 영상을 마무리합니다.

[07:43] 서브 에이전트가 Claude Code 사용 방식을 완전히 바꿨으며, 자동으로 헤더와 푸터까지 생성하는 놀라운 기능을 소개합니다.

[00:00] 안녕하세요 여러분, 이 간단하고

[00:02] 쉬운 영상에 오신 것을 환영합니다. 오늘은

[00:03] Claude Code 에이전트에 대해 설명할 예정입니다.

[00:06] 제가 만든 오케스트레이션 시스템 말이죠.

[00:08] 이 시스템은 기본적으로

[00:11] Claude Code용 플러그 앤 플레이 시스템으로

[00:14] 서브 에이전트를 사용해서 Claude Code의 품질을 향상시킵니다.

[00:17] 실제로 저는 이것도 Claude Code로 만들었어요.

[00:20] 그리고 오늘은 특히 이 기능을

[00:22] 보여드리려고 하는데요,

[00:24] 바로

[00:26] 디자인 및 SEO 에이전트 시스템입니다.

[00:29] 이게 실제로 무엇을 하는지,

[00:31] 실제 예시로 보여드릴 수 있어요.

[00:33] 이것은 저희가 어떤 분을 위해

[00:35] 만든 프로젝트 중 하나입니다.

[00:38] 참고로 만약 MVP를 만들어줄

[00:40] 회사를 찾고 계시다면 저희에게 연락해 주세요.

[00:43] 설명란과

[00:45] 고정 댓글에 상담 링크가 있습니다.

[00:48] 기본적으로 저희가 하는 일은

[00:50] MVP 서비스를 제공하는 것입니다. 바로

[00:52] 여기 이 프로젝트로 한 일이죠.

[00:54] Quotely입니다. Quotely는 AI

[00:57] 보험 플랫폼입니다. 그런데 기본적으로

[00:59] 오늘 보여드릴 에이전트가

[01:00] 한 일은 이 모든 SEO 페이지들을

[01:03] 기본적으로 10-15분 만에 만든 것입니다.

[01:06] 모두 동시에

[01:09] 오늘 보여드릴 바로 그 시스템을 사용해서요.

[01:10] 저는 나중에 스트리밍을 할 예정입니다.

[01:13] 아마 이 영상이 올라간 후 한 시간 정도 후에

[01:15] 스트리밍할 예정이니 기대해 주세요.

[01:17] 그런데 네, 이게 실제로

[01:19] 어떻게 작동하는지 얘기해보죠.

[01:21] 실제로 여기에 readme가 있어요.

[01:22] 메인을 사용하시거나 HighQ Shutter를 사용하셔도 됩니다.

[01:25] 만약 HighQ를 사용하는 데

[01:26] 관심이 있으시다면

[01:28] HighQ Shutter를 확인해보세요.

[01:30] 하지만 네, 바로 여기 이

[01:32] 디자인 에이전트가 오늘 영상에서

[01:34] 집중할 내용입니다.

[01:37] 또 한 가지 말씀드리고 싶은 것은

[01:38] 실제로 저는 agents.md 파일을 사용하지 않고도

[01:42] 서브 에이전트를 사용해왔어요.

[01:44] 그게 정확히 어떤 모습인지 보여드리겠습니다.

[01:46] cd ..를 입력하고

[01:48] clear를 한 다음 mkdir agentic-claude를 입력하고 cd agentic-claude를 실행합니다.

[01:52] 그리고 여기서 claude를 작성해보겠습니다.

[01:56] 에이전트를 사용하는

[01:58] 두 가지 다른 방법을 보여드리겠습니다.

[02:01] 첫 번째로 할 수 있는 것은

[02:03] 무엇이든 할 때 컨텍스트를 보존하기 위해

[02:06] 서브 에이전트를 사용하는 것입니다.

[02:09] 이 20만 컨텍스트 윈도우를 사용해서

[02:12] 다른 20만 컨텍스트 윈도우 에이전트들을 오케스트레이션하려고 합니다.

[02:17] 에이전트들을 말이죠.

[02:19] 기본적으로 코딩이 필요할 때마다

[02:23] 서브 에이전트를 사용하세요.

[02:25] 잊지 않도록 이것을 기억에 저장해 주세요.

[02:29] Supabase CLI를 사용해서

[02:34] 기본적인 Supabase 로컬 프로젝트를 만드는 것부터 시작해 주세요.

[02:37] 여러분, 이것을 보세요.

[02:40] 이것이 새로운 빌딩이고

[02:42] 제가 전체 SaaS 프로젝트를 3시간 이내에

[02:46] 제 채널에서 라이브로 만드는 것을 보실 수 있습니다.

[02:50] 어쩌면 여러분이 생각하기로는

[02:51] '어 미쉬, 이 영상의 요점이 뭐야?

[02:53] 여기서 우리가 뭘 얘기하는 거지?'

[02:54] 이전에는 이런 것이

[02:56] 가능하다고 말하지도 않았을 텐데요.

[02:58] 지금은 쉽습니다. 여기 이 영상,

[03:02] '몇 시간 만에 SaaS 만들기 Claude Code 한계 테스트'에서

[03:05] 실제로 이 스트림에서

[03:07] 아무것도 없는 상태에서 완전히 작동하는 Stripe

[03:12] 크레딧을 3시간도 안 되는 시간에 모든 걸 완성했습니다

[03:16] 제가 오늘 보여드리는

[03:17] 정확한 과정을 사용해서요. 제가 좋아하는

[03:20] 방법은 agents.md를 사용하지 않는

[03:22] 서브 에이전트입니다. 이게 기본적으로

[03:25] 제가 오케스트레이터가 되는 겁니다. 제 머릿속에서는

[03:27] 데이터베이스를 만들고,

[03:30] Stripe CLI를 설정하고, Docker를 설정하고, 이것저것

[03:33] 설정하라고 단계별로

[03:36] Claude Code가 무엇을 해야 할지 오케스트레이션하는 겁니다.

[03:39] 지금 이것이 서브 에이전트를 사용하는 한 가지 방법입니다. 제가

[03:42] 개인적으로 현재

[03:44] 사용하고 있는 서브 에이전트 방식입니다.

[03:46] 누군가가 저에게 'Mish, 서브 에이전트를 어떻게 사용하고 있나요?'라고 물으면

[03:49] 저는 agents.md 파일 없이

[03:50] 서브 에이전트를 사용한다고 말할 겁니다. 왜냐하면 제 생각에는

[03:53] 이제 지점에 도달했기 때문입니다

[03:56] 제가 실제로 Claude Code의

[03:57] 안내 없이도 직접 코딩을 할 수 있는

[04:00] 단계에 온 거죠. 이전에는 Claude Code와 함께

[04:03] 모든 걸 해야 했습니다. 왜냐하면

[04:06] 코딩에 대해 충분히 알지 못했기 때문에

[04:08] Claude Code를 사용해서 뭘 해야 할지

[04:10] 알려달라고 해야 했거든요.

[04:13] 여기서 일어난 일은 제가 1% 컨텍스트만 남아도

[04:16] 이걸 할 수 있었다는 겁니다.

[04:18] /compact를 실행하지 않고도요.

[04:20] 이것이 오늘 우리가 이야기하는

[04:22] 서브 에이전트가 주는

[04:24] 진짜 장점입니다. 단일한

[04:27] 20만 컨텍스트 윈도우를 사용해서 기본적으로

[04:30] 대부분의 개발을 할 수 있게 해주는 거죠.

[04:33] 그럼 다른 옵션을 살펴봅시다.

[04:36] agents.md 파일이 제가 방금 보여드린 것과

[04:38] 어떻게 다른지 보겠습니다.

[04:41] 여기 있는 Claude Code

[04:43] Agents Wizard V2는 아마도

[04:46] 이 영상 설명란에 링크가 있을 겁니다.

[04:49] readme에 나와있는데로 해야 할 일은

[04:50] 임시로

[04:53] claude.md 파일을 이동시켜야 한다는 겁니다.

[04:56] 이 프로젝트를 어떤

[05:00] 프로젝트에든 import할 수 있도록요.

[05:04] 제 컴퓨터에서 실제로 돌아가는

[05:06] 랜덤한 프로젝트를 찾아봅시다.

[05:09] Rolls-Royce로 해볼까요.

[05:12] 음,

[05:13] 이런 걸 열어보겠습니다.

[05:16] 살펴봅시다.

[05:22] 실제로 제 docs를 열어보겠습니다.

[05:25] 좋습니다 여러분. 여기 예시

[05:26] 프로젝트가 있습니다. GLM 4.6

[05:29] climb라고 불립니다. 빠르게

[05:33] cd GLM 4.6

[05:36] climb를 해보겠습니다.

[05:40] 보겠습니다. 이미 docker가 있나요?

[05:42] cd my-next-app ls를 해봅시다.

[05:47] 여기 claude가 없네요. 그럼

[05:49] 바로 이 프로젝트로 들어갈 수 있겠네요.

[05:52] claude라고 하겠습니다.

[05:56] 네, 이

[06:01] git tree를 이 프로젝트에 clone해 주세요.

[06:08] 프로젝트를 빠르게 가져오기 시작하는 걸 볼 수 있을 겁니다.

[06:11] cloud code agents로 cloning하고 있네요.

[06:13] 잘 되네요. 아, 잠깐.

[06:15] my-next-app 안에 있어야 하는군요.

[06:19] 좋습니다.

[06:22] 보시다시피, 이제 완벽하다고 나오네요.

[06:24] 여기에 clone했습니다.

[06:26] 나가봅시다. 이제 claude를 쓸 때

[06:29] /agents를 쓰면

[06:32] 여기서 일부 agents를 볼 수 있을 겁니다.

[06:34] agents를 찾을 수 없다고 나오네요.

[06:37] 좋습니다.

[06:39] 이제 /agents를 쓸 때

[06:41] 몇 가지를 바꿔달라고 요청해야 했습니다.

[06:42] 새 agent 프로젝트 agents 생성을

[06:45] 볼 수 있네요.

[06:46] 바로 여기에 있습니다. 이제 정말 간단하게

[06:49] 할 일은 이거뿐이에요. 전체 과정을 다 보여드리지는

[06:50] 않겠습니다. 여러분이 직접

[06:52] 실험해보실 수 있어요. 제 웹사이트 SEO를

[06:54] 해주세요.

[06:59] 이제 그냥 놔두면 됩니다. 보시는 것처럼

[07:03] 실제로 Haiku를 사용하고 있어요.

[07:05] 저는 이 용도로는 Haiku 3.5를 정말 좋아해요.

[07:09] 그냥 더 빠르거든요.

[07:11] 얼마나 빠른지 보세요.

[07:13] 얼마나 빠른지 보실 수 있죠.

[07:19] 50개의 SEO 랜딩 페이지를 생성합니다.

[07:22] 답안 제출.

[07:25] 이제 모든 것을 동시에

[07:27] 처리할 것입니다.

[07:29] 이것이 생성한

[07:30] 핵심 요소들입니다.

[07:32] 웨딩 교통 솔루션 등등

[07:34] 등등. 이제 10개의 디자인 에이전트를 병렬로 실행해서

[07:36] 50개의 SEO 최적화된 랜딩 페이지를

[07:38] 모두 생성합니다. 이제 보시는 것처럼

[07:40] 모든 페이지를 생성하고 있어요.

[07:42] 여기서 영상을 마무리하겠습니다.

[07:43] 스쿼드 리그에 대해서

[07:44] 이야기하고 싶었거든요. 왜냐하면 정말로

[07:46] 서브 에이전트가 제가 Claude Code를

[07:48] 사용하는 방식을 완전히 바꿔놨거든요.

[07:50] 아직 시작하지 않으셨다면 정말정말 시도해볼 가치가 있어요.

[07:53] 제 큰 머리 때문에 잘 안 보일 수도 있어서

[07:55] 이걸 옆으로 옮겨놓겠습니다.

[07:56] 네, 이렇게 하면 모든 페이지를 생성해서

[07:59] 배치할 것입니다. 또한 자동으로

[08:01] 헤더와 푸터에도 배치할 텐데

[08:03] 정말 놀라운 일이죠.

[08:06] 네, 이것이 제 에이전트 중 하나입니다.

[08:08] 이런 에이전트를 정말 많이 많이

[08:10] 작업 중이에요. 실제로 여기서

[08:11] 첫 번째 코드 조각을 볼 수 있어야

[08:13] 하는데요.

[08:16] 아직 코딩이 끝나지 않았네요.

[08:17] 하지만 여기서 영상을 마무리하겠습니다.

[08:18] 시청해주셔서 정말 감사합니다.

[08:19] 끝까지 보신다면

[08:20] 정말 대단한 분이세요.

[08:22] 스트림에서 다시 뵙겠습니다.

[08:24] 그리고 곧 더 많은 콘텐츠로

[08:26] 찾아뵙겠습니다. 안녕히계세요.