# Claude Code: o que é, como instalar, usar skills e curso grátis em português > Entenda o que é o Claude Code, como instalar no Mac, Linux e Windows, configurar CLAUDE.md, skills, MCP, subagentes e plugins — e assista às 15 aulas do curso grátis em português. **Autores:** Mauro Mequelussi **Publicado:** 2026-11-05T01:56:33.506005728Z **Atualizado:** 2026-11-05T02:00:51.759331706Z **Tags:** em-portugues, agentes-de-ia, escola-de-aplicativos, vibe-coding, mcp, claude-code, curso-gratis --- O **Claude Code** é o agente de programação de terminal da Anthropic que lê arquivos do seu projeto, executa comandos no shell, roda testes automatizados, gerencia commits no Git e edita múltiplas camadas de código autonomamente. Para dominar a ferramenta na prática, o **[curso grátis Claude Code sem mistério](/cursos/claude-code-sem-misterio)** da Escola de Aplicativos reúne 15 aulas em vídeo em português, indo da instalação até a criação de skills, servidores MCP, subagentes, hooks e publicação do seu próprio plugin. Diferente de um chat tradicional em que você copia e cola trechos isolados de código, o Claude Code opera diretamente dentro da árvore do seu repositório. Ele analisa o contexto real da aplicação, propõe um plano de ação, pede permissão para executar ferramentas sensíveis e verifica se o build e os testes passaram antes de encerrar a tarefa. ## Assista à introdução do curso grátis de Claude Code Na série **Claude Code sem mistério: do zero ao plugin**, construímos passo a passo o **Atende**, um sistema real de atendimento no WhatsApp integrado a um CRM comercial. Você acompanha como sair do improviso no terminal para uma rotina de engenharia previsível e auditável. ::video-player{src="https://www.youtube.com/watch?v=yZTHbn_OpEY" title="Claude Code sem mistério: introdução ao curso grátis em português"} :: [Matricule-se gratuitamente no curso Claude Code sem mistério](/cursos/claude-code-sem-misterio) para salvar seu progresso aula a aula ou acompanhe a trilha completa de vídeos na tabela abaixo. ## O que é o Claude Code e como ele funciona por dentro? O Claude Code é um agente CLI (*Command Line Interface*) oficial da Anthropic movido pelos modelos Claude Sonnet e Claude Opus. Ele funciona em um loop agêntico de três etapas contínuas: **coletar contexto** (buscando arquivos com `glob`/`grep` e lendo trechos relevantes), **executar ações** (editando código, rodando scripts ou consultando integrações MCP) e **verificar resultados** (validando `typecheck`, linter e testes). Por operar direto no sistema operacional sem intermediários pesados, ele consome menos memória do que IDEs modificadas e pode ser integrado tanto ao seu editor favorito (VS Code, Cursor, Zed ou terminal puro) quanto a pipelines de integração contínua (GitHub Actions e rotinas na nuvem). ::callout{type="tip" title="Por que o Claude Code esquece regras em sessões longas?"} Toda conversa com um LLM possui uma janela finita de tokens. Quando a sessão cresce e passa por compactação (`/compact`), instruções verbais dadas apenas no início do chat se perdem. Por isso, regras permanentes de arquitetura devem viver no arquivo `CLAUDE.md` e em `skills` dedicadas — tema central do Módulo 2 do nosso curso. :: ## Como instalar o Claude Code no macOS, Linux e Windows A instalação oficial do Claude Code requer **Node.js 18 ou superior** (recomendamos Node.js 22 LTS) e uma conta ativa no Claude (plano Pro, Max, Team ou chave da API no Console da Anthropic). No Windows, você pode instalar tanto nativamente via PowerShell/Git Bash quanto pelo **WSL2 (Windows Subsystem for Linux)**, que oferece a melhor compatibilidade com ferramentas Unix. ```bash # 1. Verifique se o Node.js está instalado (v18+) node --version # 2. Instale o pacote global oficial da Anthropic npm install -g @anthropic-ai/claude-code # 3. Entre na pasta do seu projeto e inicie o agente cd meu-projeto claude ``` Na primeira execução do comando `claude`, o terminal abrirá o fluxo de autenticação OAuth no navegador para vincular sua assinatura ou conta do Anthropic Console. Assim que autenticado, execute `/init` dentro do repositório para que o próprio agente escaneie a estrutura de pastas e gere o primeiro rascunho do seu arquivo `CLAUDE.md`. ## Como usar o Claude Code no dia a dia: CLAUDE.md, Skills, MCP e Hooks Programadores que extraem resultado profissional do Claude Code não dependem de prompts longos digitados manualmente a cada sessão. Eles estruturam quatro camadas de governança no repositório: ### 1. Memória do projeto com `CLAUDE.md` O arquivo `CLAUDE.md` na raiz do repositório funciona como a memória permanente da equipe. Nele você documenta os comandos exatos de build, teste e lint (`pnpm test`, `pnpm typecheck`), as convenções de arquitetura, o banco de dados utilizado e o que o agente **nunca** deve fazer (como rodar migrations destrutivas sem confirmação). ### 2. Skills no Claude Code: como instalar e criar processos reutilizáveis Uma **Skill** no Claude Code é um pacote de instruções e scripts sob demanda (definido em um arquivo `SKILL.md`) que ensina ao agente como executar um fluxo repetitivo — como criar uma rota autenticada, auditar segurança, escrever um artigo otimizado para SEO ou revisar um pull request. Em vez de poluir o `CLAUDE.md` com milhares de linhas, o Claude Code carrega a skill apenas quando a tarefa exige aquele conhecimento. ### 3. Protocolo MCP (Model Context Protocol) no Claude Code Com o comando `claude mcp add`, você conecta o agente a bancos de dados e ferramentas externas em tempo real. É possível plugar o servidor MCP do [SurrealDB](/blog/surrealdb-mcp-lovable-replit) para consultar o schema real do banco, o MCP de navegador para inspecionar páginas ou o [REA (Reverse Engineer Anything)](/blog/rea-engenharia-reversa-ia) para realizar engenharia reversa assistida por IA em binários e protocolos. ### 4. Subagentes, Hooks e Plugins - **Subagentes:** Permitem delegar pesquisas extensas no código ou tarefas paralelas para agentes secundários com contexto isolado, preservando os tokens da conversa principal. - **Hooks:** Scripts determinísticos executados automaticamente antes ou depois de uma ferramenta (`PreToolUse`, `PostToolUse`), ideais para bloquear edições em arquivos protegidos ou rodar o linter automaticamente após cada alteração. - **Plugins:** Empacotam comandos, skills, subagentes e configurações MCP em um único módulo versionado para compartilhar com todo o time de engenharia. ::read-more{to="/blog/rea-engenharia-reversa-ia" title="REA: engenharia reversa com IA no Claude Code e Codex"} :: ## Claude Code vs Codex: qual agente de terminal escolher em 2026? Tanto o **Claude Code** (Anthropic) quanto o **Codex CLI** (OpenAI) operam como agentes autônomos de terminal, mas possuem pontos fortes distintos que se complementam em projetos reais: | Critério | Claude Code (Anthropic) | OpenAI Codex | | --- | --- | --- | | **Modelos principais** | Claude Sonnet 4.6 e Claude Opus 4.6 | Série GPT-5 / o-series otimizada para código | | **Ecossistema de extensão** | Sistema nativo completo de `CLAUDE.md`, Skills, Subagentes, Hooks e Plugins | Suporte a `AGENTS.md`, skills e execução em sandbox local/nuvem | | **Refatoração multi-arquivo** | Excelente aderência ao estilo existente do monorepo e arquitetura | Forte em raciocínio algorítmico denso, debugging profundo e geração rápida | | **Integração com ferramentas** | Nativa via MCP (`claude mcp`) e CLI Unix | Nativa via MCP e execução paralela de tarefas na nuvem | Na Escola de Aplicativos, utilizamos ambos no mesmo repositório: mantemos as regras compartilhadas documentadas e aproveitamos o sistema de plugins, hooks e subagentes do Claude Code para padronizar fluxos em arquiteturas [SaaS multi-tenant com SurrealDB](/blog/saas-multi-tenant-surrealdb) e Cloudflare Workers. ## Quanto custa o Claude Code? (Preços e planos em 2026) O Claude Code em si é uma ferramenta CLI gratuita para instalar, mas o consumo dos modelos exige uma assinatura ou créditos de API da Anthropic: - **Plano Claude Pro (US$ 20/mês):** Inclui acesso ao Claude Code com franquia compartilhada de uso a cada janela de 5 horas — ideal para desenvolvedores individuais e para acompanhar todo o nosso curso gratuito. - **Plano Claude Max (a partir de US$ 100/mês):** Oferece de 5× a 20× mais capacidade de uso do que o plano Pro, indicado para quem programa o dia inteiro com agentes e subagentes em repositórios grandes. - **API Pay-as-you-go (Anthropic Console):** Cobrança por milhão de tokens consumidos (entrada, saída e prompt caching), recomendada para automações de CI/CD, revisão automática de pull requests e pipelines sem intervenção humana. ## Grade completa do curso grátis: 15 aulas em português Todas as aulas abaixo têm entre 1 e 4 minutos, vão direto ao ponto e podem ser assistidas gratuitamente na [página oficial do curso Claude Code sem mistério](/cursos/claude-code-sem-misterio) ou pelo YouTube: | Aula | Tema da Aula | Vídeo | | --- | --- | --- | | **Introdução** | O que é o Claude Code e como funciona o curso | [Assistir](https://youtu.be/yZTHbn_OpEY) | | **Aula 01** | O que é o Claude Code e como instalar a ferramenta | [Assistir](https://youtu.be/qdJCniuvUAs) | | **Aula 02** | Como o Claude Code pensa e por que esquece suas regras | [Assistir](https://youtu.be/BiRNC56NWPw) | | **Aula 03** | Como desfazer mudanças e configurar permissões no Claude Code | [Assistir](https://youtu.be/AFTA-CsAGSU) | | **Aula 04** | Do bug ao pull request com o fluxo certo no Claude Code | [Assistir](https://youtu.be/-HxHsayw0K0) | | **Aula 05** | CLAUDE.md no Claude Code: pare de repetir as mesmas regras | [Assistir](https://youtu.be/3MbA7mDadCU) | | **Aula 06** | Skills no Claude Code: ensine um processo uma vez só | [Assistir](https://youtu.be/Dj2PWwuZeg8) | | **Aula 07** | MCP no Claude Code: conecte banco de dados e ferramentas | [Assistir](https://youtu.be/P47tkOD7fhA) | | **Aula 08** | Subagentes no Claude Code: divida tarefas e processe em paralelo | [Assistir](https://youtu.be/MylGZJdQEQM) | | **Aula 09** | Hooks no Claude Code: regras e bloqueios automáticos | [Assistir](https://youtu.be/V6auv_XtR2I) | | **Aula 10** | Plugins no Claude Code: organize e compartilhe seu setup | [Assistir](https://youtu.be/gMTes0g0fLk) | | **Aula 11** | O que avaliar antes de instalar plugins no Claude Code | [Assistir](https://youtu.be/g8OjDiT8Suc) | | **Aula 12** | Criando seu primeiro plugin no Claude Code passo a passo | [Assistir](https://youtu.be/r_FJG6u87sM) | | **Aula 13** | Publique seu plugin do Claude Code para todo o time | [Assistir](https://youtu.be/WhRx-6wZGXg) | | **Aula 14** | Claude Code no automático: revisão de código e rotinas na nuvem | [Assistir](https://youtu.be/79RnYWmiRSU) | Para continuar evoluindo na criação de agentes e sistemas em produção, confira também o [curso grátis Mastra sem mistério (agentes e workflows em TypeScript)](/blog/mastra-sem-misterio) e o [curso grátis de SurrealDB do zero com CRM](/blog/surrealdb-do-zero). ## Perguntas frequentes sobre o Claude Code ### O que é o Claude Code? O Claude Code é o agente oficial de programação no terminal da Anthropic. Ele lê todo o repositório local, edita arquivos, executa comandos no terminal, roda testes e cria commits no Git sob supervisão do desenvolvedor. ### O curso de Claude Code da Escola de Aplicativos é gratuito? Sim. As 15 aulas em vídeo (divididas em 3 módulos: Fundamentos, Ensinar o Claude e Plugins e Automação) são 100% gratuitas e podem ser assistidas em português na página `/cursos/claude-code-sem-misterio` ou no nosso canal do YouTube. ### Como instalar o Claude Code no Windows? Instale o Node.js (versão 18 ou superior) ou configure o WSL2 (Ubuntu no Windows) e execute o comando `npm install -g @anthropic-ai/claude-code` no terminal. Depois, basta entrar na pasta do projeto e digitar `claude`. ### Como instalar e usar skills no Claude Code? As skills ficam armazenadas como pastas contendo um arquivo `SKILL.md` (em `.claude/skills/` no projeto ou no diretório global do usuário) ou dentro de plugins instalados via `/plugin`. O Claude Code lê a descrição de cada skill e ativa suas instruções automaticamente quando você pede uma tarefa compatível.