본문 바로가기
개발/AI

[AI] Claude Code Agent Teams 설정해보기

by ujin-dev 2026. 3. 2.

 

https://goddaehee.tistory.com/517 님의 글을 참고하여 개인 맥북에 Claude Code Agent Teams 설정해본 내용을 적으려고 합니다.

개념과 Subagent의 차이점 등을 상세히 정리해주셔서, 관련 내용은 해당 블로그 참고하시면 충분할 것 같습니다.


Claude 설치

일단 개인 맥북엔 Claude 설치가 안되어 있어 설치부터 진행했습니다.

Node 설치도 필요하니 설치안하신 분은 같이 설치가 필요합니다.

참고) Claude Code Docs

curl -fsSL https://claude.ai/install.sh | bash

`echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc`
를 입력하라는 이유는, claude 라는 명령어 만으로도 ~/.local/bin 폴더안에 있는 claude를 찾아 실행될 수 있게 설정하기 위함 입니다.

 

터미널에 claude 명령어를 입력하면, claude 계정에 로그인 할 수 있는 브라우저 창이 뜹니다.

로그인 및 Plan 결제가 되었다면 나타나는 auth code를 터미널에 복붙해주면 됩니다. 저는 Pro Plan을 구매했습니다.

Claude Code Agent Teams 설정하기

settings.json에 agent teams 설정을 적용해줍니다.

저는 agent teams모드를 자주 사용할 것 같아서 ~/.claude/settings.json 파일에 설정해주었어요.

아니면 필요할 때 마다 export로 설정해서 쓰시면 됩니다.

{
	"env": {
 		"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
	}
}

 

tmux 설치

저는 Split Pane 모드를 사용하려고 tmux도 설치했습니다.

터미널 화면 하나에서 여러 터미널을 화면 분할하여 사용할 수 있는 기능입니다.

여러 팀원들이 어떤 일을 하는지 시각적으로 보기 쉬워 같이 적용하면 좋을 것 같습니다.

brew install tmux

 

tmux 설치 후, ~/.claude/settings.json에 teammateMode 설정을 추가해줍니다.

{
	"env": {
    	"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
    },
    "teammateMode": "tmux"
}

 


Claude Code Agent Teams 실행하기

저는 `~/agent/claude-temp-project` package를 하나 만들어 주었습니다.

AI 뽑아주는 여러 산출물들을 해당 경로에 저장하려구요.

 

tmux > cluade

순으로 명령어를 입력해줍니다.

 

 

다음과 같은 프롬프트를 입력해보겠습니다.

KBO와 LCK에 관심이 많은데 한군데서 해당 경기들 일정과 경기 결과를 볼 수 있었으면 좋겠어. 그리고 직관 간 기록을 남길 수 있는 기능도 있으면 좋겠어.

한명은 기획자, 한명은 UI/UX 디자이너, 한명은 UI 개발자를 담당해.
기획자는 내가 원하는 요구사항을 반영하여 UI/UX 디자이너 및 UI 개발자에게 할 일을 지시해

디자이너가 디자인한 내용에 따라 UI 개발자가 개발을 완료했으면 나에게 개발한 내용과 결과물을 보고해줘.

각 담당자는 병렬로 일을 진행해줘

 

아주 착실히 본인의 일을 진행하고 있습니다. (기특기특)

다시 생각해보니 병렬로 처리하기 좀 어려운 프롬프트네요.

브라우저에 완성된 html파일을 띄워달라하면 띄워줍니다.

 

산출물은 아까 실행했던 package 하위에 생성되어 있습니다.


어떤가요? 나름 그럴싸하게 디자인을 해줍니다! 마치 팀장님이 된 느낌이에요 ^.^

여기에 Backend Developer까지 붙인다면 실제 동작하는 사이트가 되겠죠ㅎㅎ

이런 웹개발 말고도, 내 로컬에 저장된 코드를 가져와 코드리뷰를 하거나 분석을 시킬 수 있습니다.

 

딱 요정도 했는데 사용량이 이정도 됩니다. 꽤 많이 쓰이죠;;

 

 

지금 작성한 글에 대해서 평가를 부탁했더니 이렇게 해주네요! 

이걸 가지고 어떤걸 해볼지 앞으로 기대됩니다!

아이디어는 아직 없지만 그래도 설정해두는 것과 안해두는 것은 큰 차이가 있으니까요.