프롤로그

2026년 2월 5일, Anthropic은 Opus 4.6 발표와 함께 Claude Code에 Agent Teams를 공개했습니다.
현재 Research Preview(실험 기능) 단계로, 기본적으로 비활성화되어 있으며 설정을 통해 활성화할 수 있습니다.

여러 Claude Code 인스턴스가 팀을 이루어 병렬로 작업하는 기능인데, Reddit과 Hacker News 등 커뮤니티에서는 모델 성능 향상뿐 아니라 이 기능 자체의 워크플로우 변화에 주목하는 반응도 있었습니다.

메인 Claude Code가 독립적인 Claude Code를 여러 개 생성해서 각자 역할을 부여하고, 서로 통신하면서 작업을 수행합니다.

요즘 AI 소식이 하루가 멀다 하고 쏟아집니다.
새 모델 출시, 프레임워크 업데이트, 오픈소스 도구 등장 — 하루만 안 봐도 놓치는 게 생기는 수준입니다.
매일 아침 주요 AI 소식만 깔끔하게 정리해서 받아볼 수 있으면 좋겠다는 생각이 들었습니다.

대충 이런 느낌으로요.

🤖 오늘의 AI 뉴스 브리핑

💡 클로드 소넷 4.6 출시  
  - Opus 4.5 수준의 지능을 더 낮은 비용으로 제공

💡 GPT 5.3 Codex Spark 출시  
  - 실시간 코딩을 위해 설계된 소형 버전, 1000토큰/초 이상

💡 Oh my Codex 출시  
  - omc와 유사한 멀티 에이전트 환경 제공  

이걸 매일 자동으로 받아볼 수 있으면 좋겠다고 생각했고, Agent Teams로 직접 만들어보기로 했습니다.
뉴스 수집, AI 요약, 슬랙 알림 — 세 모듈이 독립적이라 병렬 개발에 딱 맞는 구조였거든요.

이 글에서는 Agent Teams의 개념부터 실전 앱 개발까지 처음부터 끝까지 다룹니다.
Agent Teams이 처음인 분도 따라할 수 있도록 단계별로 정리했습니다.

이 글을 읽고 나면 다음을 할 수 있습니다.

• Agent Teams의 개념과 활성화 방법을 이해합니다
• Agent Teams로 여러 모듈을 병렬 개발하는 워크플로우를 익힙니다
• 매일 아침 AI 뉴스를 요약해서 슬랙으로 보내주는 봇을 완성합니다

Agent Teams이 뭔가요?

한 줄 요약

메인 Claude Code가 독립적인 여러 개의 Claude Code 인스턴스를 생성해서 각자 역할을 부여하고, 병렬로 작업을 수행하게 하는 기능입니다.

오케스트레이션이 핵심입니다

Agent Teams를 이해하려면 오케스트레이션(Orchestration)이라는 개념을 먼저 알아야 합니다.

오케스트레이션은 여러 작업자에게 역할을 나누고 전체 흐름을 조율하는 것을 말합니다.
사실 Claude Code에서 오케스트레이션은 새로운 개념이 아닙니다.
기존 Subagent도 오케스트레이션이었거든요.

다만 조율 방식이 근본적으로 다릅니다.

Subagent: 중앙 집중형 오케스트레이션

Subagent는 메인 에이전트가 모든 것을 관리하는 구조입니다.

메인 에이전트가 여러 Subagent를 생성하고, Subagent는 맡은 작업을 처리한 뒤 결과를 메인에게만 보고합니다.

택배 기사에게 심부름을 시키는 것과 비슷합니다.
기사들은 각자 맡은 일을 처리하고 결과만 돌려줍니다.
기사 A가 기사 B에게 "거기 상황 어때?"라고 물어볼 수 없고, 심부름 중간에 추가 지시를 내리기도 어렵습니다.

Agent Teams: 분산형 오케스트레이션

Agent Teams는 팀 리드가 조율에 집중하고, 팀원들이 자율적으로 협업하는 구조입니다.

