Projetos do Claude Code: como configurar e entregar trabalho real (2026)

Resumo

O Claude Code é a ferramenta de codificação agêntica da Anthropic que vive no seu terminal, lê todo o seu repositório e edita arquivos, executa testes e abre pull requests por conta própria. "Projetos do Claude Code" agora significa duas coisas: a novíssima funcionalidade Projects lançada em 17 de setembro de 2026 (agrupar sessões relacionadas, supervisionar vários agentes ao mesmo tempo), e o sentido mais antigo e amplo de "uma base de código para a qual você aponta o Claude Code". O que separa um projeto frustrante de um tranquilo é a camada de configuração ao redor dele: um arquivo CLAUDE.md, subagentes, servidores MCP e skills. Ele está incluído em todos os planos pagos da Claude, então a maioria das pessoas já o tem.

Um limite honesto que vale a pena dizer desde já: o Claude Code é infraestrutura que você comanda, não um funcionário que chega já treinado. Ele é excelente para escrever software. Se o seu "projeto" na verdade é uma fila de suporte ou um pipeline de conteúdo, você precisa de um colega de equipe pronto para trabalhar em vez disso. É essa lacuna que a eesel preenche, e, como a eesel tem seu próprio CLI e servidor MCP, você pode até comandar esse colega de equipe a partir do mesmo terminal em que o Claude Code roda.

O que "projetos do Claude Code" realmente significa

Eu construo integrações e APIs para viver, então passo boa parte do meu dia dentro do Claude Code, e a expressão "projetos do Claude Code" confunde as pessoas porque aponta para duas coisas diferentes.

A primeira é a funcionalidade Projects literal, com quatro dias de existência. A Anthropic descreve isso sem rodeios: "Agrupe sessões de codificação relacionadas para poder executar e supervisionar facilmente vários agentes Claude ao mesmo tempo." Ela foi lançada no aplicativo desktop do Claude Code em 17 de setembro de 2026, e existe porque usuários avançados já estavam executando vários agentes em paralelo e precisavam de um lugar para mantê-los organizados.

A segunda é o sentido do dia a dia: um projeto é simplesmente um repositório dentro do qual você abre o Claude Code. Você usa cd para entrar na sua base de código, executa claude, e ele lê o projeto, entende as dependências entre os arquivos e começa a trabalhar. A maior parte deste guia trata desse segundo sentido, porque acertar nisso é o que faz a nova funcionalidade brilhante valer a pena.

Vale a pena colocar isso em escala, porque muda o quão a sério você deve levar a configuração. O anúncio da Série G da Anthropic (12 de fevereiro de 2026) apontou a receita anualizada do Claude Code em "mais de 2,5 bilhões de dólares", disse que os usuários ativos semanais tinham dobrado desde o início do ano, e citou uma estimativa de que 4% de todos os commits públicos do GitHub eram escritos pelo Claude Code. Isso não é um brinquedo. É uma ferramenta que grandes organizações de engenharia (Netflix, Spotify, KPMG e Salesforce estão entre os usuários citados) rodam contra repositórios em produção todos os dias.

Como o Claude Code funciona dentro de um projeto

O modelo mental que mais me ajudou: o Claude Code não é autocompletar, é um loop. Você descreve um resultado, e o agente lê, planeja, edita, testa e reporta de volta, repetidamente, até a tarefa estar concluída ou ele precisar de você.

Na prática, isso se parece com pedir para ele "adicionar testes para este arquivo" e observar ele abrir o arquivo, lê-lo, escrever um novo arquivo de teste e pausar para o seu aval antes de tocar em qualquer coisa. A distinção entre agêntico e copiloto traçada pelo desenvolvedor Santiago Valdarrama é a moldura mais clara que já vi:

"Mode 1: AI writes the code, and the human copilots. Mode 2: The human writes the code, and AI copilots. These two are very different. One doesn't replace the other. Professional developers use both."

Santiago Valdarrama, X

Essa pausa importa. Por padrão, o Claude Code pergunta antes de editar um arquivo ou executar um comando, e você pode aprovar uma vez, aprovar e parar de perguntar, ou redirecioná-lo. Desde a atualização de 7 de agosto de 2026, ele roda em "modo automático" por padrão nos planos Pro, Max e Team, o que permite trabalhar por mais tempo sem deixar de capturar comandos arriscados. O ponto é que você permanece no controle do loop, você não está entregando as chaves e torcendo.

A camada de configuração do projeto que o torna repetível

Eis o que a maioria das pessoas perde de vista, e é o principal indicador de se o Claude Code parece mágico ou bagunçado: uma sessão crua só é tão boa quanto o contexto que você dá a ela. A camada de configuração é o que transforma um acaso isolado em um projeto repetível.

