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 você executar sua primeira ferramenta web, você começou oficialmente.
- Encontrando Erros: Tire um print e envie para o Claude Code ou Doubao. Descreva "em qual etapa estou e qual erro vejo". Isso é 10x 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 você 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 (Pode falar, mas não pode fazer)3Agente = Cérebro + Mãos/Pés + Caixa de Ferramentas (Pode falar e fazer)
- 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 sozinho.
- Agente: Você diz "me ajude a construir 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 vastamente diferentes. O mesmo modelo Claude é apenas um chat no navegador, mas no Claude Code, ele pode escrever código sozinho.
1.2 Token, Contexto, Jaula
- 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ó pode se referir ao que está em sua "mesa".
- Janela de Contexto: O tamanho da "mesa" de cada modelo. Em 2026, modelos populares atingiram 1 milhão de Tokens (cerca de 700k-800k palavras).
- Poluição de Contexto: Conversar sobre coisas diferentes em uma janela deixa a IA confusa. Uma janela para uma tarefa; abra uma nova janela para um novo tópico.
- Jaula / 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. Claude Code é ótimo porque sua Jaula é a mais madura.
1.3 O que é uma Skill?
Uma Skill é um Manual de SOP para o Claude.
Os Big Macs do McDonald's têm o mesmo gosto globalmente não porque cada loja tem um chef mestre, mas porque cada loja tem um SOP. Uma Skill é este 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 nacionais + cc-switch para alternância 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 um alto-falante, e o computador ganha a capacidade de "tocar música".
- MCP permite conectar ferramentas ao Claude Code; conecte Tavily, e ele ganha a capacidade de "pesquisar tendências em tempo real"; conecte 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 Multimodal — 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ó pode processar texto.
- Multimodal: Pode processar texto, imagens, áudio, vídeo, arquivos e telas simultaneamente.
Suporte de modelos populares em 2026:
Entrada ≠ Saída
IA ser capaz de "ver" uma modalidade não significa que pode "gerá-la".
- Imagens: Quase todos os modelos populares podem ver imagens; só alguns podem desenhá-las (GPT Image, Gemini, Doubao Seedance, Jimeng, Nano Banana, etc.).
- Vídeo: Gemini, Doubao e Kimi podem assistir vídeo; mas os LLMs não fazem 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 prints, gravações e vídeos diretamente na IA para aumentar a eficiência.
1.8 Cenário das Ferramentas de IA (Quem é Quem)
Um mapa para esclarecer a confusão sobre diferentes ferramentas.
Ferramentas de Agente (Te ajudam 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, fácil de usar)
│ ├── 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ônomo (Roda em segundo plano)
│ ├── OpenClaw —— Antigo 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)
└── COZE —— Da ByteDance, fluxos de trabalho 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)
│
└── Nacional
├── Doubao (ByteDance)
├── DeepSeek (Alto custo-benefício)
├── Qwen (Alibaba)
├── Kimi (Moonshot AI)
├── WeChat Yuanbao (Tencent, forte ecossistema de dados do 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 ↕ Chama5Modelo (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 a permissão for 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 Claude Code com Modelos Nacionais
Claude Code é o invólucro; ele precisa de um modelo (cérebro). Os modelos oficiais do Claude exigem cartão de crédito internacional e correm risco de banimento. A solução mais realista para usuários nacionais é usar 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 Gitee Mirror.
3.3 Obtenha a Chave da API (Exemplo: MiniMax)
- Cadastre-se na Plataforma MiniMax.
- Compre um Plano de Codificação.
- Copie a Chave do Plano de Codificação (não a Chave da API normal).
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 Planejar é crucial — Claude pensa nos passos antes de agir. Use-o para funcionalidades complexas.
4.4 Pensamento Normal vs. 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 aplicativo HTML/JS que gera animais emoji quando o volume do microfone excede 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 modelos.
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 da APImart para criar uma skill que gera 3 ilustrações em estilo desenhado à mão 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
Primeiro entre na estrada, depois fale sobre habilidades de direção. Comece pelos Capítulos 2-5. IA é um multiplicador de produtividade de 10x a 100x. Comece hoje.
