O Claude Code pode parecer difícil à primeira vista.
Termos como Terminal, MCP, hooks, Skills e API aparecem todos de uma vez, facilitando se perder na primeira hora.
Neste artigo, vou organizar o Claude Code como uma "aula onde um professor ensina dois alunos do ensino fundamental."
Ao final, você entenderá a ordem para aprender operações básicas, integrações externas, Skills, memória, hooks, MCP e a API.
A imagem do cabeçalho foi gerada por IA. O prompt está disponível neste artigo.
Claude Code é uma "IA que age", não apenas uma "IA que responde"
O Claude Code não apenas responde perguntas; é uma IA que realiza tarefas dentro do seu computador.
Na documentação oficial, é descrito como uma ferramenta de desenvolvimento do tipo agente que pode editar arquivos, executar comandos, realizar operações git e se integrar com MCP.
Depois que você entende isso, todas as funções se conectam.
O professor escreveu isso no quadro negro:
"Chat AI é um professor que dá conselhos. Claude Code é um líder de turma que trabalha ao seu lado na sala de aula."
Mina pergunta:
"Então, o Claude Code é só para quem sabe programar?"
O professor balança a cabeça.
"Ele ficou famoso primeiro como uma ferramenta para escrever código. Mas sua essência é uma IA que lê pastas, corrige arquivos e executa procedimentos. Pode ser usado para escrever, documentos, páginas web, notas de pesquisa e criar materiais de ensino."
Ren diz:
"Então, em vez de pedir para o ChatGPT 'escrever uma redação', posso pedir para o Claude Code 'olhar esta pasta, corrigi-la e verificá-la'."
Exatamente.
Ao ensinar o Claude Code, estas três categorias são suficientes para começar:
- Ler
- Corrigir
- Verificar
Por exemplo, se o professor está dando uma aula sobre como criar uma página web para uma festa escolar, ele pediria ao Claude Code assim.
O importante aqui não é pedir à IA apenas uma "resposta". Você dá ao Claude Code uma sequência de tarefas.
Índice
- Claude Code é uma "IA que age", não apenas uma "IA que responde"
- Operações Básicas: "Solicitar, Confirmar, Corrigir"
- Memória: A Nota de Passagem do Professor
- Skills: Cartas de Golpes Especiais
- Hooks: A Campainha e o Guarda de Patrulha
- MCP: O Ônibus da Excursão Escolar
- API e SDK: Como Usar o Claude Code como uma Peça
- Um Menu de Prática de 30 Minutos para Começar
Operações Básicas: "Solicitar, Confirmar, Corrigir"
O básico do Claude Code envolve um fluxo de solicitar, confirmar e corrigir.
Em vez de memorizar comandos difíceis, você melhora mais rápido aprendendo esse padrão de conversa.
No início, use-o com a premissa de "corrigir juntos" em vez de "completar de uma vez".
O professor deu aos dois alunos o primeiro padrão.
Mina diz com um rosto aliviado:
"Eu estava com medo de que mudasse tudo de repente. Só preciso pedir para ele propor as coisas primeiro."
O professor responde:
"Sim. É mais seguro criar pontos de confirmação do que deixar o Claude Code trabalhar sozinho."
O uso básico consiste nestes cinco:
claudepara iniciar o diálogoclaude "conteúdo da solicitação"para passar a solicitação inicialclaude -p "conteúdo da solicitação"para uma execução única não interativa/helppara verificar comandos disponíveis/statuspara verificar o status
No entanto, não há necessidade de ensinar tudo aos alunos do ensino fundamental desde o início. Na primeira aula, apenas abrir claude e dizer uma frase é suficiente.
Ren diz:
"Se é só isso que a primeira palavra precisa ser, não é assustador."
O professor continua:
"Isso mesmo. Você pode usar o Claude Code enquanto pergunta como usá-lo. Se não entender, pergunte sobre o próprio uso."
O objetivo das operações básicas não é a memorização de comandos. É o humano decidir o escopo do que deixar para a IA.
Memória: A Nota de Passagem do Professor
Memória é um lugar para escrever premissas que você quer que o Claude Code leia toda vez.
Na documentação oficial, é explicado como um sistema para usar diferentes arquivos de instrução para usuários ou projetos. Em uma sala de aula, é como uma nota de passagem entre professores.
O professor escreveu CLAUDE.md no quadro negro.
Mina pergunta:
"O que é isso?"
O professor responde:
"É o livro de regras da sala de aula que o Claude Code lê antes de começar o trabalho."
Para um projeto de festa escolar, você pode escrever assim.
Ren diz:
"Então não preciso dizer isso toda vez."
O professor acena com a cabeça.
"Exatamente. Se você está explicando a mesma coisa toda vez, coloque na Memória."
Informações adequadas para a Memória incluem:
- Objetivos do projeto
- Regras para estilo de escrita ou design
- Comandos usados com frequência
- Arquivos que não devem ser tocados
Por outro lado, algumas informações não são adequadas para a Memória:
- Solicitações apenas para hoje
- Ideias não confirmadas
- Senhas ou chaves de API
- Informações pessoais
Se estiver ensinando um aluno do ensino fundamental, é assim que se transmite:
"Memória não é mágica para tornar a IA mais inteligente. É um caderno para regras que você não quer que ela esqueça toda vez."
Esta explicação é suficiente.
Skills: Cartas de Golpes Especiais
Skills são procedimentos de trabalho usados com frequência transformados em um formato chamável.
Na documentação oficial, é explicado como um sistema centrado em SKILL.md que organiza modelos, exemplos, scripts e materiais de referência. Em uma sala de aula, são como cartas de golpes especiais que você puxa apenas quando necessário.
O professor desenhou três cartas:
- Verificação de Relatório de Livro
- Criação de Página da Festa Escolar
- Criação de Teste de Vocabulário de Inglês
Mina pergunta:
"Qual é a diferença disso para uma coleção de prompts?"
O professor responde:
"Uma coleção de prompts é um pedaço de papel que você cola toda vez. Skills são cartas que você mantém na caixa de ferramentas do Claude Code."
A estrutura básica de uma Skill é esta:
Em SKILL.md, você escreve quando usá-la, o que fazer e o que ler. O Claude Code pode usar automaticamente uma Skill que se encaixa na conversa, ou o usuário pode chamá-la usando /nome-da-skill.
Ren diz:
"Então posso transformar as regras de correção que o professor sempre usa em uma Skill."
Exatamente.
Para uma Skill de Relatório de Livro, você a projetaria assim.
O importante aqui é não transformar tudo em uma Skill. Para uma solicitação única, apenas perguntar na hora é suficiente.
Tarefas que devem ser transformadas em Skills atendem a estes critérios:
- Repetidas muitas vezes
- Têm um procedimento fixo
- Têm critérios de julgamento
- Têm materiais de referência ou modelos
- A qualidade tende a variar dependendo da pessoa
O professor finalmente disse:
"Skills não adicionam talento à IA. Elas transformam procedimentos humanos em um formato reutilizável."
Por favor, use também o site do Dicionário Claude Code.
Hooks: A Campainha e o Guarda de Patrulha
Hooks são mecanismos que são executados automaticamente antes ou depois do trabalho do Claude Code.
Na documentação oficial, são explicados como configurações para executar comandos ou processos de acordo com eventos específicos como PreToolUse ou PostToolUse. Em uma sala de aula, são a campainha e o guarda de patrulha.
Mina pergunta:
"Uma campainha?"
O professor responde:
"Sim. Ela toca antes da aula começar. Ela toca antes da submissão. Ela impede você se tentar ir a algum lugar perigoso. É isso que os hooks fazem."
Por exemplo, antes do Claude Code reescrever um arquivo, ele pode realizar uma patrulha como esta:
- Está tentando tocar em
.env? - Está tentando quebrar arquivos de configuração importantes?
- Deve executar testes após a reescrita?
- Deve formatar o texto?
- Deve deixar um log?
Os olhos de Ren brilham:
"Então você pode parar a IA quando ela está prestes a cometer um erro!"
O professor diz um pouco severamente:
"No entanto, hooks são ferramentas poderosas. Como eles podem executar comandos shell automaticamente, são perigosos se adicionados sem entendimento."
Ao explicar hooks para alunos do ensino fundamental, você não precisa fazê-los escrever configurações no início. Apenas ensine os papéis:
Antes do trabalho: Parar operações perigosas. Depois do trabalho: Executar testes ou verificações. Ao finalizar: Verificar tarefas inacabadas.
Na prática, introduza-os nesta ordem:
- Primeiro, verifique manualmente.
- Se a mesma verificação aparecer muitas vezes, transforme-a em uma lista de verificação.
- Quando a lista de verificação estiver estável, transforme-a em um hook.
Não automatize de repente. Se você automatizar uma verificação que um humano não entende, a falha também será automatizada.
O professor escreveu no quadro negro:
"Hooks não são robôs convenientes; são guardas de patrulha que seguem as regras que você definiu."
MCP: O Ônibus da Excursão Escolar
MCP (Model Context Protocol) é um mecanismo para conectar o Claude Code a serviços e dados externos.
Na documentação oficial, MCP é explicado como um padrão aberto para conectar ferramentas de IA com fontes de dados externas. Em uma sala de aula, é o ônibus da excursão escolar para sair da sala de aula.
O professor desenhou uma imagem da sala de aula. Lá fora, ele desenhou uma biblioteca, a sala dos professores, a prefeitura e um museu.
Ren diz:
"O Claude Code pode sair da sala de aula?"
O professor responde:
"Essa é a imagem. Quando você conecta o MCP, o Claude Code pode acessar informações externas como GitHub, Sentry, PostgreSQL, Slack, Google Drive e Figma."
Claro, você não deixa ele ver tudo livremente. Você decide o servidor de conexão, autenticação e permissões.
Nas configurações MCP do Claude Code, você pode adicionar servidores HTTP ou servidores stdio rodando localmente.
Mina diz preocupada:
"Conectar-se ao exterior é um pouco assustador."
O professor responde:
"Esse sentimento está correto. MCP é conveniente, mas quanto mais você conecta, mais informações ele pode tocar. Então, comece com acesso somente leitura."
A ordem para ensinar MCP é a seguinte:
- Primeiro, use apenas arquivos locais.
- Em seguida, conecte-se a dados seguros somente leitura.
- Depois disso, conecte-se ao GitHub ou gerenciamento de tickets.
- Finalmente, considere escrever ou dados de produção.
O valor do MCP não é que a IA se torne mais inteligente. É que a IA pode ir buscar os materiais necessários para o trabalho por si só.
O professor resume:
"MCP é o ônibus que mostra o mundo exterior para a IA. No entanto, o professor decide onde é permitido ir."
API e SDK: Como Usar o Claude Code como uma Peça
API (Interface de Programação de Aplicações) e SDK (Kit de Desenvolvimento de Software) são maneiras de incorporar o Claude Code em aplicativos ou processos automatizados.
Na documentação oficial, o SDK do Claude Code é explicado como um sistema que pode ser usado a partir de CLI, TypeScript e Python. Em uma sala de aula, é uma maneira de fazer o líder de turma participar do trabalho fora da sala de aula.
Ren pergunta:
"O que é uma API, afinal?"
O professor responde:
"Em vez de um humano falando em uma tela, é a entrada para pedir ao Claude Code para fazer o trabalho a partir de um programa."
Por exemplo, o uso normal se parece com isso. Isso é um humano perguntando uma vez do terminal.
Usando o SDK, você pode chamar o Claude Code dentro de um aplicativo ou processo em lote. O SDK Python é fornecido como claude-code-sdk, e um SDK TypeScript também está disponível.
Mina pergunta:
"Isso é algo que iniciantes devem fazer primeiro?"
O professor responde:
"Não. Não é algo que você deve fazer primeiro."
APIs e SDKs são usados nos seguintes estágios:
- Quando você quer executar a mesma tarefa automaticamente todos os dias.
- Quando você quer auxiliar com revisões ou testes em CI.
- Quando você quer chamar o Claude Code de ferramentas internas.
- Quando você quer executar múltiplos processos em paralelo.
- Quando você quer receber resultados em JSON.
Para alunos do ensino fundamental, é assim:
"Pedir ao líder de turma manualmente é a base do Claude Code. Enviar solicitações automaticamente da sala de transmissão é a API e o SDK."
É conveniente, mas usá-lo desde o início causa confusão. A ordem é: Básico, Memória, Skills, MCP, hooks e depois API.
Um Menu de Prática de 30 Minutos para Começar
Você não precisa aprender tudo sobre o Claude Code de uma vez.
Se você restringir o que fazer nos primeiros 30 minutos, o medo desaparece. Ao ensinar alunos do ensino fundamental, crie pequenas experiências de sucesso primeiro.
O professor finalmente apresentou um menu de aula de 30 minutos.
Mina diz:
"Acho que consigo fazer isso na aula!"
Ren diz:
"Então MCP e hooks podem vir depois."
O professor responde:
"Sim. A ordem é importante. Se você for direto para integração externa ou auto-execução, não saberá o que está acontecendo."
Os três primeiros objetivos são:
- Fazer o Claude Code explicar uma pasta.
- Fazer ele corrigir um arquivo pequeno.
- Fazer ele explicar o motivo da correção.
Se você conseguir fazer isso, já entendeu a essência do Claude Code. Depois disso, prossiga de acordo com suas necessidades:
- Se explicar a mesma coisa toda vez é um incômodo: Memória.
- Se fazer a mesma tarefa toda vez: Skills.
- Se você quer mostrar materiais externos: MCP.
- Se você quer automatizar verificações: hooks.
- Se você quer integrá-lo em um sistema: API e SDK.
Claude Code não é uma ferramenta para memorizar funções. É uma ferramenta para desenvolver como você entrega o trabalho.
O professor finalmente disse:
"Pessoas que sabem usar IA não são aquelas que são especialistas em IA. São pessoas que conseguem dividir o trabalho, entregar regras e realizar verificações."
Esta é a conclusão mais importante ao ensinar Claude Code para alunos do ensino fundamental.
Artigos Relacionados
[Iniciantes OK] Suporte Individual Claude Code
*As vagas de early bird para as primeiras 10 pessoas estão esgotadas.
Padrões de Design Claude Code
~Estrutura de Pastas, Skills, banco de dados e fluxos de geração de conteúdo totalmente revelados~
Consultas, consultorias individuais e solicitações de treinamento corporativo:
