Claude Code 2.0: data de lançamento, novidades e como atualizar

O Claude Code 2.0 saiu em 29 de setembro de 2025 com uma extensão para VS Code, uma interface de terminal reformulada e checkpoints para os quais você volta com /rewind. Ele já não é a versão atual: a linha 2.0 terminou na 2.0.77, em 6 de janeiro de 2026, e a versão mais nova em 31 de outubro de 2026 é a 2.1.316.

Para atualizar uma instalação nativa:

claude update
claude --version

Quando o Claude Code 2.0 foi lançado?

A Anthropic publicou a 2.0.0 no npm em 29 de setembro de 2025 às 14:41 UTC, no mesmo dia do anúncio, "Enabling Claude Code to work more autonomously" (registro npm, conferido em 31 de outubro de 2026). A linha 2.0 foi até a 2.0.77, em 6 de janeiro de 2026, com 70 versões publicadas no total. A versão 2.0.74 saiu em 19 de dezembro de 2025 e a 2.0.76 em 22 de dezembro de 2025.

A versão 2.1.0 chegou no dia seguinte, 7 de janeiro de 2026, e o registro tinha 555 versões no total em 31 de outubro de 2026. Naquele dia a tag latest apontava para a 2.1.316 e a tag stable para a 2.1.309. A página de instalação da Anthropic diz que o canal stable costuma ficar cerca de uma semana atrás e pula versões com regressões graves (conferido em 31 de outubro de 2026).

O que havia de novo no Claude Code 2.0?

As mudanças principais, segundo o anúncio da Anthropic de 29 de setembro de 2025 e o changelog da 2.0.0:

• Uma extensão nativa para VS Code em beta, com painel lateral e diffs inline.
• Uma interface de terminal reformulada, com status mais visível e histórico de prompts pesquisável com Ctrl+r.
• Checkpoints que salvam o estado do código antes de cada mudança.
• O Claude Code SDK passou a se chamar Claude Agent SDK.
• Claude Sonnet 4.5 como modelo padrão.

O changelog da 2.0.0 tem dez itens, entre eles "New native VS Code extension", "Fresh coat of paint throughout the whole app", "/rewind a conversation to undo code changes" e "/usage command to see plan limits".

Os checkpoints funcionam assim até hoje: todo prompt que inicia um turno cria um, a sessão guarda os 100 mais recentes e os snapshots são apagados cerca de 30 dias depois da última vez que a sessão salvou um. /rewind, ou Esc duas vezes com o prompt vazio, abre um menu com quatro opções: restaurar código e conversa, restaurar a conversa, restaurar o código ou resumir. Arquivos alterados apenas por comandos Bash não são rastreados, e edições feitas por subagentes geralmente não são capturadas, então faça commit no git antes de uma mudança arriscada.

O que mudou depois da 2.0?

A versão 2.0.74, em 19 de dezembro de 2025, adicionou uma ferramenta LSP (Language Server Protocol) para ir à definição, encontrar referências e ver documentação ao passar o mouse. A versão 2.1.0, em 7 de janeiro de 2026, trouxe 15 itens, entre eles:

• Skills recarregam assim que você cria ou edita, sem reiniciar.
• Skills podem rodar num subagente derivado com context: fork.
• Uma configuração language escolhe o idioma das respostas do Claude.
• Shift+Enter funciona de fábrica no iTerm2, WezTerm, Ghostty e Kitty.
• Uma correção de segurança impede que tokens OAuth, chaves de API e senhas apareçam nos logs de depuração.

Desde a versão 2.1.89 (31 de março de 2026), os manifestos de release são assinados, e versões anteriores trazem apenas checksums. O pacote npm agora pede Node.js 22 ou mais novo, contra Node.js 18 na 2.0.0. O modelo padrão para Pro, Max, Ultra, Team, Enterprise e a API da Anthropic agora é o Opus 5.5.

As linhas Opções de CLI e Comandos contam a saída de claude --help da 2.0.76 e da 2.1.316.