A peça central é o CLAUDE.md, um arquivo markdown na raiz do seu projeto que o Claude Code lê no início de cada sessão. Ele contém seus padrões de código, decisões de arquitetura, bibliotecas preferidas e as zonas intocáveis que você nunca quer que o agente refatore. O Claude Code também lê um AGENTS.md se você já mantém um para outros agentes, e constrói sua própria memória automática entre as sessões. Um usuário avançado do Reddit resumiu bem essa disciplina:

"I maintain a CLAUDE.md file which i update after each session. I periodically use /compact to keep the context window smaller. I start a new session for a new feature."

u/FederalDimension6022, r/ClaudeCode

Além disso, há mais quatro camadas:

• Subagentes: assistentes especializados, cada um com sua própria janela de contexto, ferramentas e permissões. Os integrados, como Explore (busca rápida e somente leitura) e Plan, cuidam do trabalho pesado, e você pode direcionar subagentes personalizados para um modelo mais barato, como o Haiku, para manter os custos baixos.
• Servidores MCP: o padrão aberto para conectar o Claude Code a sistemas externos, para que ele possa ler um chamado do Jira, puxar contexto do Slack ou consultar um banco de dados no meio da tarefa.
• Skills: fluxos de trabalho empacotados e compartilháveis que sua equipe invoca como comandos de barra, tipo /review-pr ou /deploy-staging.
• Hooks: comandos de shell que disparam antes ou depois de uma ação, para formatação automática após cada edição ou para bloquear um commit que falhe no lint.

Uma publicação viral no X de Suryansh (4,5 mil curtidas, 1,5 milhão de visualizações) capturou por que essa camada é o verdadeiro desbloqueio:

"Most people are using Claude Code completely vanilla… which is why their experience feels messy. The real power comes from the ecosystem around it."

Suryansh, X

Se há uma reclamação real a apontar, é o esforço de configuração. Os tópicos "assim é o meu fluxo de trabalho" mais votados admitem abertamente que levaram de duas a três semanas para ajustar, e que "não é nada amigável para iniciantes". Essa é uma troca justa por uma base de código na qual você vive diariamente, mas é um custo real, e vale a pena conhecê-lo antes de começar.

Rodando projetos do Claude Code além do terminal

O Claude Code começou como uma CLI, mas agora um projeto pode acompanhar você em várias superfícies, e todas compartilham o mesmo motor, então o seu CLAUDE.md, suas configurações e seus servidores MCP funcionam em qualquer lugar.

As superfícies que vale a pena conhecer:

• CLI de terminal: a original, ainda a mais completa em funcionalidades, e combinável com pipes do Unix (git diff | claude -p "review this").
• Extensões de IDE: os plugins de VS Code e JetBrains adicionam diffs inline, menções com @ e revisão de planos.
• Aplicativo desktop: reúne o Claude Code sem instalação separada, e é onde vive a nova funcionalidade Projects.
• Claude Code na web: roda no navegador em claude.ai/code contra repositórios que você não tem localmente, além de iOS e Android.
• Routines: tarefas agendadas que rodam na nuvem e continuam funcionando quando seu computador está desligado, e podem ser disparadas por um evento do GitHub.

Nessa última categoria é onde "projetos" deixa de significar "uma pasta na qual eu me sento" e passa a significar "trabalho que roda esteja eu presente ou não". Também é a ponte para o ponto ao qual eu sempre volto: assim que seu agente começa a se agendar sozinho e chamar outros sistemas, a pergunta passa a ser com quais outros sistemas ele deveria estar conversando.

Quanto custa rodar um projeto com o Claude Code

A boa notícia sobre o preço é que o Claude Code está incluído em todos os planos pagos da Claude, não é vendido separadamente. Seu trabalho no terminal e suas conversas consomem do mesmo pool de uso, que se reinicia em uma janela móvel de cinco horas, com limites semanais por cima. Aqui está a lista de planos atual da página de preços da Claude:

Se você precisar ir além dos limites do seu plano, pode migrar para créditos de API pré-pago (pay-as-you-go) por meio de uma conta Console, cobrados nas tarifas padrão do modelo:

A única coisa a se planejar são os limites, não o preço. A reclamação recorrente mais ouvida no Reddit é que o plano Pro de 20 dólares sufoca rápido sob uso intenso. O conselho consistente de quem faz desenvolvimento em tempo integral: reserve orçamento para o Max se o Claude Code estiver fazendo o trabalho pesado, e use modelos de subagentes mais baratos para as passagens de rotina.

O que as pessoas realmente constroem com projetos do Claude Code

