Instalar o Claude Code e concluir a primeira execução segura
Guia atual de instalação, autenticação, gateway, primeira alteração segura e validação com Git.
Claude Code é o agente de programação da Anthropic para terminal e ambientes de desenvolvimento. Instale o cliente atual, abra um projeto Git pequeno, use default ou plan e confira toda primeira alteração com git diff.
Para um fluxo API pay-as-you-go separado com Claude Code, crie sua própria chave usando o guia BetterToken para Claude Code. BetterToken é acesso API Anthropic-compatible para Claude Code; não habilita Claude Chat ou Cowork e não substitui assinatura Claude.
O que preparar
Tenha terminal, um pequeno projeto Git que possa ser alterado e, de preferência, git status limpo. O login oficial exige conta Claude ou Console compatível; gateway é um caminho de provider separado. Não exponha chaves em código, capturas ou histórico do shell.
Native Install no macOS, Linux e WSL
Anthropic recomenda Native Install:
Isso instala somente o cliente; não faz login nem configura provider. Consulte os Docs atuais em vez de uma instrução npm antiga.
Windows: PowerShell, CMD e WSL
PowerShell:
CMD:
No Windows nativo, Git for Windows é recomendado para o Claude Code usar Bash. No WSL ele não é necessário: instale o cliente Linux e mantenha projetos no filesystem WSL quando possível.
Validar instalação e autenticação
Abra outro terminal:
Em seguida execute claude e conclua o login oficial no navegador. Use /login para trocar de conta. API Key não deve aparecer em prompt comum nem no repositório.
Configurar gateway de terceiros
Gateway exige API Key, Model ID suportado e Base URL correta. Com BetterToken, siga o guia atual e use https://bettertoken.ai como Base URL Anthropic-compatible. Não é a URL HTTP Messages bruta: o cliente acrescenta o caminho de protocolo. Após mudança, teste uma request pequena, sem alterar chave, modelo e URL juntos.
Primeiro projeto em leitura somente
Peça: “Explique estrutura, entry point e comando de início. Não altere arquivos nem execute comandos de rede.” Plan mode lê e explora, mas não edita fontes.
Primeira alteração reversível
Depois da aprovação:
Confira limite de arquivo, conteúdo, secrets e alterações inesperadas de configuração ou dependências.
Permissões e limites de segurança
default permite leituras e pede aprovação antes de editar ou executar comandos. plan pesquisa sem editar. acceptEdits aceita edições e operações comuns; auto é research preview com verificações de fundo. bypassPermissions é apenas para containers ou VM isolados. No primeiro uso, mantenha default ou plan.
Sinal de sucesso e validação API
O primeiro run está correto quando a pasta é a certa, login ou request do provider funciona, apenas o arquivo permitido muda e o diff é compreensível. Com BetterToken, confira modelo, status e tokens input/output/cache em Dashboard e usage history. Isso confirma a rota API, não direitos de Chat ou Cowork.
Diagnosticar por camada
Se claude não for encontrado, abra novo terminal e use o troubleshooting oficial, não npm antigo. Separe login Claude, Console/API e gateway. Em erro de provider, confira primeiro Key, depois Base URL e Model ID. Se Claude tentar editar demais, recuse, volte a Plan mode e restrinja a um arquivo, sem rede e sem commit.
Próximos passos e fontes
Depois de um README limpo, avance para teste ou correção pequena. Aumente escopo e autonomia um por vez: deploys, APIs e sistemas remotos não são reversíveis como arquivos locais.