Claude Code Agent Teams로 슈퍼마리오 게임 만들기 (AI가 팀을 꾸려서 일하는 방법 정리, Agent Teams 코딩 방법)

AI가 팀을 꾸려서 슈퍼마리오 스타일 게임을 만들었다

안녕하세요.

여러분 혹시 AI가 팀을 꾸려서 작업을 하는 개념에 대해서 알고 계신가요?

AI가 한명의 사람이라고 생각해 볼게요.

팀장 AI와 팀원 AI들이 팀을 꾸려서 능동적으로 소통하며 작업물을 만드는 것,

이것이 바로 Agent Teams의 개념이라고 보시면 될것 같습니다.

지난번에는 Claude Code 혼자서 Snake, Tetris 같은 간단한 게임 6개를 만들었는데요.

이번에는 조금 더 복잡한 게임인 "슈퍼마리오" 스타일의 게임을 AI 팀을 꾸려서 만들어 보도록 시켜볼 예정입니다.

---

AI에게 팀을 꾸려달라고 했다

먼저 저는 Claude Code에게 이렇게 요청했습니다.

슈퍼마리오 스타일의 2D 게임을 한번 만들어보자! 그런데, 나는 AI 혼자서 일하는 것을 원치 않아! Agent Teams를 이루어서 AI팀을 이루어서 개발을 시키고 싶어, 더 빠르게 결과물을 만들고 싶거든!

그리고 Claude Code는 아래와 같이 스스로 팀원을 구성하였습니다.

• Engine 담당: 물리엔진, 충돌 판정, 카메라, 게임 루프
• Level 담당: 맵 데이터, 블록/파이프/적/아이템 배치
• Graphics 담당: 스프라이트 렌더링, 애니메이션, 배경, UI

팀 구성은 아래와 같습니다.

팀원 담당 파일

Engine	물리엔진, 충돌 판정, 카메라, 게임 루프, 입력 처리	js/engine.js
Level	맵 데이터(212타일), 블록/파이프/적/아이템 배치	js/level.js
Graphics	스프라이트, 애니메이션, 배경, UI 표시	js/graphics.js

이 구조는 각 팀원이 자기 파일만 수정하고, 팀 리더가 결과를 통합하는 방식이라고 합니다.

여기서 중요한 점이 있습니다.

제가 머리를 써서, 팀을 이렇게 구성하라고 지시하지 않았습니다.

단지 팀을 이루어서 빠른 결과물을 만들어 달라고 요청한 것입니다.

AI가 프로젝트의 규모와 특성을 보고, 알아서 역할을 나누고 팀원을 배치한 겁니다.

---

첫 번째 시도에서 실패했다

하지만, 첫번째 시도에서 실패를 하고 말았습니다.

이유는 팀원 AI에게 파일 쓰는 권한이 없었기 때문입니다.

백그라운드에서 동작하는 AI 팀원은 사용자에게 "파일을 써도 될까요?"라는 확인을 요청할 수 없어서, 자동으로 거부된 겁니다.

따라서, 저는 Claude Code에게 에이전트 파일 권한쓰기를 주라고 요청하였습니다.

json

{ "permissions": { "allow": ["Write", "Edit", "Bash(mkdir:*)", "Bash(ls:*)", "Bash(cat:*)", "Bash(touch:*)"] } }

이렇게 이슈가 생기는 부분에 대해서는 Claude Code에게 원인을 분석하고, 다시 문제를 해결해 달라고 요청하면 됩니다.

이 한줄의 설정으로 모든 팀 작업이 원활하게 돌아갔습니다.

---

15분 만에 게임이 만들어졌다

권한 설정 후 다시 실행했습니다.

그리고 15분 만에 만들어진 게임을 실행하였습니다.

이걸 15분 만에 만들었다고?

저는 정말 믿을 수가 없었습니다.

횡스크롤 맵에 블록, 파이프, 구멍, 적(굼바 21마리), 골 깃발까지.

전부 순수 HTML, CSS, JavaScript로 만들어졌고, 이미지 파일은 0개입니다.

모든 그래픽이 Canvas API의 코드로 그려진 겁니다.

---

욕심이 생겼다

기본 게임이 나오니까 욕심이 생겼습니다.

저는 AI에게 추가적인 요청을 하였습니다.

캐릭터가 더 높이 점프할 수 있도록 해줘 그리고 기를 모아서 장풍이 나가도록 해줘 그리고 캐릭터도 좀 추가하자, 닌자거북이 캐릭터 만들어줘, 닌자거북이는 막대기로 공격하도록 해줘

그리고 AI는 3분 만에 Agent 팀을 꾸려서 작업을 완료하였습니다.

---

장풍이 나간다

X키를 길게 누르면 에너지가 차징됩니다. 최대 1초. 놓으면 에너지볼이 발사됩니다.

차지량 크기 속도 게이지 색상

낮음	12px	5	파랑
중간	18px	7.5	노랑
높음	20px	8.5	주황
최대	24px	10	빨강

