Suporte nativo do Claude Code para Windows: um extenso guia de instalação e configuração

Claude Code Como um produto de Anthropic A empresa lançou um auxiliar de programação de IA de linha de comando que pode interagir com o código do projeto diretamente em um ambiente de terminal, ajudando os desenvolvedores a concluir tarefas como geração de código, interpretação lógica e solução de problemas de erros. Em 1.0.51 Após a atualização da versão, oClaude Code finalmente Windows traz suporte nativo, o que significa que Windows Os usuários não precisam mais passar pelo processo de WSL (Windows Subsystem for Linux) para uma configuração tediosa, evitando assim possíveis sobrecargas de desempenho e problemas de compatibilidade do sistema de arquivos.

Requisitos ambientais

Antes de instalar, verifique se o sistema atende às seguintes condições:

• sistema operacional
  • Windows. Windows 10 ou posterior
  • macOS. macOS 10.15 ou posterior
  • Linux. Ubuntu 20.04+ / Debian 10+ ou distribuições compatíveis
• Ferramentas comuns
  • Node.js. Versão para maiores de 18 anos (endereço para download)
  • Git. Versão 2.23+ (endereço para download)

Instalação e configuração

A instalação varia um pouco de plataforma para plataforma, e as etapas a seguir são as seguintes.

Mac e Linux

existir macOS talvez Linux No sistema, abra um terminal e execute o seguinte comando de instalação global:

npm install -g @anthropic-ai/claude-code

Quando a instalação estiver concluída, você precisará configurar as variáveis de ambiente para autorização. Edite o diretório do usuário do .zshrc (Zsh) ou .bashrc (Bash), adicione o seguinte:

export ANTHROPIC_API_KEY="sk-..."
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

chamar a atenção para algo: Em macOS Você pode usar o atalho Command+Shift+. para exibir os arquivos ocultos e, em seguida, use um editor de texto para abrir o arquivo .zshrc Documentação.

Depois de adicionar a configuração, execute o comando source ~/.zshrc para que as alterações tenham efeito imediato.

Configuração nativa do Windows

Windows Dependências de suporte nativo da plataforma Git for Windows O conjunto de ferramentas de linha de comando Unix fornecido.

1. Instalação do Git para Windows
   acesse gitforwindows.org Faça o download e instale a versão mais recente. O instalador configurará automaticamente o grepecurlessh e outras ordens necessárias.
2. Definição de políticas de aplicação
   Abrir no modo de administrador PowerShellExecute o seguinte comando para permitir npm Execute o script de instalação:

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

3. Código global de instalação do Claude
   existir PowerShell Execute o seguinte comando para instalá-lo:

   npm install -g @anthropic-ai/claude-code@latest
   

   Se você encontrar erros relacionados à execução do script durante a instalação, tente usar o --ignore-scripts para resolver:

   npm install -g @anthropic-ai/claude-code --ignore-scripts
   

4. Configuração de variáveis de ambiente
   show (um ingresso) PowerShell e execute o seguinte comando para definir a variável de ambiente, defina a variável sk-... Substitua seu API Chave.

   [System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-...", "User")
   [System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.anthropic.com", "User")
   

   Após a conclusão da configuração, você precisa reiniciar o PowerShell Terminal para ativar as variáveis de ambiente.

Primeira inicialização e uso

Depois de concluir a instalação e a configuração, você estará pronto para começar.

1. kit inicial
   No terminal, vá para a pasta do projeto e execute claude Comando.

   cd ~/Desktop/my-project
   claude
   

2. Verificar a configuração
   Você sempre pode executar claude doctor para verificar o Claude Code Ele listará as informações detectadas no momento API chaves e Base URL.
3. Autorização de conta
   Na primeira inicialização, se você não usar a opção personalizada API a ferramenta pode abrir uma página de autorização em seu navegador, exigindo que você faça login no Claude Site oficial para confirmação.

   Quando a ferramenta detecta que você configurou o API Quando a chave for usada, você será solicitado a usar a chave ou não; selecione "Yes" (Sim) para fazer isso.

   Se você estiver usando um serviço de proxy de terceiros e quiser ignorar o processo de autenticação de login oficial, poderá adicionar um novo proxy ao diretório inicial do usuário no diretório .claude.json Adicione o seguinte ao arquivo:

   {
   "hasCompletedOnboarding": true
   }