Documentation 2026-10-10 23:01 UTC to 2026-10-11 21:02 UTC

3263 Tipos de Entrada de Ferramenta3263 Tipos de Entrada de Ferramenta

3264</h2>3264</h2>

3265 3265 

3266Documentação de esquemas de entrada para todas as ferramentas integradas do Claude Code. Esses tipos são exportados de `@anthropic-ai/claude-agent-sdk/sdk-tools` e podem ser usados para interações de ferramenta type-safe.3266Documentação de esquemas de entrada para ferramentas integradas do Claude Code. Esses tipos são exportados de `@anthropic-ai/claude-agent-sdk/sdk-tools` e podem ser usados para interações de ferramenta type-safe.

3267 3267 

3268<h3 id="toolinputschemas">3268<h3 id="toolinputschemas">

3269 `ToolInputSchemas`3269 `ToolInputSchemas`

4079 Tipos de Saída de Ferramentas4079 Tipos de Saída de Ferramentas

4080</h2>4080</h2>

4081 4081 

4082Documentação dos esquemas de saída para todas as ferramentas Claude Code integradas. Esses tipos são exportados de `@anthropic-ai/claude-agent-sdk/sdk-tools` e representam os dados de resposta reais retornados por cada ferramenta.4082Documentação dos esquemas de saída para as ferramentas Claude Code integradas. Esses tipos são exportados de `@anthropic-ai/claude-agent-sdk/sdk-tools` e representam os dados de resposta reais retornados por cada ferramenta.

4083 4083 

4084<h3 id="tooloutputschemas">4084<h3 id="tooloutputschemas">

4085 `ToolOutputSchemas`4085 `ToolOutputSchemas`

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>

98 98 

99O modo seguro ainda aplica hooks gerenciados e política de configurações da sua organização. Plugins gerenciados, skills, `CLAUDE.md` e servidores MCP são desativados.99O modo seguro ainda aplica hooks gerenciados e política de configurações da sua organização. Plugins gerenciados, skills, `CLAUDE.md` e servidores MCP são desativados.

100 100 

101Se o problema persistir no modo seguro, ou suas configurações em si forem suspeitas, compare contra uma sessão que não carrega nada de sua configuração usual. Aponte [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars) para um diretório vazio para contornar tudo sob `~/.claude` e inicie a partir de um diretório que não tenha pasta `.claude`, `.mcp.json` ou `CLAUDE.md` para que a configuração do projeto também seja ignorada.101Se o problema persistir no modo seguro, ou suas configurações em si forem suspeitas, inicie uma sessão sem nenhuma configuração própria e verifique se o problema continua.

102 102 

103```bash theme={null}103<Steps>

104cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude104 <Step title="Crie um diretório vazio e entre nele">

105```105 No seu shell, sem nenhuma sessão do Claude Code em execução, crie o diretório e entre nele:

106 106 

107A sessão limpa não tem configurações de usuário ou projeto, hooks, servidores MCP, plugins ou memória. No primeiro lançamento, espere as telas de configuração inicial, começando com seleção de tema. Se você as vir, o diretório de configuração limpa está em vigor. Lançamentos posteriores com o mesmo diretório pulam essas telas porque Claude Code salva o estado de integração lá.107 <Tabs>

108 108 <Tab title="Bash ou Zsh">

109* As configurações gerenciadas ainda se aplicam se sua organização as implanta. Claude Code lê perfis MDM, política de registro e `managed-settings.json` de locais fora do diretório de configuração, e [busca configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings#fetch-and-caching-behavior) novamente para a sessão limpa uma vez que tenha credenciais109 ```bash theme={null}

110* Você será solicitado a fazer login novamente110 mkdir -p ~/claude-clean/empty && cd ~/claude-clean/empty

111 111 ```

112Se o problema desaparecer aqui, a causa está em algum lugar em seus arquivos reais `~/.claude` ou `.claude` do projeto. Reintroduza-os um de cada vez, copiando arquivos para o diretório temporário ou iniciando a partir de seu projeto, para encontrar qual. Se persistir na sessão limpa, a causa está fora de sua configuração de usuário e projeto. Execute `/status` para verificar se as configurações gerenciadas estão em vigor, procure por [variáveis de ambiente](/docs/pt/env-vars) que afetam Claude Code e consulte [Solução de problemas](/docs/pt/troubleshooting).112 </Tab>

113 

114 <Tab title="PowerShell">

115 ```powershell theme={null}

116 New-Item -ItemType Directory -Force "$HOME/claude-clean/empty" | Out-Null

117 Set-Location "$HOME/claude-clean/empty"

118 ```

119 </Tab>

120 </Tabs>

121 </Step>

122 

123 <Step title="Inicie o Claude Code com um diretório de configuração limpo">

124 No mesmo shell, defina [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars) como um diretório novo no lugar de `~/.claude` e passe [`--setting-sources user`](/docs/pt/cli-reference#cli-flags) para desativar a configuração do projeto, como `.claude/settings.json`, `CLAUDE.md` e `.mcp.json`:

125 

126 <Tabs>

127 <Tab title="Bash ou Zsh">

128 A variável se aplica apenas a este lançamento.

129 

130 ```bash theme={null}

131 CLAUDE_CONFIG_DIR=~/claude-clean/config claude --setting-sources user

132 ```

133 </Tab>

134 

135 <Tab title="PowerShell">

136 A variável permanece definida pelo restante desta sessão do PowerShell, portanto lançamentos posteriores de `claude` na mesma janela continuam usando o diretório limpo. Para voltar ao seu diretório habitual, execute `Remove-Item Env:CLAUDE_CONFIG_DIR` antes do próximo lançamento.

137 

138 ```powershell theme={null}

139 $env:CLAUDE_CONFIG_DIR = "$HOME/claude-clean/config"

140 claude --setting-sources user

141 ```

142 </Tab>

143 </Tabs>

144 

145 No primeiro lançamento, você passa novamente pelas telas de configuração inicial, um sinal de que o diretório de configuração limpo está em vigor. As configurações gerenciadas ainda se aplicam, e os [conectores](/docs/pt/mcp#use-mcp-servers-from-claude-ai) ainda são carregados se você fizer login com uma conta claude.ai.

146 </Step>

147 

148 <Step title="Reproduza o problema">

149 Repita o que desencadeou o problema na sessão limpa:

150 

151 * **Problema desapareceu**: a causa está na sua configuração de usuário ou de projeto. Copie `~/.claude.json` e os arquivos em `~/.claude` para `~/claude-clean/config`, um de cada vez. Se nenhum deles trouxer o problema de volta, vá para o diretório do seu projeto no mesmo shell e inicie o Claude Code sem `--setting-sources user`. No Bash ou Zsh, execute `CLAUDE_CONFIG_DIR=~/claude-clean/config claude`. No PowerShell, a variável ainda está definida, então execute `claude`.

152 * **Problema persiste**: a causa está fora da sua configuração de usuário e de projeto. Execute `/status` na sessão para verificar as configurações gerenciadas, verifique seu shell em busca de [variáveis de ambiente](/docs/pt/env-vars) e consulte [Solução de problemas](/docs/pt/troubleshooting).

153 </Step>

154</Steps>

113 155 

114<h2 id="check-common-causes">156<h2 id="check-common-causes">

115 Verifique as causas comuns157 Verifique as causas comuns

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). |169| 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`. |170| 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). |171| 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. |172| 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). |173| 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). |174| 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). |175| 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). |

