FAQ do Claude Code

Respostas curtas, sem enchimento. O gasto típico fica à volta de $6 por dia. Cursor e Claude Code resolvem problemas diferentes. Skills são pastas de expertise reutilizável. O modo offline não existe. Tudo abaixo são perguntas que os builders fazem antes de se comprometer.

O Claude Code é gratuito?

A instalação é gratuita. Usá-lo não é. Precisas de uma chave API da Anthropic ou de uma subscrição Claude. A faturação da API é por token, e o gasto diário fica perto de $6 para trabalho de desenvolvimento típico, com 90% dos utilizadores abaixo de $12 por dia. Preferes preço fixo? O Claude Pro a $20/mês inclui Claude Code com limites de utilização. Os planos Max custam $100-200/mês para tetos mais altos e acesso ao Claude 4 Opus.

# Native installer (recommended) - no Node.js required
curl -fsSL https://claude.ai/install.sh | bash  # macOS/Linux
# Windows: irm https://claude.ai/install.ps1 | iex
 
claude  # Prompts for API key on first run

O guia do instalador nativo cobre a configuração com um único comando. O guia de instalação completo cobre todas as outras opções.

Que modelos usa o Claude Code?

A família Claude 4 alimenta tudo. Claude 4 Sonnet é o padrão diário: rápido, capaz, barato o suficiente para usar o dia todo. Claude 4 Opus pensa mais nas decisões arquiteturais mas é mais lento e custa mais.

Mudar é uma palavra de distância. Os aliases são sonnet, opus, haiku e opusplan. Este último é híbrido: Opus trata do plano, Sonnet trata da execução. Raciocínio forte onde importa, contas mais baixas em todo o resto.

# Use aliases for quick switching
claude --model sonnet
/model opus
 
# Hybrid mode: Opus plans, Sonnet executes
/model opusplan
 
# Set a permanent default in settings.json
# { "model": "claude-sonnet-4-20250514" }

Prioridade de modelo, da mais alta para a mais baixa: /model durante uma sessão > --model no arranque > variável de ambiente ANTHROPIC_MODEL > model em settings.json. Os sub-agentes têm o seu próprio controlo, CLAUDE_CODE_SUBAGENT_MODEL, se quiseres colocá-los num nível diferente.

Claude Code vs Cursor: qual é a diferença?

Duas ferramentas, dois trabalhos. Claude Code vive no terminal como um agente de IA. Lê toda a tua codebase, executa comandos e trata de alterações multi-ficheiro por conta própria. Cursor é um IDE focado em IA construído à volta de auto-completar em tempo real e sugestões inline. Em poucas palavras: Claude Code = IA conduz, tu supervisas. Cursor = tu conduzes, IA assiste. Muitos developers usam ambos ao mesmo tempo, Cursor para editar e Claude Code para raciocínio mais profundo e automação.

O que são as Claude Code Skills?

Skills são expertise que empacotas uma vez e reutilizas para sempre. Cada Skill é uma pasta com instruções, scripts e recursos, e o Claude carrega automaticamente a relevante quando o contexto o pede. Uma skill code-review, por exemplo, dá ao Claude os padrões da tua equipa de cada vez sem teres de os escrever. Skills pessoais ficam em ~/.claude/skills/. Skills de projeto ficam em .claude/skills/.

# Skills auto-load when relevant, or invoke manually
/skill security-review

O que é o CLAUDE.md e por que preciso dele?

As mensagens de chat desaparecem no final de uma sessão. O CLAUDE.md não. É um ficheiro de memória na raiz do teu projeto que carrega automaticamente em cada execução, dando ao Claude os detalhes da tua stack, convenções, estilo de código e os comandos que mais usas. Trata-o como um conjunto rígido de regras: o Claude segue o CLAUDE.md mais fielmente do que um prompt a meio de uma sessão. Mantém-no abaixo de 300 linhas.

# Auto-generate a starter CLAUDE.md
/init

Como gerir os custos da API?

