시작하기 전에
- ✓Claude Code CLI ↗
- ✓Git이 초기화된 프로젝트
- ✓Node.js 18 이상
- ✓AIFlare 계정·아직 계정이 없다면
API 키 설정
aiflare.dev에서 회원가입 후 프로젝트 설정 → API 키 관리에서 API Key를 생성합니다. 다운로드된 aiflare.yml을 프로젝트 루트에 위치시킵니다.
인스톨러 실행
aiflare.yml을 프로젝트 루트에 둔 상태에서 운영체제에 맞는 명령어를 실행하세요. 인스톨러가 Claude Code 스킬, 훅, MCP 서버, Git pre-push 훅을 자동으로 설정합니다.
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/aiflaredev/aiflare/main/install.js -o install.js && node install.js && rm install.js
Windows (PowerShell, curl.exe — Windows 10 build 1803+)
curl.exe -fsSL https://raw.githubusercontent.com/aiflaredev/aiflare/main/install.js -o install.js; node install.js; del install.js
Windows (PowerShell, Invoke-WebRequest — PowerShell 3.0+)
iwr -useb https://raw.githubusercontent.com/aiflaredev/aiflare/main/install.js -OutFile install.js; node install.js; del install.js
Claude Code에서 /skills 를 입력하면 context-capture가 표시됩니다.
> /skills Project skills (.claude/skills) context-capture
표시되지 않으면 .claude/skills/context-capture/ 디렉토리를 확인하세요.
첫 캡처 확인
Claude Code에게 간단한 작업을 요청하고 커밋하면 끝입니다.
AIFlare는 AI 에이전트가 커밋할 때만 동작합니다. 사람이 직접 git commit을 실행하면 캡처되지 않습니다.
README.md에 프로젝트 설명 한 줄 추가하고 커밋해줘
✓ 대시보드에 타임라인 엔트리가 나타나면 성공입니다!
대시보드에서 타임라인 탐색
캡처된 엔트리는 대시보드 타임라인에 시간순으로 표시됩니다. 각 엔트리에는 커밋의 의도, 변경 요약, 카테고리가 자동으로 기록됩니다.
Added a project introduction at the top of README.md per user request
featureExtracted JWT validation logic into a separate module for testability
refactor타임라인에서 엔트리를 클릭하면 상세 정보를 확인할 수 있습니다.
엔트리 상세 — 관련 프롬프트 확인
타임라인에서 엔트리를 클릭하면 상세 모달이 열립니다. 커밋의 의도, 변경 요약, 변경된 파일을 확인하고, 오른쪽 패널에서 관련 프롬프트(대화 기록)를 볼 수 있습니다.
Added a description of the project's purpose and key features at the top of README.md per user request.
Added a project introduction section at the top of README.md and organized the key feature list
Add a one-line project description to README.md and commit it
I'll add a project description to README.md and commit it.
💡 오른쪽 프롬프트 패널에서 사용자와 AI 간의 대화를 확인할 수 있어, 코드 리뷰 없이도 변경의 맥락을 빠르게 파악할 수 있습니다.
워크세션으로 작업 흐름 파악
사이드바에서 워크세션을 선택하면, 해당 세션에 속한 커밋 목록이 표시됩니다. "프롬프트 보기" 버튼으로 세션 전체 대화를 확인할 수 있습니다.
"프롬프트 보기"를 클릭하면 세션 프롬프트 모달이 열리며, 이 세션에서 사용자와 AI 간의 전체 대화를 확인할 수 있습니다.
💡 워크세션을 통해 하나의 목표를 위해 어떤 단계를 거쳤는지, 전체 맥락을 프롬프트와 함께 파악할 수 있습니다.
프로젝트 설정
API 키 생성/삭제, 멤버 관리, 프로젝트 정보 수정은 프로젝트 설정에서 할 수 있습니다.
문제가 발생했나요?
API Key 오류가 발생해요
aiflare.yml 파일이 프로젝트 루트에 있는지, api_key와 endpoint가 정확한지 확인하세요.
Skill이 인식되지 않아요
.claude/skills/context-capture/ 디렉토리가 프로젝트 루트에 존재하는지 확인하세요.
캡처가 대시보드에 나타나지 않아요
반드시 Claude Code가 커밋하도록 해주세요. aiflare.yml의 endpoint가 올바른지도 확인하세요.
직접 커밋해도 캡처할 수 있나요?
현재는 AI 에이전트가 커밋할 때만 캡처됩니다. Skill은 에이전트의 대화 컨텍스트를 분석하므로 사람의 직접 커밋은 지원하지 않습니다.
AIFlare가 어떻게 동작하는지 궁금하세요? How It Works →