second-brain

흩어진 메모·기사·생각을 한곳에 모으면, Claude Code가 정리·연결·검색·요약까지 도와주는 개인 위키입니다.

A personal wiki: dump your raw notes, articles, and thoughts in one place, and Claude Code distills, links, searches, and summarizes them for you.

언어 / Language: 🇰🇷 한국어 · 🇺🇸 English

🇰🇷 한국어

📖 Second Brain 작동 원리 튜토리얼 → — 시스템이 내부에서 어떻게 동작하는지 차근차근 설명하는 가이드입니다.

이게 뭔가요?

Second Brain(제2의 뇌) 은 내가 모은 자료를 차곡차곡 쌓아두는 개인 지식 창고입니다. 핵심 아이디어는 간단합니다.

• 모으기 — 기사, 회의록, 떠오른 생각 등 무엇이든 일단 wiki/raw/ 폴더에 던져 넣습니다. 정리는 나중에.
• 정리하기 — Claude Code에게 /ingest라고 시키면, 날것의 메모를 읽고 깔끔하게 정리된 노트로 바꿔 서로 연결해 줍니다.
• 꺼내쓰기 — /ask로 질문하면 내 노트를 근거로 답해 주고, /brief로 특정 주제에 대한 문서를 만들어 줍니다.

💡 코딩을 몰라도 괜찮습니다. 어려운 작업(정리·연결·검색·요약)은 전부 Claude Code가 합니다. 여러분은 자료를 모으고, 채팅창에 /명령어를 입력하기만 하면 됩니다.

3가지 폴더만 기억하세요

🌱 이 템플릿에는 예시 노트 몇 개가 들어 있습니다 (example 태그가 붙은 [[second-brain]] · [[zettelkasten]] · [[atomic-notes]] · [[evergreen-notes]]). /ask·그래프 뷰·검색이 처음부터 동작하도록 미리 채워둔 것이니, 빈 상태로 시작하고 싶으면 지워도 됩니다.

시작하기 (단계별)

0. 미리 준비할 것

• Claude Code 설치 (이 모든 명령어를 실행하는 도구입니다)
• Python 3.13 (검색·색인용 스크립트를 돌립니다)
• Gemini API 키 — Google AI Studio에서 무료로 발급받을 수 있습니다 (의미 기반 검색에 사용)

1. 프로젝트 환경 만들기

터미널을 열고, 이 폴더 안에서 아래를 차례대로 입력하세요. (한 줄씩 복사해서 붙여넣으면 됩니다.)

⚠️ 반드시 python3.13을 쓰세요. 더 낮은 버전에서는 일부 라이브러리 설치가 실패할 수 있습니다.

2. Gemini API 키 등록하기

발급받은 키를 .env 파일에 저장합니다. (.env는 비밀 파일이라 GitHub에 올라가지 않습니다.)

3. 첫 자료 넣어보기

직접 메모를 하나 만들어 보거나, 웹 기사를 통째로 가져올 수 있습니다.