TL;DR

Claude Scholar는 Claude Code를 주된 실행 환경으로 삼아 Zotero MCP와 Obsidian Vault를 결합한 반자동 연구 어시스턴트이다. 스킬·에이전트·명령 구조로 아이데이션에서 논문 작성까지의 파이프라인을 구성하고 evidence gate와 claim ledger로 주장의 승격을 통제하며 결과물은 파일시스템 기반으로 영구 저장된다. 설치기는 기존 사용자 파일을 보존하는 백업-친화적 설계를 채택하며 Codex CLI·Kimi Code·OpenCode 브랜치를 통해 여러 CLI 생태계에 네이티브 지원을 제공한다. 이로 인해 문헌 수집·실험 분석·보고서 생성 과정을 추적 가능하고 재현 가능한 방식으로 통합할 수 있으나 settings.json 병합과 규칙 설치는 수동 작업이 필요하다.

주요 기능

• Zotero 통합은 DOI·arXiv·URL 기반의 배치 임포트와 컬렉션 단위 읽기 흐름을 자동화하고 풀텍스트가 가능할 때는 PDF를 연결하며 메타데이터 동기화를 통해 문헌 기반 근거를 추적한다. 관련 명령으로는 /zotero-review와 /zotero-notes가 있으며 MCP 설정을 통해 전체 파이프라인을 안전하게 연결할 수 있다. 이 통합은 문헌을 Sources 컬렉션으로 라우팅하고 후속 문헌 노트가 Knowledge 또는 Writing으로 승격되는 정책을 유지한다.
• Obsidian 바인딩은 프로젝트별 Vault를 사용해 Sources, Knowledge, Experiments, Results, Writing 등의 디렉터리 구조로 결과물을 영구 저장하고 링크·인덱스·Daily 노트를 결정적 명령으로 동기화한다. /kb-init과 /kb-sync 같은 명령이 존재하며 레포와 Vault 간의 바인딩은 노트 언어 설정과 레지스트리 파일을 통해 구성된다. 이 방식은 transient 채팅 컨텍스트 대신 파일 기반 산출을 우선시하여 추적성과 재현성을 확보한다.
• 실험 분석 파이프라인은 로그와 메트릭 파일을 읽고 블로커-퍼스트 정책으로 단위 분석, 주요 지표, 시드/폴드/런의 출처를 고정한 뒤 통계 검정과 과학적 그림을 생성한다. /analyze-results는 t-test·ANOVA·Wilcoxon 같은 검정 옵션을 지원하며 결과는 figure-catalog와 분석 리포트 형태로 출력된다. 이러한 산출물은 Results/Reports에 저장되어 이후 논문의 증거 자료로 즉시 활용될 수 있다.
• 설치 프로그램은 백업-친화적이며 기존 CLAUDE.md 파일을 보존하고 repo-managed 사이드카 파일을 생성하여 안전하게 설치 상태를 관리한다. 설치 과정에서 덮어쓰기된 파일은 타임스탬프 기반 백업 디렉터리에 보관되며 설치 상태는 ~/.claude/.claude-scholar-install-state 파일에 기록된다. 이 메커니즘은 사용자의 기존 환경을 손상시키지 않으면서 선택적 업데이트와 안전한 제거를 가능하게 만든다.

어떻게 동작하는가

Claude Scholar는 스킬, 에이전트, 명령의 조합으로 동작하며 각 스킬은 명확한 트리거와 출력 규약을 가진 플러그형 모듈이다. 플랫폼별 브랜치를 통해 Claude Code·Codex CLI·Kimi Code·OpenCode 환경을 네이티브 방식으로 지원하며 런타임 훅이 세션 시작·종료·보안 체크를 삽입하여 자동화된 감독을 수행한다. 근거 승격(evidence gate)·claim ledger·planning-with-files 같은 내부 규약이 주장 승격과 프로젝트 지속성을 보장하여 임시 노트가 영구 지식으로 잘못 승격되는 것을 방지한다.

해결 문제

Claude Scholar는 연구 워크플로가 문헌 수집, 실험 추적, 분석 산출, 글쓰기까지 여러 도구와 수작업으로 분절되는 문제를 해결한다. 이 레포는 Zotero MCP와 파일시스템 기반 Obsidian Vault를 연결하여 논문·데이터·분석 산출을 추적 가능한 위치에 영속화하고 Claim Promotion Gate로 증거 적합성을 유지한다. 또한 훅과 규칙 시스템으로 세션·커밋·안전 정책을 검증하여 자동화 과정에서 발생할 수 있는 위험을 줄인다.

