복붙 프롬프트 한 번이면 — 강사와 똑같은 Claude Code + 로컬 위키가 내 노트북에 생깁니다. 터미널이 처음이어도 괜찮아요. 아래를 그대로 따라만 하면 됩니다. (선택 트랙 — 안 해도 됩니다.)
🗺️ 전체 그림 — 딱 5단계, 약 15분: ① 준비물 확인 → ② 터미널 열기 → ③ 설치 복붙 → ④ 로그인 → ⑤ 셋업 프롬프트 복붙. 우리가 하는 건 복사 → 붙여넣기 → Enter의 반복이 전부이고, 각 단계마다 "이렇게 되면 성공" 확인이 있어요.
Mac — ⌘ Command + Space 를 누르고 "터미널" 입력 → Enter. 검은 창이 뜨면 성공.
Windows — 시작 메뉴에서 "PowerShell" 검색 → 실행. 파란 창이 뜨면 성공. (WSL 등 사전 설치 필요 없어요 — 자세히는 아래 🪟 참고.)
💡 터미널은 마우스 대신 글자로 시키는 창일 뿐이에요. 우리는 복사 → 붙여넣기 → Enter만 합니다.
내 OS에 맞는 블록을 [복사] 버튼으로 복사해 터미널에 붙여넣고 Enter — 설치 + 명령 경로(PATH) 등록 + 확인까지 한 번에 됩니다. (붙여넣기: Mac ⌘+V · Windows 마우스 우클릭)
💡 Windows에서 "여러 줄을 붙여넣으려 합니다" 경고 창이 뜨면 그냥 [붙여넣기]를 누르세요(정상입니다). 붙여넣은 뒤 아무 일도 없어 보이면 Enter를 한 번 더 — 마지막 줄이 실행됩니다.
🍎 Mac (터미널)
curl -fsSL https://claude.ai/install.sh | bash export PATH="$HOME/.local/bin:$PATH" grep -qs '\.local/bin' ~/.zshrc || echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc claude --version
🪟 Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
$bin = "$env:USERPROFILE\.local\bin"
$u = [Environment]::GetEnvironmentVariable("Path","User")
if ("$u" -notlike "*$bin*") { [Environment]::SetEnvironmentVariable("Path", ("$u;$bin").Trim(";"), "User") }
$env:Path = "$bin;$env:Path"
claude --version
⏳ 1~2분 걸려요. Node.js 같은 사전 설치 필요 없어요 — 이 블록이 설치하고, 명령 경로(PATH) 등록까지 알아서 합니다. (이후 자동 업데이트도 됩니다.)
🔎 확인: 마지막 줄에 숫자 버전(예: 2.x.x)이 나오면 성공. 안 나오면 손 드세요 — 옆에서 바로 잡아드립니다.
⚠️ 🪟 "Installation failed (exit code 1)"과 함께 "requires either Git for Windows … or PowerShell" 메시지가 나오면 — PC에 Git for Windows가 없어서 설치가 안 된 것입니다(새 노트북·비개발 PC에서 흔해요). 아래 한 줄을 붙여넣어 Git을 먼저 설치하세요:
winget install --id Git.Git -e --source winget
설치 창(UAC)이 뜨면 예 → 끝나면 PowerShell을 완전히 닫고 새로 연 뒤 위 Windows 블록을 다시 붙여넣으면 됩니다. (winget이 없다고 나오면 git-scm.com/downloads/win에서 내려받아 전부 기본값으로 설치 → 새 PowerShell → 블록 재실행.)
🧑💻 (개발자용 대안) 이미 Node.js 22 이상이 있으면 npm install -g @anthropic-ai/claude-code 도 됩니다. 단 자동 업데이트는 안 되고, sudo는 쓰지 마세요(권한 오류의 원인).
터미널에 claude 라고 치고 Enter. 처음 실행하면 몇 가지를 물어보는데, 순서대로 이렇게 하면 됩니다:
① 색상 테마를 물으면 — 그냥 Enter (아무거나 상관없어요).
② 로그인 방법을 물으면 — Claude account with subscription(구독 계정, 보통 첫 번째)을 선택하고 Enter.
③ 브라우저가 자동으로 열리면 — Claude 계정으로 로그인하고 허용(Authorize) 클릭. 빌린 계정이면 그 계정의 이메일·비밀번호로 로그인하세요 (브라우저에 내 계정이 이미 로그인돼 있으면 로그아웃하거나 "다른 계정 사용"을 선택).
④ 터미널로 돌아오면 로그인 완료 메시지가 보입니다 — 성공! (브라우저가 안 열리면 터미널에 표시된 링크를 복사해 브라우저 주소창에 붙여넣으세요.)
⌨️ 권한 모드 팁 (Shift+Tab) — Claude는 기본적으로 파일을 만들거나 명령을 실행할 때마다 허락을 물어봅니다(Yes 계속 눌러도 됨). 귀찮으면 Shift+Tab 을 눌러 모드를 바꿔보세요 — auto 모드로 두면 안전한 작업은 알아서 진행하고 위험한 것만 막습니다. 같은 키로 언제든 원복돼요.
로그인 후, 아래 파란 [복사] 버튼을 누르고 → 터미널의 Claude에 붙여넣고 Enter. 내용은 이해 안 해도 됩니다 — Claude가 알아서 폴더·규칙·명령어를 다 만들어줘요.
You are going to set up an "LLM Wiki" for me on this machine and then maintain it.
THE IDEA (Karpathy's LLM Wiki pattern):
Instead of RAG that re-derives answers from raw docs every query, you incrementally
build and maintain a persistent, interlinked markdown wiki that sits between me and
my raw sources. When I add a source you read it, extract the key info, and integrate
it — updating entity/concept pages, revising summaries, flagging contradictions. The
wiki is a compounding artifact: cross-references and synthesis are already there. I
curate sources and ask questions; you do all the bookkeeping. Never make me write the
wiki myself.
STEP 1 — Create the vault as a git repo at ~/llm-wiki with this layout:
~/llm-wiki/
CLAUDE.md <- the schema (you write it in step 2)
index.md <- content catalog: every page, one line each, grouped by folder
log.md <- append-only chronological log
raw/ <- immutable source docs I drop in; you READ, never edit
sources/ <- one page per ingested source (YYMMDD-slug.md)
entities/ <- things with a timeline (a person, project, org, product)
concepts/ <- cross-cutting ideas reused across pages
recipes/ <- how to produce one output type end to end
assets/ <- images
Run `git init`. Seed index.md and log.md with a header.
IMPORTANT — if ~/llm-wiki ALREADY EXISTS: stop, show me what's in it, and ask how to
proceed before changing anything. Treat pre-existing files there as untrusted
leftovers — do NOT read their content into the new wiki or reuse it in your examples
unless I say so, and never read, delete, or commit credential files (.env and similar).
STEP 2 — Write ~/llm-wiki/CLAUDE.md as the schema. It must specify:
- The three layers: raw sources (immutable) / the wiki (you own it) / this schema.
- Node types = folders (entity, concept, recipe, source). One thing per page.
- Links are ALWAYS [[wikilinks]], never markdown links. Link generously; a link to
a page that doesn't exist yet is fine — it marks a page worth creating.
- YAML frontmatter on every page: title, type, status, tags, created, updated,
sources (source-slugs that touched it). For sources/ pages also record provenance:
original path/url and a content note, so the raw stays re-findable.
- The three operations, described as workflows:
INGEST: read the raw source; tell me the key takeaways; write a sources/ page;
update the entity/concept/recipe pages it touches (both-way [[links]]); update
index.md; append to log.md. One ingest may touch 5-15 pages.
QUERY: read index.md first to find pages, drill in, answer ONLY from the wiki
with [[citations]]. If it's not in the wiki, say so — don't guess. After the
answer, emit a `## 근거` block that RESOLVES each citation to its ORIGINAL
(Perplexity-style): for every cited page give the [[wiki page]] AND — when it's
a sources/ page — resolve its raw original from the page's provenance frontmatter
(the `original:` path/url) as a clickable link. Both hops: the wiki node
(synthesis trail) and the original (verification), not just one. File good
answers back as new concept/source pages so explorations compound.
LINT: periodically health-check — contradictions, stale claims, orphan pages,
concepts mentioned but missing a page, missing cross-refs. Propose fixes;
never delete silently.
- log.md convention: each entry starts `## [YYYY-MM-DD] ingest|query|lint | <title>`
so `grep "^## \[" log.md | tail -5` shows recent activity.
STEP 3 — Install three slash commands in ~/.claude/commands/ (the USER-level commands
folder, NOT inside the vault — so they work from ANY directory without cd-ing into the
wiki first; wiki- prefix so they don't collide with other commands). Because they can
run from anywhere, EVERY command file must begin with: "The wiki vault is ~/llm-wiki.
Read ~/llm-wiki/CLAUDE.md (the schema) first and follow its workflows; all wiki paths
are inside ~/llm-wiki."
wiki-ingest.md — "Ingest the source I name (or paste). Follow the INGEST workflow in
the vault's CLAUDE.md. Show me which pages you created/updated."
wiki-query.md — "Answer my question using ONLY this wiki. Read ~/llm-wiki/index.md
first, cite every claim with [[page]], and say so if the answer isn't in
the wiki. After the answer add a `## 근거` block: for each cited sources/
page, resolve its original (the path/url in its frontmatter) as a
clickable link — wiki node AND original, both hops."
wiki-lint.md — "Run the LINT workflow in the vault's CLAUDE.md and report findings
+ proposed fixes. Do not delete anything."
STEP 4 — Hello-world so I see the loop: create a raw/ note about ONE topic I care
about (ask me what, one sentence is fine), then run your own INGEST on it and show me
the resulting sources/ page, the updated index.md, and the log.md line.
After setup, confirm the layout and tell me how to run /wiki-ingest, /wiki-query,
/wiki-lint — and confirm they work from any folder, not just inside ~/llm-wiki.
IMPORTANT: slash commands are only scanned when Claude Code starts, so end by telling
me to type `exit` and run `claude` once more — the /wiki- commands activate then.
⏳ 2~5분 걸려요. 중간에 Claude가 "이 작업을 해도 될까요?"라고 물으면 Yes(Enter)를 계속 눌러주면 됩니다 — 폴더와 규칙 파일을 만드는 정상 과정이에요.
✅ 다 끝나면 Claude가 "이제 이렇게 쓰세요"라고 알려줍니다. 마지막 한 번만 — exit 입력 후 claude 를 다시 실행하세요.
새로 설치된 /wiki- 커맨드는 재시작 후 활성화됩니다 (시작할 때만 스캔돼요). 축하해요 — 내 위키가 생겼어요!
~/llm-wiki/raw/ 폴더에 두고 Claude에 /wiki-ingest/wiki-query 내 위키에 ~ 관련 뭐 있어? → 근거까지 붙여 답/wiki-lint 로 중복·빠진 것 점검📍 세 커맨드는 전역 설치라서 아무 폴더에서나 claude를 열고 바로 쓸 수 있어요 — ~/llm-wiki로 이동할 필요 없습니다.
📦 넣을 파일이 없다면? 체험용 문서 20종 zip을 내려받으세요 —
누리항공 (가상 항공사의 국제선 취항 프로젝트: 회의록·메일·예산·보고 pptx 등 7가지 형식).
압축을 풀어 raw/에 넣고 /wiki-ingest 해보세요. 웹 위키(/studio) 업로드 체험에도 같은 파일을 쓸 수 있어요.
🕸️ (선택) 그래프로 눈에 보고 싶으면 — Obsidian을 열어 ~/llm-wiki 폴더를 Vault로 지정하세요. 설치·사용은 선택이고, 실제 작업은 터미널에서 합니다.
기본은 네이티브 설치입니다. 위 3단계의 PowerShell 블록을 통째로 붙여넣으면 끝 —
WSL 안 깔아도 됩니다. 설치기가 PATH 등록을 빼먹는 경우가 있어서(재시작해도 claude가 안 잡히는
"not in your PATH" 증상) 블록에 경로 등록 2줄이 포함돼 있어요 — 지금 창과 앞으로의 새 창 모두에서 바로 동작합니다.
위키는 C:\Users\<나>\llm-wiki 에 생깁니다.
혹시 에러 메시지가 C:\Users\<나>\.local\bin 이 아닌 다른 경로를 보여주면, 블록 2번째 줄의
경로를 메시지에 나온 경로로 바꿔 다시 붙여넣으면 됩니다.
Git for Windows가 필요할 수 있어요. 설치기가 PC에서 Git for Windows(또는 PowerShell 7)를 못 찾으면 "Installation failed (exit code 1)"로 멈춥니다 — 그때는 위 3단계의 ⚠️ 안내대로 Git 설치 → 새 PowerShell 창 → 블록 다시 붙여넣기 순서로 하면 됩니다. git-scm.com/downloads/win
(선택) 리눅스 환경을 선호하면 WSL도 됩니다: PowerShell(관리자)에서 wsl --install → 재부팅 →
Ubuntu 안에서 위 Mac용 한 줄(curl -fsSL https://claude.ai/install.sh | bash)을 그대로 실행.
그때 위키는 \\wsl$\Ubuntu\home\<나>\llm-wiki 에 생깁니다.