Claude Code 102 para Pesquisadores Acadêmicos

Esta é a segunda parte de uma série de tutoriais que estou fazendo sobre o sobre o Claude Code para pesquisadores acadêmicos.

Este tutorial se baseia no primeiro tutorial, Claude Code 101, que viralizou com mais de 4 milhões de visualizações. Você pode lê-lo abaixo:

Estou escrevendo estes tutoriais em uma linguagem simples e acessível. Você não precisa de nenhuma habilidade técnica para entender estes tutoriais ou usar o Claude Code. Se você consegue escrever frases em inglês, você consegue usar o Claude Code.

Breve Resumo do Claude Code 101

No primeiro tutorial, você aprendeu a abrir uma única pasta, adicionar seus PDFs e dar ao Claude Code um arquivo CLAUDE.md, que contém instruções para o Claude Code. Esse tipo de configuração funciona para um projeto mais curto ou quando você está começando no Claude Code.

Mas, como pesquisadores acadêmicos, nossos projetos se estendem por meses e até anos, acumulando centenas de artigos e vários rascunhos.

Neste tutorial, aprenderemos como estruturar um projeto acadêmico mais longo com a ajuda do Claude Code.

Parte 1: Estruturando um Projeto Longo

Vamos supor que estamos trabalhando em um projeto como uma dissertação, uma monografia ou um artigo de pesquisa. Se você organizar um projeto como este em uma única pasta com apenas um arquivo CLAUDE.md, o Claude acabará dando os mesmos tipos de resultados. Ele não conseguirá fornecer resultados precisos e personalizados para o seu trabalho.

Pense assim: se você quiser que seu assistente de pesquisa (humano) redija uma seção do seu artigo, limpe um conjunto de dados ou anote um artigo, você dará a ele um conjunto diferente de instruções para cada uma dessas tarefas.

Podemos usar exatamente esse esquema de organização no Claude Code criando subpastas.

1.1 Subpastas para Melhor Organização

Digamos que você em uma dissertação para a qual tem uma pasta principal chamada "Minha Dissertação". Dentro da pasta principal, crie subpastas:

Literatura para PDFs e anotações sobre publicações acadêmicas
Capítulos para rascunhos dos seus capítulos
Dados para conjuntos de dados
Notas para notas de reuniões e ideias
Correspondência para e-mails do orientador, trocas com coautores, relatórios de revisores

Esse tipo de organização ajudará tanto você quanto o Claude Code. Se você precisar trabalhar em um rascunho de um capítulo, pode ir diretamente para a pasta Capítulos.

O mesmo acontece com o Claude Code. Se você fizer uma pergunta sobre, digamos, um determinado dado, ele saberá procurá-lo na pasta Dados.

1.2 Arquivos CLAUDE.md para Subpastas

No tutorial, escrevemos um arquivo CLAUDE.md, que é um conjunto de instruções que o Claude Code lê toda vez que inicia uma sessão.

Na sua dissertação principal, escreva um arquivo CLAUDE.md que informe o Claude Code sobre você e seu projeto em termos gerais. Vamos chamá-lo de arquivo CLAUDE.md "global".

Isso não significa que você deva ser vago. Seja preciso, mas dê o panorama geral. Teremos tempo para especificidade depois. Trate este CLAUDE.md como a constituição do seu projeto.

Dentro de cada subpasta, coloque outro arquivo CLAUDE.md que se aplique apenas àquela subpasta específica. Vamos chamá-los de arquivos CLAUDE.md "locais". O objetivo dos arquivos CLAUDE.md locais nas subpastas é dar ao Claude Code instruções específicas sobre essas tarefas sem inchar o arquivo CLAUDE.md principal.

Por exemplo, o arquivo CLAUDE.md na sua subpasta Capítulos pode dizer:

Se eu pedir para criticar meu rascunho, siga a estrutura: argumento, evidência, literatura, contraponto. Sempre use o estilo de citação MLA 9ª edição, a menos que eu especifique o contrário.

O arquivo CLAUDE.md para a subpasta Dados pode conter uma instrução como:

Trate todos os arquivos CSV e planilhas do Excel como dados brutos, a menos que eu especifique o contrário. Nunca sobrescreva nenhum arquivo bruto. Salve as versões limpas com _clean adicionado ao final dos nomes dos arquivos.

E o arquivo CLAUDE.md para a pasta Correspondência pode dizer:

Sempre priorize os pontos que são comuns entre os relatórios de revisão e as trocas com coautores.

1.3 Arquivos CLAUDE.md Aninhados

