# Obsidian và Claude Code: nối kho ghi chú với tác tử AI

URL: https://opcaios.org/blog/obsidian-va-claude-code
Ngày: 2026-11-13
Cập nhật: 2026-11-04
Tác giả: Lê Quốc Nghĩa
Chuyên mục: Hướng dẫn

Obsidian và [Claude Code](/tien-ich/claude-code) ghép với nhau bằng cách mở thư mục kho ghi chú (vault) của Obsidian làm thư mục làm việc của Claude Code, để tác tử AI đọc, tóm tắt và đề xuất sửa các ghi chú của bạn. Cách này chạy được vì ghi chú Obsidian là tệp Markdown thường nằm trong một thư mục, nên không cần plugin riêng. Bài này không hứa đây là "bộ não thứ hai tự vận hành": [Claude](/tien-ich/claude) có thể bịa, ghi đè hoặc đọc nhầm ghi chú riêng tư nếu bạn cấu hình lỏng, và chúng tôi chưa đo kho ghi chú giúp tiết kiệm bao nhiêu thời gian. Bài đi qua cách nối an toàn theo 6 bước, một khối CLAUDE.md mẫu đầy đủ, 5 việc nên thử kèm rủi ro, và những điều chúng tôi đã tự kiểm trên tài liệu của Obsidian và Anthropic.