Três hábitos reduzem a conta. Acompanha o teu uso real com ccusage. Usa Claude 4 Sonnet por padrão para trabalho de rotina e guarda Opus para o difícil. Ativa prompt caching sempre que repetes operações. O comando /compact comprime o contexto quando uma sessão fica longa. A trabalhar muito? Uma subscrição Max a $100-200/mês normalmente bate o pagamento por token.

# Check your usage
npx ccusage
 
# Compress context to save tokens
/compact

O Claude Code consegue escrever testes e fazer deploy de apps?

Testes, sim. O Claude escreve suites de testes unitários, de integração e end-to-end para Jest, Pytest, Vitest e outros. Deploy é a meio caminho: o Claude gera scripts, Dockerfiles e configs CI/CD, mas não faz push para produção por ti. Tudo é preparado. Tu escreves o último comando.

O Claude Code funciona offline?

Não. Cada chamada de IA vai para a API da Anthropic, por isso a rede tem de estar ativa. O teu código fica na tua máquina. Os teus prompts não. Planeia ter conectividade antes de depender do Claude Code num fluxo de trabalho de produção.

Como configuro o Claude Code para o meu projeto?

Dois sistemas, a correr lado a lado. Ficheiros CLAUDE.md dizem ao Claude o que fazer. Ficheiros settings.json dizem-lhe como operar: permissões, ferramentas, comportamento.

Para o lado "o que fazer", o CLAUDE.md na raiz do teu projeto carrega o contexto da codebase. Skills em .claude/skills/ empacotam fluxos de trabalho reutilizáveis. Slash commands em .claude/commands/ agrupam ações personalizadas. /init escreve um CLAUDE.md inicial se quiseres um gerado.

Para o lado "como operar", o settings.json corre numa hierarquia de 4 níveis: Managed (implantado por TI, prioridade máxima), Local (.claude/settings.local.json, pessoal para este repositório), Project (.claude/settings.json, partilhado com a equipa) e User (~/.claude/settings.json, os teus padrões globais). Níveis mais estreitos sobrepõem-se aos mais amplos, por isso os padrões da equipa vão em Project e os teus ajustes privados vão em Local.

# Initialize CLAUDE.md
/init
 
# Add $schema for autocomplete in your editor
# Then edit .claude/settings.json

O que é que o Claude Code consegue realmente fazer?

Muita coisa. Constrói apps completas do zero, refatora em centenas de ficheiros, depura lendo logs e rastreando caminhos de código, escreve suites de testes completas, conduz o git e executa comandos de terminal. A janela de contexto de 200K tokens significa que se lembra de toda a conversa e da estrutura da codebase em que estás a trabalhar. Ao contrário de um chatbot que esquece o turno anterior, o Claude Code mantém o projeto completo em vista.

Como corrijo erros "command not found"?

Normalmente é o PATH. O instalador não configurou o claude no teu shell. O instalador nativo trata disto automaticamente, por isso reinstalar resolve na maioria das vezes.

# Recommended: use native installer
curl -fsSL https://claude.ai/install.sh | bash  # macOS/Linux
# Windows PowerShell: irm https://claude.ai/install.ps1 | iex
 
# Restart terminal, then verify:
claude --version

Preciso de experiência em programação?

Não obrigatoriamente. Claude Code narra o que está a fazer, sugere o próximo passo e ensina enquanto avança. Fundadores sem conhecimentos técnicos já entregaram MVPs completos usando inglês simples. Alguma familiaridade com o terminal ainda ajuda. Saber como usar cd e executar um comando é o mínimo.

Como é que o Claude Code trata a privacidade?

Cada prompt vai para a API da Anthropic para processamento. É a natureza da ferramenta. A Anthropic afirma que não treina modelos com dados da API. Para codebases sensíveis, a documentação de segurança é o ponto de partida certo, e acordos empresariais podem acrescentar garantias contratuais por cima. O teu código fica na tua máquina. Só o que partilhas ativamente acaba na chamada da API.