Xây dựng Bộ Não Thứ Hai AI với Claude Code và Obsidian

Bạn đã từng viết ghi chú về một vấn đề, rồi vài tuần sau lại phải nghĩ lại từ đầu vì không tìm được? Hay mở Notion ra thấy hàng trăm trang chẳng ai đọc lại? Đó là dấu hiệu của một "bộ não thứ hai" thụ động — nó chỉ chứa thông tin chứ không làm gì với nó.

Bài này hướng dẫn bạn xây một hệ thống khác hẳn: kết hợp Obsidian (ứng dụng ghi chú dạng file Markdown lưu trên máy) với Claude Code (AI chạy trực tiếp trong máy tính, đọc được file của bạn) để tạo ra một bộ não AI thực sự hoạt động — tự nhớ ngữ cảnh giữa các phiên làm việc, tự xử lý inbox, và tự tổng hợp thông tin khi bạn cần.[1]

Đọc xong tài liệu này, bạn sẽ có một hệ thống chạy được ngay — từ cấu trúc thư mục vault, đến file CLAUDE.md, đến các workflow tự động hoá thực tế.

Tại sao hệ thống ghi chú thông thường không ổn

Hầu hết "bộ não thứ hai" mọi người xây đều có một điểm yếu chung: chúng thụ động. Bạn ghi vào đó, nhưng thông tin chỉ nằm im. Không tự kết nối. Không tự nhắc bạn khi cần. Và quan trọng hơn — không giúp bạn hành động.

Theo phương pháp PARA của Tiago Forte[1], bộ não thứ hai lý tưởng nên lưu trữ và gợi lại thông tin đúng lúc bạn cần. Nhưng ngay cả Obsidian — một trong những công cụ tốt nhất cho việc này — vẫn chỉ là kho lưu trữ thụ động nếu không có AI đứng phía sau.

Hai công cụ cần biết: Obsidian và Claude Code

Obsidian là gì?

Obsidian là ứng dụng ghi chú lưu toàn bộ dữ liệu dưới dạng file Markdown (.md) ngay trên máy tính của bạn — không phải trên cloud của một công ty nào đó. Hiểu nôm na: nó giống như một thư mục ghi chú siêu thông minh, mỗi ghi chú là một file text bình thường, nhưng có thể liên kết với nhau và tìm kiếm rất nhanh.

Điểm quan trọng: vì Obsidian lưu file trên máy, Claude Code có thể đọc và ghi vào vault của bạn trực tiếp.

Claude Code là gì?

Claude Code là AI của Anthropic chạy qua terminal (cửa sổ dòng lệnh) — khác hoàn toàn với Claude trên web. Khi bạn chạy Claude Code bên trong thư mục vault Obsidian, nó có thể:

• Đọc hàng chục file ghi chú trước khi trả lời
• Tạo file mới, ghi vào đúng thư mục bạn chỉ định
• Chạy script và xử lý kết quả
• Duy trì ngữ cảnh trong các tác vụ dài, nhiều bước

Cài đặt và chuẩn bị môi trường

Trước khi bắt đầu, bạn cần chuẩn bị đủ ba thứ sau:

Claude Code đang chạy và thấy mọi file trong vault. Nhưng để biến nó thành bộ não thực sự, bạn cần thêm một bước quan trọng tiếp theo.

Cấu trúc vault Obsidian cho AI

Claude Code hoạt động tốt hơn nhiều khi vault có cấu trúc nhất quán và dễ đoán. Trước khi kết nối AI, hãy dành một tiếng để chuẩn hoá vault của bạn.

Cấu trúc thư mục gợi ý

/MyVault
  /Inbox          ← Ghi chú nháp, capture nhanh chưa xử lý
  /Projects       ← Thư mục riêng cho từng dự án đang chạy
  /Areas          ← Trách nhiệm liên tục (sức khoẻ, tài chính, công việc)
  /Resources      ← Tài liệu tham khảo theo chủ đề
  /Archive        ← Dự án hoàn thành, ghi chú cũ
  /AI             ← Output của AI: session log, bản nháp, tóm tắt
  /Templates      ← Mẫu ghi chú tái sử dụng

Thư mục /AI là phần mới mà hầu hết mọi người chưa có. Đây là nơi Claude Code ghi lại output sau mỗi phiên làm việc — bản tóm tắt phiên, bản nháp tài liệu, log công việc. Theo thời gian, thư mục này trở thành lịch sử của toàn bộ những gì AI đã làm cho bạn.

Frontmatter — thẻ thông tin giúp AI hiểu đúng ngữ cảnh

Frontmatter là phần "thẻ thông tin" đặt ở đầu mỗi ghi chú, nằm giữa hai dòng ---. Hiểu nôm na như dán một nhãn vào tờ giấy: ghi chú này thuộc dự án gì, trạng thái ra sao, liên quan đến file nào. Claude Code đọc các nhãn này để biết file nào quan trọng và kết nối với nhau như thế nào — thay vì phải đọc toàn bộ nội dung của mọi file.

Thêm nhất quán vào đầu mỗi ghi chú:

---
created: 2025-06-10
tags: [project, client-abc, active]
status: in-progress
related: [[Họp kick-off tháng 5]], [[Brief dự án ABC]]
---

Trường related dùng cú pháp wiki-link của Obsidian ([[Tên ghi chú]]). Claude Code có thể đọc các liên kết này và xây dựng bức tranh toàn cảnh về ngữ cảnh trước khi hành động.