Quando o Claude Code trabalha em uma subpasta, ele lê dois arquivos CLAUDE.md: um que está na subpasta e o outro que está na pasta principal.

Esses arquivos CLAUDE.md aninhados dão ao Claude Code uma ideia clara sobre o que é seu projeto geral e como responder a perguntas específicas com precisão.

1.4 Estilos de Saída para Arquivos CLAUDE.md Locais

Você também deve considerar adicionar uma breve instrução sobre o estilo de saída em cada arquivo CLAUDE.md local.

Por exemplo, na subpasta Literatura, você pode pedir ao Claude Code para fornecer uma tabela com colunas para argumento, evidência, relevância para seu projeto quando pedir para resumir um artigo. Da mesma forma, na subpasta Notas, pode pedir para responder em tópicos.

Você pode sempre voltaradas.

Você sempre pode voltar e revisar essas instruções.

1.5 Prático/Exercício

Abra sua pasta principal de dissertação principal no Claude Code e digite o seguinte prompt:

Leia os cinco artigos que adicionei à subpasta Literatura hoje e me diga quais apoiam ou refutam meus argumentos em "Capítulo 3 – Esboço.md" na subpasta Capítulos.

O Claude Code lerá o arquivo CLAUDE.md global e dois arquivos CLAUDE.md locais nas subpastas Literatura e Capítulos e dirá qual artigo apoia ou refuta seus argumentos.

1.6 O Que Não Fazer

Não duplique instruções nos arquivos CLAUDE.md global e locais. É desnecessário e fará com que o Claude Code processe mais tokens.

Os arquivos CLAUDE.md locais nas subpastas não devem contradizer instruções no arquivo CLAUDE.md global. Se houver uma contradição, o Claude Code seguirá a instrução mais específica, mas você acabará confuso.

Parte 2: Modo de Planejamento e Comandos de Barra Personalizados

Um projeto acadêmico longo, como uma dissertação ou um artigo de pesquisa envolve certas tarefas repetitivas. Por exemplo, você pode estar selecionando artigos para revisão de literatura repetidamente. Você terá que escrever um esboço toda vez que começar a redigir um capítulo. Se você escrever rascunhos zero (também conhecidos como escrita livre), precisará "limpá-los" quase diariamente.

Mas também existem tarefas complexas e não repetitivas. Por exemplo, responder ao feedback dos revisores requer um envolvimento sério com o feedback crítico deles, seguido pela reescrita do seu manuscrito.

O Claude Code pode ajudar com ambos os tipos de tarefas. Para tarefas complexas e únicas, o Claude Code oferece um Modo de Planejamento e, para tarefas repetitivas, ele tem Comandos de Barra Personalizados.

2.1 Modo de Planejamento

Geralmente, quando você dá uma tarefa ao Claude Code, ele imediatamente começa a trabalhar. Para tarefas pequenas e de baixo risco, funciona bem. Por exemplo, você pede ao Claude Code para renomear todos os PDFs na sua subpasta Literatura usando seus títulos e nomes dos autores. O Claude Code faz isso imediatamente.

Mas essa abordagem não produz resultados desejáveis para tarefas complexas. Suponha que você tenha suas anotações brutas sobre trinta e cinco artigos de pesquisa e peça ao Claude Code para sintetizar suas anotações. Se o Claude Code entender mal uma instrução por qualquer motivo, você só perceberá quando ele concluir a tarefa.

O Modo de Planejamento dá mais controle sobre o Claude Code. Em vez de agir imediatamente, ele escreve um plano passo a passo do que vai fazer. Você lê o plano; se não concordar com algo, pede para alterar o plano de acordo.

Você pode encontrar o Modo de Planejamento no menu de permissões abaixo da barra de chat. Também pode abri-lo usando Ctrl + Shift + M. Ou pode simplesmente pedir ao Claude Code para mostrar o plano no prompt antes de executar qualquer coisa.

2.2 Quando Usar o Modo de Planejamento

O Modo de Planejamento é mais adequado para tarefas complexas envolvendo três ou mais etapas, uma tarefa que envolva mais de uma subpasta ou uma tarefa que produza uma saída longa. Exemplos podem incluir: sintetizar suas anotações, selecionar estudos para uma revisão sistemática ou limpar um conjunto de dados e produzir um livro de códigos.

Você não pediria ao seu assistente de pesquisa (humano) para apenas "redigir o capítulo três" sem perguntar sobre o plano deles. O Modo de Planejamento no Claude Code funciona da mesma forma.

2.3 Comandos de Barra Personalizados

