Ficha técnica
| Tipo | Introdução + Demonstração + Atividade Prática + Desafio |
| Bloco | AI no Financeiro · Primeira atividade da aula |
| Duração | 12 minutos |
| Ferramenta | Claude Code ou Claude Cowork (modelo Sonnet 4.6) |
| Pré-requisito | Nenhum. Começa do zero, abrindo a pasta no Claude |
| Entregável | Projeto de conciliação configurado, com a config do projeto colada nas instruções e os materiais da aula (11 notas, planilha de pagamentos, prompts) na pasta |
Antes de mandar qualquer prompt, a gente prepara o terreno. Esta AP é a fundação das próximas: pasta criada, config colada, materiais no lugar. Dura 12 minutos e desbloqueia o resto da aula.
Contexto: você é a Camila, 3 semanas de casa no financeiro da Lúmina. Semana passada, pagou uma nota da Gráfica Sergipe de R$ 2.000 como R$ 10.000. Um zero a mais que alguém digitou na planilha. R$ 8.000 saíram errado. Ninguém viu até o fornecedor ligar agradecendo. Você vai construir, nesta aula, a ferramenta que pega esse erro: lê a NF-e, cruza com a planilha pelo número da nota e alerta quando a diferença passa de 1%.
A config do projeto é o gabarito que ensina o Claude a conferir. Lista os 5 campos que importam pra conciliação (numero_nota, cnpj_fornecedor, nome_fornecedor, valor_nota, data_emissao) e fixa a regra: diferença acima de 1% vira alerta.
Sem ela, o Claude tem que adivinhar o que extrair de cada XML e qual tolerância usar pra comparar com a planilha. Com ela, todo prompt das próximas APs roda em cima da mesma régua. Config certa, conciliação certa.
Sem config, cada prompt seguinte vira uma negociação: "qual campo é o número da nota mesmo?", "considero arredondamento?", "o que conta como diferença significativa?". Você responde a mesma coisa 4 vezes e ainda corre o risco de inconsistência entre uma rodada e outra.
12 minutos aqui poupam a aula inteira.
A config do projeto tem 2 blocos: quais campos extrair da nota e qual é a regra de alerta. É curto. Cabe em 1 tela.
Os 5 campos: numero_nota, cnpj_fornecedor, nome_fornecedor, valor_nota e data_emissao. São esses que o Claude vai puxar de cada XML e jogar pra JSON. A planilha tem o número da nota e o valor pago, então o cruzamento é pelo numero_nota. A regra: se o valor pago divergir do valor da nota em mais de 1%, vira alerta. Abaixo disso, ignora (arredondamento, centavos, ruído).
Nota fiscal e pagamento dificilmente batem ao centavo. Tem desconto, taxa, arredondamento de boleto. Se você exigir bater exato, todo pagamento vira alerta e o relatório perde sentido. 1% é o limite que separa centavo de zero a mais.
No caso do erro dos R$ 8.000, a diferença foi de 400%. Passou de 1% por longe. O alerta sobe na hora.
Esses 2 blocos vão pra dentro das instruções do projeto no Claude. Ele lê uma vez e usa em toda mensagem da aula. Você não precisa repetir nada nas APs seguintes: a régua já tá colada.
Antes da demo, crie no seu computador uma pasta chamada conciliacao-lumina/ em qualquer lugar (Desktop serve). É dentro dela que vão entrar a config, os 11 XMLs, a planilha e os prompts da aula. As próximas APs continuam aqui dentro.
Se você esquecer, o Claude pergunta. Mas dá pra economizar 1 mensagem se a pasta já existir.
O professor mostra o fluxo numa sequência linear, do zero até a pasta pronta. São 4 movimentos: pasta, Claude, config, materiais.
Fluxo da demo
1. Cria a pasta. No Desktop, conciliacao-lumina/. Nada dentro ainda.
2. Abre o Claude na pasta. No Claude Code, cd até ela e roda claude. No Claude Cowork, "Abrir pasta" e seleciona conciliacao-lumina/. Confirma que o modelo selecionado é Sonnet 4.6.
3. Cola a config nas instruções do projeto. Abre o configuracao-projeto.md baixado da aula, copia o conteúdo e cola nas instruções do projeto (no Claude Cowork) ou deixa o arquivo na pasta como contexto (no Claude Code). Os 5 campos e a regra de 1% entram no contexto permanente.
4. Sobe os materiais. Joga notas-fiscais.zip dentro da pasta, descompacta os 11 XMLs, coloca pagamentos.xlsx e o nota-12345-grafica-sergipe.xml da história. Pergunta pro Claude "o que tem nessa pasta?" pra confirmar que ele enxerga tudo.
Você podia mandar os 5 campos e a regra de 1% em cada prompt das próximas APs. Funciona, mas cansa, polui o chat e abre brecha pra inconsistência. Colado nas instruções do projeto, vira contexto que o Claude carrega em toda mensagem, sem você ter que repetir.
É a diferença entre dar a régua uma vez e ter que mostrar a régua em cada conferência.
Agora você monta o projeto de conciliação da Lúmina no seu computador. 4 passos lineares: cria a pasta, baixa os materiais, cola a config e sobe os arquivos. No fim você tem a base pronta pra rodar a AP02, que é onde o Claude lê a primeira nota e extrai os 5 campos pra JSON.
Na demo você assistiu. Aqui você faz. Cria a pasta, baixa os 5 anexos da aula, cola a config nas instruções do projeto e confirma que o Claude vê os arquivos. No fim, peça pra ele listar a pasta. Se ele citar os 11 XMLs e a planilha, a configuração tá certa.
No seu computador, crie uma pasta chamada conciliacao-lumina/ em qualquer lugar (Desktop, Documentos, onde preferir). Abra o Claude Code (ou Claude Cowork) dentro dessa pasta.
Detalhamento: no Claude Code, abre o terminal, navega até a pasta com cd ~/Desktop/conciliacao-lumina (ou caminho equivalente) e roda claude. No Claude Cowork, abre o app, clica em "Abrir pasta" e seleciona conciliacao-lumina/. Confirma no canto da tela que o modelo selecionado é Claude Sonnet 4.6.
Essa pasta vai ser o projeto de conciliação da Lúmina durante a aula inteira. AP02, AP03 e AP04 continuam aqui dentro.
Baixe os 5 anexos abaixo e salve todos dentro da pasta conciliacao-lumina/. O notas-fiscais.zip precisa ser descompactado: os 11 XMLs ficam soltos na pasta junto com os outros arquivos.
Detalhamento: ao final, sua pasta conciliacao-lumina/ deve ter 4 arquivos soltos (a config, os prompts, a planilha e a nota da Gráfica Sergipe) mais os 11 XMLs descompactados do zip. Total: 14 arquivos.
Abra o configuracao-projeto.md num editor (ou no próprio Claude) e copie o conteúdo inteiro. Esse é o gabarito da aula: os 5 campos e a regra de 1%.
No Claude Cowork: abre o projeto, vai em "Instruções do projeto" (ou "Project instructions", depende da versão) e cola o conteúdo do configuracao-projeto.md ali. Salva. A partir desse momento, toda mensagem que você mandar no projeto carrega essas instruções automaticamente.
No Claude Code: não precisa colar nas instruções (não tem esse campo). Deixe o configuracao-projeto.md na pasta do projeto. O Claude lê o arquivo como contexto quando precisar. Pra garantir, na primeira mensagem da AP02 você pode pedir: "primeiro, lê o configuracao-projeto.md desta pasta pra entender a régua".
Detalhamento: a config tem 2 blocos curtos. Bloco 1: os 5 campos que o Claude deve extrair de cada NF-e (numero_nota, cnpj_fornecedor, nome_fornecedor, valor_nota, data_emissao). Bloco 2: a regra de comparação: cruzar por numero_nota, calcular a diferença percentual entre valor da nota e valor pago, sinalizar alerta se passar de 1%.
Pra fechar a configuração, peça pro Claude listar o que tem na pasta. Se ele citar a config, os 11 XMLs, a planilha e a nota da Gráfica Sergipe, a base tá pronta pra AP02.
O que avaliar na resposta do Claude:
- Ele cita os 11 XMLs (numerados ou pelo menos o total) e o
nota-12345-grafica-sergipe.xmlseparado. - Ele cita o
pagamentos.xlsxcomo a planilha de pagamentos. - Ele cita a regra de 1% como limite de alerta na comparação valor da nota x valor pago.
- Ele cita os 5 campos:
numero_nota,cnpj_fornecedor,nome_fornecedor,valor_nota,data_emissao.
Se a resposta cobriu os 4 pontos, seu projeto de conciliação tá configurado e pronto pra AP02.
Você sai desta atividade com
- Uma pasta
conciliacao-lumina/no seu computador, aberta no Claude, que vai abrigar AP02, AP03 e AP04 também. - A config do projeto aplicada: os 5 campos da NF-e e a regra de 1% já carregados nas instruções (Cowork) ou disponíveis na pasta como contexto (Code).
- Os materiais no lugar: 11 XMLs de NF-e, a planilha
pagamentos.xlsx, a nota da Gráfica Sergipe e oprompts.mdde apoio. - Confirmação do próprio Claude de que ele enxerga os arquivos e entendeu a régua. Sem isso, as próximas APs viram chute.
É 1 pasta, 1 config e 5 arquivos. Mas é o que separa um Claude que chuta qual é o número da nota de um Claude que conhece os 5 campos exatos e a regra de 1%. Config vaga, conciliação vaga. Config certa, e o Claude pega o erro dos R$ 8.000 em segundos.
É a tese do workshop em prática: você descreve o resultado, o Claude faz o trabalho. A AP01 entrega a descrição. As próximas 3 entregam o trabalho.
Você acabou de configurar o projeto da Lúmina fictícia. Agora repete o método com um processo real do seu financeiro: alguma conferência manual que hoje depende de olho humano, onde um zero a mais passaria batido.
O que fazer:
- Escolha 1 processo de conferência manual que hoje roda no seu financeiro. Pode ser nota fiscal x pagamento (como na aula), boleto x extrato bancário, comissão x faturamento, reembolso x política, qualquer cruzamento que hoje depende de alguém olhar item por item.
- Crie uma pasta de projeto no seu computador com nome curto do processo (ex:
conciliacao-fornecedores/,extrato-vs-boletos/) e abra o Claude Code (ou Cowork) nela. - Liste em linguagem corrida as 2 fontes que vão ser cruzadas. Ex: "de um lado tenho o XML da NF-e, do outro tenho a planilha com o que foi pago". Diga quais campos importam em cada uma.
- Defina a régua de alerta. Pergunta direto: "diferença a partir de quanto vira problema?". 1%, 5%, R$ 50, depende do seu volume. Escreva o número.
- Escreva a config do projeto nos mesmos 2 blocos da AP01: quais campos extrair de cada fonte e qual é a regra de alerta. Cola nas instruções do projeto (Cowork) ou salva como
configuracao-projeto.mdna pasta (Code). - Suba pelo menos 5 exemplos reais de cada fonte na pasta. Não precisa ser amostra grande, precisa ser real. O suficiente pra você ver se a régua funciona no seu dia a dia.
Com o projeto configurado, a AP02 entra em cena. Você vai pegar o nota-12345-grafica-sergipe.xml (a NF-e da história, R$ 2.000) e pedir pro Claude ler o XML e extrair os 5 campos da config pra JSON.
É a primeira vez que o gabarito da AP01 vira trabalho real. Config tá colada. Hora de ler a primeira nota.