---
title: "Karpathy's Obsidian RAG + Claude Code = CHEAT CODE"
source: "https://www.youtube.com/watch?v=OSZdFnQmgRw"
video_id: "OSZdFnQmgRw"
date_summary: 2026-05-06
date_video: 2026-05-06
type: summary
language: pl
transcript_file: "[[2026-05-06_Karpathy's_Obsidian_RAG_+_Claude_Code_=_CHEAT_CODE]]"
tags:
  - youtube
  - podsumowanie
  - obsidian
  - rag
  - claude-code
  - knowledge-management
---

# Karpathy's Obsidian RAG + Claude Code = CHEAT CODE

> Andrej Karpathy pokazuje, jak zbudować lekki „RAG” oparty wyłącznie na Obsidianie i Claude Code — bez baz wektorowych i embeddingów.

## Główne Tezy
- Obsidian + Claude Code potrafią zastąpić klasyczny RAG dla pojedynczego użytkownika lub małego zespołu, bez bazy wektorowej i embeddingów.
- Klucz tkwi w przemyślanej strukturze plików: folder `raw` (staging), folder `wiki` (skondensowana wiedza) oraz `master index` jako mapa nawigacyjna.
- Obsidian pełni rolę frontendu — człowiek widzi cały „RAG” w postaci plików Markdown, a nie czarnej skrzynki jak w light RAG czy graph RAG.
- Plik `CLAUDE.md` opisujący strukturę i zasady traversowania pozwala modelowi szybko docierać do danych przy minimalnym zużyciu tokenów.
- Dane można dostarczać ręcznie (Obsidian Web Clipper + plugin Local Images Plus) albo zlecać pozyskiwanie i porządkowanie samemu Claude Code.
- Próg opłacalności klasycznego RAG to skala — dopiero przy tysiącach lub milionach dokumentów sens ma vector DB; do tego momentu Obsidian wystarcza.
- Najlepsza strategia to zacząć od Obsidiana i przejść na pełny RAG dopiero, gdy skala faktycznie tego wymusi.

## Rozszerzone Wnioski
Karpathy w swoim wpisie na X pokazał, że **duże modele językowe radzą sobie świetnie z samodzielnym utrzymywaniem indeksów i streszczeń dokumentów** w obrębie zwykłego systemu plików. To podważa założenie, że każda nietrywialna baza wiedzy potrzebuje embeddingów i bazy wektorowej. Wystarczy spójna konwencja katalogów oraz pliki Markdown spięte linkami w stylu wiki, by model traktował to jak pełnoprawne źródło wiedzy.

Architektura jest celowo prosta: katalog **`raw`** to staging, do którego trafiają artykuły, papery, repozytoria i zrzuty stron WWW. Katalog **`wiki`** zawiera podfoldery tematyczne (np. AI agents, RAG systems, content creation) z wewnętrznymi indeksami, a w korzeniu siedzi **`master index`** — pierwsza rzecz, do której zagląda Claude Code, by zorientować się, co w ogóle istnieje. Taki układ minimalizuje liczbę „ślepych” wywołań narzędzi i ułatwia człowiekowi nawigację, zachowując pełną przezroczystość — odwrotnie niż w light RAG, gdzie cała struktura jest schowana w bazie wektorowej.

Krytycznym elementem jest **`CLAUDE.md`** w korzeniu vaulta. Pełni dwie role: opisuje reguły bazy wiedzy oraz instruuje Claude Code, jak nawigować po plikach (format wiki linków, kolejność czytania indeksów). Dzięki temu model nie marnuje tokenów na poszukiwania metodą prób i błędów. Autor udostępnia gotowy szablon `CLAUDE.md` oraz prompt, który tworzy całą strukturę katalogów jednym poleceniem.

Pozyskiwanie danych odbywa się dwiema ścieżkami. Manualna to **Obsidian Web Clipper** (rozszerzenie Chrome) skonfigurowany tak, by zapisywał wszystko bezpośrednio do `raw`, oraz plugin **Local Images Plus**, który zapisuje obrazy lokalnie zamiast jako linki. Druga ścieżka to delegacja: Claude Code samodzielnie przeszukuje sieć, kompletuje materiały i od razu generuje wiki — folder `raw` służy wówczas głównie człowiekowi do zachowania porządku.

Pytanie „czy potrzebujemy w ogóle RAG?” autor rozstrzyga **pragmatycznie, nie ideologicznie**. Dla solo dewelopera, freelancera czy małego zespołu Obsidian wygrywa — lekki, darmowy, czytelny. Pełnoprawny RAG ma sens dopiero przy skali liczonej w tysiącach–milionach dokumentów, kiedy nawet sprawne traversowanie plików przez Claude Code staje się wolne i kosztowne. Najlepszą strategią jest zacząć od Obsidiana i migrować dopiero wtedy, gdy ograniczenia rzeczywiście zaczną boleć.

## Mapa Myśli
- Obsidian jako alternatywa dla RAG
  - Brak vector DB i embeddingów
  - Markdown + wiki linki jako nośnik wiedzy
  - Obsidian jako frontend dla człowieka
- Architektura vaulta
  - Folder `raw` (staging, surowe dane)
    - Web Clipper jako pipeline manualny
    - Claude Code jako pipeline automatyczny
  - Folder `wiki` (skondensowana wiedza)
    - Podfoldery tematyczne
    - Indeksy lokalne wewnątrz wiki
  - `master index` (mapa całego vaulta)
- Konfiguracja techniczna
  - Pobranie Obsidian z obsidian.md
  - Wyznaczenie folderu jako vault
  - `CLAUDE.md` z regułami nawigacji
  - Plugin Local Images Plus
  - Web Clipper z domyślną lokalizacją `raw`
- Obsidian vs klasyczny RAG
  - Skala jako główne kryterium wyboru
  - Lekkość i darmowość Obsidiana
  - Migracja do RAG dopiero przy realnej potrzebie
- Workflow użytkownika
  - Pytanie do Claude Code w terminalu
  - Model czyta `master index` → wiki → konkretne artykuły
  - Odpowiedzi z minimalną liczbą tool calls

## Cytaty
> „Andre Karpathy just gave us the keys to his personal Obsidian Rag system. And I put Rag in air quotes because this Obsidian power knowledge base has no vector database, no embeddings, and no complicated retrieval process.” — *otwarcie filmu, opis koncepcji*

> „The large language model has been pretty good about automaintaining index files and brief summary of all the documents it reads.” — *Karpathy w cytowanym wpisie*

> „If you're a solo dev, a solo operator, or a small team that isn't dealing with thousands of documents, the answer probably is Obsidian makes more sense for you.” — *rekomendacja końcowa*

> „Why wouldn't you just start with something like obsidian? And if it's clear your scale goes well beyond the bounds of what this thing can handle, then just move into rag.” — *strategia migracji*

## Tagi
#youtube #podsumowanie #obsidian #rag #claude-code #knowledge-management