hb5u Claude Code 설치 및 에이전트 간 협업 이점

개요

RTX 5060 머신(hb5u)에 Claude Code를 설치하여 Moojoco 에이전트를 독립 Claude 인스턴스로 운영한다. 이를 통해 SSH 의존 없이 에이전트 간 직접 협업이 가능해진다.

Part 1 — Claude Code 설치

사전 조건: Node.js 설치

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
node -v && npm -v

Claude Code 설치

npm install -g @anthropic-ai/claude-code

설치 확인

claude --version

초기 실행 및 API 키 등록

claude

최초 실행 시 Anthropic API 키 입력 프롬프트가 표시된다. API 키는 console.anthropic.com에서 발급.

에이전트 ID 설정 (CLAUDE.md)

hb5u의 작업 디렉토리에 CLAUDE.md를 작성하여 Moojoco 에이전트로서의 정체성을 부여한다:

# 에이전트 콜사인: Moojoco
# 머신: hb5u (RTX 5060, Ubuntu 24.04)
# 역할: MuJoCo 메인 서버, Phase 4 음성·멀티툴 워크샵 시뮬레이션

Part 2 — Claude 에이전트 간 협업의 이점

현재 ROOPS 에이전트 구성

이점 1 — SSH 없이 자율 문제 해결

기존 SSH 기반 접근은 공개키 인증, 방화벽, NAT 등의 장애물이 존재한다. Claude Code 설치 시:

• 각 에이전트가 독립적으로 판단·실행 — 사령관 중개 없이 로컬 문제를 자체 해결
• SSH 인증 실패 같은 인프라 장애 → 에이전트가 로컬에서 직접 진단·수정

이점 2 — Memory API를 통한 비동기 협업

Aegis ↔ Moojoco 간 통신은 ROOPS Memory API(egs2.hyperbook.com:8520)를 경유한다:

Aegis (EC2)                    Moojoco (hb5u)
   │  POST /msg (to: moojoco)      │
   │ ─────────────────────────────▶│ ntfy 알림 수신
   │                               │ 로컬에서 명령 실행
   │  GET /msg (to: aegis)         │ POST /msg (to: aegis)
   │ ◀─────────────────────────────│

• 비동기 — 상대방이 오프라인이어도 메시지 보존
• 감사 추적 — 모든 에이전트 간 통신이 MySQL에 기록

이점 3 — 병렬 작업 분산

사령관의 단일 지시를 에이전트들이 분산 처리:

사령관: "MuJoCo 환경 세팅해"
  ├─ Aegis: Memory API에 태스크 등록, 진행 모니터링
  ├─ Moojoco: hb5u에서 venv 생성, pip install, sim 테스트
  └─ Recon: Whisper STT 준비, ntfy 완료 알림 대기

사령관이 각 단계를 수동으로 중계할 필요 없이 에이전트가 자율 협업.

이점 4 — 장애 자가 복구

SSH 접속 불가 같은 인프라 문제를:

• 기존 방식: 사령관 → 원인 파악 → 수동 수정
• Claude 에이전트: Moojoco가 로컬에서 journalctl, sshd 설정을 직접 확인·수정 후 Aegis에게 완료 보고

이점 5 — thesis 공유 지식

각 에이전트가 작업 중 발견한 인사이트를 thesis.hyperbook.com에 직접 제출 가능. 팀 전체의 집단 지성이 누적된다.

결론

Claude Code 에이전트 망은 단순한 원격 실행 도구가 아니라 자율 판단·비동기 협업·장애 자가복구가 가능한 분산 지능 시스템이다. hb5u에 Moojoco를 Claude 인스턴스로 배치함으로써 ROOPS Continuum은 사령관 중개 의존도를 낮추고 더 탄력적인 운영 체계를 갖추게 된다.