로컬 AI 지식 베이스: 내 문서로 Q&A

한 번만 설정: 전역 설정을 AICodeWith로

한 번만 하면 모든 사례에서 재사용합니다. 다른 도구: 연동 가이드. 키 받는 곳: API 키 받기.

1. 1. Claude Code 설치

   Claude Code 공식 설치 문서를 따르세요. claude --version이 버전 번호를 출력하면 끝입니다.

2. 2. 키를 만들고 전역 설정을 수정

   로그인한 뒤 대시보드 **API 키** 페이지를 열고 키를 만드세요. 어디인지 모르겠다면 API 키 받기를 보세요.

   전역 설정 ~/.claude/settings.json을 열고 env 아래에 Base URL과 키를 넣으세요:

   ~/.claude/settings.json复制代码

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
       "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY"
     }
   }
   

   Base URL 끝에 /v1을 붙이지 마세요. 터미널을 다시 열고 claude를 실행해 정상 답변이 오면 연결된 것입니다.

실측 단계

1. 1. 문서를 준비하고 Q&A 도구를 만들게 하기

   폴더를 만들고 Markdown 파일을 docs/에 넣은 뒤 그 안에서 claude를 실행하고 입력하세요:

   text复制代码

   docs/ 폴더에 회사 정책 문서가 몇 개 있어. 로컬 Q&A 도구를 만들어줘: 서드파티 API 키가 필요 없는 Python 스크립트 ask.py를 쓰고, docs/ 아래 Markdown을 읽고, 단락마다 자른 뒤 키워드/BM25로 가장 관련 있는 단락을 가져와 답과 출처(파일명 + 원문)를 출력해. 그런 뒤 이 질문들에 답하고 결과를 qa-results.md에 써: (질문은 본인 것으로 바꾸기). 문서에 없으면 "not found in the documents"라고 해. 답을 지어내지 마.
   

   마지막 문장의 「not found in the documents」와 답을 지어내지 말라는 말을 남기세요. 스크립트가 추측하지 못하게 막는 문장입니다.

2. 2. 나중에는 Claude Code 없이 질문

   스크립트가 있으면 Claude Code는 필요 없습니다. 터미널에서 물으세요:

   bash复制代码

   python3 ask.py "How many vacation days after 12 years?"
   python3 ask.py -k 3 "Who do I ask for a test phone?"   # top 3 candidate passages
   

   Claude Code가 쓴 스크립트는 달라질 수 있습니다. 처음엔 이미 답을 아는 질문 몇 개를 시험하세요.

문제 해결

문서에 있는데 not found라고 나옴

일치 임계를 낮추거나 동의어를 넣게 한 뒤 그 질문을 다시 실행하세요.

문서가 Word나 PDF

Markdown만 테스트했습니다. Claude Code에 먼저 변환하라고 할 수 있습니다(그 단계는 미검증).

401 또는 요청 실패

키가 완전한지, Base URL이 https://api.aicodewith.ai(/v1 없음)인지 확인하세요. 바꾼 뒤 터미널을 다시 여세요.

FAQ

관련 읽기

• Claude Code + Python: 의존성 없는 로컬 문서 Q&A
• 모든 연동 가이드
• API 키 받기