# Aula 2.4: VS Code + Obsidian, o vault como projeto (passo a passo)

Você vai abrir a mesma pasta no Obsidian e no VS Code, mandar o Claude Code criar dez notas ligadas
e ver o grafo crescer. Tempo: cerca de 25 minutos. Conferido em 30/10/2026.
Detalhes em `primeiro-vault.md`, prompt em `prompt-dez-notas.md`, modelo em `modelo-de-nota.md`.

## Antes de começar
- VS Code com a extensão do Claude Code (aula 2.1) e conta paga.
- O `CLAUDE.md` do vault da aula 2.2 (ou o trecho final de `modelo-de-nota.md`).
- Modo de permissão: Auto com Plan, como na aula 2.1.

## Passos
1. **Instale o Obsidian** (https://obsidian.md/download). Grátis, sem conta.
2. **Crie a pasta** `C:\curso-claude\cafe-aurora\` e abra no Obsidian: "Open folder as vault".
3. **Abra a mesma pasta no VS Code** (Arquivo, Abrir Pasta) e o painel do Claude Code.
4. **Crie o `CLAUDE.md` do vault** (aula 2.2): frontmatter nas notas novas, nunca apagar, links como `[[Nome]]`, não mexer em `.obsidian`.
5. **Rode `git init`** no terminal do VS Code (`` Ctrl+` ``). Proteção contra qualquer estrago.
6. **Cole o prompt das dez notas** (`prompt-dez-notas.md`). Leia a lista, edite o plano se quiser, aprove.
7. **Aprove a criação.** Aparecem dez `.md` e o `00-Indice`.
8. **Abra uma nota no VS Code** e confira o frontmatter (entre os `---`) e os `[[links]]`.
9. **Volte ao Obsidian**, `Ctrl+G` abre o grafo. Siga Cappuccino, Laticínio Serra, Lucas, Maurício.
10. **Peça a síntese** (último prompt do arquivo) e veja o novo nó central.
11. **Faça o commit** da pasta. A entrega é o vault com dez notas ligadas.

## Conceitos
- **Vault** é uma pasta. **Frontmatter** (campos entre `---` no topo) é o que o Claude lê sem abrir a nota toda, e o que as Bases do Obsidian usam para montar tabelas. **Wikilink** `[[assim]]` é a aresta do grafo.
- **Segundo cérebro** é o nome de marketing. A prática é esta: notas curtas, ligadas, que o agente consulta.
- **RAG sem servidor:** o Claude consulta só as notas validadas. O protocolo de resposta vem do `CLAUDE.md` (aula 2.2); o grafo e o RAG a fundo ficam para a 2.4.
- **MCP de memória: precisa?** Quase nunca no começo. Markdown versionado em pasta resolve a maior parte (opinião da comunidade, `palpite`: a thread do HN citada na pesquisa não foi reaberta em 30/10/2026).

## Onde isso quebra
- **Grafo sem arestas.** O wikilink tem de ter o nome exato da nota. Peça ao Claude para corrigir os links.
- **Claude apagou ou mexeu em algo.** `CLAUDE.md` é pedido, não bloqueio. Volte pelo git.
- **Notas duplicadas.** Mande procurar antes de criar (regra do `CLAUDE.md`).
- **Vault pessoal aparecendo no print.** Use só o Café Aurora (fictício) nas capturas.
- **Licença do Obsidian.** Grátis; uso no trabalho tem licença comercial recomendada (obsidian.md/pricing, 30/10/2026).
- **Instalar MCP do Obsidian cedo demais.** Comece sem. Se for usar: precisa de chave de API local e expõe o vault inteiro ao Claude; verifique licença e atividade antes (critério do módulo 3).

## Entrega (60 XP)
Vault próprio com dez notas ligadas pelo Claude Code, `CLAUDE.md` do vault na raiz, e commit. Use `checklist.md`.

## Links oficiais (acesso em 30/10/2026)
- https://obsidian.md/help/vault
- https://obsidian.md/help/links
- https://code.claude.com/docs/en/vs-code
- https://code.claude.com/docs/en/memory
- https://code.claude.com/docs/en/mcp