MedTechCommunity

Capítulo 6

Claude Projects — Criando Assistentes de IA

Introdução

Até agora, cada conversa com a Claude começava "do zero" — você precisava re-enviar documentos, re-explicar contexto, re-estabelecer tom e regras. É como trabalhar com um assistente brilhante que esquece tudo ao final de cada dia.

O Claude Projects resolve esse problema de forma elegante. Projects são workspaces persistentes que contêm sua própria base de conhecimento, instruções customizadas e histórico de conversas — tudo isolado e organizado por contexto de trabalho.

Com Projects, a Claude já "conhece" seu contexto antes de você digitar a primeira mensagem. Não é exagero dizer que Projects é a funcionalidade que transforma a Claude de um chatbot inteligente em um assistente especializado.

Neste capítulo, você vai aprender a anatomia de um Project, como funciona o RAG automático, os princípios para criar projetos eficazes, como estruturar Custom Instructions profissionais e como usar Projects para criar verdadeiros assistentes de IA personalizados.

1. O que são Claude Projects

Um Project no Claude é um espaço de trabalho persistente que permite configurar um contexto fixo carregado automaticamente em toda conversa iniciada dentro dele. Na prática, é como criar um "escritório especializado" onde a Claude já sabe quem você é, o que está fazendo e como deve se comportar.

Cada Project é composto por 4 componentes configuráveis:

1. Nome e Descrição — Identificador humano para organização. A descrição é informativa e não influencia o comportamento da Claude — serve apenas para você lembrar do propósito do projeto.

2. Custom Instructions (Instruções Personalizadas) — Este é o componente mais importante. É um system prompt persistente que será injetado no início de toda conversa do projeto. Aqui você define: quem a Claude é neste contexto, quem você é, como ela deve se comportar, qual o workflow a seguir, quais as regras e restrições, e qual o formato de saída esperado.

As Custom Instructions funcionam como o system prompt da API: tudo que você colocar ali será tratado pela Claude como instrução de alta prioridade, antes de qualquer mensagem do usuário.

3. Knowledge Base (Base de Conhecimento) — Você pode fazer upload de documentos que ficam disponíveis para a Claude consultar em todas as conversas do projeto. Formatos suportados incluem PDF, DOCX, CSV, TXT, HTML e Markdown, com limite de até 30MB por arquivo. É aqui que a mágica do RAG acontece.

4. Chat History (Histórico de Conversas) — Todas as conversas dentro de um Project ficam agrupadas e organizadas, separadas de outros Projects. Você pode ter múltiplas conversas paralelas, todas compartilhando o mesmo contexto base.

Isolamento: Cada Project opera de forma independente — um projeto de trabalho não consegue acessar informações de um projeto pessoal. Isso é uma escolha de design para manter contextos limpos e seguros.

2. RAG Automático — A Mágica por Trás dos Panos

Uma das características que mais diferencia o Claude Projects é o RAG automático (Retrieval-Augmented Generation). Quando a Knowledge Base do seu Project se aproxima do limite da janela de contexto, a Claude automaticamente ativa o modo RAG para expandir a capacidade em até 10x, mantendo a qualidade das respostas.

Na prática, funciona assim:

  • Abaixo do limite de contexto (200K tokens): todo o conteúdo da Knowledge Base é carregado diretamente na memória da Claude (in-context). Máxima qualidade, como ter todos os documentos abertos na sua mesa.
  • Acima do limite: em vez de carregar todo o conteúdo de uma vez, a Claude busca e recupera apenas as informações mais relevantes para responder cada pergunta específica. É como ter um prontuário eletrônico com busca semântica — o volume é maior, mas o sistema encontra exatamente o que precisa.

A transição entre os dois modos é automática e transparente — você não precisa configurar nada. Simplesmente adicione documentos à Knowledge Base e a Claude gerencia o acesso inteligentemente.

Por que isso importa? Imagine que você está criando um assistente de estudos para anestesiologia e quer incluir 100 PDFs de capítulos de livros e artigos. Sem RAG, você seria limitado ao que cabe em 200K tokens (~300 páginas). Com RAG, você pode ter uma biblioteca inteira e a Claude consulta os trechos relevantes para cada pergunta.

O RAG expandido está disponível nos planos pagos (Pro, Max, Team, Enterprise). No plano gratuito, você está limitado ao modo in-context.

3. Custom Instructions — O System Prompt do Projeto

As Custom Instructions são o coração de um Project. Elas definem como a Claude se comporta dentro daquele workspace — e uma boa Custom Instruction é a diferença entre a Claude genérica e a Claude especialista.

A estrutura recomendada para Custom Instructions profissionais segue cinco blocos:

Identidade — Quem a Claude é neste projeto. Defina o papel, a especialidade e o nível de expertise esperado.

"Você é um especialista em farmacologia de anestésicos, com foco em ensino para residentes de primeiro ano."

