Obsidian + Claude Code: Xây Wiki Kiến Thức Bằng AI Từ A-Z (2026)

Bạn có bao giờ viết ghi chú rất nhiều nhưng không bao giờ tìm lại được không? Mình thì có. Hàng trăm file markdown rải rác, không có liên kết, không có tóm tắt. Mỗi lần cần thông tin gì, phải tìm lại từ đầu.

Rồi mình dùng Claude Code là gì thì biết rồi, nhưng AI chat thì reset mỗi phiên. Bạn hỏi hôm nay, ngày mai nó quên hết. Không có bộ nhớ dài hạn.

Andrej Karpathy vừa chia sẻ một pattern mới ngày 3/4/2026 gọi là LLM Wiki. Ý tưởng rất đơn giản: thay vì xây hệ thống RAG phức tạp, bạn cho LLM đọc thẳng các file markdown của mình. Obsidian lưu dữ liệu, Claude Code xử lý. Kết quả: một wiki kiến thức cá nhân tự cập nhật. Bài này mình sẽ hướng dẫn bạn cài đặt từ A-Z.

Karpathy LLM Wiki Pattern Là Gì?

LLM Wiki Pattern là kiến trúc do Andrej Karpathy (đồng sáng lập OpenAI) công bố ngày 3/4/2026 qua GitHub Gist. Thay vì dùng RAG với vector database phức tạp, pattern này cho phép LLM đọc trực tiếp các file markdown. VentureBeat gọi đây là cách đơn giản hóa hoàn toàn workflow quản lý kiến thức.

Karpathy viết trong gist gốc: “The tedious part of maintaining a knowledge base is not the reading or the thinking, it’s the bookkeeping.” Đó chính xác là vấn đề mình gặp: phần nhàm chán là phân loại, liên kết, tóm tắt. Còn phần tư duy thì bạn phải tự làm.

Pattern có 3 lớp rõ ràng:

• Raw sources: Bài viết gốc, PDF, link, notes chưa xử lý. Bạn bỏ vào đây, không cần làm gì thêm.
• Wiki: Claude viết và duy trì. Mỗi entity có trang riêng, có wikilinks liên kết chéo, có summary.
• Schema: File CLAUDE.md là gì ở root vault, config cho Claude biết cấu trúc và rules.

Và 3 thao tác chính bạn sẽ dùng hàng ngày:

• Ingest: Nhập nguồn mới vào raw/, Claude tự tạo summary pages và entity pages.
• Query: Hỏi câu hỏi, Claude tìm trong wiki và trả lời có citations.
• Lint: Claude tự kiểm tra orphan pages, broken wikilinks, thông tin cũ và dọn dẹp.

Pattern này phù hợp nhất với vault 100-500 notes. Karpathy cũng thừa nhận nếu vault lớn hơn, bạn sẽ cần công cụ search như qmd để hỗ trợ. Với quy mô đó thì obsidian claude code là combo đủ mạnh để xử lý.

Tại Sao Obsidian + Claude Code Mà Không Phải Tool Khác?

Obsidian là ứng dụng ghi chú local-first với hơn 1.5M người dùng hàng tháng (Obsidian blog), lưu dữ liệu hoàn toàn trên máy bạn dưới dạng markdown thuần. Claude Code đọc và ghi file trực tiếp trên disk với context window 1M tokens. Hai công cụ này sinh ra để kết hợp với nhau.

Obsidian có graph view, wikilinks [[]], hơn 1.700 plugins, và cộng đồng active. Quan trọng hơn: dữ liệu là file markdown bình thường trên máy bạn. Không có cloud lock-in, không có API phức tạp. Claude Code chạy trong terminal, đọc toàn bộ vault chỉ bằng một lệnh cd.

Điểm hay nhất: file CLAUDE.md ở vault root vừa là config cho Claude, vừa là note bình thường trong Obsidian. Bạn mở Obsidian thì thấy nó như một file markdown. Bạn chạy Claude Code thì nó đọc như config file. Một file, hai mục đích.

So sánh nhanh với các lựa chọn khác:

Nguyên tắc quan trọng khi dùng Obsidian Claude Code: “Agents read, humans write.” Vault Obsidian là nơi giữ suy nghĩ thật của bạn. Claude chỉ đọc nguồn raw và viết vào thư mục wiki riêng. Ghi chú gốc của bạn không bao giờ bị AI chỉnh sửa trừ khi bạn cho phép rõ ràng.

