# Claude Code 2.0: data de lançamento, novidades e como atualizar > Claude Code 2.0 saiu em 29 de setembro de 2025 e já não é a versão atual: a 2.1.316 saiu em 31 de outubro de 2026. Atualize em native, Homebrew, WinGet e npm. - Canonical HTML: https://omniakey.com/pt-BR/blog/claude-code-2-0 - Markdown: https://omniakey.com/pt-BR/blog/claude-code-2-0.md - Published: 2026-10-31 (updated 2026-10-31) - Author: Kiki, COO at OmniaKey - Language: pt-BR - Category: Guide - Reading time: 10 min - All posts: https://omniakey.com/blog/llms.txt --- 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. |Versão|Lançamento|Status| |-|-|-| |2.0.0|29/09/2025|Primeira versão 2.0| |2.0.77|06/01/2026|Última 2.0.x| |2.1.0|07/01/2026|Primeira versão 2.1| |2.1.316|31/10/2026|Versão atual| Para atualizar uma instalação nativa: ```bash 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. ||2.0 (2025)|Agora| |-|-|-| |Versão|2.0.0|2.1.316| |Modelo padrão|Sonnet 4.5|Opus 5.5| |Node para npm|18+|22+| |Opções de CLI|40|66| |Comandos|6|18| 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. ```bash # Native installer claude update ``` ```bash # Homebrew, stable channel brew upgrade claude-code # Homebrew, latest channel brew upgrade claude-code@latest ``` ```bash # WinGet winget upgrade Anthropic.ClaudeCode ``` ```bash # 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. ```text Successfully updated from to version Claude Code is up to date () 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. |Instalação|Iniciou?|Depois da atualização| |-|-|-| |Nativa 2.0.0|Sim|2.1.308| |Nativa 2.0.76|Sim|2.1.314| |npm 2.0.76|Sim|Falhou| |npm 2.0.0|Travou|Não rodou| 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. ```text 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: ```text 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. ```text 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: ```bash curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89 ``` ```powershell & ([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: ```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: ```json {"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 ` 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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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. ||2.0.76|2.1.316| |-|-|-| |Correção|Mesma linha|Mesma linha| |Testes depois|Passaram|Passaram| |Tempo|25.8 s|15.9 s| |Turnos|5|5| |Estimativa de custo da CLI|$0.129|$0.055| |Leitura de cache|50,547|34,306| 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. ```bash 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](https://docs.omniakey.com/en/guides/claude-code-api-key) cobre as variáveis e a configuração no Windows. Para o passo a passo mais longo, leia [nosso guia de instalação](https://omniakey.com/pt-BR/blog/claude-code-setup) e [Claude Code sem assinatura](https://omniakey.com/pt-BR/blog/claude-code-api-without-subscription). As páginas [Claude Opus 5.5](https://omniakey.com/pt-BR/claude-opus-5-5) e [Claude Sonnet 5.5](https://omniakey.com/pt-BR/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](https://omniakey.com/pt-BR/blog/claude-code-pricing). ## 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](https://www.npmjs.com/package/@anthropic-ai/claude-code) — conferido em 31 de outubro de 2026 - [Anthropic: Enabling Claude Code to work more autonomously](https://www.anthropic.com/news/enabling-claude-code-to-work-more-autonomously) — conferido em 31 de outubro de 2026 - [Claude Code changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) — conferido em 31 de outubro de 2026 - [Claude Code setup](https://code.claude.com/docs/en/setup) — conferido em 31 de outubro de 2026 - [Claude Code checkpointing](https://code.claude.com/docs/en/checkpointing) — conferido em 31 de outubro de 2026 - [Claude Code with an LLM gateway](https://code.claude.com/docs/en/llm-gateway-connect) — conferido em 31 de outubro de 2026 - [Claude Code model configuration](https://code.claude.com/docs/en/model-config) — conferido em 31 de outubro de 2026 - [Claude Code errors](https://code.claude.com/docs/en/errors) — conferido em 31 de outubro de 2026 - [Claude Code in VS Code](https://code.claude.com/docs/en/vs-code) — conferido em 31 de outubro de 2026 - [Use Claude Code with Pro, Max or Ultra](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-max-or-ultra) — conferido em 31 de outubro de 2026 - [GitHub issue #8657](https://github.com/anthropics/claude-code/issues/8657) — conferido em 31 de outubro de 2026 - [GitHub issue #25165](https://github.com/anthropics/claude-code/issues/25165) — conferido em 31 de outubro de 2026 - [GitHub issue #60065](https://github.com/anthropics/claude-code/issues/60065) — conferido em 31 de outubro de 2026