🧭 Tour Guiado da Interface

Project agrupa chats que compartilham 200K de contexto, custom instructions e knowledge files. Disponível em Pro, Max, Team e Enterprise.

Quem trata project como pasta perde o ganho. Quem entende que é sandbox de contexto começa a desenhar fluxo de trabalho ao invés de conversa avulsa.

Contexto persistente · ~500 páginas · Custom instructions · Knowledge files compartilhados.

"Raio de impacto" = tudo que aquele project enxerga e influencia. Um chat fora do project não vê instructions nem files. Dois projects nunca se cruzam.

Mistura de escopos é causa #1 de "Claude inventou coisa que não tem". Mantendo raios disjuntos, a memória do projeto fica limpa.

Isolamento · 1 projeto = 1 escopo · Cross-talk zero · Higiene de contexto.

Critério: mudou o domínio, mudou o cliente, mudou o "personagem" — novo project. Mesma tarefa em série — mesmo project.

Acumular tudo num project só estoura contexto. Quebrar demais perde sinergia. O critério "personagem" resolve.

Trigger de novo project · Cliente novo · Domínio novo · Reset de tom.

Arquivos colados no project ficam disponíveis em toda conversa. Limite por arquivo: 30 MB. Número ilimitado (até a janela de contexto).

É o jeito mais barato de dar contexto persistente — PDFs < 100 páginas têm análise visual+texto, > 1000 só texto.

30 MB cap · Persistente · Imagens (PNG/JPG/GIF/WebP) · PDF visual até 100 pgs.

Custom instructions = system prompt do projeto. Injetadas em toda conversa daquele project. Defina tom, persona, restrições.

Repetir "responda formal em PT-BR" em cada chat queima energia. Instructions resolve isso uma vez só.

Sem limite duro de caracteres · Persona · Restrição · Idioma.

Regra mental: cada project só responde a um escopo. "Cliente X — Vendas", "Pessoal — Estudo", "Empresa — Operações".

Acaba o "vou criar mais um chat sobre isso" desorganizado. Vira biblioteca navegável.

Nomenclatura clara · Cliente — Tema · 5-10 projects ativos · Arquivar inativos.

Adaptive thinking (Opus 4.6+, Sonnet 4.6+) = Claude decide quando e quanto pensar. API: thinking: {type: "adaptive"}. Extended thinking continua disponível mas é legado.

Anthropic recomenda migrar. Adaptive supera extended de forma consistente em avaliações internas.

Adaptive vs Extended · Decisão dinâmica · API param · Effort separado.

low = minimiza pensamento. medium = moderado. high = padrão. xhigh = exploração profunda estendida (só Opus 4.7). max = sempre pensa, sem limite.

Effort é o controle principal de tradeoff inteligência × velocidade × custo no Opus 4.7.

5 níveis · Tradeoff · Velocidade vs profundidade · Custo de thinking tokens.

xhigh só existe no Opus 4.7 — exploração profunda estendida. Sonnet/Haiku não têm.

Pra problemas onde você prefere esperar 90s e receber a resposta certa, ao invés de 5s e iterar 4 vezes.

Diferenciação de modelo · Quando vale o custo · Análise densa · Reasoning longo.

Use high/xhigh em: design de arquitetura, debug de bug que você já tentou 3x, análise jurídica, código longo.

Saber escolher economiza tempo e dinheiro. Low pra resumo, max pra problema cabeludo.

Heurística de uso · Tarefa simples = low · Tarefa densa = high/xhigh.

Thinking tokens são cobrados como output tokens. xhigh pode gerar milhares de tokens "pensando" antes de responder.

Em batch grande, abusar de xhigh estoura orçamento. Calibre por tipo de tarefa.

Tokens cobrados · Output rate · Batch caro · Default em high é equilibrado.

Nas UIs (claude.ai e Claude Code), o "chain of thought" é exibido em bloco recolhível antes da resposta.

Auditar o raciocínio é onde o ouro mora — você descobre por que ele errou, e ajusta o prompt.

CoT visível · Debug de prompt · Aprender com o erro do modelo.

Flag do Claude Code que desliga TODOS os prompts de permissão. Claude executa Bash, Write, Edit sem perguntar.

É o nome real do "YOLO mode". Sem proteções nenhuma. Risco: comando destrutivo em prod.

Flag CLI · Zero guardrail · Inseguro por padrão · Use só em sandbox.

Alternativa segura ao --dangerously. Classifiers de ML analisam cada ação. 93% dos prompts que humanos aprovariam viram automáticos.

É o caminho recomendado pra produtividade sem expor o pé.

Classifier ML · 93% automatizados · Backstop · Multi-agent handoff guarda.

rm -rf indevido, commit em main, push de secret, deploy errado, alteração em DB de prod.

Quem nunca pagou o preço subestima. Listar os 5 desastres possíveis evita o sexto.

Comandos destrutivos · Repos com secrets · Prod · Backup como mitigação.

Container Docker descartável, VM efêmera, repo throwaway, devcontainer isolado. Onde "perder tudo" é OK.

