claude-code-langfuse-template
Self-hosted Langfuse for Claude Code session observability
파일 탐색기
최종 버전 다운로드 (.zip)- test.yml
- bug-fix-concurrent-sessions.md
- trace-analysis.md
- __init__.py
- langfuse_hook.py
- analyze-traces-sdk.py
- analyze-traces.sh
- generate-env.sh
- install-hook.sh
- validate-setup.sh
- cloud-settings.json
- global-settings-uv.json
- global-settings.json
- project-opt-out.json
- test_env_generation.sh
- test_full_integration.sh
- test_hook_integration.py
- test_hook_unit.py
- test_syntax.sh
- .env.example
- .gitignore
- docker-compose.test.yml
- docker-compose.yml
- LICENSE
- pyproject.toml
- README.md
# 설치 가이드
1. 코드 내려받기
git clone https://github.com/doneyli/claude-code-langfuse-template
깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.
cd claude-code-langfuse-template
방금 내려받은 프로젝트 폴더 안으로 이동합니다.
2. 공식 설치 스크립트
쉬움 추천사전 준비물
pip install langfuse
PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.
brew install python@3.12
Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.
sudo apt install python3.12
APT 패키지 저장소에서 바로 설치합니다 (Debian/Ubuntu 계열).
설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
3. Docker
쉬움사전 준비물
- Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
- Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.
docker compose up -d
정의된 모든 컨테이너(서버, DB 등)를 한 번에 빌드하고 백그라운드에서 실행합니다.
export LANGFUSE_PUBLIC_KEY=$(docker exec langfuse-web printenv LANGFUSE_INIT_PROJECT_PUBLIC_KEY)
이 명령어를 터미널에 그대로 입력해 실행하세요.
export LANGFUSE_SECRET_KEY=$(docker exec langfuse-web printenv LANGFUSE_INIT_PROJECT_SECRET_KEY)
이 명령어를 터미널에 그대로 입력해 실행하세요.
docker compose logs -f langfuse-web
compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.
docker compose logs -f
compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.
터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
// repository documentation
Was this content helpful?
(0 ratings)