Um Comando de Barra é um atalho. O Claude Code tem vários Comandos de Barra integrados. Abra seu Claude Code e digite uma barra, e ele mostrará uma lista de Comandos de Barra integrados. Quando você digita, por exemplo, o Comando de Barra integrado /schedule, o Claude Code criará uma tarefa agendada que pode ser executada sob demanda ou automaticamente.

Um Comando de Barra nada mais é do que um conjunto de instruções escritas em inglês simples que o Claude Code segue. Você pode pensar nele como um prompt longo que não precisa digitar toda vez que quiser usá-lo para uma tarefa repetitiva.

Lembre-se, na Parte 5 do tutorial 101, aprendemos a criar uma Skill manualmente e automaticamente. Se criarmos uma Skill automaticamente, ela nos dará um Comando de Barra Personalizado.

Quando você cria um Comando de Barra Personalizado, o Claude Code criará um arquivo .md na pasta .claude/commands no seu computador. Você precisa saber desse caminho para que, se precisar editar o arquivo .md, saiba onde encontrá-lo.

2.4 Criando o Primeiro Comando de Barra Personalizado

A maneira mais simples de criar um Comando de Barra Personalizado é pedir ao Claude Code para criar um para você. Por exemplo, você pode abrir o Claude Code e digitar o seguinte:

Crie um Comando de Barra chamado /primeirorascunho que converta minhas anotações brutas na minha pasta Notas em parágrafos coesos e coerentes, sem palavras ou frases redundantes.

O Claude Code escreverá um conjunto de instruções em um arquivo e o colocará na pasta .claude/commands. Assim que o Claude Code terminar de criar o Comando de Barra, reinicie a sessão e digite uma barra. Você verá /primeirorascunho no menu.

Você pode construir uma biblioteca de Comandos de Barra Personalizados escritos especificamente para seu projeto.

2.5 O Que Não Fazer

Não escreva Comandos de Barra para tarefas que você realiza uma vez a cada seis meses. Esses Comandos vão lotar seu Menu de Barra e provavelmente ficarão desatualizados à medida que seu projeto evoluir.

Não adicione instruções longas envolvendo processos de várias etapas em um arquivo de Comando de Barra. Mantenha um Comando de Barra para uma tarefa repetitiva específica. Se suas instruções excederem quinze linhas, provavelmente você precisa de dois Comandos de Barra.

Para tarefas mais longas e complexas, não pule o Modo de Planejamento.

Parte 3: Subagentes para Tarefas de Pesquisa em Paralelo

Até agora, vimos apenas tarefas que podem ser feitas em uma única sessão do Claude Code, seja no Modo de Planejamento ou com Comandos de Barra Personalizados. Você tem um assistente de IA com quem trabalha no painel principal.

Mas para um projeto mais longo, como uma dissertação ou um artigo de pesquisa, você pode precisar de vários assistentes de IA. É aí que entram os subagentes.

3.1 Por Que Um Assistente Não é Suficiente

Em projetos mais longos, encontramos dois problemas ao usar um agente de IA como o Claude Code.

Se você pedir ao Claude Code para ler vinte PDFs na sua pasta Literatura, cada página de cada artigo se torna parte da conversa para o Claude Code. Você faz várias perguntas, e ele responde.

Agora, todo o texto dos artigos e suas conversas faz parte da memória do Claude Code para aquela sessão. Se você pedir para ele redigir um esboço para o Capítulo 4 da sua dissertação, as respostas ficarão lentas e sem clareza por causa de todo o contexto. Isso é chamado de "poluição de contexto".

Em segundo lugar, em uma única sessão, você só pode atribuir tarefas ao Claude Code tarefas sequencialmente. Se você quiser três críticas diferentes do seu manuscrito (uma de um teórico, uma de um de um especialista em informação e uma do Revisor 2), você não pode executá-las sequencialmente em uma única sessão, porque cada crítica influenciará a próxima devido à poluição de contexto.

Você precisa de três sessões independentes para uma tarefa como esta.

3.2 O que é um Subagente?

Pense em um subagente como uma versão especializada do Claude Code com suas próprias instruções e, mais importante, sua própria janela de contexto. A janela de contexto é a memória de trabalho do Claude Code para uma única conversa. Tudo o que o Claude Code pode "ver" em um determinado momento, desde seus arquivos até seus prompts, passando por suas próprias respostas e instruções no CLAUDE.md, está dentro da janela de contexto. Quando você faz uma pergunta, o Claude Code usa sua janela de contexto para responder.

