Multi Vault Project Specific Setup: Vault Per Project 2026

Multi vault project specific setup là pattern chia knowledge thành vault riêng theo project hoặc theme thay vì 1 vault gigant. Pattern này phù hợp developer làm việc trên 3+ project hoặc cần tách work / personal / research, tránh context pollution và cải thiện query precision của Claude Code.

Bài này deep-dive cấu trúc multi-vault, khi nào nên split (vs 1 vault), workflow chuyển vault, integration với Claude Code per-vault context. Bài pillar Obsidian + Claude Code cover single-vault setup, bài này focus advanced multi-vault.

Khi Nào Nên Split Sang Multi-vault?

3 signal rõ ràng vault cần split. Một, vault >2000 notes làm /wiki-query standard mode chậm dần (15s+) vì index size lớn. Hai, làm việc >3 project song song khiến /wiki-query trả về note không liên quan project hiện tại. Ba, có sensitive data (work credentials, client info) cần tách rõ khỏi personal note.

3 signal vault chưa cần split. Vault <500 notes vẫn manage được single. 1-2 project chính ít overlap context. Solo developer chưa có shared knowledge với team.

Pattern khuyến nghị cho developer điển hình. Vault 1 personal-knowledge (technology learning, blog draft, research). Vault 2 work-project-A (current main work, daily note, meeting note). Vault 3 work-project-B (client work, documentation). Vault 4 family-personal (private, tách biệt work). Cấu hình này cover 90% use case mà không tạo over-fragmentation.

Anti-pattern. Tạo vault per topic (tech, AI, design, …) tạo 10+ vault không quản lý được. Tạo vault per month (note-2026-01, note-2026-02) là nhầm với log rotation, dùng /wiki-fold thay thế. Tạo vault clone của vault khác (backup workflow), dùng Git instead.

Cluster Obsidian + Claude Code có pillar overview, 3-layer architecture, /wiki bootstrap cover cấu trúc cơ bản. Bài này tiếp theo phase advanced khi vault đã grow đủ lớn cần split.

Cấu Trúc Multi-vault Như Thế Nào?

Mỗi vault là folder độc lập với cấu trúc PARA + 3-layer pattern riêng.

~/vaults/
├── personal-knowledge/
│   ├── .obsidian/
│   ├── 00-inbox/
│   ├── 10-projects/
│   ├── 20-areas/
│   ├── 30-resources/
│   ├── 40-archive/
│   ├── wiki/
│   │   ├── hot.md
│   │   ├── index.md
│   │   ├── log.md
│   │   ├── sources/
│   │   ├── entities/
│   │   └── concepts/
│   └── CLAUDE.md
├── work-project-a/
│   └── (similar structure)
├── work-project-b/
│   └── (similar structure)
└── family-personal/
    └── (similar structure)

Mỗi vault có 4 file critical riêng. Một, CLAUDE.md define context, conventions, rules cho project. Hai, wiki/hot.md cache 500 từ recent context. Ba, wiki/index.md master catalog. Bốn, wiki/log.md activity log.

Pattern share content giữa vault. Symlink chỉ dùng cho file tham chiếu chung (ví dụ ~/vaults/_shared/coding-style.md symlink vào mỗi vault). Avoid symlink active note, gây confusion về source-of-truth.

Disk space consideration. Vault 1000 note ~50MB. 5 vault tổng 250MB acceptable. Plugin folder .obsidian/ mỗi vault ~30MB nếu nhiều plugin, tổng 150MB. Total 400MB cho 5 vault active. Backup full hàng tuần (4GB) qua Backblaze hoặc Time Machine.

Naming convention. Vault folder name lowercase với hyphen: work-project-a không Work_Project_A. Vault display name (Obsidian shows) capitalize đẹp. Naming consistent giúp Claude Code path resolution và memory hint hữu ích.

Workflow Chuyển Giữa Vault Ra Sao?

