시작하기

Kandela 첫 5분 — 설치부터 첫 기억 회상까지.

1단계 — 베타 가입

Kandela는 현재 베타 운영 중입니다. 접근 권한을 요청하면 이메일로 초대코드를 보내드립니다.

베타 기간 중 모든 계정에 Pro 기능이 무료로 제공됩니다.

2단계 — 설치

2-A. Claude Code 설치 (없는 경우)

Kandela는 Claude Code 위에서 동작합니다. claude --version이 되면 건너뛰세요.

macOS

brew install node
npm install -g @anthropic-ai/claude-code
claude   # Anthropic 계정으로 로그인

Windows (PowerShell)

winget install OpenJS.NodeJS.LTS
npm install -g @anthropic-ai/claude-code
claude   # Anthropic 계정으로 로그인

다음 단계에 Git Bash가 필요합니다.

Git Bash 없으면? PowerShell에서 설치 
winget install --id Git.Git -e --silent

설치 후 시작 메뉴에서 Git Bash를 여세요.

Linux (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
npm install -g @anthropic-ai/claude-code
claude   # Anthropic 계정으로 로그인

2-B. Kandela 설치

명령 한 줄이면 끝. API 키를 물어보고 모든 설정을 자동으로 해줍니다.

macOS / Linux

curl -fsSLk https://kandela.ai/install | bash

Windows (Git Bash)

curl -fsSLk https://kandela.ai/install -o /tmp/ki.sh && bash /tmp/ki.sh

요구사항

  • Claude Code 설치 및 정상 동작 (claude --version)
  • Python 3.8+ (인스톨러 내부에서 사용)
  • Git for Windows (Windows만 해당 — Git Bash 제공)

설치되는 항목

  • MCP 서버 연결 (기억 도구 14개)
  • 라이프사이클 훅 8개 (자동 회상, 자동 저장, 프롬프트 가드 등)
  • 슬래시 명령 22개 (/kd-*)

완전 삭제: curl -fsSLk https://kandela.ai/uninstall | bash

설치 후 Kandela가 Claude Code에 자동으로 연결됩니다. 다음 세션부터 활성화됩니다.

지원 환경

  • Claude Code CLI / Desktop — 전체 지원 (자동 회상, 훅, 슬래시 명령)
  • Claude Code Web (claude.ai/code) — MCP 도구만 사용 가능. 훅과 슬래시 명령은 로컬 환경 필요.
  • Cursor / 기타 MCP 클라이언트 — MCP 도구 동작. .mcp.json으로 설정.

최고의 경험을 위해 Claude Code CLI 또는 Desktop 앱을 사용하세요.

시나리오 1: 첫 세션

프로젝트 디렉토리를 열고 Claude Code를 시작하세요.

cd ~/projects/my-web-app
claude

이 프로젝트에서 Kandela를 초기화합니다:

> /kd-init my_web_app

Kandela가 my_web_app이라는 기억 프로젝트를 생성하고 CLAUDE.md에 설정 블록을 추가합니다. 이 프로젝트의 기억이 세션 간에 유지됩니다.

첫 번째 기억 저장

Kandela의 훅이 백그라운드에서 중요한 컨텍스트를 자동으로 저장합니다. 직접 저장할 수도 있습니다:

> SQLite 대신 PostgreSQL을 사용하기로 결정했어.
  동시 쓰기 지원이 필요해서야. 이거 기억해줘.

무엇을 저장해야 하나요?

저장할 것

  • 왜 SQLite 대신 PostgreSQL을 선택했는지
  • 주의: "마이그레이션은 시딩 전에 실행해야 함"
  • 배포 명령: docker compose up -d
  • API 키 위치: .env에 STRIPE_KEY

생략할 것

  • 파일 구조나 import 경로
  • 함수 시그니처
  • Claude가 코드에서 읽을 수 있는 패턴
  • 저장소에서 명확한 것들

시나리오 2: 다음 세션 — 자동 회상

Claude Code를 닫고 내일 다시 오세요.

cd ~/projects/my-web-app
claude

Kandela의 자동 회상이 자동으로 작동합니다:

[Kandela] Brief recall loaded (3 memories)
- DB: 동시 쓰기를 위해 PostgreSQL 선택
- 주의: 시딩 전에 마이그레이션 실행
- 배포: docker compose -f prod.yaml up -d

요청하지 않아도 자동으로 나타납니다. Claude가 이전 세션의 컨텍스트를 처음부터 알고 있습니다.

대화 중 더 자세한 정보가 필요하면?

> 지난주에 겪었던 데이터베이스 마이그레이션 문제가 뭐였지?

Claude가 Kandela의 context_search를 사용해 찾아줍니다. 특별한 문법 없이 그냥 물어보세요.

시나리오 3: 과거 기억 검색

몇 주 후면 수십 개의 기억이 쌓입니다. Kandela의 하이브리드 검색이 필요한 것을 찾아줍니다.

> 배포 관련 기억을 검색해줘.
[1] 배포: 다른 컨테이너 재시작 방지를 위해 --no-deps 사용 (imp: 9.0)
[2] 스테이징 서버 staging.myapp.com, SSH 포트 2222 (imp: 5.0)
[3] CI/CD: GitHub Actions, main 브랜치 머지 시 자동 배포 (imp: 6.0)

크로스 프로젝트 검색

> 모든 프로젝트에서 Redis 캐싱 설정 방법을 검색해줘.

다른 프로젝트에 저장된 관련 기억도 찾아줍니다.

시나리오 4: 텔레그램으로 기억 관리

텔레그램 봇으로 어디서든 기억을 저장/검색할 수 있습니다. 원격 명령 실행은 준비 중입니다.

30초만에 연결

대시보드 → 계정 → 텔레그램 연결에서 QR 코드를 스캔하면 끝.

텔레그램 기능은 Pro 플랜 이상에서 사용 가능합니다.

상태 확인

/status

활성 프로젝트, 기억 수, 최근 세션, 서버 상태를 한눈에.

메모 저장

기억해: 결제 흐름에서
만료된 세션 처리 필요

이동 중에 아이디어를 기록하세요. 다음 세션에서 /kd-inbox로 전달됩니다.

프로젝트 전환

/project my_backend

활성 프로젝트를 전환합니다.

기억 검색

/search redis 캐싱 설정

텔레그램에서 바로 기억을 검색합니다.

일일 요약

/daily

오늘의 작업 요약. 퇴근 시 리뷰용으로 좋습니다.

원격 명령

/do @my_web_app 실패한
테스트를 수정해줘

에이전트가 명령을 받아 프로젝트에서 실행하고 결과를 텔레그램으로 보내줍니다.

위험 명령 PIN 확인

/do @prod_server 프로덕션 배포

위험한 명령은 PIN 확인 단계를 거칩니다. 60초 내에 PIN을 입력하세요.

시나리오 5: 직접 제어

무엇을 기억할지 직접 지정하고 싶을 때.

중요도 지정 저장

> 중요도 9로 저장해: "프로덕션에서 마이그레이션 전에
  반드시 백업. 3월 3일에 2시간 날렸음."

높은 중요도의 기억은 자동 회상 시 항상 나타납니다.

프로젝트 상태 확인

> /kd-status

현재 프로젝트, 기억 수, 최근 세션, 수신함을 보여줍니다.

다른 프로젝트 기억 로드

> /kd-load my_infrastructure

다른 프로젝트의 배포 규칙, API 키, 주의사항을 크로스 참조합니다.

주의사항(gotcha) 저장

> 주의사항으로 기억해: "docker compose up에서
  --no-deps 없이 하면 모든 컨테이너가 재시작됨."

다음에 배포 명령이 실행될 때 프롬프트 가드가 경고합니다.

수정 또는 삭제

> 스테이징 서버 관련 기억을 검색해줘.
> 그 기억을 수정해 — 스테이징이 staging-v2.myapp.com으로 이동했어.
> 이전 스테이징 서버 관련 기억은 삭제해.

세션 요약

> /kd-update

세션 요약을 저장하고 미저장 결정을 확인합니다.

명령어 요약

명령기능
/kd-init <id>새 프로젝트에 Kandela 초기화
/kd-status현재 프로젝트 상태 확인
/kd-inbox미확인 메모 확인
/kd-list모든 기억 프로젝트 목록
/kd-load <이름>다른 프로젝트 기억 로드
/kd-update세션 요약 저장 + 동기화
/kd-sync캐시된 기억을 서버에 동기화
/kd-progress프로젝트 전체 진행 보고서
/kd-help모든 명령어 도움말

자동으로 작동하는 기능

대부분의 기능은 수동 관리가 필요 없습니다:

세션 시작

이전 세션의 관련 기억을 자동 회상

작업 중

컨텍스트를 모니터링하고 중요한 결정을 자동 저장

실패 시

같은 실수가 반복되지 않도록 주의사항(gotcha) 기록

세션 종료

작업 내용을 요약하고 영구 저장

컨텍스트 압축

컨텍스트 윈도우 압축 전에 핵심 정보를 보존

다음 단계

질문이 있으신가요? kandela.ai를 방문하세요.