Assim como os Comandos de Barra Personalizados, um subagente também existe como um arquivo .md. Mas, ao contrário de um Comando de Barra, que não tem janela de contexto, um subagente tem uma.

Outra diferença importante entre um Comando de Barra e um subagente é que, ao contrário de um Comando de Barra, um subagente não lê o arquivo CLAUDE.md. Ele tem suas próprias instruções em um arquivo .md e só.

Um subagente terá um papel muito específico, por exemplo, um "Verificador de Citações" ou um "Revisor Crítico". E cada agente tem seu próprio contexto. Quando você delega uma tarefa da sua sessão principal para um subagente, a leitura e o raciocínio permanecerão dentro do subagente. Você receberá apenas a resposta final. Dessa forma, você pode manter sua sessão principal livre de poluição de contexto.

3.3 Subagentes para Pesquisadores

Embora o tipo exato de subagentes que você precisa dependa do seu projeto, seguem alguns exemplos gerais.

Subagente de Revisão de Literatura: lê cada novo PDF adicionado à pasta Literatura e fornece resumos estruturados em relação ao seu argumento.
Subagente Verificador de Citações: pega um rascunho de capítulo e verifica cada fonte citada em relação aos artigos na pasta Literatura e aponta referências ausentes.
Subagente Auditor de Metodologia: para projetos empíricos, verifica se sua seção de métodos está em consonância com os dados e análises.
Subagente Revisor 2: critica seus rascunhos como um revisor hostil.

3.4 Criando um Subagente

Assim como criar Comandos de Barra Personalizados, a maneira mais fácil de criar um subagente é pedir ao Claude Code para criar um. Abra uma sessão e digite:

Crie um subagente chamado Verificador de Citações. Ele pegará um rascunho da pasta Capítulos, listará cada citação no texto, verificará cada uma em relação aos artigos na pasta Literatura. Em seguida, criará um arquivo markdown com as referências ausentes. O subagente nunca deve editar ou alterar o rascunho.

O Claude Code criará um arquivo citation-checker.md e o colocará na pasta Agents dentro da sua pasta .claude.

Reinicie a sessão e seu subagente está pronto para uso. Para implantar um subagente, basta pedir ao Claude Code para usá-lo. Por exemplo, "Use o Verificador de Citações no chapter_4.md na pasta Capítulos."

Se desejar, pode editar o arquivo .md do subagente para adequá-lo às suas necessidades.

3.5 Exemplo: Crítica em Paralelo

Suponha que você terminou de redigir um capítulo e agora quer feedback antes de enviá-lo ao seu orientador ou colega. Abra uma sessão e digite:

Em paralelo, peça ao Auditor de Metodologia e ao Revisor 2 para lerem e criticarem o chapter_4 na pasta Capítulos e me darem relatórios de revisão. Salve os dois relatórios como chapter_4_criticas sob o nome do subagente na mesma pasta.

Ambos os subagentes usarão seus próprios contextos para ler e avaliar seu rascunho. Quando terminarem, você terá as duas críticas como dois arquivos separados. Sua sessão principal nunca precisou adicionar seu rascunho, ou qualquer coisa relacionada, à sua janela de contexto.

Observe que isso pode levar alguns minutos, dependendo do modelo que você estiver usando.

3.6 O Que Não Fazer

Não crie um subagente para tarefas menores.

Não dê aos seus subagentes responsabilidades sobrepostas.

Nunca deixe seu subagente editar seus rascunhos. Um subagente deve sempre produzir seus relatórios como arquivos separados.

Parte 4: Conectando o Claude Code a Outros Aplicativos

Até agora, seu projeto permaneceu dentro do Claude Code, sem integração com nenhum outro aplicativo. Tudo o que o Claude Code lê, edita e escreve existe dentro da pasta do seu projeto.

Mas projetos acadêmicos como dissertações e artigos de pesquisa envolvem processos organizacionais e estruturais complexos que estão distribuídos em vários aplicativos. Por exemplo, suas citações estão no Zotero, seus rascunhos no Google Drive e suas notas de reunião no Zoom.

Como integramos esses aplicativos com nosso Claude Code?

Em 2024, a Anthropic introduziu um método chamado Model Context Protocol (MCP) que permite aos usuários integrar aplicativos como Zoom e Google Drive com o Claude Code.

Você não precisa se preocupar com o que é MCP e como funciona. Você só precisa saber como conectar diferentes aplicativos usando o MCP.

4.1 Como Conectar um Aplicativo ao Claude Code

