Glossário (Acessível): Traduzindo os Jargões da Jornada para Termos Compreensíveis
📚 Navegação da Série: O artigo anterior 51 Solução de Problemas Comuns (FAQ / Troubleshooting) abordou as mensagens de erro e comportamentos inesperados mais recorrentes. Este artigo realiza uma tarefa fundamental — traduzir, um a um, os termos e jargões utilizados ao longo de todo o guia para uma linguagem compreensível. Loop de agente, janela de contexto, MCP, subagent, skill, hook, checkpoint, modo de permissão, headless, transport... Após mais de cinquenta artigos, acumulamos uma lista expressiva de conceitos. Use este texto como um guia de referência rápido: sempre que surgir uma dúvida sobre algum termo, retorne a esta página.
Dizem que "é preciso ler o glossário de cabo a rabo para criar uma base". Para ser honesto, essa é a forma menos produtiva de usá-lo.
Ao aprender uma nova ferramenta, memorizar o glossário de A a Z como se fosse um livro didático costuma ser um desperdício — você esquecerá logo em seguida, pois esses termos ainda não fizeram parte da sua rotina prática. Conceitos técnicos são melhor assimilados quando você se depara com eles na prática ou quando eles geram alguma dúvida no seu fluxo.
Portanto, o objetivo deste texto não é a leitura linear, mas sim a consulta. Isto é uma tabela de referência rápida, não um artigo didático. Siga seu aprendizado normalmente; no dia em que se deparar com dúvidas como "o que significa transport?" ou "o que é auto-compact?", retorne a esta página, localize o termo, leia a definição resumida acompanhada de uma analogia e continue seu trabalho — esta é la melhor forma de aproveitar este recurso.
Analogia: a lista de materiais fixada na parede de uma obra. Ninguém na obra perderá tempo decorando a lista inteira, mas quando os canos e conexões chegam, o mestre de obras consulta o papel — "entendi, esta é a viga de suporte, aquela é a junta de encanamento", e segue o serviço. Esta tabela funciona da mesma forma: não serve para leitura contínua, mas para consulta sob demanda. Agrupamos os conceitos por categorias temáticas (já que ideias correlacionadas são mais simples de associar do que listas em ordem alfabética). Cada verbete é composto por: "Termo → Definição direta → Analogia correspondente".
Ao concluir (ou ao retornar para consulta no futuro), você terá acessado:
- O mapeamento completo de todos os conceitos essenciais do tutorial explicados em linguagem simples e com analogias ilustrativas
- Agrupamento por blocos temáticos para facilitar o entendimento de suas inter-relações
- Referências explícitas aos artigos detalhados de cada tópico para aprofundamento rápido
- Uma tabela comparativa de termos semelhantes para esclarecer possíveis confusões
- Um exercício prático para consultar a definição oficial de qualquer conceito na própria CLI do Claude usando um servidor de documentação
01 O Fluxo de Agente: Como o processamento do Claude é executado
Esta categoria constitui a base conceitual mais importante. Ela responde à questão primordial: qual a diferença prática entre o Claude Code e uma interface web de chat convencional, e como ele consegue realizar ações autônomas. Os demais conceitos derivam desse fluxo contínuo.
Analogia: uma linha de montagem automatizada. Chats convencionais operam no modelo "pergunta-resposta", como um balcão de atendimento; o Claude Code funciona como uma linha de montagem autônoma — ao receber o objetivo, ele coleta insumos, executa modificações, valida a entrega e avalia se novas rodadas de ajustes são necessárias. Os termos abaixo representam os componentes desse fluxo.
Agentic loop (Loop de agente)
一句话： Claude 处理每个任务时反复转的那个圈——收集上下文 → 采取行动 → 验证结果 → 不够就再来一圈，直到完成。
Analogia: o ato de cozinhar experimentando. O preparo não consiste em jogar os ingredientes na panela e aguardar; o fluxo é "inserir ingredientes → refogar → experimentar → ajustar tempero", aproximando-se do ponto ideal. Cada avaliação (retorno de ferramentas) dita o passo seguinte, mantendo o controle aberto a intervenções. (veja o Artigo 03)
Agentic coding (Codificação baseada em agentes)
一句话： 一种工作方式——AI 能自主读文件、跑命令、改代码，你在旁边看着、随时纠偏或干脆走开，而不是它给你一段文字让你自己照着敲。
Analogia: contratar um desenvolvedor sênior em vez de ler um manual. O manual orienta o caminho; o desenvolvedor realiza a tarefa. O Claude Code pertence à categoria de executores práticos graças às ferramentas que manipula. (veja o Artigo 01)
Agentic harness (Ambiente de execução de agente)
一句话： 把一个语言模型「武装成」能干活的编程代理的那一整套外围——文件访问、shell 执行、权限控制、记忆加载、把动作串起来的循环。Claude Code 是外壳，Claude 是里头的模型。
Analogia: chassi e motor de um veículo. O mesmo motor (modelo) trará comportamentos e utilidades diferentes dependendo do veículo (harness) onde for instalado. O harness dita quais recursos do sistema o modelo pode acessar e sob quais regras ele operará. (veja o Artigo 03)
Tool (Ferramenta)
一句话： Claude 能实际执行的动作——读文件、改代码、跑 shell 命令、搜网页、派 subagent；没有工具，它就只能动嘴回文字。
Analogia: maquinário em uma linha de produção. Um cérebro analítico precisa de braços robóticos e esteiras para materializar o trabalho. Ferramentas são as "mãos" do Claude; cada acionamento retorna dados que alimentam a decisão do passo seguinte no loop. (veja o Artigo 03)
Turn (Turno / Rodada)
一句话： 从你发一条消息开始，到 Claude 把这次响应彻底说完为止，算一个完整回合；中间它可能调用任意多次工具。
Analogia: fazer o pedido e receber o prato pronto. Você envia a demanda (o pedido) e o Claude realiza as etapas internas de picar, refogar e empratar (acionar as ferramentas). A entrega final constitui o fechamento do prato. Uma sessão é formada pelo histórico desses turnos. (veja o Artigo 03)
Verification loop (Loop de validação)
一句话： 让 Claude 知道「活儿是真干完了，不只是看起来像」的机制——你给它一个能跑的检查（测试、构建、截图对比），它就反复改到检查通过为止。
Analogia: confrontar os resultados com o gabarito. Sem critérios objetivos de sucesso, a "conclusão" torna-se meramente presumida; ao fornecer um validador autônomo, ele corrigirá as falhas sistematicamente até obter a conformidade. Esse recurso é fundamental em automações autônomas. (veja o Artigo 49)
Extended thinking (Raciocínio estendido)
一句话： 模型在正式回答前那段看得见的逐步推理，在终端里以灰色斜体显示；可以用 MAX_THINKING_TOKENS 或调 effort level 控制它想多少。
Analogia: rascunho de cálculo matemático. Em vez de dar a resposta final de forma direta, os passos lógicos intermediários são estruturados no papel, permitindo auditar o fluxo de raciocínio e localizar eventuais desvios lógicos. (veja o Artigo 35)
Effort level (Nível de esforço)
一句话： 一个设置，控制 Claude 每个回合花多少「思考预算」——级别越高想得越深、越慢越贵，越低越快越省。
Analogia: tempo limite de resolução de prova. Questões simples são resolvidas de imediato (baixo esforço); problemas complexos exigem minutos dedicados de raciocínio (alto esforço). Tarefas triviais rodam de forma econômica em níveis baixos, enquanto refatorações críticas demandam alta prioridade de processamento. (veja o Artigo 35)
💡 Resumo em uma frase: Este bloco explica a autonomia mecânica da aplicação — composta pelo ciclo interativo "pensar → agir → observar", as tools que agem como braços executores, o harness que funciona como chassi do modelo, o extended thinking que serve de rascunho lógico, o effort level para alocação de cota de pensamento e o loop de validação que atua na inspeção de qualidade.
02 Gestão de Contexto: O limite de memória e espaço de trabalho do Claude
Ao dominar o fluxo de processamento, você se deparará com a restrição fundamental — o Claude não possui memória infinita. Os termos desta categoria tratam do volume de retenção de dados, estratégias de saturação de contexto e métodos de limpeza. As causas de esquecimentos durante as sessões estão explicadas aqui.
Analogia: as dimensões de uma mesa física de escritório. Ao trabalhar em um projeto, a mesa suporta apenas uma quantidade limite de plantas, relatórios e rascunhos; quando ela fica lotada, novos materiais exigem a organização ou arquivamento dos antigos. A memória operacional do Claude funciona como essa bancada de trabalho.
Context window (Janela de contexto)
一句话： 一次会话的「工作内存」——装着对话历史、文件内容、命令输出、CLAUDE.md、加载的 skill、系统指令，就这么大，装满为止。
Analogia: a área útil de trabalho da mesa. Quanto maior a mesa, mais documentações podem ficar acessíveis simultaneamente; ao esgotar o espaço, novas entradas exigem descartar as antigas. O comando /context lista os elementos ativos e seus respectivos pesos na bancada. (veja o Artigo 19)
Token
一句话： 模型处理文字的最小计量单位，大致是「半个到一个汉字、一个英文词的一部分」；上下文窗口的大小、计费，都按 token 算。
Analogia:文字的「计价字数」。 Assim como encomendas são cobradas por peso, a leitura e a escrita del modelo de linguagem são cobradas por tokens, que preenchem e esgotam o espaço de trabalho da mesa. (Embora seja um conceito de processamento do modelo, basta entender esta definição de escala prática para o uso).
Compaction (Compactação / Resumo de Contexto)
一句话： 上下文快装满时，自动把对话「总结成精简版」腾地方——先清掉老的工具输出，再概括对话；跑 /compact 可手动触发。
Analogia: resumir rascunhos espalhados em uma folha de notas. Com a mesa lotada, você anota as decisões importantes em um cartão e descarta as folhas rabiscadas — os pontos essenciais são mantidos com consumo mínimo de espaço. Nota: arquivos como CLAUDE.md e a memória automática persistente são preservados e relidos, mas orientações soltas registradas no chat podem ser perdidas no resumo. (veja o Artigo 19)
Auto-compact (Compactação automática)
一句话： 不用你喊，上下文接近上限时系统自动触发的那次压缩。
Analogia: o coletor de detritos possui um sensor de volume que esvazia a caçamba automaticamente ao atingir o limite, sem necessidade de intervenção humana. A ação final é idêntica ao /compact, variando apenas o gatilho de execução. (veja o Artigo 19)
Session (Sessão)
一句话： 跟你当前目录绑定的一段对话，有它自己独立的一块上下文窗口；/clear 开新会话，旧的存着可 /resume 找回。
Analogia:換个全新任务，干脆收拾干净台面再开工。 Manter anotações de uma tarefa anterior na mesa apenas confunde a execução; limpar a mesa de trabalho (iniciar nova sessão) garante foco. Como os dados das sessões são persistidos em ~/.claude/projects/, você pode encerrar o terminal e retornar ao ponto exato executando claude -c depois. (veja o Artigo 19)
CLAUDE.md
一句话： 你写给 Claude 的常驻说明书，每个会话一开就自动加载，放「项目约定、构建命令、永远做 X」这类始终生效的规矩。
Analogia:给新员工的入职手册。 Como o assistente que inicia a sessão atua de forma limpa, a presença de um roteiro de boas-vindas no projeto garante o alinhamento instantâneo sobre as regras locais. Recomenda-se manter o tamanho abaixo de 200 linhas, delegando documentações extensas para skills específicas. (veja o Artigo 18)
Auto memory (Memória automática)
一句话： Claude 根据你的纠正和偏好，给自己写的笔记，按 git 仓库存在 ~/.claude/projects/ 下，会话开始时加载索引的开头一截。
Analogia:显示器 ao lado com notas de auto-correção. Enquanto o CLAUDE.md representa as diretrizes fornecidas por você, a auto memory atua como um rascunho de aprendizado mantido pela própria IA — registrando observações como "o usuário prefere evitar NPM". Ambas atuam de forma conjunta. (veja o Artigo 25)
Rules (Diretrizes de Regras)
一句话： 放在 .claude/rules/ 里、跟 CLAUDE.md 一起加载的模块化指令文件，可以用 paths: 限定「只在 Claude 读到匹配文件时才加载」，让上下文保持精简。
Analogia:manuais específicos de engenharia ativados sob demanda. O CLAUDE.md funciona como as diretrizes gerais do canteiro de obras; os arquivos de regras (.claude/rules/) funcionam como os manuais específicos de elétrica ou hidráulica, abertos apenas quando o profissional trabalha naquelas respectivas seções. (veja o Artigo 13)
Output style (Estilo de saída / Resposta)
一句话： 一项配置，改写 Claude 的系统提示来调整它回应的行为、语气和格式；内置有 Default、Proactive、Explanatory、Learning 几种。
Analogia:ajustar o perfil de apresentação de um apresentador. A mesma pessoa pode adotar uma postura formal para jornalismo ou descontraída para entretenimento. O estilo de saída atua como essa modulação de comportamento da IA, sendo conceitualmente diferente do CLAUDE.md. (veja o Artigo 32)
💡 Resumo em uma frase: Este bloco de conceitos gerencia a retenção de dados e a comunicação — a janela de contexto atua como a mesa de trabalho, tokens servem como métrica de volume, compaction representa a organização do espaço de trabalho, sessões isolam as tarefas, enquanto CLAUDE.md, auto memory e rules servem como manuais de consulta e o output style dita a postura comunicativa.
03 Recursos de Extensão: Customizando o Claude para tarefas específicas
Esta categoria representa o núcleo de personalização do guia — estratégias para moldar o Claude do comportamento genérico para fluxos de trabalho específicos. O Artigo 30 detalha os critérios de escolha de cada ferramenta. Em comum, todas representam ganchos integrados em diferentes fases do loop de agente.
Analogia: caixas de ferramentas para especialização profissional. O profissional (modelo) ganha novas utilidades quando equipado com um roteiro de integração (CLAUDE.md), livros de receitas de nicho (skills), conectores externos (MCP), auxiliares de campo (subagents) e travas de segurança (hooks).
Skill (Habilidade)
一句话： 一个 SKILL.md 文件，装着一段知识、套路或流程；相关时 Claude 自动把它调进来用，你也能 /<名字> 主动唤它。
Analogia:atalhos configurados no celular. Executar "Modo Cinema" apaga as luzes, liga a TV e silencia notificações sem exigir comandos individuais. A skill atua como esse roteiro pré-programado: empacotando fluxos repetitivos e carregando-os somente no momento do disparo para poupar espaço de contexto (mecanismo oficial de "progressive disclosure"). (veja o Artigo 26)
Subagent (Subagente)
一句话： 一个有独立上下文窗口的专项助手，带自己的系统提示和工具权限，你派活给它，它干完只把结论摘要递回主对话。
Analogia:delegar a busca de arquivos pesados para um assistente. Você solicita a consolidação de relatórios extensos; ele executa o trabalho em sua própria mesa e traz apenas a resposta consolidada ("o número que procurava é X"). O objetivo é o isolamento de contexto — evitando poluir a janela da conversa principal com dados intermediários. Opções padrão incluem Explore, Plan e perfis genéricos. (veja o Artigo 23)
Hook (Gancho)
一句话： 在 Claude Code 生命周期的某个固定时刻（工具运行前、文件改完后、会话一开始……）自动执行的一段动作，可以是 shell 命令、脚本、通知等。
Analogia:trava de segurança em linha de produção. Sempre que uma etapa da esteira é concluída, a prensa desce de forma mecânica para selar a embalagem — sem depender de supervisão humana ou decisões da IA. Trata-se de uma garantia técnica, ao contrário das instruções puras inseridas no CLAUDE.md. (veja o Artigo 33)
Command / slash command (Comando / comando de barra)
一句话： 你在提示里打 /名字 就能调用的可复用指令；内置的（/clear、/model、/compact）控制会话，自定义的本质就是「带 /<名字> 触发的 skill」。
Analogia:botões de atalho no controle remoto. /clear funciona como a tecla reset e /deploy como um botão personalizado para publicar atualizações, rodando um roteiro padronizado de passos. Atualmente, a documentação recomenda o uso de skills para gerenciar ações complexas. (veja o Artigo 36)
Plugin (Plugin)
一句话： 把 skill、hook、subagent、MCP server 打包成一个可安装单元，装一次，一整套扩展点全到位。
Analogia:mala de viagem organizada. Em vez de carregar roupas, cabos e necessaire soltos nas mãos, você os coloca em uma mala fechada. O plugin funciona como esse container — facilitando a portabilidade do ambiente entre diferentes repositórios de projetos. As skills de um plugin são isoladas por namespaces (como /plugin-x:review) para evitar conflitos de escopo. (veja o Artigo 24)
Plugin marketplace (Mercado de Plugins)
一句话： 分发和获取 plugin 的来源，你可以添加一个或多个市场，从里面挑 plugin 安装。
Analogia:loja de aplicativos móveis. Uma vitrine centralizada onde você escolhe quais aplicações deseja instalar. Atenção à segurança: a instalação de plugins exige os mesmos cuidados que a execução de instaladores externos na máquina local. (veja o Artigo 38)
💡 Resumo em uma frase: Este bloco representa a ampliação de recursos — com skills agindo como atalhos operacionais, subagents como auxiliares isolados, hooks como travas técnicas automáticas, commands como teclas de menu, plugins como kits integrados e o marketplace como repositório de busca.
04 Ecossistema MCP: Abertura de canais de comunicação com ambientes externos
O MCP merece destaque individual por possuir sua própria terminologia (transport, server, scope...), sendo a causa mais comum de erros na execução de configurações da CLI. O Artigo 22 aborda o protocolo de ponta a ponta; detalhamos aqui suas divisões.
Analogia: adaptador multiportas USB-C. Computadores compactos carecem de portas físicas para cabos HDMI, ethernet e periféricos; plugar um hub multifuncional expande a conectividade por meio de uma única conexão física. O MCP atua como esse hub para o Claude — expondo ferramentas de múltiplos serviços externos na conversa.
MCP (Model Context Protocol / Protocolo de Contexto do Modelo)
一句话： 一套开源标准，规定「AI 工具怎么连外部数据和服务」；MCP server 给 Claude 接上 Slack、Jira、数据库、浏览器等几百种集成。
Analogia:o padrão USB. Antigamente, cada acessório exigia conectores e conexões exclusivas. A padronização da tecnologia USB unificou a comunicação em interfaces idênticas. O MCP atua como esse padrão universal de ferramentas para IA. (veja o Artigo 22)
MCP server (Servidor MCP)
一句话： 按 MCP 标准实现的一个具体「接头」，带着一组工具（比如 GitHub server 带「读 PR」「开 issue」），接上后这些工具就出现在 Claude 面前。
Analogia:um acessório conectado ao hub. O hub representa a especificação (MCP); a impressora e o drive de armazenamento acoplados são as ferramentas locais (servers) — cada um expande uma cota de ação específica. (veja o Artigo 22)
Transport (Método de Transmissão / Transporte)
一句话： Claude Code 和 MCP server 之间「怎么通信」的方式；日常就两种——stdio（本地进程）和 http（远程托管），外加一个已弃用的 sse。
Analogia:acessórios locais versus periféricos de rede. O stdio funciona como uma aplicação executada localmente no terminal em segundo plano (sob seu controle direto); o http atua como um endpoint remoto hospedado em rede (fora de sua máquina). Erros comuns ocorrem ao configurar esses canais: processos stdio não declaram transport explicitamente, enquanto conexões http exigem o parâmetro --transport http. (veja o Artigo 22)
Scope (Escopo)
一句话： 一个 MCP server 在「哪些项目里能用、要不要跟团队共享」——local（仅当前项目、私有）、project（写进 .mcp.json、随 git 共享）、user（你所有项目）。
Analogia:compartilhamento de impressora no escritório. Você pode conectá-la direto ao seu computador (local), registrá-la na rede da equipe para uso comum (project) ou usá-la de forma móvel entre salas de reunião (user). (veja o Artigo 22)
MCP Tool Search (Busca de Ferramentas MCP)
一句话： 一种省上下文的机制——启动时只加载工具的名字，Claude 真要用某个工具时才按需拉取它的完整说明。
Analogia:ler apenas os nomes dos pratos no cardápio, abrindo a receita detalhada apenas após a escolha. Evita carregar centenas de instruções de ferramentas MCP inativas na janela de contexto de antemão, mantendo a bancada de trabalho organizada. (veja o Artigo 22)
💡 Resumo em uma frase: O MCP atua como o padrão de conectividade externa para IA — com o server implementando as ferramentas, o transport definindo a conexão física (stdio local ou http remoto) e o scope definindo os limites de uso; valide a confiabilidade de servidores de terceiros antes do registro.
05 Segurança e Permissões: Níveis de aprovação prévia das ações
Com a IA atuando de forma autônoma e consumindo dados externos, garantir a segurança operacional torna-se crucial. Esta categoria lida com os filtros de autorização de tarefas — cobrindo desde confirmações interativas simples até bloqueios rígidos no terminal. Detalhado nos Artigos 20 e 21.
Analogia: camadas de segurança veicular. Cintos de segurança, airbags e faixas de velocidade atuam em conjunto — guiando as ações preventivas, contendo incidentes e impondo limites físicos rígidos de segurança. Os verbetes abaixo organizam essas barreiras.
Permission mode (Modo de permissão)
一句话： 一次会话里 Claude 动手的「基线态度」——官方共六档，包括每步都问你（default）、自动接受改动（acceptEdits）、只研究不动手（plan）、别问直接干（bypassPermissions）、自动审查（auto）、静默通过（dontAsk）；完整说明见第 35 篇。
Analogia: a autonomia concedida a um profissional iniciante. Você pode exigir que ele valide cada pequena etapa antes de executar ou dar autonomia para pequenas edições. O modo de permissão regula essa barra de liberdade, gerenciável via atalho Shift+Tab na CLI. (veja o Artigo 35)
Plan mode (Modo de planejamento)
一句话： 一项权限模式——Claude 只读、只搜、只研究，不碰你的源文件，先把改动方案列出来给你批，你点头了才动手。
Analogia: aprovação de plantas arquitetônicas antes da obra. Proíbe modificações diretas estruturais na casa até que a planta com a indicação exata de demolições e reformas seja revisada e assinada por você. Recomendado para refatorações extensas. (veja o Artigo 35)
Auto mode (Modo automático)
一句话： 一项权限模式——后台有个独立的分类器模型逐个审查操作，挡掉越权、可疑基础设施和提示注入，而不是每步都弹窗问你；目前是研究预览。
Analogia: portaria corporativa auditando crachás. O classificador foca estritamente em verificar a legitimidade do comando executado, sem acessar o conteúdo de retorno das ferramentas, mantendo-se imune a instruções maliciosas injetadas nos dados. (veja o Artigo 35)
Permission rule (Regra de permissão)
一句话： 按「工具名加参数模式」来 allow / ask / deny 的细粒度设置条目，按 deny→ask→allow 顺序匹配，先中者胜。
Analogia: regras específicas de controle de acesso físico. Define regras finas como "este perfil acessa o terceiro andar, mas tem o acesso bloqueado à sala do servidor", sobrepondo-se ao comportamento geral definido no modo de permissão. (veja o Artigo 20)
Sandboxing (Isolamento em Sandbox)
一句话： 给 Bash 工具套一层操作系统级的文件和网络隔离——Claude 在你划定的边界内自由跑，不用每条命令都弹窗批准。
Analogia: testar um carro em uma pista de testes fechada. Você pode acelerar o quanto quiser sem riscos, pois os limites físicos de contenção impedem que o veículo saia do circuito. O sandbox atua como essa barreira, de forma complementar às regras lógicas de acesso. (veja o Artigo 21)
Prompt injection (Injeção de prompt)
一句话： 藏在文件、网页或工具结果里的恶意指令，试图把 Claude 带去做你从没要求的事。
Analogia: uma fraude por engenharia social em uma chamada telefônica. O tom do interlocutor parece profissional, mas a instrução oculta solicita que você transfira fundos ou exponha dados. O Claude pode cair no golpe caso processe esses dados sem barreiras técnicas, sendo os servidores MCP os canais de maior risco. (veja o Artigo 21)
Checkpoint (Ponto de restauração / Checkpoint)
一句话： 在你每次发提示时自动建的「还原点」，Claude 改文件前先快照；按两次 Esc（输入框需为空）或 /rewind 打开回溯菜单，可选恢复代码、对话或两者到早先某个提示点。它是会话本地的，跟 git 分开。
Analogia: pontos de salvamento automático em jogos eletrônicos. Permite recarregar um save state anterior para refazer um trecho difícil, sem necessidade de reiniciar a campanha. Nota: modificações feitas diretamente via comandos do shell (ferramenta Bash) não são rastreadas pelo checkpoint, exigindo controle via git. (veja o Artigo 37)
💡 Resumo em uma frase: Este bloco abrange o ecossistema de controle operacional — com o modo de permissão ditando a atitude geral, regras refinando as autorizações, sandboxing atuando como barreira de isolamento físico, o modo auto como auditoria em segundo plano, checkpoints como pontos de recuperação locais e injeções de prompt como o vetor de ameaça a ser mitigado.
06 Interfaces e Execuções: Onde rodar a aplicação e suas posturas operacionais
Esta categoria aborda os formatos de interação e os meios de inicialização del Claude Code. Sejam comandos executados direto no terminal, interfaces no editor de código, portais web ou scripts autônomos de integração — todos rodam sobre a mesma engine básica.
Analogia: modalidades de atuação profissional. O mesmo profissional pode atuar presencialmente em sua mesa (terminal ou extensões), de forma remota via ambiente web ou sob demanda respondendo a ordens de serviço pontuais (execução automatizada de scripts). A competência é idêntica, alterando apenas a interface.
Surface (Interface / Superfície de Interação)
一句话： 你访问 Claude Code 的任何地方——CLI、VS Code、JetBrains、桌面端、claude.ai；所有入口共用同一个引擎，你的 CLAUDE.md、设置、skill 在哪儿都一样使。
Analogia: o mesmo software de navegação instalado em diferentes modelos de carro. O design externo do veículo muda, mas as telas de controle, o layout de rotas e as preferências salvas continuam idênticas. A transição de interface do Claude Code segue esse padrão. (veja o Artigo 08)
Non-interactive mode (Modo não interativo / antigo modo headless)
一句话： 用 -p（或 --print）跑——执行单条提示、出结果就退出，不进对话会话；专门给 CI、脚本、流水线用。旧文档里叫 headless mode，是同一个东西。
Analogia: envio de ordem de serviço fechada. Sem conversas intermediárias ou discussões de escopo: a tarefa é entregue, executada em lote e o relatório final é gerado. A implementação disso via código é feita com o SDK. (veja o Artigo 45)
Agent SDK (SDK de Agente)
一句话： 把 Claude Code 的能力搬进你自己程序的开发包（Python / TypeScript），让你在代码里像调函数一样驱动它。
Analogia: utilizar a placa controladora interna de um equipamento em um projeto próprio. Em vez de interagir com o gabinete fechado da máquina, você integra seus circuitos diretamente sob suas próprias regras de interface. O modo não interativo é a versão para terminal, enquanto o SDK é a versão programável em código. (veja o Artigo 45)
Claude Code on the web (Versão Web)
一句话： 在浏览器里跑的 Claude Code，任务在云端沙箱里执行（跟「Remote Control」不同——后者代码还在你本机，只是 UI 远程）。
Analogia: utilizar uma máquina virtual temporária na nuvem. Os comandos e edições rodam no ambiente isolado do provedor, mantendo a integridade da sua máquina física de trabalho. (veja o Artigo 11)
Bare mode (Modo básico / bare mode)
一句话： 启动加 --bare，跳过 hook、skill、plugin、MCP server、auto memory、CLAUDE.md 的自动发现——只有你显式传的参数生效；给 CI 和脚本求「换台机器行为也一致」用。
Analogia: viajar carregando apenas uma bagagem de mão padrão. Remove qualquer customização ou preferência local, mantendo apenas as instruções básicas para garantir o mesmo comportamento em qualquer máquina. (veja o Artigo 34)
Worktree isolation (Isolamento de Git Worktree)
一句话： 一种隔离方式，用 -w 或在 subagent 配置里写 isolation: worktree，让 Claude 在 .claude/worktrees/ 下一个单独的 git worktree、单独分支里干活，改动不会跟别的并行代理打架。
Analogia: canteiros de obras isolados para equipes distintas executando a mesma planta. Permite que múltiplos times trabalhem em paralelo sob as mesmas diretrizes, prevenindo conflitos físicos de ferramentas ou demolições cruzadas nas branches principais. (veja o Artigo 41)
Remote Control (Controle Remoto) / Teleport (Teletransporte)
一句话： Remote Control 是从手机或浏览器接管你本机正在跑的会话（代码还在你机器上，只有界面远程）；Teleport（/teleport）反过来，把云端会话拉进你本地终端接着干。
Analogia: acesso remoto via painel de visualização. O Remote Control funciona como um software de controle remoto instalado no computador da empresa que você gerencia a distância pelo celular. O Teleport atua puxando o progresso de um servidor de desenvolvimento remoto para continuar a execução direto no terminal físico. (veja o Artigo 11)
💡 Resumo em uma frase: Este bloco engloba as interfaces de uso — com a surface sendo a janela ativa (usando a mesma engine), o modo não interativo a execução pontual por ordem de serviço, o Agent SDK a integração em código, a versão web o isolamento em container de nuvem, o bare mode a inicialização limpa de scripts, o git worktree a barreira contra conflitos em execuções paralelas e o Remote Control / Teleport o fluxo de portabilidade de sessões entre a nuvem e o terminal físico.
07 Termos Semelhantes: Diferenças conceituais para evitar confusões
Com a ampliação dos termos, é comum confundir conceitos correlacionados. Mapeamos as principais dúvidas identificadas no uso prático para servir como referência de consulta rápida. Esta tabela também consolida a revisão conceitual dos blocos anteriores.
| Comparativo | Critério de distinção | Resumo da diferença |
|---|---|---|
| Skill vs Subagent | Destino dos dados na janela de contexto | A skill carrega dados direto na sua janela de conversa ativa; o subagent roda em uma janela de contexto isolada, retornando apenas o resumo das ações (Artigo 30) |
| CLAUDE.md vs Skill | Momento de leitura | O CLAUDE.md é carregado de forma automática na inicialização da sessão; a skill é lida sob demanda ("lazy load") (Artigo 30) |
| Hook vs Regra de Permissão | Abrangência de controle | O hook executa um script/comando de terminal ativado por eventos; a regra de permissão valida regras lógicas (permitir/negar) de uso de ferramentas (Artigo 30) |
| Subagent vs Agent Team | Interface de interação direta | O subagent atua internamente na sessão reportando resultados ao fluxo principal; o agent team gerencia sessões completas independentes abertas à conversa direta (Artigo 29) |
| Session vs Turn | Escala de granularidade | A session engloba todo o histórico de conversa com contexto próprio; o turn representa o ciclo pontual de envio de prompt e retorno da IA (Artigo 03) |
Compaction vs /clear | Persistência do histórico | A compaction substitui as mensagens antigas por um resumo consolidado; o comando /clear limpa a mesa de trabalho descartando a sessão para abrir uma nova conversa (Artigo 19) |
| Permission Mode vs Regra de Permissão | Nível de controle de escopo | O modo de permissão dita a autonomia padrão concedida (perguntar sempre ou não); a regra de permissão define regras finas para chamadas de ferramentas específicas (Artigo 20) |
| stdio vs http (transport) | Local de execução do servidor | O stdio executa o servidor localmente em segundo plano; o http consome o servidor hospedado remotamente em rede (Artigo 22) |
| CLAUDE.md vs Auto memory | Origem de autoria | O CLAUDE.md reúne regras declaradas pelo desenvolvedor; a auto memory reúne anotações automáticas mantidas pela própria IA (Artigo 25) |
Muitos iniciantes confundem conceitos correlacionados no início. A dúvida entre skill e subagent é o caso clássico — tentar processar a busca de códigos legados em múltiplos diretórios registrando isso em uma skill lotará o contexto de conversa ativo rapidamente. A abordagem recomendada é: tarefas volumosas que geram dados intermediários dispensáveis e exigem apenas resumos devem ser delegadas para subagents, e não embutidas em skills.
💡 Resumo em uma frase: Ao diferenciar conceitos próximos, avalie a variável crítica — skill/subagent dependem da janela de contexto destino; CLAUDE.md/skill dependem do momento de leitura; mode/regra dependem do nível de refinamento; e stdio/http do local de execução do servidor.
08 Prática: Usando o Claude como glossário interativo oficial
Este glossário funciona como referência básica, mas novos recursos atualizam a documentação oficial continuamente. O fluxo de consulta mais confiável consiste em solicitar à IA a busca das definições atualizadas direto do servidor de documentação oficial apresentado no Artigo 22 — ele não exige credenciais, bastando registrá-lo no MCP.
O servidor de documentação consome conexão HTTP em rede externa. Valide o acesso ao host
code.claude.comno seu terminal antes de iniciar.
Passo 1: Conecte o servidor de documentação oficial (execute no terminal, fora da sessão del claude)
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcpSaída esperada: O terminal exibirá a linha Added HTTP MCP server claude-code-docs .... Visualizar Added confirma a gravação das configurações.
Passo 2: Confirme o status da conexão
claude mcp listSaída esperada: O painel listará o servidor claude-code-docs com o status ✓ Connected. O destaque verde confirma o sucesso da conexão; retornos com ✗ Failed to connect indicam falha de roteamento de rede.
Passo 3: Inicie a sessão e solicite definições específicas
claudeDigite no prompt (especificar o servidor orienta a IA a ler o MCP em tempo real, evitando respostas baseadas em rascunhos de treinamento):
用 claude-code-docs server 查一下官方术语表里 compaction 和 context window 的定义，各用一句话告诉我Saída esperada: O Claude solicitará autorização manual de uso do novo servidor MCP na primeira chamada (o filtro de autorização padrão de ferramentas abordado na Seção 05, gerenciado pelo módulo de permissões). Aprove a execução. A IA retornará as definições oficiais dos dois termos consultados, registrando a tag claude-code-docs ao lado del log de execução da ferramenta. O rótulo garante que a resposta foi recuperada da documentação ativa do servidor.
Passo 4: Remova o servidor de documentação (Opcional)
claude mcp remove claude-code-docsSaída esperada: A CLI exibirá logs confirmando a exclusão. Ao rodar claude mcp list, o servidor não será exibido.
Esse fluxo estrutura uma estratégia robusta de consulta técnica: utilize esta página para referência básica rápida e acione o servidor oficial MCP para validar novidades conceituais. Esse processo garante precisão em relação à evolução dos recursos da ferramenta.
💡 Resumo em uma frase: Esta página serve como referência inicial estática, enquanto o servidor de documentação MCP funciona como o glossário oficial dinâmico (registre com
add→ valide emlistcom status conectado → execute a consulta na sessão indicando a origem → autorize a permissão) para consultar dados atualizados.
09 Resumo
Este artigo atua como um glossário de cabeceira — organizando as terminologias do manual em seis categorias temáticas para simplificar consultas futuras.
Revisão dos blocos temáticos:
| Bloco temático | Finalidade operacional | Conceitos-chave |
|---|---|---|
| Fluxo de Agente | Mecanismos de autonomia operacional da IA | agentic loop, tool, harness, turn, extended thinking, effort level, verification loop |
| Janela de Contexto | Retenção de dados e estilo de resposta | context window, token, compaction, session, CLAUDE.md, auto memory, rules, output style |
| Recursos de Extensão | Otimizações e customizações do ambiente | skill, subagent, hook, command, plugin, marketplace |
| Ecossistema MCP | Integrações e conexões com rede e hosts | MCP, server, transport, scope, tool search |
| Segurança e Permissões | Barreiras de auditoria lógica e física | permission mode, plan mode, auto mode, regras de permissão, sandbox, prompt injection, checkpoint |
| Interfaces e Execuções | Formatos de inicialização e controle de processos | surface, non-interactive (headless), Agent SDK, versão web, bare mode, isolamento de git worktree, Remote Control |
Agora você está pronto para: Identificar a finalidade e a analogia de cada conceito técnico do Claude Code, usar a Seção 07 para distinguir termos semelhantes e rodar consultas dinâmicas de definições direto da documentação oficial usando o servidor MCP. Mantenha este glossário acessível para esclarecer termos técnicos explicados ao longo de todo o guia.
Com a consolidação do glossário, cobrimos a jornada completa — desde a introdução, instalação, customizações e otimização até os conceitos finais de arquitetura.
O próximo artigo 53 "Desenvolvimento de Vídeo com Remotion (Opcional)" é um texto extra, demonstrando aplicações atípicas do Claude Code: usando o Remotion (um framework React para programar vídeos com código) para gerar um vídeo animado a partir de código. Leitura opcional, sem impacto no fluxo principal; recomendada para desenvolvedores interessados em explorar os limites de atuação de programação baseada em IA. Pense nisso: se vídeos podem ser programados por meio de código, delegar o desenvolvimento desse código ao Claude torna-se mais uma tarefa de automação interativa.