Como usar o Claude Code para a conciliação bancária de Pix e boletos

O Pix fez o dinheiro cair em segundos, a qualquer hora. A conciliação ficou mais apertada: o extrato chega na hora, mas explicar por que ele não bate com o ERP continua sendo trabalho de alguém com três abas abertas e uma planilha. Somam-se os boletos que entram pelo arquivo de retorno, os recebíveis de cartão com taxas e antecipações e, desde 2025, as cobranças recorrentes do Pix Automático. Esse trabalho pode ser feito pelo Claude Code, e cada diferença a mais praticamente não custa nada. O que não dá para automatizar é o julgamento de quem aprova o ajuste.

Este é um guia prático para heads de operações e de financeiro em fintechs brasileiras, e para o engenheiro que ajuda o time: como colocar o Claude Code para conciliar Pix, boletos e cartões com a contabilidade, como começar sem risco e como saber se está dando resultado.

O que faz. O agente cruza os lançamentos do banco, do PSP e da adquirente com o ERP e as notas fiscais, explica cada diferença com os registros que usou e deixa os ajustes prontos para aprovação.

O que não é. Um robô que lança no ERP ou movimenta dinheiro por conta própria, nem um substituto do seu ERP. As melhorias que realmente importam vão sair do seu time, quando alguém perguntar por que a conciliação é feita daquele jeito. Abra espaço para isso.

Por que o Claude Code e não uma macro

Regra de planilha funciona até chegar o caso estranho: um Pix pago duas vezes, um boleto pago com valor diferente, uma taxa que a adquirente descontou sem aviso. O Claude Code não só cruza dados; ele investiga. Busca o comprovante, confere a nota, compara com os dias anteriores e escreve numa linha o que aconteceu. E como é um agente de código, escreve as próprias integrações: se o banco só entrega um arquivo CNAB, o agente aprende a ler.

Para onde vai o tempo do seu time

Comece pela conciliação de Pix da sua conta principal. Os dados são estruturados e o resultado dá para conferir.

Como o agente trabalha

1. Seu time documenta a conciliação. Quais contas, quais regras de cruzamento, quais tolerâncias e quais casos estranhos.
2. O agente se conecta em modo leitura. Banco, PSP, adquirente, ERP e emissor de notas.
3. O agente concilia. Cruza, investiga e deixa cada diferença explicada com o cálculo.
4. Alguém do financeiro aprova no Slack. Os ajustes esperam o ok de uma pessoa responsável.
5. Cada correção vira regra. Se seu time corrige uma explicação, o agente atualiza as instruções.

As ferramentas

O Runtime é o sistema operacional para agentes de IA. Cada agente roda no seu próprio computador isolado, apagado ao fim da sessão, com suas próprias credenciais, e espera aprovação antes de movimentar dinheiro. Contas, chaves Pix, CPFs e cartões são mascarados antes de chegar ao modelo, e cada execução fica registrada. Seu time pede o trabalho em português; o Runtime cuida dos controles.

Passo 1: escolha uma conciliação e documente

Este passo é do seu time. Escolha uma única conciliação, por exemplo a conta de recebimento de Pix contra o Omie, e escreva como seu melhor analista faz: quais campos cruza, qual tolerância aceita, o que faz com um Pix pago em duplicidade e o que nunca pode acontecer.

Duas coisas que fazem o agente trabalhar melhor:

• Explique o porquê. "Busque pelo EndToEndId porque o mesmo valor pode aparecer várias vezes no dia" funciona muito melhor que "busque pelo EndToEndId".
• Diga qual erro ele não pode cometer. "Nunca dê como conciliado um Pix que só bate no valor" evita o erro mais caro.

Passo 2: crie o agente e conecte em modo leitura

O engenheiro cria o agente no Runtime e dá acesso só de leitura ao banco ou PSP, à adquirente, ao ERP e às notas. As credenciais entram pelo dashboard do Runtime, nunca coladas num chat. Depois, pede ao Claude Code as ferramentas de que ele precisa:

Escreva um programa que leia o extrato diário de Pix da nossa conta e os recebimentos lançados no Omie, e cruze por EndToEndId, valor e chave. Faça todas as somas em código. Guarde o resultado com a origem de cada registro. Teste com os arquivos da semana passada e me diga quantos lançamentos ficaram sem par.

Passo 3: peça que explique cada diferença

Cruzar é a parte fácil. O valor está na explicação.

Concilie os Pix de ontem com o Omie. Para cada diferença, busque pelo EndToEndId e me diga se o valor bate, se existe pedido ou nota fiscal correspondente, se é uma devolução e se a chave de destino é a cadastrada. Se for pagamento em duplicidade, mostre os dois Pix. Deixe a lista no Slack com o ajuste que você propõe para cada um.

Para boletos, o pedido muda de trilho, não de forma:

Leia o arquivo de retorno de boletos de ontem e cruze com os títulos em aberto no TOTVS pelo nosso número. Aponte os boletos pagos com valor diferente do título, calcule a diferença em código e diga se parece juros, desconto ou erro. Não dê baixa em nenhum título; deixe para aprovação.

