[BUG]

Resolved 💬 3 comments Opened Jan 5, 2026 by davidlsilveira Closed Jan 9, 2026

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

  1. Ctrl+Shift+P → "Claude: Restart"
  2. Ctrl+Shift+P → "Developer: Reload Window"
  3. Desinstalar e reinstalar extensão
  4. Usar claude direto 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

  1. Pressionar Esc duas vezes
  2. Comando /clear
  3. Comando /reset
  4. Comando /exit e 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

  1. Ctrl+C para cancelar
  2. Limpar cache de sessões
  3. Reiniciar VS Code
  4. 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:

  1. #14902 - Native Windows(Powershell) install of Claude Code is not viable
  2. #14942 - Windows installer reports success but fails to create claude.exe
  3. #15540 - npm install shows "installMethod is native" warning on Windows
  4. #9418 - Update to 2.0.14 on Windows is broken
  5. #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

  1. Corrigir o instalador do PowerShell que falha silenciosamente
  2. Melhorar a persistência do PATH após instalação
  3. Corrigir a desconexão da extensão VS Code
  4. Implementar melhor gerenciamento de contexto/sessões
  5. Melhorar tratamento de comandos de longa duração

Alternativas Temporárias para Usuários

  1. Usar WSL (Windows Subsystem for Linux) em vez da versão nativa
  2. Usar Claude via chat web (claude.ai) para tarefas complexas
  3. 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

  1. Ctrl+Shift+P → "Claude: Restart"
  2. Ctrl+Shift+P → "Developer: Reload Window"
  3. Desinstalar e reinstalar extensão
  4. Usar claude direto 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

  1. Pressionar Esc duas vezes
  2. Comando /clear
  3. Comando /reset
  4. Comando /exit e 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

  1. Ctrl+C para cancelar
  2. Limpar cache de sessões
  3. Reiniciar VS Code
  4. 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:

  1. #14902 - Native Windows(Powershell) install of Claude Code is not viable
  2. #14942 - Windows installer reports success but fails to create claude.exe
  3. #15540 - npm install shows "installMethod is native" warning on Windows
  4. #9418 - Update to 2.0.14 on Windows is broken
  5. #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

  1. Corrigir o instalador do PowerShell que falha silenciosamente
  2. Melhorar a persistência do PATH após instalação
  3. Corrigir a desconexão da extensão VS Code
  4. Implementar melhor gerenciamento de contexto/sessões
  5. Melhorar tratamento de comandos de longa duração

Alternativas Temporárias para Usuários

  1. Usar WSL (Windows Subsystem for Linux) em vez da versão nativa
  2. Usar Claude via chat web (claude.ai) para tarefas complexas
  3. 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_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