5 Cách Kết Nối Obsidian Với Claude Code Là Gì?

Có 5 cách tích hợp Obsidian Claude Code, từ đơn giản đến phức tạp. Theo khảo sát Stack Overflow 2025, 84% developer đã dùng AI tools, nhưng phần lớn chưa tích hợp AI vào quy trình ghi chú. Cách bạn chọn phụ thuộc vào mục tiêu và mức độ kỹ thuật.

Cách 1: Mở Terminal Trong Vault (2 Phút)

Cách đơn giản nhất, không cài gì thêm. Chỉ cần cd vào thư mục vault và chạy Claude Code.

cd ~/Documents/MyVault
claude

Claude đọc toàn bộ file trong vault ngay lập tức. Bạn có thể hỏi về bất kỳ nội dung nào. Nhược điểm: Claude chỉ đọc file, không sync real-time với Obsidian UI khi bạn đang mở nó. Nhưng để bắt đầu thử thì hoàn toàn đủ dùng.

Cách 2: kepano/obsidian-skills (Khuyên Dùng)

Steph Ango, CEO của Obsidian, tạo repo kepano/obsidian-skills với 22.1K stars trên GitHub. Đây là bộ Claude Code Skills chính thức dạy Claude hiểu định dạng Obsidian.

Bộ này gồm 5 skills: obsidian-markdown (wikilinks, callouts, properties), obsidian-bases (Obsidian Bases queries), json-canvas (canvas files), obsidian-cli (mở ứng dụng và tương tác), defuddle (xử lý web content).

Cài đặt bằng một lệnh:

npx skills add kepano/obsidian-skills

Hoặc copy thủ công thư mục .claude/ vào vault root. Sau khi cài, Claude tự hiểu cú pháp [[wikilinks]], callouts như > [!NOTE], frontmatter properties, và Bases format. Đây là cách mình khuyên dùng cho người mới bắt đầu với Obsidian Claude Code.

Cách 3: MCP Plugin (Đồng Bộ Hai Chiều)

Plugin obsidian-claude-code-mcp của Ian Sinnott tạo kết nối hai chiều thực sự giữa Obsidian và Claude Code. Để hiểu MCP là gì, đây là ứng dụng thực tế rõ ràng nhất.

Plugin cung cấp 7 tools: view, create, str_replace, insert, get_current_file, get_workspace_files, và obsidian_api. Đặc biệt, get_current_file Cho Claude biết bạn đang mở file nào trong Obsidian ngay lúc đó.

Cài qua Community Plugins: tìm “Claude Code” → Enable. Rồi trong Claude Code chạy /ide → chọn Obsidian → kết nối tự động qua WebSocket port 22360. Claude Code trong VS Code hoạt động tương tự, bạn có thể xem cách dùng Claude Code trong VS Code để so sánh.

Cách 4: Claudian Plugin (Agent Trong Vault)

Plugin Claudian nhúng Claude Code trực tiếp vào giao diện Obsidian. Không cần mở terminal. Bạn dùng slash commands ngay trong vault, có inline editing, có plan mode để xem Claude định làm gì trước khi chạy.

Cài đặt: vào Obsidian Settings → Community Plugins → Browse → tìm “Claudian” → Install → Enable. Cần Claude Code CLI đã cài sẵn trên máy. Claudian dùng Anthropic SDK trực tiếp, không qua MCP. Hỗ trợ cả Claude Code lẫn Codex. Nhược điểm: chỉ chạy trên desktop (không có mobile). Phù hợp nhất cho người muốn UX tốt nhất và không thích terminal.

Cách 5: Wiki Skill (Karpathy Pattern Đầy Đủ)

Hai repo triển khai đầy đủ LLM Wiki Pattern của Karpathy. claude-obsidian cung cấp các commands /wiki, /ingest, /query, /lint, /autoresearch. second-brain có setup wizard, 4 skills, và tương thích multi-agent. Chọn cái nào? Nếu bạn muốn slash commands trực tiếp và hot cache, dùng claude-obsidian. Nếu bạn muốn setup wizard tự động và dùng nhiều AI agent khác nhau (Cursor, Gemini CLI), chọn second-brain.

Workflow tự động hoàn toàn: bỏ source vào thư mục raw/, chạy /ingest, Claude tự tạo wiki pages, entity pages, cập nhật index. Đây là cách dùng Obsidian Claude Code đúng theo Second Brain Pattern. Nhưng learning curve cao nhất trong 5 cách, cần hiểu rõ concept của Karpathy mới tận dụng được.

