Resumo
O Claude Code 2.1.290 corrige a aplicação das permissões em leituras por links simbólicos e em chamadas modificadas por hooks. A continuidade das tarefas agendadas também recebe ajustes: a retomada de uma conversa compactada preserva os agendamentos criados a partir desta versão, enquanto outras correções evitam execuções extras após uma retomada.
Você precisa revisar as integrações que habilitavam o Chrome pelas configurações do projeto e as que interpretavam agent_id como um endereço de participante. Esses dois comportamentos mudam, mesmo com a publicação identificada como estável.
Novidades
- Claude Code 2.1.290 — Hooks de plugins:
serverToolUsesexpõe as chamadas executadas pelo servidor no resultado deturn.step. O eventotool.checkincluiagentIdpara identificar o subagente eceilingpara informar a aprovação exigida pela organização.claude plugin validate --jsonapresentagatingHookscom a presença de.catch. - Claude Code 2.1.290 — Sessões e Managed Agents:
claude attach <name>eclaude logs <name>aceitam parte do nome da sessão./claude-api managed-agents-onboardaceita uma URL com arquivosant applyou o nome de um quickstart da Console. - Claude Code 2.1.290 — Configurações gerenciadas: novos avisos indicam um link para fora da pasta gerenciada ou a desconsideração dos caminhos de leitura e domínios permitidos configurados por você.
Melhorias
- Claude Code 2.1.290 — Sessões extensas: o carregamento do histórico permite que a interface continue atendendo aos comandos. O WebFetch informa quanto texto excedeu os 100 mil caracteres e aceita
offsetpara continuar a leitura. - Claude Code 2.1.290 — Proxy e gateway: um servidor MCP (Model Context Protocol) recusado com HTTP 403 pelo proxy não recebe as três novas tentativas anteriores. O gateway informa a causa das falhas de credenciais e avisa durante os últimos 30 dias de validade do certificado apresentado ao provedor de identidade.
- Claude Code 2.1.290 — Busca na web: o orçamento da sessão interativa é renovado a 100 chamadas por hora.
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOURaltera essa taxa, com0para desativar a renovação.
Correções
- Claude Code 2.1.290 — Permissões de leitura: as restrições alcançam instruções do projeto ligadas a arquivos externos e imagens referenciadas no prompt. A troca de um link durante a leitura também recebe correções no macOS e no Windows.
- Claude Code 2.1.290 — Execução de ferramentas: as verificações de permissão são aplicadas após a alteração da entrada por
PreToolUse. Comandos com expansão de curingas e certas variáveis interpretadas pelo zsh exigem aprovação. O Monitor dentro da sandbox respeita as permissões configuradas. - Claude Code 2.1.290 — Agendamentos e agentes:
/looppreserva os agendamentos durante as compactações feitas a partir desta versão. A passagem para segundo plano permite disparar as tarefas criadas no primeiro plano, sem repetir automaticamente uma execução a cada retomada. Subagentes retomados conservam o raciocínio anterior e o cache do prompt. - Claude Code 2.1.290 — Revisão e alterações locais:
/ultrareviewinforma falhas que comprometem a inclusão do trabalho sem commit./teleportrecusa a criação de um stash que apagaria arquivos de uma pasta colocada no lugar de um arquivo rastreado. - Claude Code 2.1.290 — Conexões e interface: as correções abrangem proxies que recusam cabeçalhos beta, respostas extensas de servidores MCP e sessões com muitas imagens. A extensão do VS Code conserva o foco de um diálogo quando outra solicitação de permissão chega.
Breaking changes
- Claude Code 2.1.290 — Chrome e configurações do projeto: arquivos do projeto não habilitam mais o Chrome. Utilize
--chrome,/chromeou as configurações pessoais.CLAUDE_CODE_DISABLE_ATTACHMENTStambém precisa vir do ambiente do shell, das configurações pessoais ou das gerenciadas, pois os arquivos locais do repositório não podem defini-la. - Claude Code 2.1.290 — Identificadores dos participantes: o campo
agent_idnos resultados de Agent utiliza o identificador do agente. Integrações que liam o endereçoname@teamnesse campo precisam utilizarteammate_id. HooksTeammateIdlenão são disparados pelos subagentes ou forks desse participante. - Claude Code 2.1.290 — GitHub nas sessões de nuvem: o
gh apiintegrado recusa outro host definido apenas porGH_HOSTouGH_REPO. Scripts que utilizam esse arranjo precisam informar--hostnameou uma URL completa.
Ponto de Atenção
A versão está marcada como estável, mas altera configurações e campos consumidos por integrações. Teste sugerido: em uma sessão isolada, confira a habilitação explícita do Chrome e compare agent_id com teammate_id em um resultado de Agent. Para a leitura de arquivos, utilize uma pasta de teste com uma restrição declarada e confirme a recusa do acesso por link simbólico.
Crie uma tarefa inofensiva de /loop, compacte a conversa e retome-a para observar o agendamento. A correção não recupera retroativamente tarefas perdidas por compactações de versões anteriores.
Notas da versão
O release oficial do Claude Code 2.1.290 foi publicado às 19h33 de 05/10 em Nova York. As notas abrangem o terminal e as integrações de nuvem, com alterações também na extensão do VS Code e no Claude Tag.