Perguntas frequentes do Claude Code

Pergunta

Resposta

1.1 Como faço para instalá-lo?

macOS/Linux: curl -fsSL https://claude.ai/install.sh | bash
​Windows PowerShell: irm https://claude.ai/install.ps1 | iex
​Homebrew: brew install --cask claude-code
​WinGet: winget install Anthropic.ClaudeCode
Em seguida, execute claude de qualquer repositório.

Referência: Guia de início rápido

1.2 Instalado, mas "claude: comando não encontrado"

O instalador nativo coloca o binário em ~/.local/bin/claude (Windows: %USERPROFILE%\.local\bin). Adicione esse diretório ao seu PATH, por exemplo export PATH="$PATH:$HOME/.local/bin" em ~/.zshrc ou ~/.bashrc, depois reinicie seu terminal.

Referência: Solução de problemas: PATH

1.3 O login abre um navegador na máquina errada / Estou em SSH

Pressione c no prompt de login para copiar a URL de autenticação. Abra-a em um navegador local e cole o código de volta no terminal.

Referência: Solução de problemas: autenticação

1.4 Erros de autenticação logo após o login, mas tenho acesso

400 "organização desabilitada": uma variável de ambiente ANTHROPIC_API_KEY perdida está substituindo seu login. Desative-a, remova do seu perfil de shell e reinicie. Execute /status para confirmar qual autenticação está ativa.
​403 Proibido: seu administrador ainda não habilitou o Claude Code para seu workspace, ou um proxy corporativo está interferindo.

Referência: Solução de problemas: autenticação

1.5 O Claude Code está incluído no meu plano?

Sim. Está incluído com assentos Team e Enterprise e com acesso ao Console (API). Faça login com sua conta de trabalho; SSO é tratado automaticamente. Um erro 403 após o login geralmente significa que seu administrador ainda precisa habilitá-lo para o workspace.

Referência: Autenticação

1.6 Claude Code vs. aplicativo desktop vs. claude.ai?

Claude Code: agente de terminal que lê seu repositório, edita arquivos, executa comandos.
​Desktop / claude.ai: interfaces de chat para conversas e perguntas pontuais.
Mesma família de modelos, forma diferente de ferramenta.

Referência: Visão geral

1.7 Funciona na minha IDE?

Sim. Extensões estão disponíveis para VS Code e IDEs JetBrains (IntelliJ, PyCharm, etc.). Mesmos recursos, incorporados no editor em vez de um terminal separado.

Referência: VS Code · JetBrains

1.8 Como isso é diferente do Copilot/Cursor autocomplete?

O autocomplete sugere as próximas linhas. Claude Code é um agente: dê a ele uma tarefa ("corrigir os testes com falha") e ele lê arquivos, executa comandos e faz edições em múltiplos arquivos até terminar. Menos "complete minha frase", mais "aqui está um problema, vá trabalhar nele".

Referência: Visão geral

1.9 O que devo tentar primeiro?

Aponte para um bug tedioso mas não difícil que você vem adiando. Exemplo: "o teste em [arquivo] é instável, descubra por quê." Deixe-o ler o código em vez de você explicar o código.

Referência: Casos de uso comuns

1.10 Como faço para atualizá-lo?

Instalações nativas são atualizadas automaticamente em segundo plano. Para forçar uma agora, execute claude update.
Homebrew/WinGet não são atualizados automaticamente: execute brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode periodicamente.

Referência: Configuração: atualizações

Pergunta

Resposta

2.1 Ele continua pedindo permissão para os mesmos comandos

As aprovações duram a sessão atual por padrão. Para torná-las persistentes:
• Escolha "sempre permitir" no prompt
• Adicione o padrão a permissions.allow em .claude/settings.json
• Ou execute /permissions para gerenciar interativamente

Referência: Permissões

2.2 Modos de permissão e como alternar

Pressione Shift+Tab para alternar modos:

Referência: Modos de permissão

2.3 O que é /init e quando devo executá-lo?

Execute uma vez, no início, em qualquer repositório em que você trabalhará mais de uma vez. Ele verifica o projeto e escreve CLAUDE.md com comandos de compilação, arquitetura e convenções. Cada sessão futura o carrega automaticamente, para que Claude comece com contexto.

Referência: Memória e CLAUDE.md

2.4 O que vai em CLAUDE.md?

Coisas que as ferramentas não conseguem impor e que um novo colega erraria no primeiro dia: "implante a partir de release, não de main", "todos os IDs são strings", "nunca chame o banco de dados diretamente de um manipulador de rota". Mantenha em menos de duas telas; mais do que isso fica superficial.