913 913 

914Cada entrada requer `id`, `name` e `sshHost`. Os campos `sshPort` e `sshIdentityFile` são opcionais. Os usuários também podem adicionar `sshConfigs` ao seu próprio `~/.claude/settings.json`.914Cada entrada requer `id`, `name` e `sshHost`. Os campos `sshPort` e `sshIdentityFile` são opcionais. Os usuários também podem adicionar `sshConfigs` ao seu próprio `~/.claude/settings.json`.

915 915 

916Se você omitir `user@` em `sshHost`, o Desktop se conecta como o `User` que o `~/.ssh/config` de cada desenvolvedor define para o host ou, caso contrário, como o nome de usuário dele em seu próprio computador.

917 

916<h4 id="restrict-which-ssh-hosts-users-can-connect-to">918<h4 id="restrict-which-ssh-hosts-users-can-connect-to">

917 Restrict which SSH hosts users can connect to919 Restrict which SSH hosts users can connect to

918</h4>920</h4>

937 939 

938`sshHostAllowlist` é lido apenas de managed settings; valores em configurações de usuário ou projeto são ignorados. Apenas o aplicativo Claude Desktop honra esta configuração; a CLI Claude Code e extensões IDE não a leem, e não restringe comandos `ssh` executados através da ferramenta Bash. Governa quais hosts o aplicativo Desktop se conecta, não saída de rede, portanto combine-o com controles de rede ou zero-trust da sua organização se você precisar de um limite rígido.940`sshHostAllowlist` é lido apenas de managed settings; valores em configurações de usuário ou projeto são ignorados. Apenas o aplicativo Claude Desktop honra esta configuração; a CLI Claude Code e extensões IDE não a leem, e não restringe comandos `ssh` executados através da ferramenta Bash. Governa quais hosts o aplicativo Desktop se conecta, não saída de rede, portanto combine-o com controles de rede ou zero-trust da sua organização se você precisar de um limite rígido.

939 941 

942<h4 id="turn-off-local-sessions-and-distribute-ssh-connections">

943 Desativar sessões locais e distribuir conexões SSH

944</h4>

945 

