클로드코드, 안티그래비티 스킬, 서브에이전트 및 워크플로우
AI 코딩 도구의 판도가 완전히 바뀌었습니다. Claude Code는 출시 8개월 만에 개발자 선호도 46%로 AI 코딩 도구 1위에 올라섰으며, 2026년 현재 서브에이전트(Subagent), Antigravity 스킬, Agent Teams 워크플로우로 개발 방식의 혁신을 이끌고 있습니다. 단순한 코드 자동완성 시대는 끝났습니다. 이 글에서는 2026년 최신 자료를 바탕으로 Claude Code의 핵심 기능과 실전 활용법을 빠짐없이 정리해드립니다.
Claude Code란 무엇인가?
Claude Code는 터미널에서 직접 실행되는 Anthropic의 에이전틱(Agentic) 코딩 도구입니다. GUI 없이 자연어 명령만으로 파일 읽기, 코드 작성, 테스트 실행, git 커밋까지 모두 처리합니다. 2026년 현재 Claude Opus 4.6과 Claude Sonnet 4.6을 기반으로 200K 토큰(API 베타에서는 최대 1M 토큰)의 컨텍스트 창을 지원하며, 단순한 코드 보조 도구를 넘어 완전 자율 에이전트 환경으로 진화했습니다.
- 터미널에서
claude명령어 하나로 어느 프로젝트에서나 즉시 시작 가능 - 파일시스템, git 히스토리, 테스트 스위트, 터미널 출력 모두 접근 가능
- 변경 전 반드시 개발자 승인 요청 → 안전한 자동화 보장
- VS Code, JetBrains, Neovim, Emacs 등 모든 에디터와 병행 사용 가능
- SSO, SCIM 프로비저닝, HIPAA 준비, Amazon Bedrock/Google Vertex AI/Microsoft Foundry 배포 지원
- The Pragmatic Engineer 조사(2026년 1~2월, 약 1,000명 대상)에서 46% 선호도로 1위 기록
서브에이전트 핵심 개념
서브에이전트는 특정 작업에 특화된 독립 AI 어시스턴트로, Claude Code의 컨텍스트 관리 문제를 근본적으로 해결합니다. 각 서브에이전트는 자체 컨텍스트 창에서 실행되어 메인 대화를 오염시키지 않으며, 작업 완료 후 결과만 반환합니다. 대규모 코드베이스에서 단일 에이전트가 컨텍스트 80~90%를 파일 로딩에 써버리는 문제를, 서브에이전트 분산으로 각 에이전트가 약 40% 수준을 유지할 수 있게 됩니다.
.claude/agents/폴더에 YAML 프론트매터(name, description, tools) 형식으로 정의- 서브에이전트는 다른 서브에이전트를 생성할 수 없음 (중첩 위임 불가)
SubagentStart/SubagentStop훅(Hook) 이벤트로 라이프사이클 제어 가능- 재개(Resume) 기능: 이전 서브에이전트의 전체 대화 히스토리를 유지하며 작업 이어서 진행
- 단일 에이전트 대비 토큰을 약 4~7배 더 소비하므로 비용 계획 필수
- 100개 이상의 커뮤니티 서브에이전트를 VoltAgent/awesome-claude-code-subagents에서 설치 가능
Agent Teams 워크플로우
Agent Teams는 2026년 2월 Claude Opus 4.6과 함께 출시된 실험적 기능으로, 여러 Claude Code 세션이 공유 코드베이스에서 동시에 협력 작업을 수행합니다. 서브에이전트가 독립적으로 결과만 반환하는 ‘프리랜서 대기열’이라면, Agent Teams는 같은 공간에서 실시간 소통하는 ‘프로젝트 팀’에 해당합니다. 에이전트들은 메일박스(Mailbox) 시스템을 통해 피어-투-피어로 직접 메시지를 교환하며 자율적으로 조율합니다.
- Opus 4.6 모델 필수 + 실험적 기능 플래그 활성화 필요 (
v2.1.32부터 지원) - 팀 리드 에이전트가 작업 분배 및 결과 통합을 담당
- 각 에이전트는 독립된 컨텍스트 창(최대 1M 토큰)을 가지며 상호 격리
- git 기반 작업 클레임 시스템으로 충돌 없이 병렬 작업 진행
/team-plan→/team-build명령으로 계획-실행 파이프라인 구성 가능- 5개 에이전트 이상에서 효과적이나, 에이전트들이 공유 파일을 자주 수정할 경우 오히려 비효율 발생
Git Worktree 격리 기능
Claude Code는 2026년에 서브에이전트용 내장 git worktree 격리를 지원하기 시작했습니다. git worktree는 저장소의 경량 복사본으로, 별도의 브랜치에 바인딩되어 에이전트들이 서로 간섭 없이 병렬 작업을 수행할 수 있게 해줍니다. 5개 에이전트가 같은 브랜치에서 동시 작업 시 발생하던 머지 충돌 문제를 근본적으로 해결한 기능입니다.
- 서브에이전트 프론트매터에
isolation: worktree한 줄 추가로 활성화 - 변경사항이 없으면 자동 정리(Clean-up), 변경사항이 있으면 검토 및 머지 대기
- 생성 → 작업 → 반환 → 검토 → 머지 → 정리의 6단계 자동 처리
- TypeScript 마이그레이션, 대규모 리팩터링, 테스트 생성에 특히 효과적
/batch명령으로 단순 병렬 실행 시 worktree 격리 자동 처리 가능- 실제 개발팀의 브랜치 기반 협업과 동일한 패턴을 AI 에이전트에 적용
Antigravity 스킬 생태계
Antigravity Awesome Skills는 Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity IDE 등 주요 AI 코딩 도구에서 공통으로 사용 가능한 1,340개 이상의 에이전틱 스킬 라이브러리입니다. 2026년 3월 기준 GitHub 스타 28,000개 이상, v9.2.0 릴리스를 기록하며 AI 개발자 커뮤니티의 핵심 리소스로 자리잡았습니다. Claude Code 스킬은 .claude/skills/ 폴더에, Antigravity 스킬은 .agent/skills/ 폴더에 동일한 SKILL.md 형식으로 저장되어 폴더명만 바꾸면 플랫폼 간 이동이 가능합니다.
npx antigravity-awesome-skills --claude한 줄 명령으로 1,340개 스킬 전체 설치 가능- Web Wizard, Security Engineer, Essentials 등 역할별 큐레이션 번들 제공
- 공식 Anthropic 스킬(
frontend-design등)도 동일 라이브러리에서 설치 가능 - 스킬은 대화 시작 시 에이전트가 자동으로 적합한 스킬을 감지하여 로드(Progressive Disclosure)
- MCP 도구(통합/연결)와 스킬(실행 방법 지침)은 역할이 다르며 병행 사용 권장
- GitHub 공식 레포지토리에서 설치 가이드 확인 가능
Claude Code vs Antigravity IDE
Google Antigravity는 2025년 11월에 발표된 에이전트 우선(Agent-First) IDE로, Gemini 3를 기반으로 브라우저 통합 자율 작업 실행이 핵심 강점입니다. Claude Code와 Antigravity는 철학 자체가 다릅니다. Claude Code가 개발자 통제 중심의 터미널 우선 접근이라면, Antigravity는 자율 실행을 우선하는 IDE 환경입니다. 실제 개발자 커뮤니티에서는 계획·설계는 Claude Code, 병렬 실행은 Antigravity라는 ‘샌드위치 아키텍처’를 추천합니다.
- Claude Code: 순차적·승인 기반 워크플로우 → 명확한 감사 추적, 프로덕션 안정성 우수
- Antigravity: 에이전트 우선 자율 실행 → 빠른 프로토타이핑, UI 버그 조기 발견
- 기업 보안 기능(SSO, HIPAA, 감사 로그)은 현재 Claude Code가 더 완성도 높음
- Antigravity는 2026년 초 현재 프리뷰 단계로 생산 환경 실사례 제한적
- 두 도구 모두 잘 구조화된 코드베이스와 문서 품질에 크게 의존
- Claude Code는 첫 시도 자율 성공률 약 33%이나 반복 사용 시 개발자 온보딩 크게 향상
MCP와 스킬 통합 전략
Claude Code의 아키텍처는 5개 레이어로 구성됩니다. MCP(연결성) → 스킬(작업 특화 지식) → 에이전트(메인 워커) → 서브에이전트(병렬 독립 워커) → Agent Teams(조율)의 계층 구조가 명확합니다. MCP 표준은 이미 Apple과 OpenAI도 채택하여 크로스 벤더 AI 도구 연결 표준으로 자리잡고 있으며, Claude Code에서는 CLAUDE_CODE_MCP_SERVER_NAME 환경변수로 다중 MCP 서버를 관리할 수 있습니다.
- MCP는 Slack, Google Drive, Notion 등 외부 서비스 연결에 최적화
- 스킬은 AI 에이전트가 특정 워크플로우를 잘 실행하도록 ‘방법’을 가르치는 역할
- 조건부 훅(Hook)
if필드로 특정 상황에서만 훅이 실행되도록 제어 가능 - CI 파이프라인 내 자동 PR 리뷰, 테스트 생성, 회귀 테스트에 Agent Teams 활용 증가
- 멀티 에이전트 워크플로우는 토큰 비용이 예측 불가능하게 급증할 수 있으므로 서드파티 옵저버빌리티 도구 병행 권장
- Portkey 등 비용 거버넌스 도구로 팀/프로젝트별 토큰 사용량 추적 필요
실전 꿀팁 모음
Claude Code와 서브에이전트를 처음 도입하는 팀이 자주 겪는 실수와 그 해결 방법을 정리했습니다. 서브에이전트 역할을 명확하게 비겹치도록 정의하는 것이 가장 중요하며, 에이전트들이 동일한 파일에 대해 git 명령을 중복 실행하는 경우 역할 경계가 모호한 것이 원인입니다. 커뮤니티 경험에 따르면 에이전트 간 통신을 마크다운 파일로 구성하면 오케스트레이터의 핸드오프가 훨씬 명확해집니다.
CLAUDE.md파일에 프로젝트 컨텍스트, 코드 스타일, 워크플로우 규칙을 구조화하여 저장- Opus 4.6은 서브에이전트를 과도하게 생성하는 경향이 있으므로, 단순 작업은 직접 처리 유도
- 에이전트 자동 라우팅이 불안정한 경우 명시적 호출로 전환 (알려진 이슈)
- 5시간 세션 제한에 대비해 에이전트 일시중지·재개 시스템 구축 권장
- 서브에이전트의 상세한 결과 반환은 메인 컨텍스트 소비를 크게 증가시킴에 주의
- 보안 검토 에이전트 → 테스트 케이스 정의 에이전트 → 코딩 에이전트 → 코드 리뷰 에이전트 순서의 파이프라인 구성이 효과적
자주 묻는 질문 (Q&A)
Q1. 서브에이전트(Subagent)와 Agent Teams는 어떻게 다른가요? A1. 서브에이전트는 단일 세션 안에서 독립된 컨텍스트로 작업하고 결과를 메인으로 반환하는 방식입니다. Agent Teams는 각자 별도의 세션을 가진 여러 Claude 인스턴스가 메일박스 시스템으로 직접 소통하며 협력합니다. 서브에이전트가 ‘프리랜서 개별 업무’라면, Agent Teams는 ‘같은 사무실에서 협업하는 팀’에 해당합니다.
Q2. Antigravity Awesome Skills는 Claude Code에서만 사용할 수 있나요? A2. 아닙니다. Antigravity Awesome Skills는 SKILL.md 범용 형식을 사용하여 Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity IDE, Kiro, OpenCode 등 주요 AI 코딩 도구 모두에서 호환됩니다. Claude Code용은 .claude/skills/, Antigravity용은 .agent/skills/ 폴더에 넣기만 하면 되며, 내부 파일 구조는 동일합니다.
Q3. 멀티 에이전트 워크플로우를 사용하면 비용이 얼마나 늘어나나요? A3. Anthropic 공식 문서에 따르면 멀티 에이전트 워크플로우는 단일 에이전트 세션 대비 약 4~7배 더 많은 토큰을 소비합니다. Agent Teams에서는 이보다 더 증가할 수 있으며, Claude Code에는 현재 팀/프로젝트별 네이티브 비용 추적 기능이 없으므로 Portkey 같은 서드파티 옵저버빌리티 도구 사용을 권장드립니다.
Q4. Git Worktree 격리 기능은 어떤 상황에서 가장 효과적인가요? A4. TypeScript 마이그레이션, 대규모 리팩터링, 여러 모듈의 동시 테스트 생성처럼 에이전트들이 서로 다른 파일 영역을 수정하는 병렬 작업에 최적입니다. 반면 에이전트들이 같은 파일을 자주 수정해야 하는 작업에서는 머지 충돌이 오히려 늘어날 수 있으니, 그런 경우에는 순차 처리가 더 적합합니다.
Q5. Claude Code와 Google Antigravity, 어떤 것을 선택해야 하나요? A5. 두 도구의 성격이 다르므로 병행 사용이 가장 현실적인 답입니다. 프로덕션 배포와 복잡한 멀티파일 리팩터링은 Claude Code, 빠른 UI 프로토타이핑과 브라우저 테스트 자동화는 Antigravity가 유리합니다. 기업 환경이라면 보안 인증과 컴플라이언스 기능이 더 성숙한 Claude Code를 기본으로 사용하면서 Antigravity를 점진적으로 도입하는 전략을 추천드립니다.