팀 리드가 공유 태스크 목록을 만들고 팀원을 생성하면, 각 팀원은 독립적인 컨텍스트 윈도우에서 자기 작업을 수행합니다.
팀원들은 메일박스를 통해 서로 직접 메시지를 주고받으며, 팀 리드는 전체 진행 상황을 모니터링하고 결과를 종합합니다.

오케스트라를 떠올리면 이해가 쉽습니다.
지휘자(팀 리드)가 직접 악기를 연주하지 않고 전체 흐름을 조율합니다.
연주자(팀원)들은 각자 파트를 연주하면서도, 서로의 호흡을 맞추며 하나의 곡을 완성합니다.

💡 팀 리드도 직접 작업을 할 수 있습니다.
다만 팀원들에게 위임하지 않고 혼자 코드를 짜기 시작하는 경우가 종종 있어서, 이를 방지하려면 Shift+Tab으로 Plan 모드로 전환해 먼저 계획을 받도록 하거나, "팀원들이 작업을 완료할 때까지 기다려"라고 명시적으로 지시해 리드가 조율에 집중하도록 유도할 수 있습니다.

두 오케스트레이션의 핵심 차이

핵심은 "관리자가 모든 걸 직접 하느냐, 팀원들이 자율적으로 움직이느냐"의 차이입니다.
Subagent에서는 메인 에이전트가 작업도 하고 관리도 했다면, Agent Teams에서는 이 역할이 분리됩니다.

언제 뭘 써야 할까?

오케스트레이션 방식의 차이를 이해했다면, 선택 기준은 간단합니다.

Subagent를 쓰다가 팀원끼리 통신이 필요하거나, 컨텍스트 한계에 부딪히면 Agent Teams로 전환할 시점입니다.

• 여러 모듈을 독립적으로 개발할 때 (프론트엔드/백엔드/테스트)
• 병렬 코드 리뷰 (보안/성능/테스트 커버리지를 동시에)
• 여러 가설을 동시에 검증하는 디버깅
• 크로스 레이어 변경 (프론트·백·테스트를 각 팀원이 담당)

• 순차적으로 진행해야 하는 작업 (앞 단계가 끝나야 다음 단계 시작)
• 같은 파일을 여러 팀원이 수정해야 하는 경우 (덮어쓰기 충돌)
• 단순한 작업 (조율 오버헤드가 이점보다 큼)

⚠️ 토큰 비용 주의

Agent Teams는 단일 세션 대비 훨씬 많은 토큰을 사용합니다.
각 팀원이 독립적인 Claude Code 세션이기 때문에, 팀원 수에 비례해서 비용이 증가합니다.

커뮤니티 사례 중에는 4명 팀 구성 시 실행 시간은 단축되었지만 토큰 사용량은 약 3~4배 증가했다는 보고도 있습니다.
환경과 작업 유형에 따라 달라질 수 있습니다.

일상적인 작업에는 단일 세션이 더 비용 효율적입니다.

사전 준비

Agent Teams로 뉴스봇을 만들기 전에 몇 가지 준비가 필요합니다.

필요한 것들

tmux 설치

Agent Teams의 분할 창 모드를 사용하려면 tmux가 필요합니다.

설치 후 tmux를 입력하면 하단에 초록색 바가 나타납니다.
이 안에서 Claude Code를 실행하게 됩니다.

tmux 기본 설정으로는 마우스 스크롤이 안 됩니다.
팀원들의 작업 로그를 확인하려면 스크롤이 필수이므로, ~/.tmux.conf에 아래 설정을 추가하세요.

설정 후 tmux source ~/.tmux.conf를 실행하거나 tmux를 재시작하면 적용됩니다.

💡 tmux는 macOS에서 가장 안정적으로 작동합니다.
iTerm2를 사용한다면 tmux -CC로 진입하는 방식이 자주 권장됩니다.

Agent Teams 활성화

settings.json에 두 가지 설정을 추가합니다.

teammateMode에는 세 가지 옵션이 있습니다.

⚠️ 베타 상태 주의
실험 기능이기 때문에 환경에 따라 동작 방식이 달라질 수 있으며, 명시적으로 --teammate-mode 플래그를 사용하는 것이 더 확실합니다.

뉴스봇 설계

완성된 앱의 모습

매일 아침 7시, 슬랙 채널에 이런 메시지가 도착합니다.

