🌱 Fundamentos do Claude Cowork

Chat é o produto de conversa pura. Code é o agente de linha de comando pra devs. Cowork é o ambiente híbrido: conversa + ações em ferramentas reais, no Desktop App.

Saber qual produto usar evita gastar token caro com tarefa errada. Cowork resolve 80% do dia-a-dia de marketing sem precisar abrir terminal.

Cowork = ambiente agentivo. Chat = texto. Code = CLI. Pode trocar entre eles preservando contexto.

Skills são instruções reutilizáveis em markdown. Pense em cada uma como um funcionário: ela só "aparece" quando você descreve uma tarefa que casa com sua descrição.

Esse modelo mental destrava tudo: você para de escrever prompts gigantes e passa a montar uma equipe.

SKILL.md, YAML frontmatter, progressive disclosure (só carrega quando necessário).

Prospecção em Gmail, scraping competitivo, deep research multifonte, dashboards, revisão de contrato, design em escala no Canva, sincronização Notion/Linear, atribuição de receita.

Ver o leque inteiro evita "martelar" Cowork em coisa errada. Saber o que ele é bom e o que ele não é.

Marketing plugin oficial (6 workflows): Brand Review, Campaign Plan, Email Sequence, Performance Report, Competitive Brief, Draft Content.

Janeiro/2026: lançamento do Cowork derrubou US$ 285 bi de valor de software num dia. Porque o agente substitui camadas inteiras de SaaS (assinatura, agendamento, pesquisa, geração).

Você é o operador do que está substituindo SaaS. Quem entende isso primeiro tem vantagem de 6-12 meses no mercado.

Agente substitui interfaces. Operador (você) substitui equipes. Skills substituem workflows manuais.

GPTs são instruções + arquivos, sem ações. n8n é fluxo determinístico (drag-and-drop). Cowork é agente conversacional com ações em tempo real.

Não tudo é prego pra martelo Cowork. Workflow repetitivo + alto volume → n8n. Workflow conversacional + decisão → Cowork.

Determinístico vs agentivo. Volume vs adaptabilidade. Cowork brilha quando o caminho não é 100% previsível.

Pedido simples: "Abra o YouTube, encontre meu canal e me mostre o último vídeo." O Cowork abre o browser, navega e devolve.

Sentir na prática a diferença entre "responder texto" e "executar no mundo".

Computer use, browser automation, observação visual + ação.

Plano Max ou superior libera Cowork. Desktop App (Mac/Windows) é onde Cowork roda nativo, com permissões de browser e arquivos.

Sem Desktop App, várias ações (browser, arquivos) não funcionam. Web Claude é limitado.

Permissões de sistema, sandbox, Anthropic Account.

Pasta Cowork raiz com 4 subpastas: ABOUT ME (brand brief, ICP, KPIs), PROJECTS (cliente/produto), TEMPLATES (prompts e formatos), CLAUDE OUTPUTS (entregas).

O Claude lê esses arquivos como contexto persistente. Sem isso, você reexplica tudo toda vez.

Context engineering, brand brief, ICP, KPI benchmarks.

Arquivo único de 1-2 páginas com: o que vendemos, pra quem, voz de marca, KPIs, concorrentes, regras de tom.

Esse arquivo evita 80% das correções. Sem ele, todo output é genérico.

ICP, voice/tone, do's & don'ts, "north star metric".

Markdowns com prompts e instruções padronizados: estrutura de campanha, script de reel, brief de blog, etc.

Templates = versão 0 de skills. Quando um template estabiliza, vira SKILL.md.

Da pasta TEMPLATES nasce o repositório de skills.

Pasta local sincronizada com Drive/Dropbox/iCloud. Cowork lê via filesystem, então precisa estar no disco.

Trabalha em vários dispositivos sem perder contexto. Backup automático.

Path absoluto, permissões, exclusão de pastas sensíveis.

Prompt: "Leia minha pasta Cowork e me dê um resumo de quem eu sou, meu ICP e KPIs."

Confirma que Cowork tem permissão de filesystem e que seu brief está acessível.

Smoke test, verificação de contexto, debugging por leitura.

Cada skill é uma pasta com um arquivo SKILL.md. O nome da pasta vira o ID da skill.

Skills são portáveis: a mesma pasta funciona em Cowork, Code e até em outros agentes (padrão aberto da Anthropic).

Pasta = unidade. Skill ID = nome da pasta. Padrão aberto.

Cabeçalho YAML com `name` e `description`. Sempre carregado no contexto do Claude — é o que faz ele decidir invocar a skill.

Description ruim = skill nunca dispara. Description boa = Claude acerta sozinho qual usar.

Triggers, palavras-chave, "use this skill when…".

Frontmatter sempre carregado. Corpo só quando invocado. Anexos (references/, assets/) só quando o corpo pede.

