Começando

Configuração do ambiente

O que o lola setup faz, por que cada passo importa e como reverter tudo.

O lola setup prepara seu ambiente para usar a Lola no Claude Code. Ele configura identidade, permissões, slash commands e integrações. Cada passo é explicado abaixo.

Antes de tudo: seus arquivos estão seguros

A Lola cria arquivos novos no seu ambiente (rules, agent, skills) e modifica dois arquivos que você já pode ter. Antes de tocar nos seus arquivos existentes, ela cria uma cópia de segurança (.bak). Suas configurações nunca são perdidas.

Arquivos que a Lola cria (novos):

Arquivo	Função
`~/.claude/rules/lola.md`	Identidade básica da Lola.
`~/.claude/agents/lola.md`	Subagent para delegação de tarefas.
`~/.claude/commands/*.md`	15 slash commands.
`~/.lola/shell/lola.sh`	Launcher no terminal.

Arquivo

Função

~/.claude/rules/lola.md

Identidade básica da Lola.

~/.claude/agents/lola.md

Subagent para delegação de tarefas.

~/.claude/commands/*.md

15 slash commands.

~/.lola/shell/lola.sh

Launcher no terminal.

Para remover, basta deletar esses arquivos.

Arquivos seus que a Lola modifica (com backup):

Seu arquivo	Backup criado	O que muda
`~/.claude/settings.json`	`~/.claude/settings.json.bak`	Merge de permissões MCP.
`~/.claude/CLAUDE.md`	`~/.claude/CLAUDE.md.bak`	Adiciona seção de identidade (entre marcadores).

Seu arquivo

Backup criado

O que muda

~/.claude/settings.json

~/.claude/settings.json.bak

Merge de permissões MCP.

~/.claude/CLAUDE.md

~/.claude/CLAUDE.md.bak

Adiciona seção de identidade (entre marcadores).

Para reverter, renomeie o .bak de volta para o original. Para remover tudo de uma vez, veja a seção de desinstalação no final desta página.

Passo 1: Rules file (obrigatório)

O que cria: ~/.claude/rules/lola.md

O que faz: ensina o agente que ele deve se comportar como a Lola e chamar bootstrap() no início de toda sessão.

Por que importa: sem esse arquivo, o agente não sabe que a Lola existe. Ele não chama bootstrap(), não carrega seu contexto e não usa as tools MCP automaticamente. Você teria que pedir manualmente toda vez.

Conteúdo resumido:

Voce E a Lola.

Primeira acao em TODA sessao: chamar bootstrap().

Genero feminino. Idioma: Portugues BR.

Passo 2: Arquivo de agente (obrigatório)

O que cria: ~/.claude/agents/lola.md

O que faz: registra a Lola como subagent do Claude Code. Isso permite delegar tarefas para a Lola em paralelo usando "Use a Lola para...".

Por que importa: sem esse arquivo, você não consegue usar a Lola como agente autônomo. A delegação de tarefas não funciona.

Benefício: você pode pedir algo como "Use a Lola para criar as issues enquanto eu continuo codando" e ela trabalha em paralelo.

Passo 3: Permissões MCP (obrigatório)

O que modifica: ~/.claude/settings.json (faz merge, não sobrescreve)

O que faz: autoriza as tools MCP da Lola para que não peçam aprovação manual a cada chamada. Tools destrutivas (deletar dados, revogar tokens) continuam pedindo confirmação.

Por que importa: sem as permissões, cada vez que a Lola precisar usar uma tool, o Claude Code vai pausar e pedir sua aprovação. Com 350+ tools, isso torna a experiência inviável.

Segurança: a Lola nunca sobrescreve seu settings.json. Ela faz backup do seu arquivo original, depois faz merge adicionando apenas o necessário. Suas configurações existentes são preservadas.

O que fica em "allow" (executa direto): todas as tools da Lola (mcp__lola__*).

O que fica em "ask" (pede confirmação): tools destrutivas como forget, delete_message, delete_comment, delete_role, delete_client, delete_email_group, calendar_delete_event, revoke_tokens e cleanup.

Passo 4: Skills / Slash commands (recomendado)

O que cria: 15 arquivos em ~/.claude/commands/

O que faz: instala slash commands que funcionam como atalhos de produtividade no Claude Code.

Por que importa: sem eles, você ainda pode pedir tudo em linguagem natural, mas perde atalhos úteis que padronizam fluxos de trabalho.

Slash commands disponíveis:

Comando	O que faz
`/hello`	Dashboard de boas-vindas com contexto completo.
`/bye`	Encerrar sessão salvando contexto para a próxima.
`/commit`	Criar commit seguindo Conventional Commits.
`/pr`	Criar Pull Request formatada.
`/fix`	Corrigir um problema no código.
`/test`	Criar testes para código existente.
`/component`	Criar componente React seguindo padrões.
`/refactor`	Melhorar código sem alterar comportamento.
`/docs`	Documentar código com TSDoc.
`/pr-review`	Code review estruturado.
`/inbox`	Ver mensagens recebidas.
`/msg`	Enviar mensagem para outro dev.
`/init`	Inicializar sessão de desenvolvimento.
`/setup`	Configurar ambiente.
`/conversation`	Ver histórico de conversa com outro dev.

Comando

O que faz

/hello

Dashboard de boas-vindas com contexto completo.

/bye

Encerrar sessão salvando contexto para a próxima.

/commit

Criar commit seguindo Conventional Commits.

/pr

Criar Pull Request formatada.

/fix

Corrigir um problema no código.

/test

Criar testes para código existente.

/component

Criar componente React seguindo padrões.

/refactor

Melhorar código sem alterar comportamento.

/docs

Documentar código com TSDoc.

/pr-review

Code review estruturado.

/inbox

Ver mensagens recebidas.

/msg

Enviar mensagem para outro dev.

/init

Inicializar sessão de desenvolvimento.

/setup

Configurar ambiente.

/conversation

Ver histórico de conversa com outro dev.

Esses slash commands são diferentes das skills do servidor (contratos, petições, prontuário, etc.). Skills do servidor funcionam via skill_run() independentemente do setup. Os slash commands da tabela acima precisam do setup para existir no seu terminal.

Passo 5: Identidade completa (opcional)

O que modifica: seção em ~/.claude/CLAUDE.md

O que faz: adiciona a identidade completa da Lola (gênero, idioma, protocolo, sigilo) como seção marcada no seu CLAUDE.md global.

Por que é opcional: o passo 1 (rules file) já garante o comportamento básico. A identidade completa reforça e detalha.

Se você já tem CLAUDE.md: a Lola faz backup do seu arquivo e só modifica a seção entre os marcadores `

`. O restante do seu arquivo não é tocado.

Passo 6: Playwright MCP (obrigatório)

O que faz: instala o Playwright MCP, que permite a Lola navegar na web, tirar screenshots e ler páginas.

Comando de instalação:

bash

claude mcp add --scope user playwright -- npx @playwright/mcp@latest

Por que importa: algumas tools da Lola (web_search, crawl_site, seo_audit) dependem de acesso ao navegador. Sem o Playwright, essas funcionalidades não estão disponíveis.

Passo 7: Comando lola no terminal (opcional)

O que cria: ~/.lola/shell/lola.sh + source no seu .zshrc ou .bashrc

O que faz: adiciona o comando lola no terminal, um launcher que detecta quais CLIs de IA você tem instalados (Claude Code, Codex, Gemini) e abre o que você escolher.

Como usar:

bash

lola           # menu interativo se tiver multiplos CLIs
lola claude    # abre Claude Code direto
lola codex     # abre Codex CLI direto
lola gemini    # abre Gemini CLI direto

Passo 8: Paper MCP (opcional)

O que faz: instala o Paper MCP para design visual. Requer o Paper Desktop rodando.

Quando instalar: apenas se você usa Paper.design para criação de interfaces e quer que a Lola interaja com seus designs.

Como executar o setup

Abra o Claude Code e diga:

Lola, configura meu ambiente

A Lola vai executar setup_check() para verificar o que já está configurado e setup_apply() para cada passo necessário. Ela pede confirmação antes de cada alteração.

Como reverter tudo

Se quiser remover a Lola completamente, existem duas opções:

Opção 1: reverter manualmente

Restaure os backups criados durante o setup:

bash

# Reverter rules
mv ~/.claude/rules/lola.md.bak ~/.claude/rules/lola.md
# Ou simplesmente deletar
rm ~/.claude/rules/lola.md

# Reverter settings
mv ~/.claude/settings.json.bak ~/.claude/settings.json

# Remover agent
rm ~/.claude/agents/lola.md

# Remover slash commands
rm ~/.claude/commands/bye.md
rm ~/.claude/commands/hello.md
rm ~/.claude/commands/commit.md
# ... (ou remover todos de uma vez)
rm ~/.claude/commands/{bye,hello,commit,pr,fix,test,component,refactor,docs,pr-review,inbox,msg,init,setup,conversation}.md

# Remover seção identity do CLAUDE.md (entre os marcadores lola:identity)

# Remover launcher do terminal
rm -rf ~/.lola/
# Remover a linha 'source ~/.lola/shell/lola.sh' do seu .zshrc ou .bashrc

Opção 2: pedir para a Lola

Lola, desinstala tudo

A Lola executa o passo uninstall que remove rules, agent e skills automaticamente.

Resumo

Passo	O que faz	Obrigatório	Reversível
Rules file	Ensina o agente a ser a Lola.	Sim	Sim (backup .bak)
Agent file	Registra Lola como subagent.	Sim	Sim (backup .bak)
Permissões	Autoriza tools MCP.	Sim	Sim (backup .bak)
Skills	15 slash commands.	Recomendado	Sim (deletar arquivos)
Identidade	Reforço no CLAUDE.md.	Opcional	Sim (backup .bak)
Playwright	Navegação web.	Obrigatório	Sim (claude mcp remove)
Launcher	Comando lola no terminal.	Opcional	Sim (deletar ~/.lola/)
Paper	Design visual.	Opcional	Sim (claude mcp remove)

Passo

O que faz

Obrigatório

Reversível

Rules file

Ensina o agente a ser a Lola.

Sim

Sim (backup .bak)

Agent file

Registra Lola como subagent.

Sim

Sim (backup .bak)

Permissões

Autoriza tools MCP.

Sim

Sim (backup .bak)

Skills

15 slash commands.

Recomendado

Sim (deletar arquivos)

Identidade

Reforço no CLAUDE.md.

Opcional

Sim (backup .bak)

Playwright

Navegação web.

Obrigatório

Sim (claude mcp remove)

Launcher

Comando lola no terminal.

Opcional

Sim (deletar ~/.lola/)

Paper

Design visual.

Opcional

Sim (claude mcp remove)

Todos os passos são reversíveis. A Lola faz backup dos seus arquivos antes de qualquer modificação. Seu ambiente volta ao estado original sempre que você quiser.