Documentation 2026-10-15 23:58 UTC to 2026-10-16 22:59 UTC

9Hooks são funções de callback que executam seu código em resposta a eventos do agente, como uma ferramenta sendo chamada, uma sessão iniciando ou a execução parando. Com hooks, você pode:9Hooks são funções de callback que executam seu código em resposta a eventos do agente, como uma ferramenta sendo chamada, uma sessão iniciando ou a execução parando. Com hooks, você pode:

10 10 

11* **Bloquear operações perigosas** antes de serem executadas, como comandos shell destrutivos ou acesso a arquivos não autorizado11* **Bloquear operações perigosas** antes de serem executadas, como comandos shell destrutivos ou acesso a arquivos não autorizado

12* **Registrar e auditar** cada chamada de ferramenta para conformidade, depuração ou análise12* **Registrar e auditar** chamadas de ferramenta para conformidade, depuração ou análise

13* **Transformar entradas e saídas** para sanitizar dados, injetar credenciais ou redirecionar caminhos de arquivo13* **Transformar entradas e saídas** para sanitizar dados, injetar credenciais ou redirecionar caminhos de arquivo

14* **Exigir aprovação humana** para ações sensíveis como gravações em banco de dados ou chamadas de API14* **Exigir aprovação humana** para ações sensíveis como gravações em banco de dados ou chamadas de API

15* **Rastrear ciclo de vida da sessão** para gerenciar estado, limpar recursos ou enviar notificações15* **Rastrear ciclo de vida da sessão** para gerenciar estado, limpar recursos ou enviar notificações

40 </Step>40 </Step>

41</Steps>41</Steps>

42 42 

43O exemplo a seguir reúne essas etapas. Ele registra um hook `PreToolUse` (etapa 1) com um matcher `"Write|Edit"` (etapa 3) para que o callback seja acionado apenas para ferramentas de escrita de arquivo. Quando acionado, o callback recebe a entrada da ferramenta (etapa 4), verifica se o caminho do arquivo tem como alvo um arquivo `.env` e retorna `permissionDecision: "deny"` para bloquear a operação (etapa 5):43Este exemplo registra um hook `PreToolUse` (etapa 1) com um matcher `"Write|Edit"` (etapa 3) para que o callback seja acionado para as ferramentas Write e Edit. Quando acionado, o callback recebe a entrada da ferramenta (etapa 4), verifica se o caminho do arquivo tem como alvo um arquivo `.env` e retorna `permissionDecision: "deny"` para bloquear a operação (etapa 5):

44 44 

45<CodeGroup>45<CodeGroup>

46 ```python Python theme={null}46 ```python Python theme={null}

61 file_name = file_path.split("/")[-1]61 file_name = file_path.split("/")[-1]

62 62 

63 # Block the operation if targeting a .env file63 # Block the operation if targeting a .env file

64 if file_name == ".env":64 if file_name.lower() == ".env":