Claude Code resolve vault qua working directory. cd ~/vaults/work-project-a rồi claude trong terminal mở Claude Code với vault đó là context. CLAUDE.md trong root vault được load auto.

Workflow daily điển hình.

1. Sáng: cd vào personal-knowledge, mở Claude Code, /daily generate note today.
2. Trưa work session: switch vào work-project-a, /daily-work generate note với template work.
3. Chiều research: switch vào personal-knowledge, /save URL và /wiki-ingest article.
4. Tối review: switch vào work-project-b nếu có client task, kiểm meeting notes.

Switch vault tốn ~5 giây (close Claude Code, cd, reopen). Pattern hiệu quả: 1 terminal tab per vault, alt-tab giữa tab thay vì close/reopen.

Cross-vault query. Khi cần data từ vault khác, có 2 approach. Một, explicit reference: prompt “Đọc file ~/vaults/work-project-a/wiki/hot.md và summarize”. Claude Code đọc qua absolute path. Hai, copy file qua: ngắn gọn nhưng break source-of-truth, avoid trừ archive.

Hot.md per-vault. Mỗi vault có hot.md riêng cập nhật theo session trong vault đó. Switch vault = swap hot.md context. Pattern này giữ context cô lập giữa work và personal.

Setup tip. Đặt alias shell cho từng vault: alias vp='cd ~/vaults/personal-knowledge && claude', alias vw='cd ~/vaults/work-project-a && claude'. Switch vault thành 1 command, save 5-10 giây/lần.

Per-vault CLAUDE.md Setup Như Thế Nào?

CLAUDE.md là context file Claude Code đọc auto khi mở vault. Mỗi vault có CLAUDE.md riêng define rule và convention specific cho project.

Sample CLAUDE.md cho personal-knowledge vault.

# Personal Knowledge Vault

## Context
Vault tổng hợp learning, research, blog draft cho ongboit.com.
Audience: developer.

## Conventions
- Note tiếng Việt full diacritics
- Frontmatter chuẩn: type, tags, created, source
- Wikilink dùng [[]] consistent
- Daily note location: 00-inbox/daily/YYYY-MM-DD.md

## AgriciDaniel skills active
/wiki, /save, /wiki-ingest, /defuddle, /wiki-query, /wiki-lint, /wiki-fold

## Out of scope
- Work project task (use work-project-a vault)
- Sensitive credentials (use 1Password)

Sample CLAUDE.md cho work-project-a vault.

# Work Project A Vault

## Context
Client X engagement, focus content marketing audit.
Confidential: do not share data outside this vault.

## Conventions
- Note tiếng Anh (client communication)
- Frontmatter: type, project, status, due_date
- Meeting note: 10-projects/meetings/YYYY-MM-DD-topic.md

## AgriciDaniel skills active
/wiki, /save, /wiki-ingest, /wiki-query, /canvas (project diagram)

## Privacy rules
- Không paste API key, credential
- Không upload file binary client-sensitive
- Backup encrypt qua Cryptomator

CLAUDE.md per-vault giúp Claude Code không nhầm context giữa work và personal. Naming convention work English, personal Vietnamese tự động enforce qua context. Skill set per-vault tùy use case.

Anti-pattern. CLAUDE.md duplicate khắp 5 vault với content giống hệt. Solution: shared file ~/vaults/_shared/CLAUDE-base.md, từng vault import qua reference markdown. Hoặc copy 1 lần và customize 30%, 70% giống nhau.

Use Case Cụ Thể Nào Cho Developer?

Mình personal apply 4 vault active sau 18 tháng dùng Obsidian + Claude Code.

Vault 1, personal-knowledge (1200 notes). Learning AI, Claude Code, n8n, web dev. Blog draft cho ongboit.com. Research source ingest qua /wiki-ingest. CLAUDE.md focus content creation và Vietnamese tone.

Vault 2, work-client-content (800 notes). Client content audit, blog ghostwrite, SEO research. CLAUDE.md focus English communication và confidentiality.