Daily Note làm điểm bàn giao

Tạo template cho Daily Note (ghi chú ngày) với bốn mục cố định:

• Ưu tiên hôm nay — những gì bạn muốn hoàn thành
• Vòng lặp chưa đóng — việc còn dở từ hôm qua
• Ngữ cảnh cho AI — bất cứ điều gì bạn muốn AI biết trước khi bắt đầu
• AI Log — phần trống, Claude Code sẽ điền vào cuối phiên

Viết file CLAUDE.md — "Hiến pháp" của bộ não AI

Đây là phần quan trọng nhất. CLAUDE.md là file đặt ở gốc vault mà Claude Code tự động đọc mỗi khi bắt đầu phiên làm việc. Nó là bộ hướng dẫn thường trực của AI — nếu bạn đầu tư thời gian viết tốt file này, mọi phiên làm việc sau đó sẽ chính xác và hữu ích hơn nhiều.

Bốn phần bắt buộc trong CLAUDE.md

Ví dụ CLAUDE.md hoàn chỉnh

# Bộ Não Thứ Hai AI — Hướng dẫn cho Agent

## Về tôi
Tôi là product manager tại công ty SaaS B2B. Tôi quản lý 3–4 dự án
song song và cần hỗ trợ tổng hợp nghiên cứu, soạn tài liệu và
theo dõi quyết định.

## Cấu trúc vault
- /Inbox: Ghi chú chưa xử lý — kiểm tra đây trước tiên
- /Projects: Mỗi dự án có thư mục riêng; dự án đang chạy có status: active
- /AI/sessions: Ghi session summary sau mỗi phiên làm việc

## Giao thức phiên làm việc

Khi bắt đầu, hãy:
1. Đọc Daily Note hôm nay (định dạng: /Inbox/YYYY-MM-DD.md)
2. Quét /Inbox để xem có ghi chú chưa xử lý không
3. Kiểm tra ghi chú nào được tag #cần-xem-lại

Khi kết thúc, hãy:
1. Ghi session summary vào /AI/sessions/YYYY-MM-DD-HH.md
2. Cập nhật phần "AI Log" trong Daily Note hôm nay

## Sở thích output
- Viết tiếng Việt, rõ ràng, tránh dùng thuật ngữ kỹ thuật không cần thiết
- Ưu tiên bullet points ngắn gọn hơn đoạn văn dài
- Nếu không chắc → hỏi trước khi làm

Bộ nhớ liên tục qua session log

Đây là phần tạo ra sự khác biệt thực sự so với chỉ chat với Claude trên web. Claude Code không có bộ nhớ tích hợp giữa các phiên — nhưng bạn có thể tạo bộ nhớ đó bằng cách lưu session log vào vault.

Sau mỗi phiên, CLAUDE.md hướng dẫn AI ghi một file tóm tắt vào /AI/sessions/, gồm:

• Những gì đã thảo luận hoặc làm trong phiên
• Các quyết định đã được đưa ra
• Việc còn dở, chưa xong
• Bất kỳ thông tin mới nào về sở thích hoặc ngữ cảnh của bạn

Đầu phiên tiếp theo, AI đọc các session log gần nhất trước khi làm bất cứ điều gì. Kết quả: AI biết bạn đang làm gì hôm qua, nhớ rằng dự án Henderson đang bị tạm dừng, biết bạn thích tóm tắt ngắn hơn là giải thích dài dòng.

Bốn workflow tự động hoá có giá trị ngay

Khi hệ thống cơ bản đã chạy, bạn có thể mở rộng với các workflow cụ thể. Đây là bốn cái cho kết quả nhanh nhất.

Những lỗi hay gặp cần tránh

Vault không nhất quán

Claude Code giỏi suy luận về cấu trúc, nhưng sự không nhất quán tạo ra ma sát. Nếu một số dự án nằm trong /Projects và số khác nằm trong /Work/Active, AI phải đoán. Dành một tiếng chuẩn hoá vault trước khi kết nối AI — công sức đó hoàn vốn rất nhanh.

CLAUDE.md quá chung chung

Cập nhật CLAUDE.md mỗi khi bạn thấy AI hiểu sai hoặc làm không đúng kỳ vọng. Hãy coi file này như một tài liệu sống — càng dùng nhiều, bạn càng biết thêm để thêm vào.

Không đọc session log

Session log chỉ có giá trị nếu bạn thực sự đọc chúng. Xây thói quen 2 phút: trước khi bắt đầu phiên mới, lướt qua log của phiên trước. Bạn sẽ bắt được lỗi và tinh chỉnh hướng dẫn trước khi chúng trở thành thói quen xấu của AI.

Dùng AI cho mọi thứ

Nếu bạn cần đổi tên một file, cứ đổi tay. Claude Code có giá trị nhất cho tác vụ liên quan đến tổng hợp nhiều ghi chú, workflow nhiều bước nhất quán, hoặc tạo bản nháp đầu tiên cần nhiều ngữ cảnh. Đừng với tay lấy búa để đóng đinh ghim.

Để Inbox thành bãi rác

Inbox chỉ hoạt động nếu bạn xử lý nó. Đặt một trigger cố định trong ngày — cà phê sáng, cuối buổi trưa, hoặc khi shutdown máy — để chạy workflow inbox processing. Một backlog 200 ghi chú chưa xử lý sẽ làm AI bối rối.

Câu hỏi thường gặp