Buzz 플랫폼에 Claude Code, Codex, Antigravity 연동 및 멀티 AI 에이전트 팀 구축
Buzz 플랫폼에 Claude Code, Codex, Antigravity 연동 및 멀티 AI 에이전트 팀 구축 완벽 가이드
Jack Dorsey의 Buzz 플랫폼에 3가지 AI CLI 엔진을 하네스(Harness)로 등록하고 실전 멀티 에이전트 개발 환경을 구축하는 방법
Buzz는 메시징 및 팀 채널 인터페이스를 담당하고, 실제 AI 수행은 로컬 머신의 **Local Relay**를 통해 터미널 CLI 도구(Agent Harness)를 호출하여 처리합니다.
따라서 각 CLI 엔진을 로컬에 개별 설치한 후, Buzz의 harnesses.json 파일에 엔진을 등록하면 한 채널에서 서로 다른 AI 모델들을 자유롭게 조합할 수 있습니다.
1단계: 필수 CLI 엔진 로컬 설치 및 인증
터미널(Terminal / PowerShell)을 열고 Buzz에서 구동할 3가지 AI CLI 도구를 각각 설치합니다.
① Claude Code CLI 설치
# Anthropic Claude Code 글로벌 설치
npm install -g @anthropic-ai/claude-code
# 계정 로그인 및 인증
claude login
② OpenAI Codex CLI 설치 및 API Key 설정
# OpenAI Codex CLI 패키지 설치
npm install -g @openai/codex-cli
# 환경 변수에 API Key 등록 (macOS/Linux)
export OPENAI_API_KEY="sk-proj-your-openai-key-here"
# PowerShell (Windows)의 경우:
# $env:OPENAI_API_KEY="sk-proj-your-openai-key-here"
③ Antigravity CLI SDK 설치
# Antigravity 에이전트 실행 엔진 설치
pip install antigravity-sdk
# 환경 변수에 API Key 등록 (macOS/Linux)
export ANTIGRAVITY_API_KEY="ag-your-antigravity-key-here"
2단계: Buzz 플랫폼 및 Local Relay 설치
Buzz 리포지토리를 클론하고 로컬 통신용 Relay 서버를 가동합니다.
# Claude Code를 통해 Buzz 자동 설치 또는 직접 클론
claude "install and setup Buzz repository on local machine"
# 설치 완료 후 로컬 릴레이(Local Relay) 프로세스 실행
buzz relay start --port 8080
Buzz를 처음 구동할 때 생성되는 Identity Key는 별도의 비밀번호 없이 계정을 복구하고 모바일 앱과 페어링할 때 사용되는 암호화 키입니다. 반드시 안전한 곳에 백업해 두세요.
3단계: Buzz 하네스(Harness) 설정 파일 수정
Buzz가 로컬 터미널의 claude, codex, antigravity 명령어를 스폰(Spawn)할 수 있도록 설정 파일에 커스텀 하네스를 정의합니다.
설정 파일 경로: ~/.buzz/harnesses.json (또는 Windows: %USERPROFILE%\.buzz\harnesses.json)
{
"default_harness": "claude-code",
"harnesses": {
"claude-code": {
"name": "Claude Code Engine",
"command": "claude",
"args": ["--mode", "agent", "--model", "claude-3-7-sonnet"],
"env": {
"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_KEY"
}
},
"codex-engine": {
"name": "OpenAI Codex Engine",
"command": "codex",
"args": ["--interactive", "--model", "code-davinci-002"],
"env": {
"OPENAI_API_KEY": "YOUR_OPENAI_KEY"
}
},
"antigravity-engine": {
"name": "Antigravity Agent Engine",
"command": "antigravity",
"args": ["run", "--auto-context"],
"env": {
"ANTIGRAVITY_API_KEY": "YOUR_ANTIGRAVITY_KEY"
}
}
}
}
4단계: Buzz 앱에서 에이전트별 전문 역할 및 하네스 할당
Buzz 앱 UI의 **Agents** 탭으로 이동하여 각 AI 에이전트의 페르소나와 하네스를 연결합니다.
| 에이전트 이름 | 지정 하네스 (Harness) | 담당 역할 (Role & Specialty) |
|---|---|---|
| Fizz | claude-code |
전체 시스템 설계, 리팩토링 및 코드 품질 검수 |
| Honey | codex-engine |
알고리즘 작성, 데이터 파싱 함수 및 단위 테스트 작성 |
| Bumble | antigravity-engine |
Git 리포지토리 파싱, 환경 구성 및 CI/CD 워크플로우 제어 |
5단계: 실전 활용 및 협업 워크플로우
실나리오 A: Git 프로젝트 등록 및 채널 자동 생성
Buzz 대화창에서 로컬 개발 프로젝트 경로를 지정하면, 에이전트가 리포지토리를 인식하고 프로젝트 전용 채널을 생성합니다.
@Bumble ~/projects/my-weather-app 프로젝트를 Buzz Project로 등록하고, main 브랜치를 체크아웃한 뒤 전용 채널을 만들어줘.
실나리오 B: 멀티 에이전트 교차 지시 (Cross-Agent Call)
프로젝트 채널에서 3개의 에이전트를 동시 태그하여 각자의 특화된 엔진으로 분업 과제를 수행하도록 지시합니다.
@Honey @Fizz @Bumble
- @Honey (Codex): src/parser.py 에 대용량 파싱 알고리즘 함수를 추가해주세요.
- @Fizz (Claude Code): 작성된 파싱 알고리즘을 검토하고 성능 최적화를 진행해주세요.
- @Bumble (Antigravity): 파싱 결과가 기존 빌드 환경과 충돌하지 않는지 테스트를 구동해주세요.
실나리오 C: 음성 허들(Huddle) 및 모바일 페어링
- Voice Huddle: 상단의 🎧 Huddle 아이콘을 눌러 Honey(Codex) 또는 Fizz(Claude Code)와 직접 음성 통화로 요구사항을 전달하면, 대화 내용이 트랜스크립트로 자동 남습니다.
- Mobile Pairing:
Settings > Mobile에서 발급되는 Pairing Code를 스마트폰 앱에 입력하면 외부에서도 로컬 PC의 에이전트 팀과 실시간 소통할 수 있습니다.
Buzz 커뮤니티 데이터는 서버에 보관되지만, 에이전트 실행 엔진(CLI)은 로컬 PC가 켜져 있을 때만 반응합니다. PC를 꺼도 지속 작동하게 하려면 AWS / DigitalOcean 등 VPS(가상 전용 서버) 환경에 buzz relay와 CLI 스택을 배치하는 것을 권장합니다.
요약 및 결론
Buzz 플랫폼을 활용하면 단일 AI에 의존하는 대신, 코드 작성 성능이 뛰어난 Codex, 심도 깊은 리팩토링 및 아키텍처에 강한 Claude Code, 자율적 시스템 제어가 가능한 Antigravity의 장점만을 조합하여 최상의 개발 에이전트 팀을 구성할 수 있습니다.
댓글
댓글 쓰기