NateCueClaudian - Claude Agent Trong Obsidian
Claudian biến vault Obsidian của bạn thành working directory của Claude Code - AI có thể đọc/ghi file, tìm kiếm, chạy bash, và thực hiện workflow nhiều bước ngay trong ứng dụng ghi chú.
Là gì / Hoạt động sao
Claudian là Obsidian community plugin (mã nguồn mở, MIT) do YishenTu phát triển. Thay vì phải mở terminal riêng để chạy claude CLI, bạn chat trực tiếp với AI agent ngay trong sidebar của Obsidian.
Cách hoạt động:
- Plugin kết nối đến Claude Code CLI (hoặc Codex CLI) đã cài sẵn trên máy
- Vault Obsidian trở thành working directory - agent có quyền đọc/ghi toàn bộ file trong vault
- Mọi thao tác (tạo note, sửa nội dung, tìm kiếm từ khóa) đều chạy qua agent, không qua Obsidian API thông thường
Yêu cầu:
- Claude Code CLI đã cài và đăng nhập (hoặc Codex CLI nếu dùng OpenAI)
- Obsidian v1.4.5+
- Desktop only (macOS, Linux, Windows) - không chạy trên mobile
Tính năng chính
Chat Sidebar
Mở từ ribbon icon hoặc Command Palette. Giao tiếp với agent bằng ngôn ngữ tự nhiên - agent tự quyết định cần đọc file nào, ghi gì, và thực thi các bước ra sao.
Inline Edit
Bôi đen đoạn text bất kỳ trong note + nhấn hotkey - agent sẽ chỉnh sửa trực tiếp vào vị trí đó với word-level diff preview (xem sự thay đổi từng từ trước khi chấp nhận).
Slash Commands & Skills (/ hoặc $)
Tạo prompt template tái sử dụng ở cấp user hoặc vault. Ví dụ: /summarize, /translate, /format-note - gõ là chạy ngay.
@mention
Gõ @ để đính kèm bất kỳ thứ gì vào context của agent:
- File trong vault
- Subagents khác
- MCP servers
- File bên ngoài vault
Plan Mode (Shift+Tab)
Bật chế độ “lên kế hoạch trước”. Agent khám phá và thiết kế phương án, trình bày plan để bạn duyệt trước khi thực thi - an toàn hơn cho các tác vụ phức tạp hoặc thay đổi nhiều file.
MCP Servers
Kết nối công cụ bên ngoài qua Model Context Protocol (stdio, SSE, HTTP). Ví dụ: kết nối Notion, Jira, hoặc database để agent có thể thao tác từ trong Obsidian.
Multi-Tab & Conversation History
Mở nhiều tab chat song song, fork conversation, resume session cũ, và compact (tóm gọn) hội thoại dài.
Cài đặt (Cách đơn giản nhất - GitHub Release)
- Vào Releases, tải 3 file:
main.js,manifest.json,styles.css - Tạo folder trong vault:
vault/.obsidian/plugins/claudian/ - Copy 3 file vừa tải vào folder đó
- Mở Obsidian: Settings → Community plugins → Enable “Claudian”
Cách khác - Dùng BRAT (tự động update):
- Cài plugin BRAT từ Community Plugins
- Mở BRAT Settings → Add Beta plugin
- Nhập:
https://github.com/YishenTu/claudian - BRAT cài tự động và thông báo khi có bản mới
Xử lý lỗi thường gặp
Lỗi: Claude CLI not found / spawn claude ENOENT
Plugin không tìm thấy CLI - hay xảy ra khi dùng Node version manager (nvm, fnm, volta).
Tìm đường dẫn CLI:
which claude # macOS/Linux
where.exe claude # WindowsRồi điền vào: Settings → Advanced → Claude CLI path
Điểm hay - Tại sao cần dùng
- Không cần rời Obsidian: Toàn bộ workflow AI (nghiên cứu, viết, chỉnh sửa, tổ chức note) chạy ngay trong vault - không context-switch sang terminal hay trình duyệt.
- Agent thực sự, không chỉ là chatbot: Claudian dùng Claude Code SDK - agent tự đọc file, tự viết, tự tìm kiếm, thực thi nhiều bước liên tiếp mà không cần hướng dẫn từng bước.
- Inline Edit với diff preview: Chỉnh sửa chính xác từng đoạn text, xem thay đổi trước khi chấp nhận - an toàn hơn nhiều so với chat thông thường.
- Plan Mode = kiểm soát tốt hơn: Với tác vụ lớn (viết lại 20 note, restructure vault), bật Plan Mode để duyệt plan trước - tránh AI làm sai hàng loạt.
- MCP mở rộng không giới hạn: Kết nối thêm Notion, Jira, Supabase - vault Obsidian trở thành hub điều phối mọi công cụ.
- Privacy: Không có telemetry - dữ liệu chỉ gửi đến API provider bạn cấu hình (Anthropic, OpenRouter, Kimi…).