Referência: Memória e CLAUDE.md

2.5 Claude não está seguindo meu CLAUDE.md

• Muito longo ou muito vago: reduza às regras que realmente importam
• Enterrado em prosa: coloque regras rígidas no topo, use linguagem imperativa ("Nunca X. Sempre Y.")

Referência: Melhores práticas

2.6 Aponte para um arquivo específico sem colá-lo

Digite @ seguido do caminho (preenchimento com tabulação). O arquivo mencionado é lido antes de Claude responder.

Referência: Fluxos de trabalho comuns

2.7 Cole uma captura de tela no prompt

Arraste a imagem para o terminal ou pressione Ctrl+V. No Mac é Ctrl, não Cmd (Cmd+V cola texto). Funciona para diálogos de erro, mockups de UI, fotos de quadro branco.

Referência: Trabalhando com imagens

2.8 Copie a resposta de Claude do terminal

/copy coloca a última resposta na sua área de transferência. /export escreve toda a conversa em um arquivo.

2.9 Recupere uma sessão anterior

claude --continue retoma a mais recente. claude --resume abre uma lista para escolher. As sessões são armazenadas localmente por diretório de projeto.

Referência: Fluxos de trabalho comuns: retomar

2.10 Trocar modelos

/model abre o seletor. Defina um padrão em .claude/settings.json se quiser o mesmo modelo em cada sessão.

Referência: Configuração de modelo

2.11 Pensamento estendido

Ativado por padrão. O raciocínio em si fica oculto na visualização normal; pressione Ctrl+O para alternar para a transcrição detalhada se quiser lê-lo. Use /effort para aumentar ou diminuir a profundidade. Vale a latência extra para depuração complicada ou decisões de arquitetura.

Referência: Pensamento estendido

2.12 Interrompa no meio da tarefa

Pressione Ctrl+C para cancelar a geração atual, depois diga o que fazer em vez disso. Sem necessidade de reiniciar a conversa.

Pergunta

Resposta

3.1 O que é MCP?

MCP conecta Claude Code às suas ferramentas externas: GitHub, Linear, Slack, seu banco de dados, sua pilha de observabilidade. Uma configuração .mcp.json e Claude pode ler seus problemas, consultar seus dados e trabalhar com as mesmas ferramentas que você. Primeiro conector comum: seu rastreador de problemas.

Referência: MCP

3.2 Configure seu primeiro servidor MCP

• Adicione um .mcp.json na raiz do projeto ou use claude mcp add
• Cada entrada nomeia um pacote de servidor mais quaisquer variáveis de ambiente (geralmente um token de autenticação)
• Reinicie Claude Code e execute /mcp para confirmar que está conectado

Referência: Configuração de MCP

3.3 Para que servem os hooks?

Scripts de shell que são acionados em eventos (antes de uma ferramenta ser executada, após uma edição de arquivo, quando Claude está esperando por você). Primeiro hook comum: um hook de Notificação que avisa sua área de trabalho quando Claude precisa de entrada. O mesmo mecanismo pode executar seu linter após cada edição, postar no Slack ou bloquear edições em caminhos protegidos.

Referência: Guia de hooks

3.4 Crie um prompt/habilidade reutilizável

Crie .claude/skills/ship/SKILL.md e o nome da pasta se torna o comando: /ship. Inglês simples, sem sintaxe especial. Caminho mais fácil: peça a Claude para escrever para você. (O caminho legado .claude/commands/ship.md ainda funciona.)

Referência: Habilidades

3.5 Habilidades vs. comandos legados

Mesmo mecanismo; comandos foram mesclados em habilidades. .claude/commands/foo.md e .claude/skills/foo/SKILL.md ambos criam /foo. A forma de habilidade é preferida e oferece uma pasta para arquivos de suporte (documentos de referência, modelos, scripts auxiliares).

Referência: Habilidades

3.6 Para que servem os subagendes?

Trabalho paralelo: pesquise diferentes partes da base de código, revise um diff em dimensões separadas ou gere implementações concorrentes ao mesmo tempo. A sessão principal agrega os resultados.

Referência: Subagendes

3.7 Executar de forma não interativa (CI / scripts)

claude -p "seu prompt" executa uma vez e imprime o resultado. Bom para hooks de CI, verificações de pré-commit ou redirecionamento para outras ferramentas. Autenticação via sua sessão conectada ou ANTHROPIC_API_KEY.

Referência: Uso no estilo Unix

3.8 Desfazer o que foi feito

/rewind reverte para um ponto de verificação anterior. Os pontos de verificação são criados automaticamente a cada prompt que você envia. Para qualquer coisa já confirmada, use um git revert normal.

