00:00:00O Claude Code tem tantos recursos a esta altura que é genuinamente difícil de acompanhar.
00:00:04Mesmo com tudo visível no menu de comandos, há muita coisa que não é imediatamente
00:00:08aparente.
00:00:09A maioria dos problemas que você encontra ao usar o Claude Code já tem correções integradas.
00:00:13Elas existem.
00:00:14Estão apenas enterradas em arquivos de configuração e variáveis de ambiente de que quase ninguém fala.
00:00:18Nós analisamos tudo e montamos uma lista de configurações ocultas e sinalizadores que você deve
00:00:22ativar agora mesmo.
00:00:23Para os problemas que o Claude não tem uma correção integrada, também encontramos algumas soluções
00:00:27sólidas de código aberto.
00:00:28Se você já executou o comando de insights ou usou o Claude com a flag resume, deve ter
00:00:32notado que todas as conversas exibidas são limitadas a apenas um mês, mesmo
00:00:37que você esteja usando o Claude há muito mais tempo.
00:00:39E se você realmente precisar voltar a essas sessões ou quiser uma análise de insights por um
00:00:42período mais longo, agora que o Opus 4.6 suporta uma janela de contexto de 1 milhão de tokens, você não
00:00:48conseguirá fazer isso porque o Claude Code não as armazena no sistema por mais de um
00:00:52mês.
00:00:53Esse período de um mês é o intervalo padrão definido nas configurações do Claude para retenção de dados,
00:00:57mas isso não significa que você não possa modificar essas configurações para reter dados por mais tempo.
00:01:01O Claude realmente tem uma configuração para isso.
00:01:02Na pasta principal .claude, existe um arquivo settings.json.
00:01:06Usaremos este arquivo para muitas outras configurações ao longo do vídeo também.
00:01:09É assim que você altera muitas das configurações padrão no Claude Code.
00:01:12Você pode adicionar este campo "cleanupPeriodDays" com qualquer número de dias que desejar.
00:01:16Se você definir como 365, ele poderá reter um ano inteiro de conversas.
00:01:22E ao definir como zero, você está pedindo para não armazenar nenhuma de suas conversas, o que significa
00:01:26que não poderá extrair nenhuma informação ou visualizar referências passadas.
00:01:30Outra coisa que você pode fazer é, dentro da pasta .claude do seu projeto, configurar regras
00:01:35específicas de caminho.
00:01:36Elas são carregadas no contexto quando o agente tenta modificar um arquivo específico.
00:01:40Essas regras são acionadas em operações de leitura e carregadas quando o padrão do caminho corresponde
00:01:44ao arquivo que está sendo lido.
00:01:45Elas contêm todas as instruções que precisam ser seguidas ao trabalhar com aquele arquivo.
00:01:49Normalmente, é isso que as pessoas adicionam no arquivo main.claude.md.
00:01:52Elas jogam todas as instruções relacionadas a diferentes aspectos do app em um só lugar.
00:01:57Embora não precisemos nos preocupar com o contexto agora, isso ainda ajuda na separação de preocupações
00:02:01quando seu app fica muito grande.
00:02:03Colocar tudo em um só lugar às vezes faz o Claude ignorar instruções que você escreveu porque
00:02:07o arquivo se tornou tão grande e cheio de instruções que o Claude não sabe em quais realmente
00:02:11focar.
00:02:12Por exemplo, se ele estiver trabalhando no front-end, só precisa carregar as instruções dos
00:02:17componentes React, não todas ao mesmo tempo.
00:02:19Isso mantém o agente mais focado.
00:02:21Como você já sabe, o Claude Code pode executar comandos bash e ler suas saídas.
00:02:25Mas, dependendo do comando, essas saídas podem ser massivas.
00:02:28A Anthropic definiu um limite de quantos caracteres o Claude pode ler da saída de qualquer
00:02:33comando, e esse limite é de 30.000 caracteres.
00:02:35Qualquer coisa além disso é truncada, e o Claude nunca vê.
00:02:38Então, por exemplo, se você rodar sua suíte de testes e ela imprimir milhares de linhas de resultados,
00:02:42o Claude só lerá os 30.000 caracteres definidos dessa saída.
00:02:46A mesma coisa se você estiver olhando logs de build ou executando migrações de banco de dados.
00:02:50Qualquer comando que despeje muito no terminal, o Claude recebe apenas os 30.000 caracteres.
00:02:54Para corrigir isso, no seu settings.json, há novamente uma configuração que controla quantos caracteres
00:02:59o Claude Code carrega do terminal para sua janela de contexto.
00:03:03Isso foi definido em 30k devido aos modelos antigos com janela de contexto de 200k, onde você não podia
00:03:08se dar ao luxo de carregar mais.
00:03:09Mas, novamente, com a nova janela de 1 milhão de tokens, isso não é mais um problema.
00:03:13Você pode aumentar isso para algo como 150.000 para que a saída completa seja carregada
00:03:18e o Claude possa ler tudo corretamente.
00:03:20Se você estiver trabalhando em um projeto que contém muitos subagentes, cada um adaptado para
00:03:24trabalhar em suas respectivas tarefas, se tivermos uma tarefa específica para qualquer agente, normalmente
00:03:29pedimos explicitamente ao Claude em nosso prompt para usar esse agente na tarefa.
00:03:33Mas se você quiser entregar rapidamente o trabalho a um agente específico, o que pode fazer é rodar o Claude
00:03:37como um subagente.
00:03:38Você só precisa usar a flag agent e digitar o nome do subagente que deseja executar
00:03:42o Claude como tal.
00:03:43Agora você pode delegar tarefas a ele diretamente e usar suas capacidades e ferramentas sem o
00:03:47atraso de o Claude primeiro carregar aquele subagente para depois realizar a tarefa.
00:03:51Como você já deve saber, você pode definir o modelo e a configuração das ferramentas MCP ao configurar
00:03:57subagentes, mas há muitas outras configurações que você pode adicionar a um subagente.
00:04:00Por exemplo, subagentes não herdam habilidades por padrão, mas se você usar a flag skill,
00:04:04pode fazer com que esse agente herde uma habilidade que você criou para aquele subagente específico.
00:04:08Isso significa que ele pode realmente usar essa habilidade para realizar suas tarefas.
00:04:11Além das habilidades, há outro sinalizador chamado effort (esforço).
00:04:14Caso não saiba, o esforço determina quanto token e poder de processamento o agente usa
00:04:18ao realizar tarefas.
00:04:19Alguns agentes por padrão não precisam de muito esforço, então você altera conforme a tarefa.
00:04:23Além do esforço, você também pode configurar hooks dentro do subagente que são específicos
00:04:28para o fluxo de trabalho daquele agente.
00:04:29Você também pode definir se um agente deve sempre rodar em segundo plano usando a flag
00:04:33background.
00:04:34Defina como true se quiser que o agente trabalhe completamente em segundo plano sem interromper
00:04:38o agente principal, ou false se quiser que o agente sempre apareça no topo.
00:04:42Você também pode fazer subagentes rodarem isolados em uma árvore de trabalho separada definindo a
00:04:47configuração isolation na descrição do agente.
00:04:49Agentes isolados recebem uma cópia temporária da árvore de trabalho, dando-lhes espaço para fazer mudanças
00:04:53significativas sem arriscar a base de código principal.
00:04:55Se o agente não fizer alterações, a árvore de trabalho é limpa automaticamente.
00:04:59Se houver alterações, o caminho da árvore e a branch são retornados para mesclagem e revisão.
00:05:03Essa configuração é ideal para experimentar abordagens que possam quebrar o código principal.
00:05:08Por fim, você pode controlar quais agentes um determinado agente tem permissão para gerar adicionando os
00:05:12nomes dos agentes permitidos na seção de ferramentas da configuração desse agente.
00:05:16Isso restringe a criação para que múltiplos agentes não sejam criados desnecessariamente, evitando
00:05:20que um único agente saia do controle e continue criando muitos outros.
00:05:24Por padrão, quando o Claude lê um arquivo, ele lê apenas 25k tokens.
00:05:28Mas desde que a janela de contexto aumentou para 1 milhão de tokens, 25k é na verdade muito pouco
00:05:34e não permite que o Claude utilize todo o seu potencial.
00:05:36Você pode mudar isso no settings.json definindo esta flag para 100k ou mais.
00:05:41Mas há um outro detalhe.
00:05:42Não importa o tamanho da janela de contexto, o Claude só lê 2000 linhas, e ele nem
00:05:47sabe que perdeu as outras linhas, então nunca volta para ler o resto.
00:05:51A Anthropic não permite que você altere este limite.
00:05:53Mas existe uma alternativa.
00:05:54Você pode adicionar uma instrução no arquivo claude.md para que, sempre que o Claude ler arquivos grandes,
00:05:59ele primeiro verifique a contagem de linhas.
00:06:01Se o arquivo exceder 2000 linhas, ele usa parâmetros de offset e limit para ler o arquivo inteiro
00:06:06corretamente, sem perder nada no meio.
00:06:08Também podemos configurar um hook que é acionado sempre que o comando de leitura é executado.
00:06:12Este hook verifica a contagem de linhas do arquivo e, se exceder 2000 linhas, força o agente
00:06:16a seguir a instrução em claude.md, usando comandos como HEAD para garantir que o Claude leia
00:06:21até o fim.
00:06:22Como você já sabe, o Claude Code aciona automaticamente o compact quando a janela de contexto atinge
00:06:2795%.
00:06:28Mesmo com a janela de 1 milhão de tokens, o agente não precisa esperar até
00:06:32que a janela de contexto esteja 95% cheia.
00:06:35A qualidade da saída geralmente começa a degradar quando a janela de contexto atinge 70%.
00:06:40Este é o momento certo para acionar a compactação automática, a menos que você precise de todo o milhão
00:06:44de contexto.
00:06:45Para mudar isso, basta adicionar uma flag de configuração no settings.json e definir o override
00:06:50de porcentagem do auto-compact para o valor que preferir.
00:06:53Nós definimos o nosso em 75%.
00:06:55Com isso configurado, quando sua janela de contexto atingir 75%, ela será compactada automaticamente,
00:07:00mantendo a qualidade da saída do agente.
00:07:02Mas antes de passarmos para os próximos recursos, uma palavra do nosso patrocinador, Make.com.
00:07:06Todos sabemos que o maior risco com a IA é a caixa preta.
00:07:09Você implanta agentes, mas não consegue verificar suas decisões.
00:07:12Os novos agentes do Make mudam isso completamente.
00:07:14Sua plataforma visual combina no-code e IA para implantar agentes que gerenciam o seu negócio.
00:07:19Você pode construir agentes inteligentes diretamente dentro da tela visual deles.
00:07:22Basta dar uma meta ao seu agente e, com mais de 3000 integrações nativas de apps, ele cuida da
00:07:27tomada de decisão complexa para você.
00:07:29Além dos agentes, a plataforma está repleta de recursos.
00:07:31Você tem templates prontos para começar rápido, MCP para conexões seguras e o recurso de
00:07:36knowledge para fundamentar as respostas.
00:07:38O painel de raciocínio permite que você veja, controle e confie em cada passo que a IA dá.
00:07:42Além disso, com o Make grid, seu monitoramento e insights ficam em um mapa centralizado.
00:07:46Pare de fazer trabalho manual repetitivo e crie fluxos eficientes que economizam tempo e simplificam a escala.
00:07:52Clique no link no comentário fixado para garantir seu plano Pro exclusivo de 1 mês grátis e experimente
00:07:56o Make hoje.
00:07:57Agora, a maioria de vocês deve saber que o Agent Teams ainda é experimental, por isso
00:08:01muitas pessoas não conhecem.
00:08:03No Agent Teams, há um líder de equipe e múltiplos membros, cada um sendo sua própria
00:08:07sessão do Claude, iniciada e controlada pelo líder da equipe.
00:08:10O líder da equipe é responsável por coordenar toda a tarefa entre todos os membros.
00:08:15Isso é diferente dos subagentes, porque os subagentes não conseguem se comunicar
00:08:19entre si.
00:08:20Enquanto em uma equipe de agentes, cada membro da equipe pode se comunicar com os outros e
00:08:24compartilhar informações.
00:08:25Fizemos um vídeo completo sobre isso, onde falamos dos recursos e de como
00:08:29usá-lo da melhor forma para aproveitar ao máximo suas capacidades.
00:08:32Além disso, se estiver gostando do nosso conteúdo, considere clicar no botão de hype, pois nos ajuda
00:08:36a criar mais conteúdos assim e alcançar mais pessoas.
00:08:40Se você gerencia múltiplas configurações para diferentes tipos de trabalho, existe uma ferramenta
00:08:44de código aberto chamada Claude CTX que permite alternar rapidamente entre perfis configurados,
00:08:49gerenciar configurações de clientes separadamente e lidar com permissões e ferramentas em diferentes
00:08:54provedores de espaço.
00:08:55Para instalá-la, os comandos estão listados para todos os sistemas operacionais.
00:08:58No Mac, você pode usar o comando brew install e, em outros sistemas, pode instalar
00:09:02clonando o repositório.
00:09:03A ferramenta gerencia seu settings.json, claude.md, servidores mcp e backups rastreando
00:09:08perfis através de uma pasta profiles dentro da pasta principal .claude.
00:09:12Esta pasta de perfis contém uma subpasta para cada perfil, com seu próprio settings.json e
00:09:17claude.md, cada um otimizado para aquele perfil específico.
00:09:21Cada arquivo de configuração contém apenas as permissões necessárias para aquele perfil, evitando conflitos
00:09:26entre eles.
00:09:27Alternar perfis é simples.
00:09:29Você pode verificar seu perfil atual usando esta flag C e, para trocar, executa claude ctx seguido
00:09:34pelo nome do perfil desejado.
00:09:35Quando você troca, ele cria um backup do estado de trabalho atual e o salva na pasta
00:09:39de backup para que você sempre tenha um registro do perfil anterior.
00:09:42Assim você mantém múltiplos perfis completamente separados e o Claude trabalha com exatamente as
00:09:47permissões de que precisa sem se preocupar com misturas indesejadas.
00:09:50Recursos de todos os nossos vídeos anteriores estão disponíveis no AI Labs Pro.
00:09:54Templates, habilidades e várias outras coisas que você pode plugar direto nos seus projetos.
00:09:58Se você encontrou valor no que fazemos e quer apoiar o canal, esta é a melhor maneira
00:10:02de fazer isso.
00:10:03O link está na descrição.
00:10:04Se você se irrita quando o Claude se coloca como coautor em commits do GitHub, há uma solução
00:10:09para isso também.
00:10:10No seu settings.json, adicione a chave "attribution" e deixe os campos de commit e PR vazios.
00:10:15Depois disso, sempre que pedir para o Claude fazer um push para o GitHub, ele não se incluirá como coautor.
00:10:18Você também pode definir uma string personalizada para que o commit mostre o nome de autor que você escolher.
00:10:23Por padrão, o Claude Code se adiciona como coautor a cada commit, o que significa que ele aparece
00:10:28no gráfico de contribuidores do seu repositório.
00:10:30O Claude Code também envia dados analíticos para a Statsig, onde rastreia padrões de uso e dados
00:10:35operacionais como latência e confiabilidade.
00:10:37Esses dados são usados para testes A/B de recursos e análises estatísticas.
00:10:41Ele também envia dados para o Sentry para log de erros, permitindo que a Anthropic diagnostique travamentos e
00:10:45bugs em produção.
00:10:47Mas se quiser desativar isso, você pode adicionar três variáveis ao settings.json principal.
00:10:52Elas desativam telemetria, relatórios de erros e exibição de feedback.
00:10:55Com isso em vigor, o Claude Code não enviará mais seus dados, mantendo tudo privado.
00:10:59Mas também há uma flag de CLI separada no Claude Code para desativar tráfego não essencial, o que
00:11:04pode parecer que faz a mesma coisa.
00:11:06A diferença é que essa flag também bloqueia atualizações automáticas, o que você provavelmente não quer.
00:11:11Portanto, é melhor confiar nas três configurações, pois elas dão o mesmo benefício de privacidade
00:11:15sem cortar as atualizações.
00:11:17Muita gente também não conhece o "prompt stashing" (armazenamento de prompts) no Claude Code.
00:11:20Se você estiver digitando um prompt e perceber que precisa enviar outra tarefa primeiro,
00:11:24pode pressionar Ctrl + S para guardar seu prompt atual.
00:11:28Depois disso, você pode digitar e enviar o novo prompt, e o anterior guardado
00:11:31volta automaticamente para a caixa de entrada.
00:11:33Muitos de vocês já devem estar usando hooks, mas também podem usar códigos de saída dentro dos
00:11:37hooks que dizem ao Claude se a execução deve prosseguir, ser bloqueada ou ignorada.
00:11:41Existem três tipos principais de códigos de saída.
00:11:44O código de saída 0 significa que a execução foi bem-sucedida e indica que a tarefa atribuída foi
00:11:48concluída corretamente.
00:11:49Na maioria das vezes, suas saídas não são inseridas no contexto e servem apenas como um indicador
00:11:54de que tudo foi feito corretamente.
00:11:55Qualquer outro código de saída, exceto 0 e 2, é mostrado no modo detalhado e não é bloqueante,
00:12:01o que significa que são mensagens de erro, mas o Claude não as considera graves o suficiente para parar
00:12:05seu fluxo de trabalho.
00:12:06Mas o mais importante é o código de saída 2, que tem um impacto significativo em nossos fluxos.
00:12:10Quando usamos o código 2 com qualquer ferramenta, a mensagem de erro é enviada de volta ao Claude,
00:12:15e ele é forçado a agir sobre essa mensagem de erro.
00:12:17Por exemplo, muitas vezes você quer usar uma certa biblioteca, mas o Claude usa
00:12:21outra devido aos seus padrões de treinamento.
00:12:24Para evitar isso, você pode configurar um hook para isso e fazê-lo rodar antes de cada comando bash.
00:12:28Ele verifica se o comando que o Claude vai usar corresponde à biblioteca que você não quer,
00:12:33no meu caso era o pip, então ele imprime uma mensagem dizendo para não usar o pip e o direciona
00:12:37a usar o uvicorn, saindo com o código 2.
00:12:41Com isso ativado, sempre que o Claude tentar instalar via pip, ele será forçado a instalar
00:12:45pelo uvicorn no lugar.
00:12:46Esses hooks com códigos de saída formam a base dos ralfloops, que você deve lembrar que
00:12:50estavam ganhando muita tração há pouco tempo.
00:12:52Também fizemos um vídeo detalhado sobre eles, que você pode conferir em nosso canal.
00:12:56Eles usam o mesmo mecanismo de códigos de saída e hooks para forçar o Claude a continuar iterando até
00:13:01que os critérios para um resultado completo sejam atingidos.
00:13:03Isso garante que o Claude não relaxe e marque tarefas incompletas como concluídas.
00:13:08Esses hooks podem ajudar na criação de múltiplos fluxos de trabalho semelhantes.
00:13:11Isso nos traz ao final deste vídeo.
00:13:13Se quiser apoiar o canal e nos ajudar a continuar fazendo vídeos como este, você pode
00:13:17fazer isso usando o botão "Valeu demais" abaixo.
00:13:19Como sempre, obrigado por assistir e vejo você no próximo.