Cách kết hợp Claude Code với Obsidian CLI

Sau nhiều năm người dùng phải sống chung với một kho lưu trữ đầy hỗn loạn, Claude Code đã làm được điều mà không một plugin nào có thể làm được.

Nếu đã sử dụng Obsidian để ghi chú hơn một năm, có lẽ kho lưu trữ của bạn là một mớ hỗn độn. Hãy thử giao vấn đề cho Claude Code, kết hợp nó với một vài lệnh CLI của Obsidian, và chứng kiến ​​nó làm được điều mà bạn đã không thể làm được trong nhiều năm, chỉ trong khoảng 90 phút.

Claude Code là gì? Tại sao nó lại quan trọng đối với việc ghi chú?

Một AI hoạt động trong terminal, không phải hộp trò chuyện

Nếu bạn chưa biết, Claude Code là công cụ AI dòng lệnh của Anthropic. Không giống như giao diện truyền thống của Claude, Claude Code hoạt động trực tiếp trong terminal, đọc các file từ hệ thống cục bộ, viết và chỉnh sửa code, thực hiện các tác vụ nhiều bước một cách tự động mà không cần bạn phải quản lý từng prompt.

Điểm cuối cùng đó chính là điều làm nên sự khác biệt của Claude Code. Hầu hết các công cụ AI yêu cầu bạn phải liên tục tham gia vào quá trình tương tác, trao đổi thông tin qua lại. Claude Code có thể được giao một mục tiêu, cấp quyền truy cập vào một thư mục và được tin tưởng để tự giải quyết vấn đề một cách có hệ thống. Nó nhìn nhận hệ thống file của bạn theo cách của một nhà phát triển, chứ không phải theo cách của một chatbot.

Đối với một nhiệm vụ như sắp xếp lại kho ghi chú, sự khác biệt đó có ý nghĩa vô cùng quan trọng.

Cách kết nối Claude Code với Obsidian vault

Tại sao notesmd-cli là công cụ phù hợp cho công việc này?

Để thực hiện việc này, hãy sử dụng notesmd-cli. Mặc dù Obsidian đã phát hành CLI chính thức vào đầu năm 2026, nhưng hiện chưa thể sử dụng được. notesmd-cli là tiêu chuẩn cộng đồng thực tế; nó miễn phí, cài đặt thông qua một lệnh Homebrew duy nhất và xử lý những tác vụ nặng nhọc: đổi tên hàng loạt 63 ghi chú "Untitled", chỉnh sửa phần đầu để chuẩn hóa việc gắn thẻ lộn xộn và di chuyển các file mà không cần phải mở ứng dụng Obsidian.

Sự kết hợp của hai công cụ tạo ra một thứ thực sự hữu ích: Một AI có thể đọc mọi ghi chú trong kho lưu trữ của bạn, hiểu nội dung và sau đó thực hiện hành động, đổi tên, gắn thẻ, di chuyển, liên kết, mà bạn không cần phải theo dõi từng quyết định.

Cách cấu trúc các prompt Claude Code để dọn dẹp kho dữ liệu

Phương pháp ba giai đoạn giúp bạn kiểm soát mọi thứ

Hãy đưa cho Claude Code một bản tóm tắt cụ thể, được chia thành các giai đoạn:

• Giai đoạn 1: Kiểm tra kho dữ liệu. Lập danh mục những gì có trong đó, tên file, thẻ hiện có, vị trí thư mục, danh mục nội dung sơ bộ, v.v..., sau đó báo cáo lại bản tóm tắt trước khi động vào bất cứ thứ gì.
• Giai đoạn 2: Đề xuất cấu trúc thư mục và phân loại thẻ dựa trên những gì thực sự được tìm thấy, chứ không phải những gì bạn nghĩ là có ở đó.
• Giai đoạn 3: Thực hiện việc sắp xếp lại, từng file một, với nhật ký của mọi thay đổi được thực hiện để bạn có thể xem xét (và hoàn tác, nếu cần) sau đó. Hãy buộc Claude phải tuân theo một giao thức nghiêm ngặt 'chỉ xem chứ không được động vào'.

Những gì Claude Code phát hiện ra khi phân tích ghi chú

Cách phân loại sẽ thay đổi cách bạn nhìn nhận kho lưu trữ của mình

Bản tóm tắt mà Claude Code trả về sau giai đoạn đầu tiên sẽ thực sự khiến bạn phải suy ngẫm. Trong số 847 ghi chú, khoảng 340 ghi chú không có thẻ, trong khi 200 ghi chú khác sử dụng các thẻ được áp dụng không nhất quán. Ngoài ra còn có 14 thư mục khác nhau với mục đích chồng chéo. 63 file khác được đặt tên theo một biến thể nào đó của "Ghi chú không tiêu đề". Cuối cùng là 11 file trống.

Mọi thứ có thể tệ hơn bạn nghĩ.

Điều hữu ích nhất là cách phân loại mà quá trình kiểm tra tạo ra. Nó đã xác định 7 nhóm nội dung rõ ràng trong kho lưu trữ dựa trên văn bản thực tế của các ghi chú: Nội dung viết chuyên nghiệp, nhật ký cá nhân, nghiên cứu du lịch, tham khảo công nghệ, ghi chú sách và nội dung media, theo dõi sức khỏe và một nhóm tổng hợp các mục khác. Các kho lưu trữ không thể sắp xếp giống hệt nhau.

Cách Claude Code xây dựng cấu trúc thư mục từ đầu

Tổ chức dựa trên bằng dấu hiệu tốt hơn tổ chức dựa trên ý định

Hệ thống phân loại do Claude Code đề xuất gọn gàng hơn bất cứ thứ gì bạn tự thiết kế, chính xác là vì nó dựa trên dấu hiệu chứ không phải ý định.

Nó đề xuất một cấu trúc thư mục tương đối phẳng với 7 thư mục cấp cao nhất phù hợp với các cụm nội dung, sử dụng một sơ đồ thẻ nhất quán với những thẻ viết thường, có dấu gạch ngang. Nó đánh dấu 11 file trống để xóa sau khi xác nhận. Nó cũng đề xuất chuyển 63 ghi chú không có tiêu đề vào một thư mục xem xét duy nhất thay vì đoán danh mục của chúng, đó là một quyết định đúng đắn.

Điều gì thực sự xảy ra khi Claude Code sắp xếp lại kho dữ liệu của bạn?

Bạn không cần phải theo dõi toàn bộ quá trình. Hãy đi pha cà phê, trả lời một vài email, lướt mạng xã hội, rồi quay lại. Điều bạn nhận được khi trở lại là nhật ký thay đổi, một file plain text mà Claude Code đã tạo trong thư mục gốc kho dữ liệu, ghi lại mọi hành động đã được thực hiện.

Kho dữ liệu, được mở trong Obsidian lần đầu tiên sau đó, trông khác hẳn ngay lập tức. Chế độ xem đồ thị, thứ thường bị từ bỏ vì cho là vô dụng, giờ đây hiển thị các cụm thực sự dễ đọc. 7 danh mục nội dung được phê duyệt hiển thị dưới dạng các khu vực lân cận trong hình ảnh trực quan.

Hãy dành khoảng 30 phút để xem lại nhật ký thay đổi, kiểm tra ngẫu nhiên các thao tác di chuyển và xác nhận những file trống đã bị xóa.