Vault 3, work-personal-business (300 notes). Personal business operations: invoice, contract template, vendor list. CLAUDE.md focus financial precision và compliance.

Vault 4, family-personal (200 notes). Tách biệt hoàn toàn khỏi work. Health, family planning, hobby. CLAUDE.md focus privacy.

Workflow daily. Sáng vault 4 (planning), morning vault 1 (learning + blog), trưa vault 2 (client work), chiều vault 1 (blog continue), tối vault 3 (admin tasks). Switch 4-5 lần/ngày, total <2 phút overhead.

KPI track per-vault. Vault size (note count + MB), query response time, weekly write count. Mình personal track qua /wiki-stats slash command, output report mỗi cuối tuần.

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

Có thể merge 2 vault thành 1 sau khi split không?

Có. Copy mọi note từ vault A vào vault B với prefix/folder để avoid name collision. Update CLAUDE.md merge rule. Run /wiki-lint full để fix dead link. Process tốn 1-2 giờ cho vault 500 notes. Không recommend merge thường xuyên, plan vault structure upfront.

Sync vault qua đâu (iCloud, Sync, Git)?

Iniglio Obsidian Sync chính thức (chính chủ, hỗ trợ mobile, premium ~$4/tháng). iCloud miễn phí cho Apple ecosystem (chậm với vault lớn). Git tốt cho version control + free, cần manual conflict resolution. Bài Obsidian sync mobile multi-device cover detail comparison.

Plugin có cần install riêng cho mỗi vault không?

Có. Mỗi vault có folder .obsidian/plugins/ riêng. Install cùng plugin set 5 lần tốn thời gian. Workaround: dùng Obsidian Plugin Sync feature (premium) hoặc copy .obsidian/ từ vault template sang vault mới khi tạo.

CLAUDE.md có hierarchical inherit được không?

Có ở mức limited. Claude Code đọc CLAUDE.md trong working directory + parent directories. Setup ~/vaults/CLAUDE.md chứa rule chung, từng vault có CLAUDE.md specific. Hierarchical inherit này native trong Claude Code, no extra config needed.

Tốn LLM cost nhiều hơn khi multi-vault không?

Không nhiều hơn. Mỗi vault có hot.md/index.md riêng nhưng size nhỏ hơn 1 mega-vault. Total token/query stable hoặc giảm vì query precise hơn không pull noise. Cost net neutral hoặc giảm 10-20%.

Có công cụ visual track all vault status không?

Có với /obsidian-bases plugin từ v1.7+. Tạo .base file trong root parent folder track properties: vault_name, note_count, last_modified, size_mb. Dashboard view show all vault tổng quan. Bài /canvas + /obsidian-bases visual layer cover detail.

Bạn Setup Multi-vault Như Thế Nào?

Tuần 1, audit single vault hiện có. Đếm notes per project, identify 2-3 cluster lớn nhất sẽ split. Tuần 2, tạo vault thứ 2 cho project active nhất. Move notes liên quan, setup CLAUDE.md riêng. Tuần 3, observe pattern: query có precise hơn không, switch vault có tốn thời gian không. Tuần 4, decide có tạo vault thứ 3 hay revert single. Build incrementally, không split tất cả 1 lần.

Vault sensitive thì sao? Nếu vault chứa client data hoặc work confidential, đọc tiếp privacy security Obsidian LLM để setup encryption 3 layer + secret management trước khi integrate Claude Code.

Tham khảo cluster Obsidian + Claude Code: pillar setup, 3-layer architecture, /wiki bootstrap, vault structure PARA, CLAUDE.md trong vault, sync multi-device, 11 skills overview. Bài này (E-2) là spoke advanced cho multi-vault, complement single-vault setup ở pillar.

Tài liệu tham khảo bên ngoài

• Obsidian, Manage multiple vaults (official).
• CLAUDE.md hierarchical memory (Anthropic), per-folder context.