Como instalar skill no Claude: 4 caminhos e privacidade

Resposta direta

Para instalar uma skill no Claude você tem quatro caminhos: subir o .zip em Customize > Skills no claude.ai, adicionar o marketplace do GitHub no Cowork, rodar /plugin marketplace add e /plugin install no Claude Code, ou executar o script Python direto no terminal, sem IA. O comando muda, a pergunta que importa não: para onde vai o seu arquivo.

Este tutorial vale para qualquer ferramenta do Finance AI Lab. O exemplo resolvido é o Auditor de Tarifas (soma as tarifas de um extrato OFX ou CSV). Para a próxima ferramenta, troque auditor-de-tarifas pelo nome do plugin dela e o resto fica igual.

O que cada caminho faz com o seu arquivo

Antes dos passos, o recado que decide qual caminho usar. Extrato bancário tem CNPJ, saldo e contraparte, e a TI vai perguntar onde ele é processado.

Plataforma	Plano	Python na sua máquina?	Onde o motor roda	O que vai para a Anthropic
claude.ai (web ou app), com o .zip	Pago (Pro, Max, Ultra, Team ou Enterprise), com execução de código ligada	Não	Sandbox da Anthropic	O arquivo anexado, o seu pedido e o resultado
Cowork	Pago	Não, na nuvem (padrão); sim, em sessão local antiga	Nuvem da Anthropic (padrão desde 06/10/2026 em Pro, Max e Ultra)	Na nuvem: o trabalho inteiro, inclusive arquivos locais que a sessão abre pelo app
Claude Code, em sessão local (terminal, IDE ou aba Code do app)	Assinatura paga do Claude ou conta do Console	Sim, 3.12 ou mais	No seu computador	O seu pedido, o resumo que o motor imprime e qualquer arquivo que o Claude abrir
Terminal, sem IA	Nenhum	Sim, 3.12 ou mais	No seu computador	Nada

Três leituras da tabela, sem arredondar.

No claude.ai, o arquivo sobe. A conversa inteira roda na nuvem da Anthropic, e o código da skill roda no sandbox dela. Anexou o extrato, ele está lá. Se o extrato for sensível, anonimize antes ou use outro caminho.

No Claude Code, o arquivo fica no disco, mas o que o Claude lê sobe. O motor roda no seu computador e a skill foi desenhada para o Claude ler só o resumo agregado (totais por banco, mês e tipo), nunca o lançamento individual. Só que a documentação do Claude Code diz que os dados enviados incluem “all user prompts and model outputs”. Seu pedido, o resumo impresso e qualquer arquivo que você peça para o Claude abrir fazem parte disso. Se você mandar “abra o extrato e me explique”, o conteúdo sobe. A proteção é de desenho, não de bloqueio. E isso vale só para a sessão local: o Claude Code no navegador (claude.ai/code) e a sessão em nuvem do app rodam nos servidores da Anthropic, e aí o extrato sobe também.

No Cowork, o padrão mudou. Desde 6 de outubro de 2026, as tarefas novas em Pro, Max e Ultra rodam na nuvem, e não existe mais opção de rodar só no computador. Segundo a Anthropic, o trabalho do agente, “including any local files it opens through the desktop app”, é processado nos servidores dela. Para este caminho, trate o extrato como se tivesse subido. A Anthropic diz que a execução local segue disponível para implantações de desktop já existentes, sem detalhar por plano. Em Team e Enterprise, confira no app qual modo a sua empresa usa. Se você quer o motor no computador com o Claude conduzindo, a própria Anthropic aponta o Claude Code no app desktop.

Só o terminal, sem IA, garante que nada sai da máquina.

Passo a passo por plataforma

1. claude.ai (web ou app), pelo .zip

1. Abra a última release do repositório e baixe auditor-de-tarifas.zip. Não descompacte. Dentro dele há a pasta auditor-de-tarifas/ com o SKILL.md, que é a estrutura que o claude.ai exige (a pasta da skill no topo do zip, não o SKILL.md solto na raiz).
2. Em Settings > Capabilities, confirme que “Code execution and file creation” está ligado. Skills rodam no sandbox de código, então sem isso não funcionam. Em Team e Enterprise, quem liga é o Owner.
3. Vá em Customize > Skills, clique em ”+”, depois em “Create skill” e escolha “Upload a skill”. Selecione o .zip. Com a interface em português, os nomes podem vir traduzidos.
4. A skill aparece na lista. Ligue o interruptor dela.
5. Abra uma conversa nova, anexe o extrato (um arquivo por conta) e peça em português: “some as tarifas desse extrato”.