에너지볼은 흰색 코어 + 주황 글로우 + 잔상 트레일로 렌더링됩니다.

적을 맞히면 넉백 + 200점 + 폭발 파티클이 터지고, 벽돌 블록도 파괴할 수 있습니다.

이 모든 비주얼이 이미지 파일 하나 없이, 코드로 그린 그래픽입니다.

---

닌자거북이가 난입했다

여러분 보이시나요, 슈퍼마리오 게임에 닌자거북이가 난입했습니다.

아래 내용은 AI가 캐릭터에 맞는 기능을 정의한 내용입니다.

💡 Pixel Hero (기본)

• 속도 ★★★ / 점프 ★★★★
• 스킬: Fireball — X키 차지 후 원거리 장풍 발사
• 멀리서 안전하게 적을 처치하는 플레이 스타일

Ninja Turtle (신규)

• 속도 ★★★★ / 점프 ★★★
• 스킬: Bo Staff — X키 누르면 즉시 막대기 타격
• 초록 피부, 파란 마스크(레오나르도), 갈색 등껍질
• 전방 40px 범위 근접 공격, 빠르고 공격적인 플레이 스타일

캐릭터 선택부터 스킬 차이, 스탯 밸런스까지 전부 AI가 설계한 겁니다.

---

숫자로 보면 이렇다

항목 수치

총 코드량	2,711줄
engine.js	965줄
graphics.js	1,213줄
level.js	302줄
index.html	231줄
맵 크기	212 x 15 타일 (6개 섹션)
적 수	굼바 21마리
플레이어블 캐릭터	2종
이미지 파일	0개 (전부 코드로 그림)
서버 비용	$0
초안 완성 시간	15분

---

Agent Teams를 써본 솔직한 소감

먼저, 제가 무언가를 구체적으로 지시해야 할 것 같았는데,

"팀으로 구성해서 일해"

이 한마디로 쉽게 사용할 수 있었습니다.

초안은 AI가 알아서 팀 배정을 짜주었습니다.

실제로 얻은 이점

1. 병렬 작업으로 속도 향상

3명의 AI가 동시에 각자 파일을 수정합니다. 혼자였으면 graphics.js → engine.js → index.html을 순차적으로 작업해야 했을 겁니다. 서로 독립적인 파일이라 충돌 없이 병렬 처리가 가능했습니다.

2. 코드 구조가 강제로 깔끔해짐

팀을 나누면서 자연스럽게 engine / graphics / level 구조가 확립됐습니다. AI 혼자 작성하면 한 파일에 모든 코드가 뭉치기 쉬운데, 역할 분담 자체가 아키텍처를 깔끔하게 유지시켜줬습니다.

3. 컨텍스트 윈도우 효율

각 에이전트가 자기 파일만 집중적으로 다루기 때문에, 한 에이전트가 2,711줄 전체를 기억하지 않아도 됩니다. 특히 graphics.js(1,213줄)처럼 큰 파일은 전담 에이전트가 맡는 게 훨씬 효과적이었습니다.

솔직한 한계도 있었다

문제 내용

권한 실패	첫 시도에서 팀원 AI가 파일 쓰기 권한이 없어서 전부 실패
코드 누락	Graphics 에이전트가 일부 함수를 누락 → 메인 AI가 직접 보완
통합 비용	에이전트 결과를 검증하고 빠진 부분 채우는 작업이 매번 필요

결론적으로, Agent Teams는 완전 자율 팀이라기보다 병렬 코파일럿에 가깝습니다.

여기서 병렬 코파일럿이라는 것은 여러 AI가 동시에 각자 맡은 일을 하지만, 최종 검증과 통합은 팀장 AI가 해야 하는 구조를 의미합니다**.**

팀장 AI가 결과를 검증하고 수습하는 과정이 반드시 필요합니다.

하지만 혼자 2,711줄을 순차적으로 작업하는 것과, 3명이 동시에 작업하고 팀장이 합치는 것.

후자가 확실히 빠르고, 코드 구조도 더 깔끔합니다.

---

그래서 느낀 점

사실 여기서 엔지니어적인 포인트를 더 얻을 수 있을까? 고민했는데,

앞으로는 사람이 이야기하지 않아도 알아서 최적화해서 작업물을 만들 것이라고 생각합니다.

AI를 잘 사용해보고 싶었지만, 잘 사용하는 것도 AI가 알아서 하는 시대가 된 것 같습니다.

"팀을 꾸려서 만들어줘" 한 마디에 AI가 스스로 팀을 구성하고, 역할을 나누고, 동시에 작업하고, 15분 만에 게임을 만들어냈습니다.

야, 진짜 사람이 앞으로 뭐하나?

정말 무서운 시대인 것 같습니다.

---

Git 코드

아래 작업했던 git 코드를 공유합니다. 한번 참고해 보세요.

https://github.com/johnehk86/pixel_adventure

---

저는 임베디드 소프트웨어 개발자이면서 AI로 서비스를 만드는 AICRAFTER입니다. 이 여정을 aicraftlog.com에서 기록하고 있습니다.