Toggle Sidebar

EscreverDivididoPrévia

salvo

Armadilhas específicas deste Windows, já pagas pelo menos uma vez cada. O padrão comum: **falham em silêncio**, sem erro na tela, e o sintoma aponta pro lugar errado. Quinta nota da série, junto de **My CLAUDE.md**, **My SETUP.md**, **My Skills Claude Code** e **My Agents Claude Code**. ## Shell e terminal <details> <summary><strong>Git Bash quebrado</strong>: sh.exe falha intermitente</summary> O Cygwin desta máquina dá erro fatal sem padrão claro. Workaround conhecido: rodar via node e usar `--no-verify` quando o hook for a vítima, sempre com autorização explícita. Não é problema do comando, é do ambiente. Reescrever o comando não resolve. </details> <details> <summary><strong>Path mangling do Git Bash</strong>: `--path=/server` vira caminho do Windows</summary> O MSYS converte qualquer argumento que pareça caminho Unix. O `infisical --path=/server` vira `C:\Program Files\Git\server` e o comando falha por motivo que não tem nada a ver. Fix: prefixar `MSYS_NO_PATHCONV=1`. </details> <details> <summary><strong>curl no Git Bash corrompe acento</strong></summary> Payload com acento chega quebrado no destino. Teste de webhook falha por encoding, não por bug de lógica, e você perde tempo depurando o lado errado. Suspeitar disso sempre que um POST com texto em português der resultado estranho. </details> <details> <summary><strong>PowerShell + pipe + SSH insere BOM</strong></summary> `$valor | ssh host cmd` corrompe silenciosamente: o BOM entra no começo do conteúdo e o destino recebe lixo invisível. Fix: `cmd /c "ssh ... < arquivo"` com um arquivo sem BOM. </details> <details> <summary><strong>Heredoc de commit come acento</strong></summary> Mensagem de commit com acento passa por caminhos que corrompem. Reler o texto procurando acento faltando **antes** de rodar o `git commit`, não depois. Vale a mesma regra do CLAUDE.md: arquivo com acento grava em UTF-8 explícito, e no PowerShell 5.1 exige `-Encoding utf8`. </details> ## Classifier e permissões <details> <summary><strong>Autorização genérica não vale</strong></summary> Dizer "pode fazer tudo" não passa no classificador. Cada ação de risco (migration, SSH, leitura de segredo) pede confirmação pontual, mesmo com autorização ampla dada antes. Isso é por design. A saída é confirmar na hora, não tentar contornar. </details> <details> <summary><strong>Edição em bloco de `permissions.allow` é barrada</strong></summary> Editar muitas linhas de permissão de uma vez trava. Fatiar em 4 a 16 linhas por família de MCP passa. </details> <details> <summary><strong>Segredo cross-machine trava automação</strong></summary> Combinar chave local e da VPS no mesmo comando falha sempre. O caminho é pedir o valor no chat e tratar o resto manualmente. </details> <details> <summary><strong>opencode-playwright morre com credencial no prompt</strong></summary> O classifier trava agente autônomo quando há token de login no prompt. Para site que exige sessão, usar claude-in-chrome com a sessão já logada. </details> ## Ferramentas <details> <summary><strong>Playwright MCP só grava dentro do cwd</strong></summary> As allowed roots são o diretório da sessão e `<cwd>\.playwright-mcp`. Screenshot com caminho de scratchpad é recusado com `File access denied`. Sempre passar `filename: ".playwright-mcp/nome.png"`, senão o PNG cai na raiz do projeto e suja o `git status`. Limpar no fim da sessão. Contraria a convenção de mandar saída de MCP pra `~/.claude/MCP/<nome>`: neste não dá. </details> <details> <summary><strong>Playwright não é o default</strong></summary> Validar por build e lint primeiro. O MCP também precisa de restart pra carregar as tools, o que engana quando "não aparece nada". </details> <details> <summary><strong>`rclone lsl` não ordena por data</strong></summary> A saída crua parece backup parado sem estar. Passar por `Sort-Object` antes de concluir qualquer coisa. Operação em massa no Drive vai por rclone via SSH, nunca pelo navegador, que trava. </details> <details> <summary><strong>McAfee dá falso positivo no Claude Code</strong></summary> Checar o `detection.log` antes de assumir comprometimento. Já aconteceu e não era nada. </details> ## Deploy e CI <details> <summary><strong>Porta nova de produção precisa de regra UFW</strong></summary> Não basta o `.yml` do Traefik. O UFW bloqueia por padrão o tráfego das redes docker (172.17.0.0/16 e 172.18.0.0/16) pra portas do host sem regra explícita. Sintoma que engana: o domínio pendura 10 a 15 segundos e cai, enquanto o processo responde instantâneo direto no host via `curl http://172.17.0.1:<porta>`. Nada nos logs do Traefik além do timeout. Fix: `ufw allow from 172.17.0.0/16 to any port <porta> proto tcp`, e o mesmo pra 172.18. </details> <details> <summary><strong>CI verde local, vermelho no GitHub</strong></summary> O npm 10 (Node 20) reprova `peerOptional` que o npm 11 local aceita. Alinhar o `node-version` do workflow ao que roda aqui. </details> <details> <summary><strong>`serve` com cleanUrls quebra query string</strong></summary> Pegou o ComponentsAlienUI em produção (corrigido em 10-08). É padrão que pode repetir em qualquer app da suíte servido assim. </details> ## Como isso deveria ser lido Todos os itens acima têm a mesma forma: **a ferramenta não avisa que falhou**. Quando algo der resultado estranho sem erro, a primeira hipótese é encoding, path ou firewall, não lógica.

761 palavras · 5426 caracteres · 4 min de leitura11 de ago., 08:59