O motor pede Python 3.12 ou mais, e a Anthropic não publica a versão do Python do sandbox. Por isso, a primeira rodada deve ser com o extrato fictício (próxima seção). Se falhar por versão, o caminho é Claude Code ou terminal.

Há um atalho: Customize > Plugins > Add > Add marketplace, com financeailab/skills-financas-br. Plugin instalado na conta vale também no chat, mas a privacidade é a mesma do claude.ai: nuvem.

2. Cowork, pelo marketplace

1. Abra o Claude Desktop (macOS ou Windows) em uma conta paga.
2. Vá em Customize > Plugins e escolha Add marketplace.
3. Digite financeailab/skills-financas-br. O Cowork aceita a forma owner/repo e a URL completa do GitHub.
4. Os plugins do repositório aparecem junto com os demais. Abra auditor-de-tarifas e clique em Install.
5. Numa tarefa nova, descreva o pedido e deixe o Claude carregar a skill. Para dar acesso ao extrato, conecte a pasta que o contém.

O plugin instalado fica salvo na conta e aparece também no chat e no Claude Code. Releia a seção de privacidade antes do passo 5.

3. Claude Code, pelo marketplace

1. Confirme Python 3.12 ou mais no computador (python --version).
2. Na sessão do Claude Code, adicione o marketplace:

   /plugin marketplace add financeailab/skills-financas-br

   Quando der certo, ele responde Successfully added marketplace: skills-financas-br.
3. Instale o plugin:

   /plugin install auditor-de-tarifas@skills-financas-br

   O comando abre o painel do plugin. Revise o que ele adiciona e escolha o escopo (para você, para o projeto ou só local).
4. Confirme: digite / e procure /auditor-de-tarifas:auditor-de-tarifas.
5. Peça em português, com o caminho do extrato. O Claude Code vai pedir permissão para executar o script, porque rodar script é uma chamada de Bash.

Para trocar o nome da ferramenta, só o trecho antes do @ muda.

4. Terminal, sem IA

1. Baixe o repositório (botão Code > Download ZIP no GitHub, ou git clone).
2. Entre na pasta plugins/auditor-de-tarifas/skills/auditor-de-tarifas/.
3. Rode:

   python scripts/auditar_tarifas.py extrato.ofx --ano 2025 --saida auditoria.csv

4. Leia o resumo na tela e abra o auditoria.csv para conferir linha a linha.

Zero dependência externa: só a biblioteca padrão do Python. É o caminho para quem não pode, por política, mandar nada para fora.

Teste com o extrato fictício

O repositório traz exemplo/extrato_341.ofx, três meses do banco 341 com dados inventados. Rode no terminal (ou peça ao Claude) antes de usar dado real:

python scripts/auditar_tarifas.py exemplo/extrato_341.ofx --ano 2025 --saida aud.csv

A saída que eu obtive em 04/11/2026:

Total de tarifa no periodo: R$ 191.90
Total de IOF (imposto, a parte): R$ 8.32
Periodo coberto: 2025-01 a 2025-02

Por tipo:
  boleto: R$ 3.90
  cartao: R$ 120.00
  custodia: R$ 15.00
  manutencao: R$ 29.90
  outra_tarifa: R$ 4.20
  pix: R$ 1.50
  saque_extrato: R$ 6.50
  transferencia: R$ 10.90

Nao-classificados a conferir: 1
Veredicto: CONFERIR

Se os números baterem, a instalação está certa. O veredicto CONFERIR aqui é esperado: um lançamento tem cara de tarifa e o dicionário não o reconheceu, então ele entra no total como outra_tarifa e a ferramenta pede conferência em vez de esconder. Os valores acima são do extrato de exemplo, não referência de preço de banco nenhum.

Atualizar e remover

