Claude Code "terminated by signal SIGSEGV (Address boundary error)": como voltar a abrir

Você digitou claude e o terminal devolveu terminated by signal SIGSEGV (Address boundary error). Essa é a mensagem do shell fish; no bash e no zsh o mesmo crash aparece como Segmentation fault (core dumped), com código de saída 139. Entre agosto e setembro de 2026 o repositório oficial anthropics/claude-code acumulou dezenas de issues com esse sinal, e elas caem em três padrões diferentes. O que decide a saída é em que momento o processo morre.

O que significa "terminated by signal SIGSEGV (Address boundary error)"?

O processo do Claude Code tentou ler ou escrever num endereço de memória que não podia, e o sistema operacional matou ele. Não é erro no seu código nem no seu projeto: o crash acontece dentro do binário do Claude Code.

A instalação nativa do Claude Code é um executável único com o runtime Bun embutido. Quase todas as issues de setembro apontam para dentro desse runtime, seja num build específico que saiu quebrado, seja no coletor de lixo do JavaScriptCore que o Bun usa. Por isso as saídas abaixo são quase sempre sobre qual versão você roda, não sobre configuração.

Qual dos três casos é o seu?

Olhe quando o crash acontece. A tabela resume os três padrões encontrados nas issues oficiais e a saída de cada um.

Quando quebra	Sinal típico	Causa	O que fazer
Ao abrir, até claude --version, logo depois de uma atualização	Sempre, 100% das vezes	Build da versão nova quebrado no seu sistema	Voltar para a última versão que abria e travar o auto-update
Durante a instalação	CPU lacks AVX support no relatório do Bun	Processador sem AVX	Nenhuma versão resolve hoje; rodar em outra máquina
No meio de uma sessão que estava funcionando	Intermitente, às vezes com a sessão ociosa	Falha no coletor de lixo do runtime	Retomar com claude --continue e mudar de versão

Quebra ao abrir, logo depois de atualizar: como voltar de versão?

Se até claude --version dá SIGSEGV, a versão que o auto-update instalou está quebrada no seu sistema. Volte para a anterior e desligue o auto-update até sair a correção.

Dois casos reais em 2026:

• 2.1.243 (issues #89390 e #89484, 25/08): segfault imediato em Linux x86_64 com glibc 2.44, enquanto 2.1.239, 2.1.240 e 2.1.241 abriam normalmente na mesma máquina. Segundo relatos na #89390, a correção chegou na 2.1.250.
• 2.1.251 em diante (issue #92749, 07/09, ainda aberta): em algumas máquinas Linux, as versões que embutem o Bun 1.4.1 morrem cerca de 25 ms depois de abrir, e a última que funciona é a 2.1.243, com Bun 1.4.0.

Passo 1: descubra quais versões você tem no disco. A instalação nativa em macOS e Linux guarda cada versão em ~/.local/share/claude/versions/ e aponta o ~/.local/bin/claude para uma delas. Teste cada uma:

ls ~/.local/share/claude/versions/
for v in ~/.local/share/claude/versions/*; do echo "$v"; "$v" --version; done

A que imprimir algo como 2.1.241 (Claude Code) é a sua versão boa. A quebrada sai com código 139.

Passo 2: reinstale a versão boa pelo instalador. Não dá para usar claude install aqui, porque ele roda dentro do mesmo binário que está quebrando. O script oficial aceita número de versão:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.241

Se instalou pelo npm, o equivalente é fixar a versão no pacote:

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

Passo 3: impeça o auto-update de trazer a versão quebrada de volta. Sem isso, a próxima checagem em segundo plano reinstala a mesma versão. No ~/.claude/settings.json:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Confirme com claude doctor: a linha Auto-updates deve mostrar disabled (set by env: DISABLE_AUTOUPDATER).

Alternativa sem desligar o auto-update: troque o link ~/.local/bin/claude por um script que fixa a versão. A documentação oficial confirma que, desde a v2.1.207, o auto-update respeita um launcher customizado nesse caminho: as versões novas continuam sendo baixadas em versions/, mas quem decide qual roda é o seu script. Foi a saída sugerida na #89390:

#!/bin/sh
PIN="${CLAUDE_PIN:-2.1.241}"
BIN="$HOME/.local/share/claude/versions/$PIN"
if [ ! -x "$BIN" ]; then
  echo "claude: versão $PIN não encontrada em ~/.local/share/claude/versions" >&2
  exit 127
fi
exec "$BIN" "$@"

Para testar uma versão nova sem mexer no script, rode CLAUDE_PIN=2.1.283 claude --version.

Atenção ao piso de versão dos modelos. Na #92749, voltar para a 2.1.243 fez a API recusar o Fable 5.1 com claude_code_version_too_old: "version 2.1.251 or newer is required". Se o downgrade te deixar sem o modelo que você usa, troque de modelo com /model até a correção sair.

Quebra ao instalar, com "CPU lacks AVX support": tem saída?

Hoje não, pelo lado da versão. Em processadores x86-64 sem AVX, o instalador nativo e o pacote npm falham do mesmo jeito, então trocar de canal de instalação não ajuda.

A issue #87974 (19/08/2026) mostra a sequência completa:

CPU lacks AVX support. Please consider upgrading to a newer CPU.
panic(main thread): Segmentation fault at address 0x43AE6000000
oh no: Bun has crashed. This indicates a bug in Bun, not your code.

Quem abriu a issue depurou com gdb e mostrou que o crash é uma leitura de até 3 bytes além do fim de um bloco de memória, e não uma instrução inválida. A issue foi fechada por inatividade em 22/09/2026, sem correção. Confira se a sua CPU tem AVX antes de insistir:

grep -o -w 'avx\|avx2' /proc/cpuinfo | sort -u

Saída vazia confirma o caso. O caminho real é rodar o agente numa máquina com AVX e acessar por SSH.

Quebra no meio da sessão: como não perder o trabalho?

Retome a conversa do ponto em que parou e, se o crash se repetir, mude de versão. O histórico da sessão fica salvo em disco, então o SIGSEGV derruba o processo, não a conversa.

claude --continue   # retoma a conversa mais recente do diretório
claude --resume     # escolhe qual conversa retomar

Esse padrão é intermitente e mais difícil de isolar. Dois relatos detalhados de setembro:

• #95655 (20/09, aberta): crashes em sessões ociosas no binário linux-x64, recorrentes da 2.1.210 à 2.1.278. A análise do core dump aponta escrita em memória já liberada, que o coletor de lixo encontra depois. O mesmo relato registra a frequência subindo de 1 crash a cada 9 dias para 2 em 39 horas depois de uma atualização grande de kernel e glibc.
• #96793 (24/09, aberta): regressão na 2.1.280 em sessões Remote Control via VS Code Remote-SSH, com panic(main thread): Segmentation fault at address 0x0. Última versão boa informada: 2.1.279.

No caso da #96793, o canal stable resolve direto: em 27/09/2026 ele estava na 2.1.274, antes da regressão, enquanto o latest estava na 2.1.283 (dist-tags do pacote @anthropic-ai/claude-code no npm).

Para anexar a uma issue, o log do kernel mostra o endereço e a versão exata que caiu:

journalctl -k | grep -i 'claude.*segfault'
coredumpctl list claude

Como evitar que a próxima atualização quebre de novo?

Mude para o canal stable. Segundo a documentação oficial, ele entrega uma versão com cerca de uma semana e pula releases com regressões grandes, que é exatamente o que derrubou a 2.1.243 e a 2.1.280.

{
  "autoUpdatesChannel": "stable"
}

Também dá para trocar em /config, na opção Auto-update channel, ou já instalar direto no canal:

curl -fsSL https://claude.ai/install.sh | bash -s stable

Quando a correção sair, desfaça o que você travou. Tire o DISABLE_AUTOUPDATER do settings.json e rode claude update. Se usou o launcher customizado, apague o script e rode o instalador de novo, que recria o link e volta a gerenciar as versões:

rm ~/.local/bin/claude
curl -fsSL https://claude.ai/install.sh | bash