지금 주목받는 이유

이 프로젝트는 Claude Code 생태계의 확산과 연구자 대상 워크플로 자동화에 대한 수요 증가가 맞물려 주목을 받는다. 최근 추가된 Kimi Code 브랜치와 Zotero MCP 통합, Nature 스타일 글쓰기 스택 같은 업데이트들이 커뮤니티 채택을 촉진했다. 또한 설치·업데이트·언인스톨의 안전성 개선으로 실제 실무 환경에서 적용 가능성이 높아졌다.

차별점

• 근거 승격과 Claim Ledger는 단순한 스크립트 수준의 자동화와 구별되며 증거 강도와 출처를 기준으로 노트의 승격을 제어한다. 이 메커니즘은 임시 관찰을 영구 지식으로 오인하지 않게 하며 추적 가능한 감사 로그를 남긴다. 연구 재현성과 주장의 검증가능성을 작업 흐름 차원에서 확보하는 점이 핵심 차별점이다.
• 플랫폼별 브랜치 구성과 백업-친화적 설치기는 Claude Code, Codex CLI, Kimi Code, OpenCode 같은 서로 다른 CLI 생태계에서 동일한 워크플로를 재현 가능하게 만든다. 설치 스크립트는 기존 파일을 덮어쓰지 않고 사이드카를 생성하며 설치 상태 파일로 안전한 제거를 지원한다. 이러한 설계는 여러 도구가 혼재한 연구 환경에서 충돌을 최소화한다.
• 결론 우선 규약을 강제하는 expression-skill은 보고서와 응답 텍스트의 가독성과 검증가능성을 높이고 후속 자동화 단계와의 명확한 인터페이스를 만든다. 이 규약은 출력이 체크리스트·경로·관찰 가능한 증거 항목을 포함하도록 유도하여 기계적 산출의 실용성을 높인다. 결과적으로 인간 결정권을 유지하면서 반복적 작업을 기계가 견고하게 수행하도록 균형을 잡았다.

사용 사례

• 새로운 연구 주제를 빠르게 정교화하고 문헌 기반의 가설 목록과 검증 계획을 생성하는 초기 아이데이션 단계에 활용할 수 있다. /research-init 명령과 research-ideation 스킬은 주제에서 구체적 질문과 증거 필요항목을 자동으로 추출하여 Zotero 컬렉션으로 연결한다. 이 흐름은 문헌 기반 초기 설계와 실험 계획 수립을 일관성 있게 만든다.
• 실험 결과를 구조화된 분석 번들로 전환하고 통계 검정을 수행하여 보고 가능한 산출물을 생성하는 데 사용할 수 있다. /analyze-results는 블로커-퍼스트 정책으로 단위 분석과 비교 가족을 고정하고 t-test·ANOVA·Wilcoxon 같은 검정을 적용하여 결과 신뢰도를 확보한다. 생성된 figure-catalog와 analysis-report는 Obsidian Results/Reports로 바로 저장되어 논문 작성에 즉시 연결된다.
• 저자 응답서, 논문 초안, 템플릿 정리와 같은 출판 준비 전 과정에서 산출물의 품질 보증과 스타일 정리를 지원한다. nature-writing·nature-polishing 스킬은 저널 스타일에 맞춘 문장 구조와 데이터 가용성 선언을 준비하여 제출 전 점검 프로세스를 단축한다. 또한 paper-self-review 스킬은 구조·논리·인용을 재현 가능하게 점검하는 체크리스트를 제공한다.

시작하기

기본 설치는 레포를 클론한 뒤 제공된 setup.sh를 실행하는 방식으로 시작된다. 전체 설치는 git clone과 bash scripts/setup.sh 실행으로 이루어지며 설치 과정에서 기존 CLAUDE.md 파일은 보존되고 백업이 생성된다. 최소 설치나 선택적 설치는 필요한 훅과 스킬만 홈 디렉토리로 복사하는 방식으로 진행할 수 있으며 settings.json 같은 구성 파일은 수동으로 병합해야 정상 동작한다.

요구사항

• 기본적으로 Claude Code 환경이 필요하며 Git이 설치되어 있어야 한다. 추가 통합을 원할 경우 Zotero와 Obsidian 설치가 권장되며 Zotero MCP를 구성하면 자동 문헌 파이프라인을 완성할 수 있다. Python 개발을 위해선 선택적으로 Python과 uv가 요구될 수 있으며 플랫폼별 브랜치를 사용하려면 해당 CLI의 권장 설정을 따라야 한다.