개발자와 바이브 코더에게 실질적으로 영향을 주는 뉴스만 선별합니다.
새 모델 출시, 개발 도구, AI 에이전트 관련 소식을 우선적으로 다루고, 각 뉴스에 출처 링크(🔗)와 개발자 관점의 짧은 코멘트(💬)를 덧붙여 가독성을 높였습니다.

앱 구조

왜 Agent Teams로 만드나요?

이 앱의 모듈은 서로 독립적입니다.

• 뉴스 수집 모듈: RSS 피드에서 뉴스를 가져옴
• AI 요약 모듈: 수집된 뉴스를 AI API로 요약
• 슬랙 알림 모듈: 요약된 결과를 슬랙 웹훅으로 전송

각 모듈이 다른 파일을 다루기 때문에 파일 충돌 없이 병렬 개발이 가능합니다.
Agent Teams의 강점에 딱 맞는 구조입니다.

💡 파일 소유권이 핵심입니다
Agent Teams에서 가장 중요한 규칙은 두 팀원이 같은 파일을 수정하면 안 된다는 것입니다.
덮어쓰기 충돌이 발생하기 때문입니다.
각 팀원이 담당하는 디렉토리/파일을 명확하게 분리하세요.

Step 1. 프로젝트 시작하기

tmux 실행

하단에 초록색 바가 나타나면 준비 완료입니다.

Claude Code 실행

팀 계획 요청

바로 팀을 만들지 않고, 먼저 계획을 요청합니다.

💡 왜 계획부터 요청하나요?

"팀으로 작업해줘"라고만 하면 서브에이전트를 만드는 경우가 있습니다.
병렬 작업 구성과 팀메이트 구성을 명시적으로 요청하고, 공식 문서 링크를 함께 제공하면 Agent Teams를 제대로 활용할 확률이 높아집니다.

아직 새로운 기능이라 문서 링크를 넣어주는 게 결과가 훨씬 좋습니다.

Claude가 계획을 세워줍니다. 보통 이런 구조로 나옵니다.

계획이 마음에 들면 다음 단계로 진행합니다.

Step 2. 팀 생성 및 작업 분배

팀 생성 요청

Claude가 Phase 1(초기 설정)을 직접 처리한 뒤, 팀원들을 생성합니다.

팀원 스폰 확인

팀원이 생성되면 tmux 분할 창에 각 팀원의 독립적인 Claude Code 세션이 나타납니다.

이 시점에서 확인할 것들

• 팀 리드가 태스크 리스트를 만들었는지
• 각 팀원이 자기 영역의 작업을 시작했는지
• 팀원들이 서로 통신하며 인터페이스를 조율하는지

💡 팀원은 프로젝트의 CLAUDE.md, MCP 서버, 스킬을 자동으로 로드합니다.
다만 팀 리드의 대화 기록은 상속하지 않으므로, 스폰 프롬프트에 필요한 컨텍스트를 충분히 포함하는 것이 중요합니다.

태스크 리스트 확인

팀 리드는 태스크 리스트를 만들고 팀원들에게 배분합니다.

태스크는 대기 중 → 진행 중 → 완료 세 가지 상태를 가지며, 태스크 간 의존성도 지원됩니다.
의존 관계가 있는 태스크는 선행 태스크가 완료될 때까지 자동으로 대기합니다.

💡 팀원에게 직접 지시할 수 있습니다

• In-process 모드: Shift+Down으로 팀원 세션을 순환한 뒤 메시지 입력
• 분할 창 모드: 팀원의 창을 클릭해서 직접 입력

팀 리드를 거치지 않고 개별 팀원에게 바로 추가 지시를 줄 수 있습니다.

Step 3. 병렬 개발 과정

각 팀원이 하는 일

3명의 팀원이 동시에 작업을 진행합니다. AI로 개발하면 결과물은 매번 다르겠지만, 대략 이런 방향으로 구현됩니다.

Collector Engineer

src/collectors/ 디렉토리를 전담합니다.
rss-parser로 여러 피드를 Promise.allSettled로 병렬 수집하고, 개별 피드가 실패해도 나머지는 정상 수집되도록 구현했습니다.
수집된 뉴스는 제목, 링크, 출처, 날짜를 포함하는 NewsItem 타입으로 통일됩니다.