![Sơ đồ nối kho Obsidian với Claude Code: sao lưu, mở kho làm thư mục làm việc, CLAUDE.md, chế độ chỉ đọc, thư mục nháp tách khỏi ghi chú gốc, rồi duyệt từng thay đổi](https://opcaios.org/images/blog/obsidian-va-claude-code/so-do.webp)
*Kho ghi chú, thư mục nháp và lớp duyệt giữa người và tác tử. Sơ đồ: OPCAIOS.*

## Vì sao Obsidian và Claude Code ghép được với nhau?

Obsidian lưu ghi chú dưới dạng tệp văn bản Markdown trong một thư mục trên máy gọi là vault, kể cả thư mục con. Theo trang trợ giúp chính thức đọc ngày 04/11/2026, bạn có thể sửa ghi chú bằng trình soạn thảo khác và Obsidian tự làm mới kho để phản ánh thay đổi bên ngoài; thư mục `.obsidian` ở gốc kho giữ cài đặt riêng như phím tắt, giao diện và plugin cộng đồng. Claude Code, như bài [Claude Code cho người mới bắt đầu](/blog/claude-code-cho-nguoi-moi-bat-dau) đã nêu, làm việc trực tiếp trên tệp trong thư mục bạn mở. Hai công cụ vì thế gặp nhau ở thư mục. Phần nền tảng nằm ở các bài riêng: [Obsidian là gì](/blog/obsidian-la-gi), [second brain là gì](/blog/second-brain-la-gi) và [Obsidian second brain](/blog/obsidian-second-brain-la-gi); bài này chỉ bàn phần nối.

## Nối kho ghi chú an toàn theo 6 bước

Thứ tự đi từ an toàn nhất đến rộng quyền nhất; đừng nhảy bước.

1. **Sao lưu trước khi cho Claude chạm vào kho.** Checkpoint của Claude Code chỉ theo dõi tệp mà công cụ sửa tệp của nó đã đổi; tài liệu chính thức nói thay đổi từ lệnh Bash, chỉnh sửa bên ngoài và tiến trình khác thường không được bắt, và checkpoint không thay thế Git. Hãy chép cả kho sang nơi ngoài thư mục đồng bộ, hoặc dùng Git (`git init`, `git add -A`, `git commit -m "truoc khi dung AI"`; đây là lệnh Git chuẩn, không riêng Claude Code).
2. **Mở Claude Code ngay trong thư mục kho, ở chế độ lập kế hoạch.** Dùng `cd` vào thư mục kho rồi chạy `claude --permission-mode plan`. Chế độ này cho Claude đọc và đề xuất, chặn sửa tệp tới khi bạn duyệt. Bản mới của Claude Code khởi động mặc định ở Auto, nên đừng bỏ cờ này trong những lần đầu.
3. **Viết CLAUDE.md ở gốc kho** (khối mẫu ở mục sau). Tài liệu khuyên dưới 200 dòng và nhắc đây là ngữ cảnh, không phải quy tắc cưỡng chế.
4. **Đặt quy tắc quyền cho phần không được động tới.** Thêm tệp `.claude/settings.json` trong kho, hoặc gõ `/permissions` trong phiên, để từ chối sửa thư mục ghi chú gốc và `.obsidian`.
5. **Tạo thư mục nháp tách riêng**, ví dụ `_nhap-ai/`, và bảo Claude chỉ viết kết quả vào đó. Bạn tự chuyển ghi chú đạt yêu cầu sang chỗ chính.
6. **Mở rộng quyền từng nấc.** Chỉ chuyển sang chế độ tự nhận sửa (`acceptEdits`) khi bản sao lưu còn mới và thư mục nháp đã chạy ổn vài lần.

Ví dụ quy tắc quyền (giả định tên thư mục, sửa theo kho của bạn):

```json
{
  "permissions": {
    "deny": [
      "Edit(/01-ghi-chu-goc/**)",
      "Edit(/.obsidian/**)",
      "Read(/rieng-tu/**)"
    ]
  }
}
```

Theo trang phân quyền, dấu `/` ở đầu trong tệp cài đặt dự án nghĩa là tính từ thư mục làm việc chính, và quy tắc từ chối được kiểm trước quy tắc cho phép. Giới hạn cần biết: quy tắc áp dụng cho công cụ tệp của Claude và các lệnh tệp phổ biến, không áp dụng cho một đoạn mã tự mở tệp; muốn chặn cứng ở mức hệ điều hành phải bật sandbox. Xem thêm [chế độ lập kế hoạch và quyền](/blog/plan-mode-va-che-do-quyen-trong-claude-code).

## CLAUDE.md mẫu cho kho ghi chú

CLAUDE.md là tệp Markdown ở gốc thư mục làm việc mà Claude đọc đầu mỗi phiên, dùng để ghi cấu trúc kho và quy tắc làm việc thay vì giải thích lại. Khối dưới đây là mẫu đầy đủ, chép vào tệp `CLAUDE.md` rồi sửa tên thư mục:

```markdown
# Quy tắc làm việc trong kho ghi chú này

## Cấu trúc
- 01-ghi-chu-goc/: ghi chú chính của tôi. CHỈ ĐỌC, không sửa, không xoá.
- _nhap-ai/: nơi duy nhất bạn được tạo hoặc sửa tệp.
- rieng-tu/: không đọc, không nhắc tới.
- .obsidian/: cấu hình Obsidian, không đụng tới.

## Cách làm
- Luôn đưa kế hoạch trước, chờ tôi đồng ý rồi mới ghi tệp.
- Mọi kết quả mới ghi vào _nhap-ai/, tên tệp theo dạng YYYY-MM-DD-chu-de.md.
- Giữ nguyên định dạng liên kết [[...]] và phần frontmatter của Obsidian.
- Khi trích ý từ ghi chú, ghi rõ tên tệp nguồn.
- Không chắc thì ghi "chưa chắc", không bịa nguồn hay số liệu.
- Với việc gắn thẻ hoặc dọn trùng: chỉ liệt kê đề xuất, không tự áp dụng.
```

Nếu kho của bạn đã có một tệp quy tắc dùng chung cho nhiều công cụ AI tên `AGENTS.md`, tài liệu chính thức nói Claude Code đọc nó khi không có CLAUDE.md (từ bản 2.1.277), và bạn có thể đặt dòng `@AGENTS.md` ở đầu CLAUDE.md để dùng một nguồn cho mọi công cụ. Chi tiết từng dòng nằm ở bài [CLAUDE.md là gì](/blog/claude-md-la-gi).

## 5 việc nên thử với kho ghi chú

Bảng là gợi ý của OPCAIOS, chưa đo hiệu quả. Bắt đầu bằng một thư mục con nhỏ, không phải cả kho.

| Việc | Cách giao (rút gọn) | Rủi ro chính | Cách kiểm |
|---|---|---|---|
| Tóm tắt | "Tóm tắt 5 ghi chú trong thư mục X vào _nhap-ai/" | Bỏ sót hoặc thêm ý không có | Đối chiếu với ghi chú gốc |
| Gắn thẻ | "Đề xuất thẻ cho từng ghi chú, chỉ liệt kê" | Thẻ tự đặt, phá hệ thống thẻ cũ | Chỉ áp dụng sau khi bạn duyệt |
| Tìm liên kết | "Gợi ý ghi chú nào nên liên kết với nhau và vì sao" | Liên kết gượng ép | Mở cả hai ghi chú để xác nhận |
| Soạn nháp từ ghi chú | "Dựng dàn ý bài viết từ các ghi chú này, ghi nguồn" | Bịa chi tiết, nhầm nguồn | Mỗi ý phải trỏ về tên tệp |
| Dọn trùng | "Liệt kê các ghi chú nghi trùng, đừng xoá" | Xoá nhầm ghi chú khác nhau | Không bao giờ cho xoá tự động |

## Rủi ro nào cần chặn trước khi cho Claude đọc kho?

Có ba rủi ro: ghi đè, lộ ghi chú riêng và thông tin bịa. Ghi đè xảy ra khi Claude sửa tệp gốc và bạn không có bản lưu, nên sao lưu và thư mục nháp là hàng rào chính. Lộ ghi chú riêng xảy ra vì nội dung tệp Claude đọc đi vào phiên làm việc, và theo trang Data usage đọc ngày 04/11/2026, Claude Code gửi lời nhắc cùng đầu ra qua mạng tới mô hình. Với tài khoản Free, Pro, Max, Ultra, tài liệu ghi bạn có tuỳ chọn cho phép dùng dữ liệu huấn luyện (cho phép thì giữ 5 năm, không thì 30 ngày); với Team, Enterprise và API là điều khoản thương mại, giữ chuẩn 30 ngày. Cách an toàn nhất là để nhật ký cá nhân, sức khoẻ, tài chính, mật khẩu ngoài thư mục làm việc hoặc chặn bằng quy tắc `Read`. Rủi ro thứ ba, thông tin bịa, chỉ giảm được bằng việc bắt Claude ghi nguồn và bạn tự đối chiếu.

## Kinh nghiệm của OPCAIOS

OPCAIOS dùng một kho Obsidian làm kho tri thức và một file quy tắc chung cho mọi tác tử AI (Claude Code, Codex, Antigravity, mỗi công cụ một vai trò). File đó quy định thứ tự đọc tài liệu đầu phiên và ghi nhật ký cuối phiên, để các tác tử không làm lệch nhau. Chúng tôi chưa có số liệu năng suất, chưa đo số giờ tiết kiệm và chưa có khách ngoài dùng cách này; Case Study #0 đang chạy trên chính anh Nghĩa. Chúng tôi cũng chưa thử công cụ dòng lệnh chính thức của Obsidian (tài liệu ghi có từ bản 1.12.7). Vì vậy bài này là quy trình thận trọng, không phải kết quả đã chứng minh.

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

### Obsidian có miễn phí khi dùng với Claude Code không?

Phần Obsidian thì có: trang giá chính thức đọc ngày 04/11/2026 ghi dùng cá nhân miễn phí không giới hạn, và dùng cho công việc thì không bắt buộc mua giấy phép thương mại (có khuyến khích). Phần Claude Code thì không miễn phí: gói Free của claude.ai không bao gồm Claude Code theo trang cài đặt chính thức. Bạn cần gói trả phí hoặc tài khoản API.

### Claude Code có sửa nhầm ghi chú của tôi không?

Có thể, nếu bạn cho phép ghi và không có bản sao lưu. Để giảm rủi ro: sao lưu hoặc dùng Git trước, mở ở chế độ lập kế hoạch, cho Claude ghi vào thư mục nháp riêng và từ chối sửa thư mục ghi chú gốc bằng quy tắc quyền. `/rewind` hỗ trợ khôi phục tệp mà công cụ sửa tệp đã đổi nhưng không phải mọi thay đổi, và không thay Git.

### Claude Code có đọc toàn bộ ghi chú riêng tư của tôi không?

Nó đọc những gì nằm trong thư mục làm việc khi cần cho yêu cầu, và việc đọc trong thư mục đó không cần xin phép theo trang phân quyền. Nội dung đọc được đi vào phiên và gửi tới mô hình. Để giữ riêng tư, đặt ghi chú nhạy cảm ngoài thư mục làm việc hoặc thêm quy tắc từ chối `Read` cho thư mục đó, và kiểm cài đặt dữ liệu của tài khoản.

### Có cần plugin Obsidian để dùng Claude Code không?

Không bắt buộc. Vì ghi chú là tệp Markdown trong thư mục, Claude Code mở thư mục kho là làm việc được. Plugin cộng đồng là lớp tiện lợi thêm; chúng tôi chưa đánh giá cái nào.

### Khác gì giữa bài này và các bài về Obsidian, second brain?

Các bài nền tảng trả lời Obsidian là gì, second brain là gì và cách tổ chức kho ghi chú. Bài này chỉ trả lời câu hỏi nối kho đó với tác tử AI sao cho an toàn.

## Bước tiếp theo

Chép khối CLAUDE.md mẫu ở trên vào gốc một kho thử (bản sao nhỏ, đã sao lưu), mở Claude Code ở chế độ lập kế hoạch và giao đúng một việc: tóm tắt 5 ghi chú vào thư mục nháp. Đọc kết quả, đối chiếu với ghi chú gốc, rồi mới nghĩ tới việc thứ hai.

*Nguồn: trang trợ giúp Obsidian (Vault, How Obsidian stores data, Obsidian CLI) và trang giá obsidian.md; tài liệu Claude Code của Anthropic (quickstart, memory, permissions, permission modes, checkpointing, data usage) và claude.com/pricing, đọc ngày 04/11/2026. Chưa kiểm chứng: hiệu quả thực tế với kho lớn, hành vi khi kho nằm trong thư mục đồng bộ đám mây, công cụ dòng lệnh Obsidian, plugin cộng đồng; chưa chạy thử các khối cấu hình mẫu trên kho thật. Kinh nghiệm là của OPCAIOS.*