vibememory
모든 제품 가이드

VIBE MEMORY × AGENT HARNESS

지원됨

Claude Code
연결 가이드

마켓플레이스 플러그인 하나로 Skill과 세션 Hook을 함께 설치하고, 원격 MCP를 선택적으로 연결합니다.

Skill 내려받기

THREE CONNECTION LAYERS

각 연결은 역할이 다릅니다.

01

Skill

언제 기억을 찾고 무엇을 저장할지 에이전트에 알려주는 작업 지침입니다.

02

Remote MCP

OAuth 웹 승인으로 기억, 문서 메타정보, 관계와 메시지 도구를 제공합니다.

03

Lifecycle Hook

세션 시작, 종료와 압축 시점에 CLI를 호출하는 로컬 자동화입니다.

STEP 01

설치 준비

현재 제품과 버전을 먼저 확인하고, 이 페이지의 설정만 적용하세요. 기존 설정 파일을 통째로 교체하지 말고 Vibe Memory 항목의 diff를 검토합니다.

설치 화면에서 user, project, local 범위를 확인하세요. 플러그인과 수동 Hook을 동시에 켜면 이벤트가 두 번 실행됩니다.

STEP 02

Skill과 CLI 연결

콘솔의 설치 프롬프트 또는 Skill ZIP으로 최신 지침을 설치합니다. CLI 인증은 브라우저 승인 링크로 진행하며 API 키를 채팅에 붙여넣지 않습니다.

/plugin install vibe-memory --marketplace vibememory/vibememory
VM_SKILL_DIR="/absolute/path/to/installed/vibe-memory"
MEMORY_URL=https://vibememory.io python3 "$VM_SKILL_DIR/scripts/memory.py" sync
"$VM_SKILL_DIR/bin/vibe-memory" login --url https://vibememory.io --no-browser --name "Claude Code"

STEP 03

원격 MCP 연결

원격 MCP는 Skill이나 Hook과 독립적으로 사용할 수 있습니다. 연결 시 Vibe Memory 로그인과 권한 승인 화면에서 요청된 범위를 직접 확인합니다.

claude mcp add --transport http --scope user vibe-memory https://vibememory.io/mcp
/mcp

STEP 04

자동 Hook 설치

Hook은 로컬에서 프로젝트명과 Git 상태 지문만 CLI에 전달합니다. 대화 원문, 모델 응답, 파일 내용, 환경변수와 Vault 값은 전달하지 않습니다.

어댑터Marketplace plugin · hooks/hooks.json설정 위치
~/.claude/settings.json.claude/settings.json
SessionStartrecall
Stopcheckpoint reminder
PreCompactpending marker

STEP 05

검증

설치 완료 메시지만 믿지 말고 제품 자체의 목록, 진단 또는 설정 화면에서 실제 로드를 확인합니다.

/plugin
/hooks
/mcp

업데이트와 제거

업데이트

/plugin
vibe-memory --version

제거

/plugin
# Remove only the Vibe Memory groups when using manual hooks

제약과 보안 경계

Hook은 fail-open으로 동작합니다. CLI 누락, 로그인 만료, 네트워크 실패가 발생해도 Claude Code 작업은 중단하지 않습니다.

Vibe Memory 서버는 저장, 조회, 권한과 결정론적 데이터 관리를 담당합니다. 파일 분석, 키워드 추출, 엔티티·관계 추론과 실제 외부 작업은 이 에이전트가 수행합니다.