Referência: Pontos de verificação

3.9 Compartilhe sua configuração com o time

Verifique .claude/ no repositório (CLAUDE.md, comandos, configuração MCP). Qualquer pessoa que clonar o repositório obtém a mesma configuração automaticamente. As habilidades também podem ser empacotadas como um plugin que os times instalam via /plugin.

Referência: Plugins

Pergunta

Resposta

4.1 Não consegue encontrar arquivos / a busca não retorna nada

Claude Code é fornecido com uma cópia integrada do ripgrep, portanto você não precisa instalá-lo. O binário integrado pode falhar em sistemas Alpine/musl; nesse caso, instale uma cópia do sistema (apk add ripgrep) e defina USE_BUILTIN_RIPGREP=0 para que Claude a use.

Referência: Solução de problemas: busca

4.2 Copiar/colar e rolagem quebrados via SSH ou em tmux

A interface do terminal captura eventos do mouse. Mantenha Shift pressionado ao selecionar para contorná-lo, ou configure tmux para passar eventos do mouse. /copy e /export contornam o problema completamente.

4.3 Lento no WSL

Ler arquivos do Windows através de /mnt/c/ é uma penalidade conhecida. Mova o repositório para o sistema de arquivos WSL (~/ em vez de /mnt/c/...). A diferença de velocidade é dramática.

Referência: Solução de problemas: WSL

4.4 Colar imagem não está funcionando no Mac

Use Ctrl+V, não Cmd+V. Cmd+V cola texto; Ctrl+V é o caminho para imagem da área de transferência.

4.5 A regra de permissão com curinga não corresponde

Construa regras incrementalmente: aprove comandos interativamente primeiro, verifique o que foi escrito nas configurações, depois generalize.

Referência: Padrões de permissões

4.6 O modo não interativo -p se comporta diferentemente

Para execuções não interativas/CI, prefira autenticação por chave de API e servidores MCP configurados com tokens de variáveis de ambiente.

4.7 Ficou sem contexto no meio da tarefa

/compact resume a conversa anterior para liberar espaço. /clear começa do zero mantendo CLAUDE.md e configurações carregadas. Para tarefas longas, divida em etapas com um /clear entre fases.

Referência: Gerenciando contexto

Pergunta

Resposta

5.1 A Anthropic treina com meu código?

Não. Sob os termos de Team/Enterprise da sua organização, seu código e conversas não são usados para treinar modelos.

Referência: Uso de dados

5.2 Para onde meu código realmente vai?

Claude Code é executado em sua máquina. Os arquivos de origem são lidos localmente, e apenas as porções necessárias para a tarefa atual são enviadas à API para gerar uma resposta. Nada é indexado, carregado como um repositório inteiro ou usado para treinamento.

Referência: Uso de dados

5.3 Alguém mais pode ver minhas conversas?

Não. As sessões são armazenadas localmente em sua máquina, por diretório de projeto, e não são compartilhadas com colegas de time ou visíveis em nenhum painel. Use /export se você quiser compartilhar uma conversa.

Referência: Uso de dados

5.4 Como mantenho segredos e arquivos .env fora da conversa?

Claude lê apenas os arquivos que precisa para a tarefa; não verifica todo o seu repositório. Para bloquear especificamente arquivos, adicione uma regra de negação de leitura em .claude/settings.json (por exemplo, "Read(.env*)"). Arquivos negados não podem ser lidos mesmo se você acidentalmente pedir por eles.

Referência: Permissões

5.5 O que o modo "acceptEdits" pode fazer sem me perguntar?

As edições de arquivo passam sem um aviso. Ainda assim, ele pergunta antes de executar comandos shell, fazer chamadas de rede ou tocar em qualquer coisa fora do seu diretório de trabalho. Para um controle mais rigoroso, mantenha o modo padrão.

Referência: Permissões

Recurso

Para que serve

/help

Comando integrado que lista o que está disponível na sua sessão

/feedback

Registre um problema no terminal (alias para /bug)

Documentação completa

Tudo aqui, em detalhes

Canal #claude-code da sua equipe

Pequenas vitórias e erros estranhos têm lugar lá

Página

Link

Guia de início rápido

code.claude.com/docs/en/quickstart

Solução de problemas

code.claude.com/docs/en/troubleshooting

Permissões

code.claude.com/docs/en/permissions

Memória e CLAUDE.md

code.claude.com/docs/en/memory

MCP

code.claude.com/docs/en/mcp

Uso de dados

code.claude.com/docs/en/data-usage