Velocidade absoluta sem risco. Demo cinemática sai daí.

Docker · VM · Devcontainer · Throwaway repo.

Repo principal da empresa, máquina com SSH key, ambiente com kubectl apontado pra prod, qualquer máquina com .env.

A regra inegociável. Se a sala estiver em laptop corporativo, fala pra usar Auto Mode.

Prod · Secrets locais · kubectl perigoso · SSH key exposta.

Auto-accept (VS Code extension) aceita edits sem perguntar, mas mantém Bash sob prompt. YOLO desliga tudo.

Confundir os dois leva a relaxar onde não deveria.

VS Code initialPermissionMode · Edit ≠ Bash · Granularidade.

Instructions = tom, persona, domínio, restrições. O que vale em todo chat do projeto.

Quem coloca tarefa específica em instructions perde flexibilidade. Quem coloca persona ganha consistência.

Persistente · Tom · Domínio · Restrições.

3 blocos: Role (quem é), Style (como fala), Constraints (o que não faz). Cada bloco em até 5 linhas.

Estrutura clara facilita manutenção e debug do comportamento do modelo.

Role · Style · Constraints · Cada bloco curto.

Não coloque "redija o e-mail para Maria sobre o produto X" — isso é prompt de chat, não instruction.

Tarefa em instructions deixa o projeto travado em um único uso.

Separação tarefa/persona · Sem hardcode · Reutilizável.

Atualize quando o projeto incorpora um cliente novo, muda tom (formal→informal), ou ganha restrição (compliance).

Instructions estagnadas viram "dívida" e o modelo começa a divergir.

Manutenção periódica · Trigger de update · Versionar mudanças.

Mantenha cópia das instructions em arquivo .md no repo ou na knowledge do projeto.

UI da Anthropic não tem histórico. Sem cópia, você perde a versão anterior pra sempre.

Git para prompt · Histórico recuperável · Diff entre versões.

Em Team/Enterprise, projects podem ser compartilhados — instructions ficam visíveis pra todos do time.

Instructions de equipe são contrato. Erros viram bug de todo mundo.

Project compartilhado · Revisão por pares · Convenção do time.

Session-scoped: cron dentro de sessão Claude Code ativa. Routines: rodam em infra Anthropic, mesmo com PC desligado.

Escolha errada = tarefa "fantasma" que nunca dispara.

/loop · /schedule · CLAUDE_CODE_DISABLE_CRON · 7 dias --resume.

Cron vixie padrão. 0/7 = domingo. Não aceita L/W/?, sem aliases MON/JAN.

Usar sintaxe estendida silenciosamente quebra o cron sem aviso.

5 campos · DOM+DOW match qualquer um · Sem extensões.

Revisão matinal de PR, análise overnight de CI failures, auditoria semanal de deps, sync de docs pós-merge.

Casos certos = Routines. Casos errados → Zapier/n8n.

Trigger cron · API · GitHub event · Saída em PR/issue.

Session-scoped: dispara só quando Claude Code está ocioso, sem catch-up. Routines: roda independente.

Esperar catch-up no session-scoped é frustração garantida.

Sem catch-up · Ocioso só · Limpa em nova conversa.

Claude Routines: tarefa precisa de raciocínio. Zapier/n8n: tarefa é "se X então Y" determinístico.

Usar Claude pra mover dado entre planilhas é caro. Usar Zapier pra revisar PR é impossível.

Raciocínio vs determinismo · Custo por execução · Ferramenta certa.

Checklist: (1) Claude Code estava aberto e ocioso? (2) sintaxe cron correta? (3) CLAUDE_CODE_DISABLE_CRON setado? (4) ambiente é Routine ou local?

90% dos "meu cron não rodou" caem em um desses 4 itens.

Debug em ordem · Confirmar ambiente · Variável de env.

Painel separado ao lado do chat onde Claude gera conteúdo independente: código, documento, SVG, React, HTML/CSS/JS, diagrama.

É a feature que vira demo "wow" — artifact com preview ao vivo prende a sala.

Painel separado · Preview ao vivo · Tipos suportados · Mobile incluso.

Out/2025: artifacts ganharam suporte a MCP e storage persistente. App de artifact agora pode lembrar estado entre sessões.

Transformou artifact de demo descartável em mini-app real.

MCP em artifact · Storage persistente · Stateful · App real.

Artifact pode integrar chamada à API do Claude sem você gerenciar key — quem abre o artifact paga via sua conta Claude.

Mini-apps com IA distribuíveis por URL — sem deploy, sem backend.

API embarcada · Sem gerenciamento de key · Apps IA distribuíveis.

Artifact publicado vira link público. Recebedor abre sem login, vê o app rodando.

Mata o passo "preciso fazer deploy" pra apresentar uma ideia.

Link público · Sem deploy · Prova de conceito instantânea.

Project = contexto persistente, instructions, knowledge. Artifact = produto entregável da conversa.

Não são alternativas — são complementares. Project gera artifact.

Context vs output · Complementares · Persistência diferente.

