🔧 95CC Automacao

Visual Studio Code com a extensao oficial do Claude Code, permitindo usar o agente diretamente na IDE mais popular do mundo.

A integracao com VS Code oferece a melhor experiencia de desenvolvimento, com arquivos a esquerda e agente a direita.

Extensao Claude Code, interface lado a lado, login Anthropic, plano Pro ou Max.

Cada projeto Claude Code vive em uma pasta propria com estrutura definida: workflows/, tools/, .tmp/, .env.

Uma estrutura limpa evita confusao e permite que o agente encontre rapidamente o que precisa.

Open folder, workflows/, tools/, .tmp/, .env, credentials.json.

O painel esquerdo do VS Code mostra todos os arquivos do projeto. O agente Claude Code fica no painel direito.

Entender a interface permite navegar rapidamente entre workflows, tools e arquivos gerados.

Explorer (esquerda), agente (direita), multiplas abas, arrastar arquivos.

Modo que permite ao agente executar acoes sem pedir permissao a cada passo, acelerando drasticamente o desenvolvimento.

Sem bypass, voce precisa aprovar cada edicao de arquivo manualmente - muito lento para automacoes complexas.

Settings > allow bypass permissions mode, ask before edits, edit automatically.

Modo especial onde Claude pensa mais profundamente, faz pesquisas e faz perguntas antes de executar.

Usar plan mode no inicio de projetos garante que Claude entenda completamente o que voce quer construir.

Plan mode toggle, pesquisa web, perguntas clarificadoras, analise de estrutura.

O agente (lado direito) le, cria e modifica arquivos (lado esquerdo). Essa separacao e fundamental.

Entender essa divisao ajuda a saber o que o agente pode fazer e onde os resultados ficam salvos.

Agente = raciocinador, arquivos = persistencia, workflows guiam, tools executam.

Arquivos Markdown que descrevem processos completos: objetivo, inputs, tools a usar, outputs esperados e tratamento de erros.

Workflows sao como briefings para o agente - quanto mais claros, melhores os resultados.

workflows/, arquivo.md, linguagem natural, objective, inputs, outputs, edge cases.

O agente Claude Code e o decisor - le workflows, escolhe tools, trata erros e faz perguntas quando necessario.

Separar decisao (IA) de execucao (codigo) e o que torna automacoes confiaveis.

Coordenacao inteligente, sequenciamento de tools, tratamento de falhas, clarificacoes.

Scripts Python que executam acoes especificas: API calls, transformacoes de dados, operacoes de arquivo.

Tools sao testaveis, confiaveis e rapidos - diferente de deixar a IA fazer tudo diretamente.

tools/, scripts .py, API calls, data transformations, file operations, database queries.

Quando algo falha, o agente investiga, corrige o tool, verifica a correcao e atualiza o workflow para evitar o erro no futuro.

Este loop e o que torna o sistema cada vez mais robusto com o tempo - aprende com cada falha.

Identificar erro, corrigir tool, verificar fix, atualizar workflow, documentar aprendizado.

Estrutura padrao: .tmp/ (temporarios), tools/ (scripts), workflows/ (instrucoes), .env (secrets), credentials.json (OAuth).

Seguir a estrutura padrao permite que o agente encontre tudo automaticamente sem configuracao adicional.

.tmp/ descartavel, tools/ permanente, workflows/ evolui, .env nunca commitado.

Arquivo que armazena API keys e credenciais senssiveis. Nunca deve ser commitado no Git.

Guardar secrets no .env evita exposicao acidental quando o codigo for compartilhado ou publicado.

.env, .gitignore, API_KEY=valor, nunca no codigo, nunca no workflow.

Arquivo claude.md na raiz do projeto que funciona como system prompt - o agente le automaticamente ao iniciar.

Sem um bom claude.md, o agente e generico. Com ele, entende seu projeto, ferramentas e padroes.

claude.md, framework WAT, estrutura de pastas, regras do projeto, como operar.

Modo onde Claude dedica mais tempo pensando, pesquisando APIs, analisando opcoes antes de propor uma solucao.

Bypass sem planejamento gera codigo ruim. Plan mode primeiro, execucao depois.

Ativar plan mode, descrever objetivo completo, listar features, esperar perguntas.

Claude faz perguntas sobre detalhes que voce pode nao ter pensado: frequencia, formato, integracao, tratamento de erros.

Responder bem as perguntas evita retrabalho e garante que a automacao faca exatamente o que voce precisa.

Perguntas clarificadoras, especificacoes, edge cases, preferencias de implementacao.

