[BUG]
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
Relatório de Problemas - Claude Code Windows
Data: 05/01/2026
Usuário: Auditeste0387
Sistema: Windows 11
Versão Claude Code: 2.0.67
---
Resumo Executivo
Múltiplos problemas críticos encontrados na versão nativa do Claude Code para Windows, resultando em impossibilidade de uso estável da ferramenta. Os problemas persistiram mesmo após múltiplas reinstalações e tentativas de correção.
---
Problema 1: Instalador Falha Silenciosamente
Descrição
O instalador oficial via PowerShell (irm https://claude.ai/install.ps1 | iex) reporta sucesso mas não cria o arquivo claude.exe no diretório de destino.
Mensagem Exibida
✔ Claude Code successfully installed!
Version: 2.0.67
Location: C:\Users\Auditeste0387\.local\bin\claude.exe
⚠ Setup notes:
• installMethod is native, but claude command not found at C:\Users\Auditeste0387\.local\bin\claude.exe
Solução Tentada
Instalação manual via download direto:
$GCS_BUCKET = "https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases"
$version = Invoke-RestMethod -Uri "$GCS_BUCKET/stable"
Invoke-WebRequest -Uri "$GCS_BUCKET/$version/win32-x64/claude.exe" -OutFile "$env:USERPROFILE\.local\bin\claude.exe"
Resultado
Funcionou - arquivo baixado com 234MB.
---
Problema 2: PATH Não Persiste
Descrição
Mesmo após adicionar C:\Users\Auditeste0387\.local\bin ao PATH do usuário, o comando claude não é reconhecido após reiniciar o VS Code ou terminal.
Comandos Tentados
# Adicionar ao PATH permanente
[Environment]::SetEnvironmentVariable("Path", "$([Environment]::GetEnvironmentVariable('Path', 'User'));$env:USERPROFILE\.local\bin", "User")
# Aplicar na sessão atual
$env:Path += ";$env:USERPROFILE\.local\bin"
Problema Adicional Descoberto
O PATH do usuário estava poluído com múltiplas entradas duplicadas, excedendo o limite de 2047 caracteres do Windows.
Solução Aplicada
Limpeza de duplicatas via PowerShell:
$path = [Environment]::GetEnvironmentVariable("Path", "User")
$cleanPath = ($path -split ";" | Sort-Object -Unique | Where-Object { $_ -ne "" }) -join ";"
[Environment]::SetEnvironmentVariable("Path", $cleanPath, "User")
Resultado
PATH reduzido de tamanho excessivo para 1127 caracteres.
---
Problema 3: Extensão VS Code Desconecta
Descrição
A extensão "Claude Code" do VS Code perde conexão com o backend. Comandos digitados na caixa "Claude Terminal Input" são enviados diretamente para o PowerShell em vez de serem processados pelo Claude Code.
Sintoma
Ao digitar uma pergunta como [Oconcluiu a subida para o saveincloud?, o PowerShell tenta interpretar como comando e retorna erro de sintaxe.
Soluções Tentadas
Ctrl+Shift+P→ "Claude: Restart"Ctrl+Shift+P→ "Developer: Reload Window"- Desinstalar e reinstalar extensão
- Usar
claudedireto no terminal em vez da extensão
Resultado
Instável - às vezes funciona, às vezes não.
---
Problema 4: Sessões Travam com "Context Low"
Descrição
Após uso prolongado, o Claude Code exibe "Context low - Run /compact to compact & continue" mas o comando /compact falha com erro.
Mensagem de Erro
Error: Error during compaction: Error: Conversation too long. Press esc twice to go up a few messages and try again.
Soluções Tentadas
- Pressionar Esc duas vezes
- Comando
/clear - Comando
/reset - Comando
/exite reiniciar
Resultado
Necessário limpar sessões manualmente:
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\sessions" -ErrorAction SilentlyContinue
---
Problema 5: Loading Infinito
Descrição
Ao iniciar o Claude Code, a interface exibe uma barra de loading que nunca completa. O terminal fica inutilizável.
Soluções Tentadas
Ctrl+Cpara cancelar- Limpar cache de sessões
- Reiniciar VS Code
- Abrir terminal PowerShell externo
Resultado
Inconsistente - às vezes resolve, às vezes não.
---
Problema 6: Comandos SSH Travam
Descrição
Comandos que envolvem SSH para servidores remotos (como deploy via docker-compose) travam indefinidamente, mesmo com timeout configurado.
Exemplo
Bash(ssh 254545-14144@gate.paas.saveincloud.net.br -p 3022 "sleep 180 && docker ps...") timeout: 5m 0s
Solução Paliativa
Pressionar Esc para interromper ou Ctrl+B para enviar para background.
---
Problema 7: Arquivos Temporários Corrompidos
Descrição
Claude Code tenta acessar arquivos temporários que não existem.
Mensagem de Erro
tail: cannot open '/tmp/claude/tasks/b28eed2.output' for reading: No such file or directory
Solução Tentada
Remove-Item -Recurse -Force "$env:TEMP\claude-code-extension" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "C:\tmp\claude" -ErrorAction SilentlyContinue
---
Issues Relacionados no GitHub
Estes problemas já foram reportados por outros usuários:
- #14902 - Native Windows(Powershell) install of Claude Code is not viable
- #14942 - Windows installer reports success but fails to create claude.exe
- #15540 - npm install shows "installMethod is native" warning on Windows
- #9418 - Update to 2.0.14 on Windows is broken
- #3838 - claude CLI Not Recognized After Global Installation on Windows
---
Conclusão
A versão nativa do Claude Code para Windows (2.0.67) apresenta múltiplos problemas críticos que impedem o uso estável da ferramenta. Os problemas afetam:
- Instalação
- Configuração de PATH
- Integração com VS Code
- Gerenciamento de sessões
- Execução de comandos remotos
Recomendações para Anthropic
- Corrigir o instalador do PowerShell que falha silenciosamente
- Melhorar a persistência do PATH após instalação
- Corrigir a desconexão da extensão VS Code
- Implementar melhor gerenciamento de contexto/sessões
- Melhorar tratamento de comandos de longa duração
Alternativas Temporárias para Usuários
- Usar WSL (Windows Subsystem for Linux) em vez da versão nativa
- Usar Claude via chat web (claude.ai) para tarefas complexas
- Instalação manual do binário em vez do script oficial
---
Tempo gasto em troubleshooting: Aproximadamente 3+ horas
Status final: Parcialmente funcional, mas instável
What Should Happen?
nao dar erros
Error Messages/Logs
Steps to Reproduce
Relatório de Problemas - Claude Code Windows
Data: 05/01/2026
Usuário: Auditeste0387
Sistema: Windows 11
Versão Claude Code: 2.0.67
---
Resumo Executivo
Múltiplos problemas críticos encontrados na versão nativa do Claude Code para Windows, resultando em impossibilidade de uso estável da ferramenta. Os problemas persistiram mesmo após múltiplas reinstalações e tentativas de correção.
---
Problema 1: Instalador Falha Silenciosamente
Descrição
O instalador oficial via PowerShell (irm https://claude.ai/install.ps1 | iex) reporta sucesso mas não cria o arquivo claude.exe no diretório de destino.
Mensagem Exibida
✔ Claude Code successfully installed!
Version: 2.0.67
Location: C:\Users\Auditeste0387\.local\bin\claude.exe
⚠ Setup notes:
• installMethod is native, but claude command not found at C:\Users\Auditeste0387\.local\bin\claude.exe
Solução Tentada
Instalação manual via download direto:
$GCS_BUCKET = "https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases"
$version = Invoke-RestMethod -Uri "$GCS_BUCKET/stable"
Invoke-WebRequest -Uri "$GCS_BUCKET/$version/win32-x64/claude.exe" -OutFile "$env:USERPROFILE\.local\bin\claude.exe"
Resultado
Funcionou - arquivo baixado com 234MB.
---
Problema 2: PATH Não Persiste
Descrição
Mesmo após adicionar C:\Users\Auditeste0387\.local\bin ao PATH do usuário, o comando claude não é reconhecido após reiniciar o VS Code ou terminal.
Comandos Tentados
# Adicionar ao PATH permanente
[Environment]::SetEnvironmentVariable("Path", "$([Environment]::GetEnvironmentVariable('Path', 'User'));$env:USERPROFILE\.local\bin", "User")
# Aplicar na sessão atual
$env:Path += ";$env:USERPROFILE\.local\bin"
Problema Adicional Descoberto
O PATH do usuário estava poluído com múltiplas entradas duplicadas, excedendo o limite de 2047 caracteres do Windows.
Solução Aplicada
Limpeza de duplicatas via PowerShell:
$path = [Environment]::GetEnvironmentVariable("Path", "User")
$cleanPath = ($path -split ";" | Sort-Object -Unique | Where-Object { $_ -ne "" }) -join ";"
[Environment]::SetEnvironmentVariable("Path", $cleanPath, "User")
Resultado
PATH reduzido de tamanho excessivo para 1127 caracteres.
---
Problema 3: Extensão VS Code Desconecta
Descrição
A extensão "Claude Code" do VS Code perde conexão com o backend. Comandos digitados na caixa "Claude Terminal Input" são enviados diretamente para o PowerShell em vez de serem processados pelo Claude Code.
Sintoma
Ao digitar uma pergunta como [Oconcluiu a subida para o saveincloud?, o PowerShell tenta interpretar como comando e retorna erro de sintaxe.
Soluções Tentadas
Ctrl+Shift+P→ "Claude: Restart"Ctrl+Shift+P→ "Developer: Reload Window"- Desinstalar e reinstalar extensão
- Usar
claudedireto no terminal em vez da extensão
Resultado
Instável - às vezes funciona, às vezes não.
---
Problema 4: Sessões Travam com "Context Low"
Descrição
Após uso prolongado, o Claude Code exibe "Context low - Run /compact to compact & continue" mas o comando /compact falha com erro.
Mensagem de Erro
Error: Error during compaction: Error: Conversation too long. Press esc twice to go up a few messages and try again.
Soluções Tentadas
- Pressionar Esc duas vezes
- Comando
/clear - Comando
/reset - Comando
/exite reiniciar
Resultado
Necessário limpar sessões manualmente:
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\sessions" -ErrorAction SilentlyContinue
---
Problema 5: Loading Infinito
Descrição
Ao iniciar o Claude Code, a interface exibe uma barra de loading que nunca completa. O terminal fica inutilizável.
Soluções Tentadas
Ctrl+Cpara cancelar- Limpar cache de sessões
- Reiniciar VS Code
- Abrir terminal PowerShell externo
Resultado
Inconsistente - às vezes resolve, às vezes não.
---
Problema 6: Comandos SSH Travam
Descrição
Comandos que envolvem SSH para servidores remotos (como deploy via docker-compose) travam indefinidamente, mesmo com timeout configurado.
Exemplo
Bash(ssh 254545-14144@gate.paas.saveincloud.net.br -p 3022 "sleep 180 && docker ps...") timeout: 5m 0s
Solução Paliativa
Pressionar Esc para interromper ou Ctrl+B para enviar para background.
---
Problema 7: Arquivos Temporários Corrompidos
Descrição
Claude Code tenta acessar arquivos temporários que não existem.
Mensagem de Erro
tail: cannot open '/tmp/claude/tasks/b28eed2.output' for reading: No such file or directory
Solução Tentada
Remove-Item -Recurse -Force "$env:TEMP\claude-code-extension" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "C:\tmp\claude" -ErrorAction SilentlyContinue
---
Issues Relacionados no GitHub
Estes problemas já foram reportados por outros usuários:
- #14902 - Native Windows(Powershell) install of Claude Code is not viable
- #14942 - Windows installer reports success but fails to create claude.exe
- #15540 - npm install shows "installMethod is native" warning on Windows
- #9418 - Update to 2.0.14 on Windows is broken
- #3838 - claude CLI Not Recognized After Global Installation on Windows
---
Conclusão
A versão nativa do Claude Code para Windows (2.0.67) apresenta múltiplos problemas críticos que impedem o uso estável da ferramenta. Os problemas afetam:
- Instalação
- Configuração de PATH
- Integração com VS Code
- Gerenciamento de sessões
- Execução de comandos remotos
Recomendações para Anthropic
- Corrigir o instalador do PowerShell que falha silenciosamente
- Melhorar a persistência do PATH após instalação
- Corrigir a desconexão da extensão VS Code
- Implementar melhor gerenciamento de contexto/sessões
- Melhorar tratamento de comandos de longa duração
Alternativas Temporárias para Usuários
- Usar WSL (Windows Subsystem for Linux) em vez da versão nativa
- Usar Claude via chat web (claude.ai) para tarefas complexas
- Instalação manual do binário em vez do script oficial
---
Tempo gasto em troubleshooting: Aproximadamente 3+ horas
Status final: Parcialmente funcional, mas instável
Claude Model
None
Is this a regression?
Yes, this worked in a previous version
Last Working Version
_No response_
Claude Code Version
nao sei
Platform
Anthropic API
Operating System
Windows
Terminal/Shell
Windows Terminal
Additional Information
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