Passo 4: rode em paralelo por uma semana e depois passe o processo

Durante uma semana, o agente concilia o mesmo que seu time, sem mexer em nada. No fim vocês comparam: em quantos casos ele chegou à mesma explicação, onde errou e por quê. Cada diferença vira uma instrução nova. Depois, agende o agente para rodar sozinho toda manhã, antes de o time chegar, e deixar no Slack o que precisa de aprovação.

Passo 5: ataque as pendências antigas

Quando a conciliação diária estiver rodando sem sustos, coloque o agente para limpar o passado.

Revise as pendências de mais de 30 dias na conta transitória. Calcule a idade em código. Para cada uma, procure no extrato, na agenda da adquirente e nas notas o que a originou, diga o que você acha que é e qual evidência tem, e proponha se deve ser baixada, contestada ou escalada. Não baixe nenhuma.

O que fica com seu time

O que aprendemos

• Comece por uma conta só. Uma conciliação bem resolvida convence mais do que cinco pela metade.
• Conta é em código. O agente escreve um programa para cada cálculo e salva; assim qualquer pessoa consegue repetir o resultado.
• O valor está nos casos estranhos. O normal bate sozinho; a diferença aparece em como ele explica o que não bate.
• Não apague a idade. Uma pendência reclassificada continua com a data em que apareceu.
• Compare com seu time, não com a perfeição. A pergunta é se ele erra menos e explica mais rápido que o processo atual.

O que o compliance vai pedir

Seu auditor, seu banco parceiro ou o Banco Central vão querer saber quatro coisas, e o Runtime já resolve isso por design:

• Quem é o responsável pelo agente. Inventário com responsável e permissões por agente.
• Que ele não movimenta dinheiro nem lança sozinho. Ajustes esperam a aprovação de uma pessoa.
• Que os dados estão protegidos. Contas, chaves, CPFs e CNPJs são mascarados antes de chegar ao modelo, e o Runtime nunca treina com seus dados.
• O que ele fez e por quê. Um registro de cada execução, que dá para exportar numa auditoria.

Se você precisa manter os dados no Brasil, dá para rodar o Runtime na sua própria conta de AWS, Google Cloud ou Azure em São Paulo, com o Claude Code, o Codex ou modelos open source para conciliação.

Como medir resultado

Meça uma semana antes de começar para ter base de comparação.

Um cronograma realista

A Rain, emissora de cartões presente em mais de 150 países, usa o Runtime para suporte técnico, monitoramento de fraude e risco, compliance, cibersegurança, investigações de engenharia, revisão de PRs, QA e relatórios, e economizou $750k com fornecedores e folha.

Em resumo

O volume do Pix vai continuar crescendo e seu time de conciliação não precisa crescer no mesmo ritmo. Deixe o Claude Code cruzar, investigar e explicar, e o seu time com os ajustes. Para a operação completa, veja como automatizar a operação de pagamentos no Brasil; para SPEI e Bre-B, o guia em espanhol; e para o detalhe técnico, como conciliar pagamentos com Claude Code e Codex.

Mãos à obra.

Perguntas frequentes

Como fazer conciliação bancária com o Claude Code?

Escreva seu procedimento de conciliação, conecte o Claude Code em modo leitura ao banco ou PSP e ao ERP, e peça para ele cruzar os lançamentos por identificador, valor e conta. O agente explica cada diferença com os registros que usou e deixa os ajustes propostos para uma pessoa aprovar.

O Claude Code consegue conciliar Pix?

Sim. Ele cruza os Pix do extrato ou do PSP com o ERP pelo EndToEndId, pelo valor e pela chave, verifica se existe a nota fiscal ou o pedido correspondente e explica cada diferença, inclusive devoluções e Pix pagos em duplicidade. Os ajustes contábeis são aprovados por uma pessoa.

E para boletos e recebíveis de cartão?

Funciona do mesmo jeito. Nos boletos, o agente lê o arquivo de retorno do banco e cruza pelo nosso número, valor e data de crédito. Nos cartões, compara a agenda de recebíveis da adquirente com as vendas, separando taxas, antecipações e chargebacks.

É seguro dar acesso ao banco para o Claude Code?

Só com acesso de leitura e num ambiente controlado. No Runtime, o agente roda num computador isolado com credenciais próprias, sem permissão para fazer Pix, e contas e CPFs são mascarados antes de chegar ao modelo. Cada execução fica registrada.

O Claude Code pode lançar no ERP?

Comece com lançamentos em rascunho. O agente propõe o ajuste com a evidência e uma pessoa do financeiro aprova. Lançar direto exige regras contábeis revisadas e proteção contra duplicidade, que valem a pena só depois que o processo estiver estável.

O que é o Runtime?

O Runtime é o sistema operacional para agentes de IA em times de pagamentos e fintech. Ele roda o Claude Code, o Codex ou modelos open source em computadores isolados, com credenciais próprias, aprovações antes de movimentar dinheiro, mascaramento de dados sensíveis e um registro exportável de cada execução. Pode rodar na sua própria nuvem em São Paulo.