Apos revisar o plano de Claude, voce pode aceitar automaticamente todas as mudancas propostas de uma vez.

Auto-accept acelera a execucao, mas so deve ser usado apos revisar o plano cuidadosamente.

Revisar plano primeiro, aceitar mudancas, monitorar execucao, intervir se necessario.

Claude cria uma lista de tarefas e vai marcando cada item conforme completa, permitindo acompanhar o progresso.

A lista permite voce trabalhar em outra coisa enquanto a automacao roda, verificando periodicamente.

To-do list automatico, checkboxes visuais, acompanhamento de progresso, multitasking.

Nao precisa aceitar o primeiro plano. Voce pode pedir ajustes, adicionar requisitos ou mudar abordagem antes de executar.

Iterar no plano e muito mais barato que refazer depois de implementado. Invista tempo aqui.

Feedback no plano, ajustes antes de executar, multiplas iteracoes, plano final aprovado.

Cada tool e um script Python que faz uma unica coisa bem feita - scrape_site.py, send_email.py, generate_chart.py.

Tools atomicos sao reutilizaveis, testaveis e faceis de debugar quando algo da errado.

Um script = uma funcao, inputs claros, outputs definidos, erros tratados.

Tools que chamam APIs externas: YouTube Data API, Gmail API, Google Sheets, OpenAI, Perplexity.

A maioria das automacoes uteis envolve conectar multiplos servicos via APIs.

API keys no .env, requests library, rate limits, paginacao, autenticacao OAuth.

Tools que transformam dados: JSON para CSV, agregacoes, calculos, filtragem, formatacao para relatorios.

Dados brutos raramente estao no formato que voce precisa - transformacoes sao essenciais.

pandas, json parsing, csv handling, data aggregation, format conversion.

O agente instala automaticamente bibliotecas necessarias via pip quando identifica dependencias faltantes.

Entender dependencias ajuda a debugar erros de importacao e garantir reproducibilidade.

pip install, requirements.txt, virtual environments, dependencias transitivas.

Quando um tool falha, o agente le o erro, investiga a causa, corrige o codigo e testa novamente automaticamente.

O loop de auto-correcao e poderoso, mas voce precisa saber quando intervir para evitar loops infinitos.

Ler stack trace, identificar causa raiz, aplicar fix, verificar correcao, atualizar workflow.

O agente testa cada tool apos criar para garantir que funciona antes de integrar no workflow completo.

Validacao precoce evita descobrir bugs no meio de uma execucao complexa de multiplos tools.

Testes unitarios, execucao isolada, verificacao de output, casos de edge.

MCP server que permite ao agente fazer pesquisas web semanticas, encontrando informacoes relevantes automaticamente.

Exa expande as capacidades do agente para alem de arquivos locais - pode pesquisar documentacao, noticias, dados.

MCP server Exa, pesquisa semantica, web search, content extraction.

MCP server que permite controlar um browser real - navegar, clicar, preencher formularios, extrair dados de paginas dinamicas.

Muitos sites nao tem API - Playwright permite automatizar qualquer coisa que um humano faria no browser.

Browser automation, headless mode, selectors, wait for elements, screenshots.

MCPs sao instalados via comandos CLI que o agente pode executar, configurando automaticamente as integracoes.

Saber instalar MCPs permite expandir as capacidades do agente conforme suas necessidades.

npx install MCP, configuracao automatica, verificacao de instalacao.

Apos instalar um MCP, testar se a conexao funciona antes de usar em automacoes de producao.

Testar MCPs isoladamente evita debugar problemas de conexao no meio de workflows complexos.

Health check, teste de endpoint, verificacao de credenciais, logs de conexao.

Usar multiplos MCPs juntos em um unico workflow - Exa para pesquisar, Playwright para extrair, Gmail para enviar.

O verdadeiro poder esta em combinar capacidades - cada MCP adiciona uma nova "habilidade" ao agente.

Orquestracao de MCPs, passagem de dados, sequenciamento, tratamento de erros cruzados.

MCPs tem acesso a servicos externos - entender as permissoes e riscos de cada um e crucial.

Um MCP mal configurado pode expor dados ou executar acoes nao autorizadas em seus servicos.

Principio do menor privilegio, scopes de API, revisao de permissoes, audit logs.

MCPs dao capacidade de ACAO (conectar a servicos). Skills dao CONHECIMENTO (como fazer algo bem).

Entender a diferenca ajuda a decidir quando criar um skill vs quando usar/criar um MCP.

MCP = API/integracao, Skill = prompt/instrucoes, complementares nao substitutos.

Skills globais ficam disponiveis em todos os projetos. Skills de projeto so existem naquela pasta especifica.