Uma vez que a configuração está ajustada, a variedade de projetos é ampla. Pelo que vejo na comunidade e uso eu mesmo, os padrões se agrupam assim:

A visão mais honesta sobre essa troca veio de um profissional no LinkedIn que tinha entregado funcionalidades 5 vezes mais rápido e depois encontrou a pegadinha:

"Claude had created 5 nearly identical methods instead of refactoring into reusable functions. The AI optimizes for 'make it work' not 'make it maintainable.'… What's working: Treating AI as a junior developer who needs review."

John Keaney, LinkedIn

Esse enquadramento, um júnior rápido que precisa de revisão, é o que eu tatuaria no monitor de um novo usuário. Um desenvolvedor com uma década de experiência levou o mesmo ponto ainda mais a fundo: "Claude Code isn't a shortcut. It's a multiplier, but only if you bring the fundamentals to the table."

Onde um agente de código termina e um colega de equipe começa

Eis o reenquadramento que muda como você deveria pensar sobre tudo isso. O Claude Code é surpreendentemente bom em projetos de software. Mas muitos dos "projetos" que as pessoas realmente querem automatizar não são software algum: responder chamados de suporte, escrever posts de blog, manter uma base de conhecimento atualizada. E, para isso, um agente de código é a ferramenta errada.

Pense nisso como infraestrutura versus funcionário. O Claude Code é infraestrutura que você opera: você o comanda, ele escreve código e executa comandos, e abre pull requests para sua revisão. A eesel é a outra metade: uma plataforma onde você contrata colegas de equipe de IA prontos para trabalhar em funções específicas. O elenco atual é um colega de equipe de IA para helpdesk que entra na sua fila de suporte e um redator de blog com IA que pesquisa e escreve posts longos. Cada um chega já com as habilidades, integrações e contexto da empresa para sua função, e entra em operação em minutos em vez de precisar de duas a três semanas de configuração.

O que torna isso concreto para um usuário do Claude Code é que a eesel não é um painel fechado. Ela oferece uma superfície programável de verdade, então a mesma pessoa, script ou agente de código que comanda o Claude Code também pode comandar um colega de equipe da eesel. O @eesel/cli é um binário npm cuja documentação diz literalmente que "tudo neste site pode ser feito a partir do terminal". Alguns comandos que vale a pena conhecer:

• eesel integrations connect <platform> conecta o colega de equipe ao seu helpdesk Zendesk, Freshdesk ou Gorgias.
• eesel instructions lê e edita as regras fixas que moldam suas respostas, o equivalente em suporte de um CLAUDE.md.
• eesel activity lista as execuções da mais recente para a mais antiga, para você inspecionar exatamente o que o colega de equipe fez, e eesel approvals mantém uma pessoa no controle.
• Todo comando imprime JSON, e --dry-run mostra a chamada exata ao servidor que uma escrita faria antes de enviá-la, o que torna seguro automatizar por script.

Também há um servidor MCP para cada workspace, então você pode rodar npx @eesel/cli mcp token, colar o comando claude mcp add impresso, e deixar o Claude Code operar seu colega de equipe de suporte como um conjunto de ferramentas no meio da sessão. Um engenheiro sênior descreveu exatamente essa mudança rumo a fazer tudo pelo terminal:

"I'm spending significantly less time in my IDE and web browser. I'm doing most things, including accessing other systems using MCP, all from Terminal."

Jesse Altman, LinkedIn

A ressalva honesta, para eu não estar vendendo demais: a eesel não publica um produto de API REST pública documentado separadamente. A superfície programável é a CLI, o servidor MCP, webhooks e acesso à rede, o que já é suficiente para comandar um colega de equipe a partir de um agente, mas melhor dizer assim do que imaginar uma API CRUD completa.

Experimente a eesel

Se o projeto que você realmente quer automatizar é suporte ao cliente ou conteúdo em vez de entrega de código, esse é exatamente o trabalho para o qual a eesel foi construída. O colega de equipe de IA para helpdesk treina com seus chamados passados, sua central de ajuda e sua documentação, entra no helpdesk que você já usa, e pode ser simulado contra seus chamados históricos antes de responder a um cliente de verdade. A diretora de inovação da Global Pay relatou "até 80% de economia de tempo" depois de implementá-lo.

O melhor para o público do Claude Code: você pode operar esse colega de equipe inteiro a partir do terminal em que você já vive. Comece grátis com 50 $ de uso e sem cartão de crédito, e depois são 40 centavos fixos por chamado ou chat resolvido, sem taxas por assento. Experimente a eesel e veja como é um colega de equipe pronto para trabalhar ao lado de um agente de código que você precisa comandar.