LunaRoute를 설치하고 사용하려면 어떻게 해야 하나요?

GitHub 릴리스에서 미리 빌드된 바이너리를 다운로드하거나 소스에서 빌드할 수 있습니다. 빠른 시작을 위해 \'lunaroute-server\'를 실행하고 AI 도구의 기본 URL을 http://localhost:8081로 설정하기만 하면 됩니다. API 키나 구성이 필요하지 않습니다.

LunaRoute의 주요 기능은 무엇인가요?

주요 기능으로는 제로 오버헤드 패스스루 모드(~0.1-0.2ms 지연 시간), 포괄적인 세션 기록, 자동 PII 감지 및 수정, 세션 통계 추적, Prometheus 메트릭, 고급 세션 검색 및 세션 검색을 위한 웹 UI가 있습니다.

LunaRoute를 구성하려면 API 키가 필요한가요?

아니요, LunaRoute는 API 키 구성을 필요로 하지 않습니다. 기존 인증과 함께 작동합니다. Claude Code는 헤더를 통해 키를 보내고 Codex CLI는 ~/.codex/auth.json에서 자동으로 읽습니다.

LunaRoute에서 세션 기록은 어떻게 작동하나요?

LunaRoute는 두 가지 기록 모드를 제공합니다. 경량 세션 통계를 위한 SQLite 분석(세션당 ~1-2KB)과 완전한 요청/응답 기록을 위한 JSONL 로그(요청당 ~10KB)입니다. 둘 다 동시에 또는 독립적으로 활성화할 수 있으며 보존 정책 및 PII 수정 옵션이 있습니다.

LunaRoute

WebsiteFreeAI Code Assistant Monitor & Log Management

LunaRoute는 제로 오버헤드 패스스루, 포괄적인 세션 기록 및 강력한 디버깅 기능을 통해 모든 LLM 상호 작용에 대한 완전한 가시성을 제공하는 Claude Code, OpenAI Codex CLI 및 OpenCode와 같은 AI 코딩 도우미를 위한 고성능 로컬 프록시입니다.

웹사이트 방문

이 도구 광고하기

https://github.com/erans/lunaroute?ref=producthunt&utm_source=aipure

개요
대안

제품 정보

업데이트됨:Nov 3, 2025

LunaRoute이란?

LunaRoute는 AI 코딩 도우미를 위해 특별히 설계된 오픈 소스 로컬 프록시로, 개발 도구와 AI 서비스 간의 투명한 브리지 역할을 합니다. 개발자는 성능이나 보안을 저해하지 않고 AI 상호 작용을 모니터링, 디버깅 및 분석할 수 있습니다. 이 도구는 최소한의 구성이 필요합니다. 사용자는 AI 코딩 도우미의 기존 인증 방법과 원활하게 작동하므로 API 키를 제공하지 않고도 몇 초 만에 시작할 수 있습니다.

LunaRoute의 주요 기능

LunaRoute는 LLM 상호 작용에 대한 포괄적인 가시성과 제어 기능을 제공하는 AI 코딩 도우미를 위한 고성능 로컬 프록시입니다. 제로 오버헤드 패스스루 모드, 상세한 세션 기록, PII 보호 및 강력한 디버깅 기능을 제공하며 Claude Code, OpenAI Codex CLI 및 OpenCode와 같은 여러 AI 도우미를 지원합니다. 이 도구는 기본 제공 개인 정보 보호 기능 및 규정 준수 제어를 통해 토큰 사용량, 성능 지표 및 대화 기록을 추적할 수 있도록 합니다.

제로 오버헤드 패스스루 모드: 100% API 충실도로 0.1-0.2ms의 대기 시간만 추가하여 성능에 영향을 주지 않고 요청을 투명하게 프록시할 수 있습니다.

포괄적인 세션 기록: 사용자 정의 가능한 보존 정책 및 PII 보호 기능을 통해 모든 대화, 토큰 및 도구 호출을 JSONL 및 SQLite 형식으로 기록합니다.

고급 PII 감지 및 수정: 저장 전에 여러 수정 모드를 사용하여 이메일, SSN 및 신용 카드와 같은 민감한 정보를 자동으로 감지하고 수정합니다.