Skills de design ou escrita geralmente sao globais. Skills especificos de um cliente sao por projeto.

~/.claude/skills/ (global), ./claude/skills/ (projeto), quando usar cada um.

Skill que ensina o agente a criar PDFs e documentos visuais bonitos, com filosofia de design e fontes.

Sem o skill, PDFs gerados sao feios. Com ele, o agente aplica principios de design automaticamente.

Canvas design skill, skill.md, fontes incluidas, filosofia visual.

Skills sao instalados copiando codigo para o terminal ou arrastando arquivos - o agente configura automaticamente.

A comunidade compartilha skills uteis - saber instalar permite aproveitar o trabalho de outros.

Copiar comando, colar no terminal, verificar instalacao, testar skill.

Se voce repete instrucoes frequentemente, transforme-as em um skill - um arquivo markdown com suas instrucoes.

Skills proprios economizam tempo e garantem consistencia nas respostas do agente.

Criar arquivo .md, estrutura de skill, instrucoes claras, exemplos incluidos.

Site com colecao de agents, commands, MCP servers, skills e hooks compartilhados pela comunidade.

Nao precisa reinventar a roda - provavelmente alguem ja criou o skill que voce precisa.

cloudcode-templates, buscar por categoria, view details, copiar instalacao.

Plataforma que permite rodar suas automacoes na nuvem - voce so paga quando elas executam.

Sem deploy, suas automacoes so rodam quando voce abre o VS Code. Com Modal, rodam automaticamente.

Serverless, pay-per-use, $5 gratis, $30 com cartao, duracao ilimitada por execucao.

Trigger que executa sua automacao em horarios definidos - toda segunda as 6h, todo dia as 9h, etc.

Relatorios semanais, coleta de dados diaria, backups - qualquer tarefa recorrente usa cron.

Cron expression, timezone, frequencia, proxima execucao, historico de runs.

URL que dispara sua automacao quando recebe uma requisicao - formulario enviado, lead criado, pagamento feito.

Webhooks permitem reagir a eventos em tempo real, nao apenas em horarios fixos.

Webhook URL, payload JSON, integracao com servicos, Postman para testes.

Modal Secrets armazena suas API keys de forma segura - nunca vao para o codigo ou repositorio.

Secrets expostos sao o erro #1 de seguranca. Modal resolve isso de forma elegante.

Modal secrets, environment variables, nunca no codigo, audit trail.

Pedir ao agente para revisar o codigo antes do deploy - verificar API keys expostas, webhooks inseguros, vulnerabilidades.

Uma revisao de seguranca pode evitar problemas serios quando a automacao estiver publica na internet.

"Run security review", verificar .env, checar webhooks, validar permissoes.

Dashboard do Modal mostra historico de execucoes, logs, erros e tempo de execucao de cada run.

Quando algo falha em producao, os logs sao sua unica forma de descobrir o que aconteceu.

Dashboard Modal, logs por execucao, status (success/failed), debugging remoto.

Automacao que analisa canais de YouTube no seu nicho, identifica videos em alta e gera relatorios semanais.

Este exemplo integra todos os conceitos da trilha em um projeto pratico e util.

YouTube Data API, analise de tendencias, descoberta de canais, metricas de engajamento.

Sequencia de tools: buscar dados (YouTube API), processar metricas, gerar graficos, criar apresentacao.

Entender o pipeline ajuda a decompor qualquer automacao complexa em steps gerenciaveis.

fetch_youtube_data.py, analyze_data.py, generate_charts.py, generate_slides.py.

Usar o canvas design skill para gerar PDFs bonitos com graficos, logo e formatacao profissional.

PDFs bem formatados impressionam clientes e stakeholders - vale o esforco extra.

Canvas design skill, branding (logo), charts embedded, formatacao consistente.

Tool que envia o relatorio por email via Gmail API, com corpo formatado e PDF anexado.

Email e a forma mais comum de entregar resultados de automacoes - essencial dominar.

Gmail API, OAuth credentials, MIME multipart, attachments, HTML body.

Exportar todos os dados coletados para Google Sheets, permitindo analises adicionais e historico.

Sheets permite compartilhar dados com equipe e criar dashboards sem codigo adicional.

Google Sheets API, multiplas abas, append vs overwrite, formatacao automatica.

Deploy do workflow completo no Modal com cron trigger semanal - roda automaticamente sem intervencao.

Este e o objetivo final: automacoes que trabalham para voce enquanto voce faz outras coisas.

Deploy Modal, cron semanal, monitoramento, alertas de falha, iteracao continua.