TL;DR

  • use-citations는 Claude Code가 정부 웹사이트나 로컬 파일을 바탕으로 답변하고, 모든 인용문을 저장된 원문과 단어 단위로 대조하는 Claude Code 스킬임
  • 계약서·세법·법령·임상 지침·연구 논문·회사 정책처럼 답변의 근거 위치를 확인해야 하는 질문에 각 문장을 원문 구절과 연결함
  • 별도 검증 프로그램이 인용문을 찾지 못하면 답변을 표시하지 않으며, 34개 공개 질문에서 인용된 372개 구절이 모두 원문에서 확인됨
  • 보고서에는 수집된 문서와 저장 시점, Claude가 실행한 검색, 반증을 찾은 검색, 답변이 다루지 못한 내용, 후속 질문별 출처가 포함됨
  • 인용문 자체는 검증하지만 평이한 문장이 원문을 공정하게 요약했는지와 문서 외 지식에 의존했는지는 검증하지 않으므로 원문 구절을 직접 확인해야 함

use-citations 소개

  • Claude Code에 연구 질문을 입력하면 정부 사이트나 컴퓨터의 파일 등 출처를 저장한 뒤, 평이한 영어 답변과 각 문장의 근거 구절 링크를 제공하는 스킬임
  • 답변이 표시되기 전에 별도 프로그램이 근거 구절을 실제 문서에서 단어 그대로 검색함
  • 인용문을 찾지 못하면 문제가 해결될 때까지 답변을 표시하지 않음
  • 적용 대상은 계약서, 세법, 법령, 임상 지침, 연구 논문, 회사 정책 등 답변의 출처를 정확히 확인해야 하는 질문임

설치

  • Claude Code와 Python 3.10 이상이 필요하며, 지원 환경은 Mac 또는 Linux임
  • Claude Code를 시작한 뒤 다음 저장소의 스킬 설치를 요청하는 방식으로 설치 가능함: https://github.com/sshah03/use-citations
  • 설치 요청 시 Claude가 스킬을 내려받고 설정한 뒤 작동 여부를 확인하며 사용법을 안내함
  • 설치 과정은 저장소의 AGENTS.md에서 먼저 확인 가능함
  • 직접 설치하려면 저장소를 ~/.claude/use-citations에 복제하고, ~/.claude/skills를 만든 뒤 스킬 디렉터리의 심볼릭 링크를 생성해야 함
  • Python 버전은 python3 --version으로 확인 가능하며, Python이 없는 Mac에서는 python.org에서 설치 가능함
  • 업데이트는 git -C ~/.claude/use-citations pull 명령으로 수행함

사용법

  • 터미널에서 claude를 입력해 Claude Code를 시작한 뒤 /use-citations와 질문을 입력함
  • 예시 질문은 다음과 같음
  • /use-citations Is there an age limit on claiming my child as a dependent?
  • /use-citations follow-up Does my child have to live with me?
  • /use-citations follow-up dependent-age-2025 What if we're divorced?
  • /use-citations The contracts are in ~/Documents/orion-contracts. How much notice does the customer have to give to cancel?
  • 자체 문서 폴더를 지정하거나 질문만 입력할 수 있으며, 스킬이 공식 온라인 출처를 찾아 각 문서의 사본을 저장함
  • 온라인 출처 예시는 irs.gov, 법원 웹사이트, 정부 기관 웹사이트임
  • 각 질문은 보고서를 생성하며, follow-up을 붙이면 방금 만든 보고서에 질문을 추가함
  • 이전 대화의 보고서에 추가하려면 follow-up 뒤에 보고서 이름을 입력함
  • 각 보고서에는 이름과 명령을 복사하는 버튼이 표시됨
  • /use-citations를 입력한 경우에만 스킬이 실행되며, 나머지 Claude Code 세션은 정상적으로 작동함