Summarizer Engineer

src/summarizer/ 디렉토리를 전담합니다.
수집된 뉴스 중 최신 30건을 OpenAI 호환 API(이 가이드에서는 Groq 무료 API)로 보내 핵심 뉴스 5개를 선별하고 요약합니다.

💡 AI API는 자유롭게 선택할 수 있습니다
OpenAI SDK와 호환되는 API라면 baseURL과 모델명만 바꾸면 됩니다.
이 글의 핵심은 AI API가 아니라 Agent Teams 워크플로우입니다.

Notifier Engineer

src/notifier/ 디렉토리를 전담합니다.
요약 결과를 Slack Block Kit 형식으로 변환하고, Incoming Webhook으로 전송합니다.
전송 실패 시 지수 백오프로 최대 3회 재시도합니다.
cron 스케줄러도 이 팀원이 구현합니다.

팀원 간 통신

작업 중에 팀원들이 서로 메시지를 주고받습니다.

예를 들어, Summarizer Engineer가 Collector Engineer에게 "수집 데이터의 반환 형식이 어떻게 되나요?"라고 물으면, Collector Engineer가 NewsItem 타입 정의를 공유합니다.

이런 조율이 자동으로 일어나는 게 Agent Teams의 핵심입니다.
Subagent였다면 메인 에이전트를 거쳐야 했을 소통이 팀원끼리 직접 이루어집니다.

진행 상황 모니터링

팀 리드에서 진행 상황을 확인할 수 있습니다.
Ctrl+T로 태스크 목록을 확인하고, Shift+Down으로 각 팀원의 세션을 순환할 수 있습니다.

⚠️ 너무 오래 방치하지 마세요
팀원의 진행 상황을 주기적으로 확인하고, 방향이 잘못되면 빨리 재지정하는 게 좋습니다.
무인으로 오래 돌리면 토큰 낭비가 늘어날 수 있습니다.

Step 4. 통합 및 완성

팀 리드가 통합

모든 팀원의 작업이 완료되면, 팀 리드가 모듈을 통합합니다.
진입점(src/index.ts)에서 세 모듈을 연결하는 파이프라인을 구성합니다.

RUN_MODE=once로 즉시 실행하거나, RUN_MODE=cron으로 매일 정해진 시간에 자동 실행되도록 설정할 수 있습니다.

환경 변수 설정

💡 다른 AI API를 사용하려면 src/summarizer/openaiClient.ts의 baseURL과 summarizeNews.ts의 모델명을 변경하면 됩니다.

실행 및 테스트

팀 정리

작업이 완료되면 팀을 정리합니다.

리드에서 정리를 실행하면 팀 리소스가 정리됩니다.
다만 활성 팀원이 남아 있으면 정리가 실패할 수 있으므로, 먼저 팀원 종료를 요청한 뒤 정리하는 것이 안전합니다.

⚠️ 반드시 팀 리드에서 정리하세요
팀원이 아닌 리드에서 정리를 실행해야 합니다.
팀원에서 정리하면 리소스가 일관성 없는 상태로 남을 수 있습니다.

트러블슈팅

실제로 작업하면서 겪을 수 있는 문제들을 정리했습니다.

settings.json 설정이 안 먹힐 때

실험 기능이기 때문에 환경에 따라 settings.json 설정이 기대대로 동작하지 않을 수 있습니다.

분할 창이 안 나올 때

tmux가 설치되어 있는지 확인합니다.

tmux 세션 안에서 Claude Code를 실행했는지도 확인하세요.
tmux 밖에서 실행하면 분할 창이 생성되지 않습니다.

⚠️ VS Code 통합 터미널, Windows Terminal, Ghostty에서는 분할 창 모드가 지원되지 않습니다.
이 경우 in-process 모드를 사용하세요.

팀원이 서브에이전트로 생성될 때

"팀으로 구성해줘"라고만 하면 서브에이전트를 만드는 경우가 있습니다.