Hướng Dẫn Cài Đặt Từng Bước Mất Bao Lâu?

Cài đặt Obsidian Claude Code theo Cách 1 và 2 mất khoảng 10 phút. Đây là combo mình khuyên mọi người bắt đầu, trước khi upgrade lên Cách 3-5. Không cần biết lập trình, chỉ cần biết dùng terminal cơ bản.

Bước 1: Cài Obsidian

Tải Obsidian miễn phí tại obsidian.md (Windows, Mac, Linux). Cài xong, tạo vault mới: Obsidian → Create new vault → đặt tên và chọn thư mục lưu. Nếu bạn đã có thư mục ghi chú Markdown sẵn thì chọn “Open folder as vault” để dùng luôn.

Bước 2: Tạo CLAUDE.md Cho Vault

Tạo file CLAUDE.md ở root vault (cùng cấp với các thư mục ghi chú). File này là config cho Claude và cũng là một note Obsidian bình thường.

# My Knowledge Vault
> Personal wiki maintained by Claude Code using Karpathy's LLM Wiki pattern.

## Vault Structure
- raw/      - nguồn gốc chưa xử lý (articles, links, PDFs)
- wiki/     - Claude viết và duy trì (summaries, entity pages)
- projects/ - dự án đang làm
- notes/    - ghi chú cá nhân (KHÔNG chỉnh sửa)

## Rules
- Tạo wikilinks [[page-name]] khi mention entity quan trọng
- Mỗi wiki page cần frontmatter: title, tags, created, updated
- Cập nhật wiki/index.md khi tạo page mới
- Ngôn ngữ: tiếng Việt cho nội dung, tiếng Anh cho technical terms
- KHÔNG sửa file trong notes/ trừ khi được yêu cầu rõ ràng

## Naming Conventions
- Wiki pages: kebab-case (vi-du-ten-page.md)
- Raw files: date-prefix (2026-04-10-ten-bai.md)
- Tags: lowercase, dùng / cho hierarchy (claude/mcp)

## Active Context
- Chủ đề đang nghiên cứu: [cập nhật đầu mỗi phiên]
- Dự án đang làm: [tên dự án]

Bước 3: Cài kepano/obsidian-skills

Chạy lệnh sau trong terminal (không cần đứng trong vault, chạy ở đâu cũng được):

npx skills add kepano/obsidian-skills

Nếu bạn muốn cài thủ công: tải thư mục .claude/ từ repo kepano/obsidian-skills và copy vào vault root. Sau khi cài, verify bằng cách chạy Claude Code trong vault và hỏi: “Giải thích wikilinks trong Obsidian là gì?” Nếu Claude trả lời đúng cú pháp [[]] thì cài thành công.

Bước 4: Chạy Claude Code Và Thử Ngay

cd ~/Documents/MyVault
claude

# Thử các lệnh này:
# "Đọc toàn bộ vault và tóm tắt nội dung chính"
# "Tạo note mới về [topic] với wikilinks và frontmatter"
# "Tạo thư mục wiki/ và file wiki/index.md"

Lần đầu chạy, Claude sẽ đọc CLAUDE.md và hiểu cấu trúc vault. Từ đó trở đi, mọi lệnh đều có context. Bạn có thể dùng tiết kiệm token bằng cách dùng /compact thường xuyên khi vault lớn.

Demo Thực Tế: Ingest, Query, Lint Hoạt Động Ra Sao?

Ba thao tác cốt lõi của obsidian claude code là Ingest, Query, và Lint. Mỗi thao tác giải quyết một vấn đề khác nhau trong quy trình quản lý kiến thức. Đây là ví dụ thực tế mình hay dùng.

Ingest: Nhập Nguồn Mới

Bỏ file vào thư mục raw/, rồi hỏi Claude:

# Bỏ file vào raw/ trước, rồi nói với Claude:
"Đọc file raw/2026-04-10-karpathy-llm-wiki.md và tạo:
 1. Summary page tại wiki/karpathy-llm-wiki.md
 2. Entity page cho Andrej Karpathy tại wiki/andrej-karpathy.md
 3. Cập nhật wiki/index.md"

Claude đọc source gốc, viết summary có frontmatter, tạo entity page với thông tin về Karpathy, và cập nhật index. Tất cả các trang đều có wikilinks liên kết với nhau. Bạn không cần làm gì cả, chỉ bỏ file vào và ra lệnh.

