agarwalvishal/claude-chat-exporter

One-click, privacy-first exporter for Claude.ai chats — clean Markdown with artifacts and attachments, ready for Obsidian and RAG.

Claude Chat Exporter – 무엇인가요

Claude.ai에서 진행한 모든 대화를 깔끔한 Markdown 파일로 다운로드할 수 있는 작고 오픈소스의 브라우저 스크립트입니다. 완전히 브라우저 내에서 실행되며(서버 없음), Claude의 사내 API에서 직접 생성된 원시 Markdown을 가져와 로컬에 저장합니다.

왜 존재하는가

웹 UI는 긴 대화의 일부만 표시하며, 복사 버튼에 취약한 CSS 선택자에 의존합니다.
UI를 통한 내보내기는 아티팩트, 파일, 차트, 첨부 파일을 놓칠 수 있습니다.
Obsidian이나 검색 증강 생성(RAG) 파이프라인과 같은 지식 기반 도구에서는 구조화되고 메타데이터가 풍부한 Markdown 문서가 필요합니다.

핵심 기능

기능	얻을 수 있는 것
한 번 클릭 북마크릿	버튼을 북마크 바에 드래그하고, Claude 대화를 열어 클릭하면 `.md` 파일이 자동으로 다운로드됩니다.
완벽한 Markdown 충실도	API에서 원본 Markdown을 읽기 때문에 HTML 변환 없이, 테이블, 수식, 코드 등이 바이트 단위로 정확합니다.
모든 요소 지원	테이블, LaTeX 수식, 코드 블록, 중첩된 목록, 링크, 제목, 아티팩트, 생성된 파일, 차트/다이어그램( fenced code로), 모든 첨부 파일.
Obsidian 및 RAG 준비 출력	YAML 프론트마터(`title`, `source`, `model`, `exported`)에 더해 각 턴에 `# Human` / `# Claude` 헤더를 추가하여 노트 작성이나 검색용 청크화에 이상적입니다.
타임스탬프	Claude의 API에서 가져온 메시지별 타임스탬프.
스마트 파일명	API에서 가져온 대화 제목 사용(백업: `claude_conversation.md`).
프라이버시 우선	백엔드 없음, 추적 없음; 유일한 네트워크 요청은 Claude의 자체 API에 대한 인증된 호출입니다.
UI 변경에 강건함	CSS 선택자가 아니라 안정적인 데이터 계약에 기반해 작동합니다.

작동 방식 (요약)

가져오기 – GET /api/organizations/{orgId}/chat_conversations/{conversationId} 호출 (동일 출처, 세션 쿠키 사용). 응답에는 대화 제목, 모델, 모든 메시지가 포함됩니다.
순서 정리 – current_leaf_message_uuid에서 parent_message_uuid 링크를 따라 위로 탐색하여 현재 브랜치를 재구성한 후 리스트를 역순으로 만듭니다.
추출 – 각 메시지의 content 블록을 순서대로 반복하며, 원시 text 블록을 출력하고 특수 tool_use 블록(아티팩트, create_file, visualize 위젯)을 레이블이 붙은 fenced code로 렌더링합니다.
Markdown 생성 – YAML 프론트마터를 앞에 추가하고, 각 턴에 # Human — … / # Claude — … 헤더를 추가, 타임스탬프 삽입, 첨부 파일(이미지는 내장, 텍스트 파일은 블록 인용, 기타 문서는 링크)을 배치합니다.
다운로드 – 조립된 .md 파일을 브라우저 다운로드로 트리거합니다.

사용 방법

북마크릿 – 설치 페이지에 방문하여 "📥 Claude Export" 버튼을 북마크 바에 드래그하고, Claude 대화를 열어 북마크를 클릭합니다. 스크립트는 자동으로 업데이트됩니다.
콘솔 모드 – claude-chat-exporter.js 소스를 복사하여 Claude 대화 페이지의 브라우저 개발자 콘솔에 붙여넣고 Enter를 누릅니다. 스크립트는 작은 상태 박스를 표시한 후 파일을 다운로드합니다.

프라이버시 및 보안

완전히 클라이언트 측에서 실행되며, 저자의 서버로는 어떤 데이터도 전송되지 않습니다.
유일한 네트워크 요청은 웹 UI가 이미 수행하는 것과 동일한 인증된 Claude 백엔드 GET 요청입니다.
다운로드 후 데이터는 저장되지 않으며, 북마크릿의 업데이트 확인은 공개 스크립트 파일만 가져옵니다.

제한 사항

로그인 중인 Claude 웹 UI에서만 작동합니다.
Claude의 비공개 내부 API에 의존합니다 – 브레이킹 변경이 발생하면 스크립트 업데이트가 필요합니다.
이진 첨부 파일 데이터(이미지/PDF)는 내보내지 않으며, 링크만 제공하고 일부 도구 호출(웹 검색, bash 등)은 건너뜁니다.
브라우저에서 JavaScript가 활성화되어 있어야 합니다.

누가 사용할 수 있을까

Claude 세션의 재현 가능한 기록이 필요한 연구자나 개발자.
Obsidian, Notion 등과 같은 도구를 사용해 지식 기반을 구축하는 사람.
깨끗하고 타임스탬프가 있는 메타데이터가 풍부한 Markdown이 필요한 RAG 파이프라인을 구축하는 사람.

프로젝트는 MIT 라이선스이며 저자에 의해 유지 관리됩니다. 후원은 Claude의 진화하는 API에 맞춰 최신 상태로 유지하는 데 도움이 됩니다.