프롬프트에 "팀메이트를 구성해서 병렬로 작업해줘"를 명시하고, 공식 문서 링크를 함께 제공합니다.
아직 새 기능이라 Claude가 정확히 인식하지 못하는 경우가 있기 때문입니다.

팀 리드가 직접 작업을 시작할 때

팀원에게 위임하지 않고 리드가 직접 코드를 작성하기 시작하는 경우가 있습니다.

또는 Shift+Tab으로 Plan 모드로 전환하면, 리드가 직접 코드를 작성하지 않고 계획만 세우도록 제한할 수 있습니다.

⚠️ 일부 환경에서는 permission mode 전환 이후 팀원이 파일 도구에 접근하지 못하는 사례가 보고된 바 있습니다. 문제가 발생하면 팀원을 다시 스폰하는 것이 안전합니다.

팀원이 권한 프롬프트에서 멈출 때

팀원은 독립적인 세션이므로, 파일 수정이나 명령 실행 시 별도의 권한 승인이 필요합니다.
Claude Code의 permissions 설정(allow/deny 규칙)에서 팀원이 자주 사용하는 작업을 미리 허용해두면 권한 프롬프트를 줄일 수 있습니다.

컨텍스트 압축 시 팀을 잊어버릴 때

장시간 세션에서 리드의 컨텍스트가 압축되면 팀의 존재를 잊는 경우가 있습니다.
작업을 짧은 단위로 나누거나, 토큰이 차기 전에 팀을 정리하고 새로 생성하세요.

남아있는 tmux 세션 정리

팀이 끝난 후 tmux 세션이 남아있을 수 있습니다.

알아두면 좋은 것들

Agent Teams의 현재 제한사항

Agent Teams는 아직 Research Preview 단계입니다. 주요 제한사항은 다음과 같습니다.

커뮤니티 실전 팁

Agent Teams를 먼저 사용해본 개발자들의 조언을 정리했습니다.

• 2명부터 시작하세요. 처음부터 5명을 만들지 말고, 2명으로 워크플로우를 익힌 후 확장합니다.
• 리뷰 태스크부터 시도하세요. 구현보다 리뷰에서 Agent Teams이 더 안정적이라는 커뮤니티 합의가 있습니다. 보안/성능/테스트 3명 구성이 검증된 패턴입니다.
• 역할 이름을 구체적으로 지정하세요. architect, security-reviewer 같은 전문가 역할 이름을 부여하면 결과가 개선됩니다.
• 파일 경계를 프롬프트에서 명시하세요. 각 팀원이 담당할 디렉토리를 확실히 지정합니다.
• 팀원당 5~6개 태스크를 유지하세요. 모두가 생산적으로 작업하고, 누군가 막히면 리드가 재배분할 수 있습니다.
• 스폰 프롬프트에 컨텍스트를 충분히 넣으세요. 팀원은 리드의 대화 기록을 모릅니다. 프로젝트 구조, 기술 스택, 구체적인 작업 범위를 포함해야 결과가 좋습니다.

에필로그

프롤로그에서 던졌던 질문, "그래서 이걸로 뭘 만들 수 있는데?"에 대한 답을 함께 찾아보았습니다.

Agent Teams를 사용하면 독립적인 모듈을 병렬로 빠르게 개발할 수 있습니다.
이 글에서는 뉴스 수집, AI 요약, 슬랙 알림이라는 세 모듈을 동시에 개발해서 뉴스봇을 완성했습니다.

Agent Teams의 핵심은 결국 "적절한 작업 분배"입니다.
파일 충돌 없이 독립적으로 진행할 수 있는 작업을 나누고, 각 팀원에게 명확한 역할과 범위를 지정하는 것이 성공의 열쇠입니다.

핵심 정리

1. Agent Teams = 분산형 오케스트레이션
   • Subagent(중앙 집중형)와 달리 팀원끼리 직접 통신하고 자율 조율합니다
   • 개별 팀원에게 직접 지시할 수도 있습니다
2. 셋업은 두 가지만 기억하세요
   • CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1" 설정
   • tmux 설치 후 --teammate-mode tmux로 실행