• claude.ai: suba o .zip novo da release (e remova o antigo em Customize > Skills).
• Cowork: no marketplace, “Check for updates”; para remover, Customize > Plugins, abra o plugin e escolha Remove.
• Claude Code: claude plugin update auditor-de-tarifas@skills-financas-br. Marketplace de terceiros não atualiza sozinho por padrão. Para remover, claude plugin uninstall auditor-de-tarifas@skills-financas-br.
• Terminal: baixe o repositório de novo.

Onde ajuda e onde quebra

Repositório sem promessa de permanência. O código é aberto (Apache-2.0) e o nome do plugin é mantido por intenção do projeto, mas é um repositório de terceiros: pode mudar, mudar de lugar ou sair do ar. Quem depende da ferramenta num fechamento deve guardar uma cópia do .zip da versão que validou.

Python exigido no local. Claude Code e terminal precisam de Python 3.12 ou mais instalado. Em máquina corporativa travada, isso costuma ser um chamado para a TI.

Extrato em PDF fica fora. O Auditor lê OFX e CSV. Um PDF não entra, e converter PDF em OFX é outro trabalho.

Marketplace de terceiros não passa pela revisão da Anthropic. Segundo a documentação, a revisão dos plugins do diretório “doesn’t cover a plugin you add from a marketplace URL”. Isso vale para este repositório. O SKILL.md e os scripts são curtos e abertos; leia antes de ligar.

O menu muda. Os caminhos de menu e a regra de onde o Cowork roda mudaram em 2026 e podem mudar de novo. O princípio da seção de privacidade é estável, os rótulos dos botões não.

Instalar não é auditar. A skill soma tarifa e separa o IOF. Não concilia, não compara bancos, não renegocia. Tarifa PJ é livre e negociável: total alto é argumento de renegociação, não cobrança indevida.

Perguntas relacionadas

Preciso de plano pago para instalar skill no Claude?

Para skills personalizadas no claude.ai, a documentação lista Pro, Max, Ultra, Team e Enterprise, com execução de código ligada. O Cowork também exige plano pago. O terminal não usa o Claude: roda o script Python direto, de graça, sem conta nenhuma.

Qual a diferença entre skill e plugin no Claude?

Skill é uma pasta com um SKILL.md de instruções e, às vezes, scripts. Plugin é um pacote que junta skills, conectores, comandos e agentes para instalar de uma vez. No Claude Code e no Cowork você instala o plugin pelo marketplace; no claude.ai, sobe a pasta da skill em .zip.

Preciso do Claude Code para usar uma skill?

Não. O claude.ai aceita a skill em .zip, o Cowork instala o plugin pelo marketplace e o terminal roda o script sem IA. O Claude Code é o caminho em que o motor roda no seu computador com o Claude conduzindo a conversa, ao custo de instalar Python e usar linha de comando.

A skill manda o meu extrato para a Anthropic?

Depende do caminho. No claude.ai, o arquivo anexado sobe. No Cowork em nuvem, também. No Claude Code em sessão local, o arquivo fica no disco, mas pedido, resumo e qualquer arquivo que o Claude abrir sobem. No terminal, sem IA, nada sai da máquina.

Como atualizar ou remover uma skill do Claude Code?

Atualize com claude plugin update auditor-de-tarifas@skills-financas-br ou pelo painel /plugin, aba Installed, Update now. Remova com claude plugin uninstall seguido do mesmo nome. Marketplaces de terceiros não atualizam sozinhos por padrão, então a atualização é manual.

É seguro instalar skill de terceiros?

A skill é instrução e código que rodam na sua conversa, e a Anthropic não revisa o que você sobe ou adiciona por URL. Abra o SKILL.md e os scripts antes de ligar. Neste repositório tudo é aberto e a ferramenta não usa dependência externa, o que facilita a leitura.

Próximo passo

Use a ferramenta: a página do Auditor de Tarifas mostra o que ela faz e o que ela não faz, e o código está no repositório no GitHub. Comece pelo extrato fictício.

Se ainda falta o conceito, leia para trás: o que é uma skill de IA, skill, prompt ou project: qual usar, Claude chat, Cowork e Code no financeiro e plugins e extensões de IA.