Artifacts não são substituto de deploy real — sem domínio próprio, autenticação avançada limitada, dependente da infra Anthropic.

Saber o limite evita vender o que não entrega.

Sem domínio próprio · Auth limitada · Dependência infra · POC, não produção.

Ferramenta do Claude Code pra delegar tarefa a um subagente. Aliases Task(...) ainda funcionam por compatibilidade.

Quem ouviu falar de "Task tool" e procura documentação não acha — agora é Agent.

Rename · Aliases legados · Agent é o nome novo.

Arquivo .md com YAML frontmatter: name, description, model, tools, disallowedTools. Conteúdo do arquivo é o system prompt do subagente.

Description bem escrita é o que faz Claude decidir delegar pro subagente certo.

Frontmatter YAML · Allowlist/denylist · Description é roteamento.

Subagent roda em contexto separado. Orchestrator recebe só o resumo do resultado, não o histórico.

Preserva o context window do principal. Tarefas exploratórias não poluem.

Isolamento de contexto · Resumo de retorno · Window protection.

Instrução em natural language: "research auth, db e API em paralelo". Claude spawna múltiplos subagentes simultâneos.

Acelera tarefas exploratórias de minutos para segundos.

Natural language fork · 3-N agentes simultâneos · Síntese final.

~/.claude/agent-memory/ (user) · .claude/agent-memory/ (project) · .claude/agent-memory-local/ (local). Recomendado: project como padrão.

Memória no escopo errado vaza segredo de projeto pra outro projeto.

3 escopos · Persistência por escopo · Project default.

Dispatch quando: tarefa é exploratória (Explore), envolve N arquivos a ler, ou pode rodar em paralelo. Faça direto quando é edição cirúrgica.

Dispatch demais vira overhead. Pouco demais estoura contexto.

Exploratório dispatch · Edição direto · Paralelo dispatch.

Skill = pasta contendo SKILL.md (frontmatter YAML com name e description) + scripts/recursos opcionais. Claude invoca automaticamente por relevância.

Unidade focada de conhecimento. Bem mais leve que plugin.

SKILL.md · Auto-invocação · Frontmatter · Disponível em Pro+.

Integrations (mai/2025): Atlassian, Zapier, Cloudflare, Intercom, Asana, Square, Sentry, PayPal, Linear, Plaid via MCP. OAuth por conector.

É como Claude alcança dados de SaaS sem você baixar e colar.

MCP remoto · OAuth · Diretório · Custom Connectors disponíveis.

Plugin (public beta no Claude Code) = bundle empacotando qualquer combinação de slash commands, subagentes, MCP servers e hooks.

Instalação single-command, ligável/desligável pra economizar contexto.

Bundle · /plugin · Ligar/desligar · agents/ recursivo.

Skill = workflow focado. Connector = ponte pra SaaS externo. Plugin = bundle de extensões do Claude Code.

Sala se perde quando você usa os três termos como sinônimos.

Vocabulário distinto · Granularidade · Escopo de cada um.

Skills: Settings > Features (admin habilita em Team/Enterprise). Connectors: Settings > Connectors. Plugins: /plugin no Claude Code.

Quem não sabe onde achar acha que "não está disponível".

3 lugares · Admin habilita · Gallery pública.

Skill oficial da Anthropic que guia interativamente: pergunta sobre o workflow, gera SKILL.md formatado e empacota.

É o jeito mais rápido de transformar um prompt repetido em skill reutilizável.

Interview-driven · Output pronto · Pacote distribuível.

Termo coloquial pro "subagente que serve de guia". Não há página oficial só dele — a doc canônica de subagentes é a referência.

Pra responder com precisão quando alguém pergunta "onde está a doc do Guide".

Termo coloquial · Não é uma URL · Doc canônica é sub-agents.

docs.anthropic.com/en/docs/claude-code/sub-agents — quickstart, AGENT.md completo, fork mode, exemplos prontos.

É o link que você sempre deve enviar quando perguntarem onde estudar.

URL canônica · Quickstart · Exemplos · Fork mode.

Subagents do Claude Code = CLI/IDE. Claude Agent SDK = biblioteca pra construir sistemas de agentes via API. Mesma filosofia, superfícies distintas.

Resposta certa pra dev que pergunta "uso Claude Code ou SDK".

CLI vs SDK · Mesma filosofia · Casos de uso diferentes.

Built-in (Explore, Plan, general-purpose) resolvem 80% — só crie custom quando o padrão clara não cabe.

Quem cria subagente cedo demais acaba com manutenção infinita.

Default first · Custom só quando justifica · Manutenção.

Webinar "Claude Code Advanced Patterns" e PDF em resources.anthropic.com mostram padrões avançados de subagentes, MCP e escala.

Material de referência pra fechar Q&A com link concreto.

Webinar · PDF advanced patterns · Building C compiler post.

Crie um AGENT.md "claude-code-guide" que carrega os links canônicos, AGENT.md template e padrões do seu time.

Subagente serve de "biblioteca viva" do time — onboarding fica trivial.

Internal guide · Onboarding · Padrões do time · Repo único.