3. 성공의 핵심은 파일 소유권 분리
   • 같은 파일을 두 팀원이 수정하면 안 됩니다
   • 모듈/디렉토리 단위로 담당 영역을 나누세요
4. 처음이라면 리뷰 태스크부터, 2명부터 시작하세요
   • 한번 직접 써봐야 감이 옵니다
   • 토큰 비용(팀원 수에 비례)을 감안해서 적절한 상황에 활용하세요

끝까지 읽어주셔서 감사합니다.

참고 자료

• Agent Teams 공식 문서
• Claude Code CLI: The Definitive Technical Reference — Blake Crosley
• How to Set Up and Use Claude Code Agent Teams — Dára Sobaloju
• 오늘 나온 따끈 따끈한 클로드 코드를 10배 스마트하게 만드는법! Claude Code Teams — 코드팩토리

🤖 AI 뉴스 브리핑 (2026. 02. 23.)  
─────────────────────────────────────

💡 Claude Sonnet 4.6 출시  
  • Opus 4.5 수준의 지능을 더 낮은 비용으로 제공  
  • Free 및 Pro 요금제 기본 모델로 적용, 100만 토큰당 $3/$15  
  🔗 https://www.anthropic.com/news/claude-sonnet-4-6  
  💬 코딩 벤치마크에서 유의미한 향상이 있어서 바이브 코딩 체감이 달라질 듯  
─────────────────────────────────────

💡 GPT 5.3 Codex Spark 출시  
  • 실시간 코딩을 위해 설계된 소형 버전, 1000토큰/초 이상  
  • 실제 코딩 작업에서 즉각적인 반응성을 제공  
  🔗 https://openai.com/index/introducing-gpt-5-3-codex-spark  
  💬 속도가 인상적인데, 정확도와의 트레이드오프는 실제로 써봐야 알 것 같음  
─────────────────────────────────────

💡 Oh my Codex 출시  
  • oh my claude code로 유명한 허예찬님이 제작한 Codex용 멀티 에이전트 도구  
  • tmux를 통해 여러 에이전트를 호출하고 작업을 병렬로 돌릴 수 있음  
  🔗 https://yeachan-heo.github.io/oh-my-codex-website/  
  💬 omc 사용자라면 익숙한 워크플로우로 바로 적용 가능  
─────────────────────────────────────

📊 3개 주요 뉴스를 선별했습니다.  

ai-news-bot/  
├── src/  
│   ├── collectors/        # 뉴스 수집 모듈  
│   │   ├── feedSources.ts  
│   │   ├── rssCollector.ts  
│   │   ├── deduplicator.ts  
│   │   └── index.ts  
│   ├── summarizer/        # AI 요약 모듈  
│   │   ├── openaiClient.ts  
│   │   ├── prompt.ts  
│   │   ├── summarizeNews.ts  
│   │   └── index.ts  
│   ├── notifier/          # 알림 전송 + 스케줄러 모듈  
│   │   ├── slackClient.ts  
│   │   ├── formatter.ts  
│   │   ├── scheduler.ts  
│   │   └── index.ts  
│   ├── config/  
│   │   └── index.ts       # 환경변수 로더  
│   ├── types/  
│   │   └── index.ts       # 공유 타입 정의  
│   └── index.ts           # 진입점  
├── package.json  
├── tsconfig.json  
└── .env                   # API 키 등 환경변수  

팀 리드: 프로젝트 초기 설정 (package.json, tsconfig.json, 공유 타입)  
  ├── 팀원 A (Collector): src/collectors/ 전담  
  ├── 팀원 B (Summarizer): src/summarizer/ 전담  
  └── 팀원 C (Notifier): src/notifier/ 전담  

Task List (news-bot-team)  
  ✅ 프로젝트 초기 설정                     - team-lead  
  🔄 collectors 모듈 구현                     - collector (blockedBy: #1)  
  🔄 summarizer 모듈 구현                     - summarizer (blockedBy: #1)  
  🔄 notifier 모듈 구현                     - notifier (blockedBy: #1)  
  ⬜ 메인 엔트리포인트 통합                     - team-lead (blockedBy: #2, #3, #4)  

뉴스 수집 (collectors) → AI 요약 (summarizer) → 슬랙 전송 (notifier)