Comparado com a 2.0.76, o texto de ajuda da 2.1.316 mostra:

• Novos comandos, incluindo agents para agentes em segundo plano, attach, logs, stop e rm para sessões em segundo plano, auth, import para trazer configuração de outro agente de código, purge para apagar do computador os dados do Claude Code de um projeto e ultrareview, uma revisão de código multiagente hospedada na nuvem.
• Novas opções, entre elas --worktree para uma nova worktree do git, --effort de low a max, --bg para iniciar em segundo plano, --remote-control, --safe-mode para iniciar com todas as personalizações desligadas e --name.
• --permission-mode perdeu default e delegate e ganhou auto e manual, então scripts que passam default ou delegate precisam de um valor novo.
• Só uma opção desapareceu: --mcp-debug, que a 2.0.76 já marcava como deprecated.

Como verificar a versão e atualizar o Claude Code?

Rode claude --version para ver a sua versão: ele imprime o número seguido de "(Claude Code)", por exemplo 2.1.316 (Claude Code). Depois atualize do mesmo jeito que você instalou.

# Native installer
claude update

# Homebrew, stable channel
brew upgrade claude-code
# Homebrew, latest channel
brew upgrade claude-code@latest

# WinGet
winget upgrade Anthropic.ClaudeCode

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

Instalações nativas se atualizam sozinhas em segundo plano, checando na inicialização e enquanto rodam, e a versão nova passa a valer no próximo start do Claude Code. Instalações por Homebrew, WinGet e pacote Linux (apt, dnf, apk) precisam de atualização manual. Numa instalação nativa, claude update imprime uma das duas primeiras linhas abaixo; numa instalação Homebrew, WinGet ou apk, a terceira.

Successfully updated from <old version> to version <new version>
Claude Code is up to date (<version>)
Claude is up to date!

claude doctor mostra o resultado da última tentativa de atualização e se as atualizações automáticas estão ligadas. O número de versão da extensão do VS Code é o da versão do Claude Code que ela traz.

No npm, evite npm update -g: ele mantém o intervalo de versões da instalação original e pode não chegar à versão mais nova. Também não use sudo npm install -g.

O que acontece ao atualizar uma instalação 2.0 antiga?

Em 31 de outubro de 2026 rodamos cinco instalações novas num Mac com Node.js 26.12.1, cada uma numa pasta de usuário vazia, e apontamos todas para modelos Claude pela API da OmniaKey.

As duas instalações nativas iniciaram, e claude update levou cada uma para a 2.1.x. A instalação da 2.0.0 levou 36.6 segundos e a atualização dela 35.6 segundos; a instalação da 2.0.76 levou 51.6 segundos e a dela 29.6 segundos.

Successfully updated from 2.0.0 to version 2.1.308
Successfully updated from 2.0.76 to version 2.1.314

Nenhuma das duas chegou à 2.1.316, a versão mais nova no npm naquela hora, então confira claude --version depois de atualizar.

A instalação npm da 2.0.76 iniciou e falhou ao atualizar:

New version available: 2.1.316 (current: 2.0.76)
Error: Failed to install update
Or consider using native installation with: claude install

A versão continuou 2.0.76. O build npm da 2.0.0 nem chegou lá: travou ao iniciar em Node.js 26.12.1 com código de saída 1.

TypeError: Cannot read properties of undefined (reading 'prototype')

O binário nativo da 2.0.0 iniciou sem problema na mesma máquina, então essa queda é do build npm da 2.0.0 nesta versão do Node. A instalação npm da 2.1.316 iniciou e imprimiu 2.1.316 (Claude Code). Numa instalação npm, atualize com o comando npm acima ou, como a mensagem sugere, migre para o instalador nativo com claude install.