Query: Hỏi Đáp Từ Wiki

"Tóm tắt tất cả những gì mình đã nghiên cứu về MCP"
"So sánh Karpathy LLM Wiki với RAG theo các notes của mình"
"Những entity nào liên quan đến Claude Code trong wiki?"

Claude đọc toàn bộ thư mục wiki và trả lời có citations rõ ràng (từ file nào). Vì wiki đã được Claude tổ chức từ trước, query nhanh và chính xác hơn nhiều so với tìm thủ công.

Lint: Dọn Dẹp Tự Động

"Kiểm tra wiki/ và tìm:
 1. Orphan pages (không có page nào link tới)
 2. Broken wikilinks (link tới page không tồn tại)
 3. Pages không có frontmatter đầy đủ
Sau đó fix tất cả lỗi trên"

Đây là phần mình thích nhất. Claude làm cái phần bookkeeping nhàm chán mà Karpathy nhắc đến. Vault luôn sạch sẽ mà bạn không tốn thời gian dọn.

CLAUDE.md Mẫu Copy-Paste Cho Obsidian Vault

File CLAUDE.md là trái tim của workflow Obsidian Claude Code. Template đầy đủ dưới đây dùng được ngay, chỉ cần thay các phần trong dấu [...] theo vault của bạn. Bốn phần chính đủ để Claude hoạt động hiệu quả.

# [Tên Vault] Knowledge Base
> [Mô tả ngắn vault của bạn dùng cho mục đích gì]
> Maintained by Claude Code, Karpathy LLM Wiki pattern.

## Vault Purpose
[2-3 câu mô tả: vault này lưu kiến thức về gì, ai dùng, để làm gì]

## Folder Structure
- raw/      - Nguồn gốc chưa xử lý. Claude ĐỌC, không sửa.
- wiki/     - Claude viết và maintain. Entity pages, summaries.
- projects/ - Dự án đang làm. Claude hỗ trợ khi được yêu cầu.
- notes/    - Ghi chú cá nhân. Claude KHÔNG đụng vào.
- archive/  - Nội dung cũ. Chỉ đọc.

## Naming Conventions
- Wiki pages: kebab-case, tiếng Anh (claude-code-mcp.md)
- Raw files: YYYY-MM-DD-ten-ngan.md
- Tags: lowercase, dùng / cho hierarchy

## Wiki Page Template
---
title: [Tên entity]
tags: [category/subcategory]
created: YYYY-MM-DD
updated: YYYY-MM-DD
---
## Summary
[1-2 câu định nghĩa entity]
## Key Points
- [bullet points chính]
## Related
[[page-a]] | [[page-b]]

## Rules
1. Luôn tạo wikilinks khi nhắc đến entity đã có trong wiki
2. Cập nhật wiki/index.md sau mỗi lần tạo page mới
3. Giữ wiki pages ngắn gọn, dưới 500 từ
4. Source mọi thông tin về ngày tháng, số liệu
5. Ngôn ngữ: tiếng Việt, technical terms giữ tiếng Anh

## Active Context
# CẬP NHẬT phần này đầu mỗi phiên làm việc
- Đang nghiên cứu: [topic]
- Deadline gần: [project]
- Ưu tiên hôm nay: [task]

Mình Dùng Obsidian + Claude Code Thế Nào?

Mình dùng Obsidian Claude Code chủ yếu cho research, viết blog. Mỗi khi cần viết bài về một chủ đề mới, mình bỏ các bài viết tham khảo vào raw/, chạy ingest, và wiki tự động được cập nhật. Khi ngồi viết, mình query wiki thay vì mở lại từng tab. Tiết kiệm rất nhiều thời gian.

Vault của mình có cấu trúc khá đơn giản: raw/ chứa articles và links đã lưu, wiki/ do Claude viết với summaries và entity pages, projects/ chứa bản nháp blog và notes cho từng bài. Tổng cộng khoảng 300 notes sau 3 tháng dùng.

Điều mình thích nhất: hỏi “mình đã nghiên cứu gì về MCP trong 2 tháng qua?” và Claude trả lời từ wiki, có citations cụ thể từng file. Không phải mở lại từng note tìm thủ công nữa. Đây chính xác là điểm mạnh của pattern second brain với Claude Code.

