Comece do zero, instale o Claude Code — que entende linguagem natural, escreve código e funciona automaticamente — no seu computador e use-o para criar seu primeiro produto funcional.
Primeiros Passos
- Iniciantes Completos: Siga os Capítulos 1 a 5 em ordem. Assim que rodar sua primeira ferramenta web, você já começou oficialmente.
- Encontrando Erros: Tire uma captura de tela e entregue ao Claude Code ou ao Doubao. Descreva "em que etapa estou e qual erro vejo". Isso é 10 vezes mais eficiente do que pesquisar no Google por conta própria.
Capítulo 1: Dominando Conceitos Básicos
Se você não consegue entender lives ou manuais, geralmente não é porque não é inteligente, mas porque os termos não estão conectados. Este capítulo explica as palavras que aparecerão repetidamente.
1.1 Três Conceitos Centrais
1Modelo = Cérebro (Só pensa, não tem mãos nem pés)2Chatbot = Cérebro + Boca (Fala, mas não age)3Agente = Cérebro + Mãos/Pés + Caixa de Ferramentas (Fala e age)
- Modelo: GPT, Claude, Gemini, DeepSeek, Doubao, Qwen, Kimi, GLM, MiniMax... esses são modelos, o "cérebro".
- Chatbot: Web do ChatGPT, App do Doubao, caixa de diálogo do DeepSeek. Você pergunta, ele responde, mas você tem que fazer o trabalho.
- Agente: Você diz "me ajude a criar um site", e ele cria pastas, escreve código, executa e depura no seu computador, finalmente te dizendo "está pronto". Claude Code é um Agente.
O mesmo modelo em ferramentas diferentes tem capacidades muito distintas. O mesmo modelo Claude é apenas um chat no navegador, mas no Claude Code, ele pode escrever código sozinho.
1.2 Token, Contexto e Capacidade (Harness)
- Token: A menor unidade que a IA usa para entender texto. 1 caractere chinês tem cerca de 1-2 Tokens; 1 palavra em inglês tem cerca de 1 Token. Tokens são sua "conta de luz". Não economize Tokens durante a fase de aprendizado.
- Contexto: Tudo nesta rodada de conversa. A IA não tem memória de longo prazo; ela só consegue se referir ao que está em sua "mesa".
- Janela de Contexto: O tamanho da "mesa" de cada modelo. Em 2026, os modelos principais atingiram 1 milhão de Tokens (cerca de 700k-800k palavras).
- Poluição de Contexto: Conversar sobre assuntos diferentes em uma mesma janela deixa a IA confusa. Uma janela para uma tarefa; abra uma nova janela para um novo tópico.
- Capacidade (Harness) / Engenharia de Contexto: Não é um software, mas um conjunto de métodos para dominar a IA — como organizar informações, gerenciar contexto, guiar a IA e verificar resultados. O Claude Code é ótimo porque sua Capacidade (Harness) é a mais madura.
1.3 O que é uma Skill (Habilidade)?
Uma Skill é um Manual de SOP (Procedimento Operacional Padrão) para o Claude.
O Big Mac do McDonald's tem o mesmo gosto globalmente não porque cada loja tem um chef mestre, mas porque cada loja tem um SOP. Uma Skill é esse SOP para o Claude — definindo "o que fazer primeiro, o que fazer depois, quais ferramentas usar e o que conta como sucesso."
- Escreva uma vez, chame repetidamente.
- Escrever seu próprio SOP é como "ensinar" sua experiência de trabalho ao Claude; ele se torna seu "funcionário virtual."
1.4 Três Métodos de Pagamento
A solução mais realista: Use APIs de modelos domésticos + cc-switch para alternar com um clique. Detalhado no Capítulo 3.
1.5 Ferramentas Auxiliares para Conhecer Antes da Instalação
1.6 MCP — O "Padrão de Tomada" para Agentes
MCP significa Model Context Protocol.
Pense nisso como um padrão de tomada — permitindo que Agentes se conectem a várias ferramentas externas e fontes de dados (Feishu, bancos de dados, navegadores, Xiaohongshu, WeChat, etc.).
Analogia:
- Uma porta USB permite conectar periféricos ao seu computador; conecte uma caixa de som, e o computador ganha a capacidade de "tocar música".
- O MCP permite conectar ferramentas ao Claude Code; conecte o Tavily, e ele ganha a capacidade de "pesquisar tendências em tempo real"; conecte o xiaohongshu-mcp, e ele pode "postar no Xiaohongshu."
Por padrão, o Claude Code só processa informações que você dá a ele e não vai pesquisar ativamente na internet. Você precisa do MCP para pesquisar, ler bancos de dados ou chamar APIs externas.
1.7 Multimodalidade — A IA Faz Mais do Que "Ler Texto"
Modalidade é o tipo de informação. Texto é uma modalidade; imagens, som e vídeo são outras.
- Unimodal: Só consegue processar texto.
- Multimodal: Consegue processar texto, imagens, áudio, vídeo, arquivos e telas simultaneamente.
Suporte de modelos mainstream em 2026:
Entrada ≠ Saída
A IA "ver" uma modalidade não significa que ela pode "gerá-la".
- Imagens: Quase todos os modelos mainstream conseguem ver imagens; só alguns conseguem desenhá-las (GPT Image, Gemini, Doubao Seedance, Jimeng, Nano Banana, etc.).
- Vídeo: Gemini, Doubao e Kimi conseguem assistir vídeo; mas os LLMs não criam vídeo diretamente; eles usam ferramentas especializadas (Wan, Seaweed Dance, Jimeng).
Pontos Fortes dos Modelos:
Conselho prático para iniciantes: Não digite só texto; aprenda a jogar capturas de tela, gravações e vídeos diretamente na IA para aumentar a eficiência.
1.8 Panorama das Ferramentas de IA (Quem é Quem)
Um mapa para esclarecer a confusão sobre as diferentes ferramentas.
Ferramentas de Agente (Ajudam você a trabalhar)
``text
Ferramentas de Agente
├── Linha de Comando (Baseado em terminal, mais poderoso)
│ ├── Claude Code —— Da Anthropic, atualmente o mais forte, a estrela deste guia
│ └── Codex CLI —— Da OpenAI, código aberto
│
├── GUI (Interface visual, amigável)
│ ├── Codex Desktop/Web —— Da OpenAI
│ ├── Claude Cowork —— Da Anthropic, para usuários não técnicos
│ ├── Trae Solo —— Da ByteDance, nacional, tem modos Code e MTC
│ ├── WorkBuddy —— Da Tencent, nacional, para trabalho de escritório não dev
│ └── Kiro —— Da AWS, IDE orientada a especificações (fork do VS Code)
│
├── Autônomos (Rodam em segundo plano)
│ ├── OpenClaw —— Anteriormente Clawdbot, código aberto, controle remoto via WeChat/TG
│ └── Hermes —— Da Nous Research, código aberto, memória persistente
│
└── Orquestração de Fluxo de Trabalho (Automação em blocos de montar)
└── COZE —— Da ByteDance, fluxos de trabalho de arrastar e soltar
``
Ferramentas de Chatbot (Conversam com você)
``text
Chatbot
├── Exterior
│ ├── ChatGPT (Modelo GPT)
│ ├── Claude.ai (Modelo Claude)
│ ├── Gemini (Modelo Google)
│ └── Grok (xAI/Elon Musk, para tarefas relacionadas ao X)
│
└── Nacionais
├── Doubao (ByteDance)
├── DeepSeek (Alto custo-benefício)
├── Qwen (Alibaba)
├── Kimi (Moonshot AI)
├── WeChat Yuanbao (Tencent, fortes dados do ecossistema WeChat)
└── GLM / Zhipu Qingyan (Zhipu AI)
``
"Jargões" Comuns em Comentários:
1.9 Resumo em Uma Frase do Relacionamento
1Você (Humano)2 ↕ Linguagem Natural3Claude Code (Agente) —— Conecta-se a ferramentas externas via MCP4 ↕ Chamadas5Modelo (Claude / GLM / MiniMax / Kimi…)6 ↕ Consome7Token (Conta de luz)
Capítulo 2: Configurando o Ambiente
Instale 4 coisas em ordem: Git → Node.js → VS Code → Claude Code.
2.1 Confirme o Tipo de Chip
- Mac: Ícone da Apple -> Sobre Este Mac. M1/M2/M3/M4 é ARM; Intel é x86_64.
- Windows: Clique com o botão direito em "Este Computador" -> Propriedades. Intel/AMD é x86_64.
2.2 Instale o Git
- Mac: Abra o Terminal, cole:
/bin/zsh -c "$(curl -fsSL https://gitee.com/happyaicoder/HomebrewCN/raw/master/Homebrew.sh)". Verifique comgit --version. - Windows: Baixe de https://git-scm.com/https://git-scm.com/). Use as configurações padrão.
2.3 Instale o Node.js (18+, 20 ou 22 recomendado)
- Mac: Cole:
/bin/bash -c "$(curl -fsSL https://gitee.com/iamzhihuix/nvm-install-cn/raw/main/install.sh)". Verifique comnode -v. - Windows: Baixe o LTS de https://nodejs.org/https://nodejs.org/). Se
npm -vfalhar no PowerShell, execute:Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.
2.4 Instale o VS Code
Baixe de https://code.visualstudio.com/https://code.visualstudio.com/). No Windows, marque as opções "Adicionar ao PATH" e "Abrir com Code".
2.5 Instale o Claude Code
- Mac:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. Usesudose houver permissão negada. - Windows: Execute o PowerShell como Administrador, depois:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com.
2.6 Solução de Problemas Comuns
Capítulo 3: Configurando o Claude Code com Modelos Nacionais
O Claude Code é o invólucro; ele precisa de um modelo (cérebro). Os modelos oficiais Claude requerem cartão de crédito internacional e correm risco de banimento. A solução mais realista para usuários nacionais é usar o cc-switch com modelos nacionais.
3.1 Escolha um Modelo
Recomendação para Iniciantes: MiniMax Coding Plan (29 RMB/mês).
3.2 Instale o cc-switch
Baixe do GitHub ou Espelho Gitee.
3.3 Obtenha a Chave da API (Exemplo: MiniMax)
- Registre-se na Plataforma MiniMax.
- Compre um Plano de Codificação (Coding Plan).
- Copie a Chave do Plano de Codificação (não a Chave da API regular).
3.4 Configure no cc-switch
- Abra o cc-switch, clique no ícone do Claude.
- Clique em +, selecione o provedor (ex: MiniMax), cole a Chave e clique em Adicionar.
- Passe o mouse sobre o modelo e clique em "Ativar".
3.5 Verifique
No terminal, digite claude. Pergunte: "Qual modelo você é?" Se ele responder MiniMax/GLM, está configurado.
Capítulo 4: Operações Básicas do Claude Code
4.1 Duas Maneiras de Iniciar
- Terminal: Abra uma pasta no VS Code, abra o terminal, digite
claude. - Plugin: Instale a extensão "Claude Code" da Anthropic no VS Code.
4.2 Atalhos Essenciais
4.3 Três Modos de Trabalho
O modo Plano é crucial — Claude pensa nos passos antes de agir. Use-o para funcionalidades complexas.
4.4 Pensamento Normal vs. Pensamento Profundo (ultrathink)
4.5 Modo YOLO (Mãos Livres)
Pula os prompts de permissão para cada alteração de arquivo. Use: claude --dangerously-skip-permissions.
4.6 CLAUDE.md para Preferências
Escreva suas preferências em um arquivo CLAUDE.md na raiz do seu projeto (ex: "Use português para comentários").
Capítulo 5: Construindo uma "Ferramenta de Leitura Antecipada"
5.1 Crie o Diretório e o PRD
Crie prd.md no VS Code com os requisitos para um app HTML/JS que gera animais emoji quando o volume do microfone ultrapassa um limite.
5.2 Implementação
No terminal, execute claude --dangerously-skip-permissions e digite: @prd.md implemente esta funcionalidade.
5.3 Resultado
Abra index.html em um navegador, permita o acesso ao microfone e fale para ver os animais aparecerem.
Capítulo 6: Dominando Habilidades de Fluxo de Trabalho
Skills são SOPs reutilizáveis. Uma Skill inclui um SKILL.md (configuração), scripts e templates.
6.2 Usando npx skills
Instale skills com um comando: npx skills add jimliu/baoyu-skills. Selecione a skill e o alvo (Claude Code).
6.3 Repositórios de Skills
6.5 Criando uma Skill Personalizada: Auto-Ilustração
Use a API Nano Banana 2 do APImart para criar uma skill que gera 3 ilustrações em estilo à mão livre para qualquer artigo que você escrever.
6.6 Skill vs MCP vs Hooks vs Plugin
- Skill: Receita (Passos para o chef).
- MCP: Utilidades (Água/Eletricidade/Gás para a cozinha).
Capítulo 7: Hardware e Rede
- Mac é melhor para IA devido à memória unificada, mas Windows funciona bem.
- Use o modo TUN no seu proxy (ex: clash.verge) se encontrar erros de rede com MCP ou geração de imagens.
Apêndice A: Folha de Dicas de Comandos
claude, /skills list, /clear, /compact, /doctor, /model.
Apêndice B: Erros Comuns
Apêndice C: Terminologia
Palavras Finais
Entre na estrada primeiro, depois fale sobre técnicas de direção. Comece com os Capítulos 2-5. A IA é um multiplicador de produtividade de 10x a 100x. Comece hoje.