실시간 모니터링 및 분석: AI 상호 작용 및 성능 지표를 분석하기 위한 Prometheus 지표, 세션 통계 및 웹 UI를 제공합니다.

LunaRoute의 사용 사례

개발 디버깅: 개발자가 토큰 사용량 및 성능 병목 현상에 대한 가시성을 제공하여 비용이 많이 드는 AI 대화를 추적하고 디버깅할 수 있도록 지원합니다.

팀 협업: 여러 팀 구성원이 서로 다른 API 키를 사용하는 동안 하나의 프록시를 공유할 수 있도록 중앙 집중식 로깅 및 모니터링을 제공합니다.

규정 준수 및 보안: 자동 PII 수정 및 AI 상호 작용에 대한 포괄적인 감사 추적을 제공하여 규제 산업을 지원합니다.

성능 최적화: 자세한 성능 지표 및 분석을 통해 느린 도구 호출 또는 비효율적인 AI 상호 작용을 식별하고 최적화합니다.

장점

밀리초 미만의 오버헤드로 성능에 미치는 영향이 최소화됩니다.

포괄적인 가시성 및 디버깅 기능

강력한 개인 정보 보호 및 규정 준수 기능

구성 없이 쉬운 설정이 가능합니다.

단점

현재 로컬 개발 환경으로 제한됩니다.

웹 UI 기능은 아직 개발 중입니다.

73%의 테스트 커버리지를 개선할 수 있습니다.

LunaRoute 사용 방법

LunaRoute 설치: GitHub 릴리스 페이지에서 최신 릴리스를 다운로드하고 압축을 풉니다. 'tar -xzf lunaroute-server-*.tar.gz' 그런 다음 실행 가능하게 만듭니다. 'chmod +x lunaroute-server'

PATH에 추가(선택 사항): 바이너리를 시스템 경로로 이동합니다. 'sudo mv lunaroute-server /usr/local/bin/'

LunaRoute 서버 시작: 기본 구성으로 시작하려면 'lunaroute-server'를 실행하기만 하면 됩니다. 서버는 8081 포트에서 시작됩니다.

AI 도구 구성: Claude Code의 경우 'export ANTHROPIC_BASE_URL=http://localhost:8081'을 설정합니다. OpenAI Codex CLI의 경우 'export OPENAI_BASE_URL=http://localhost:8081/v1'을 설정합니다.

세션 기록 액세스: 세션은 JSONL 형식으로 ~/.lunaroute/sessions/ 디렉터리에 자동으로 기록되고 SQLite 분석을 위해 ~/.lunaroute/sessions.db에 기록됩니다.

웹 인터페이스 보기: http://localhost:8082에서 내장 웹 UI에 액세스하여 기록된 세션을 탐색하고 분석합니다.

실시간 모니터링: 'tail -f ~/.lunaroute/sessions/$(date +%Y-%m-%d)/session_*.jsonl | jq'를 사용하여 실시간으로 세션을 감시합니다.

PII 보호 구성(선택 사항): 이메일, SSN 및 신용 카드 번호와 같은 민감한 정보를 자동으로 감지하고 수정하려면 구성 파일에 PII 수정 설정을 추가합니다.

메트릭 보기(선택 사항): 요청 속도, 대기 시간, 토큰 사용량 등을 모니터링하려면 http://localhost:8081/metrics에서 Prometheus 메트릭에 액세스합니다.

AI 도구 사용 시작: AI 코딩 도우미를 정상적으로 사용하기 시작합니다. 이제 모든 상호 작용이 완전한 가시성 및 기록과 함께 LunaRoute를 통해 라우팅됩니다.

LunaRoute 자주 묻는 질문

LunaRoute는 Claude Code, OpenAI Codex CLI 및 OpenCode와 같은 AI 코딩 도우미를 위한 고성능 로컬 프록시입니다. 제로 오버헤드 패스스루, 세션 기록 및 디버깅 기능을 통해 모든 LLM 상호 작용에 대한 완전한 가시성을 제공합니다.