Documentation 2026-10-10 23:01 UTC to 2026-10-11 10:58 UTC

300* **Você interrompe o turno**: Claude Code cancela a alternância e mostra `Backgrounding cancelled — the turn was stopped.` Por exemplo, o turno é interrompido quando você [interrompe Claude com `Esc`](/docs/pt/interactive-mode#general-controls) ou seleciona **No** [sem um comentário](/docs/pt/permissions#add-a-comment-when-you-answer-a-permission-prompt) em um prompt de permissão da conversa principal, ou pressiona `Esc` em uma pergunta que Claude faz ali. Pressione `←` novamente para colocar a sessão em background.300* **Você interrompe o turno**: Claude Code cancela a alternância e mostra `Backgrounding cancelled — the turn was stopped.` Por exemplo, o turno é interrompido quando você [interrompe Claude com `Esc`](/docs/pt/interactive-mode#general-controls) ou seleciona **No** [sem um comentário](/docs/pt/permissions#add-a-comment-when-you-answer-a-permission-prompt) em um prompt de permissão da conversa principal, ou pressiona `Esc` em uma pergunta que Claude faz ali. Pressione `←` novamente para colocar a sessão em background.

301* **Uma mensagem enfileirada não pode ser movida**: as mensagens que você [enfileirou enquanto Claude estava trabalhando](/docs/pt/interactive-mode#queue-messages-while-claude-works) se movem para a sessão em background com a conversa. Quando uma delas não pode ser movida, a sessão permanece em primeiro plano e Claude Code mostra um aviso como `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.`301* **Uma mensagem enfileirada não pode ser movida**: as mensagens que você [enfileirou enquanto Claude estava trabalhando](/docs/pt/interactive-mode#queue-messages-while-claude-works) se movem para a sessão em background com a conversa. Quando uma delas não pode ser movida, a sessão permanece em primeiro plano e Claude Code mostra um aviso como `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.`

302 302 

303Quando Claude Code coloca a sessão em background, seja após cerca de dez segundos ou depois que você pressiona `←` novamente, ele interrompe um comando shell que Claude ainda está executando em primeiro plano. Claude Code não mostra o diálogo `Background this session?` para esse comando. Na sessão em background, Claude não tem registro de que o comando foi iniciado, então Claude pode executar o comando novamente. Para manter o comando em execução quando a sessão for movida, pressione `Ctrl+B` para [transformá-lo em um comando em background](/docs/pt/interactive-mode#background-bash-commands) enquanto Claude Code ainda está aguardando.

304 

303Pressionar `←` cria a linha da sessão mesmo quando a conversa não tem mensagens ainda, então `→` ainda retorna a ela.305Pressionar `←` cria a linha da sessão mesmo quando a conversa não tem mensagens ainda, então `→` ainda retorna a ela.

304 306 

305Você pode desativar este atalho para sessões em primeiro plano com a configuração [`leftArrowOpensAgents`](/docs/pt/settings-reference#leftarrowopensagents) em `/config`.307Você pode desativar este atalho para sessões em primeiro plano com a configuração [`leftArrowOpensAgents`](/docs/pt/settings-reference#leftarrowopensagents) em `/config`.

90 90 

91Quando a solicitação de seus limites de plano falha, na maioria das vezes porque o endpoint de uso está com limite de taxa, `/usage` mostra as últimas barras de uso que carregou nesta máquina nos últimos 60 minutos, junto com uma nota `Showing last-known usage` indicando há quanto tempo esses dados foram obtidos. Pressione `r` para tentar novamente; uma tentativa bem-sucedida substitui as últimas barras conhecidas por dados atualizados. Sem um snapshot dos últimos 60 minutos, `/usage` relata que o endpoint de uso está com limite de taxa e oferece o mesmo atalho de tentativa. Antes da v2.1.208, uma solicitação com limite de taxa em uma sessão que ainda não havia carregado uso sempre mostrava o erro sem barras.91Quando a solicitação de seus limites de plano falha, na maioria das vezes porque o endpoint de uso está com limite de taxa, `/usage` mostra as últimas barras de uso que carregou nesta máquina nos últimos 60 minutos, junto com uma nota `Showing last-known usage` indicando há quanto tempo esses dados foram obtidos. Pressione `r` para tentar novamente; uma tentativa bem-sucedida substitui as últimas barras conhecidas por dados atualizados. Sem um snapshot dos últimos 60 minutos, `/usage` relata que o endpoint de uso está com limite de taxa e oferece o mesmo atalho de tentativa. Antes da v2.1.208, uma solicitação com limite de taxa em uma sessão que ainda não havia carregado uso sempre mostrava o erro sem barras.

92 92 

93<h3 id="read-the-token-count-beside-the-spinner">

94 Leia a contagem de tokens ao lado do spinner

95</h3>

96 

97Enquanto Claude trabalha na conversa principal, a linha ao lado do spinner pode terminar com um tempo decorrido e uma contagem de tokens, como em `Deciphering… (10m 27s · ↓ 5.5k tokens)`. É uma contagem ao vivo e aproximada da saída que o turno atual produziu até o momento. A seta ao lado da contagem aponta para baixo enquanto a saída chega ou ferramentas são executadas.

98 

99* **O que ela abrange**: a saída que o turno gera, como o texto e as chamadas de ferramenta que Claude transmite de volta, seu pensamento e a saída de subagentes executados em [primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background)

100* **O que ela deixa de fora**: o que Claude Code envia ao modelo, portanto, seu prompt, o histórico da conversa e o resto do seu contexto não a alteram

101* **Quando ela é redefinida**: no início de cada turno e quando Claude Code [compacta a conversa](/docs/pt/prompt-caching#compacting-the-conversation)

102* **Quando ela permanece oculta**: até que a saída comece a chegar, quando a linha é estreita demais para exibi-la e no [modo de leitor de tela](/docs/pt/accessibility)

103 

104Ela não corresponderá às figuras de saída de `Usage by model` no bloco Session de `/usage`, que somam a sessão inteira em vez de um único turno. Ela também difere da contagem de tokens que o [modo verbose adiciona](/docs/pt/statusline#notifications-share-the-status-line-row), porque essa contagem mede o tamanho do seu contexto em vez da saída de um turno.

105 

93<h3 id="analyze-your-usage-patterns">106<h3 id="analyze-your-usage-patterns">

94 Analise seus padrões de uso107 Analise seus padrões de uso

95</h3>108</h3>

127| Um valor de `settings.json` parece ser ignorado | A mesma chave está definida em `settings.local.json` | `settings.local.json` substitui `settings.json`, e ambos substituem `~/.claude/settings.json`. Consulte [precedência de configurações](/docs/pt/settings#settings-precedence). |127| Um valor de `settings.json` parece ser ignorado | A mesma chave está definida em `settings.local.json` | `settings.local.json` substitui `settings.json`, e ambos substituem `~/.claude/settings.json`. Consulte [precedência de configurações](/docs/pt/settings#settings-precedence). |

128| Skill não aparece em `/skills` | O arquivo de skill está em `.claude/skills/name.md` em vez de em uma pasta | Use uma pasta com `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |128| Skill não aparece em `/skills` | O arquivo de skill está em `.claude/skills/name.md` em vez de em uma pasta | Use uma pasta com `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |

129| Skill aparece em `/skills` mas Claude nunca o invoca | Skill tem `disable-model-invocation: true` em seu frontmatter, ou sua descrição não corresponde a como você frasa a solicitação | Verifique o badge em `/skills`: um rótulo "user-only" significa que Claude não o acionará por conta própria. Consulte [invocação de skill](/docs/pt/skills). |129| Skill aparece em `/skills` mas Claude nunca o invoca | Skill tem `disable-model-invocation: true` em seu frontmatter, ou sua descrição não corresponde a como você frasa a solicitação | Verifique o badge em `/skills`: um rótulo "user-only" significa que Claude não o acionará por conta própria. Consulte [invocação de skill](/docs/pt/skills). |

130| As instruções de `CLAUDE.md` do subdiretório parecem ser ignoradas | Os arquivos do subdiretório são carregados sob demanda, não no início da sessão | Consulte [quando os arquivos de subdiretório são carregados](/docs/pt/memory#how-claude-md-files-load). Antes da v2.1.288, apenas a ferramenta Read os carregava. |130| As instruções de `CLAUDE.md` do subdiretório parecem ser ignoradas | Os arquivos do subdiretório são carregados sob demanda, não no início da sessão | Para carregar o `CLAUDE.md` de um subdiretório, peça ao Claude para ler outro arquivo nesse subdiretório. Consulte [quando os arquivos de subdiretório são carregados](/docs/pt/memory#how-claude-md-files-load). |

131| Subagente ignora as instruções de `CLAUDE.md` | Os agentes Explore e Plan integrados pulam `CLAUDE.md`. Um subagente personalizado o carrega da mesma forma que a conversa principal, a menos que sua definição defina [`omitClaudeMd`](/docs/pt/sub-agents#supported-frontmatter-fields) | Para Explore ou Plan, reafirme a instrução em seu prompt de delegação. Para um subagente que define `omitClaudeMd`, remova o campo. Para qualquer outro subagente personalizado, coloque instruções críticas no corpo do arquivo do agente, que se torna o prompt do sistema do agente. Consulte [o que é carregado na inicialização](/docs/pt/sub-agents#what-loads-at-startup). |131| Subagente ignora as instruções de `CLAUDE.md` | Os agentes Explore e Plan integrados pulam `CLAUDE.md`. Um subagente personalizado o carrega da mesma forma que a conversa principal, a menos que sua definição defina [`omitClaudeMd`](/docs/pt/sub-agents#supported-frontmatter-fields) | Para Explore ou Plan, reafirme a instrução em seu prompt de delegação. Para um subagente que define `omitClaudeMd`, remova o campo. Para qualquer outro subagente personalizado, coloque instruções críticas no corpo do arquivo do agente, que se torna o prompt do sistema do agente. Consulte [o que é carregado na inicialização](/docs/pt/sub-agents#what-loads-at-startup). |

132| A lógica de limpeza nunca é executada no final da sessão | Nenhum hook `SessionEnd` configurado | Adicione um hook `SessionEnd` em `settings.json`. Consulte a [lista de eventos de hook](/docs/pt/hooks#hook-events). |132| A lógica de limpeza nunca é executada no final da sessão | Nenhum hook `SessionEnd` configurado | Adicione um hook `SessionEnd` em `settings.json`. Consulte a [lista de eventos de hook](/docs/pt/hooks#hook-events). |

133| Servidores MCP em `.mcp.json` nunca são carregados | O arquivo está sob `.claude/`, ou seus servidores estão sob uma chave `servers` de nível superior, como no `mcp.json` do VS Code, em vez de `mcpServers` | A configuração MCP do projeto vai na raiz do repositório como `.mcp.json`, não dentro de `.claude/`, com servidores sob a chave `mcpServers`. Consulte [configuração MCP](/docs/pt/mcp). |133| Servidores MCP em `.mcp.json` nunca são carregados | O arquivo está sob `.claude/`, ou seus servidores estão sob uma chave `servers` de nível superior, como no `mcp.json` do VS Code, em vez de `mcpServers` | A configuração MCP do projeto vai na raiz do repositório como `.mcp.json`, não dentro de `.claude/`, com servidores sob a chave `mcpServers`. Consulte [configuração MCP](/docs/pt/mcp). |

256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para desativar todas as funcionalidades de tarefas em segundo plano, incluindo o parâmetro `run_in_background` nas ferramentas Bash e de subagente, o envio automático para segundo plano e o atalho Ctrl+B |256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para desativar todas as funcionalidades de tarefas em segundo plano, incluindo o parâmetro `run_in_background` nas ferramentas Bash e de subagente, o envio automático para segundo plano e o atalho Ctrl+B |

257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Defina como `1` para impedir que o Claude Code trate uma resposta de streaming do [Amazon Bedrock](/docs/pt/amazon-bedrock) com um cabeçalho `Content-Type` ausente ou vazio como o stream de eventos binário do Amazon Bedrock. Por padrão, o Claude Code presume que um gateway removeu o cabeçalho de uma resposta que, de resto, não foi modificada; então ele decodifica o corpo e o streaming continua funcionando. Defina-a apenas para um gateway que também reemite o stream como server-sent events; o Claude Code então lê o corpo sem cabeçalho como server-sent events. Requer o Claude Code v2.1.239 ou posterior |257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Defina como `1` para impedir que o Claude Code trate uma resposta de streaming do [Amazon Bedrock](/docs/pt/amazon-bedrock) com um cabeçalho `Content-Type` ausente ou vazio como o stream de eventos binário do Amazon Bedrock. Por padrão, o Claude Code presume que um gateway removeu o cabeçalho de uma resposta que, de resto, não foi modificada; então ele decodifica o corpo e o streaming continua funcionando. Defina-a apenas para um gateway que também reemite o stream como server-sent events; o Claude Code então lê o corpo sem cabeçalho como server-sent events. Requer o Claude Code v2.1.239 ou posterior |

258| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Defina como `1` para ignorar a verificação de que uma resposta de streaming do [Amazon Bedrock](/docs/pt/amazon-bedrock) tem o content-type `application/vnd.amazon.eventstream`. Sem esta variável, quando uma resposta tem um content-type diferente, o Claude Code faz a requisição falhar com um erro que nomeia esse tipo, o que significa que um [gateway ou proxy está transformando a resposta](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configure o gateway para encaminhar o cabeçalho `Content-Type` e o corpo sem modificações, em vez de definir esta variável. Requer o Claude Code v2.1.208 ou posterior |258| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Defina como `1` para ignorar a verificação de que uma resposta de streaming do [Amazon Bedrock](/docs/pt/amazon-bedrock) tem o content-type `application/vnd.amazon.eventstream`. Sem esta variável, quando uma resposta tem um content-type diferente, o Claude Code faz a requisição falhar com um erro que nomeia esse tipo, o que significa que um [gateway ou proxy está transformando a resposta](/docs/pt/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configure o gateway para encaminhar o cabeçalho `Content-Type` e o corpo sem modificações, em vez de definir esta variável. Requer o Claude Code v2.1.208 ou posterior |

259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Defina como `1` para interromper os comandos de shell em segundo plano em execução, os workflows dinâmicos e, a partir da v2.1.198, os subagentes em segundo plano de uma [sessão em segundo plano](/docs/pt/agent-view) quando o [supervisor](/docs/pt/agent-view#the-supervisor-process) para, reinicia ou atualiza o processo dessa sessão, em vez de transferi-los para o próximo processo da sessão. Afeta apenas essa transferência: enviar uma sessão para segundo plano com `←` ou [`/background`](/docs/pt/agent-view#from-inside-a-session) ainda transfere o trabalho em andamento, e `CLAUDE_DISABLE_ADOPT` desativa ambos. Requer o Claude Code v2.1.196 ou posterior |259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Defina como `1` para interromper os comandos de shell em segundo plano em execução, os workflows dinâmicos e, a partir da v2.1.198, os subagentes em segundo plano de uma [sessão em segundo plano](/docs/pt/agent-view) quando o [supervisor](/docs/pt/agent-view#the-supervisor-process) para, reinicia ou atualiza o processo dessa sessão, em vez de entregá-los ao próximo processo da sessão. Afeta apenas essa entrega: enviar uma sessão para segundo plano com `←` ou [`/background`](/docs/pt/agent-view#from-inside-a-session) continua transferindo o trabalho em segundo plano em andamento, e `CLAUDE_DISABLE_ADOPT` desativa ambos. Requer Claude Code v2.1.196 ou posterior |

260| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Defina como `1` para impedir que o Claude Code encerre [comandos de shell em segundo plano](/docs/pt/interactive-mode#background-bash-commands) sob pressão de memória. Por padrão, no macOS e no Linux, o Claude Code encerra shells em segundo plano quando o sistema operacional relata pressão crítica de memória RAM e a sessão está ociosa há 30 minutos sem nenhum turno ou subagente em execução. O Windows não tem sinal de pressão de memória, então esta variável não tem efeito nele. Requer o Claude Code v2.1.193 ou posterior |260| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Defina como `1` para impedir que o Claude Code encerre [comandos de shell em segundo plano](/docs/pt/interactive-mode#background-bash-commands) sob pressão de memória. Por padrão, no macOS e no Linux, o Claude Code encerra shells em segundo plano quando o sistema operacional relata pressão crítica de memória RAM e a sessão está ociosa há 30 minutos sem nenhum turno ou subagente em execução. O Windows não tem sinal de pressão de memória, então esta variável não tem efeito nele. Requer o Claude Code v2.1.193 ou posterior |

261| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Defina como `1` para desativar as [skills](/docs/pt/skills) e os workflows incluídos no Claude Code: as skills incluídas e os workflows incluídos são removidos por completo, enquanto comandos integrados como `/init` continuam podendo ser digitados, mas ficam ocultos do modelo. `/doctor` continua podendo ser digitado como os comandos integrados; oculte-o com `DISABLE_DOCTOR_COMMAND`. Skills de plugins, de `.claude/skills/` e de `.claude/commands/` não são afetadas. Equivalente à configuração [`disableBundledSkills`](/docs/pt/settings-reference#disablebundledskills) |261| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Defina como `1` para desativar as [skills](/docs/pt/skills) e os workflows incluídos no Claude Code: as skills incluídas e os workflows incluídos são removidos por completo, enquanto comandos integrados como `/init` continuam podendo ser digitados, mas ficam ocultos do modelo. `/doctor` continua podendo ser digitado como os comandos integrados; oculte-o com `DISABLE_DOCTOR_COMMAND`. Skills de plugins, de `.claude/skills/` e de `.claude/commands/` não são afetadas. Equivalente à configuração [`disableBundledSkills`](/docs/pt/settings-reference#disablebundledskills) |

262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Defina como `1` para manter as ferramentas de navegador do [Claude in Chrome](/docs/pt/chrome) disponíveis enquanto omite a seção do Chrome do system prompt e a [skill incluída](/docs/pt/skills#bundled-skills) `/claude-in-chrome`. Destinada a hosts que incorporam o Claude Code e fornecem suas próprias orientações de navegador. Requer o Claude Code v2.1.257 ou posterior |262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Defina como `1` para manter as ferramentas de navegador do [Claude in Chrome](/docs/pt/chrome) disponíveis enquanto omite a seção do Chrome do system prompt e a [skill incluída](/docs/pt/skills#bundled-skills) `/claude-in-chrome`. Destinada a hosts que incorporam o Claude Code e fornecem suas próprias orientações de navegador. Requer o Claude Code v2.1.257 ou posterior |

1308Fora da [renderização em tela cheia](/docs/pt/fullscreen), o Claude Code mostra notificações na mesma linha que sua linha de status. Na renderização em tela cheia, o Claude Code oferece às notificações uma linha própria.1308Fora da [renderização em tela cheia](/docs/pt/fullscreen), o Claude Code mostra notificações na mesma linha que sua linha de status. Na renderização em tela cheia, o Claude Code oferece às notificações uma linha própria.

1309 1309 

1310* Notificações do sistema como erros de servidor MCP e atualizações automáticas são exibidas no lado direito da linha. Notificações transitórias como o aviso de contexto baixo também circulam por esta área.1310* Notificações do sistema como erros de servidor MCP e atualizações automáticas são exibidas no lado direito da linha. Notificações transitórias como o aviso de contexto baixo também circulam por esta área.

1311* Habilitar modo verbose adiciona um contador de tokens a esta área1311* Habilitar modo verbose adiciona um contador de tokens a esta área, mostrando o tamanho do seu contexto conforme relatado pela última resposta de API, e não a [contagem por turno ao lado do indicador de carregamento](/docs/pt/costs#read-the-token-count-beside-the-spinner)

1312* Em terminais estreitos, essas notificações podem truncar sua saída de linha de status1312* Em terminais estreitos, essas notificações podem truncar sua saída de linha de status