제공되는 결과

  • 공개 테스트 질문을 실행하면 채팅에 짧은 답변과 보고서 링크가 표시됨
  • 예시 답변은 자녀를 부양가족으로 신고하려면 일반적으로 연말 기준 만 19세 미만이거나 학생인 경우 만 24세 미만이어야 하며, 신고자 또는 공동 신고 시 배우자보다 나이가 어려야 한다는 내용임
  • 영구적이고 완전한 장애가 있는 자녀에는 연령 제한이 없다는 내용도 포함됨
  • 보고서의 각 문장 뒤에는 작은 번호가 표시되며, 번호를 누르면 오른쪽에 답변과 문서가 나란히 열리고 해당 구절이 강조됨
  • 장애 관련 문장은 uscode.house.gov에서 저장한 26 U.S.C. § 152의 원문 구절로 연결됨
  • 같은 대화에서 후속 질문을 입력하면 기존 보고서의 두 번째 질문으로 추가됨
  • 자녀가 신고자와 함께 살아야 하는지 묻는 후속 질문에는 일반적으로 연간 절반을 초과하는 기간 동안 함께 살아야 하며, 학교·질병·업무·휴가·군 복무·소년 구금시설 수용 기간은 함께 산 기간으로 간주된다는 답변이 연결됨
  • 두 질문을 처리하는 데 약 3분이 걸렸으며, IRS Publication 501, 법령, IRS 페이지 2곳에서 인용한 36개 구절이 모두 단어 그대로 발견됨
  • 보고서에는 다음 항목이 포함됨
  • 문서가 답하지 않는 내용
  • 사용되지 않은 문서를 포함해 수집된 모든 문서와 저장 위치·시점
  • Claude가 실행한 모든 검색과 답변이 틀렸다는 증거를 찾은 검색을 포함한 검증 방식
  • 같은 페이지에 표시되는 후속 질문별 출처 목록
  • 보고서는 claude.ai의 비공개 링크이며 공유하기 전에는 다른 사람이 볼 수 없음

검증 범위와 한계

  • 검증기는 숫자가 변경되거나, 두 숫자의 순서가 바뀌거나, 숫자가 잘리거나, not이 추가·삭제되거나, 서로 다른 구절이 합쳐진 인용문을 거부함
  • 줄바꿈, 따옴표 스타일의 차이, PDF에서 줄을 넘어 분할된 단어는 허용함
  • 검증하지 못하는 항목은 Claude의 평이한 영어 문장이 원문 구절을 공정하게 요약하는지 여부임
  • Claude가 실제 문서가 아니라 이미 알고 있던 지식으로 답변했는지도 검증하지 않음
  • 따라서 보고서의 각 번호가 여는 원문 구절과 모든 검색 기록을 확인한 뒤 문장을 신뢰해야 함
  • IRS, CFPB, 노동부, EEOC, FDA, 저작권청, 의학 연구 데이터셋의 공식 답변이 포함된 34개 공개 질문으로 테스트함
  • 인용된 372개 구절이 모두 출처에서 발견됨
  • 결과는 evals/RESULTS.md에 있으며, 같은 질문을 직접 실행하는 방법은 evals/README.md에 설명됨

사용자 문서

  • 사용자 파일은 컴퓨터에 남으며, 웹페이지 저장을 요청한 경우에만 무언가를 내려받음
  • Claude Code에서 연 파일과 같은 방식으로 검색 대상 문서의 관련 부분을 Claude가 읽음
  • 게시한 보고서에는 인용한 문서 페이지가 포함됨
  • 컴퓨터 밖으로 나가면 안 되는 문서는 보고서로 게시하지 말고 컴퓨터의 파일로 열어야 함

아직 지원하지 않는 기능

  • 로그인이 필요한 웹페이지나 전체 브라우저에서만 제대로 로드되는 페이지를 저장하지 못함
  • PACER
  • EDGAR 검색
  • 대부분의 데이터룸
  • Google Drive, Notion, 법률 연구 서비스처럼 Claude에 연결한 앱에서 직접 읽지 못함
  • 연결 앱은 Claude가 이미 처리한 텍스트를 반환하며, 스킬은 직접 저장한 파일만 인용함
  • 연결 앱의 문서를 사용하려면 파일을 내려받아 해당 파일을 지정해야 함
  • 질문에 포함된 단어를 기준으로 검색하므로 문서가 같은 의미를 다른 단어로 표현하면 놓칠 수 있음
  • Claude는 해당 내용이 없다고 말하기 전에 여러 검색을 시도함
  • 인용문은 확인하지만, 두 문서가 충돌할 때 어느 문서를 우선할지 판단하는 추론과 산술은 Claude가 수행하며 보고서에서 별도로 표시됨
  • Windows에서는 아직 테스트되지 않음
  • 법률·세무·의료 자문이 아님

추가 자료

  • 작동 방식, 검증기, 스크립트, 실제 예시, 테스트
  • SKILL.md: Claude가 따르는 지침
  • AGENTS.md: Claude를 위한 설치 단계와 저장소 작업 관련 참고 사항

라이선스

  • MIT 라이선스임