설치 단계
- CodeTracker 웹사이트에 로그인
- 대시보드에서 새 프로젝트 생성
- 프로젝트 목록에서 환경 설정 버튼 클릭
대시보드에서 환경 설정 버튼을 클릭하면 아래와 같은 모달이 나타납니다.
환경 설정 모달 미리보기
버튼을 클릭하여 실제 모달 화면을 확인해보세요.
모달에서 명령어 복사 버튼을 클릭하면 다음 단계로 진행하세요.
위 모달에서 복사한 명령어를 사용합니다.
터미널에서 프로젝트 루트 디렉토리로 이동 후 붙여넣기:
cd your-project
# Ctrl+V (Windows) 또는 Cmd+V (Mac)로 붙여넣기 후 Enter설치가 완료되면 다음과 같은 메시지가 표시됩니다:
🚀 CodeTracker 설치를 시작합니다...
📋 감지된 아키텍처: ARM64
📥 파일 다운로드 중... (플랫폼: darwin-arm64)
📦 파일 압축 해제 중...
🔧 실행 권한 설정 중...
✅ CodeTracker 설치 완료!
📁 설치된 파일:
.codetracker/config.json
.codetracker/credentials.json
.claude/settings.json
.claude/hooks/user_prompt_submit
.claude/hooks/stop
💡 Claude Code를 실행하면 자동으로 CodeTracker가 활성화됩니다.프로젝트의 .gitignore 파일에 다음을 추가하세요:
# CodeTracker
.codetracker/credentials.json
.codetracker/cache/주의: credentials.json은 절대 Git에 커밋하지 마세요!
Claude Code를 실행하여 정상 동작을 확인하세요:
claude간단한 프롬프트를 입력:
Create a new file called test.txt with "Hello World"웹 대시보드에서 AI 인터랙션이 기록되었는지 확인하세요.
CodeTracker 삭제
CodeTracker를 프로젝트에서 완전히 제거하려면 프로젝트 루트 디렉토리에서 아래 명령어를 실행하세요.
Mac / Linux:
rm -rf .claude .codetrackerWindows (PowerShell):
Remove-Item -Recurse -Force .claude, .codetracker -ErrorAction SilentlyContinue이 명령어는 모든 CodeTracker 설정과 캐시 파일을 삭제합니다. 대시보드의 프로젝트 데이터는 유지됩니다.
지원 플랫폼
| 운영체제 | 아키텍처 | 자동 감지 |
|---|---|---|
| Mac | Intel (x64) | |
| Mac | Apple Silicon (ARM64) | |
| Linux | x64 (amd64) | |
| Linux | ARM64 | |
| Windows | x64 |
Mac과 Linux에서는 uname -m 명령으로 아키텍처를 자동 감지합니다.
문제 해결
문제: Claude Code를 사용해도 인터랙션이 기록되지 않음
1. 실행 권한 확인 (Mac/Linux):
ls -la .claude/hooks/-rwxr-xr-x와 같이 실행 권한(x)이 있어야 합니다.
2. 바이너리 실행 테스트:
./.claude/hooks/user_prompt_submit --help3. 재설치:
대시보드에서 환경 설정 > 명령어 복사 후 다시 실행
문제: 데이터가 서버에 저장되지 않음
credentials.json 확인:
cat .codetracker/credentials.jsonapi_key와 current_project_hash가 있는지 확인
문제: Windows에서 바이너리 실행이 차단됨
해결 방법:
- Windows Defender 경고창에서 "추가 정보" 클릭
- "실행" 버튼 클릭