Depois de uma atualização nativa, as duas versões ficam em ~/.local/share/claude/versions/ e o launcher aponta para a nova. Os binários que medimos tinham 74 MB na 2.0.0, 182 MB na 2.0.76, 275 MB na 2.1.308 e 279 MB na 2.1.314, ou seja, cada atualização deixou o binário antigo no disco.

Dá para fixar uma versão, voltar atrás ou atrasar atualizações?

Instale uma versão específica com o mesmo script e um número de versão:

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

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

Use stable no lugar do número para começar no canal stable. O canal escolhido na instalação vira o padrão das atualizações automáticas, e você pode trocar depois no settings.json:

{"autoUpdatesChannel": "stable"}

latest, o padrão, instala as versões novas assim que aparecem. stable costuma ter cerca de uma semana e pula versões com regressões graves, e o mesmo ajuste fica em /config. Um modelo recém-lançado pode exigir uma versão mais nova do que a que o canal stable serve, então troque para latest para usá-lo na hora.

minimumVersion define um piso, e as atualizações automáticas e o claude update passam a recusar qualquer coisa mais antiga:

{"minimumVersion": "2.1.143"}

DISABLE_AUTOUPDATER em 1 na chave env do settings.json desliga apenas a checagem em segundo plano, e claude update continua funcionando. DISABLE_UPDATES bloqueia todos os caminhos, inclusive os manuais.