Economiza token e mantém contexto enxuto. Você pode ter 100 skills sem estourar nada.

Camadas. Lazy load. Anexos opcionais.

`references/` = docs longas. `assets/` = imagens/PDFs. `scripts/` = python/shell que o agente pode executar.

Skills viram poderosas quando vêm com scripts. Ex: gerador de PDF, validador de schema.

Skill = instruções + ativos + código auxiliar.

Skill oficial da Anthropic. Você diz "quero criar uma skill pra X", ela faz entrevista e gera o SKILL.md.

Você nunca precisa escrever YAML/markdown manualmente. A meta-skill cuida.

Bootstrap, entrevista guiada, evals automáticos.

Comando para o Claude rodar testes contra a skill e comparar com baseline (sem skill).

Skill ruim piora o output. Evals impedem que você tenha skill que atrapalha.

Baseline, regressão, score por critério.

Skill = "como fazer" (workflow). Connector = ponte pra serviço (OAuth nativo). MCP server = ponte programável pra qualquer API.

Saber qual é cada um evita instalar 3 coisas pra mesma tarefa.

Procedural vs ferramenta. OAuth vs API key. Nativo vs custom.

Google Workspace, Notion, Canva, GitHub, Slack, HubSpot, Linear, Stripe — tudo via OAuth, 1 clique.

Se um serviço está aqui, use o conector. Mais seguro que API key manual.

OAuth scope, revogação, audit log.

Apify não está na lista oficial. Você adiciona via "Add custom connector" colando texto de configuração.

Qualquer serviço com OAuth ou MCP pode entrar como custom.

Configuração JSON, scope, "Allow access".

MCP = Model Context Protocol. Servidor que expõe ferramentas pra qualquer agente. Existe MCP pra Stripe, Postgres, GitHub, Linear, etc.

Use MCP quando: precisa de controle fino, integra API obscura, ou quer rodar local.

stdio, sse, registry, local vs remote.

Cada conector pede escopos (read, write, admin). Conceda o MENOR necessário.

Conceder admin do Gmail por preguiça é risco real. Read-only resolve 90%.

Princípio do menor privilégio, audit, revogação rápida.

Reautenticar, verificar escopos, testar com prompt mínimo, ver log do conector.

90% dos erros são OAuth expirado ou escopo faltando.

Token refresh, rate limit, fallback.

Você diz "transforme isso em tarefa recorrente diária às 9h" e o Cowork cria o cron.

É o que destrava produtividade de verdade: o agente trabalha enquanto você dorme.

Cron, recurrence, fuso horário, notificação de erro.

Daily 9am (trend scan), Monday 9am (relatório semanal), on-demand (com gatilho manual).

Cadência errada = ou esquece, ou inunda. Daily pra signal, weekly pra report.

Frequência ótima por tipo de output.

O resultado pode cair em Drive, ser enviado por Gmail, postado em Slack ou só ficar na conversa.

Output sem destino bom = output perdido.

Sink, canal, formato (markdown vs PDF vs HTML).

Cowork abre o X.com, conversa com Grok como humano faria, traz a resposta e processa.

Desbloqueia dados que não têm API barata. Grok tem acesso ao firehose do X.

Computer use, navegação visual, sem API paga.

Skill A (trend scan) → Skill B (gera ideia de vídeo) → Skill C (cria slide Canva).

Encadear é como você sai de 1 tarefa pra um sistema.

Pipeline, handoff, estado intermediário.

Tarefa agendada que falha sem te avisar. Conta de token sobe, output some.

Configure alerta de falha (email/Slack). Verifique log semanal.

Heartbeat, alerta, retry com backoff.

Frase explícita: "Meu objetivo declarado com este prompt é X". Cowork usa isso pra resolver ambiguidade.

Sem objetivo, o agente otimiza pra "parecer útil" e foge do que você queria.

Norte do agente. Critério de sucesso explícito.

Cowork pode ler seu brand brief. Você refere a ele: "Use meu ABOUT ME e ICP".

Output dá quebra em qualidade quando ele tem contexto. Genérico vira específico.

Reference, anchor, "based on my files".

Definir critérios numerados. Ex: matriz 4 fatores Primacy/Authority/Velocity/Fit.

Framework força o agente a ranquear, comparar, justificar.

Score matrix, weights, threshold.

"Antes de rodar, me confirma o plano." Salva tokens e evita output errado.

Tarefa longa que parte errada custa caro.

Dry run, plano, "checkpoint".

Após output: "essa parte tá boa, essa não. Refaz só X". Não recomece do zero.

Cowork preserva contexto da sessão. Iterar é mais barato que reprompt.

Feedback localizado, "keep X, change Y".

Depois de rodar 3-5 vezes com resultados bons, peça: "Transforme isso em skill reusável."

Skill = prompt cristalizado. Você nunca mais reescreve.

Maturação de workflow, "enshrine" do prompt.