Điều chưa hài lòng: Vault lớn hơn 400 notes bắt đầu chậm. Claude cần thêm thời gian đọc trước khi trả lời. Mình phải dùng /compact thường xuyên hơn và đôi khi chỉ load wiki/ thay vì cả vault. Nếu bạn cũng gặp vấn đề này, xem thêm về Claude Code sub-agents để chia nhỏ tác vụ theo chủ đề.

Câu Hỏi Thường Gặp

Obsidian có miễn phí không?

Obsidian miễn phí hoàn toàn cho cá nhân, nên chi phí duy nhất khi dùng Obsidian Claude Code là subscription Claude Code ($20/tháng Pro). Ứng dụng desktop (Windows, Mac, Linux) và mobile (iOS, Android) đều tải về không mất tiền. Tính năng Sync (đồng bộ vault giữa các thiết bị qua Obsidian servers) có phí $4/tháng, nhưng hoàn toàn tùy chọn. Bạn có thể dùng iCloud, Google Drive, hoặc Syncthing miễn phí để thay thế. Publish (đăng lên web) cũng có phí riêng nếu cần.

Cần biết lập trình không để dùng Obsidian Claude Code?

Không cần biết lập trình. Bạn chỉ cần biết dùng terminal ở mức cơ bản nhất: gõ lệnh cd để chuyển thư mục và chạy claude. Nếu bạn chưa từng dùng terminal, cần học thêm 15-20 phút trước. Phần còn lại là gõ tiếng Việt bình thường để ra lệnh cho Claude. Không có code nào cần viết.

Vault bao nhiêu ghi chú thì Claude đọc được?

Claude Sonnet 4.6 có context window 1M tokens, đủ để đọc vault 100-500 notes thoải mái. Karpathy cũng khuyến nghị ngưỡng này trong pattern gốc. Trên 500 notes, vault bắt đầu chậm và bạn cần chiến lược thêm: chỉ load thư mục wiki thay vì cả vault, dùng /compact thường xuyên, hoặc cân nhắc công cụ search như qmd để hỗ trợ.

Dùng Notion hoặc Logseq thay Obsidian được không?

Được, nhưng sẽ phức tạp hơn nhiều. Notion lưu dữ liệu trên cloud, Claude Code không đọc trực tiếp được, bạn phải export ra markdown trước. Logseq lưu file local nhưng dùng cú pháp outliner khác Markdown chuẩn. Obsidian phù hợp nhất cho Obsidian Claude Code vì dữ liệu là Markdown thuần trên máy bạn, Claude Code

vào là đọc được ngay, không cần bước trung gian nào.

Claude có ghi chú của mình không?

Không, trừ khi bạn cho phép rõ ràng. Nguyên tắc “Agents read, humans write” trong CLAUDE.md template phân chia rõ: thư mục notes/ Claude không đụng vào, thư mục wiki/ Claude viết và duy trì. Bạn kiểm soát hoàn toàn bằng cách viết rules trong CLAUDE.md. Trước khi chạy lệnh nào có ghi file, Claude sẽ hỏi xác nhận theo cơ chế mặc định của Claude Code.

Nên bắt đầu với cách kết nối nào?

Bắt đầu với Cách 1 và 2 kết hợp: cd Vào Vault, cài kepano/obsidian-skills, tạo CLAUDE.md. Dùng như vậy 2-3 tuần để hiểu workflow. Khi bạn thấy cần real-time sync thì upgrade lên Cách 3 (MCP plugin). Khi bạn muốn full automation thì thử Cách 5. Không cần nhảy thẳng vào Cách 5 ngay từ đầu, sẽ bị overwhelm. Đa số người dùng Obsidian Claude Code mà mình biết đều bắt đầu từ Cách 1+2.

Bạn Nên Bắt Đầu Với Obsidian Claude Code Từ Đâu?

Bạn đã có đủ nền tảng để bắt đầu với Obsidian Claude Code ngay hôm nay. Cài Obsidian, tạo CLAUDE.md theo template, cài kepano/obsidian-skills, và chạy claude trong vault. Thử Ingest một bài viết, Query một câu hỏi. Mất 10 phút, không có gì để mất.

Bài tiếp theo trong series này sẽ cover sâu hơn: 7 plugins và skills hữu ích nhất cho vault, workflow theo từng role (developer, researcher, blogger), và cách dùng Obsidian Bases với Claude Code để tạo database kiến thức có cấu trúc. Nếu bạn muốn tìm hiểu thêm về cơ chế hoạt động của agent, xem bài về sub-agents trong Claude Code.