Claude Code as a personal assistant — vault, environment and site

I spent a vacation weekend setting up a system I’d been putting off for months, using Claude Code as the main collaborator. I came out the other side with something I actually use — and a few conclusions about what this kind of tool does well.

The vault as foundation

Claude Code works well with an Obsidian vault because it has direct access to the filesystem. It reads, writes, and edits Markdown while respecting wiki links, YAML frontmatter, and Obsidian’s conventions — which means the notes it creates behave exactly like ones you’d create manually.

From there, what you gain is the ability to delegate the mechanical work of the system. Creating a study note about Java, for example, doesn’t just mean creating a file — it means identifying already-existing related notes in the vault, linking back from them, logging the activity in the day’s daily note with context. Each step individually is simple. Together, it’s the kind of friction that makes you not create the note.

Claude handles that as part of the flow. You mention the topic, it creates the note in the right place, links where it makes sense, and logs what was done. The vault grows consistently without having to manage the structure manually.

Beyond that, I built a set of specialized commands for different types of capture — daily notes with a morning briefing, weekly review, work session logging, quick learning capture. Each one knows where to write and how to integrate with what already exists. It’s not automation for its own sake — it’s reducing the friction between having something in mind and having it recorded in a useful way.

Neovim and the development environment

I use Neovim as my main editor, so I wanted the interaction with the vault to work from within nvim. The configuration involved integrating obsidian.nvim, creating vault-specific keybindings — navigate notes, quick capture, backlinks, wikilink autocomplete — and connecting with file navigation tools.

The most useful result was a keyboard shortcut that opens the daily note as a scratchpad directly from the window manager. One keypress, the day’s note appears. Another, it’s gone. It sounds trivial, but it’s the kind of thing that changes how often you use something.

The process of setting this up with Claude Code was different from what I expected. It wasn’t “generate the config for me.” It was reading what already existed, understanding what needed to change, proposing something surgical. In several moments Claude suggested something more complex than necessary and I had to simplify. The quality of the result depends on you knowing what you want.

Unified themes

One of the things that bothered me most was the visual inconsistency across environments — terminal, editor, system bar. Each one with a different palette, nothing talking to each other.

I created two themes — Yerba Mate (dark, olive-industrial palette) and Tererê (light, paper-butter tones) — and Claude Code helped apply the same palette across all environments at once: Neovim, the system configuration (Omarchy/Hyprland), Obsidian, and this site.

What would make this tedious manually is the number of places where colors need to be defined — each tool has its own format, its own structure, its own variable names. With Claude reading each config and adapting the palette to the correct format, what would have taken a few days took a few hours.

The site

This site was built from scratch during that period, also with Claude Code.

What worked best was generating content from existing sources. The resume page was generated from my LinkedIn PDF — I passed the file, Claude read it and assembled the structured page with experience and skills. The About and Now pages were written from vault notes. I didn’t have to draft anything from scratch.

The layout and style adjustment process was also smooth — sidebar, typography, time-based theme system. Claude proposes, you evaluate, you fix what didn’t turn out right.

What remains

What Claude Code does well isn’t generate code or text on its own — it’s reducing the friction between intention and result. For personal systems, where you’re the only user and the only maintainer, that has a disproportionate effect.

The caveat is that the quality of the result depends directly on you understanding what’s being done. Claude doesn’t replace judgment — it executes faster what you already know you want. When you don’t know, it tends to propose something that seems reasonable but isn’t what you needed.

Used well, it’s a tool that changes the viability of personal projects — not because you couldn’t do it without it, but because without it you simply wouldn’t.

Passei um fim de semana de férias configurando um sistema que ficava postergando há meses, usando o Claude Code como colaborador principal. Saí do outro lado com algo que realmente uso — e com algumas conclusões sobre o que esse tipo de ferramenta faz bem.

O vault como base

O Claude Code funciona bem com um vault Obsidian porque tem acesso direto ao sistema de arquivos. Ele lê, escreve e edita Markdown respeitando os links wiki, o frontmatter YAML e as convenções do Obsidian — o que significa que as notas que ele cria se comportam exatamente como as que você criaria manualmente.