Contexto — Sobre o que é o projeto e qual o objetivo. Dê informações sobre o público, o escopo e o propósito.

"Este projeto produz material de revisão para a prova de TSA. O público são residentes R1-R3 de anestesiologia."

Workflow/Pipeline — As etapas que a Claude deve seguir. Defina o fluxo de trabalho com passos claros, pontos de pausa e critérios de qualidade.

"Para cada tema: 1) Faça um panorama geral em tópicos. 2) Aguarde minha aprovação. 3) Aprofunde cada tópico. 4) Gere 5 questões de revisão."

Regras — Comportamentos obrigatórios e proibidos. O que fazer e o que não fazer.

"Use exclusivamente as referências da Knowledge Base. Se a informação não constar nas referências, diga explicitamente."

Formato de Saída — Como as respostas devem ser estruturadas.

"Respostas em tópicos e subtópicos, palavras-chave em negrito, linguagem didática. Ao final de cada tema, inclua um diagrama resumo."

Use Markdown headings ou XML tags para separar cada bloco nas Custom Instructions. A Claude processa melhor instruções com hierarquia clara.

4. Princípios de um Bom Projeto

Seis princípios fundamentais para criar Projects eficazes, baseados na documentação oficial da Anthropic e em práticas validadas:

1. Especificidade > Generalidade — Um projeto eficaz tem escopo definido. Quanto mais específico o papel e o workflow, melhor a Claude performa. Um projeto "Assistente Geral" funciona pior do que um projeto "Pipeline de Produção de Ebooks MedTech". Crie projetos separados para contextos diferentes em vez de tentar colocar tudo num projeto só.

2. Golden Examples na Knowledge Base — Um dos usos mais poderosos da Knowledge Base é subir exemplos do output ideal. Se você quer que a Claude produza capítulos num formato específico, suba um capítulo já finalizado como referência. A Claude aprende o padrão implicitamente ao ver o exemplo concreto — isso é muito mais eficaz do que descrever o formato em texto.

3. Economia de Tokens — A janela de contexto é compartilhada entre Custom Instructions + Knowledge Base + histórico. Boas práticas: instruções concisas e diretas (evite repetições), apenas arquivos necessários para aquele projeto, Markdown sobre PDFs (consome menos tokens), e recortes de trechos relevantes em vez de documentos inteiros.

4. Checkpoints e Pontos de Pausa — Para workflows multi-etapa, defina pontos de pausa explícitos nas instruções. Sem isso, a Claude tende a executar tudo de uma vez, o que pode gerar outputs longos e sem oportunidade de revisão intermediária.

5. Nomes Descritivos para Arquivos — A Claude usa os nomes dos arquivos na Knowledge Base para entender o contexto antes de abri-los. Nomeie de forma descritiva: "Cap1-Farmacologia-Propofol.md" é muito melhor que "doc1.pdf".

6. Conversas Separadas por Tema — Dentro de um Project, crie conversas diferentes para temas diferentes. Cada conversa herda as Custom Instructions e a Knowledge Base, mas mantém seu próprio histórico limpo. Isso evita que outputs de um tema poluam o contexto de outro.

5. Montando um Projeto na Prática

Vamos aplicar tudo em um exemplo concreto: criar um Assistente de Estudos para qualquer área.

Antes de abrir a Claude:

  1. Defina as fontes — Baixe os documentos que serão a base de conhecimento: capítulos de livros, artigos, guidelines, anotações. Organize em uma pasta no seu computador.
  2. Pense no workflow — Como você quer estudar? Ciclos de leitura e exercícios? Resumos seguidos de questões? Flashcards? Defina o fluxo antes de criar o projeto.
  3. Defina o formato — Como quer que as respostas sejam estruturadas? Tópicos? Tabelas? Mapas mentais?

Na Claude:

  1. Crie o Project com um nome descritivo: "Estudos TSA — Farmacologia".
  2. Escreva as Custom Instructions seguindo a estrutura dos 5 blocos (identidade, contexto, workflow, regras, formato).
  3. Suba os documentos para a Knowledge Base. Priorize Markdown e TXT sobre PDFs.
  4. Inicie a primeira conversa pedindo um panorama geral do conteúdo na Knowledge Base.
  5. Itere — Peça aprofundamentos tópico por tópico, gere questões, crie flashcards.

Dica avançada: você pode pedir para a própria Claude escrever as Custom Instructions. Descreva o que você quer que o projeto faça, o público, as fontes e o formato desejado — e peça: "Com base nisso, escreva as Custom Instructions otimizadas para este projeto." A Claude gera system prompts excelentes para si mesma.

Outro ponto importante: Projects permitem trabalho colaborativo. Nos planos Team e Enterprise, você pode compartilhar projetos com colegas, com permissões de "Can Use" (usar sem editar) ou "Can Edit" (usar e modificar). Isso permite que toda uma equipe use o mesmo assistente especializado com contexto consistente.