Abra seu Claude Code e, no canto superior esquerdo, você verá uma opção "Personalizar". Clique nela e selecione "Conecte seus aplicativos" na tela seguinte.

Isso mostrará os Conectores, uma lista de aplicativos aprovados pela Anthropic para uso no Claude Code. Procure por aplicativos como Zoom ou Google Drive e clique em "Conectar" na tela seguinte.

Será solicitado que você conceda permissões ao Claude Code. Depois de fazer isso, seu aplicativo estará conectado ao Claude Code.

4.2 Exemplo Prático

Conecte seu Zoom ao Claude Code, abra uma sessão e digite:

Pegue a transcrição das três chamadas recentes que tive com meu colega. Extraia todos os comentários relacionados ao Capítulo 4 em Rascunhos. Salve todos os comentários extraídos em um novo arquivo na pasta Correspondência com a data de hoje.

4.3 Conectores e Subagentes

À medida que seu projeto evolui, você pode usar uma combinação de Conectores e subagentes para tornar seus processos eficientes.

Por exemplo, você pode configurar um subagente chamado Revisor de Literatura que usa as bases de dados PubMed ou arxiv disponíveis na lista de Conectores.

4.4 O Que Não Fazer

Não instale muitos Conectores. Seja seletivo e instale apenas aqueles relacionados ao seu projeto.

Não conecte aplicativos que possam conter informações confidenciais que você não queira compartilhar com a IA. Por exemplo, se seu Slack contiver mensagens com dados confidenciais não publicados, não o conecte.

Parte 5: Hooks e Tarefas Agendadas

Uma das partes mais importantes de qualquer projeto de pesquisa é ter um backup de todos os seus arquivos. Você não quer ter uma única cópia da sua dissertação em um computador que trava três dias antes da sua defesa.

5.1 O que é um Hook?

Os Hooks no Claude Code podem automatizar o processo de criação de backups. Um Hook é um conjunto curto de instruções que é acionado automaticamente quando um evento específico ocorre no Claude Code. Depois de configurar um Hook, você não precisará se lembrar de usá-lo. O Claude Code o Claude Code o usará automaticamente.

5.2 Criando Seu Primeiro Hook

A maneira mais fácil de criar um Hook é simplesmente pedir ao Claude Code para criar um. Abra uma sessão do Claude Code e digite:

Configure um hook de segurança pré-edição que copie um capítulo e salve sua versão atual antes de começar a editá-lo.

Este Hook criará uma versão de backup de qualquer capítulo que você pedir ao Claude Code para editar.

Assim que o Hook estiver pronto para uso, peça ao Claude Code o seguinte:

Edite o Chapter_4.md em Rascunhos à luz dos comentários na transcrição da reunião de hoje no Zoom.

O Claude Code criará um backup do arquivo original, colocará em uma pasta de backup e editará uma cópia na pasta Rascunhos.

5.3 O que são Tarefas Agendadas

Projetos de escrita acadêmica mais longos envolvem tarefas que precisam ser feitas em intervalos regulares. Por exemplo, você querer executar varreduras de literatura toda semana para se manter atualizado sobre as publicações mais recentes.

Você pode configurar Tarefas Agendadas assim como os Hooks no Claude Code. Basta descrever o que deve acontecer e quando, e o Claude Code escreverá uma rotina para isso. As Tarefas Agendadas usarão os Conectores e subagentes que discutimos nas partes anteriores.

5.4 Casos de Uso para Tarefas Agendadas

Como pesquisador, você pode querer agendar um backup regular de seus rascunhos. Você pode pedir ao Claude Code para criar uma Tarefa de Backup de Rascunhos que copie tudo na pasta Rascunhos e salve em uma pasta de backup com um carimbo de data/hora.

5.5 Exemplo

Abra uma sessão do Claude Code e digite:

Crie uma Tarefa Agendada que seja executar toda segunda-feira de manhã às 9h. Ela deve usar o MCP do PubMed para buscar novos artigos sobre mídia social e saúde mental publicados na última semana. Em seguida, deve entregar os artigos ao subagente de Revisão de Literatura para selecioná-los. Salve a tabela de seleção em uma subpasta chamada Varreduras Semanais na pasta Literatura.

5.6 O Que Não Fazer

Não configure Hooks ou Tarefas Agendadas que envolvam a exclusão de qualquer arquivo.

Não crie muitos Hooks a ponto de ter dificuldade em lembrá-los. Ou você pode manter uma lista separada de Hooks para se lembrar.

Não configure um Hook ou uma Tarefa Agendada para algo que você não tenha feito pelo menos quatro vezes manualmente.