946Para desativar sessões locais e limitar as sessões SSH aos hosts que você escolher, implante [`disableDesktopLocalSessions`](/docs/pt/settings-reference#disabledesktoplocalsessions), [`sshConfigs`](#pre-configure-ssh-connections-for-your-team) e [`sshHostAllowlist`](#restrict-which-ssh-hosts-users-can-connect-to) juntos.

947 

948<Note>

949 Esta configuração é para usuários que fazem login com uma conta Claude. Com um [provedor de terceiros](/docs/pt/third-party-integrations), as sessões SSH ficam desativadas por padrão, e definir `sshHostAllowlist` pode ativá-las. Leia [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) antes de implantar essas chaves.

950</Note>

951 

952O exemplo a seguir desativa as sessões locais, adiciona uma conexão e limita as sessões SSH ao host dessa conexão:

953 

954```json managed-settings.json theme={null}

955{

956 "disableDesktopLocalSessions": true,

957 "sshConfigs": [

958 {

959 "id": "shared-dev-vm",

960 "name": "Shared Dev VM",

961 "sshHost": "dev.example.com"

962 }

963 ],

964 "sshHostAllowlist": ["dev.example.com"]

965}

966```

967 

968As chaves se aplicam ao aplicativo desktop. Elas não alteram outras formas de executar Claude Code, como a CLI, o Cowork e as sessões na nuvem:

969 

970* **A CLI**: nenhuma das chaves impede um desenvolvedor de executar a CLI do Claude Code em seu próprio computador

971* **Cowork**: nenhuma das chaves se aplica a sessões do [Cowork](https://claude.com/docs/cowork/overview) ou a tarefas agendadas do Cowork

972* **Sessões na nuvem**: nenhuma das chaves altera se as [sessões na nuvem](#cloud-sessions) estão disponíveis. Para desativá-las, use a configuração **Cloud sessions** em [Admin console controls](#admin-console-controls).

973 

974Ao adaptar o exemplo, verifique os nomes de host e a versão do Desktop:

975 

976* **Nomes de host**: certifique-se de que um padrão em `sshHostAllowlist` corresponda ao nome de host de cada entrada de `sshConfigs`, sem `user@`, ou os desenvolvedores não conseguirão se conectar a ela. Para saber como o Desktop faz a correspondência de um nome de host, veja [Restrict which SSH hosts users can connect to](#restrict-which-ssh-hosts-users-can-connect-to).

977* **Versão**: `disableDesktopLocalSessions` requer Claude Desktop v1.37937.0 ou posterior

978 

979Coloque as três chaves em uma única [fonte gerenciada](/docs/pt/managed-settings#how-claude-code-combines-managed-sources), a de maior prioridade que você fornece. Se você fornece [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings), mantenha também uma cópia das três chaves na política MDM ou no arquivo de configurações gerenciadas de maior prioridade em cada computador. O Desktop busca as configurações gerenciadas pelo servidor na inicialização, e a cópia no computador se aplica até que uma busca seja bem-sucedida.

980 

981Para confirmar que as configurações se aplicam, verifique o computador de um desenvolvedor:

982 

983<Steps>

984 <Step title="Verificar o menu suspenso de ambiente">

985 Feche e reabra o Desktop e, em seguida, abra o menu suspenso de ambiente na caixa de prompt. **Local** fica acinzentado, e **Shared Dev VM** aparece em **SSH**. Se **Local** ainda estiver disponível, verifique a versão do Desktop, se o arquivo é um JSON válido e qual fonte gerenciada o computador lê.

986 </Step>

987 

988 <Step title="Adicionar um host que não está na allowlist">

989 [Adicione uma conexão SSH](#ssh-sessions) com um nome de host que não está na allowlist, como `other.example.com`. O Desktop salva a conexão, mas se recusa a conectar e informa que as configurações da sua organização não permitem a conexão.

990 </Step>

991</Steps>

992 

940<h2 id="enterprise-configuration">993<h2 id="enterprise-configuration">

941 Configuração corporativa994 Configuração corporativa

942</h2>995</h2>

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 |

4039 4039 

4040**O que fazer:**4040**O que fazer:**

4041 4041 

4042* Execute `claude plugin marketplace remove <name>`. Isso também desinstala os plugins instalados do marketplace e deleta seus dados salvos4042* Para manter um marketplace que um arquivo de configurações declara inline com `"source": "settings"`, renomeie-o antes de remover o nome antigo, porque remover o marketplace também exclui sua entrada dos seus arquivos de configurações. Claude Code v2.1.292 ou posterior lista estas etapas na mensagem:

4043* Para manter o marketplace em vez disso, aguarde até que seu mantenedor o renomeie, depois execute `claude plugin marketplace update <name>`4043 1. Em cada arquivo de configurações que lista o marketplace em `extraKnownMarketplaces`, dê à chave da entrada e ao seu `source.name` um mesmo nome novo em ASCII simples que não se pareça com um oficial. Se um administrador adiciona o marketplace por meio das configurações gerenciadas da sua organização, o administrador realiza esta etapa

4044 2. Execute `claude plugin marketplace remove <old-name>`, ou remova o nome antigo na aba **Marketplaces** do `/plugin`. Isso também desinstala seus plugins e exclui seus dados, opções e segredos

4045 3. Inicie o Claude Code novamente, na pasta do projeto se o arquivo for um arquivo de configurações de projeto. Depois instale os plugins a partir do marketplace renomeado

4046* Para manter qualquer outro marketplace, aguarde até que seu mantenedor o renomeie, depois execute `claude plugin marketplace update <name>`

4047* Para remover o marketplace, execute `claude plugin marketplace remove <name>`. Isso também desinstala os plugins instalados do marketplace e exclui seus dados, opções e segredos

4044* Se você publica o marketplace, renomeie-o em seu `marketplace.json`; os usuários então atualizam o marketplace em vez de removê-lo4048* Se você publica o marketplace, renomeie-o em seu `marketplace.json`; os usuários então atualizam o marketplace em vez de removê-lo

4045 4049 

4046<h3 id="marketplace-is-already-added-from-a-different-source">4050<h3 id="marketplace-is-already-added-from-a-different-source">

3321 WorktreeCreate3321 WorktreeCreate

3322</h3>3322</h3>

3323 3323 

3324É executado quando um worktree está sendo criado, seja a partir de `claude --worktree`, de um [subagente usando `isolation: "worktree"`](/docs/pt/sub-agents#choose-the-subagent-scope), ou para uma [sessão em segundo plano](/docs/pt/agent-view#how-file-edits-are-isolated) que o Claude Code isola em seu próprio worktree. Por padrão, o Claude Code cria a cópia de trabalho isolada com `git worktree`. Configurar um hook WorktreeCreate substitui esse comportamento padrão do git, permitindo que você use um sistema de controle de versão diferente, como SVN, Perforce ou Mercurial.3324É executado quando o Claude Code cria um worktree em casos como estes:

3325 

3326* Você inicia uma sessão com `claude --worktree`

3327* O Claude cria um worktree durante uma sessão e muda para ele com a ferramenta [`EnterWorktree`](/docs/pt/tools-reference)

3328* Um [subagente usa `isolation: "worktree"`](/docs/pt/sub-agents#choose-the-subagent-scope)

3329* Um [fluxo de trabalho](/docs/pt/workflows#migrate-many-files-in-parallel) executa um agente em seu próprio worktree

3330* O Claude Code isola uma [sessão em segundo plano](/docs/pt/agent-view#how-file-edits-are-isolated) em seu próprio worktree

3331* [`claude remote-control`](/docs/pt/remote-control#start-a-remote-control-session) no modo `worktree` inicia uma sessão em seu próprio worktree

3332 

3333Quando o Claude executa `git worktree add` por meio da ferramenta Bash em vez de chamar `EnterWorktree`, seu hook WorktreeCreate não é executado. Para inspecionar ou bloquear esse comando, adicione um hook [`PreToolUse`](#pretooluse) com o matcher `Bash`.

3334 

3335Por padrão, o Claude Code cria a cópia de trabalho isolada com `git worktree`. Configurar um hook WorktreeCreate substitui esse comportamento padrão do git, permitindo que você use um sistema de controle de versão diferente, como SVN, Perforce ou Mercurial.

3325 3336 

3326Como o hook substitui totalmente o comportamento padrão, o [`.worktreeinclude`](/docs/pt/worktrees#copy-gitignored-files-into-worktrees) não é processado. Se você precisar copiar arquivos de configuração locais como `.env` para o novo worktree, faça isso dentro do seu script de hook.3337Como o hook substitui totalmente o comportamento padrão, o [`.worktreeinclude`](/docs/pt/worktrees#copy-gitignored-files-into-worktrees) não é processado. Se você precisar copiar arquivos de configuração locais como `.env` para o novo worktree, faça isso dentro do seu script de hook.

3327 3338 

3390* Você sai de uma [sessão de worktree](/docs/pt/worktrees#start-claude-in-a-worktree) interativa e opta por remover o worktree quando o Claude Code pergunta3401* Você sai de uma [sessão de worktree](/docs/pt/worktrees#start-claude-in-a-worktree) interativa e opta por remover o worktree quando o Claude Code pergunta

3391* Você sai de uma sessão de worktree interativa que não [nomeou](/docs/pt/sessions#name-your-sessions), o Claude Code não encontra arquivos alterados ou não rastreados, e remove o worktree sem perguntar3402* Você sai de uma sessão de worktree interativa que não [nomeou](/docs/pt/sessions#name-your-sessions), o Claude Code não encontra arquivos alterados ou não rastreados, e remove o worktree sem perguntar

3392* Você exclui uma [sessão em segundo plano](/docs/pt/agent-view#what-deleting-a-session-removes) que é executada no worktree3403* Você exclui uma [sessão em segundo plano](/docs/pt/agent-view#what-deleting-a-session-removes) que é executada no worktree

3404* Você pede ao Claude para sair e remover o worktree durante uma sessão, e o Claude o remove com a ferramenta [`ExitWorktree`](/docs/pt/tools-reference)

3405* Uma sessão que [`claude remote-control`](/docs/pt/remote-control#start-a-remote-control-session) iniciou no modo `worktree` termina sem travar, e o Claude Code não encontra arquivos alterados ou não rastreados nem novos commits em seu worktree

3406* Você para o `claude remote-control` enquanto sessões que ele iniciou no modo `worktree` ainda estão em execução, e o Claude Code não encontra arquivos alterados ou não rastreados nem novos commits em seus worktrees

3407 

3408Quando um subagente ou um agente de fluxo de trabalho termina, o Claude Code mantém o worktree que seu hook WorktreeCreate criou para ele e não executa seu hook WorktreeRemove. Remova esses worktrees você mesmo quando o trabalho estiver concluído.

3409 

3410O Claude Code não pede confirmação antes de seu hook ser executado para uma chamada `ExitWorktree` ou uma limpeza do `claude remote-control`. `ExitWorktree` se recusa a remover um worktree criado por hook, a menos que a chamada passe [`discard_changes: true`](/docs/pt/agent-sdk/typescript#exitworktree), o que torna seu hook a última verificação nesse caminho.

3393 3411 

3394O Claude Code usa o git para procurar arquivos alterados ou não rastreados, então não encontra nenhum em um worktree que não seja um checkout git nem esteja dentro de um, mesmo quando o diretório contém trabalho não commitado. Verifique esse trabalho no seu hook WorktreeRemove antes que ele exclua qualquer coisa.3412O Claude Code usa o git para procurar arquivos alterados ou não rastreados, então não encontra nenhum em um worktree que não seja um checkout git nem esteja dentro de um, mesmo quando o diretório contém trabalho não commitado. Verifique esse trabalho no seu hook WorktreeRemove antes que ele exclua qualquer coisa.

3395 3413 

3396Para worktrees baseados em git, o Claude Code cuida da limpeza automaticamente com `git worktree remove`. Se você configurou um hook WorktreeCreate, combine-o com um hook WorktreeRemove para controlar a limpeza dos worktrees que ele cria:3414Para worktrees baseados em git, o Claude Code faz a limpeza automaticamente com `git worktree remove`. Se você configurou um hook WorktreeCreate, combine-o com um hook WorktreeRemove para controlar a limpeza:

3397 3415 

3398* **Sem hook WorktreeRemove**: quando o Claude Code remove o worktree ao sair de uma sessão de worktree, ele recorre a `git worktree remove --force` no caminho que seu hook WorktreeCreate retornou, de modo que um worktree que o git reconhece é removido. Um worktree que o git não reconhece, por exemplo um que seu hook criou com um sistema de controle de versão que não seja git, permanece no disco. Para saber o que a exclusão de uma [sessão em segundo plano](/docs/pt/agent-view#what-deleting-a-session-removes) faz com um worktree criado por hook, consulte as regras de exclusão do agent view.3416* **Sem hook WorktreeRemove**: o Claude Code recorre ao git para uma remoção na saída ou por meio de `ExitWorktree`, e mantém o worktree quando o `claude remote-control` faz a limpeza:

3417 * **Você sai de uma sessão de worktree, ou o Claude chama `ExitWorktree`**: o Claude Code remove o caminho que seu hook WorktreeCreate retornou como `git worktree remove --force` faria, de modo que um worktree que o git reconhece é removido. Um worktree que o git não reconhece, por exemplo um que seu hook criou com um sistema de controle de versão que não seja git, permanece no disco.

3418 * **O `claude remote-control` limpa o worktree de uma sessão**: o worktree permanece no disco, e o terminal que executa `claude remote-control` mostra `worktree removal failed, kept: <path>`.

3419 * **Você exclui uma sessão em segundo plano**: consulte [O que a exclusão de uma sessão remove](/docs/pt/agent-view#what-deleting-a-session-removes).

3399* **O hook sai com 0**: o worktree conta como removido. O Claude Code não lê mais nada do hook, então certifique-se de que seu hook excluiu o diretório.3420* **O hook sai com 0**: o worktree conta como removido. O Claude Code não lê mais nada do hook, então certifique-se de que seu hook excluiu o diretório.

3400* **O hook sai com código diferente de zero**: a remoção falha se o diretório em `worktree_path` ainda existir depois, e o worktree permanece no disco sem fallback para o git. Um hook que excluiu o diretório antes de sair com código diferente de zero conta como removido. Para saber como a falha é relatada, consulte [Entrada de WorktreeRemove](#worktreeremove-input).3421* **O hook sai com código diferente de zero**: a remoção falha se o diretório em `worktree_path` ainda existir depois, e o worktree permanece no disco sem fallback para o git. Um hook que excluiu o diretório antes de sair com código diferente de zero conta como removido. Para saber como a falha é relatada, consulte [Entrada de WorktreeRemove](#worktreeremove-input).

3401 3422 

3403 3424 

3404O Claude Code descarta os [campos de saída JSON](#json-output) de um hook WorktreeRemove, como `systemMessage` e `continue`.3425O Claude Code descarta os [campos de saída JSON](#json-output) de um hook WorktreeRemove, como `systemMessage` e `continue`.

3405 3426 

3406Para a exclusão de uma sessão em segundo plano, o Claude Code verifica o caminho do worktree armazenado antes de executar o hook e recusa um caminho que seja um link simbólico ou que passe por um abaixo da raiz do repositório. O hook é executado para um worktree que ainda contém arquivos somente quando você confirma a exclusão no [agent view](/docs/pt/agent-view#what-deleting-a-session-removes); para esse tipo de worktree, [`claude rm`](/docs/pt/agent-view#manage-sessions-from-the-shell) mantém a sessão e o worktree. Antes da v2.1.216, o hook era executado no caminho armazenado sem essas verificações.3427Para a exclusão de uma sessão em segundo plano, o Claude Code verifica o caminho do worktree armazenado antes de executar o hook e recusa um caminho que seja um link simbólico ou passe por um abaixo da raiz do repositório. Nesse caminho, o hook é executado para um worktree que ainda contém arquivos somente quando você confirma a exclusão na [visualização de agentes](/docs/pt/agent-view#what-deleting-a-session-removes); para esse worktree, [`claude rm`](/docs/pt/agent-view#manage-sessions-from-the-shell) mantém a sessão e o worktree. Antes da v2.1.216, o hook era executado no caminho armazenado sem essas verificações.

3407 3428 

3408O Claude Code passa o caminho retornado por WorktreeCreate como `worktree_path` na entrada do hook. Este exemplo lê esse caminho e remove o diretório:3429O Claude Code passa o caminho retornado por WorktreeCreate como `worktree_path` na entrada do hook. Este exemplo lê esse caminho e remove o diretório:

3409 3430 

3444 3465 

3445* O worktree permanece no disco, e o comando do hook e o stderr vão para o [log de depuração](#debug-hooks).3466* O worktree permanece no disco, e o comando do hook e o stderr vão para o [log de depuração](#debug-hooks).

3446* Se você estava excluindo uma sessão em segundo plano, a sessão também permanece. A mensagem de recusa no [agent view](/docs/pt/agent-view#what-deleting-a-session-removes) informa como o hook terminou, como `exited 1`, cita o início do stderr e diz se excluir a sessão novamente remove o diretório mesmo assim.3467* Se você estava excluindo uma sessão em segundo plano, a sessão também permanece. A mensagem de recusa no [agent view](/docs/pt/agent-view#what-deleting-a-session-removes) informa como o hook terminou, como `exited 1`, cita o início do stderr e diz se excluir a sessão novamente remove o diretório mesmo assim.

3468* Se o `claude remote-control` estava limpando o worktree de uma sessão, o terminal que o executa mostra `worktree removal failed, kept: <path>`.

3447 3469 

3448<h3 id="precompact">3470<h3 id="precompact">

3449 PreCompact3471 PreCompact

55| Você quer | Comece com | Isolamento necessário | Notas |55| Você quer | Comece com | Isolamento necessário | Notas |

56| :- | :- | :- | :- |56| :- | :- | :- | :- |

57| Revisar cada ação você mesmo | Modo Manual: `claude --permission-mode default` | Nenhum | Trabalho sensível, código desconhecido |57| Revisar cada ação você mesmo | Modo Manual: `claude --permission-mode default` | Nenhum | Trabalho sensível, código desconhecido |

58| Iterar localmente com menos prompts, sem um classificador | Modo Manual mais o sandbox Bash em [modo auto-allow](/docs/pt/sandboxing#sandbox-modes): `claude --permission-mode default`, depois execute `/sandbox` e selecione auto-allow | O sandbox Bash integrado, em macOS, Linux e WSL2 | Regras de negação ainda se aplicam, e regras de solicitação que nomeiam um comando, como `Bash(git push *)`, ainda solicitam. Para ativar o sandbox a partir de um arquivo de configurações em vez disso, defina [`sandbox.enabled`](/docs/pt/settings-reference#sandbox-enabled) como `true` |58| Iterar localmente com menos prompts, sem um classificador | Modo Manual mais o sandbox Bash em [modo auto-allow](/docs/pt/sandboxing#sandbox-modes): `claude --permission-mode default`, depois execute `/sandbox` e selecione auto-allow | O sandbox Bash integrado, em macOS, Linux e WSL2 | Regras de negação ainda se aplicam, e regras de solicitação que nomeiam um comando, como `Bash(git push *)`, ainda solicitam. O [modo auto-allow](/docs/pt/sandboxing#auto-allow-mode) abrange outros comandos que podem solicitar confirmação. Para ativar o sandbox a partir de um arquivo de configurações em vez disso, defina [`sandbox.enabled`](/docs/pt/settings-reference#sandbox-enabled) como `true` |

59| Explorar antes de alterar qualquer coisa | `claude --permission-mode plan` | Nenhum | Claude Code bloqueia edições até que você [aprove um plano](#review-and-approve-a-plan) |59| Explorar antes de alterar qualquer coisa | `claude --permission-mode plan` | Nenhum | Claude Code bloqueia edições até que você [aprove um plano](#review-and-approve-a-plan) |

60| Trabalhar sem supervisão em modo automático | `claude --permission-mode auto`, o [modo de permissão inicial integrado](#which-mode-a-session-starts-in) com v2.1.283 ou posterior | Nenhum; um sandbox ou contêiner adiciona defesa em profundidade | Requer um [modelo suportado](#eliminate-prompts-with-auto-mode), e sua organização pode [desativar o modo automático](#eliminate-prompts-with-auto-mode) |60| Trabalhar sem supervisão em modo automático | `claude --permission-mode auto`, o [modo de permissão inicial integrado](#which-mode-a-session-starts-in) com v2.1.283 ou posterior | Nenhum; um sandbox ou contêiner adiciona defesa em profundidade | Requer um [modelo suportado](#eliminate-prompts-with-auto-mode), e sua organização pode [desativar o modo automático](#eliminate-prompts-with-auto-mode) |

61| Executar em CI com uma lista de permissões exata | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Nenhum além do que seu executor de CI fornece | [Cloud sessions](/docs/pt/claude-code-on-the-web) ignora `dontAsk` de arquivos de configurações |61| Executar em CI com uma lista de permissões exata | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Nenhum além do que seu executor de CI fornece | [Cloud sessions](/docs/pt/claude-code-on-the-web) ignora `dontAsk` de arquivos de configurações |

744* Regras de pergunta com escopo de conteúdo como `Bash(git push *)` ainda forçam uma solicitação744* Regras de pergunta com escopo de conteúdo como `Bash(git push *)` ainda forçam uma solicitação

745* Regras de negação explícitas ainda se aplicam745* Regras de negação explícitas ainda se aplicam

746* Comandos `rm` ou `rmdir` que visam um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda passam pelo fluxo de permissão regular746* Comandos `rm` ou `rmdir` que visam um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda passam pelo fluxo de permissão regular

747* Outros comandos em sandbox também podem passar pelo fluxo de permissão regular, conforme descrito em [modo de permissão automática](/docs/pt/sandboxing#auto-allow-mode)

747 748 

748Comandos que não serão executados em sandbox, como comandos excluídos, respeitam a regra de pergunta simples `Bash` como de costume. Veja [sandbox modes](/docs/pt/sandboxing#sandbox-modes) para alterar esse comportamento.749Comandos que não serão executados em sandbox, como comandos excluídos, respeitam a regra de pergunta simples `Bash` como de costume. Veja [sandbox modes](/docs/pt/sandboxing#sandbox-modes) para alterar esse comportamento.

749 750 

55* **Nomes começando com `claudeai-`**: reservado para marketplaces hospedados em claude.ai. `claude plugin marketplace add` recusa qualquer outro marketplace que use um com `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.55* **Nomes começando com `claudeai-`**: reservado para marketplaces hospedados em claude.ai. `claude plugin marketplace add` recusa qualquer outro marketplace que use um com `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.

56* **A pasta de download de um marketplace GitHub registrado, `<owner>-<repo>`**: Claude Code baixa um marketplace adicionado de uma origem `github` como `acme/x-tools` por meio de uma pasta chamada `acme-x-tools`, qualquer que seja o `name` próprio desse marketplace. Enquanto esse marketplace estiver registrado sob um nome diferente de `acme-x-tools`, `claude plugin marketplace add` recusa um marketplace diferente chamado `acme-x-tools` após baixá-lo e relata `Can't use the marketplace name "acme-x-tools"`. Esta verificação requer Claude Code v2.1.290 ou posterior.56* **A pasta de download de um marketplace GitHub registrado, `<owner>-<repo>`**: Claude Code baixa um marketplace adicionado de uma origem `github` como `acme/x-tools` por meio de uma pasta chamada `acme-x-tools`, qualquer que seja o `name` próprio desse marketplace. Enquanto esse marketplace estiver registrado sob um nome diferente de `acme-x-tools`, `claude plugin marketplace add` recusa um marketplace diferente chamado `acme-x-tools` após baixá-lo e relata `Can't use the marketplace name "acme-x-tools"`. Esta verificação requer Claude Code v2.1.290 ou posterior.

57 57 

58Quando um marketplace registrado para de carregar porque seu nome imita um oficial, `claude plugin list` e `/plugin` relatam `Claude Code refuses the marketplace name "<name>"`. A mensagem informa você a remover o marketplace. Removê-lo também desinstala seus plugins e exclui seus dados salvos. Esta mensagem de recusa nomeada requer Claude Code v2.1.282 ou posterior.58Quando um marketplace registrado para de carregar porque seu nome imita um oficial, `claude plugin list` e `/plugin` relatam `Claude Code refuses the marketplace name "<name>"`. A mensagem informa você a remover o marketplace. Removê-lo também desinstala seus plugins e exclui seus dados, opções e segredos. Esta mensagem de recusa nomeada requer Claude Code v2.1.282 ou posterior.

59 

60Se um arquivo de configurações declarar o marketplace inline, a mensagem informa você a renomear sua entrada antes de remover o nome antigo. Para as etapas, consulte [Claude Code refuses the marketplace name](/docs/pt/errors#claude-code-refuses-the-marketplace-name). A mensagem as lista no Claude Code v2.1.292 ou posterior.

59 61 

60<h2 id="top-level-fields">62<h2 id="top-level-fields">

61 Top-level fields63 Top-level fields

88| [`prompt.submit`](/docs/pt/plugins/mods/events#rewrite-or-add-to-a-prompt) | Um prompt é enviado | `next({ ...e, text })`, `next({ ...e, context })` ou `{ drop: reason }` |88| [`prompt.submit`](/docs/pt/plugins/mods/events#rewrite-or-add-to-a-prompt) | Um prompt é enviado | `next({ ...e, text })`, `next({ ...e, context })` ou `{ drop: reason }` |

89| `prompt.fill`, `prompt.suggest` | Um texto está prestes a entrar na caixa de prompt como rascunho ou como uma sugestão esmaecida | `next(e)` com o texto alterado |89| `prompt.fill`, `prompt.suggest` | Um texto está prestes a entrar na caixa de prompt como rascunho ou como uma sugestão esmaecida | `next(e)` com o texto alterado |

90| `prompt.edit` | O usuário edita a caixa de prompt | `next(e)` |90| `prompt.edit` | O usuário edita a caixa de prompt | `next(e)` |

91| `prompt.autocomplete` | O usuário digita na caixa de prompt e uma palavra termina no cursor. `e.token` é essa palavra. O Claude Code não espera pelo hook: suas próprias linhas de preenchimento automático aparecem primeiro. | `{ suggestions }`, uma lista de linhas `{ text, label, description }` exibidas abaixo das do próprio Claude Code. Escolher uma linha escreve seu `text` sobre a palavra. |

91| `prompt.compose` | O Claude Code renderiza um system prompt | `{ sections }`, uma lista de `{ id, text, scope }` na ordem em que são enviadas |92| `prompt.compose` | O Claude Code renderiza um system prompt | `{ sections }`, uma lista de `{ id, text, scope }` na ordem em que são enviadas |

92| [`prompt.section`](/docs/pt/plugins/mods/events#rewrite-or-add-to-a-prompt) | Uma vez para cada seção nomeada do system prompt. `e.name` é o `id` da seção em `prompt.compose`. | `{ text }`, ou `{ text: null }` para omitir a seção |93| [`prompt.section`](/docs/pt/plugins/mods/events#rewrite-or-add-to-a-prompt) | Uma vez para cada seção nomeada do system prompt. `e.name` é o `id` da seção em `prompt.compose`. | `{ text }`, ou `{ text: null }` para omitir a seção |

93| [`prompt.context`](/docs/pt/plugins/mods/events#rewrite-or-add-to-a-prompt) | Uma vez para cada conversa, para o contexto enviado com a primeira mensagem | `{ blocks }` |94| [`prompt.context`](/docs/pt/plugins/mods/events#rewrite-or-add-to-a-prompt) | Uma vez para cada conversa, para o contexto enviado com a primeira mensagem | `{ blocks }` |

64 | `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão gerados automaticamente quando nenhum nome explícito é definido. O padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito. |64 | `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão gerados automaticamente quando nenhum nome explícito é definido. O padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito. |

65 | `-c`, `--continue` | Recupere a sessão que o último servidor neste diretório iniciou, em vez de criar uma nova. Consulte [Retomar sessões após parar o servidor](#resume-sessions-after-stopping-the-server). Não pode ser combinado com `--session-id`, `--spawn`, `--capacity` ou `--create-session-in-dir`. Requer Claude Code v2.1.200 ou posterior. |65 | `-c`, `--continue` | Recupere a sessão que o último servidor neste diretório iniciou, em vez de criar uma nova. Consulte [Retomar sessões após parar o servidor](#resume-sessions-after-stopping-the-server). Não pode ser combinado com `--session-id`, `--spawn`, `--capacity` ou `--create-session-in-dir`. Requer Claude Code v2.1.200 ou posterior. |

66 | `--session-id <id>` | Recupere uma sessão por seu ID. Consulte [Retomar sessões após parar o servidor](#resume-sessions-after-stopping-the-server). Não pode ser combinado com `--continue`, `--spawn`, `--capacity` ou `--create-session-in-dir`. Requer Claude Code v2.1.200 ou posterior. |66 | `--session-id <id>` | Recupere uma sessão por seu ID. Consulte [Retomar sessões após parar o servidor](#resume-sessions-after-stopping-the-server). Não pode ser combinado com `--continue`, `--spawn`, `--capacity` ou `--create-session-in-dir`. Requer Claude Code v2.1.200 ou posterior. |

67 | `--spawn <mode>` | Como o servidor cria sessões.<br />• `same-dir` (padrão): todas as sessões compartilham o diretório de trabalho atual, portanto podem entrar em conflito se editarem os mesmos arquivos.<br />• `worktree`: cada sessão sob demanda obtém seu próprio [git worktree](/docs/pt/worktrees). Requer um repositório git.<br />• `session`: modo de sessão única. Serve exatamente uma sessão e rejeita conexões adicionais. Defina apenas na inicialização.<br />Pressione `w` em tempo de execução para alternar entre `same-dir` e `worktree`. |67 | `--spawn <mode>` | Como o servidor cria sessões.<br />• `same-dir` (padrão): todas as sessões compartilham o diretório de trabalho atual, portanto podem entrar em conflito se editarem os mesmos arquivos.<br />• `worktree`: cada sessão sob demanda obtém seu próprio [git worktree](/docs/pt/worktrees). Requer um repositório git ou um [hook `WorktreeCreate`](/docs/pt/hooks#worktreecreate).<br />• `session`: modo de sessão única. Serve exatamente uma sessão e rejeita conexões adicionais. Defina apenas na inicialização.<br />Pressione `w` em tempo de execução para alternar entre `same-dir` e `worktree`. |

68 | `--capacity <N>` | Número máximo de sessões simultâneas. O padrão é 32. Não pode ser usado com `--spawn=session`. |68 | `--capacity <N>` | Número máximo de sessões simultâneas. O padrão é 32. Não pode ser usado com `--spawn=session`. |

69 | `--[no-]create-session-in-dir` | Pré-crie uma sessão no diretório atual quando o servidor inicia, para que você tenha um lugar para digitar imediatamente. Em modo `worktree`, essa sessão permanece no diretório atual enquanto as sessões sob demanda obtêm worktrees isoladas. Ativado por padrão. Se você passar `--no-create-session-in-dir` para iniciar sem nenhuma, Claude Code arquiva as sessões do servidor quando você o para, portanto não há nada para [retomar](#resume-sessions-after-stopping-the-server). |69 | `--[no-]create-session-in-dir` | Pré-crie uma sessão no diretório atual quando o servidor inicia, para que você tenha um lugar para digitar imediatamente. Em modo `worktree`, essa sessão permanece no diretório atual enquanto as sessões sob demanda obtêm worktrees isoladas. Ativado por padrão. Se você passar `--no-create-session-in-dir` para iniciar sem nenhuma, Claude Code arquiva as sessões do servidor quando você o para, portanto não há nada para [retomar](#resume-sessions-after-stopping-the-server). |

70 | `--permission-mode <mode>` | Define o [modo de permissão](/docs/pt/permission-modes) inicial para as sessões do servidor, como `acceptEdits`. Aceita `manual` como um alias para `default`; um modo não reconhecido para o servidor na inicialização e lista os modos válidos. |70 | `--permission-mode <mode>` | Define o [modo de permissão](/docs/pt/permission-modes) inicial para as sessões do servidor, como `acceptEdits`. Aceita `manual` como um alias para `default`; um modo não reconhecido para o servidor na inicialização e lista os modos válidos. |

202* [Regras de negação](/docs/pt/permissions) explícitas são sempre respeitadas202* [Regras de negação](/docs/pt/permissions) explícitas são sempre respeitadas

203* Comandos `rm` ou `rmdir` que têm como alvo um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda passam pelo fluxo de permissão regular203* Comandos `rm` ou `rmdir` que têm como alvo um [caminho crítico](/docs/pt/permission-modes#critical-paths) ainda passam pelo fluxo de permissão regular

204* [Regras de solicitação](/docs/pt/permissions) com escopo de conteúdo, como `Bash(git push *)`, ainda forçam um prompt mesmo para comandos em sandbox204* [Regras de solicitação](/docs/pt/permissions) com escopo de conteúdo, como `Bash(git push *)`, ainda forçam um prompt mesmo para comandos em sandbox

205* Uma regra de solicitação `Bash` simples, ou a forma equivalente `Bash(*)`, é ignorada para comandos executados em sandbox; ela ainda se aplica a comandos que recorrem ao fluxo de permissão regular. No [modo de planejamento](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), a regra não é ignorada: ela solicita confirmação também para comandos em sandbox, incluindo os somente leitura205* Uma regra de solicitação `Bash` simples, ou a forma equivalente `Bash(*)`, é ignorada para comandos executados em sandbox; ela ainda se aplica a comandos executados fora do sandbox. No [modo de planejamento](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), a regra não é ignorada: ela solicita confirmação também para comandos em sandbox, incluindo os somente leitura

206* Os comandos da [ferramenta Monitor](/docs/pt/tools-reference#monitor-tool) não são aprovados automaticamente, embora ainda sejam executados no sandbox. Para pular o prompt, adicione uma [regra de permissão](/docs/pt/permissions#bash) que corresponda ao comando, como `Bash(npm run *)`206* Os comandos da [ferramenta Monitor](/docs/pt/tools-reference#monitor-tool) não são aprovados automaticamente, embora ainda sejam executados no sandbox. Para pular o prompt, adicione uma [regra de permissão](/docs/pt/permissions#bash) que corresponda ao comando, como `Bash(npm run *)`

207 207 

208Alguns comandos em sandbox também passam pelo [fluxo de permissão](/docs/pt/permissions) regular em vez de serem aprovados automaticamente. Isso acontece com comandos como `FOO=bar npm test`, em que uma variável definida antes de um comando pode alterar qual programa é executado, e com `make CC=clang` ou `eval "ls"`. Suas regras de permissão e seu modo de permissão então decidem se você vê um prompt, e o comando ainda é executado dentro do sandbox.

209 

210Para esses três comandos, uma [regra de permissão](/docs/pt/permissions#bash) que corresponda ao comando interrompe um prompt recorrente. Estas regras mostram o padrão:

211 

212* `Bash(make *)` aprova `make CC=clang`

213* `Bash(FOO=bar npm *)` aprova `FOO=bar npm test`. Quando o comando começa com uma atribuição de variável, inclua a atribuição na regra

214* `Bash(eval "ls")` aprova `eval "ls"`. Uma regra curinga como `Bash(eval *)` não interrompe esse prompt, então escreva uma regra que corresponda ao comando inteiro

215 

216Uma regra de permissão que corresponde a um comando também aprova uma [nova tentativa fora do sandbox](#the-unsandboxed-retry-escape-hatch) desse comando, então ele pode ser executado fora do sandbox sem prompt.

217 

208<Info>218<Info>

209 O modo auto-allow funciona independentemente da configuração do seu modo de permissão, com três exceções: o [modo de planejamento](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), um comando do modo auto que traz [domínios permitidos por comando](#per-command-allowed-domains-in-auto-mode) e a [revisão do classificador no lado do servidor](/docs/pt/permission-modes#how-the-classifier-evaluates-actions) de comandos em sandbox no modo auto. Mesmo que você não esteja no modo "accept edits", os comandos Bash em sandbox são executados automaticamente quando o auto-allow está ativado. Isso significa que comandos Bash que modificam arquivos dentro dos limites do sandbox são executados sem solicitar confirmação, mesmo no modo Manual, em que as ferramentas de edição de arquivos solicitariam.219 O modo auto-allow funciona independentemente da configuração do seu modo de permissão, com três exceções: o [modo de planejamento](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode), um comando do modo auto que traz [domínios permitidos por comando](#per-command-allowed-domains-in-auto-mode) e a [revisão do classificador no lado do servidor](/docs/pt/permission-modes#how-the-classifier-evaluates-actions) de comandos em sandbox no modo auto. Mesmo que você não esteja no modo "accept edits", os comandos Bash em sandbox são executados automaticamente quando o auto-allow está ativado. Isso significa que comandos Bash que modificam arquivos dentro dos limites do sandbox são executados sem solicitar confirmação, mesmo no modo Manual, em que as ferramentas de edição de arquivos solicitariam.

210 220 

191 Jitter191 Jitter

192</h3>192</h3>

193 193 

194Uma tarefa agendada pode ser executada em um horário diferente do que seu agendamento indica. Se as tarefas de todas as sessões fossem executadas exatamente no horário agendado, muitas delas chamariam a API no mesmo momento, então Claude Code desloca o horário de execução de cada tarefa. Tarefas recorrentes são executadas com atraso, e tarefas únicas agendadas para a hora cheia ou a meia hora são executadas um pouco mais cedo.194Uma tarefa agendada pode ser executada em um horário diferente do que seu agendamento indica. Se as tarefas de todas as sessões fossem executadas exatamente no horário agendado, muitas delas chamariam a API no mesmo momento, então Claude Code desloca o horário de execução de cada tarefa. Tarefas recorrentes são executadas com atraso, exceto uma tarefa executada a cada cinco minutos, escrita como `*/5 * * * *`. Tarefas únicas agendadas para a hora cheia ou a meia hora são executadas um pouco mais cedo.

195 195 

196<h4 id="how-late-a-recurring-task-runs">196<h4 id="how-late-a-recurring-task-runs">

197 Quanto atraso uma tarefa recorrente tem197 Quanto atraso uma tarefa recorrente tem

198</h4>198</h4>

199 199 

200Quando você cria uma tarefa recorrente, Claude Code atribui a ela um atraso fixo e adiciona esse atraso a cada execução. O atraso é calculado a partir do ID da tarefa, portanto a mesma tarefa é executada com o mesmo número de minutos de atraso todas as vezes, inclusive quando a sessão está ociosa e nada mais está em execução.200A menos que seja executada a cada cinco minutos, uma tarefa recorrente inicia cada execução com um atraso de até metade do intervalo até a próxima execução, e de no máximo 30 minutos. Sua tarefa se enquadra em um destes três casos:

201 201 

202Tarefas executadas com mais frequência recebem atrasos menores, e 30 minutos é o maior atraso que uma tarefa pode receber. Estes são os intervalos de atraso para alguns agendamentos comuns:202* **Execuções com espaçamento uniforme**: uma tarefa com intervalos iguais, como a cada hora, diariamente ou a cada 10 minutos, é executada com o mesmo número de minutos de atraso todas as vezes, inclusive quando a sessão está ociosa.

203* **Execuções com espaçamento irregular**: uma tarefa com intervalos desiguais, como uma agendada para `:00` e `:15` de cada hora, pode ser executada com um número diferente de minutos de atraso em cada uma.

204* **A cada cinco minutos**: uma tarefa escrita como `*/5 * * * *` não sofre atraso. Uma execução exatamente cinco minutos após a anterior começaria depois que um [cache de prompt](/docs/pt/prompt-caching#which-ttl-each-request-gets) de cinco minutos tivesse expirado, então cada execução começa 15 segundos antes.

203 205 

204| A tarefa é executada | O atraso fica entre |206Encontre seu agendamento na primeira coluna desta tabela para ver quando cada uma de suas execuções começa.

207 

208| Agendamento | Quando cada execução começa |

205| :- | :- |209| :- | :- |

206| A cada 10 minutos | 0 e 5 minutos |210| A cada 5 minutos, escrito como `*/5 * * * *`, que é o que `/loop 5m` cria | 4 minutos e 45 segundos após a execução anterior |

207| A cada 30 minutos | 0 e 15 minutos |211| A cada 10 minutos | 0 a 5 minutos de atraso |

208| A cada hora, ou com menos frequência, como diariamente | 0 e 30 minutos |212| A cada 30 minutos | 0 a 15 minutos de atraso |

213| A cada hora, ou com menos frequência, como diariamente | 0 a 30 minutos de atraso |

209 214 

210Por exemplo, `7,37 * * * *` agenda uma tarefa para `:07` e `:37`, que estão a 30 minutos de distância, então seu atraso fica em algum ponto entre 0 e 15 minutos. Se o atraso dessa tarefa for de 14 minutos, ela é executada às `:21` e `:51` de cada hora. Alterar o agendamento para um minuto diferente move o horário de execução, e um atraso ainda é adicionado a ele.215Por exemplo, `7,37 * * * *` agenda uma tarefa para `:07` e `:37`, que estão a 30 minutos de distância, então seu atraso fica em algum ponto entre 0 e 15 minutos. Se o atraso dessa tarefa for de 14 minutos, ela é executada às `:21` e `:51` de cada hora. Alterar o agendamento para um minuto diferente move o horário de execução, e um atraso ainda é adicionado a ele.

211 216 

1931 1931 

1932* **Scope**: [`Any file`](#scopes)1932* **Scope**: [`Any file`](#scopes)

1933* **Type**: Boolean1933* **Type**: Boolean

1934 * `true`: Claude Code executa comandos Bash em sandbox sem um prompt de permissão, sujeito a regras `deny` e regras `ask` com escopo de conteúdo; `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` desativa a auto-autorização1934 * `true`: Claude Code executa comandos Bash em sandbox sem um prompt de permissão, exceto nos casos que [Auto-allow mode](/docs/pt/sandboxing#auto-allow-mode) descreve; `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` desativa a auto-autorização

1935 * `false`: comandos em sandbox passam pelo fluxo de permissão regular, então suas regras de autorização e modo de permissão decidem. A aba **Mode** do `/sandbox` chama isso modo de permissões regular1935 * `false`: comandos em sandbox passam pelo fluxo de permissão regular, então suas regras de autorização e modo de permissão decidem. A aba **Mode** do `/sandbox` chama isso modo de permissões regular

1936* **Default**: `true`1936* **Default**: `true`

1937 1937 

1946}1946}

1947```1947```

1948 1948 

1949Consulte [Sandbox modes](/docs/pt/sandboxing#sandbox-modes) para saber o que o modo auto-autorização ainda solicita e como se comporta em modo de planejamento.1949Consulte [Auto-allow mode](/docs/pt/sandboxing#auto-allow-mode) para saber o que o modo auto-autorização ainda solicita e como se comporta em modo de planejamento.

1950 1950 

1951<h3 id="sandbox-excludedcommands">1951<h3 id="sandbox-excludedcommands">

1952 `sandbox.excludedCommands`1952 `sandbox.excludedCommands`

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

431 431 

432Retome uma execução pausada de `/workflows` selecionando-a e pressionando `p`. Para uma execução que você parou, peça a Claude para relançar o fluxo de trabalho com o mesmo script. Se agentes da execução parada ainda não tiverem saído, Claude Code recusa o relançamento até que saiam, para que uma segunda cópia desses agentes não possa ser executada ao lado deles.432Retome uma execução pausada de `/workflows` selecionando-a e pressionando `p`. Para uma execução que você parou, peça a Claude para relançar o fluxo de trabalho com o mesmo script. Se agentes da execução parada ainda não tiverem saído, Claude Code recusa o relançamento até que saiam, para que uma segunda cópia desses agentes não possa ser executada ao lado deles.

433 433 

434<h4 id="which-agents-run-again">

435 Quais agentes são executados novamente

436</h4>

437 

434Claude Code reproduz a execução na ordem em que os agentes começaram, e cada agente retorna seu resultado salvo ou é executado novamente:438Claude Code reproduz a execução na ordem em que os agentes começaram, e cada agente retorna seu resultado salvo ou é executado novamente:

435 439 

436* **Concluído**: retorna seu resultado salvo. O primeiro agente cujo prompt difere da execução anterior, porque você editou o script ou um agente anterior retornou algo diferente, é executado novamente, assim como todos os agentes depois dele, mesmo os que foram concluídos.440* **Concluído**: retorna seu resultado salvo. O primeiro agente cujo prompt difere da execução anterior, porque você editou o script ou um agente anterior retornou algo diferente, é executado novamente, assim como todos os agentes depois dele, mesmo os que foram concluídos.

439 443 

440Esse último caso significa que uma falha no meio de um fan-out reexecuta trabalho que já foi concluído. Se um script inicia A, B, C e D nessa ordem e B falha, relançar retorna A do cache e executa B, C e D novamente.444Esse último caso significa que uma falha no meio de um fan-out reexecuta trabalho que já foi concluído. Se um script inicia A, B, C e D nessa ordem e B falha, relançar retorna A do cache e executa B, C e D novamente.

441 445 

446Se você editar um script que iniciava A, B, C e D para que ele inicie A, C, B e D, o segundo agente a iniciar agora é C, onde a execução anterior iniciou B. Relançar retorna A do cache e executa C, B e D novamente.

447 

448<h4 id="resume-after-you-leave-the-session">

449 Retomar após sair da sessão

450</h4>

451 

442Você pode retomar uma execução dentro da mesma sessão de Claude Code. O que acontece com um fluxo de trabalho em execução quando você sai da sessão depende de como você sai:452Você pode retomar uma execução dentro da mesma sessão de Claude Code. O que acontece com um fluxo de trabalho em execução quando você sai da sessão depende de como você sai:

443 453 

444* Se você [colocar a sessão em segundo plano](/docs/pt/agent-view#what-carries-over-when-you-background), Claude Code reproduz a execução da mesma forma na sessão em segundo plano e continua.454* Se você [colocar a sessão em segundo plano](/docs/pt/agent-view#what-carries-over-when-you-background), Claude Code reproduz a execução da mesma forma na sessão em segundo plano e continua.

129and report the results.129and report the results.

130```130```

131 131 

132Cada subagente obtém uma worktree temporária que Claude Code remove automaticamente quando o subagente termina sem alterações; uma worktree com alterações fica no disco até que a [varredura periódica abaixo](#clean-up-subagent-and-background-session-worktrees) possa removê-la sem perder trabalho.132Cada subagente obtém uma worktree temporária que Claude Code remove automaticamente quando o subagente termina sem alterações; uma worktree com alterações fica no disco até que a [varredura periódica abaixo](#clean-up-subagent-and-background-session-worktrees) possa removê-la sem perder trabalho. Para um worktree que seu [hook WorktreeCreate](/docs/pt/hooks#worktreecreate) criou, consulte [WorktreeRemove](/docs/pt/hooks#worktreeremove).

133 133 

134As worktrees de subagentes usam a mesma [branch base](#choose-the-base-branch) que `--worktree`, então elas fazem branch da branch padrão do seu repositório a menos que `worktree.baseRef` seja definido como `"head"`.134As worktrees de subagentes usam a mesma [branch base](#choose-the-base-branch) que `--worktree`, então elas fazem branch da branch padrão do seu repositório a menos que `worktree.baseRef` seja definido como `"head"`.

135 135