65 return {65 return {

66 "hookSpecificOutput": {66 "hookSpecificOutput": {

67 "hookEventName": input_data["hook_event_name"],67 "hookEventName": input_data["hook_event_name"],

108 const fileName = filePath?.split("/").pop();108 const fileName = filePath?.split("/").pop();

109 109 

110 // Block the operation if targeting a .env file110 // Block the operation if targeting a .env file

111 if (fileName === ".env") {111 if (fileName?.toLowerCase() === ".env") {

112 return {112 return {

113 hookSpecificOutput: {113 hookSpecificOutput: {

114 hookEventName: preInput.hook_event_name,114 hookEventName: preInput.hook_event_name,

140 ```140 ```

141</CodeGroup>141</CodeGroup>

142 142 

143Quando você executa qualquer um dos scripts, Claude tenta criar o arquivo `.env` e o hook nega a chamada de ferramenta.143O hook nega uma chamada Write ou Edit cujo `file_path` termina em `/.env`, com qualquer combinação de maiúsculas e minúsculas. No Windows, `file_path` usa barras invertidas, como `C:\project\.env`, e este hook permite uma chamada Write ou Edit para `C:\project\.env`.

144 

145<Warning>

146 O matcher `Write|Edit` limita este hook às ferramentas Write e Edit. Se Claude escrever `.env` com um comando Bash, o hook não é executado. Para bloquear escritas via Bash em um arquivo onde [o sandbox é executado](/docs/pt/sandboxing), consulte a configuração do sandbox para [Python](/docs/pt/agent-sdk/python#sandbox-configuration) ou [TypeScript](/docs/pt/agent-sdk/typescript#sandbox-configuration).

147</Warning>

144 148 

145<h2 id="available-hooks">149<h2 id="available-hooks">

146 Hooks disponíveis150 Hooks disponíveis

151| Evento de Hook | SDK Python | SDK TypeScript | O que o dispara | Caso de uso de exemplo |155| Evento de Hook | SDK Python | SDK TypeScript | O que o dispara | Caso de uso de exemplo |

152| - | - | - | - | - |156| - | - | - | - | - |

153| `PreToolUse` | Sim | Sim | Solicitação de chamada de ferramenta (pode bloquear ou modificar) | Bloquear comandos shell perigosos |157| `PreToolUse` | Sim | Sim | Solicitação de chamada de ferramenta (pode bloquear ou modificar) | Bloquear comandos shell perigosos |

154| `PostToolUse` | Sim | Sim | Resultado de execução de ferramenta | Registrar todas as alterações de arquivo na trilha de auditoria |158| `PostToolUse` | Sim | Sim | Resultado de execução de ferramenta | Registrar alterações de arquivo em uma trilha de auditoria |

155| `PostToolUseFailure` | Sim | Sim | Falha na execução de ferramenta | Lidar ou registrar erros de ferramenta |159| `PostToolUseFailure` | Sim | Sim | Falha na execução de ferramenta | Lidar ou registrar erros de ferramenta |

156| `PostToolBatch` | Não | Sim | Um lote completo de chamadas de ferramenta é resolvido, uma vez por lote antes da próxima chamada de modelo | Injetar convenções uma vez para todo o lote |160| `PostToolBatch` | Não | Sim | Um lote completo de chamadas de ferramenta é resolvido, uma vez por lote antes da próxima chamada de modelo | Injetar convenções uma vez para todo o lote |

157| [`UserPromptSubmit`](/docs/pt/hooks#userpromptsubmit) | Sim | Sim | Um prompt é enviado, incluindo um turno que o Claude Code inicia por conta própria | Injetar contexto adicional em prompts |161| [`UserPromptSubmit`](/docs/pt/hooks#userpromptsubmit) | Sim | Sim | Um prompt é enviado, incluindo um turno que o Claude Code inicia por conta própria | Injetar contexto adicional em prompts |

235| `hooks` | `HookCallback[]` | - | Obrigatório. Array de funções de callback a executar quando o padrão corresponde |239| `hooks` | `HookCallback[]` | - | Obrigatório. Array de funções de callback a executar quando o padrão corresponde |

236| `timeout` | `number` | `undefined` | Timeout em segundos. Quando omitido, Claude Code aplica o [timeout padrão do evento](#hook-timeout). Seus callbacks do SDK seguem os padrões de hook `command` |240| `timeout` | `number` | `undefined` | Timeout em segundos. Quando omitido, Claude Code aplica o [timeout padrão do evento](#hook-timeout). Seus callbacks do SDK seguem os padrões de hook `command` |

237 241 

238Use o padrão `matcher` para direcionar ferramentas específicas sempre que possível. Um matcher com `'Bash'` é executado apenas para comandos Bash, enquanto omitir o padrão executa seus callbacks para cada ocorrência do evento. Omita-o propositalmente para registrar cada chamada de ferramenta que sua sessão faz.242Use o padrão `matcher` para direcionar ferramentas específicas sempre que possível. Um matcher com `'Bash'` é executado apenas para comandos Bash, enquanto omitir o padrão executa seus callbacks para cada ocorrência do evento.

239 243 

240<h3 id="callback-functions">244<h3 id="callback-functions">

241 Funções de callback245 Funções de callback

268Retorne `{}` para permitir a operação sem alterações. Hooks de callback do SDK usam o mesmo formato de saída JSON que [hooks de comando shell do Claude Code](/docs/pt/hooks#json-output), que documenta cada campo e opção específica do evento. Para as definições de tipo do SDK, veja as referências do SDK [TypeScript](/docs/pt/agent-sdk/typescript#synchookjsonoutput) e [Python](/docs/pt/agent-sdk/python#synchookjsonoutput).272Retorne `{}` para permitir a operação sem alterações. Hooks de callback do SDK usam o mesmo formato de saída JSON que [hooks de comando shell do Claude Code](/docs/pt/hooks#json-output), que documenta cada campo e opção específica do evento. Para as definições de tipo do SDK, veja as referências do SDK [TypeScript](/docs/pt/agent-sdk/typescript#synchookjsonoutput) e [Python](/docs/pt/agent-sdk/python#synchookjsonoutput).

269 273 

270<Note>274<Note>

271 Quando múltiplos hooks ou regras de permissão se aplicam, `deny` tem prioridade sobre `defer`, que tem prioridade sobre `ask`, que tem prioridade sobre `allow`. Se qualquer hook retornar `deny`, a operação é bloqueada independentemente de outros hooks.275 Quando múltiplos hooks `PreToolUse` retornam [decisões](/docs/pt/hooks#pretooluse-decision-control) diferentes, `deny` tem prioridade sobre `defer`, que tem prioridade sobre `ask`, que tem prioridade sobre `allow`.

272</Note>276</Note>

273 277 

274<h4 id="asynchronous-output">278<h4 id="asynchronous-output">

313 Modificar entrada de ferramenta317 Modificar entrada de ferramenta

314</h3>318</h3>

315 319 

316Este exemplo intercepta chamadas de ferramenta Write e reescreve o argumento `file_path` para prepender `/sandbox`, redirecionando todas as gravações de arquivo para um diretório em sandbox. O callback retorna `updatedInput` com o caminho modificado e `permissionDecision: 'allow'` para aprovar automaticamente a operação reescrita:320Este exemplo intercepta chamadas de ferramenta Write e reescreve o argumento `file_path` para prepender `/sandbox`. O callback retorna `updatedInput` com o caminho modificado e `permissionDecision: 'allow'` para aprovar automaticamente a operação reescrita:

317 321 

318<CodeGroup>322<CodeGroup>

319 ```python Python theme={null}323 ```python Python theme={null}

370 Adicionar contexto e bloquear uma ferramenta374 Adicionar contexto e bloquear uma ferramenta

371</h3>375</h3>

372 376 

373Este exemplo bloqueia gravações no diretório `/etc` e explica o motivo tanto para o modelo quanto para o usuário:377Este exemplo nega chamadas de ferramenta cujo `file_path` começa com `/etc` e explica o motivo tanto para o modelo quanto para o usuário:

374 378 

375* `permissionDecision: 'deny'` interrompe a chamada de ferramenta.379* `permissionDecision: 'deny'` interrompe a chamada de ferramenta.

376* `permissionDecisionReason` informa ao modelo por que, para que ele evite tentar novamente.380* `permissionDecisionReason` informa ao modelo o motivo.

377* `systemMessage` mostra ao usuário o que aconteceu.381* `systemMessage` mostra ao usuário o que aconteceu.

378 382 

379<CodeGroup>383<CodeGroup>

468 Registrar múltiplos hooks472 Registrar múltiplos hooks

469</h3>473</h3>

470 474 

471Quando um evento é disparado, todos os hooks correspondentes são executados em paralelo. Para decisões de permissão, o resultado mais restritivo vence: um único `deny` bloqueia a chamada de ferramenta independentemente do que os outros hooks retornam. Como a ordem de conclusão é não-determinística, escreva cada hook para agir independentemente em vez de depender de outro hook ter sido executado primeiro.475Quando um evento é disparado, os hooks correspondentes são executados em paralelo. Para decisões de permissão, o resultado mais restritivo se aplica. Um `deny` de um hook bloqueia a chamada de ferramenta. Como a ordem de conclusão é não-determinística, escreva cada hook para agir independentemente em vez de depender de outro hook ter sido executado primeiro.

472 476 

473O exemplo abaixo registra três verificações independentes para cada chamada de ferramenta. Os nomes de hook nele, como `audit_logger` em Python ou `auditLogger` em TypeScript, representam callbacks que você define:477O exemplo abaixo registra três verificações independentes, cada uma com um [matcher omitido](/docs/pt/hooks#matcher-patterns). Os nomes de hook nele, como `audit_logger` em Python ou `auditLogger` em TypeScript, representam callbacks que você define:

474 478 

475<CodeGroup>479<CodeGroup>

476 ```python Python theme={null}480 ```python Python theme={null}

504 508 

505Use matchers de múltiplas ferramentas para compartilhar um callback entre ferramentas relacionadas. Este exemplo registra três matchers com escopos diferentes, e cada hook que ele nomeia representa um callback que você define:509Use matchers de múltiplas ferramentas para compartilhar um callback entre ferramentas relacionadas. Este exemplo registra três matchers com escopos diferentes, e cada hook que ele nomeia representa um callback que você define:

506 510 

507* Uma lista exata separada por pipe (`Write|Edit|NotebookEdit`) dispara `file_security_hook` apenas para ferramentas de modificação de arquivo.511* Uma lista exata separada por pipe (`Write|Edit|NotebookEdit`) dispara `file_security_hook` para as ferramentas Write, Edit e NotebookEdit.

508* Uma regex (`^mcp__`) dispara `mcp_audit_hook` para qualquer ferramenta MCP cujo nome começa com `mcp__`.512* Uma regex (`^mcp__`) dispara `mcp_audit_hook` para qualquer ferramenta MCP cujo nome começa com `mcp__`.

509* Um matcher omitido dispara `global_logger` para cada chamada de ferramenta independentemente do nome.513* Um matcher omitido dispara `global_logger` sem filtrar pelo nome da ferramenta.

510 514 

511<CodeGroup>515<CodeGroup>

512 ```python Python theme={null}516 ```python Python theme={null}

832 836 

833Quando um callback excede seu timeout, Claude Code o cancela e descarta sua saída, e a sessão continua em vez de travar. O que acontece a seguir depende do evento:837Quando um callback excede seu timeout, Claude Code o cancela e descarta sua saída, e a sessão continua em vez de travar. O que acontece a seguir depende do evento:

834 838 

835* `PreToolUse`: Claude Code não executa a chamada de ferramenta, Claude recebe um resultado de ferramenta informando que o hook não respondeu antes de seu timeout, e o turno continua. Se outro hook `PreToolUse` retornou uma negação explícita, Claude recebe essa negação em vez do erro de timeout. Antes da v2.1.210, Claude Code relatava o timeout a Claude como uma rejeição do usuário, o que fazia sessões autônomas pararem e aguardarem entrada.839* `PreToolUse`: Claude Code bloqueia a chamada de ferramenta. Em seu lugar, Claude recebe um resultado de ferramenta informando que o hook não respondeu antes de seu timeout, e o turno continua. Antes da v2.1.210, Claude Code relatava o timeout a Claude como uma rejeição do usuário, o que fazia sessões autônomas pararem e aguardarem entrada.

836* `PostToolUse` e `PostToolUseFailure`: Claude Code mantém o resultado da ferramenta e o turno continua.840* `PostToolUse` e `PostToolUseFailure`: Claude Code mantém o resultado da ferramenta e o turno continua.

837* `UserPromptSubmit` e [`UserPromptExpansion`](/docs/pt/hooks#userpromptexpansion): Claude Code bloqueia o prompt com uma mensagem nomeando o hook e o timeout, e a sessão continua. Como um callback nesses eventos pode atuar como uma porta de política, Claude Code nunca deixa um prompt com timeout passar sem ser verificado. Antes da v2.1.208, Claude Code terminava a consulta com `error_during_execution` quando um callback nesses eventos expirava.841* `UserPromptSubmit` e [`UserPromptExpansion`](/docs/pt/hooks#userpromptexpansion): Claude Code bloqueia o prompt com uma mensagem nomeando o hook e o timeout, e a sessão continua. Antes da v2.1.208, Claude Code terminava a consulta com `error_during_execution` quando um callback nesses eventos expirava.

838* `Stop` e `SubagentStop`: o callback com timeout conta como retornando nenhuma decisão. O agente ou subagente para como se esse callback o tivesse permitido, e uma decisão de seus outros hooks no evento ainda se aplica. Antes do Claude Code v2.1.273, um callback `Stop` ou `SubagentStop` com timeout contava como uma execução de hook falhada, e Claude Code descartava as decisões de seus outros hooks no evento.842* `Stop` e `SubagentStop`: o callback com timeout conta como retornando nenhuma decisão. O agente ou subagente para como se esse callback o tivesse permitido, e uma decisão de seus outros hooks no evento ainda se aplica. Antes do Claude Code v2.1.273, um callback `Stop` ou `SubagentStop` com timeout contava como uma execução de hook falhada, e Claude Code descartava as decisões de seus outros hooks no evento.

839* `SessionStart`: o callback com timeout conta como retornando nenhuma saída, e a sessão continua com a saída de seus outros hooks `SessionStart`.843* `SessionStart`: o callback com timeout conta como retornando nenhuma saída, e a sessão continua com a saída de seus outros hooks `SessionStart`.

840* `PreModelSwitch`: Claude Code bloqueia a mudança de modelo. Um hook que não responde não aprovou a mudança.844* `PreModelSwitch`: Claude Code bloqueia a mudança de modelo. Um hook que não responde não aprovou a mudança.

3881<Note>3881<Note>

3882 O sandbox depende do suporte de plataforma e, no Linux, de ferramentas como `bubblewrap` e `socat`. Por padrão, quando `enabled` é `True` mas o sandbox não consegue iniciar, comandos executam sem sandbox com um aviso em stderr. Este padrão difere do SDK TypeScript, onde `failIfUnavailable` tem padrão `true`.3882 O sandbox depende do suporte de plataforma e, no Linux, de ferramentas como `bubblewrap` e `socat`. Por padrão, quando `enabled` é `True` mas o sandbox não consegue iniciar, comandos executam sem sandbox com um aviso em stderr. Este padrão difere do SDK TypeScript, onde `failIfUnavailable` tem padrão `true`.

3883 3883 

3884 Defina `"failIfUnavailable": True` nas suas configurações de sandbox para parar em vez disso. A chave ainda não está declarada em `SandboxSettings`, mas o SDK a encaminha para Claude Code, que a honra. `query()` então relata uma `ResultMessage` com `subtype="error_during_execution"` e a razão em `errors`. Como esta é uma chamada `query()` de um único disparo, o SDK lança após ceder esse resultado de erro, então envolva o loop em um bloco try para continuar além dele. Veja [Lidar com o resultado](/docs/pt/agent-sdk/agent-loop#handle-the-result) para o contrato de erro.3884 Defina `"failIfUnavailable": True` nas suas configurações de sandbox para parar em vez disso. O SDK encaminha `failIfUnavailable` para o Claude Code junto com os campos declarados de `SandboxSettings`. `query()` então relata uma `ResultMessage` com `subtype="error_during_execution"` e a razão em `errors`. Como esta é uma chamada `query()` de um único disparo, o SDK lança após ceder esse resultado de erro, então envolva o loop em um bloco try para continuar além dele. Veja [Lidar com o resultado](/docs/pt/agent-sdk/agent-loop#handle-the-result) para o contrato de erro.

3885</Note>3885</Note>

3886 3886 

3887Para impedir que comandos em sandbox gravem em um arquivo, liste seu caminho absoluto em [`denyWrite`](/docs/pt/settings-reference#sandbox-filesystem-denywrite) nas suas configurações de sandbox, como `"filesystem": {"denyWrite": ["/home/user/project/.env"]}`. O SDK encaminha `filesystem` para o Claude Code junto com os campos declarados de `SandboxSettings`. Depois que o sandbox inicia, ele bloqueia gravações em cada caminho listado. Se você listar `.env` ou `./.env`, comandos em sandbox podem gravar no arquivo `.env` no diretório de trabalho da sessão.

3888 

3887<h4 id="example-usage">3889<h4 id="example-usage">

3888 Exemplo de uso3890 Exemplo de uso

3889</h4>3891</h4>

557O [guia de skills do Claude Code](/docs/pt/skills) cobre autoria em profundidade. Sua orientação se aplica a sessões do SDK. Comece com estas seções:557O [guia de skills do Claude Code](/docs/pt/skills) cobre autoria em profundidade. Sua orientação se aplica a sessões do SDK. Comece com estas seções:

558 558 

559* [Referência de frontmatter](/docs/pt/skills#frontmatter-reference): cada campo suportado559* [Referência de frontmatter](/docs/pt/skills#frontmatter-reference): cada campo suportado

560* [Passe argumentos para skills](/docs/pt/skills#pass-arguments-to-skills): `$ARGUMENTS`, `$0`, `$1` e empilhamento de skills. A [tabela de substituição completa](/docs/pt/skills#available-string-substitutions) adiciona argumentos nomeados e as variáveis `${CLAUDE_*}`560* [Passe argumentos para skills](/docs/pt/skills#pass-arguments-to-skills): `$ARGUMENTS`, `$0` e `$1`. A [tabela de substituição completa](/docs/pt/skills#available-string-substitutions) adiciona argumentos nomeados e as variáveis `${CLAUDE_*}`

561* [Injete contexto dinâmico](/docs/pt/skills#inject-dynamic-context): linhas `` !`command` `` que executam antes de Claude ver o conteúdo da skill561* [Injete contexto dinâmico](/docs/pt/skills#inject-dynamic-context): linhas `` !`command` `` que executam antes de Claude ver o conteúdo da skill

562* [Escolha onde skills carregam](/docs/pt/skills#where-skills-live): cada local de skill, namespacing de plugin e qual skill executa quando dois compartilham um nome562* [Escolha onde skills carregam](/docs/pt/skills#where-skills-live): cada local de skill, namespacing de plugin e qual skill executa quando dois compartilham um nome

563 563 

6370| Property | Type | Default | Description |6370| Property | Type | Default | Description |

6371| :- | :- | :- | :- |6371| :- | :- | :- | :- |

6372| `allowWrite` | `string[]` | `[]` | Padrões de caminho de arquivo para permitir acesso de escrita |6372| `allowWrite` | `string[]` | `[]` | Padrões de caminho de arquivo para permitir acesso de escrita |

6373| `denyWrite` | `string[]` | `[]` | Padrões de caminho de arquivo para negar acesso de escrita |6373| `denyWrite` | `string[]` | `[]` | Padrões de caminho de arquivo para negar acesso de escrita. Para bloquear escritas em sandbox em um arquivo no diretório de trabalho da sessão, liste seu caminho absoluto. Se você listar `.env` ou `./.env`, comandos em sandbox podem escrever no arquivo `.env` no diretório de trabalho da sessão |

6374| `denyRead` | `string[]` | `[]` | Padrões de caminho de arquivo para negar acesso de leitura |6374| `denyRead` | `string[]` | `[]` | Padrões de caminho de arquivo para negar acesso de leitura |

6375 6375 

6376<h3 id="permissions-fallback-for-unsandboxed-commands">6376<h3 id="permissions-fallback-for-unsandboxed-commands">

231 231 

232O líder envia uma solicitação de encerramento. O companheiro de equipe pode aprovar, saindo graciosamente, ou rejeitar com uma explicação.232O líder envia uma solicitação de encerramento. O companheiro de equipe pode aprovar, saindo graciosamente, ou rejeitar com uma explicação.

233 233 

234Os diretórios compartilhados da equipe são limpos automaticamente quando a sessão termina, portanto não há uma etapa de limpeza separada. Veja [Architecture](#architecture) para saber quais diretórios são removidos e quais persistem para sessões retomadas.234Os diretórios compartilhados da equipe são limpos automaticamente quando a sessão termina, portanto não há uma etapa de limpeza separada. Veja [Architecture](#architecture) para saber quais diretórios são removidos e quais permanecem no disco.

235 235 

236<h3 id="enforce-quality-gates-with-hooks">236<h3 id="enforce-quality-gates-with-hooks">

237 Aplicar gates de qualidade com hooks237 Aplicar gates de qualidade com hooks

278 278 

279Equipes e tarefas são armazenadas localmente sob um nome derivado da sessão. O nome é `session-` seguido pelos primeiros oito caracteres do ID da sessão:279Equipes e tarefas são armazenadas localmente sob um nome derivado da sessão. O nome é `session-` seguido pelos primeiros oito caracteres do ID da sessão:

280 280 

281* **Team config**: `~/.claude/teams/{team-name}/config.json`281* **Team config**: `~/.claude/teams/{team-name}/config.json`. Claude Code remove o diretório de configuração da equipe quando a sessão termina.

282* **Task list**: `~/.claude/tasks/{team-name}/`282* **Task list**: `~/.claude/tasks/{team-name}/`. Este diretório permanece no disco após o término da sessão. Para alterar [por quanto tempo Claude Code o mantém](/docs/pt/claude-directory#cleaned-up-automatically), defina [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays).

283 283 

284Claude Code gera ambas automaticamente na inicialização da sessão e as atualiza conforme os companheiros de equipe entram, ficam ociosos ou saem. O diretório de configuração da equipe é removido quando a sessão termina. O diretório da lista de tarefas persiste localmente e nunca é carregado, portanto as sessões retomadas mantêm suas tarefas. A retenção é governada pelo mesmo [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) que você já controla para transcrições de sessão, seguindo as [regras de limpeza de retenção](/docs/pt/claude-directory#cleaned-up-automatically).284Claude Code gera ambos automaticamente na inicialização da sessão e os atualiza conforme os companheiros de equipe entram, ficam ociosos ou saem.

285 285 

286A configuração da equipe contém estado de tempo de execução, como IDs de sessão e IDs de painel tmux, portanto não a edite manualmente ou a crie previamente: suas alterações são sobrescritas na próxima atualização de estado.286A configuração da equipe contém estado de tempo de execução, como IDs de sessão e IDs de painel tmux, portanto não a edite manualmente ou a crie previamente: suas alterações são sobrescritas na próxima atualização de estado.

287 287 

325 325 

326O segundo pressionamento deleta a sessão mesmo quando a tentativa de parada falha, por exemplo porque o [serviço em background não está respondendo](#agent-view-says-the-background-service-did-not-respond): a confirmação permanece ativa por mais dois segundos, e a exclusão encerra o processo da sessão em si. Pressione `Esc` para descartar a confirmação sem deletar.326O segundo pressionamento deleta a sessão mesmo quando a tentativa de parada falha, por exemplo porque o [serviço em background não está respondendo](#agent-view-says-the-background-service-did-not-respond): a confirmação permanece ativa por mais dois segundos, e a exclusão encerra o processo da sessão em si. Pressione `Esc` para descartar a confirmação sem deletar.

327 327 

328Exceto nos casos mantidos cobertos em [What deleting a session removes](#what-deleting-a-session-removes), deletar remove a sessão da lista, e um worktree que Claude criou para ela é removido, mantido ou deixado no lugar dependendo de como você deleta e o que o worktree contém. A transcrição da conversa sempre fica em sua máquina local, disponível através de `claude --resume`.328Exceto nos casos mantidos cobertos em [What deleting a session removes](#what-deleting-a-session-removes), deletar remove a sessão da lista, e um worktree que Claude criou para ela é removido, mantido ou deixado no lugar dependendo de como você deleta e o que o worktree contém. A transcrição da conversa fica em sua máquina local, disponível através de `claude --resume`.

329 329 

330Para trazer uma sessão de volta no Claude Code v2.1.212 ou posterior, digite `/resume` na entrada de despacho. Um seletor abre com sessões passadas do repositório a partir do qual você abriu agent view, mais recentes primeiro, incluindo sessões que você deletou da lista; sessões que já têm uma linha não são listadas. `↑`/`↓` movem a seleção, `Enter` retoma a sessão selecionada como uma sessão em background para que ela se rejunte à lista como uma linha, e `Esc` fecha o seletor.330Para trazer uma sessão de volta no Claude Code v2.1.212 ou posterior, digite `/resume` na entrada de despacho. Um seletor abre com sessões passadas do repositório a partir do qual você abriu agent view, mais recentes primeiro, incluindo sessões que você deletou da lista; sessões que já têm uma linha não são listadas. `↑`/`↓` movem a seleção, `Enter` retoma a sessão selecionada como uma sessão em background para que ela se rejunte à lista como uma linha, e `Esc` fecha o seletor.

331 331 

12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.

13```13```

14 14 

15No prompt, Claude Code retém a primeira ação que verificaria dessa forma até você responder. Nada está quebrado: o modo automático continua funcionando, e suas solicitações de classificador são cobradas como eram antes. A causa mais comum é um gateway LLM ou proxy entre Claude Code e a API, e quando Claude Code consegue identificar um, o aviso o nomeia. Pressione **Enter** para continuar, ou veja [Tornar a sessão elegível](#make-the-session-eligible) para evitar que apareça em novas sessões.15No prompt, Claude Code retém a primeira ação que verificaria dessa forma até você responder. O modo auto continua funcionando, e suas requisições de classificador são cobradas como eram antes.

16 

17A causa mais comum é um gateway de LLM ou proxy entre Claude Code e a API, e quando Claude Code consegue identificar um, o aviso o nomeia. Pressione **Enter** para continuar, ou veja [Tornar a sessão elegível](#make-the-session-eligible) para evitar que apareça em novas sessões.

16 18 

17<h2 id="respond-to-the-notice">19<h2 id="respond-to-the-notice">

18 Responder ao aviso20 Responder ao aviso

45 Se a instalação falhar, corresponda à mensagem que Claude Code relata:45 Se a instalação falhar, corresponda à mensagem que Claude Code relata:

46 46 

47 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.47 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.

48 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.48 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: sua cópia local do catálogo do marketplace pode estar desatualizada. Atualize-a com `/plugin marketplace update claude-plugins-official` e, em seguida, tente novamente a instalação. Se a nova tentativa exibir a mesma mensagem, consulte [Plugin não encontrado no marketplace](/docs/pt/plugins/troubleshooting#plugin-not-found-in-marketplace).

49 49 

50 Quando a instalação solicitar um escopo de instalação, escolha a opção de escopo do usuário para que o plugin esteja disponível em todos os seus projetos. Verifique o resumo da instalação: se relatar `Run /reload-plugins to apply.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/plugins/cli-reference#reload-plugins) para disponibilizar o comando de configuração do plugin.50 Quando a instalação solicitar um escopo de instalação, escolha a opção de escopo do usuário para que o plugin esteja disponível em todos os seus projetos. Verifique o resumo da instalação: se relatar `Run /reload-plugins to apply.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/plugins/cli-reference#reload-plugins) para disponibilizar o comando de configuração do plugin.

51 </Step>51 </Step>

123 Se a instalação falhar, corresponda à mensagem que Claude Code relata:123 Se a instalação falhar, corresponda à mensagem que Claude Code relata:

124 124 

125 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.125 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.

126 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.126 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: sua cópia local do catálogo do marketplace pode estar desatualizada. Atualize-a com `/plugin marketplace update claude-plugins-official` e, em seguida, tente novamente a instalação. Se a nova tentativa exibir a mesma mensagem, consulte [Plugin não encontrado no marketplace](/docs/pt/plugins/troubleshooting#plugin-not-found-in-marketplace).

127 127 

128 Quando a instalação solicitar um escopo de instalação, escolha a opção de escopo do usuário para que o plugin esteja disponível em todos os seus projetos. Verifique o resumo da instalação: se relatar `Run /reload-plugins to apply.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/plugins/cli-reference#reload-plugins) para disponibilizar o comando de configuração do plugin.128 Quando a instalação solicitar um escopo de instalação, escolha a opção de escopo do usuário para que o plugin esteja disponível em todos os seus projetos. Verifique o resumo da instalação: se relatar `Run /reload-plugins to apply.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/plugins/cli-reference#reload-plugins) para disponibilizar o comando de configuração do plugin.

129 </Step>129 </Step>

188 Se a instalação falhar, corresponda à mensagem que Claude Code relata:188 Se a instalação falhar, corresponda à mensagem que Claude Code relata:

189 189 

190 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.190 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.

191 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.191 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: sua cópia local do catálogo do marketplace pode estar desatualizada. Atualize-a com `/plugin marketplace update claude-plugins-official` e, em seguida, tente novamente a instalação. Se a nova tentativa exibir a mesma mensagem, consulte [Plugin não encontrado no marketplace](/docs/pt/plugins/troubleshooting#plugin-not-found-in-marketplace).

192 192 

193 Quando a instalação solicitar um escopo de instalação, escolha a opção de escopo do usuário para que o plugin esteja disponível em todos os seus projetos.193 Quando a instalação solicitar um escopo de instalação, escolha a opção de escopo do usuário para que o plugin esteja disponível em todos os seus projetos.

194 194 

247 Se a instalação falhar, corresponda à mensagem que Claude Code relata:247 Se a instalação falhar, corresponda à mensagem que Claude Code relata:

248 248 

249 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.249 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.

250 * O plugin é [não encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.250 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: sua cópia local do catálogo do marketplace pode estar desatualizada. Atualize-a com `/plugin marketplace update claude-plugins-official` e, em seguida, tente novamente a instalação. Se a nova tentativa exibir a mesma mensagem, consulte [Plugin não encontrado no marketplace](/docs/pt/plugins/troubleshooting#plugin-not-found-in-marketplace).

251 251 

252 Quando a instalação solicitar um escopo de instalação, escolha a opção de escopo do usuário para que o plugin esteja disponível em todos os seus projetos.252 Quando a instalação solicitar um escopo de instalação, escolha a opção de escopo do usuário para que o plugin esteja disponível em todos os seus projetos.

253 253 

290 note: commandsNote,290 note: commandsNote,

291 when: <>User types <C>/command-name</C></>,291 when: <>User types <C>/command-name</C></>,

292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,

293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; commands remain supported'],293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; command files still work'],

294 docsLink: '/en/skills',294 docsLink: '/en/skills',

295 children: [{295 children: [{

296 id: 'cmd-example',296 id: 'cmd-example',

48 48 

49O comando abre os detalhes do plugin, onde você escolhe um [escopo de instalação](/docs/pt/plugins/install#install-a-plugin) para iniciar a instalação.49O comando abre os detalhes do plugin, onde você escolhe um [escopo de instalação](/docs/pt/plugins/install#install-a-plugin) para iniciar a instalação.

50 50 

51Se a instalação falhar, a correção depende de qual mensagem Claude Code relata:51Se a instalação falhar, identifique a mensagem que o Claude Code relata:

52 52 

53* Se relatar `Marketplace "claude-plugins-official" not found`, adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.53* `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official` e, em seguida, tente novamente a instalação.

54* Se relatar que não consegue [encontrar o plugin no marketplace](/docs/pt/plugins/install#install-a-plugin), verifique o nome do plugin para um erro de digitação.54* `Plugin "claude-security" not found in marketplace "claude-plugins-official"`: sua cópia local do catálogo do marketplace pode estar desatualizada. Atualize-a com `/plugin marketplace update claude-plugins-official` e, em seguida, tente novamente a instalação. Se a nova tentativa exibir a mesma mensagem, consulte [Plugin não encontrado no marketplace](/docs/pt/plugins/troubleshooting#plugin-not-found-in-marketplace).

55 55 

56Verifique o resumo da instalação. Se relatar `Run /reload-plugins to apply.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/plugins/cli-reference#reload-plugins) para ativar o plugin em sua sessão atual.56Verifique o resumo da instalação. Se relatar `Run /reload-plugins to apply.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/plugins/cli-reference#reload-plugins) para ativar o plugin em sua sessão atual.

57 57 

118Após o nível de esforço e as flags, o Claude Code lê o restante da linha como o alvo da revisão. O argumento `ultra` muda essa interpretação:118Após o nível de esforço e as flags, o Claude Code lê o restante da linha como o alvo da revisão. O argumento `ultra` muda essa interpretação:

119 119 

120* **Com `ultra`**: o Claude Code lê uma única palavra como um branch base ou número de PR. Um texto mais longo que não nomeia um branch ou PR se torna [uma nota anexada à revisão](/docs/pt/ultrareview#pass-a-request-in-plain-words). `/code-review ultra check my auth changes` revisa seu branch atual, e o Claude relaciona as descobertas à sua nota.120* **Com `ultra`**: o Claude Code lê uma única palavra como um branch base ou número de PR. Um texto mais longo que não nomeia um branch ou PR se torna [uma nota anexada à revisão](/docs/pt/ultrareview#pass-a-request-in-plain-words). `/code-review ultra check my auth changes` revisa seu branch atual, e o Claude relaciona as descobertas à sua nota.

121* **Sem `ultra`**: tudo o que sobra é o alvo da revisão, mesmo quando começa com outro nome de comando. `/code-review /fix-issue 123` revisa com `/fix-issue 123` como texto do alvo, em vez de carregar `/fix-issue` como uma segunda [skill empilhada](/docs/pt/skills#pass-arguments-to-skills). Antes da v2.1.218, um comando empilhado após `/code-review` era expandido como sua própria skill.121* **Sem `ultra`**: tudo o que sobra é o alvo da revisão, mesmo quando começa com outro nome de comando. `/code-review /fix-issue 123` revisa com `/fix-issue 123` como texto do alvo, em vez de carregar `/fix-issue` como uma segunda [skill empilhada](/docs/pt/skills#stack-several-skills-in-one-message). Antes da v2.1.218, um comando empilhado após `/code-review` era expandido como sua própria skill.

122 122 

123<h2 id="run-in-the-foreground">123<h2 id="run-in-the-foreground">

124 Executar em primeiro plano124 Executar em primeiro plano

10 10 

11Digite `/` para ver os comandos disponíveis para você, ou digite `/` seguido de letras para filtrar. [Como o menu de comandos corresponde ao que você digita](#how-the-command-menu-matches-what-you-type) aborda realce, erros de digitação e os poucos comandos que o Claude Code oculta do menu até que você digite seu nome completo.11Digite `/` para ver os comandos disponíveis para você, ou digite `/` seguido de letras para filtrar. [Como o menu de comandos corresponde ao que você digita](#how-the-command-menu-matches-what-you-type) aborda realce, erros de digitação e os poucos comandos que o Claude Code oculta do menu até que você digite seu nome completo.

12 12 

13Um comando é reconhecido apenas no início da sua mensagem. O texto que segue o nome do comando se torna seus argumentos. [Skills](/docs/pt/skills#pass-arguments-to-skills) são a exceção: uma invocação de skill seguida por mais skills, como `/skill-a /skill-b do XYZ`, carrega as skills nomeadas no início e passa o texto final para cada uma como argumentos. Até seis skills podem ser encadeadas.13Um comando é reconhecido apenas no início da sua mensagem. O texto que segue o nome do comando se torna seus argumentos. No prompt do terminal, você pode iniciar uma mensagem com várias [skills](/docs/pt/skills#stack-several-skills-in-one-message): digitar `/skill-a /skill-b do XYZ` carrega ambas as skills e passa o texto final para cada uma como argumentos. Até seis skills podem ser encadeadas.

14 14 

15Se você enviar um comando enquanto Claude está respondendo, o Claude Code o coloca na fila e o executa após o turno atual terminar. O Claude Code executa alguns comandos imediatamente sem interromper a resposta, como `/status`, `/tasks` e `/usage`. Em [renderização em tela cheia](/docs/pt/fullscreen), o Claude Code também abre comandos de diálogo como `/theme` e `/help` imediatamente. Antes da v2.1.234, o Claude Code colocava esses diálogos na fila até que o turno terminasse.15Se você enviar um comando enquanto Claude está respondendo, o Claude Code o coloca na fila e o executa após o turno atual terminar. O Claude Code executa alguns comandos imediatamente sem interromper a resposta, como `/status`, `/tasks` e `/usage`. Em [renderização em tela cheia](/docs/pt/fullscreen), o Claude Code também abre comandos de diálogo como `/theme` e `/help` imediatamente. Antes da v2.1.234, o Claude Code colocava esses diálogos na fila até que o turno terminasse.

16 16 

1137</Warning>1137</Warning>

1138 1138 

1139* **Após suspensão ou perda de rede**: você recupera a tarefa em execução se o processo [ainda estiver em execução](#limits-while-desktop-is-disconnected) e o Desktop puder fazer login sem prompt. Se não puder, [envie uma mensagem](#reconnect-after-sleep-or-a-network-loss).1139* **Após suspensão ou perda de rede**: você recupera a tarefa em execução se o processo [ainda estiver em execução](#limits-while-desktop-is-disconnected) e o Desktop puder fazer login sem prompt. Se não puder, [envie uma mensagem](#reconnect-after-sleep-or-a-network-loss).

1140* **Após uma saída, com o Desktop no macOS ou no Linux e uma conta Claude**: você recupera a tarefa em execução se o Desktop puder [reconectar-se ao processo](#reopen-a-session-after-you-quit-desktop). Se não puder, a tarefa para. Se ela continuar parada, envie uma mensagem.1140* **Após sair**: a tarefa continua em execução, mas você a perde quando a sessão é aberta novamente, a menos que o Desktop consiga se reconectar ao processo dela. Verifique [quando o Desktop consegue se reconectar](#reopen-a-session-after-you-quit-desktop) antes de sair. Se você perdeu a tarefa, envie uma mensagem para continuar.

1141* **Após uma saída, com o Desktop no Windows ou com um [provedor terceirizado](/docs/pt/third-party-integrations)**: você perde a tarefa em execução, porque o Desktop encerra o processo quando a sessão é aberta. Envie uma mensagem para continuar.

1142 1141 

1143Quando você voltar e a tarefa não estiver concluída, verifique se há um aviso de que o Desktop não consegue se reconectar, um erro de autenticação ou uma solicitação pendente:1142Quando você voltar e a tarefa não estiver concluída, verifique se há um aviso de que o Desktop não consegue se reconectar, um erro de autenticação ou uma solicitação pendente:

1144 1143 

1154</h5>1153</h5>

1155 1154 

1156* **Atualize primeiro**: atualize o Desktop antes de iniciar uma tarefa longa. No macOS e no Windows, o Desktop pode reiniciar sozinho para instalar uma atualização que baixou. Essa reinicialização aguarda enquanto Claude está trabalhando em uma tarefa SSH. No macOS com uma conta Claude, por padrão a reinicialização pode acontecer mesmo assim depois que a atualização tiver aguardado 72 horas.1155* **Atualize primeiro**: atualize o Desktop antes de iniciar uma tarefa longa. No macOS e no Windows, o Desktop pode reiniciar sozinho para instalar uma atualização que baixou. Essa reinicialização aguarda enquanto Claude está trabalhando em uma tarefa SSH. No macOS com uma conta Claude, por padrão a reinicialização pode acontecer mesmo assim depois que a atualização tiver aguardado 72 horas.

1157* **Não saia do Desktop**: se o Desktop é executado no Windows ou usa um provedor terceirizado, deixe-o aberto enquanto a tarefa longa é executada. Após uma saída, ele [encerra a tarefa em execução](#reopen-a-session-after-you-quit-desktop) quando a sessão é aberta. Deixá-lo aberto não protege uma solicitação que [aguarda por você](#handle-requests-that-arrive-while-you-are-away).1156* **Não saia no Windows, ou antes da v2.42304.0 com um provedor terceirizado**: nesses casos, ao sair você perde a tarefa em execução, então deixe o Desktop aberto durante a tarefa. Em qualquer outro caso, veja [o que você recupera](#reopen-a-session-after-you-quit-desktop) antes de sair.

1158* **Reduza as solicitações**: escolha um modo de permissão, regras ou hooks que [façam a tarefa aguardar por você com menos frequência](#handle-requests-that-arrive-while-you-are-away)1157* **Reduza as solicitações**: escolha um modo de permissão, regras ou hooks que [façam a tarefa aguardar por você com menos frequência](#handle-requests-that-arrive-while-you-are-away)

1159* **Verifique o jump host**: se seu jump host pede um login, por exemplo um push para um telefone, mude para um login que funcione sem prompt. Caso contrário, o Desktop pode enviar outro push cada vez que tentar se reconectar.1158* **Verifique o jump host**: se seu jump host pede um login, por exemplo um push para um telefone, mude para um login que funcione sem prompt. Caso contrário, o Desktop pode enviar outro push cada vez que tentar se reconectar.

1160* **Teste a máquina remota**: inicie uma tarefa curta, saia do Desktop enquanto a tarefa ainda está em execução e abra a sessão novamente bem depois de a tarefa dever ter terminado. Se a tarefa não estiver concluída e a sessão não mostrar nenhum erro de autenticação, verifique na máquina remota [o que pode encerrar uma tarefa](#limits-while-desktop-is-disconnected).1159* **Teste a máquina remota**: inicie uma tarefa curta, saia do Desktop enquanto a tarefa ainda está em execução e abra a sessão novamente bem depois de a tarefa dever ter terminado. Se a tarefa não estiver concluída e a sessão não mostrar nenhum erro de autenticação, verifique na máquina remota [o que pode encerrar uma tarefa](#limits-while-desktop-is-disconnected).

1206 1205 

1207Se Claude precisar da sua aprovação ou lhe fizer uma pergunta enquanto o Desktop está desconectado, Claude aguarda na máquina remota. A espera não tem limite de tempo próprio. Quando o Desktop se reconecta ao processo, ele mostra a solicitação. Se, em vez disso, o Desktop iniciar um novo processo, você perde a solicitação.1206Se Claude precisar da sua aprovação ou lhe fizer uma pergunta enquanto o Desktop está desconectado, Claude aguarda na máquina remota. A espera não tem limite de tempo próprio. Quando o Desktop se reconecta ao processo, ele mostra a solicitação. Se, em vez disso, o Desktop iniciar um novo processo, você perde a solicitação.

1208 1207 

1209Enquanto uma tarefa aguarda por você, o Desktop pode reiniciar sozinho, por exemplo para instalar uma atualização. Se o Desktop é executado no Windows ou usa um provedor terceirizado, você perde a solicitação após essa reinicialização.1208Se uma solicitação que aguardava por você tiver sumido quando você voltar, uma causa possível é que o Desktop reiniciou sozinho, por exemplo para instalar uma atualização. Você só mantém uma solicitação após uma reinicialização se o Desktop conseguir se reconectar ao processo, então verifique [quando o Desktop consegue se reconectar](#reopen-a-session-after-you-quit-desktop) antes de deixar uma tarefa em execução.

1210 1209 

1211Se você perder uma solicitação, envie uma mensagem para continuar.1210Se você perder uma solicitação, envie uma mensagem para continuar.

1212 1211 

1238 - **Jump host, os pushes continuam chegando**: onde o Desktop não consegue perceber que ninguém responde, como com o Desktop no Windows, ele continua tentando enquanto tiver um processo ao qual se reconectar, esteja esse processo ainda em execução ou não. Você pode receber outro push a cada tentativa. Para encerrar as tentativas, saia do Desktop, o que [pode custar a tarefa em execução](#reopen-a-session-after-you-quit-desktop).1237 - **Jump host, os pushes continuam chegando**: onde o Desktop não consegue perceber que ninguém responde, como com o Desktop no Windows, ele continua tentando enquanto tiver um processo ao qual se reconectar, esteja esse processo ainda em execução ou não. Você pode receber outro push a cada tentativa. Para encerrar as tentativas, saia do Desktop, o que [pode custar a tarefa em execução](#reopen-a-session-after-you-quit-desktop).

1239 - **Interrupção longa**: o Desktop reduz o ritmo para cerca de uma tentativa a cada cinco minutos. Para se reconectar mais cedo, tente novamente na sessão ou envie uma mensagem, que o Desktop entrega assim que estiver conectado.1238 - **Interrupção longa**: o Desktop reduz o ritmo para cerca de uma tentativa a cada cinco minutos. Para se reconectar mais cedo, tente novamente na sessão ou envie uma mensagem, que o Desktop entrega assim que estiver conectado.

1240 - **Saída ausente**: enquanto o Desktop está desconectado, o auxiliar mantém a saída mais recente do Claude Code de cada sessão em um buffer de 16 MiB e descarta a saída mais antiga. Depois que o Desktop se reconecta, a sessão pode mostrar `Loading recent output from <host>…`. Se o Desktop não conseguir carregar toda a saída, você verá a linha `Some output produced while you were disconnected may be missing here.` Essa linha não significa que a tarefa parou.1239 - **Saída ausente**: enquanto o Desktop está desconectado, o auxiliar mantém a saída mais recente do Claude Code de cada sessão em um buffer de 16 MiB e descarta a saída mais antiga. Depois que o Desktop se reconecta, a sessão pode mostrar `Loading recent output from <host>…`. Se o Desktop não conseguir carregar toda a saída, você verá a linha `Some output produced while you were disconnected may be missing here.` Essa linha não significa que a tarefa parou.

1241 - **Processo desaparecido**: se o processo tiver desaparecido quando o Desktop se reconectar, o Desktop pode iniciar um novo a partir do histórico salvo da conversa e pedir a Claude que continue a tarefa. O Desktop não continua a tarefa sozinho se o processo continuar terminando, ou se o Desktop usar um provedor terceirizado. Envie uma mensagem para continuar.1240 - **Processo sumiu**: o processo terminou enquanto o Desktop estava desconectado, como quando a máquina remota reinicia. O Desktop pode então iniciar um novo a partir do histórico salvo da conversa e dizer ao Claude para continuar a tarefa. Se a tarefa continuar parada, envie uma mensagem. Com um provedor terceirizado, atualize para o Claude Desktop v2.42304.0 ou posterior, porque as versões anteriores nunca continuam a tarefa sozinhas.

1242</Accordion>1241</Accordion>

1243 1242 

1244<a id="reopen-a-session-after-you-quit-desktop" />1243<a id="reopen-a-session-after-you-quit-desktop" />

1247 Reabrir uma sessão depois de sair do Desktop1246 Reabrir uma sessão depois de sair do Desktop

1248</h5>1247</h5>

1249 1248 

1250Depois que você sai do Desktop, a tarefa continua em execução na máquina remota até terminar, precisar de você ou atingir um dos [limites](#limits-while-desktop-is-disconnected).1249Depois que você sai do Desktop, a tarefa continua em execução na máquina remota, mas para quando a sessão é aberta novamente, a menos que o Desktop consiga se reconectar ao processo dela. Enquanto o Desktop está fechado, a tarefa é executada até terminar, precisar de você ou atingir um dos [limites](#limits-while-desktop-is-disconnected).

1251 1250 

1252* **Desktop no macOS ou no Linux, com uma conta Claude**: inicie o Desktop e abra a sessão. Você recupera a tarefa em execução quando o Desktop consegue se reconectar ao processo. Nem sempre ele consegue, por exemplo após algumas atualizações do Desktop ou depois que sua organização altera as configurações gerenciadas.1251* **Desktop no Windows**: você não recupera a tarefa em execução, porque o Desktop nunca se reconecta depois de sair. Inicie o Desktop novamente somente quando esperar que a tarefa esteja concluída, porque a sessão pode ser aberta quando o Desktop é iniciado.

1253* **No macOS ou no Linux, quando o Desktop não consegue se reconectar**: o Desktop encerra o processo e inicia um novo a partir do histórico salvo da conversa. Sua tarefa em execução para, e você perde qualquer aprovação ou pergunta que estava aguardando por você. Após uma atualização, o Desktop pode então pedir a Claude que continue. Se a tarefa continuar parada, envie uma mensagem.1252* **Provedor terceirizado, tarefa de uma versão anterior**: se você iniciou a tarefa em uma versão do Desktop anterior à v2.42304.0, também não a recupera no macOS nem no Linux. Inicie o Desktop novamente somente quando esperar que a tarefa esteja concluída.

1254* **Desktop no Windows, ou com um provedor terceirizado em qualquer plataforma**: inicie o Desktop novamente somente quando esperar que a tarefa esteja concluída. Você não recupera a tarefa em execução, porque o Desktop nunca se reconecta após uma saída. Ele encerra o processo quando a sessão é aberta, o que pode acontecer quando o Desktop é iniciado. Envie uma mensagem para continuar.1253* **Qualquer outra tarefa, com o Desktop no macOS ou no Linux**: inicie o Desktop e abra a sessão, e a tarefa continua se o Desktop se reconectar. Ele nem sempre consegue se reconectar, por exemplo após algumas atualizações do Desktop, então [atualize antes de uma tarefa longa](#prepare-a-long-task).

1254 

1255Quando o Desktop não consegue se reconectar, você também perde qualquer aprovação ou pergunta que estava aguardando por você. Se a tarefa não continuar sozinha, envie uma mensagem, e o Claude continua a partir do histórico salvo da conversa.

1255 1256 

1256Para implantações de terceiros, consulte [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).1257Para implantações de terceiros, consulte [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).

1257 1258 

186 | - | - | - |186 | - | - | - |

187 | **Executa** | Um comando shell, solicitação HTTP, chamada de ferramenta MCP, prompt LLM ou subagent | Instruções que Claude lê e segue |187 | **Executa** | Um comando shell, solicitação HTTP, chamada de ferramenta MCP, prompt LLM ou subagent | Instruções que Claude lê e segue |

188 | **Disparado por** | [Eventos de ciclo de vida](/docs/pt/hooks#hook-events) como `PostToolUse` ou `SessionStart` | Você digitando `/<name>`, ou Claude correspondendo a descrição à sua tarefa |188 | **Disparado por** | [Eventos de ciclo de vida](/docs/pt/hooks#hook-events) como `PostToolUse` ou `SessionStart` | Você digitando `/<name>`, ou Claude correspondendo a descrição à sua tarefa |

189 | **Determinismo** | Sempre dispara em seu evento; o gatilho é garantido | Claude interpreta as instruções; o resultado pode variar |189 | **Determinismo** | Dispara em seu evento sem que Claude decida | Claude interpreta as instruções; o resultado pode variar |

190 | **Custo de contexto** | Zero a menos que o hook retorne saída | Descrição carrega a cada sessão; conteúdo completo carrega quando usado |190 | **Custo de contexto** | Zero a menos que o hook retorne saída | Descrição carrega a cada sessão; conteúdo completo carrega quando usado |

191 | **Melhor para** | Linting após edições, bloqueio de comandos inseguros, logging, notificações | Fluxos de trabalho que precisam de raciocínio, material de referência, tarefas de múltiplas etapas |191 | **Melhor para** | Linting após edições, bloqueio de comandos inseguros, logging, notificações | Fluxos de trabalho que precisam de raciocínio, material de referência, tarefas de múltiplas etapas |

192 192 

1832 1832 

1833Use o [controle de decisão do PreToolUse](#pretooluse-decision-control) para permitir, negar, perguntar ou adiar a chamada de ferramenta.1833Use o [controle de decisão do PreToolUse](#pretooluse-decision-control) para permitir, negar, perguntar ou adiar a chamada de ferramenta.

1834 1834 

1835Um [hook de callback do Agent SDK](/docs/pt/agent-sdk/hooks) em `PreToolUse` que excede seu timeout bloqueia a chamada de ferramenta, e o Claude recebe um resultado de erro nomeando o timeout. Uma negação explícita retornada por outro hook ainda tem precedência.1835Um [hook de callback do Agent SDK](/docs/pt/agent-sdk/hooks) em `PreToolUse` que excede seu timeout bloqueia a chamada de ferramenta, e o Claude recebe um resultado de erro indicando o timeout.

1836 1836 

1837<h4 id="pretooluse-input">1837<h4 id="pretooluse-input">

1838 Entrada do PreToolUse1838 Entrada do PreToolUse

213Se a instalação falhar, corresponda à mensagem que Claude Code relata:213Se a instalação falhar, corresponda à mensagem que Claude Code relata:

214 214 

215* `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.215* `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.

216* O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.216* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: sua cópia local do catálogo do marketplace pode estar desatualizada. Atualize-a com `/plugin marketplace update claude-plugins-official` e, depois, tente novamente a instalação. Se a nova tentativa exibir a mesma mensagem, consulte [Plugin not found in marketplace](/docs/pt/plugins/troubleshooting#plugin-not-found-in-marketplace).

217 217 

218Para habilitar um plugin para todos no repositório em vez de instalá-lo você mesmo, adicione-o à [configuração de projeto `enabledPlugins`](/docs/pt/settings-reference#plugin-settings).218Para habilitar um plugin para todos no repositório em vez de instalá-lo você mesmo, adicione-o à [configuração de projeto `enabledPlugins`](/docs/pt/settings-reference#plugin-settings).

219 219 

50 Se a instalação falhar, corresponda à mensagem que Claude Code relata:50 Se a instalação falhar, corresponda à mensagem que Claude Code relata:

51 51 

52 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.52 * `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.

53 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.53 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: sua cópia local do catálogo do marketplace pode estar desatualizada. Atualize-a com `/plugin marketplace update claude-plugins-official` e, em seguida, tente novamente a instalação. Se a nova tentativa exibir a mesma mensagem, consulte [Plugin não encontrado no marketplace](/docs/pt/plugins/troubleshooting#plugin-not-found-in-marketplace).

54 54 

55 Se o resumo da instalação relatar `Run /reload-plugins to apply.`, Claude Code então executa esse recarregamento para você. Se o recarregamento avisar que sua próxima mensagem releria a conversa, execute `/reload-plugins --force`.55 Se o resumo da instalação relatar `Run /reload-plugins to apply.`, Claude Code então executa esse recarregamento para você. Se o recarregamento avisar que sua próxima mensagem releria a conversa, execute `/reload-plugins --force`.

56 </Step>56 </Step>

772**Atributos**:772**Atributos**:

773 773 

774* Todos os [atributos padrão](#standard-attributes)774* Todos os [atributos padrão](#standard-attributes)

775* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`). O tipo `"input"` exclui tokens lidos do cache de prompt ou gravados nele, que são contados em `"cacheRead"` e `"cacheCreation"`775* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`). O tipo `"input"` exclui tokens lidos do cache de prompt ou gravados nele, que são contados em `"cacheRead"` e `"cacheCreation"`. O tipo `"cacheCreation"` conta juntas as gravações em cache com os [tempos de vida de cache](/docs/pt/prompt-caching#cache-lifetime) de cinco minutos e de uma hora.

776* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")776* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

777* `query_source`: Categoria do subsistema que emitiu a requisição. Um de `"main"`, `"subagent"`, ou `"auxiliary"`777* `query_source`: Categoria do subsistema que emitiu a requisição. Um de `"main"`, `"subagent"`, ou `"auxiliary"`

778* `speed`: `"fast"` quando a requisição usou modo rápido. Ausente caso contrário778* `speed`: `"fast"` quando a requisição usou modo rápido. Ausente caso contrário

749Essas verificações ainda se aplicam:749Essas verificações ainda se aplicam:

750 750 

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

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

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

754* 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)752* 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)

755 753 

756Comandos 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.754Comandos 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.

78 78 

79Mods não substituem os controles que você já tem:79Mods não substituem os controles que você já tem:

80 80 

81* **Hooks de configurações continuam funcionando.** Hooks de comando, HTTP, prompt e agente em arquivos de configurações e em `hooks/hooks.json` de plugins são executados como antes, ao lado de mods. Nada sobre eles está descontinuado.81* **Hooks de configuração continuam funcionando.** Hooks de comando, HTTP, prompt e agente em arquivos de configurações e em `hooks/hooks.json` de plugins são executados como antes, ao lado de mods.

82* **Regras de negação têm precedência onde o guard é carregado.** Um mod de um usuário não pode aprovar uma chamada que uma regra `deny` recusa, a menos que você defina [`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard).82* **Regras de negação têm precedência onde o guard é carregado.** Um mod de um usuário não pode aprovar uma chamada que uma regra `deny` recusa, a menos que você defina [`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard).

83* **Hooks gerenciados são executados primeiro.** Um hook `PreToolUse` em configurações gerenciadas é executado antes de qualquer mod ver a chamada de ferramenta, e seu bloqueio é final. Se um mod então reescrever a chamada, seus hooks gerenciados são executados novamente na chamada reescrita, então um bloqueio ainda se aplica. Hooks `PreToolUse` de outros arquivos de configurações e de plugins são executados após o último mod, então um mod que retorna seu próprio resultado no lugar de executar a ferramenta impede que aqueles sejam executados. Veja [A ordem em que mods são executados](/docs/pt/plugins/mods/events#the-order-mods-run-in).83* **Hooks gerenciados são executados primeiro.** Um hook `PreToolUse` em configurações gerenciadas é executado antes de qualquer mod ver a chamada de ferramenta, e seu bloqueio é final. Se um mod então reescrever a chamada, seus hooks gerenciados são executados novamente na chamada reescrita, então um bloqueio ainda se aplica. Hooks `PreToolUse` de outros arquivos de configurações e de plugins são executados após o último mod, então um mod que retorna seu próprio resultado no lugar de executar a ferramenta impede que aqueles sejam executados. Veja [A ordem em que mods são executados](/docs/pt/plugins/mods/events#the-order-mods-run-in).

84* **Política de rede cobre `$.http.fetch`.**84* **Política de rede cobre `$.http.fetch`.**

114 `Text`114 `Text`

115</h3>115</h3>

116 116 

117`Text` desenha uma string com os estilos que você fornece. Este exemplo mostra uma linha para cada estilo:117`Text` desenha uma string com os estilos que você fornece. Este exemplo mostra texto simples e oito estilos, um em cada linha:

118 118 

119```javascript theme={null}119```javascript theme={null}

120Box({120Box({

455 455 

456| Elemento | O que desenha | Onde |456| Elemento | O que desenha | Onde |

457| :- | :- | :- |457| :- | :- | :- |

458| `Box` | Um contêiner flex. Leva props de layout como `flexDirection`, `columnGap`, `padding`, [`borderStyle`](/docs/pt/plugins/mods/reference#box-border-styles) e `width`. | Em todos os lugares |458| `Box` | Um contêiner flex que leva props de layout como `flexDirection`, [`borderStyle`](/docs/pt/plugins/mods/reference#box-border-styles) e `width`. Props de espaçamento como `columnGap` e `padding` levam um número ou um [nome de passo](/docs/pt/plugins/mods/reference#box-spacing-steps) de `'xs'` a `'xl'`. | Em todos os lugares |

459| `Text` | Texto estilizado. Leva `color`, `bold`, `dimColor`, `italic` e `wrap`. Uma `color` é uma chave de tema ou uma cor como `'red'`. Um `wrap` é `'wrap'`, `'truncate'`, `'truncate-start'`, `'truncate-middle'` ou `'truncate-end'`. | Em todos os lugares |459| `Text` | Texto estilizado. Leva `color`, `bold`, `dimColor`, `italic`, `wrap` e outras como [`weight`](/docs/pt/plugins/mods/reference#text-typography). Uma `color` é uma chave de tema ou uma cor como `'red'`. Um `wrap` é `'wrap'`, `'truncate'`, `'truncate-start'`, `'truncate-middle'` ou `'truncate-end'`. | Em todos os lugares |

460| `Button` | Um controle que chama `onPress` | Em todos os lugares |460| `Button` | Um controle que chama `onPress` | Em todos os lugares |

461| `Link`, `Code`, `Markdown` | Um link com `href` e um `label` opcional, um bloco de código e texto formatado da forma que as respostas do Claude são. `Markdown` leva seu conteúdo em uma propriedade `text`, não em `children`, e precisa de uma `key` quando você passa `onLinkPress`. | Em todos os lugares |461| `Link`, `Code`, `Markdown` | Um link com `href` e um `label` opcional, um bloco de código e texto formatado da forma que as respostas do Claude são. `Markdown` leva seu conteúdo em uma propriedade `text`, não em `children`, e precisa de uma `key` quando você passa `onLinkPress`. | Em todos os lugares |

462| `Input`, `Select` | Um campo de texto e um seletor | Terminal, Desktop, VS Code |462| `Input`, `Select` | Um campo de texto e um seletor | Terminal, Desktop, VS Code |

293 293 

294| Elemento | Props principais | Terminal | Desktop | VS Code |294| Elemento | Props principais | Terminal | Desktop | VS Code |

295| :- | :- | :-: | :-: | :-: |295| :- | :- | :-: | :-: | :-: |

296| [`Box`](/docs/pt/plugins/mods/interface#build-a-tree-from-elements) | `key`, layout flex, `gap`, `padding`, `margin`, `width`, `height`, [`borderStyle`](#box-border-styles), `backgroundColor`, `position`, `hover` | ✓ | ✓ | ✓ |296| [`Box`](/docs/pt/plugins/mods/interface#build-a-tree-from-elements) | `key`, layout flex, [`gap`, `padding`, `margin`](#box-spacing-steps), `width`, `height`, [`borderStyle`](#box-border-styles), `backgroundColor`, `position`, `hover` | ✓ | ✓ | ✓ |

297| [`Text`](/docs/pt/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, `bold`, `italic`, `underline`, `dimColor`, `inverse`, `wrap` | ✓ | ✓ | ✓ |297| [`Text`](/docs/pt/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, [`bold`](#text-bold), `italic`, `underline`, `dimColor`, `inverse`, `wrap`, [`size`, `weight`, `mono`, `tabular`](#text-typography) | ✓ | ✓ | ✓ |

298| [`Button`](/docs/pt/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ | ✓ |298| [`Button`](/docs/pt/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ | ✓ |

299| [`Link`](/docs/pt/plugins/mods/interface#link-in-the-desktop-app) | `href`, `label`. Consulte [Limites](#limits). | ✓ | ✓ | ✓ |299| [`Link`](/docs/pt/plugins/mods/interface#link-in-the-desktop-app) | `href`, `label`. Consulte [Limites](#limits). | ✓ | ✓ | ✓ |

300| [`Code`](/docs/pt/plugins/mods/gallery#show-code-and-changes) | `source`, `language`, `path`, `startLine`, `format`, `wrap` | ✓ | ✓ | ✓ |300| [`Code`](/docs/pt/plugins/mods/gallery#show-code-and-changes) | `source`, `language`, `path`, `startLine`, `format`, `wrap` | ✓ | ✓ | ✓ |

311A extensão do VS Code ignora algumas props de elementos e desenha o elemento como se você as tivesse omitido:311A extensão do VS Code ignora algumas props de elementos e desenha o elemento como se você as tivesse omitido:

312 312 

313* **`Box`**: `position` e `hover`313* **`Box`**: `position` e `hover`

314* **`Text`**: `size`, `mono` e `tabular`

314* **`Button`**: `hotkey`, `plain`, `autoFocus` e `action`, então o usuário pressiona um botão ali com um clique, ou com Enter quando ele estiver com o foco315* **`Button`**: `hotkey`, `plain`, `autoFocus` e `action`, então o usuário pressiona um botão ali com um clique, ou com Enter quando ele estiver com o foco

315* **`Code`**: `language`, `path`, `startLine`, `format` e `wrap`, então o código é desenhado sem cores nem números de linha, e um bloco `format: 'diff'` mostra o texto bruto do diff316* **`Code`**: `language`, `path`, `startLine`, `format` e `wrap`, então o código é desenhado sem cores nem números de linha, e um bloco `format: 'diff'` mostra o texto bruto do diff

316* **`Input` e `Select`**: `autoFocus`317* **`Input` e `Select`**: `autoFocus`

336 337 

337Um `Box` cujo `borderStyle` indica qualquer outro nome, como `'rounded'`, é desenhado sem borda.338Um `Box` cujo `borderStyle` indica qualquer outro nome, como `'rounded'`, é desenhado sem borda.

338 339 

340<h3 id="box-spacing-steps">

341 Passos de espaçamento de `Box`

342</h3>

343 

344As props de espaçamento de `Box` são `gap`, `columnGap`, `rowGap`, `padding`, `margin` e as formas de um lado e de um eixo de `padding` e `margin`, como `paddingX` e `marginTop`. Cada uma aceita um número de células do terminal, como `gap: 1`, ou um nome de passo, como `gap: 'md'`. No terminal e na extensão do VS Code, cada passo corresponde a esta quantidade de células:

345 

346| Passo | Células na horizontal | Células na vertical |

347| :- | :- | :- |

348| `'xs'` | 1 | 0 |

349| `'sm'` | 1 | 0 |

350| `'md'` | 2 | 1 |

351| `'lg'` | 3 | 1 |

352| `'xl'` | 4 | 2 |

353 

354Se você definir `gap`, `padding` ou `margin` como um passo, o passo se aplica na horizontal e na vertical ao mesmo tempo. Por exemplo, no terminal e na extensão do VS Code, `padding: 'md'` equivale a duas células de cada lado e uma linha acima e abaixo.

355 

356Nomes de passos exigem o Claude Code v2.1.299 ou posterior. Em uma versão anterior, o Claude Code [desenha sua própria versão do site](/docs/pt/plugins/mods/interface#build-a-tree-from-elements) no lugar de uma árvore que usa um nome de passo.

357 

358<h3 id="text-typography">

359 Props de tipografia de `Text`

360</h3>

361 

362Defina `size`, `weight`, `mono` ou `tabular` em um `Text` para pedir ao aplicativo que desenha sua árvore um tamanho de texto, um peso, uma fonte monoespaçada ou dígitos de largura igual. Antes de depender de uma prop, verifique o que o terminal e a extensão do VS Code fazem com ela. Se um aplicativo ignorar uma prop que você definiu, sua árvore ainda é desenhada ali, com o texto como se você tivesse omitido essa prop.

363 

364| Prop | Valores | No terminal | Na extensão do VS Code |

365| :- | :- | :- | :- |

366| `size` | `'caption'`, `'footnote'`, `'body'`, `'heading'` ou `'title'` | Ignorada: o terminal tem um único tamanho de texto | Ignorada |

367| `weight` | `'regular'`, `'medium'`, `'semibold'` ou `'bold'` | `semibold` e `bold` são desenhados como texto em negrito | `semibold` e `bold` são desenhados como texto em negrito |

368| `mono` | `true` para pedir a fonte monoespaçada do aplicativo | Ignorada: o terminal é sempre monoespaçado | Ignorada, então o texto mantém a fonte própria da extensão |

369| `tabular` | `true` para pedir dígitos de largura igual, para que um número que é atualizado no lugar ou uma coluna de números permaneça alinhado | Ignorada: os dígitos do terminal já têm uma célula de largura | Ignorada |

370 

371Essas quatro props exigem o Claude Code v2.1.299 ou posterior. Em uma versão anterior, o Claude Code [desenha sua própria versão do site](/docs/pt/plugins/mods/interface#build-a-tree-from-elements) no lugar de uma árvore que define `size`, `weight`, `mono` ou `tabular`.

372 

373<h4 id="text-bold">

374 Substituir `bold` por `weight`

375</h4>

376 

377`bold` em um `Text` foi descontinuado em favor de `weight` e ainda funciona. Para substituí-lo em um `Text` sem `weight`, altere `bold: true` para `weight: 'semibold'` para obter o mesmo resultado no Claude Code v2.1.299 ou posterior.

378 

379Em uma versão anterior à v2.1.299, uma árvore que define `weight` não é desenhada, e o Claude Code [desenha sua própria versão do site](/docs/pt/plugins/mods/interface#build-a-tree-from-elements) em vez dela. Se você definir tanto `bold` quanto `weight` em um `Text`, `bold` não tem efeito.

380 

339<h2 id="limits">381<h2 id="limits">

340 Limites382 Limites

341</h2>383</h2>

235 235 

236O mod carregou e seu painel, banda, toast ou controles não se comportam como você espera.236O mod carregou e seu painel, banda, toast ou controles não se comportam como você espera.

237 237 

238<h3 id="another-mods-band-shows-and-yours-doesnt">

239 A banda de outro mod aparece e a sua não

240</h3>

241 

242Há uma única banda acima do prompt, e todos os mods a compartilham. Um mod que executa [antes do seu](/docs/pt/plugins/mods/events#the-order-mods-run-in) substitui a sua banda quando retorna uma árvore sem o resultado de `next(e)` nela. Para mostrar as duas bandas, altere o hook desse mod, ou peça ao autor dele que o faça:

243 

244* **Manter as bandas depois dele**: coloque o resultado de `await next(e)` entre os filhos de um `Box` na árvore dele, como na aba Banda acima do prompt de [Escolher onde desenhar](/docs/pt/plugins/mods/interface#pick-where-to-draw)

245* **Manter a árvore válida**: não dê a esse `Box`, nem a nenhum `Box` ao redor dele, uma prop `width`, `height`, `minWidth`, `minHeight`, `position`, `top`, `left`, `right`, `bottom`, `display` ou `overflow`

246 

247Para encontrar esse mod, [grave um log de depuração](#read-the-debug-log) e procure nele por `answered ui.render without next()`. Uma linha como `other-mod (user) answered ui.render without next()` nomeia um mod que retornou sua árvore sem chamar `next(e)`. Ela não nomeia o [ponto de renderização](/docs/pt/plugins/mods/reference#render-sites), então um mod que desenha apenas em um painel também pode aparecer. Um mod que chama `next(e)` e descarta o resultado não gera nenhuma linha, então verifique também os hooks que executam antes do seu.

248 

249Após a alteração, você não vê nada na banda se algum dos mods retornar uma árvore que não valida. Para ler o motivo, procure uma linha `ui.render (AbovePrompt) refused:` na transcrição de uma sessão com `--plugin-dir`, ou procure `does not validate` no log de depuração. Com vários mods na banda, nenhuma das linhas nomeia um mod, então verifique a árvore de cada mod.

250 

238<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">251<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">

239 Um painel ou banda está vazio ou mostra o conteúdo usual de Claude Code252 Um painel ou banda está vazio ou mostra o conteúdo usual de Claude Code

240</h3>253</h3>

199 199 

200Mesmo no modo auto-allow, o seguinte ainda se aplica:200Mesmo no modo auto-allow, o seguinte ainda se aplica:

201 201 

202* [Regras de negação](/docs/pt/permissions) explícitas são sempre respeitadas202* Um comando em uma [forma à qual uma regra de negação `Bash` corresponde](/docs/pt/permissions#bash-rule-limits) ainda é bloqueado

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` reconhecidos como tendo como alvo um [caminho crítico](/docs/pt/permission-modes#which-paths-are-critical) 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 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 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 *)`

114 Segurança do IDE114 Segurança do IDE

115</h2>115</h2>

116 116 

117Consulte [VS Code security and privacy](/docs/pt/vs-code#security-and-privacy) para mais informações sobre como executar Claude Code em um IDE.117Consulte [O servidor MCP de IDE integrado](/docs/pt/vs-code#the-built-in-ide-mcp-server) para mais informações sobre como executar Claude Code em um IDE.

118 118 

119<h2 id="cloud-execution-security">119<h2 id="cloud-execution-security">

120 Segurança de execução em nuvem120 Segurança de execução em nuvem

42Se a instalação falhar, corresponda à mensagem que Claude Code relata:42Se a instalação falhar, corresponda à mensagem que Claude Code relata:

43 43 

44* `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.44* `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.

45* O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.45* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: sua cópia local do catálogo do marketplace pode estar desatualizada. Atualize-a com `/plugin marketplace update claude-plugins-official`, depois tente novamente a instalação. Se a nova tentativa exibir a mesma mensagem, consulte [Plugin não encontrado no marketplace](/docs/pt/plugins/troubleshooting#plugin-not-found-in-marketplace).

46 46 

47Verifique o resumo da instalação. Se relatar `Run /reload-plugins to apply.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/plugins/cli-reference#reload-plugins) para ativar o plugin em sua sessão atual.47Verifique o resumo da instalação. Se relatar `Run /reload-plugins to apply.`, consulte [Aplicar alterações de plugin sem reiniciar](/docs/pt/plugins/cli-reference#reload-plugins) para ativar o plugin em sua sessão atual.

48 48 

718 718 

719Se você invocar uma skill com argumentos, mas nenhum placeholder no conteúdo da skill receber um, o Claude Code anexa `ARGUMENTS: <your input>` ao final do conteúdo da skill para que Claude ainda veja o que você digitou. Um placeholder é `$ARGUMENTS`, uma forma indexada como `$1` ou um argumento nomeado. Um placeholder indexado sem argumento em sua posição permanece como texto literal e não conta como tendo recebido um. Um placeholder nomeado conta mesmo quando sua posição não tem argumento, porque ele se expande para uma string vazia.719Se você invocar uma skill com argumentos, mas nenhum placeholder no conteúdo da skill receber um, o Claude Code anexa `ARGUMENTS: <your input>` ao final do conteúdo da skill para que Claude ainda veja o que você digitou. Um placeholder é `$ARGUMENTS`, uma forma indexada como `$1` ou um argumento nomeado. Um placeholder indexado sem argumento em sua posição permanece como texto literal e não conta como tendo recebido um. Um placeholder nomeado conta mesmo quando sua posição não tem argumento, porque ele se expande para uma string vazia.

720 720 

721Você também pode empilhar várias skills no início de uma mensagem. Digitar `/write-tests /fix-issue 123` carrega ambas as skills e passa o texto final `123` como `$ARGUMENTS` para cada uma delas.

722 

723O Claude Code expande a primeira skill mais até cinco outras empilhadas depois dela. A expansão para no primeiro token que não seja uma skill inline invocável pelo usuário, então uma skill que é executada como um [subagente bifurcado](#run-skills-in-a-subagent), como [`/code-review`](/docs/pt/code-review-local), ou uma cujos argumentos possam começar com um comando de barra, como `/loop`, também encerra a sequência ali. Esse token e tudo o que vem depois dele se tornam o texto de argumento para cada skill expandida. `/code-review` é executada como um subagente bifurcado a partir da v2.1.218; em versões anteriores, ela era executada inline e empilhada.

724 

725Para acessar argumentos individuais por posição, use `$ARGUMENTS[N]` ou a forma mais curta `$N`:721Para acessar argumentos individuais por posição, use `$ARGUMENTS[N]` ou a forma mais curta `$N`:

726 722 

727```yaml theme={null}723```yaml theme={null}

746Preserve all existing behavior and tests.742Preserve all existing behavior and tests.

747```743```

748 744 

745<h4 id="stack-several-skills-in-one-message">

746 Empilhar várias skills em uma mensagem

747</h4>

748 

749Quando você digita no prompt do Claude Code no seu terminal, pode empilhar várias skills no início de uma mensagem. Por meio do Agent SDK ou de `claude -p`, o Claude Code carrega apenas a primeira skill, com o restante da linha como seus argumentos. No prompt do terminal, digitar `/write-tests /fix-issue 123` carrega ambas as skills e passa o texto final `123` como `$ARGUMENTS` para cada uma delas.

750 

751O Claude Code expande a primeira skill mais até cinco outras empilhadas depois dela. A expansão para no primeiro token que não seja uma skill inline invocável pelo usuário. Se você empilhar uma skill que é executada como um [subagente bifurcado](#run-skills-in-a-subagent), como [`/code-review`](/docs/pt/code-review-local), ou uma cujos argumentos possam começar com outro comando, como `/loop`, a expansão termina ali. Esse token e tudo o que vem depois dele se tornam o texto de argumento para cada skill expandida.

752 

749<h2 id="advanced-patterns">753<h2 id="advanced-patterns">

750 Padrões avançados754 Padrões avançados

751</h2>755</h2>

1044Se a instalação falhar, corresponda à mensagem que Claude Code relata:1048Se a instalação falhar, corresponda à mensagem que Claude Code relata:

1045 1049 

1046* `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.1050* `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente novamente a instalação.

1047* O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.1051* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: sua cópia local do catálogo do marketplace pode estar desatualizada. Atualize-a com `/plugin marketplace update claude-plugins-official` e, em seguida, tente novamente a instalação. Se a nova tentativa exibir a mesma mensagem, consulte [Plugin not found in marketplace](/docs/pt/plugins/troubleshooting#plugin-not-found-in-marketplace).

1048 1052 

1049Se o resumo da instalação relatar `Run /reload-plugins to apply.`, Claude Code então executa esse reload para você. Se o reload avisar que sua próxima mensagem releria a conversa, execute `/reload-plugins --force` para disponibilizar as skills do plugin na sessão atual. Depois peça ao Claude para avaliar uma skill existente, por exemplo `evaluate my summarize-changes skill with skill-creator`. O plugin o orienta através da escrita de casos de teste e executa o loop:1053Se o resumo da instalação relatar `Run /reload-plugins to apply.`, Claude Code então executa esse reload para você. Se o reload avisar que sua próxima mensagem releria a conversa, execute `/reload-plugins --force` para disponibilizar as skills do plugin na sessão atual. Depois peça ao Claude para avaliar uma skill existente, por exemplo `evaluate my summarize-changes skill with skill-creator`. O plugin o orienta através da escrita de casos de teste e executa o loop:

1050 1054 

281 Modo tela cheia281 Modo tela cheia

282 </h4>282 </h4>

283 283 

284 Claude Code pinta `userMessageBackground`, `bashMessageBackgroundColor` e `memoryBackgroundColor` nos renderizadores padrão e tela cheia. Ele usa `userMessageBackgroundHover` e `selectionBg` apenas no [modo de renderização tela cheia](/docs/pt/fullscreen).284 Claude Code usa `userMessageBackgroundHover`, `selectionBg` e `composerSidebarBackground` apenas no [modo de renderização tela cheia](/docs/pt/fullscreen). Ele pinta `userMessageBackground`, `bashMessageBackgroundColor` e `memoryBackgroundColor` nos renderizadores padrão e tela cheia.

285 285 

286 | Token | Controla |286 | Token | Controla |

287 | :- | :- |287 | :- | :- |

290 | `bashMessageBackgroundColor` | Fundo atrás de entradas de comando shell `!` na transcrição |290 | `bashMessageBackgroundColor` | Fundo atrás de entradas de comando shell `!` na transcrição |

291 | `memoryBackgroundColor` | Fundo atrás de entradas de memória `#` na transcrição |291 | `memoryBackgroundColor` | Fundo atrás de entradas de memória `#` na transcrição |

292 | `selectionBg` | Fundo do texto selecionado com o mouse |292 | `selectionBg` | Fundo do texto selecionado com o mouse |

293 | `composerSidebarBackground` | Fundo do painel ao lado da conversa, como o [painel de diff](/docs/pt/fullscreen#watch-your-changes-in-the-diff-panel) ou o [painel de um mod](/docs/pt/plugins/mods/interface) |

293 294 

294 <h4 id="usage-meter-and-speaker-labels">295 <h4 id="usage-meter-and-speaker-labels">

295 Medidor de uso e rótulos de alto-falante296 Medidor de uso e rótulos de alto-falante

10 10 

11A extensão VS Code fornece uma interface gráfica nativa para Claude Code, integrada diretamente ao seu IDE. Esta é a forma recomendada de usar Claude Code no VS Code.11A extensão VS Code fornece uma interface gráfica nativa para Claude Code, integrada diretamente ao seu IDE. Esta é a forma recomendada de usar Claude Code no VS Code.

12 12 

13Com a extensão, você pode revisar e editar os planos do Claude antes de aceitá-los, aceitar automaticamente edições conforme são feitas, @-mencionar arquivos com intervalos de linhas específicas da sua seleção, acessar o histórico de conversas e abrir múltiplas conversas em abas separadas ou janelas.13Com a extensão, você pode:

14 

15* Revisar e editar os planos do Claude antes de aceitá-los

16* Aceitar automaticamente edições conforme são feitas

17* @-mencionar arquivos com intervalos de linhas específicas da sua seleção

18* Acessar o histórico de conversas

19* Abrir múltiplas conversas em abas ou janelas separadas

14 20 

15<h2 id="prerequisites">21<h2 id="prerequisites">

16 Pré-requisitos22 Pré-requisitos

26</Tip>32</Tip>

27 33 

28<h2 id="install-the-extension">34<h2 id="install-the-extension">

29 Instale a extensão35 Instalar a extensão

30</h2>36</h2>

31 37 

32Clique no link do seu IDE para instalar diretamente:38Clique no link do seu IDE para instalar diretamente:

34* [Instalar para VS Code](vscode:extension/anthropic.claude-code)40* [Instalar para VS Code](vscode:extension/anthropic.claude-code)

35* [Instalar para Cursor](cursor:extension/anthropic.claude-code)41* [Instalar para Cursor](cursor:extension/anthropic.claude-code)

36 42 

37Ou no VS Code, pressione `Cmd+Shift+X` (Mac) ou `Ctrl+Shift+X` (Windows/Linux) para abrir a visualização de Extensões, procure por "Claude Code" e clique em **Instalar**.43Ou, no VS Code, pressione `Cmd+Shift+X` (Mac) ou `Ctrl+Shift+X` (Windows/Linux) para abrir a visualização de Extensões, pesquise por "Claude Code" e clique em **Install**.

38 44 

39O número de versão da extensão é a versão do Claude Code que ela inclui. Por exemplo, um recurso que requer o Claude Code v2.1.286 ou posterior precisa da versão 2.1.286 ou posterior da extensão, que é exibida na visualização de Extensões.45O número de versão da extensão é a versão do Claude Code que ela inclui. Por exemplo, um recurso que requer o Claude Code v2.1.286 ou posterior precisa da versão 2.1.286 ou posterior da extensão, que é exibida na visualização de Extensões.

40 46 

41A extensão também é instalada em outros forks do VS Code como Devin Desktop ou Kiro. Procure por "Claude Code" na visualização de Extensões do editor, ou instale a partir do [registro Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Se o seu editor não conseguir instalar a extensão, [instale a CLI](/docs/pt/quickstart) e execute `claude` no seu terminal integrado. A CLI funciona em qualquer terminal.47O Claude Code também é executado em outros editores e contêineres:

42 48 

43Para executar o Claude Code dentro de um dev container, consulte [Contêineres de desenvolvimento](/docs/pt/devcontainer).49* **Outros forks do VS Code**: a extensão também pode ser instalada em forks como Devin Desktop ou Kiro. Pesquise por "Claude Code" na visualização de Extensões do editor ou instale a partir do [registro Open VSX](https://open-vsx.org/extension/Anthropic/claude-code).

50* **Editores que não conseguem instalar a extensão**: [instale a CLI](/docs/pt/quickstart) e execute `claude` no terminal integrado do editor. A CLI funciona em qualquer terminal.

51* **Dev containers**: para executar o Claude Code dentro de um dev container, consulte [Contêineres de desenvolvimento](/docs/pt/devcontainer).

44 52 

45<Note>Se a extensão não aparecer após a instalação, reinicie o VS Code ou execute "Developer: Reload Window" na Paleta de Comandos.</Note>53<Note>Se a extensão não aparecer após a instalação, reinicie o VS Code ou execute "Developer: Reload Window" na Paleta de Comandos.</Note>

46 54 

47<h2 id="get-started">55<h2 id="get-started">

48 Comece agora56 Comece a usar

49</h2>57</h2>

50 58 

51Após a instalação, você pode começar a usar Claude Code através da interface do VS Code:59Após a instalação, você pode começar a usar o Claude Code pela interface do VS Code:

52 60 

53<Steps>61<Steps>

54 <Step title="Abra o painel Claude Code">62 <Step title="Abra o painel do Claude Code">

55 Em todo o VS Code, o ícone Spark indica Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Ícone Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />63 Em todo o VS Code, o ícone Spark indica o Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Ícone Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

56 64 

57 A forma mais rápida de abrir Claude é clicar no ícone Spark na **Barra de Ferramentas do Editor** (canto superior direito do editor). O ícone só aparece quando você tem um arquivo aberto.65 A maneira mais rápida de abrir o Claude é clicar no ícone Spark na **Editor Toolbar** (canto superior direito do editor). O ícone só aparece quando você tem um arquivo aberto.

58 66 

59 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="VS Code editor mostrando o ícone Spark na Barra de Ferramentas do Editor" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />67 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="Editor do VS Code mostrando o ícone Spark na Editor Toolbar" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />

60 68 

61 Outras formas de abrir Claude Code:69 Outras maneiras de abrir o Claude Code:

62 70 

63 * **Activity Bar**: clique no ícone Spark na barra lateral esquerda para abrir a lista de sessões. Clique em qualquer sessão para abri-la no seu [local preferido](#extension-settings), ou inicie uma nova. Este ícone está sempre visível na Activity Bar.71 * **Activity Bar**: clique no ícone Spark na barra lateral esquerda para abrir a lista de sessões. Clique em qualquer sessão para abri-la no seu [local preferido](#extension-settings) ou inicie uma nova. Esse ícone está sempre visível na Activity Bar.

64 * **Command Palette**: `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux), digite "Claude Code" e selecione uma opção como "Open in New Tab"72 * **Command Palette**: `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux), digite "Claude Code" e selecione uma opção como "Open in New Tab"

65 * **Status Bar**: clique em **✻ Claude Code** no canto inferior direito da janela. Isso funciona mesmo quando nenhum arquivo está aberto.73 * **Status Bar**: clique em **✻ Claude Code** no canto inferior direito da janela. Isso funciona mesmo quando nenhum arquivo está aberto.

66 74 

67 Você pode arrastar o painel Claude para reposicioná-lo em qualquer lugar no VS Code. Veja [Personalize seu fluxo de trabalho](#customize-your-workflow) para detalhes.75 Você pode arrastar o painel do Claude para reposicioná-lo em qualquer lugar do VS Code. Consulte [Personalize seu fluxo de trabalho](#customize-your-workflow) para obter detalhes.

68 </Step>76 </Step>

69 77 

70 <Step title="Faça login">78 <Step title="Faça login">

71 A primeira vez que você abre o painel, uma tela de login aparece. Clique em **Sign in** e complete a autorização no seu navegador.79 Na primeira vez que você abre o painel, uma tela de login é exibida. Clique em **Sign in** e conclua a autorização no seu navegador.

72 80 

73 Se você vir **Not logged in · Please run /login** mais tarde, a extensão reabre a tela de login automaticamente. Se ela não aparecer, recarregue a janela a partir da Command Palette com **Developer: Reload Window**.81 Se você vir **Not logged in · Please run /login** mais tarde, a extensão reabre a tela de login automaticamente. Se ela não aparecer, recarregue a janela pela Command Palette com **Developer: Reload Window**.

74 82 

75 Se você tem `ANTHROPIC_API_KEY` definida no seu shell mas ainda vê o prompt de login, o VS Code pode não ter herdado o ambiente do seu shell. Inicie o VS Code a partir de um terminal com `code .` para que ele herde suas variáveis de ambiente, ou faça login com sua conta Claude.83 Se você tem `ANTHROPIC_API_KEY` definida no seu shell, mas ainda vê o prompt de login, o VS Code pode não ter herdado o ambiente do seu shell. Inicie o VS Code a partir de um terminal com `code .` para que ele herde suas variáveis de ambiente, ou faça login com sua conta Claude.

76 84 

77 Após fazer login, uma lista de verificação **Learn Claude Code** aparece. Trabalhe em cada item clicando em **Show me**, ou descarte-a com o X. Para reabri-la mais tarde, desmarque **Hide Onboarding** nas configurações do VS Code em Extensions → Claude Code.85 Depois que você fizer login, uma checklist **Learn Claude Code** será exibida. Percorra cada item clicando em **Show me** ou dispense-a com o X. Para reabri-la mais tarde, desmarque **Hide Onboarding** nas configurações do VS Code em **Extensions > Claude Code**.

78 </Step>86 </Step>

79 87 

80 <Step title="Envie um prompt">88 <Step title="Envie um prompt">

81 Peça a Claude para ajudar com seu código ou arquivos, seja explicando como algo funciona, depurando um problema ou fazendo alterações.89 Peça ao Claude ajuda com seu código ou arquivos, seja para explicar como algo funciona, fazer a depuração de um problema ou fazer alterações.

82 90 

83 <Tip>Claude vê automaticamente seu texto selecionado. Pressione `Option+K` (Mac) / `Alt+K` (Windows/Linux) para também inserir uma referência @-mention (como `@file.ts#5-10`) no seu prompt.</Tip>91 <Tip>O Claude vê automaticamente o texto selecionado. Pressione `Option+K` (Mac) / `Alt+K` (Windows/Linux) para também inserir uma referência de @-menção (como `@file.ts#5-10`) no seu prompt.</Tip>

84 92 

85 Aqui está um exemplo de pergunta sobre uma linha particular em um arquivo:93 Aqui está um exemplo de pergunta sobre uma linha específica de um arquivo:

86 94 

87 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="VS Code editor com as linhas 2-3 selecionadas em um arquivo Python, e o painel Claude Code mostrando uma pergunta sobre essas linhas com uma referência @-mention" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />95 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="Editor do VS Code com as linhas 2-3 selecionadas em um arquivo Python e o painel do Claude Code mostrando uma pergunta sobre essas linhas com uma referência de @-menção" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />

88 </Step>96 </Step>

89 97 

90 <Step title="Revise as alterações">98 <Step title="Revise as alterações">

91 O que você vê depende do [modo de permissão](/docs/pt/permission-modes#which-mode-a-session-starts-in) mostrado na parte inferior da caixa de prompt:99 <span id="security-considerations" />

100 

101 <span id="security-and-privacy" />

102 

103 Verifique o [modo de permissão](/docs/pt/permission-modes#which-mode-a-session-starts-in) exibido na parte inferior da caixa de prompt:

92 104 

93 * No modo Auto ou Edit automatically, Claude edita a maioria dos arquivos no seu workspace sem perguntar.105 * No modo Auto ou Edit automatically, o Claude edita [a maioria dos arquivos](/docs/pt/permission-modes#protected-paths) no seu workspace sem perguntar.

94 * No modo Manual, quando Claude quer editar um arquivo, ele mostra uma comparação lado a lado do original e das alterações propostas, depois pede permissão. Você pode aceitar, rejeitar ou dizer a Claude o que fazer em vez disso. Se você editar o conteúdo proposto diretamente na visualização de diff antes de aceitar, Claude é informado de que você o modificou para que não assuma que o arquivo corresponde à sua proposta original.106 * No modo Manual, quando o Claude quer editar um arquivo, ele mostra uma comparação lado a lado do original e das alterações propostas e, em seguida, pede permissão. Você pode aceitar, rejeitar ou dizer ao Claude o que fazer em vez disso. Se você editar o conteúdo proposto diretamente na visualização do diff antes de aceitar, o Claude é informado de que você o modificou, para que não presuma que o arquivo corresponde à proposta original.

95 107 

96 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code mostrando um diff das alterações propostas por Claude com um prompt de permissão perguntando se deve fazer a edição" width="3292" height="1876" data-path="images/vs-code-edits.png" />108 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code mostrando um diff das alterações propostas pelo Claude com um prompt de permissão perguntando se a edição deve ser feita" width="3292" height="1876" data-path="images/vs-code-edits.png" />

97 109 

98 Para revisar uma edição proposta uma alteração por vez, use os botões **Accept this change** e **Reject this change** sob cada alteração no diff. Rejeitar uma alteração a reverte no conteúdo proposto; aceitar a marca como revisada. Aceitar ou rejeitar o arquivo inteiro ainda finaliza a revisão. Um diff com mais de 100 alterações abre sem os botões por alteração, então revise-o como um arquivo inteiro. A revisão por alteração requer Claude Code v2.1.275 ou posterior.110 Para revisar uma edição proposta uma alteração por vez, use os botões **Accept this change** e **Reject this change** abaixo de cada alteração no diff. Rejeitar uma alteração a reverte no conteúdo proposto; aceitar a marca como revisada. A revisão por alteração requer o Claude Code v2.1.275 ou posterior.

99 111 

100 As mesmas ações estão disponíveis no cursor a partir do menu de contexto do editor e da Command Palette como **Claude Code: Accept Change at Cursor** e **Claude Code: Reject Change at Cursor**.112 Aceitar ou rejeitar o arquivo inteiro ainda conclui a revisão. Um diff com mais de 100 alterações é aberto sem os botões por alteração, portanto revise-o como um arquivo inteiro.

113 

114 As mesmas ações estão disponíveis na posição do cursor pelo menu de contexto do editor e pela Command Palette como **Claude Code: Accept Change at Cursor** e **Claude Code: Reject Change at Cursor**.

101 </Step>115 </Step>

102</Steps>116</Steps>

103 117 

104Para mais ideias sobre o que você pode fazer com Claude Code, veja [Fluxos de trabalho comuns](/docs/pt/common-workflows).118Para mais ideias sobre o que você pode fazer com o Claude Code, consulte [Fluxos de trabalho comuns](/docs/pt/common-workflows).

105 119 

106<Tip>120<Tip>

107 Execute "Claude Code: Open Walkthrough" a partir da Command Palette para um tour guiado dos conceitos básicos.121 Execute "Claude Code: Open Walkthrough" na Command Palette para um tour guiado pelos conceitos básicos.

108</Tip>122</Tip>

109 123 

110<h2 id="use-the-prompt-box">124<h2 id="use-the-prompt-box">

111 Use the prompt box125 Usar a caixa de prompt

112</h2>126</h2>

113 127 

114The prompt box supports several features:128A caixa de prompt oferece vários recursos:

115 129 

116* **Permission modes**: click the mode indicator at the bottom of the prompt box to switch permission modes. With Claude Code v2.1.283 or later, Auto is the built-in starting permission mode, and on earlier versions only on Pro, Max, and Team plans. See [how the extension chooses the starting permission mode](/docs/pt/permission-modes#switch-permission-modes) for what changes that, and every permission mode the indicator offers.130* **Modos de permissão**: clique no indicador de modo na parte inferior da caixa de prompt para alternar entre modos de permissão. Com o Claude Code v2.1.283 ou posterior, Auto é o modo de permissão inicial padrão e, em versões anteriores, somente nos planos Pro, Max e Team. Consulte [como a extensão escolhe o modo de permissão inicial](/docs/pt/permission-modes#switch-permission-modes) para saber o que altera isso e todos os modos de permissão que o indicador oferece.

117 * **Auto**: a classifier reviews most actions instead of asking you. See [auto mode](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) for what it reviews and blocks.131 * **Auto**: um classificador analisa a maioria das ações em vez de perguntar a você. Consulte [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) para saber o que ele analisa e bloqueia.

118 * **Manual**: Claude asks permission before file edits and most shell commands.132 * **Manual**: o Claude pede permissão antes de edições de arquivos e da maioria dos comandos de shell.

119 * **Plan**: Claude describes what it will do and waits for approval before making changes. VS Code automatically opens the plan as a full Markdown document where you can add inline comments to give feedback before Claude begins.133 * **Plan**: o Claude descreve o que fará e aguarda aprovação antes de fazer alterações. O VS Code abre automaticamente o plano como um documento Markdown completo, no qual você pode adicionar comentários inline para dar feedback antes que o Claude comece.

120 134 

121 You can also type `/plan` in the prompt box. Requires Claude Code v2.1.280 or later.135 Você também pode digitar `/plan` na caixa de prompt. Requer o Claude Code v2.1.280 ou posterior.

122 136 

123 * `/plan`: switches to plan mode. If you're already in plan mode, shows the current plan instead.137 * `/plan`: alterna para o modo de planejamento. Se você já estiver no modo de planejamento, mostra o plano atual.

124 * `/plan` with a task, such as `/plan fix the auth bug`: switches to plan mode and starts planning that task.138 * `/plan` com uma tarefa, como `/plan fix the auth bug`: alterna para o modo de planejamento e começa a planejar essa tarefa.

125 * `/plan open`: when you're already in plan mode, opens the plan file in the editor.139 * `/plan open`: quando você já está no modo de planejamento, abre o arquivo do plano no editor.

126 * **Edit automatically**: Claude makes edits without asking.140 * **Edit automatically**: o Claude faz edições sem perguntar.

127* **Modelo**: selecione **Switch model…** no menu de comandos para trocar o modelo no meio da sessão. Você também pode clicar no nome do modelo na parte inferior da caixa de prompt para abrir o mesmo seletor. Com o Claude Code v2.1.284 ou posterior, digitar `/model` sozinho na caixa de prompt também abre o seletor.141* **Modelo**: selecione **Switch model…** no menu de comandos para trocar o modelo no meio da sessão. Você também pode clicar no nome do modelo na parte inferior da caixa de prompt para abrir o mesmo seletor. Com o Claude Code v2.1.284 ou posterior, digitar `/model` sozinho na caixa de prompt também abre o seletor.

128 142 

129 When the current model supports [effort levels](/docs/pt/model-config#adjust-effort-level), the picker also shows an **Effort** row and the model name button shows the selected level. When you pick a level other than `max`, Claude Code saves it for the current model as your default, under [`modelSettings`](/docs/pt/settings-reference#modelsettings) in your user settings; `max` applies to the current session only. The model name button and the **Effort** row require Claude Code v2.1.257 or later.143 Quando o modelo atual oferece suporte a [níveis de esforço](/docs/pt/model-config#adjust-effort-level), o seletor também mostra uma linha **Effort** e o botão do nome do modelo mostra o nível selecionado. Quando você escolhe um nível diferente de `max`, o Claude Code o salva para o modelo atual como seu padrão, em [`modelSettings`](/docs/pt/settings-reference#modelsettings) nas suas configurações de usuário; `max` se aplica somente à sessão atual. O botão do nome do modelo e a linha **Effort** requerem o Claude Code v2.1.257 ou posterior.

144 

145 Quando os [fluxos de trabalho dinâmicos](/docs/pt/workflows) estão ativados e o modelo atual oferece suporte a eles, um botão **Ultracode** aparece abaixo da linha **Effort**. Ative-o para que o Claude planeje um [fluxo de trabalho](/docs/pt/workflows#let-claude-decide-with-ultracode) para cada tarefa substancial nesta sessão, no nível de esforço selecionado. Enquanto ele estiver ativado, o botão do nome do modelo mostra `· Ultracode` após o nível. O botão requer o Claude Code v2.1.284 ou posterior.

146* **Menu de comandos**: clique em `/` ou digite `/` para abrir o menu de comandos. As opções incluem anexar arquivos, trocar de modelo e ativar ou desativar o pensamento estendido.

130 147 

131 When [dynamic workflows](/docs/pt/workflows) are enabled and the current model supports it, an **Ultracode** switch appears under the **Effort** row. Turn it on to have Claude plan a [workflow](/docs/pt/workflows#let-claude-decide-with-ultracode) for each substantive task in this session, at the selected effort level. While it's on, the model name button shows `· Ultracode` after the level. The switch requires Claude Code v2.1.284 or later.148 A seção Customize inclui entradas como servidores MCP, comandos, estilos de saída, hooks, memória, instruções, permissões e plugins. Itens com um ícone de terminal abrem no terminal integrado.

132* **Command menu**: click `/` or type `/` to open the command menu. Options include attaching files, switching models, and toggling extended thinking.

133 149 

134 The Customize section includes entries such as MCP servers, commands, output styles, hooks, memory, instructions, permissions, and plugins. Items with a terminal icon open in the integrated terminal.150 * Para navegar por comandos como `/usage` ou [`/remote-control`](/docs/pt/remote-control), selecione **Slash commands** na seção Customize. Uma caixa de diálogo os lista com uma caixa de filtro. Escolha um para executá-lo. Digitar `/` na caixa de prompt continua sugerindo comandos inline. Requer o Claude Code v2.1.257 ou posterior.

135 151 

136 * To browse commands such as `/usage` or [`/remote-control`](/docs/pt/remote-control), select **Slash commands** in the Customize section. A dialog lists them with a filter box. Pick one to run it. Typing `/` in the prompt box still suggests commands inline. Requires Claude Code v2.1.257 or later.152 Digitar `/skills` também abre essa caixa de diálogo. Cada linha de [skill](/docs/pt/skills) mostra sua [visibilidade](/docs/pt/skills#override-skill-visibility-from-settings), como **On** ou **Name only**. Clique na visibilidade para alterá-la, exceto em linhas marcadas como **locked**, como skills de plugins. O atalho `/skills` e os controles de visibilidade requerem o Claude Code v2.1.280 ou posterior.

153 * Selecione **Output styles** na seção Customize para escolher um [estilo de saída](/docs/pt/output-styles), incluindo seus estilos personalizados. Requer o Claude Code v2.1.257 ou posterior.

137 154 

138 Typing `/skills` also opens this dialog. Each [skill](/docs/pt/skills) row shows its [visibility](/docs/pt/skills#override-skill-visibility-from-settings), such as **On** or **Name only**. Click the visibility to change it, except on rows marked **locked**, such as plugin skills. The `/skills` shortcut and the visibility controls require Claude Code v2.1.280 or later.155 Para criar um estilo personalizado, selecione **Build a custom style** no menu **Output styles**. O Claude Code escreve o [arquivo de estilo](/docs/pt/output-styles#create-a-custom-output-style) para você no nível do projeto ou do usuário. Requer o Claude Code v2.1.261 ou posterior.

139 * Select **Output styles** in the Customize section to pick an [output style](/docs/pt/output-styles), including your custom styles. Requires Claude Code v2.1.257 or later.156 * Selecione **Hooks** na seção Customize para ver os [hooks](/docs/pt/hooks) carregados na sessão, agrupados por evento. Você pode adicionar, editar ou remover hooks salvos nos seus arquivos de configurações de usuário, de projeto e locais. Hooks de outras fontes, como configurações gerenciadas ou plugins, são somente leitura. Requer o Claude Code v2.1.269 ou posterior.

157 * Selecione **Permissions** na seção Customize para ver as [regras de permissão](/docs/pt/permissions) da sessão, agrupadas em Allow, Ask e Deny. Você pode adicionar regras às suas configurações de usuário, de projeto ou locais e remover regras salvas nelas. Regras de outras fontes, como configurações gerenciadas ou aprovações feitas somente para esta sessão, são somente leitura. Requer o Claude Code v2.1.269 ou posterior.

158 * Selecione **Memory** na seção Customize para ativar ou desativar a [memória automática](/docs/pt/memory#auto-memory). Enquanto ela estiver ativada, você também pode navegar pelas memórias que o Claude salvou e mostrar no seu gerenciador de arquivos as pastas que as armazenam. Requer o Claude Code v2.1.274 ou posterior.

140 159 

141 To create a custom style instead, select **Build a custom style** from the **Output styles** menu. Claude Code writes the [style file](/docs/pt/output-styles#create-a-custom-output-style) for you at the project or user level. Requires Claude Code v2.1.261 or later.160 Clique em uma memória salva para lê-la na caixa de diálogo, onde você pode editar o texto, excluir a memória ou abrir o arquivo dela no editor. Visualizar, editar e excluir uma memória na caixa de diálogo requer o Claude Code v2.1.275 ou posterior.

142 * Select **Hooks** in the Customize section to view the [hooks](/docs/pt/hooks) loaded in the session, grouped by event. You can add, edit, or remove hooks saved in your user, project, and local settings files. Hooks from other sources, such as managed settings or plugins, are read-only. Requires Claude Code v2.1.269 or later.161 * Selecione **Instructions** na seção Customize para editar os [arquivos CLAUDE.md](/docs/pt/memory#claude-md-files) que o Claude lê. Escolha um arquivo para abri-lo no editor. Se o arquivo ainda não existir, o Claude Code o cria primeiro. Requer o Claude Code v2.1.274 ou posterior.

143 * Select **Permissions** in the Customize section to view the session's [permission rules](/docs/pt/permissions), grouped into Allow, Ask, and Deny. You can add rules to your user, project, or local settings and remove rules saved there. Rules from other sources, such as managed settings or approvals made for this session only, are read-only. Requires Claude Code v2.1.269 or later.162 * Selecione **Status** na seção Customize, ou digite `/status`, para verificar a versão do Claude Code, a conta, o modelo e os detalhes dos servidores MCP da sessão. Requer o Claude Code v2.1.280 ou posterior.

144 * Select **Memory** in the Customize section to turn [auto memory](/docs/pt/memory#auto-memory) on or off. While it's on, you can also browse the memories Claude has saved and reveal the folders that store them in your file manager. Requires Claude Code v2.1.274 or later.163 * Selecione **Sandbox** na seção Customize, ou digite `/sandbox`, para ver se os comandos Bash do Claude são executados [em sandbox](/docs/pt/sandboxing). Você pode alternar o modo do sandbox e adicionar [comandos excluídos](/docs/pt/settings-reference#sandbox-excludedcommands) ali. Requer o Claude Code v2.1.280 ou posterior.

164 * Selecione **Claude in Chrome** na seção Customize, ou digite `/chrome`, para verificar e gerenciar a conexão do [Claude in Chrome](/docs/pt/chrome). Ambos requerem login com uma conta claude.ai. Requer o Claude Code v2.1.280 ou posterior.

165 * Selecione **Export conversation** na seção Context, ou digite `/export`, para copiar a conversa como texto simples ou salvá-la em um arquivo. Adicione um nome de arquivo, como `/export notes.txt`, para pular a caixa de diálogo e escolher onde salvar o arquivo. Requer o Claude Code v2.1.280 ou posterior.

166 * A seção Settings inclui **Enable Remote Control for all sessions**, que define [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) para controlar se [novas sessões interativas se conectam automaticamente ao Remote Control](/docs/pt/remote-control#enable-remote-control-for-all-sessions). Requer o Claude Code v2.1.203 ou posterior.

145 167 

146 Click a saved memory to read it in the dialog, where you can edit the text, delete the memory, or open its file in the editor. Viewing, editing, and deleting a memory in the dialog require Claude Code v2.1.275 or later.168 Quando você ativa ou desativa essa opção em uma janela do VS Code, a alteração não se limita às sessões que você iniciar depois. Ela também se aplica às sessões já abertas nessa janela do VS Code. Se você a desativar, as sessões abertas se desconectam. Com o Claude Code v2.1.261 ou posterior, a alteração também alcança as sessões abertas nas suas outras janelas do VS Code.

147 * Select **Instructions** in the Customize section to edit the [CLAUDE.md files](/docs/pt/memory#claude-md-files) Claude reads. Pick a file to open it in the editor. If the file doesn't exist yet, Claude Code creates it first. Requires Claude Code v2.1.274 or later.169 * A seção Settings também inclui **Focus view**, que oculta chamadas de ferramenta, resultados de ferramentas e pensamento atrás de linhas expansíveis, deixando seus prompts e as respostas do Claude. Ative ou desative ali, com `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), ou pela Command Palette com **Claude Code: Toggle Focus view**. A alteração se aplica a todas as sessões abertas e persiste entre sessões. Requer o Claude Code v2.1.221 ou posterior.

148 * Select **Status** in the Customize section, or type `/status`, to check the session's Claude Code version, account, model, and MCP server details. Requires Claude Code v2.1.280 or later.

149 * Select **Sandbox** in the Customize section, or type `/sandbox`, to see whether Claude's Bash commands run [sandboxed](/docs/pt/sandboxing). You can switch the sandbox mode and add [excluded commands](/docs/pt/settings-reference#sandbox-excludedcommands) there. Requires Claude Code v2.1.280 or later.

150 * Select **Claude in Chrome** in the Customize section, or type `/chrome`, to check and manage the [Claude in Chrome](/docs/pt/chrome) connection. Both require signing in with a claude.ai account. Requires Claude Code v2.1.280 or later.

151 * Select **Export conversation** in the Context section, or type `/export`, to copy the conversation as plain text or save it to a file. Add a file name, such as `/export notes.txt`, to skip the dialog and choose where to save the file. Requires Claude Code v2.1.280 or later.

152 * The Settings section includes **Enable Remote Control for all sessions**, which sets [`remoteControlAtStartup`](/docs/pt/settings-reference#remotecontrolatstartup) to control whether [new interactive sessions connect to Remote Control automatically](/docs/pt/remote-control#enable-remote-control-for-all-sessions). Requires Claude Code v2.1.203 or later.

153 170 

154 When you turn the toggle on or off in a VS Code window, the change applies to the sessions already open in that VS Code window, not only to sessions you start afterwards. If you turn it off, the open sessions disconnect. With Claude Code v2.1.261 or later, the change also reaches sessions open in your other VS Code windows.171 A lista de tarefas mais recente do Claude permanece visível, assim como o texto ao qual se refere uma pergunta pendente do Claude; isso requer o Claude Code v2.1.225 ou posterior. Enquanto o Claude executa [subagentes](/docs/pt/sub-agents), linhas de progresso em tempo real com a atividade mais recente deles aparecem abaixo do grupo de chamadas de ferramenta que os iniciou. Isso requer o Claude Code v2.1.269 ou posterior.

155 * The Settings section also includes **Focus view**, which hides tool calls, tool results, and thinking behind expandable rows, leaving your prompts and Claude's responses. Toggle it there, with `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), or from the Command Palette with **Claude Code: Toggle Focus view**. The change applies to every open session and persists across sessions. Requires Claude Code v2.1.221 or later.172 * Para sair da sua conta Anthropic, selecione **Sign out** na seção Settings ou digite `/logout`. Em um [provedor terceirizado](#use-third-party-providers), o menu não oferece nenhum dos dois. Requer o Claude Code v2.1.277 ou posterior.

173 * Para relatar um bug, clique em **Report a problem** na parte inferior do menu, ou digite `/bug` ou `/feedback` com uma descrição opcional que preenche previamente o relatório. Quando você envia o relatório e está conectado à Anthropic em uma conexão first-party, o Claude Code o envia à Anthropic. Requer o Claude Code v2.1.229 ou posterior.

156 174 

157 Claude's latest to-do list stays visible, and so does the text a pending question from Claude is asking about; this requires Claude Code v2.1.225 or later. While Claude runs [subagents](/docs/pt/sub-agents), live progress rows with their latest activity appear under the tool-call group that started them. This requires Claude Code v2.1.269 or later.175 Em um provedor terceirizado, ou sem credenciais da Anthropic, nada é enviado. A caixa de diálogo informa isso antes de você escrever. Enviar salva o relatório como um [arquivo local em `~/.claude/feedback-bundles/`](/docs/pt/data-usage#telemetry-services), com padrões conhecidos de chaves de API e tokens ocultados. Salvar o relatório no seu computador requer o Claude Code v2.1.284 ou posterior.

158 * To sign out of your Anthropic account, select **Sign out** in the Settings section, or type `/logout`. On a [third-party provider](#use-third-party-providers), the menu doesn't offer either. Requires Claude Code v2.1.277 or later.

159 * To report a bug, click **Report a problem** at the bottom of the menu, or type `/bug` or `/feedback` with an optional description that prefills the report. When you submit the report and you're signed in to Anthropic on a first-party connection, Claude Code sends it to Anthropic. Requires Claude Code v2.1.229 or later.

160 176 

161 On a third-party provider, or without Anthropic credentials, nothing is sent. The dialog says so before you write. Submitting saves the report as a [local archive under `~/.claude/feedback-bundles/`](/docs/pt/data-usage#telemetry-services) with known API key and token patterns redacted. Send that file to your Anthropic account representative or attach it to a support request. The confirmation names the file and includes a **Show folder** button. Saving the report on your computer requires Claude Code v2.1.284 or later.177 Depois que o relatório é salvo, a confirmação informa o nome do arquivo e inclui um botão **Show folder**. Envie esse arquivo ao representante da sua conta Anthropic ou anexe-o a uma solicitação de suporte.

162 178 

163 If your organization's policy turns product feedback off, **Report a problem** doesn't appear in the menu, and `/bug` and `/feedback` show a `Feedback is turned off by your organization's policy or this environment's settings.` notice instead of opening the report. With Claude Code v2.1.284 or later, if you set the `DISABLE_FEEDBACK_COMMAND` or `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` environment variable, feedback is also turned off and opening the report shows that notice instead.179 Se a política da sua organização desativar o feedback sobre o produto, **Report a problem** não aparece no menu, e `/bug` e `/feedback` mostram o aviso `Feedback is turned off by your organization's policy or this environment's settings.` em vez de abrir o relatório. Com o Claude Code v2.1.284 ou posterior, se você definir a variável de ambiente `DISABLE_FEEDBACK_COMMAND` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, o feedback também é desativado e abrir o relatório mostra esse aviso.

164* **Side questions**: type `/btw` followed by a question to ask about your session [without adding to the conversation](/docs/pt/interactive-mode#side-questions-with-%2Fbtw). The answer opens in a panel beside the chat, where you can ask follow-up questions. The thread survives window reloads. Claude Code keeps the newest 20 exchanges and expires stored threads on the [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) schedule, as long as Claude Code can [safely determine the retention period](/docs/pt/claude-directory#cleaned-up-automatically). To clear a thread, click the trash icon in the panel. Requires Claude Code v2.1.227 or later.180* **Perguntas paralelas**: digite `/btw` seguido de uma pergunta para perguntar sobre sua sessão [sem adicioná-la à conversa](/docs/pt/interactive-mode#side-questions-with-%2Fbtw). A resposta abre em um painel ao lado do chat, onde você pode fazer perguntas de acompanhamento. Requer o Claude Code v2.1.227 ou posterior.

165* **Copy a response**: hover over a response and click **Copy response** to copy it to your clipboard, or type `/copy` to copy the latest response. `/copy 2` copies the second-to-last. Requires Claude Code v2.1.277 or later.

166* **Favoritos**: passe o mouse sobre uma resposta e clique em **Bookmark response** para salvá-la, ou clique em **Remove bookmark** em uma resposta salva para removê-la.

167 181 

168 Para revisar as respostas salvas, abra o painel Bookmarks: clique no ícone de favorito na parte superior do painel do Claude Code, selecione **Bookmarks** na seção Context do menu de comandos ou digite `/bookmarks`. Requer Claude Code v2.1.286 ou posterior.182 A conversa paralela sobrevive a recarregamentos da janela. O Claude Code mantém as 20 trocas mais recentes e expira as conversas armazenadas conforme o cronograma de [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays), desde que o Claude Code consiga [determinar com segurança o período de retenção](/docs/pt/claude-directory#cleaned-up-automatically). Para limpar uma conversa paralela, clique no ícone de lixeira no painel.

183* **Copiar uma resposta**: passe o cursor sobre uma resposta e clique em **Copy response** para copiá-la para a área de transferência, ou digite `/copy` para copiar a resposta mais recente. `/copy 2` copia a penúltima. Requer o Claude Code v2.1.277 ou posterior.

184* **Favoritos**: passe o cursor sobre uma resposta e clique em **Bookmark response** para salvá-la, ou clique em **Remove bookmark** em uma resposta salva para removê-la.

185 

186 Para revisar as respostas salvas, abra o painel Bookmarks. Você pode clicar no ícone de favorito na parte superior do painel do Claude Code, selecionar **Bookmarks** na seção Context do menu de comandos ou digitar `/bookmarks`. Requer o Claude Code v2.1.286 ou posterior.

169* **Arquivos que o Claude envia para você**: quando a sessão está conectada ao [Remote Control](/docs/pt/remote-control#start-a-remote-control-session) e o Claude envia arquivos para você com a [ferramenta `SendUserFile`](/docs/pt/tools-reference), a conversa mostra uma linha como **Sent report.md, chart.png**. Clique no nome de um arquivo para abri-lo no editor.187* **Arquivos que o Claude envia para você**: quando a sessão está conectada ao [Remote Control](/docs/pt/remote-control#start-a-remote-control-session) e o Claude envia arquivos para você com a [ferramenta `SendUserFile`](/docs/pt/tools-reference), a conversa mostra uma linha como **Sent report.md, chart.png**. Clique no nome de um arquivo para abri-lo no editor.

170* **Context indicator**: the prompt box shows how much of Claude's context window you're using. Claude automatically compacts when needed, or you can run `/compact` manually.188* **Indicador de contexto**: a caixa de prompt mostra quanto da janela de contexto do Claude você está usando. O Claude compacta automaticamente quando necessário, ou você pode executar `/compact` manualmente.

171* **Prompt cache clock**: a clock icon next to the context indicator estimates how much time the conversation's [prompt cache](/docs/pt/prompt-caching) has left before it expires. It counts down from the cache's five-minute or one-hour [lifetime](/docs/pt/prompt-caching#cache-lifetime), and each response that uses the cache restarts the countdown. Apart from compaction, the [actions that invalidate the cache](/docs/pt/prompt-caching#actions-that-invalidate-the-cache) don't reset the clock, so it can still show minutes left after you switch models.189* **Relógio do cache de prompt**: um ícone de relógio ao lado do indicador de contexto estima quanto tempo resta antes que o [cache de prompt](/docs/pt/prompt-caching) da conversa expire. Ele faz uma contagem regressiva a partir do [tempo de vida](/docs/pt/prompt-caching#cache-lifetime) de cinco minutos ou de uma hora do cache, e cada resposta que usa o cache reinicia a contagem. Exceto pela compactação, as [ações que invalidam o cache](/docs/pt/prompt-caching#actions-that-invalidate-the-cache) não reiniciam o relógio, então ele ainda pode mostrar minutos restantes depois que você troca de modelo.

172 * Until the countdown runs out, the icon shows the minutes left, such as **12m**.190 * Até que a contagem termine, o ícone mostra os minutos restantes, como **12m**.

173 * When the countdown runs out, the minutes disappear and the icon turns red, or your theme's error color, until the next response. The cache has likely expired, so expect a slower, more expensive response to your next message while the cache rebuilds. If the five-minute lifetime keeps running out between your messages, see [Choose the TTL yourself](/docs/pt/prompt-caching#choose-the-ttl-yourself).191 * Quando a contagem termina, os minutos desaparecem e o ícone fica vermelho, ou na cor de erro do seu tema, até a próxima resposta. O cache provavelmente expirou, então espere uma resposta mais lenta e mais cara à sua próxima mensagem enquanto o cache é reconstruído. Se o tempo de vida de cinco minutos continuar se esgotando entre suas mensagens, consulte [Escolher o TTL você mesmo](/docs/pt/prompt-caching#choose-the-ttl-yourself).

174 * Right after the conversation is [compacted](/docs/pt/prompt-caching#compacting-the-conversation), the icon also turns red without minutes until the next response, because the cache doesn't cover the compacted conversation yet.192 * Logo após a conversa ser [compactada](/docs/pt/prompt-caching#compacting-the-conversation), o ícone também fica vermelho sem minutos até a próxima resposta, porque o cache ainda não cobre a conversa compactada.

175* **Agent map**: when the conversation includes [subagents](/docs/pt/sub-agents), an agent count such as **2 agents** appears at the bottom of the prompt box. Its dot shows whether any subagent is working or waiting for your permission.193* **Mapa de agentes**: quando a conversa inclui [subagentes](/docs/pt/sub-agents), uma contagem de agentes como **2 agents** aparece na parte inferior da caixa de prompt. O ponto dela mostra se algum subagente está trabalhando ou aguardando sua permissão.