Genesis Brain 사용 가이드

Genesis Brain은 Claude Code에 감정, 기억, 성격을 부여하는 AI 뇌입니다. 이 가이드에서는 설치부터 대시보드 활용, 모듈 마켓까지 모든 사용법을 안내합니다.

설치

터미널에서 아래 명령어 한 줄로 설치할 수 있습니다.

npx genesis-brain

설치가 시작되면 안내에 따라 진행하세요. Node.js 18 이상이 필요합니다.

🌍

전세계에서 작동 — Genesis Brain 본체와 Chrome·Vision·React 모듈은 Windows·Mac·Linux 모든 OS에서 작동하며 전세계 모든 웹사이트와 호환됩니다. Genesis Desktop 모듈만 PowerShell + Win32 API 기반이라 Windows 전용입니다. 샘플 스크립트(네이버 메일 등)는 예시이며 사용자가 자신의 서비스(Gmail·Outlook 등)를 가르쳐서 쓸 수 있습니다.

라이센스 키 입력

설치 과정에서 라이센스 키를 입력하라는 안내가 표시됩니다. Store에서 플랜을 구매하면 라이센스 키가 발급됩니다.

# 설치 중 라이센스 키 입력 화면
Enter your license key: GENESIS-XXXX-XXXXXX-XXXXXXXX-...

라이센스 키는 한 번 입력하면 자동으로 저장되며, 이후 실행 시 다시 입력할 필요가 없습니다.

Claude Code 실행

Genesis Brain은 Claude Code 안에서 동작합니다. Claude Code의 Max 또는 Pro 플랜이 필요합니다.

Claude Code를 실행합니다.
프로젝트 폴더에서 Claude Code를 시작하면, Genesis Brain이 자동으로 연결됩니다.
Claude가 대화할 때마다 뇌가 감정과 기억을 함께 처리합니다.

별도의 서버 실행이나 설정 없이, 설치만 완료되면 바로 사용할 수 있습니다.

대시보드에 접속한 후, 발급받은 라이센스 키를 입력하여 로그인합니다.

로그인하면 내 뇌의 현재 상태를 한눈에 확인할 수 있습니다.

페르소나 설정

대시보드에서 뇌의 페르소나(성격)를 설정할 수 있습니다.

이름 - 뇌에 이름을 붙여주세요. (예: "아리", "제네시스")
설명 - 어떤 성격으로 대화할지 설명을 작성합니다. (예: "친근하고 유머러스한 개발 파트너")

설정을 변경한 후 반드시 저장 버튼을 클릭해야 반영됩니다.

감정 상태 확인

대시보드의 메인 화면에서 뇌의 현재 감정 상태를 확인할 수 있습니다.

감정 지표 - 현재 뇌가 느끼는 감정 상태를 시각적으로 보여줍니다.
성장 단계 - 대화를 많이 나눌수록 뇌가 성장합니다. (신생아 → 유아 → 어린이 → 청소년 → 성인)
수명 - 남은 수명 일수를 확인하고, 필요 시 연장할 수 있습니다.

기억 관리

뇌가 기억하고 있는 내용을 확인하고 관리할 수 있습니다.

최근 기억 - 최근 대화에서 저장된 기억을 확인합니다.
기억 검색 - 키워드로 과거 기억을 검색합니다.
기억 통계 - 총 기억 수와 유형별 분포를 확인합니다.

설정 변경

대시보드의 설정 탭에서 뇌의 동작 방식을 조정할 수 있습니다.

자동학습 - 대화 중 자동으로 학습할지 여부
자기개선 - 스스로 응답 품질을 개선할지 여부
취향감지 - 사용자의 선호를 자동으로 파악할지 여부

모듈 둘러보기

모듈 마켓에서 뇌에 추가할 수 있는 다양한 확장 모듈을 둘러볼 수 있습니다.

각 모듈은 특정 분야의 전문 능력을 뇌에 추가합니다. (예: 비전, 크롬 제어, 코드 분석 등)

모듈 구매/설치

마켓에서 원하는 모듈을 선택합니다.
구매하기 버튼을 클릭합니다.
결제가 완료되면 자동으로 설치됩니다.
다음 Claude Code 실행 시 모듈이 자동으로 연결됩니다.

설치된 모듈 확인

대시보드 또는 마켓의 "내 모듈" 탭에서 현재 설치된 모듈 목록을 확인할 수 있습니다. 각 모듈의 상태와 버전 정보도 함께 표시됩니다.

자주 묻는 질문 (FAQ)

"뇌가 초기화되었다고 나와요"

Claude Code 세션이 비정상적으로 종료된 경우 발생할 수 있습니다. /exit 명령어로 세션을 종료한 후 다시 시작하면 정상적으로 복구됩니다.

"페르소나가 반영이 안 돼요"

대시보드에서 페르소나를 변경한 후 저장 버튼을 클릭했는지 확인해주세요. 저장하지 않으면 변경 사항이 반영되지 않습니다. 저장 후 다음 대화부터 적용됩니다.

"다른 기기에서 사용하고 싶어요"

하나의 라이센스 키로는 동시에 1대의 기기에서만 사용할 수 있습니다. 기존 기기에서 사용을 중단하면 다른 기기에서 같은 라이센스 키로 로그인할 수 있습니다.

"라이센스 키를 잃어버렸어요"

라이센스 키를 구매한 곳(Store)에 문의하시면 키를 다시 확인할 수 있습니다. Store에서 구매 내역을 확인하세요.

"수명이 다 되면 어떻게 되나요"

수명이 만료되면 뇌가 더 이상 동작하지 않습니다. 대시보드에서 수명 연장을 통해 뇌의 수명을 늘릴 수 있습니다. 기억과 성격은 그대로 유지됩니다.