Dois relatos de bug de usuários no GitHub mostram as arestas. Em 12 de fevereiro de 2026, um usuário relatou: "When running curl -fsSL https://claude.ai/install.sh | bash -s <version> to install a specific version, the script downloads the new binary but fails to update the symlink, leaving the user on the old version" (issue #25165, fechada).

Em 17 de maio de 2026, um usuário de Windows relatou que, depois de instalar a 2.1.143 no canal stable, o atualizador automático recolocou a 2.1.133, o build stable da época. autoUpdatesChannel: "latest" junto com minimumVersion: "2.1.143" "stopped the revert" (issue #60065, fechada).

Depois de fixar, rode claude --version e confirme o número que você esperava.

Uma versão antiga do Claude Code ainda funciona?

A Anthropic não publica data de corte para builds antigos, e nenhuma das páginas que conferimos diz que a 2.0.x é recusada. A API ainda pode rejeitar uma requisição com um 400 claude_code_version_too_old quando o modelo escolhido precisa de um build mais novo ou quando a política da sua organização exige um (página de erros da Anthropic, conferida em 31 de outubro de 2026).

Num gateway, o modelo padrão embutido de uma instalação antiga pode atrapalhar. Iniciada sem modelo definido, a 2.0.76 pediu claude-sonnet-4-5-20250929, o padrão embutido dela, e a requisição falhou porque nosso gateway não serve esse modelo. A 2.1.316 pediu claude-opus-5-5 e respondeu.

Defina o modelo você mesmo com --model ou com a variável de ambiente ANTHROPIC_MODEL. Com --model claude-sonnet-5-5, a 2.0.76 fez a correção abaixo sem problema.

Builds 2.0 antigos também tinham os seus: em 1º de outubro de 2025 um usuário relatou que o Claude Code 2.0.0 e a 2.0.1 travavam sem parar no Emacs e num shell no Linux (issue #8657, fechada).

Então atualize, a menos que você tenha um motivo para ficar. Se ficar na 2.0, nomeie o modelo em toda sessão.

A versão nova é melhor na mesma tarefa?

Rodamos uma tarefa de correção de bug na 2.0.76 e na 2.1.316, sem interação, as duas com --model claude-sonnet-5-5.

Tarefa:

The tests in test_wordcount.py fail. Find the bug in wordcount.py, fix it, and run python3 test_wordcount.py to confirm. Do not change the test file.

O bug era uma contagem sensível a maiúsculas e minúsculas.

As duas versões fizeram a mesma correção de uma linha, passando o texto para minúsculas com text.lower() antes de contar, e deixaram o arquivo de teste intacto. Os testes passaram nas duas, e os dois diffs são idênticos byte a byte, então o build mais novo mudou o tempo gasto, não a resposta.

A versão 2.1.316 terminou em 15.9 segundos contra 25.8 segundos, 38% menos tempo, e a estimativa de custo do Claude Code dela foi de $0.055 contra $0.129, principalmente porque leu e escreveu menos tokens em cache. Esses dois valores em dólar são a estimativa de custo do próprio Claude Code, não o que pagamos. Uma tarefa, uma execução em cada versão, é uma amostra pequena.

Como usar o Claude Code com uma chave de API em vez de assinatura?

O Claude Code exige uma conta Pro, Max, Ultra, Team, Enterprise ou Console, e o plano gratuito do claude.ai não inclui. Um gateway usa duas variáveis: ANTHROPIC_BASE_URL para onde as requisições vão e uma credencial, em que ANTHROPIC_AUTH_TOKEN é enviado como Authorization: Bearer e ANTHROPIC_API_KEY como x-api-key. A URL base muda para onde as requisições vão, não qual modelo responde, então nomeie o modelo também.

export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude --model claude-sonnet-5-5

Nossos testes acima rodaram assim, com uma chave OmniaKey em ANTHROPIC_AUTH_TOKEN.

O guia da chave de API do Claude Code cobre as variáveis e a configuração no Windows. Para o passo a passo mais longo, leia nosso guia de instalação e Claude Code sem assinatura. As páginas Claude Opus 5.5 e Claude Sonnet 5.5 mostram para que serve cada modelo, e os preços dos planos estão em nosso guia de preços do Claude Code.

Perguntas frequentes

O Claude Code 2.0 é a versão mais recente?

Não. A linha 2.0 terminou na 2.0.77, em 6 de janeiro de 2026, e a versão mais nova em 31 de outubro de 2026 é a 2.1.316. Rode claude --version para ver a sua.

Quando o Claude Code 2.0 foi lançado?

O Claude Code 2.0 foi lançado em 29 de setembro de 2025, quando a versão 2.0.0 chegou ao npm no mesmo dia do anúncio da Anthropic. A linha 2.1 começou em 7 de janeiro de 2026.

Como atualizar o Claude Code?

Numa instalação nativa, rode claude update ou deixe que ela se atualize em segundo plano. O Homebrew usa brew upgrade claude-code ou brew upgrade claude-code@latest, o WinGet usa winget upgrade Anthropic.ClaudeCode e o npm usa npm install -g @anthropic-ai/claude-code@latest. Depois confira o resultado com claude --version.

Como instalar uma versão antiga do Claude Code?

Passe a versão para o script de instalação: curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89 no macOS, Linux ou WSL, ou & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89 no PowerShell.

O Claude Code funciona no plano gratuito?

Não. O plano gratuito do claude.ai não inclui o Claude Code, que exige uma conta Pro, Max, Ultra, Team, Enterprise ou Console. O outro caminho é uma chave de API, do Console da Anthropic ou de um gateway, cobrada por uso.

Fontes consultadas

• npm: @anthropic-ai/claude-code — conferido em 31 de outubro de 2026
• Anthropic: Enabling Claude Code to work more autonomously — conferido em 31 de outubro de 2026
• Claude Code changelog — conferido em 31 de outubro de 2026
• Claude Code setup — conferido em 31 de outubro de 2026
• Claude Code checkpointing — conferido em 31 de outubro de 2026
• Claude Code with an LLM gateway — conferido em 31 de outubro de 2026
• Claude Code model configuration — conferido em 31 de outubro de 2026
• Claude Code errors — conferido em 31 de outubro de 2026
• Claude Code in VS Code — conferido em 31 de outubro de 2026
• Use Claude Code with Pro, Max or Ultra — conferido em 31 de outubro de 2026
• GitHub issue #8657 — conferido em 31 de outubro de 2026
• GitHub issue #25165 — conferido em 31 de outubro de 2026
• GitHub issue #60065 — conferido em 31 de outubro de 2026