A partir daí, o que se ganha é a capacidade de delegar o trabalho mecânico do sistema. Criar uma nota de estudo sobre Java, por exemplo, não envolve só criar o arquivo — envolve identificar notas relacionadas já existentes no vault, linkar de volta a partir delas, registrar na daily note do dia com contexto. Individualmente, cada passo é simples. Em conjunto, é o tipo de atrito que faz você não criar a nota.

O Claude faz isso como parte do fluxo. Você menciona o tópico, ele cria a nota no lugar certo, linka onde faz sentido e registra o que foi feito. O vault cresce de forma consistente sem precisar gerenciar a estrutura manualmente.

Além disso, criei um conjunto de comandos especializados para diferentes tipos de captura — daily notes com briefing matinal, revisão semanal, registro de sessões de trabalho, captura rápida de aprendizados. Cada um sabe onde escrever e como integrar com o que já existe. Não é automação por automação — é reduzir o atrito entre ter algo na cabeça e ter isso registrado de forma útil.

Neovim e o ambiente de desenvolvimento

Uso Neovim como editor principal, então queria que a interação com o vault funcionasse de dentro do nvim. A configuração envolveu integrar o obsidian.nvim, criar keybindings específicos para o vault — navegar notas, captura rápida, backlinks, autocomplete de wikilinks — e conectar com ferramentas de navegação de arquivos.

O resultado mais útil foi um atalho de teclado que abre a daily note como scratchpad diretamente do sistema de janelas. Um keypress, a nota do dia aparece. Outro, some. Parece trivial, mas é o tipo de coisa que muda a frequência com que você usa algo.

O processo de configurar isso com o Claude Code foi diferente do que eu esperava. Não foi “gera o config pra mim”. Foi ler o que já existia, entender o que precisava mudar, propor algo cirúrgico. Em vários momentos o Claude sugeriu algo mais complexo do que o necessário e precisei simplificar. A qualidade do resultado depende de você saber o que quer.

Temas unificados

Uma das coisas que mais me incomodava era a inconsistência visual entre os ambientes — terminal, editor, barra do sistema. Cada um com uma paleta diferente, nada conversando entre si.

Criei dois temas — Yerba Mate (escuro, paleta oliva-industrial) e Tererê (claro, tons de manteiga de papel) — e o Claude Code ajudou a aplicar a mesma paleta em todos os ambientes ao mesmo tempo: Neovim, configuração do sistema (Omarchy/Hyprland), Obsidian e este site.

O que tornaria isso trabalhoso manualmente é a quantidade de lugares onde as cores precisam ser definidas — cada ferramenta tem seu formato, sua estrutura, seus nomes de variáveis. Com o Claude lendo cada config e adaptando a paleta para o formato correto, o que seria alguns dias virou algumas horas.

O site

Este site foi construído do zero durante esse período, também com o Claude Code.

O que funcionou melhor foi gerar conteúdo a partir de fontes existentes. A página de currículo foi gerada a partir do meu PDF do LinkedIn — passei o arquivo, o Claude leu e montou a página estruturada com as experiências e competências. As páginas Sobre e Agora foram escritas a partir das notas do vault. Não precisei redigir nada do zero.

O processo de ajuste de layout e estilo também foi fluido — sidebar, tipografia, sistema de temas por horário. O Claude propõe, você avalia, ajusta o que não ficou certo.

O que fica

O que o Claude Code faz bem não é gerar código ou texto por si só — é reduzir o atrito entre a intenção e o resultado. Para sistemas pessoais, onde você é o único usuário e o único mantenedor, isso tem um efeito desproporcional.

A ressalva é que a qualidade do resultado depende diretamente de você entender o que está sendo feito. O Claude não substitui o julgamento — ele executa com mais velocidade o que você já sabe que quer. Quando você não sabe, ele tende a propor algo que parece razoável mas não é o que você precisava.

Usado bem, é uma ferramenta que muda a viabilidade de projetos pessoais — não porque você não conseguiria fazer sem, mas porque sem ela você simplesmente não faria.