AI 업무 위키
심화 · 선택 (Track C)
Advanced · self-serve

내 노트북에 '내 위키' 직접 만들기

복붙 프롬프트 한 번이면 — 강사와 똑같은 Claude Code + 로컬 위키가 내 노트북에 생깁니다. 터미널이 처음이어도 괜찮아요. 아래를 그대로 따라만 하면 됩니다. (선택 트랙 — 안 해도 됩니다.)

🗺️ 전체 그림 — 딱 5단계, 약 15분: ① 준비물 확인 → ② 터미널 열기 → ③ 설치 복붙 → ④ 로그인 → ⑤ 셋업 프롬프트 복붙. 우리가 하는 건 복사 → 붙여넣기 → Enter의 반복이 전부이고, 각 단계마다 "이렇게 되면 성공" 확인이 있어요.

🎁 Claude 계정이 없어도 됩니다. 오늘 참석자 몇 분께 Claude Pro/Max 계정을 빌려드려요AI 계정 예약 페이지에서 신청하세요 (이 위키 로그인 → 참여 코드는 현장 안내). (수량 한정·선착순)

1준비물 2가지

2터미널 열기

Mac⌘ Command + Space 를 누르고 "터미널" 입력 → Enter. 검은 창이 뜨면 성공.

Windows — 시작 메뉴에서 "PowerShell" 검색 → 실행. 파란 창이 뜨면 성공. (WSL 등 사전 설치 필요 없어요 — 자세히는 아래 🪟 참고.)

💡 터미널은 마우스 대신 글자로 시키는 창일 뿐이에요. 우리는 복사 → 붙여넣기 → Enter만 합니다.

3Claude Code 설치 (통째로 복붙)

내 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는 쓰지 마세요(권한 오류의 원인).

4로그인

터미널에 claude 라고 치고 Enter. 처음 실행하면 몇 가지를 물어보는데, 순서대로 이렇게 하면 됩니다:

색상 테마를 물으면 — 그냥 Enter (아무거나 상관없어요).

로그인 방법을 물으면 — Claude account with subscription(구독 계정, 보통 첫 번째)을 선택하고 Enter.

브라우저가 자동으로 열리면 — Claude 계정으로 로그인하고 허용(Authorize) 클릭. 빌린 계정이면 그 계정의 이메일·비밀번호로 로그인하세요 (브라우저에 내 계정이 이미 로그인돼 있으면 로그아웃하거나 "다른 계정 사용"을 선택).

④ 터미널로 돌아오면 로그인 완료 메시지가 보입니다 — 성공! (브라우저가 안 열리면 터미널에 표시된 링크를 복사해 브라우저 주소창에 붙여넣으세요.)

⌨️ 권한 모드 팁 (Shift+Tab) — Claude는 기본적으로 파일을 만들거나 명령을 실행할 때마다 허락을 물어봅니다(Yes 계속 눌러도 됨). 귀찮으면 Shift+Tab 을 눌러 모드를 바꿔보세요 — auto 모드로 두면 안전한 작업은 알아서 진행하고 위험한 것만 막습니다. 같은 키로 언제든 원복돼요.

5셋업 프롬프트 붙여넣기 — 이거 하나면 끝

로그인 후, 아래 파란 [복사] 버튼을 누르고 → 터미널의 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- 커맨드는 재시작 후 활성화됩니다 (시작할 때만 스캔돼요). 축하해요 — 내 위키가 생겼어요!

6이제 매일 이렇게 씁니다

📥 자료 넣기 — 파일을 ~/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로 지정하세요. 설치·사용은 선택이고, 실제 작업은 터미널에서 합니다.

🪟 Windows 사용자 — 자세히

기본은 네이티브 설치입니다. 위 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 에 생깁니다.

😌 막히면 그냥 손 드세요. AI자동화 T/F팀이 옆에서 바로 도와드립니다. 오늘 다 못 해도 괜찮아요 — 이 페이지는 계속 열려 있으니 나중에 이어서 하면 됩니다.
아이디어 원문: Karpathy · LLM Wiki  ·  ← 전체 위키로