Documentation 2026-09-30 23:00 UTC to 2026-10-01 04:01 UTC

2885 2885 

2886**Nome da ferramenta:** `Bash`2886**Nome da ferramenta:** `Bash`

2887 2887 

2888Para o que define o limite do primeiro plano, veja [Limites de tempo limite e saída](/docs/pt/tools-reference#timeout-and-output-limits). Para o limite de tempo em segundo plano, veja [Comandos em segundo plano](/docs/pt/tools-reference#background-commands).2888Para o que define o limite do primeiro plano, veja [Limites de tempo limite e saída](/docs/pt/tools-reference#timeout-and-output-limits). Para o limite de tempo em segundo plano, veja [Limite de tempo para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands).

2889 2889 

2890**Entrada:**2890**Entrada:**

2891 2891 

3185};3185};

3186```3186```

3187 3187 

3188Executa comandos Bash com timeout opcional e execução em background. O diretório de trabalho persiste entre comandos, incluindo comandos executados em turnos posteriores de uma sessão multi-turno; o estado do shell, como variáveis de ambiente exportadas, não persiste. Para os limites sobre quais mudanças de diretório são mantidas, veja [O que persiste entre comandos](/docs/pt/tools-reference#what-persists-between-commands). Para o que define o limite de foreground, veja [Timeout e limites de saída](/docs/pt/tools-reference#timeout-and-output-limits). Para o limite de tempo em background, veja [Comandos em background](/docs/pt/tools-reference#background-commands).3188Executa comandos Bash com timeout opcional e execução em background. O diretório de trabalho persiste entre comandos, incluindo comandos executados em turnos posteriores de uma sessão multi-turno; o estado do shell, como variáveis de ambiente exportadas, não persiste. Para os limites sobre quais mudanças de diretório são mantidas, veja [O que persiste entre comandos](/docs/pt/tools-reference#what-persists-between-commands). Para o que define o limite de foreground, veja [Timeout e limites de saída](/docs/pt/tools-reference#timeout-and-output-limits). Para o limite de tempo em background, veja [Limite de tempo para comandos em background](/docs/pt/tools-reference#time-limit-for-background-commands).

3189 3189 

3190<h3 id="monitor">3190<h3 id="monitor">

3191 Monitor3191 Monitor

4089 4089 

4090`timedOutAfterMs` é o tempo limite em milissegundos, definido quando o comando atingiu seu tempo limite e passou para o segundo plano em vez de começar lá explicitamente. `backgroundCwdHint` é definido quando o comando em segundo plano continha um builtin de mudança de diretório como `cd`, `pushd`, `popd` ou `chdir`, e observa que o diretório de trabalho da sessão não mudou. Ambos os campos requerem Claude Code v2.1.210 ou posterior.4090`timedOutAfterMs` é o tempo limite em milissegundos, definido quando o comando atingiu seu tempo limite e passou para o segundo plano em vez de começar lá explicitamente. `backgroundCwdHint` é definido quando o comando em segundo plano continha um builtin de mudança de diretório como `cd`, `pushd`, `popd` ou `chdir`, e observa que o diretório de trabalho da sessão não mudou. Ambos os campos requerem Claude Code v2.1.210 ou posterior.

4091 4091 

4092Quando um subagente em execução em primeiro plano possui um comando em segundo plano, o comando [termina quando a execução desse subagente termina](/docs/pt/tools-reference#background-commands). Claude Code define `backgroundEndsWithFinalResponse` como `true` em tais comandos e omite o campo quando o comando sobrevive ao turno, como comandos iniciados pela conversa principal ou por subagentes em segundo plano fazem. O campo requer Claude Code v2.1.227 ou posterior.4092Quando um subagente em execução em primeiro plano possui um comando em segundo plano, o comando [termina quando a execução desse subagente termina](/docs/pt/tools-reference#when-a-background-command-stops). Claude Code define `backgroundEndsWithFinalResponse` como `true` em tais comandos e omite o campo quando o comando sobrevive ao turno, como comandos iniciados pela conversa principal ou por subagentes em segundo plano fazem. O campo requer Claude Code v2.1.227 ou posterior.

4093 4093 

4094Claude Code define `gitOperation.commit.branch` para o branch nomeado na linha de resumo do commit do git e o omite para um commit feito em um HEAD desanexado. O campo requer Agent SDK v0.3.227 ou posterior. Claude Code relata um comando `gh pr reopen` como a ação PR `reopened`, que requer Agent SDK v0.3.234 ou posterior.4094Claude Code define `gitOperation.commit.branch` para o branch nomeado na linha de resumo do commit do git e o omite para um commit feito em um HEAD desanexado. O campo requer Agent SDK v0.3.227 ou posterior. Claude Code relata um comando `gh pr reopen` como a ação PR `reopened`, que requer Agent SDK v0.3.234 ou posterior.

4095 4095 

8 8 

9Agent view, aberto com `claude agents`, é uma tela para todas as suas sessões em background: o que está em execução, o que precisa de sua entrada e o que está concluído. Despache novas sessões, observe seu estado rapidamente em vez de rolar pelos transcritos e intervenha apenas quando uma precisar de você. Cada sessão em background é uma conversa completa do Claude Code que continua em execução sem um terminal anexado, então você pode abri-la, responder e sair sempre que quiser.9Agent view, aberto com `claude agents`, é uma tela para todas as suas sessões em background: o que está em execução, o que precisa de sua entrada e o que está concluído. Despache novas sessões, observe seu estado rapidamente em vez de rolar pelos transcritos e intervenha apenas quando uma precisar de você. Cada sessão em background é uma conversa completa do Claude Code que continua em execução sem um terminal anexado, então você pode abri-la, responder e sair sempre que quiser.

10 10 

11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="Agent view em um terminal: o cabeçalho mostra Claude Code v2.1.140, o modelo, o diretório de trabalho e uma contagem de resumo. As sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído, com uma entrada de despacho na parte inferior e um rodapé de dicas de atalhos de teclado." width="1772" height="780" data-path="images/agent-view-light.png" />11<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-light.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=d6905012bee31f3e6b3920b09c05dd02" className="dark:hidden" alt="Agent view em um terminal: o cabeçalho mostra Claude Code v2.1.140, o modelo, o diretório de trabalho e uma contagem de resumo. As sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído, com uma entrada de despacho na parte inferior e um rodapé de dicas de atalhos de teclado." width="1872" height="680" data-path="images/agent-view-light.png" />

12 12 

13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="Agent view em um terminal: o cabeçalho mostra Claude Code v2.1.140, o modelo, o diretório de trabalho e uma contagem de resumo. As sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído, com uma entrada de despacho na parte inferior e um rodapé de dicas de atalhos de teclado." width="1772" height="780" data-path="images/agent-view-dark.png" />13<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-dark.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=fc3c195bfc57e313ced1f1beb36cee93" className="hidden dark:block" alt="Agent view em um terminal: o cabeçalho mostra Claude Code v2.1.140, o modelo, o diretório de trabalho e uma contagem de resumo. As sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído, com uma entrada de despacho na parte inferior e um rodapé de dicas de atalhos de teclado." width="1872" height="680" data-path="images/agent-view-dark.png" />

14 14 

15Use agent view quando você tiver várias tarefas independentes que Claude pode trabalhar sem você observar cada passo. Despache uma correção de bug, uma revisão de pull request e uma investigação de teste instável como três linhas, continue trabalhando em outra janela e verifique quando uma linha mostrar que precisa de você ou tem um resultado.15Use agent view quando você tiver várias tarefas independentes que Claude pode trabalhar sem você observar cada passo. Despache uma correção de bug, uma revisão de pull request e uma investigação de teste instável como três linhas, continue trabalhando em outra janela e verifique quando uma linha mostrar que precisa de você ou tem um resultado.

16 16 

84| `--dangerously-skip-permissions` | Pular prompts de permissão. Equivalente a `--permission-mode bypassPermissions`. Veja [modos de permissão](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) para o que isso faz e não faz. Para sessões iniciadas com `--bg`, o modo [persiste quando o supervisor reinicia a sessão](/docs/pt/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | Pular prompts de permissão. Equivalente a `--permission-mode bypassPermissions`. Veja [modos de permissão](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) para o que isso faz e não faz. Para sessões iniciadas com `--bg`, o modo [persiste quando o supervisor reinicia a sessão](/docs/pt/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

85| `--debug` | Ativar modo de depuração com filtragem de categoria opcional, como `--debug='mcp,startup'` ou `--debug='!1p'`. O filtro se vincula apenas na forma `=`; um filtro separado por espaço ativa o modo de depuração sem filtragem | `claude --debug='mcp,startup'` |85| `--debug` | Ativar modo de depuração com filtragem de categoria opcional, como `--debug='mcp,startup'` ou `--debug='!1p'`. O filtro se vincula apenas na forma `=`; um filtro separado por espaço ativa o modo de depuração sem filtragem | `claude --debug='mcp,startup'` |

86| `--debug-file <path>` | Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração. Tem precedência sobre `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |86| `--debug-file <path>` | Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração. Tem precedência sobre `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

87| `--desktop` | Abrir o [aplicativo Claude Desktop](/docs/pt/desktop) no diretório atual e sair sem iniciar uma sessão no terminal. Adicione `--continue` ou `--resume` com um ID de sessão para [abrir essa sessão no Desktop](/docs/pt/desktop#coming-from-the-cli) em vez disso. `--resume` aqui leva apenas um ID de sessão, não um nome ou caminho de transcrição. Não leva prompt e nenhum outro sinalizador exceto `--verbose` e os sinalizadores `--debug`, já que o aplicativo inicia a sessão em si. Disponível em macOS e Windows x64 quando você está conectado com uma assinatura Claude. Requer Claude Code v2.1.285 ou posterior | `claude --desktop` |

87| `--disable-slash-commands` | Desativar todas as skills e comandos para esta sessão | `claude --disable-slash-commands` |88| `--disable-slash-commands` | Desativar todas as skills e comandos para esta sessão | `claude --disable-slash-commands` |

88| `--disallowedTools`, `--disallowed-tools` | Regras de negação. Um nome de ferramenta simples remove as ferramentas correspondentes do contexto do Claude: `"Edit"` remove Edit, `"*"` remove todas as ferramentas e `"mcp__*"` remove todas as ferramentas MCP. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e nega apenas chamadas correspondentes [conforme escrito](/docs/pt/permissions#bash-rule-limits). Uma regra nomeando [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) não pode removê-la enquanto qualquer outra ferramenta permanecer | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |89| `--disallowedTools`, `--disallowed-tools` | Regras de negação. Um nome de ferramenta simples remove as ferramentas correspondentes do contexto do Claude: `"Edit"` remove Edit, `"*"` remove todas as ferramentas e `"mcp__*"` remove todas as ferramentas MCP. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e nega apenas chamadas correspondentes [conforme escrito](/docs/pt/permissions#bash-rule-limits). Uma regra nomeando [`EndConversation`](/docs/pt/tools-reference#endconversation-tool-behavior) não pode removê-la enquanto qualquer outra ferramenta permanecer | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

89| `--effort` | Definir o [nível de esforço](/docs/pt/model-config#adjust-effort-level) para a sessão atual. Opções: `low`, `medium`, `high`, `xhigh`, `max` ou `ultracode`. Os níveis disponíveis dependem do modelo. `ultracode` inicia a sessão em esforço `xhigh` com [ultracode](/docs/pt/workflows#let-claude-decide-with-ultracode) ativado e requer Claude Code v2.1.203 ou posterior. Substitui as configurações [`modelSettings`](/docs/pt/settings-reference#modelsettings) e [`effortLevel`](/docs/pt/settings-reference#effortlevel) para esta sessão e não persiste | `claude --effort high` |90| `--effort` | Definir o [nível de esforço](/docs/pt/model-config#adjust-effort-level) para a sessão atual. Opções: `low`, `medium`, `high`, `xhigh`, `max` ou `ultracode`. Os níveis disponíveis dependem do modelo. `ultracode` inicia a sessão em esforço `xhigh` com [ultracode](/docs/pt/workflows#let-claude-decide-with-ultracode) ativado e requer Claude Code v2.1.203 ou posterior. Substitui as configurações [`modelSettings`](/docs/pt/settings-reference#modelsettings) e [`effortLevel`](/docs/pt/settings-reference#effortlevel) para esta sessão e não persiste | `claude --effort high` |

116| `--permission-prompts` | Definir quem responde prompts de permissão em modo print. Com o padrão `host`, Claude Code os envia para o host do Agent SDK ou a ferramenta `--permission-prompt-tool`. Passe `none` quando ninguém puder responder, e Claude Code os nega em vez disso. Veja [Desativar prompts de permissão em execuções sem supervisão](/docs/pt/headless#turn-off-permission-prompts-in-unattended-runs). Requer Claude Code v2.1.259 ou posterior | `claude -p --permission-prompts none "query"` |117| `--permission-prompts` | Definir quem responde prompts de permissão em modo print. Com o padrão `host`, Claude Code os envia para o host do Agent SDK ou a ferramenta `--permission-prompt-tool`. Passe `none` quando ninguém puder responder, e Claude Code os nega em vez disso. Veja [Desativar prompts de permissão em execuções sem supervisão](/docs/pt/headless#turn-off-permission-prompts-in-unattended-runs). Requer Claude Code v2.1.259 ou posterior | `claude -p --permission-prompts none "query"` |

117| `--plugin-dir` | Carregar um plugin de um diretório ou arquivo `.zip`, ou vários de uma [pasta de plugins](/docs/pt/plugins/create#load-a-directory-or-archive-for-one-session), apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para mais caminhos: `--plugin-dir A --plugin-dir B.zip`. Passar uma pasta de plugins requer Claude Code v2.1.265 ou posterior | `claude --plugin-dir ./my-plugin` |118| `--plugin-dir` | Carregar um plugin de um diretório ou arquivo `.zip`, ou vários de uma [pasta de plugins](/docs/pt/plugins/create#load-a-directory-or-archive-for-one-session), apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para mais caminhos: `--plugin-dir A --plugin-dir B.zip`. Passar uma pasta de plugins requer Claude Code v2.1.265 ou posterior | `claude --plugin-dir ./my-plugin` |

118| `--plugin-url` | Buscar um arquivo `.zip` de plugin de uma URL apenas para esta sessão. Repita o sinalizador para vários plugins, ou passe URLs separadas por espaço em um único valor entre aspas | `claude --plugin-url https://example.com/plugin.zip` |119| `--plugin-url` | Buscar um arquivo `.zip` de plugin de uma URL apenas para esta sessão. Repita o sinalizador para vários plugins, ou passe URLs separadas por espaço em um único valor entre aspas | `claude --plugin-url https://example.com/plugin.zip` |

119| `--print`, `-p` | Imprimir resposta sem modo interativo (veja [documentação do Agent SDK](/docs/pt/agent-sdk/overview) para detalhes de uso programático) | `claude -p "query"` |120| `--print`, `-p` | Imprimir resposta sem modo interativo (veja [documentação do Agent SDK](/docs/pt/agent-sdk/overview) para detalhes de uso programático). Para `--resume` em uma sessão de fundo que ainda está em execução, veja [Retomar uma sessão](/docs/pt/sessions#resume-a-running-background-session) | `claude -p "query"` |

120| `--prompt-suggestions` | Emitir uma mensagem `prompt_suggestion` com um prompt de usuário previsto após cada turno que gera um; conversas muito curtas podem não produzir nenhum. Requer `--print`, `--output-format stream-json` e `--verbose`. Veja [Sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |121| `--prompt-suggestions` | Emitir uma mensagem `prompt_suggestion` com um prompt de usuário previsto após cada turno que gera um; conversas muito curtas podem não produzir nenhum. Requer `--print`, `--output-format stream-json` e `--verbose`. Veja [Sugestões de prompt](/docs/pt/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

121| `--ref <branch>` | Com `--environment`, basear o checkout da nova sessão em uma ref nomeada em vez de `HEAD` local | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |122| `--ref <branch>` | Com `--environment`, basear o checkout da nova sessão em uma ref nomeada em vez de `HEAD` local | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |

122| `--remote` | Alias descontinuado para `--cloud`, incluindo o formulário de sessão existente | `claude --remote "Fix the login bug"` |123| `--remote` | Alias descontinuado para `--cloud`, incluindo o formulário de sessão existente | `claude --remote "Fix the login bug"` |

124| `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão [Remote Control](/docs/pt/remote-control) gerados automaticamente quando nenhum nome explícito está definido. Padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito | `claude remote-control --remote-control-session-name-prefix dev-box` |125| `--remote-control-session-name-prefix <prefix>` | Prefixo para nomes de sessão [Remote Control](/docs/pt/remote-control) gerados automaticamente quando nenhum nome explícito está definido. Padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito | `claude remote-control --remote-control-session-name-prefix dev-box` |

125| `--replay-user-messages` | Re-emitir mensagens do usuário de stdin de volta em stdout para confirmação. Requer `--input-format stream-json` e `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |126| `--replay-user-messages` | Re-emitir mensagens do usuário de stdin de volta em stdout para confirmação. Requer `--input-format stream-json` e `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

126| `--restricted` | Iniciar em modo restrito. Use-o quando um harness de avaliação dirige `claude` em uma máquina compartilhada e Claude Code não deve executar comandos ou ler configurações de usuário e projeto dessa máquina. Claude Code remove as ferramentas integradas que executam comandos ou código, e WebFetch, a menos que você as nomeie individualmente em `--tools`, não através do preset `default`. Também confina as ferramentas de arquivo integradas aos [diretórios de trabalho](/docs/pt/permissions#working-directories), carrega apenas [configurações gerenciadas](/docs/pt/managed-settings) e `--settings`, recusa [`bypassPermissions`](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) e [recusa criar sessões em nuvem](/docs/pt/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Requer Claude Code v2.1.248 ou posterior | `claude --restricted -p "query"` |127| `--restricted` | Iniciar em modo restrito. Use-o quando um harness de avaliação dirige `claude` em uma máquina compartilhada e Claude Code não deve executar comandos ou ler configurações de usuário e projeto dessa máquina. Claude Code remove as ferramentas integradas que executam comandos ou código, e WebFetch, a menos que você as nomeie individualmente em `--tools`, não através do preset `default`. Também confina as ferramentas de arquivo integradas aos [diretórios de trabalho](/docs/pt/permissions#working-directories), carrega apenas [configurações gerenciadas](/docs/pt/managed-settings) e `--settings`, recusa [`bypassPermissions`](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) e [recusa criar sessões em nuvem](/docs/pt/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Requer Claude Code v2.1.248 ou posterior | `claude --restricted -p "query"` |

127| `--resume`, `-r` | Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão. No lugar de um ID, você pode passar o caminho absoluto para o arquivo de [transcrição](/docs/pt/sessions#where-transcripts-are-stored) `.jsonl` de uma sessão. O seletor e a busca por nome incluem sessões que adicionaram este diretório com `/add-dir`. Quando você passa um ID de sessão, Claude Code pesquisa o diretório do projeto atual e seus git worktrees, depois todos os outros projetos nesta máquina. Antes de v2.1.223, a busca de ID cobria apenas o diretório do projeto atual e seus git worktrees. [Sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg` | `claude --resume auth-refactor` |128| `--resume`, `-r` | Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão. No lugar de um ID, você pode passar o caminho absoluto para o arquivo de [transcrição](/docs/pt/sessions#where-transcripts-are-stored) `.jsonl` de uma sessão. O seletor e a busca por nome incluem sessões que adicionaram este diretório com `/add-dir`. Quando você passa um ID de sessão, Claude Code pesquisa o diretório do projeto atual e seus git worktrees, depois todos os outros projetos nesta máquina. Antes de v2.1.223, a busca de ID cobria apenas o diretório do projeto atual e seus git worktrees. [Sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg`. Retomar uma que ainda está em execução [abre essa sessão](/docs/pt/sessions#resume-a-running-background-session) neste terminal através de `claude attach`, e um prompt que você passa na linha de comando vai para ela como seu próximo turno. Antes de v2.1.285, Claude Code recusava e imprimia o comando `claude attach` para executar em vez disso | `claude --resume auth-refactor` |

128| `--safe-mode` | Iniciar com todas as personalizações desativadas para solucionar problemas de uma configuração quebrada: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente, o que difere de [`--bare`](/docs/pt/headless#start-faster-with-bare-mode). A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, linha de status e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Útil para verificar se uma personalização é o que dispara [fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback). Define [`CLAUDE_CODE_SAFE_MODE`](/docs/pt/env-vars) | `claude --safe-mode` |129| `--safe-mode` | Iniciar com todas as personalizações desativadas para solucionar problemas de uma configuração quebrada: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente, o que difere de [`--bare`](/docs/pt/headless#start-faster-with-bare-mode). A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, linha de status e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Útil para verificar se uma personalização é o que dispara [fallback automático de modelo](/docs/pt/model-config#automatic-model-fallback). Define [`CLAUDE_CODE_SAFE_MODE`](/docs/pt/env-vars) | `claude --safe-mode` |

129| `--session-id` | Usar um ID de sessão específico para a conversa (deve ser um UUID válido) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |130| `--session-id` | Usar um ID de sessão específico para a conversa (deve ser um UUID válido) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

130| `--setting-sources` | Lista separada por vírgula de fontes de configuração a carregar (`user`, `project`, `local`). Veja [agent view](/docs/pt/agent-view#what-carries-over-when-you-background) e [agent teams](/docs/pt/agent-teams#context-and-communication) para as sessões que você inicia a partir desta que herdam a lista | `claude --setting-sources user,project` |131| `--setting-sources` | Lista separada por vírgula de fontes de configuração a carregar (`user`, `project`, `local`). Veja [agent view](/docs/pt/agent-view#what-carries-over-when-you-background) e [agent teams](/docs/pt/agent-teams#context-and-communication) para as sessões que você inicia a partir desta que herdam a lista | `claude --setting-sources user,project` |

439 439 

440* **Comandos que Claude executa**: um ambiente na nuvem não define seu próprio timeout de comando, portanto os padrões da ferramenta Bash se aplicam. Claude aguarda 2 minutos por um comando por padrão e pode pedir até 10 minutos.440* **Comandos que Claude executa**: um ambiente na nuvem não define seu próprio timeout de comando, portanto os padrões da ferramenta Bash se aplicam. Claude aguarda 2 minutos por um comando por padrão e pode pedir até 10 minutos.

441 441 

442 Quando um comando atinge seu [timeout](/docs/pt/tools-reference#timeout-and-output-limits), Claude Code [o move para o background](/docs/pt/tools-reference#background-commands) em vez de pará-lo, a menos que o comando comece com `sleep`. Um comando movido dessa forma pode continuar executando por até 30 minutos a mais antes de Claude Code pará-lo em seu [limite de tempo de background](/docs/pt/tools-reference#background-commands). Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `1800000` milissegundos alonga esse limite bem como o padrão de foreground.442 Quando um comando atinge seu [timeout](/docs/pt/tools-reference#timeout-and-output-limits), Claude Code [o move para o background](/docs/pt/tools-reference#foreground-commands-that-move-to-the-background) em vez de pará-lo, a menos que o comando comece com `sleep`. Um comando movido dessa forma pode continuar executando por até 30 minutos a mais antes de Claude Code pará-lo em seu [limite de tempo de background](/docs/pt/tools-reference#time-limit-for-background-commands). Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `1800000` milissegundos alonga esse limite bem como o padrão de foreground.

443* **Hooks SessionStart**: Claude Code cancela um hook `command` após 600 segundos a menos que você defina [`timeout`](/docs/pt/hooks#common-fields), em segundos, na entrada do hook. Claude Code não aplica o timeout em um hook que você executa com [`async: true`](/docs/pt/hooks#run-hooks-in-the-background).443* **Hooks SessionStart**: Claude Code cancela um hook `command` após 600 segundos a menos que você defina [`timeout`](/docs/pt/hooks#common-fields), em segundos, na entrada do hook. Claude Code não aplica o timeout em um hook que você executa com [`async: true`](/docs/pt/hooks#run-hooks-in-the-background).

444* **Script de configuração**: um script que leva mais tempo do que aproximadamente cinco minutos não é armazenado em cache. [Requisitos de script](#script-requirements) cobre como ficar abaixo disso.444* **Script de configuração**: um script que leva mais tempo do que aproximadamente cinco minutos não é armazenado em cache. [Requisitos de script](#script-requirements) cobre como ficar abaixo disso.

445* **Sessões inativas**: após alguns minutos sem atividade, a VM de uma sessão pausa com seus arquivos salvos, e uma VM pausada pode ser recuperada posteriormente. [Defina variáveis de ambiente](#set-environment-variables) descreve o que uma sessão pega em cada caso, e [Environment expired](/docs/pt/claude-code-on-the-web#environment-expired) cobre como reabrir uma sessão cuja VM foi recuperada.445* **Sessões inativas**: após alguns minutos sem atividade, a VM de uma sessão pausa com seus arquivos salvos, e uma VM pausada pode ser recuperada posteriormente. [Defina variáveis de ambiente](#set-environment-variables) descreve o que uma sessão pega em cada caso, e [Environment expired](/docs/pt/claude-code-on-the-web#environment-expired) cobre como reabrir uma sessão cuja VM foi recuperada.

132| `/remote-control` | Disponibilize esta sessão para [Remote Control](/docs/pt/remote-control) de claude.ai. Executá-lo enquanto desconectado imprime que Remote Control requer uma assinatura claude.ai e diz como conectar; antes da v2.1.206 relatava `Unknown command: /remote-control`. Alias: `/rc` |132| `/remote-control` | Disponibilize esta sessão para [Remote Control](/docs/pt/remote-control) de claude.ai. Executá-lo enquanto desconectado imprime que Remote Control requer uma assinatura claude.ai e diz como conectar; antes da v2.1.206 relatava `Unknown command: /remote-control`. Alias: `/rc` |

133| `/remote-env` | Escolha o [ambiente em nuvem](/docs/pt/cloud-environments#select-an-environment-from-the-cli) padrão para sessões em nuvem que você inicia a partir da CLI |133| `/remote-env` | Escolha o [ambiente em nuvem](/docs/pt/cloud-environments#select-an-environment-from-the-cli) padrão para sessões em nuvem que você inicia a partir da CLI |

134| `/rename [name]` | Renomeie a sessão atual e mostre o nome na barra de prompt. Sem um nome, auto-gera um a partir do histórico de conversa. Também disponível em modo não interativo (`-p`); requer Claude Code v2.1.205 ou posterior. De cada superfície de renomeação, incluindo claude.ai e o aplicativo de desktop, Claude Code substitui caracteres de controle e invisíveis no novo nome com espaços e limita o nome a 200 caracteres. Se o nome estiver vazio uma vez que caracteres invisíveis são removidos, Claude Code o rejeita e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. A substituição de caracteres e limite de comprimento requerem Claude Code v2.1.221 ou posterior. Se outra sessão ativa nesta máquina já usar um nome que você passa, Claude Code aplica [uma variante dele](/docs/pt/sessions#name-your-sessions) |134| `/rename [name]` | Renomeie a sessão atual e mostre o nome na barra de prompt. Sem um nome, auto-gera um a partir do histórico de conversa. Também disponível em modo não interativo (`-p`); requer Claude Code v2.1.205 ou posterior. De cada superfície de renomeação, incluindo claude.ai e o aplicativo de desktop, Claude Code substitui caracteres de controle e invisíveis no novo nome com espaços e limita o nome a 200 caracteres. Se o nome estiver vazio uma vez que caracteres invisíveis são removidos, Claude Code o rejeita e mostra `That name is empty once invisible characters are removed. Usage: /rename <name>`. A substituição de caracteres e limite de comprimento requerem Claude Code v2.1.221 ou posterior. Se outra sessão ativa nesta máquina já usar um nome que você passa, Claude Code aplica [uma variante dele](/docs/pt/sessions#name-your-sessions) |

135| `/resume [session]` | Retome uma conversa por ID ou nome, ou abra o seletor de sessão. [Sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg`; uma que ainda está em execução não pode ser retomada aqui, então anexe-a de `claude agents` ou pare-a lá primeiro. Alias: `/continue` |135| `/resume [session]` | Retome uma conversa por ID ou nome, ou abra o seletor de sessão. [Sessões de fundo](/docs/pt/agent-view) aparecem no seletor marcadas com `bg`. Retomar uma que ainda está em execução, do seletor ou por ID ou nome, [abre essa sessão](/docs/pt/sessions#resume-a-running-background-session): sua conversa atual se move para o fundo e este terminal se anexa à em execução. Pressione `←` em um prompt vazio para retornar à visualização de agente, que também lista a conversa que você deixou. Antes da v2.1.285, Claude Code recusava e dizia para abrir a sessão com `claude attach` ou pará-la primeiro. Alias: `/continue` |

136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias de [`/code-review`](/docs/pt/code-review#review-a-diff-locally): revisa o diff atual, ou um número de PR, branch ou caminho que você passa, como `/review 1234`, e toma os mesmos níveis de esforço e sinalizadores. Sem um nível dado, a revisão reutiliza o último nível `low` através `max` que você digitou; consulte [Revise um diff localmente](/docs/pt/code-review#review-a-diff-locally) para as regras exatas. Para uma revisão em nuvem profunda, use [`/code-review ultra`](/docs/pt/ultrareview). Antes da v2.1.223, `/review` era um comando separado que executava uma revisão de uma única passagem, somente leitura de um pull request GitHub por número, listando PRs abertos para escolher quando executado sem argumento; de v2.1.186 através v2.1.201, executava o mesmo mecanismo multi-agente que `/code-review medium` |136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias de [`/code-review`](/docs/pt/code-review#review-a-diff-locally): revisa o diff atual, ou um número de PR, branch ou caminho que você passa, como `/review 1234`, e toma os mesmos níveis de esforço e sinalizadores. Sem um nível dado, a revisão reutiliza o último nível `low` através `max` que você digitou; consulte [Revise um diff localmente](/docs/pt/code-review#review-a-diff-locally) para as regras exatas. Para uma revisão em nuvem profunda, use [`/code-review ultra`](/docs/pt/ultrareview). Antes da v2.1.223, `/review` era um comando separado que executava uma revisão de uma única passagem, somente leitura de um pull request GitHub por número, listando PRs abertos para escolher quando executado sem argumento; de v2.1.186 através v2.1.201, executava o mesmo mecanismo multi-agente que `/code-review medium` |

137| `/rewind` | Retroceda a conversa e/ou código para um ponto anterior, ou resuma a partir de uma mensagem selecionada. Consulte [checkpointing](/docs/pt/checkpointing). Aliases: `/checkpoint`, `/undo` |137| `/rewind` | Retroceda a conversa e/ou código para um ponto anterior, ou resuma a partir de uma mensagem selecionada. Consulte [checkpointing](/docs/pt/checkpointing). Aliases: `/checkpoint`, `/undo` |

138| `/run` | **[Skill](/docs/pt/skills#bundled-skills).** Inicie e dirija o aplicativo do seu projeto para ver uma mudança funcionando, não apenas passando testes. Consulte [Execute e verifique seu aplicativo](/docs/pt/skills#run-and-verify-your-app) |138| `/run` | **[Skill](/docs/pt/skills#bundled-skills).** Inicie e dirija o aplicativo do seu projeto para ver uma mudança funcionando, não apenas passando testes. Consulte [Execute e verifique seu aplicativo](/docs/pt/skills#run-and-verify-your-app) |

967 967 

968Para mover uma sessão CLI para Desktop, execute `/desktop` no terminal. Claude salva sua sessão e a abre no aplicativo desktop, depois sai do CLI. Este comando está disponível em macOS e Windows x64 quando você está conectado com uma assinatura Claude. Não está disponível com autenticação de chave de API ou em Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.968Para mover uma sessão CLI para Desktop, execute `/desktop` no terminal. Claude salva sua sessão e a abre no aplicativo desktop, depois sai do CLI. Este comando está disponível em macOS e Windows x64 quando você está conectado com uma assinatura Claude. Não está disponível com autenticação de chave de API ou em Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry.

969 969 

970Do seu shell, [`claude --desktop`](/docs/pt/cli-reference#cli-flags) abre Desktop diretamente sem iniciar uma sessão de terminal. Requer Claude Code v2.1.285 ou posterior e tem os mesmos requisitos de plataforma e login que `/desktop`. Sem outros argumentos, abre Desktop no diretório atual. Para abrir uma sessão CLI existente em Desktop, adicione `--continue` para a conversa mais recente neste diretório, ou `--resume` com o ID da sessão que `/status` mostra:

971 

972```bash theme={null}

973claude --desktop --resume <session-id>

974```

975 

976Claude Code imprime `Opening session <session-id> in Claude Desktop`, a sessão abre no aplicativo e o comando sai. Um nome de sessão não funciona no lugar do ID. Claude Code não move uma sessão que está aberta em outro terminal ou ainda em execução em segundo plano. Se Claude Desktop não estiver instalado, o comando imprime um link de download e sai.

977 

970Você também pode retomar uma sessão CLI de dentro do Desktop com `/resume`. O comando está disponível em sessões locais, não em SSH, WSL ou sessões na nuvem.978Você também pode retomar uma sessão CLI de dentro do Desktop com `/resume`. O comando está disponível em sessões locais, não em SSH, WSL ou sessões na nuvem.

971 979 

972Para continuar uma sessão de terminal em Desktop:980Para continuar uma sessão de terminal em Desktop:

3657 Não foi possível abrir Claude Desktop3657 Não foi possível abrir Claude Desktop

3658</h3>3658</h3>

3659 3659 

3660Você executou [`/desktop`](/docs/pt/desktop#coming-from-the-cli), ou seu alias `/app`, e o comando do sistema que Claude Code usa para abrir Claude Desktop falhou. A sessão permanece no terminal.3660Você executou [`/desktop`](/docs/pt/desktop#coming-from-the-cli) ou seu alias `/app` em uma sessão, ou [`claude --desktop`](/docs/pt/cli-reference#cli-flags) em seu shell, e o comando do sistema que Claude Code usa para abrir Claude Desktop falhou. Depois de `/desktop`, a sessão permanece no terminal; `claude --desktop` imprime a mensagem sem o prefixo `Error:` e sai com status 1.

3661 

3662O texto entre parênteses nomeia o comando que falhou, com seu status de saída e a primeira linha de sua saída de erro quando a produziu. No macOS esse comando é `open`, como neste exemplo; no Windows é `rundll32`:

3661 3663 

3662```text theme={null}3664```text theme={null}

3663Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.3665Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.

3664```3666```

3665 3667 

3666**O que fazer:**3668**O que fazer:**

3667 3669 

3668* Abra Claude Desktop você mesmo, depois execute `/desktop` novamente3670* Abra Claude Desktop você mesmo, depois execute `/desktop` ou `claude --desktop` novamente

3669* Para ler a saída de erro completa desse comando, ative o log de debug com `/debug`, execute `/desktop` novamente e verifique o log de debug3671* Para ler a saída de erro completa do comando que falhou, ative o log de debug com `/debug` e execute `/desktop` novamente, ou execute `claude --desktop --debug-file <path>`, depois verifique o log de debug

3670 3672 

3671Antes da v2.1.275, a mensagem era `Failed to open Claude Desktop. Please try opening it manually.` e não dizia o que falhou.3673Antes da v2.1.285, a mensagem terminava `Open Claude Desktop and run /desktop again.` Antes da v2.1.275, era `Failed to open Claude Desktop. Please try opening it manually.` e não dizia o que falhou.

3672 3674 

3673<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3675<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3674 /terminal-setup deixou seu mapa de teclas Zed inalterado3676 /terminal-setup deixou seu mapa de teclas Zed inalterado

1938| :- | :- |1938| :- | :- |

1939| `permissionDecision` | `"allow"` pula o prompt de permissão, exceto para as [ações que nenhum modo auto-aprova](/docs/pt/permission-modes#actions-no-mode-auto-approves) e para `AskUserQuestion` e `ExitPlanMode`, que precisam de [`updatedInput` emparelhado com ele](#allow-with-updatedinput). `"deny"` impede a chamada de ferramenta. `"ask"` solicita ao usuário para confirmar. `"defer"` sai graciosamente para que a ferramenta possa ser retomada mais tarde. [Regras de negação e pergunta](/docs/pt/permissions#manage-permissions) ainda são avaliadas independentemente do que o hook retorna |1939| `permissionDecision` | `"allow"` pula o prompt de permissão, exceto para as [ações que nenhum modo auto-aprova](/docs/pt/permission-modes#actions-no-mode-auto-approves) e para `AskUserQuestion` e `ExitPlanMode`, que precisam de [`updatedInput` emparelhado com ele](#allow-with-updatedinput). `"deny"` impede a chamada de ferramenta. `"ask"` solicita ao usuário para confirmar. `"defer"` sai graciosamente para que a ferramenta possa ser retomada mais tarde. [Regras de negação e pergunta](/docs/pt/permissions#manage-permissions) ainda são avaliadas independentemente do que o hook retorna |

1940| `permissionDecisionReason` | Para `"ask"`, mostrado ao usuário mas não ao Claude. Para `"deny"`, mostrado ao Claude. Para `"allow"` e `"defer"`, escrito apenas no [log de depuração](#debug-hooks) |1940| `permissionDecisionReason` | Para `"ask"`, mostrado ao usuário mas não ao Claude. Para `"deny"`, mostrado ao Claude. Para `"allow"` e `"defer"`, escrito apenas no [log de depuração](#debug-hooks) |

1941| `updatedInput` | Modifica os parâmetros de entrada da ferramenta antes da execução. Substitui o objeto de entrada inteiro, então inclua campos inalterados junto com os modificados. Claude Code avalia regras de permissão e a elegibilidade de [colocação em segundo plano automático](/docs/pt/tools-reference#background-commands) de um comando Bash contra a entrada que seu hook retorna, não a entrada que Claude enviou. Combine com `"allow"` para auto-aprovar, ou `"ask"` para mostrar a entrada modificada ao usuário. Para `"defer"`, ignorado |1941| `updatedInput` | Modifica os parâmetros de entrada da ferramenta antes da execução. Substitui o objeto de entrada inteiro, então inclua campos inalterados junto com os modificados. Claude Code avalia regras de permissão e a elegibilidade de [colocação em segundo plano automático](/docs/pt/tools-reference#foreground-commands-that-move-to-the-background) de um comando Bash contra a entrada que seu hook retorna, não a entrada que Claude enviou. Combine com `"allow"` para auto-aprovar, ou `"ask"` para mostrar a entrada modificada ao usuário. Para `"defer"`, ignorado |

1942| `additionalContext` | String adicionada ao contexto do Claude junto com o resultado da ferramenta. Ignorado quando `permissionDecision` é `"defer"`. Veja [Adicionar contexto para Claude](#add-context-for-claude) |1942| `additionalContext` | String adicionada ao contexto do Claude junto com o resultado da ferramenta. Ignorado quando `permissionDecision` é `"defer"`. Veja [Adicionar contexto para Claude](#add-context-for-claude) |

1943 1943 

1944Quando vários hooks PreToolUse retornam decisões diferentes, a precedência é `deny` > `defer` > `ask` > `allow`.1944Quando vários hooks PreToolUse retornam decisões diferentes, a precedência é `deny` > `defer` > `ask` > `allow`.

346* Solicitar ao Claude Code que execute um comando em segundo plano346* Solicitar ao Claude Code que execute um comando em segundo plano

347* Pressionar `Ctrl+B` para mover uma invocação regular da ferramenta Bash para o segundo plano. Usuários de Tmux devem pressionar `Ctrl+B` duas vezes devido à chave de prefixo do tmux.347* Pressionar `Ctrl+B` para mover uma invocação regular da ferramenta Bash para o segundo plano. Usuários de Tmux devem pressionar `Ctrl+B` duas vezes devido à chave de prefixo do tmux.

348 348 

349Quando um comando atinge seu tempo limite antes de terminar, Claude Code o move automaticamente [para o segundo plano](/docs/pt/tools-reference#background-commands) em vez de interrompê-lo, a menos que o comando comece com `sleep`. Para alterar quanto tempo os comandos são executados antes disso acontecer, defina as [variáveis de ambiente de tempo limite do Bash](/docs/pt/tools-reference#timeout-and-output-limits).349Quando um comando atinge seu tempo limite antes de terminar, Claude Code o move automaticamente [para o segundo plano](/docs/pt/tools-reference#foreground-commands-that-move-to-the-background) em vez de interrompê-lo, a menos que o comando comece com `sleep`. Para alterar quanto tempo os comandos são executados antes disso acontecer, defina as [variáveis de ambiente de tempo limite do Bash](/docs/pt/tools-reference#timeout-and-output-limits).

350 350 

351**Recursos principais:**351**Recursos principais:**

352 352 

358* No macOS e Linux, Claude Code encerra as tarefas em segundo plano em execução quando o sistema operacional sinaliza pressão de memória crítica, desde que a sessão tenha ficado ociosa por pelo menos 30 minutos e nenhuma volta ou subagente esteja em execução. Requer Claude Code v2.1.193 ou posterior358* No macOS e Linux, Claude Code encerra as tarefas em segundo plano em execução quando o sistema operacional sinaliza pressão de memória crítica, desde que a sessão tenha ficado ociosa por pelo menos 30 minutos e nenhuma volta ou subagente esteja em execução. Requer Claude Code v2.1.193 ou posterior

359 * O [log de depuração](/docs/pt/debug-your-config) diz por que as tarefas foram interrompidas, ou por que um evento de pressão as deixou em execução359 * O [log de depuração](/docs/pt/debug-your-config) diz por que as tarefas foram interrompidas, ou por que um evento de pressão as deixou em execução

360 * Defina [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/pt/env-vars) como `1` para desativar paradas por pressão de memória360 * Defina [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/pt/env-vars) como `1` para desativar paradas por pressão de memória

361* Comandos Bash e PowerShell em segundo plano têm um limite de tempo, contado a partir do momento em que o comando entra em segundo plano: 30 minutos, ou o `timeout` que Claude solicita quando inicia um comando em segundo plano, até um máximo de 2 horas. Um comando que se move para o segundo plano enquanto é executado, por exemplo com `Ctrl+B`, recebe 30 minutos a partir da mudança. Quando um comando atinge seu limite, Claude Code o interrompe e diz a Claude por quê, e Claude pode iniciá-lo novamente com um `timeout` mais longo se o trabalho ainda precisar dele. Duas variáveis de ambiente aumentam os limites, em milissegundos, e nenhuma delas pode encurtá-los:361* Comandos Bash e PowerShell em segundo plano têm um limite de tempo, contado a partir do momento em que o comando entra em segundo plano: 30 minutos, ou o `timeout` que Claude solicita quando inicia um comando em segundo plano, até um máximo de 2 horas. Um comando que se move para o segundo plano enquanto é executado, por exemplo com `Ctrl+B`, recebe 30 minutos a partir da mudança. Quando um comando atinge seu limite, Claude Code o interrompe e diz a Claude por quê, e Claude pode iniciá-lo novamente com um `timeout` mais longo se o trabalho ainda precisar dele. Para aumentar os limites, veja [Aumentar o limite de tempo para comandos em segundo plano](/docs/pt/tools-reference#raise-the-time-limit-for-background-commands) na referência de ferramentas

362 * Defina [`BASH_DEFAULT_TIMEOUT_MS`](/docs/pt/env-vars) acima de `1800000` para substituir o padrão de 30 minutos por esse valor, para comandos movidos também362* Um comando em segundo plano que um [subagente](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) em primeiro plano iniciou termina quando a execução desse subagente termina, independentemente de ter terminado, falhado ou sido interrompido; veja [Quando um comando em segundo plano para](/docs/pt/tools-reference#when-a-background-command-stops) na referência de ferramentas

363 * Defina [`BASH_MAX_TIMEOUT_MS`](/docs/pt/env-vars) acima de `7200000` para aumentar o máximo de 2 horas. Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `7200000` aumenta-o da mesma forma

364* Um comando em segundo plano que um [subagente](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) em primeiro plano iniciou termina quando a execução desse subagente termina, independentemente de ter terminado, falhado ou sido interrompido; veja [Comandos em segundo plano](/docs/pt/tools-reference#background-commands) na referência de ferramentas

365 363 

366Para desabilitar toda a funcionalidade de tarefas em segundo plano, defina a variável de ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` como `1`. Veja [Variáveis de ambiente](/docs/pt/env-vars) para detalhes.364Para desabilitar toda a funcionalidade de tarefas em segundo plano, defina a variável de ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` como `1`. Veja [Variáveis de ambiente](/docs/pt/env-vars) para detalhes.

367 365 

29Cada subcomando compartilha estes códigos de saída, argumentos de plugin e valores de escopo:29Cada subcomando compartilha estes códigos de saída, argumentos de plugin e valores de escopo:

30 30 

31* **Códigos de saída**: `0` em caso de sucesso e `1` em caso de falha. `validate` adiciona saída `2` para um erro inesperado, e `eval` adiciona os códigos listados em [sua seção](#plugin-eval).31* **Códigos de saída**: `0` em caso de sucesso e `1` em caso de falha. `validate` adiciona saída `2` para um erro inesperado, e `eval` adiciona os códigos listados em [sua seção](#plugin-eval).

32* **Argumentos de plugin**: um argumento `<plugin>` é um `name` de plugin ou `name@marketplace`. Quando dois marketplaces oferecem o mesmo nome, use a forma qualificada.32* **Argumentos de plugin**: um argumento `<plugin>` é um `name` de plugin ou `name@marketplace`. Quando dois marketplaces oferecem o mesmo nome, use a forma qualificada. `configure` aceita apenas a forma qualificada.

33* **Escopos**: `--scope` aceita `user`, `project` ou `local`, e nomeia o arquivo de configurações que o comando escreve. `update` também aceita `managed`.33* **Escopos**: `--scope` aceita `user`, `project` ou `local`, e nomeia o arquivo de configurações que o comando escreve. `update` também aceita `managed`.

34 34 

35<h3 id="plugin-init">35<h3 id="plugin-init">

87| Flag | Descrição |87| Flag | Descrição |

88| :- | :- |88| :- | :- |

89| `-s, --scope <scope>` | Escopo de instalação: `user`, `project` ou `local`. Padrão é `user` |89| `-s, --scope <scope>` | Escopo de instalação: `user`, `project` ou `local`. Padrão é `user` |

90| `--config <key=value>` | Defina uma opção [`userConfig`](/docs/pt/plugins/manifest-reference) que o manifesto do plugin declara. Repita a flag para cada opção. Requer Claude Code v2.1.147 ou posterior |90| `--config <key=value>` | Defina uma opção [`userConfig`](/docs/pt/plugins/manifest-reference) que o manifesto do plugin declara. Repita a flag para cada opção. Requer Claude Code v2.1.147 ou posterior. Uma chave escrita como `<server>.<key>` define uma configuração que um [servidor MCP empacotado](/docs/pt/plugins/components#include-a-packaged-mcpb-server) declara em sua própria `user_config`, para um arquivo de pacote enviado dentro do plugin. A forma `<server>.<key>` requer Claude Code v2.1.285 ou posterior |

91| `-y, --yes` | Aceite o comando de instalação exibido sem o prompt `Run this command now?`. Ignorado quando o comando é executado dentro de uma sessão Claude Code, como da ferramenta Bash ou um hook. Requer Claude Code v2.1.229 ou posterior |91| `-y, --yes` | Aceite o comando de instalação exibido sem o prompt `Run this command now?`. Ignorado quando o comando é executado dentro de uma sessão Claude Code, como da ferramenta Bash ou um hook. Requer Claude Code v2.1.229 ou posterior |

92| `--accept-command <sha256>` | Aceite o comando de instalação exibido cujo `sha256` uma execução anterior [`--json`](#plugin-json-result) relatou em `shownCommand`, no lugar de `-y`. Não pode ser combinado com `-y`. Veja [Aceitar um comando de instalação exibido](#accept-a-displayed-install-command). Requer Claude Code v2.1.271 ou posterior |92| `--accept-command <sha256>` | Aceite o comando de instalação exibido cujo `sha256` uma execução anterior [`--json`](#plugin-json-result) relatou em `shownCommand`, no lugar de `-y`. Não pode ser combinado com `-y`. Veja [Aceitar um comando de instalação exibido](#accept-a-displayed-install-command). Requer Claude Code v2.1.271 ou posterior |

93| `--json` | Imprima o resultado como um objeto JSON na última linha de stdout em vez da mensagem legível por humanos, para uso em scripts. Veja [Formato de resultado JSON](#plugin-json-result). Requer Claude Code v2.1.268 ou posterior |93| `--json` | Imprima o resultado como um objeto JSON na última linha de stdout em vez da mensagem legível por humanos, para uso em scripts. Veja [Formato de resultado JSON](#plugin-json-result). Requer Claude Code v2.1.268 ou posterior |

299| :- | :- |299| :- | :- |

300| `--json` | Imprima a lista como JSON |300| `--json` | Imprima a lista como JSON |

301| `--available` | Também liste plugins que seus marketplaces oferecem que você não instalou. Não tem efeito sem `--json` |301| `--available` | Também liste plugins que seus marketplaces oferecem que você não instalou. Não tem efeito sem `--json` |

302| `--data-size [plugin]` | Meça o [diretório de dados salvos](#what-an-uninstall-deletes-and-keeps) de cada plugin instalado, ou apenas o do plugin nomeado, dado como `name@marketplace`. Não tem efeito sem `--json`. Se o nome não tem registro de instalação, o comando imprime `--data-size names a plugin that is not installed` e sai com `1` em vez de imprimir a lista. Requer Claude Code v2.1.285 ou posterior |

302 303 

303Claude Code agrupa a saída legível por humanos por como cada plugin carrega:304Claude Code agrupa a saída legível por humanos por como cada plugin carrega:

304 305 

330| `notes` | array of strings | Avisos de autoria para um plugin que carregou e funciona |331| `notes` | array of strings | Avisos de autoria para um plugin que carregou e funciona |

331| `errorDetails` | array of objects | Um objeto por entrada `errors`, fornecendo seu `type` de diagnóstico e os nomes aos quais se refere, como o plugin, marketplace, servidor ou arquivo. Requer Claude Code v2.1.268 ou posterior |332| `errorDetails` | array of objects | Um objeto por entrada `errors`, fornecendo seu `type` de diagnóstico e os nomes aos quais se refere, como o plugin, marketplace, servidor ou arquivo. Requer Claude Code v2.1.268 ou posterior |

332| `noteDetails` | array of objects | Os mesmos objetos de detalhe para cada entrada `notes`. Requer Claude Code v2.1.268 ou posterior |333| `noteDetails` | array of objects | Os mesmos objetos de detalhe para cada entrada `notes`. Requer Claude Code v2.1.268 ou posterior |

334| `hasUserConfig` | boolean | Presente e `true` quando o plugin carregou e seu manifesto declara opções [`userConfig`](/docs/pt/plugins/manifest-reference#user-configuration). Ausente para um plugin que falhou ao carregar, qualquer que seja seu manifesto declare. Valores salvos nunca são incluídos. Requer Claude Code v2.1.285 ou posterior |

335| `projectEnabled` | boolean | Se o `.claude/settings.json` compartilhado do projeto ativa o plugin. Apenas installs de marketplace. Requer Claude Code v2.1.285 ou posterior |

336| `dataDirSize` | object | Com `--data-size`, o tamanho do [diretório de dados salvos](#what-an-uninstall-deletes-and-keeps) do plugin como `bytes` e `human`; ausente quando o diretório está faltando ou vazio. Apenas installs de marketplace. Requer Claude Code v2.1.285 ou posterior |

337| `dataDirUnreadable` | boolean | Com `--data-size`, `true` quando o diretório de dados salvos existe mas não conseguiu ser medido. Apenas installs de marketplace. Requer Claude Code v2.1.285 ou posterior |

333 338 

334Com `--json --available`, Claude Code imprime um objeto em vez de um array. Seu campo `installed` contém o array de objetos de plugin instalado, e seu campo `available` contém um objeto por plugin de marketplace não instalado com os campos abaixo.339Com `--json --available`, Claude Code imprime um objeto em vez de um array. Seu campo `installed` contém o array de objetos de plugin instalado, e seu campo `available` contém um objeto por plugin de marketplace não instalado com os campos abaixo.

335 340 

373 378 

374Para um plugin que não está carregado, Claude Code imprime ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` e sai com `1`.379Para um plugin que não está carregado, Claude Code imprime ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` e sai com `1`.

375 380 

381<h3 id="plugin-configure">

382 plugin configure

383</h3>

384 

385Mostre as opções [`userConfig`](/docs/pt/plugins/manifest-reference#user-configuration) de um plugin instalado e quais estão definidas, ou salve valores canalizados em stdin. Requer Claude Code v2.1.285 ou posterior.

386 

387```bash theme={null}

388claude plugin configure <plugin>

389```

390 

391| Flag | Descrição |

392| :- | :- |

393| `--values-stdin` | Leia valores de opção de stdin como um objeto JSON de strings de linha única e salve-os. Opções que você deixa de fora mantêm seus valores salvos |

394| `--json` | Imprima o resultado como um objeto JSON em stdout. Sem `--values-stdin`, o objeto carrega o `schema` e `choices` das opções, seus `inputs` iniciais, e os nomes de opções `configured` e `unconfigured`. Com `--values-stdin`, carrega os nomes de opções `saved` e, quando conseguem ser lidos novamente, os nomes `unconfigured` |

395 

396Sem flags, o comando lista cada opção com até três rótulos: `required` ou `optional`, depois `sensitive` para uma opção que o manifesto declara sensível, depois `set` ou `not set`. Não imprime valores salvos. Com `--json`, a saída inclui os valores salvos de opções que não são sensíveis, e nunca o texto de uma sensível.

397 

398Para salvar valores, escreva-os em um arquivo como um objeto JSON que mapeia chaves de opção para valores de string, depois passe o arquivo em stdin. Substitua `formatter@my-marketplace` pelo id do seu próprio plugin conforme `claude plugin list` o mostra. Este exemplo define uma opção nomeada `api_url` de um arquivo `values.json` que contém `{"api_url": "https://example.com"}`:

399 

400```bash theme={null}

401claude plugin configure formatter@my-marketplace --values-stdin < values.json

402```

403 

404Claude Code valida cada valor contra o tipo declarado da opção e imprime `Configuration saved. Restart Claude Code to apply it.` Se você passar uma chave que o manifesto não declara, ou um valor que falha na validação, o comando não salva nada, imprime `Failed to save configuration:` com o motivo, e sai com `1`. Com `--json`, um valor recusado também imprime um objeto em stdout cujo campo `refused` carrega a `message` e, quando uma opção é culpada, sua chave `option`.

405 

406Passe o id completo `name@marketplace` do plugin, conforme `claude plugin list` o mostra. `configure` não aceita um `name` simples. Quando nenhum plugin carregado tem esse id, o comando imprime `No installed plugin has the id "<plugin>".` e sai com `1`.

407 

408Para as configurações de um servidor MCP empacotado, veja [`plugin install --config`](#plugin-install) ou o item **Configure** em `/plugin`.

409 

376<h3 id="plugin-prune">410<h3 id="plugin-prune">

377 plugin prune411 plugin prune

378</h3>412</h3>

868 868 

869O servidor usa seu nome do `name` no manifesto do pacote.869O servidor usa seu nome do `name` no manifesto do pacote.

870 870 

871Um manifesto próprio do pacote pode declarar configurações que o servidor precisa do usuário em um bloco `user_config`. Um servidor agrupado com uma configuração obrigatória que não tem valor salvo não inicia. A aba **Errors** de `/plugin` mostra `Bundled MCP server "<name>" was not started: it needs configuration`.

872 

873Os usuários fornecem os valores de uma de duas maneiras:

874 

875* **Em `/plugin`**: selecione o plugin na aba **Installed** e escolha **Configure**

876* **Na instalação, a partir do shell**: passe [`--config <server>.<key>=<value>`](/docs/pt/plugins/cli-reference#plugin-install) para `claude plugin install`. Requer Claude Code v2.1.285 ou posterior, e funciona apenas para um pacote empacotado dentro do plugin.

877 

871Para transportes e autenticação, consulte [MCP](/docs/pt/mcp#plugin-provided-mcp-servers).878Para transportes e autenticação, consulte [MCP](/docs/pt/mcp#plugin-provided-mcp-servers).

872 879 

873<h3 id="lsp-servers">880<h3 id="lsp-servers">

1071 Quando o diálogo de configuração aparece1078 Quando o diálogo de configuração aparece

1072</h3>1079</h3>

1073 1080 

1074O diálogo aparece apenas na interface interativa `/plugin`. Ele abre para qualquer opção que ainda não está definida quando o usuário faz qualquer um dos seguintes:1081O diálogo faz parte da interface interativa `/plugin`. Quando o usuário faz qualquer um dos seguintes, ele abre para qualquer opção que ainda não está definida:

1075 1082 

1076* Instala o plugin em `/plugin`1083* Instala o plugin em `/plugin`

1077* Executa `/plugin install <plugin>@<marketplace>` dentro de uma sessão1084* Executa `/plugin install <plugin>@<marketplace>` dentro de uma sessão

1079 1086 

1080Para abrir o mesmo diálogo a qualquer momento, o usuário executa `/plugin configure <plugin>@<marketplace>`.1087Para abrir o mesmo diálogo a qualquer momento, o usuário executa `/plugin configure <plugin>@<marketplace>`.

1081 1088 

1082O comando shell `claude plugin install` nunca solicita valores `userConfig`. Para definir valores do shell, passe cada um como `--config KEY=VALUE`. Quando opções permanecem indefinidas, o comando imprime uma linha `userConfig options not yet set` que nomeia ambas as formas de defini-las. [O diálogo `userConfig` nunca aparece](/docs/pt/plugins/troubleshooting#the-userconfig-dialog-never-appears) cita a linha.1089O diálogo Manage plugins da extensão VS Code [Manage plugins dialog](/docs/pt/vs-code#install-plugins) solicita opções não definidas como um formulário após uma instalação, e um ícone de engrenagem na linha do plugin abre o formulário novamente com todas as opções.

1090 

1091O comando shell `claude plugin install` nunca solicita valores `userConfig`. Para definir valores do shell, passe cada um como `--config KEY=VALUE` quando você instalar, ou redirecione um objeto JSON para [`claude plugin configure --values-stdin`](/docs/pt/plugins/cli-reference#plugin-configure) depois.

1092 

1093Quando opções permanecem indefinidas, `claude plugin install` imprime uma linha `userConfig options not yet set`. Para o texto exato da linha, consulte [O diálogo `userConfig` nunca aparece](/docs/pt/plugins/troubleshooting#the-userconfig-dialog-never-appears).

1083 1094 

1084Para os campos de opção, onde cada valor é armazenado, como um componente referencia um valor salvo e quais campos rejeitam `${user_config.*}`, consulte [Configuração do usuário](/docs/pt/plugins/manifest-reference#user-configuration).1095Para os campos de opção, onde cada valor é armazenado, como um componente referencia um valor salvo e quais campos rejeitam `${user_config.*}`, consulte [Configuração do usuário](/docs/pt/plugins/manifest-reference#user-configuration).

1085 1096 

72 A última frase do resumo diz se o plugin é utilizável nesta sessão:72 A última frase do resumo diz se o plugin é utilizável nesta sessão:

73 73 

74 * **Active now**: `Plugin is now active.` Nenhuma recarga é necessária.74 * **Active now**: `Plugin is now active.` Nenhuma recarga é necessária.

75 * **Active, but a server needs setup**: `Plugin is now active.` é seguido por `Its bundled MCP server needs configuration before it can start`. O [servidor MCP empacotado](/docs/pt/plugins/components#include-a-packaged-mcpb-server) do plugin não pode iniciar até que você defina suas opções. Selecione o plugin na aba **Installed** em `/plugin` e escolha **Configure** para definir as opções do servidor.

75 * **Reload needed**: `Run /reload-plugins to activate.` O painel fecha e o Claude Code executa essa recarga para você. Se a recarga [invalidasse o cache de prompt](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin), ela avisa e deixa o plugin pendente. Execute `/reload-plugins --force` para ativá-lo mesmo assim, o que custa uma solicitação sem cache.76 * **Reload needed**: `Run /reload-plugins to activate.` O painel fecha e o Claude Code executa essa recarga para você. Se a recarga [invalidasse o cache de prompt](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin), ela avisa e deixa o plugin pendente. Execute `/reload-plugins --force` para ativá-lo mesmo assim, o que custa uma solicitação sem cache.

76 * **Load failed**: `The plugin couldn't be loaded`. Abra a aba **Errors** em `/plugin` para saber o motivo e depois veja [Após instalação: plugin não funcionando](/docs/pt/plugins/troubleshooting#plugin-installed-but-not-working).77 * **Load failed**: `The plugin couldn't be loaded`. Abra a aba **Errors** em `/plugin` para saber o motivo e depois veja [Após instalação: plugin não funcionando](/docs/pt/plugins/troubleshooting#plugin-installed-but-not-working).

77 </Step>78 </Step>

248Um marketplace privado é um em um repositório que você precisa de credenciais para clonar, no GitHub ou em qualquer outro host git. Você o adiciona com o mesmo comando `/plugin marketplace add` ou `claude plugin marketplace add` que um público. O Claude Code o clona com as credenciais git já em sua máquina e nunca solicita, então cada forma de conexão tem um requisito:249Um marketplace privado é um em um repositório que você precisa de credenciais para clonar, no GitHub ou em qualquer outro host git. Você o adiciona com o mesmo comando `/plugin marketplace add` ou `claude plugin marketplace add` que um público. O Claude Code o clona com as credenciais git já em sua máquina e nunca solicita, então cada forma de conexão tem um requisito:

249 250 

250* **HTTPS**: seus ajudantes de credencial git se aplicam, então o acesso que você configurou com `gh auth login`, o Keychain do macOS ou `git-credential-store` funciona. Prompts interativos são suprimidos, então um host que você nunca autenticou falha em vez de pedir uma senha.251* **HTTPS**: seus ajudantes de credencial git se aplicam, então o acesso que você configurou com `gh auth login`, o Keychain do macOS ou `git-credential-store` funciona. Prompts interativos são suprimidos, então um host que você nunca autenticou falha em vez de pedir uma senha.

251* **SSH**: o host já deve estar em seu arquivo `known_hosts` e a chave deve funcionar sem um prompt de frase-passe, porque os prompts de impressão digital do host e frase-passe também são suprimidos.252* **SSH**: o host já deve estar em seu arquivo `known_hosts` e a chave deve funcionar sem um prompt de frase-passe. Se sua configuração git nomeia um programa SSH em `GIT_SSH_COMMAND`, `GIT_SSH` ou `core.sshCommand` da sua configuração git, o Claude Code executa esse programa.

252* **Atalho GitHub `owner/repo`**: o Claude Code verifica se sua chave SSH autentica em `github.com`, depois clona sobre SSH se fizer e sobre HTTPS se não fizer. Defina [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/pt/env-vars#variables) para pular essa verificação e sempre clonar sobre HTTPS.253* **Atalho GitHub `owner/repo`**: o Claude Code verifica se sua chave SSH autentica em `github.com`, depois clona sobre SSH se fizer e sobre HTTPS se não fizer. Defina [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/pt/env-vars#variables) para pular essa verificação e sempre clonar sobre HTTPS.

253 254 

254As mesmas credenciais se aplicam quando você executa `/plugin install`, `/plugin marketplace update` e `claude plugin update`.255As mesmas credenciais se aplicam quando você executa `/plugin install`, `/plugin marketplace update` e `claude plugin update`.

288 289 

289* Digite para filtrar por nome ou descrição.290* Digite para filtrar por nome ou descrição.

290* Pressione **Space** para habilitar ou desabilitar o plugin selecionado, e **f** para favoritá-lo.291* Pressione **Space** para habilitar ou desabilitar o plugin selecionado, e **f** para favoritá-lo.

291* Pressione **Enter** para abrir os detalhes de um plugin. O menu lá oferece **Disable plugin** ou **Enable plugin**, **Update now** e **Uninstall**. Plugins que aceitam configurações também oferecem **Configure options**.292* Pressione **Enter** para abrir os detalhes de um plugin.

293 

294Um menu de detalhes de plugin oferece **Disable plugin** ou **Enable plugin**, **Update now** e **Uninstall**. Dois itens adicionais aparecem para plugins que aceitam configurações, e um plugin pode mostrar ambos:

295 

296* **Configure options**: mostrado quando o manifesto do plugin declara opções [`userConfig`](/docs/pt/plugins/manifest-reference#user-configuration). Abre o diálogo para essas opções

297* **Configure**: mostrado quando o plugin inclui um [servidor MCP empacotado](/docs/pt/plugins/components#include-a-packaged-mcpb-server). Define as configurações `user_config` próprias desse servidor

292 298 

293A aba também pode mostrar plugins em escopo **Managed**. Sua organização os instalou através de [configurações gerenciadas](/docs/pt/settings#settings-files), e você não pode habilitá-los, desabilitá-los ou desinstalá-los aqui.299A aba também pode mostrar plugins em escopo **Managed**. Sua organização os instalou através de [configurações gerenciadas](/docs/pt/settings#settings-files), e você não pode habilitá-los, desabilitá-los ou desinstalá-los aqui.

294 300 

201 201 

202Uma adição bem-sucedida imprime `Successfully added marketplace: <name>`.202Uma adição bem-sucedida imprime `Successfully added marketplace: <name>`.

203 203 

204<h3 id="invalid-git-url">

205 `Invalid git URL`

206</h3>

207 

208Você adicionou um marketplace, instalou um plugin ou executou uma atualização a partir de um endereço git, e o comando falhou com `Invalid git URL` em sua mensagem.

209 

210Claude Code verifica cada endereço git antes de executar git. Ele recusa um endereço cujo protocolo não suporta. Ele também recusa um endereço que git poderia ler como nomeando um servidor ou pasta diferente do que o endereço mostra.

211 

212O texto após o endereço nomeia o que mudar. Reescreva o endereço como a mensagem diz e execute o comando novamente.

213 

214Uma recusa que em vez disso diz `is blocked by enterprise policy` vem das configurações da sua organização. Veja [Marketplace source is blocked by enterprise policy](#marketplace-source-is-blocked-by-enterprise-policy).

215 

204<h3 id="path-does-not-exist">216<h3 id="path-does-not-exist">

205 `Path does not exist: <path>`217 `Path does not exist: <path>`

206</h3>218</h3>

410 422 

411`claude plugin install` no seu shell imprime uma mensagem diferente. Para um plugin já instalado no escopo de destino, imprime `Plugin "<name>@<marketplace>" is already installed (scope: user)` e sai com 0. Se seu diretório de cache está faltando, o mesmo comando o re-baixa.423`claude plugin install` no seu shell imprime uma mensagem diferente. Para um plugin já instalado no escopo de destino, imprime `Plugin "<name>@<marketplace>" is already installed (scope: user)` e sai com 0. Se seu diretório de cache está faltando, o mesmo comando o re-baixa.

412 424 

425<h3 id="plugin-would-share-its-folder">

426 `"<plugin>" was not installed: it would share its folder with "<other>"`

427</h3>

428 

429Você instalou um plugin através de `claude plugin install`, `/plugin`, ou uma sugestão de instalação em uma sessão, e Claude Code o recusou com esta linha, ou com `would share its saved data with`.

430 

431O id do plugin recusado e o id de um plugin instalado mapeiam para a mesma pasta no disco: eles são os mesmos uma vez que `.` e `@` são escritos como `-`. No macOS e Windows, ids que diferem apenas em maiúsculas mapeiam para a mesma pasta também. Instalar ambos colocaria os arquivos de um plugin na pasta do outro, então Claude Code recusa e o plugin instalado mantém seus arquivos.

432 

433A mensagem nomeia a saída:

434 

435* **O outro plugin está instalado**: a mensagem diz `Only one of the two can be installed.` e nomeia o comando `claude plugin uninstall`, ou o passo de desinstalação em `/plugin`, que remove o outro plugin. Execute-o, depois instale novamente. Para o que a desinstalação remove, veja [What an uninstall deletes and keeps](/docs/pt/plugins/cli-reference#what-an-uninstall-deletes-and-keeps).

436* **Ambos os ids chegam em uma instalação**, como um plugin e uma dependência que ele precisa: nenhuma ordem de instalação ajuda. Apenas um mantenedor do marketplace que lista os dois plugins pode corrigi-lo, renomeando um deles. Quando os dois vêm de marketplaces diferentes, um mantenedor de qualquer um deles pode.

437 

413<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">

414 `This plugin uses a source type your Claude Code version does not support`439 `This plugin uses a source type your Claude Code version does not support`

415</h3>440</h3>

790* **`URL is unset or invalid`**: uma opção `${user_config.*}` que a URL usa não está definida. Execute `/plugin configure <plugin>` para defini-la815* **`URL is unset or invalid`**: uma opção `${user_config.*}` que a URL usa não está definida. Execute `/plugin configure <plugin>` para defini-la

791* **`has an invalid MCP url`** ou **`headersHelper for MCP server '<server>' references ${user_config.*}`**: a configuração do próprio plugin está em falta. Corrija a `url` ou `headersHelper` em sua configuração MCP do plugin, ou relate ao autor do plugin se o plugin não é seu. O caso `headersHelper` tem sua própria entrada em [plugin command references user\_config](/docs/pt/errors#plugin-command-references-user-config)816* **`has an invalid MCP url`** ou **`headersHelper for MCP server '<server>' references ${user_config.*}`**: a configuração do próprio plugin está em falta. Corrija a `url` ou `headersHelper` em sua configuração MCP do plugin, ou relate ao autor do plugin se o plugin não é seu. O caso `headersHelper` tem sua própria entrada em [plugin command references user\_config](/docs/pt/errors#plugin-command-references-user-config)

792 817 

818<h4 id="bundled-mcp-server-name-was-not-started-it-needs-configuration">

819 `Bundled MCP server "<name>" was not started: it needs configuration`

820</h4>

821 

822O plugin inclui o servidor como um [bundle MCPB](/docs/pt/plugins/components#include-a-packaged-mcpb-server) que declara `user_config`, e uma configuração obrigatória não tem valor salvo ainda ou um valor salvo falha na validação do próprio bundle, então Claude Code pula o início do servidor. O resto do plugin funciona.

823 

824Selecione o plugin na aba **Installed** do `/plugin` e escolha **Configure** para fornecer os valores. Depois que você salvar, `/plugin` mostra `Configuration saved.` e fecha, e Claude Code recarrega plugins conforme descrito em [Gerenciar plugins instalados](/docs/pt/plugins/install#manage-installed-plugins). O servidor inicia uma vez que esse reload se aplica. Antes da v2.1.285, Claude Code pulava o servidor sem mostrar esta linha.

825 

793<h4 id="server-is-configured-but-never-connects">826<h4 id="server-is-configured-but-never-connects">

794 Server is configured but never connects827 Server is configured but never connects

795</h4>828</h4>

934 967 

935Seu plugin declara opções `userConfig`, mas nenhum diálogo de configuração aparece quando você o instala.968Seu plugin declara opções `userConfig`, mas nenhum diálogo de configuração aparece quando você o instala.

936 969 

937A instalação interativa mostra o diálogo, e o comando de shell leva os valores como sinalizadores em vez disso:970Se a instalação solicita os valores depende de onde você a executa:

938 971 

939* **`/plugin install` em uma sessão, ou a aba Discover em `/plugin`**: o diálogo é parte desta instalação interativa972* **`/plugin install` em uma sessão, ou a aba Discover em `/plugin`**: o diálogo é parte desta instalação interativa

973* **O diálogo Manage plugins da extensão VS Code**: solicita opções não definidas como um formulário após a instalação. Antes da v2.1.285, instalar lá não mostrava formulário de opções, então defina os valores a partir de uma sessão de terminal com `/plugin configure <plugin>@<marketplace>`

940* **`claude plugin install` no seu shell**: nunca pede valores `userConfig`. Salva qualquer valor `--config KEY=VALUE` que você passa, e quando opções permanecem não definidas imprime `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Quando qualquer uma das opções não definidas é obrigatória, `(M required)` segue `not yet set`.974* **`claude plugin install` no seu shell**: nunca pede valores `userConfig`. Salva qualquer valor `--config KEY=VALUE` que você passa, e quando opções permanecem não definidas imprime `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Quando qualquer uma das opções não definidas é obrigatória, `(M required)` segue `not yet set`.

941 975 

942Se você instalou a partir do shell, passe os valores com `--config`, um sinalizador por opção:976Se você instalou a partir do shell, passe os valores com `--config`, um sinalizador por opção:

945claude plugin install my-plugin@my-marketplace --config api_url=https://example.com979claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

946```980```

947 981 

948Quando cada opção está definida, a saída de instalação não carrega nenhuma linha `not yet set`. Para abrir o diálogo depois em vez disso, execute `/plugin configure my-plugin@my-marketplace` em uma sessão.982Quando cada opção está definida, a saída de instalação não carrega nenhuma linha `not yet set`.

983 

984Para abrir o diálogo depois em vez disso, execute `/plugin configure my-plugin@my-marketplace` em uma sessão. A partir do shell, [`claude plugin configure`](/docs/pt/plugins/cli-reference#plugin-configure) mostra quais opções ainda estão não definidas e salva valores canalizados em stdin. Requer Claude Code v2.1.285 ou posterior.

949 985 

950Se você passar uma chave `--config` que o manifesto não declara, o plugin ainda instala, e o comando imprime `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` seguido pelas chaves que o plugin declara.986Se você passar uma chave `--config` que o manifesto não declara, o plugin ainda instala, e o comando imprime `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` seguido pelas chaves que o plugin declara.

951 987 

988Para um plugin que envia um [arquivo de pacote MCPB](/docs/pt/plugins/components#include-a-packaged-mcpb-server) declarando `user_config` próprio, a mensagem lê `isn't declared in this plugin's userConfig or by its bundled MCP servers.` em vez disso, e as chaves conhecidas incluem as chaves desse servidor, escritas `<server>.<key>`. Um pacote que o manifesto referencia por URL não é lido no tempo de instalação, então suas chaves não estão listadas e a mensagem diz para configurá-lo em `/plugin`. Definir chaves `<server>.<key>` requer Claude Code v2.1.285 ou posterior.

989 

952<h3 id="claude-plugin-validate-reports-errors">990<h3 id="claude-plugin-validate-reports-errors">

953 `claude plugin validate` reports errors991 `claude plugin validate` reports errors

954</h3>992</h3>

29 29 

30`claude --continue` abre uma [sessão em background](/docs/pt/agent-view) que foi concluída, mas não uma que ainda está em execução; abrir sessões em background concluídas requer Claude Code v2.1.257 ou posterior. Se sua conversa mais recente for uma que você [moveu para o background](/docs/pt/agent-view#send-the-session-to-the-background) e ainda estiver em execução lá, Claude Code sai com `Your most recent conversation is running in the background` e o ID dessa sessão. Anexe à sessão a partir de [`claude agents`](/docs/pt/agent-view#attach-to-a-session), ou execute `claude --resume` para escolher outra.30`claude --continue` abre uma [sessão em background](/docs/pt/agent-view) que foi concluída, mas não uma que ainda está em execução; abrir sessões em background concluídas requer Claude Code v2.1.257 ou posterior. Se sua conversa mais recente for uma que você [moveu para o background](/docs/pt/agent-view#send-the-session-to-the-background) e ainda estiver em execução lá, Claude Code sai com `Your most recent conversation is running in the background` e o ID dessa sessão. Anexe à sessão a partir de [`claude agents`](/docs/pt/agent-view#attach-to-a-session), ou execute `claude --resume` para escolher outra.

31 31 

32<span id="resume-a-running-background-session" />

33 

34Quando a conversa que você retoma com `claude --resume` ou `/resume` pertence a uma [sessão em background](/docs/pt/agent-view) que ainda está em execução, Claude Code abre a sessão em execução em si. Com `--bg` na linha de comando, a retomada é um [dispatch em background](/docs/pt/agent-view#from-your-shell) em vez disso. Antes da v2.1.285, Claude Code recusava e dizia para você abrir a sessão com `claude attach <id>`, ou para parar com `claude stop <id>` primeiro.

35 

36* **Do seu shell**: `claude --resume <session>` executa [`claude attach`](/docs/pt/agent-view#attach-to-a-session) nessa sessão no mesmo terminal em vez de carregar a transcrição em si. Um prompt que você passa na linha de comando, como em `claude --resume <session> "check the tests too"`, vai para a sessão como seu próximo turno primeiro, e Claude Code imprime `Sent your prompt to the background session (<id>); opening it…` antes de anexar. `claude -p --resume <session> "prompt"` digitado em um terminal faz o mesmo, portanto `-p` não mantém essa execução não interativa.

37 

38 Claude Code não abre a sessão quando a linha de comando tem qualquer um destes:

39 

40 * Entrada ou saída canalizada ou redirecionada

41 * Flags que configuram a sessão, como `--permission-mode`, `--model` ou `--settings`

42 * Flags que leem a saída, como `--output-format json` ou `--json-schema`

43 * Flags que limitam ou rebobinham a execução, como `--max-turns` ou `--max-budget-usd`

44 

45 Com qualquer um destes, ou quando [agent view está desativado](/docs/pt/agent-view#turn-off-agent-view), Claude Code não envia nada e sai com status 1, imprimindo que a sessão está em execução no background junto com o comando `claude attach <id>` que a abre, ou dizendo para você encontrá-la em `claude agents` quando não conseguir determinar o ID. Adicione `--fork-session` para retomar uma cópia da conversa em vez disso. Para continuar a conversa em si em uma sessão sua, com suas flags aplicadas, execute `claude stop <id>` e depois repita o comando.

46 

47 Um prompt que começa com `/` ou `!` não é enviado, e nem é qualquer prompt enquanto a sessão aguarda sua resposta a uma pergunta. Em ambos os casos Claude Code não abre a sessão, e a mensagem inclui `Your prompt was not sent to it` com o motivo.

48* **De dentro de uma sessão**: `/resume` move sua conversa atual para o background e anexa este terminal à sessão em execução, imprimindo `Opening "<title>", running in the background (<id>)`. Pressione `←` em um prompt vazio para retornar à agent view, que também lista a conversa que você deixou. Quando a conversa atual não consegue se mover para o background, por exemplo porque você já está anexado a uma sessão em background ou a persistência de sessão está desativada, `/resume` imprime o comando `claude attach` para executar em vez disso.

49 

32Você pode executar `claude --resume <session-id>` de qualquer diretório: Claude Code procura o ID no diretório do projeto atual e seus git worktrees primeiro, depois em todos os outros projetos nesta máquina, para que encontre uma sessão que começou em outro lugar ou se moveu com [`/cd`](/docs/pt/commands). A busca entre projetos resolve o ID apenas quando exatamente um outro projeto contém uma transcrição com mensagens para ele, portanto uma duplicata copiada manualmente faz Claude Code relatar não encontrado em vez de retomar uma cópia arbitrária. Se nenhuma sessão armazenada corresponder ao ID, Claude Code relata `No conversation found with session ID: <session-id>`. Antes da v2.1.223, a busca parava no diretório do projeto atual e seus git worktrees, portanto você tinha que retomar do diretório em que a sessão trabalhou por último.50Você pode executar `claude --resume <session-id>` de qualquer diretório: Claude Code procura o ID no diretório do projeto atual e seus git worktrees primeiro, depois em todos os outros projetos nesta máquina, para que encontre uma sessão que começou em outro lugar ou se moveu com [`/cd`](/docs/pt/commands). A busca entre projetos resolve o ID apenas quando exatamente um outro projeto contém uma transcrição com mensagens para ele, portanto uma duplicata copiada manualmente faz Claude Code relatar não encontrado em vez de retomar uma cópia arbitrária. Se nenhuma sessão armazenada corresponder ao ID, Claude Code relata `No conversation found with session ID: <session-id>`. Antes da v2.1.223, a busca parava no diretório do projeto atual e seus git worktrees, portanto você tinha que retomar do diretório em que a sessão trabalhou por último.

33 51 

34<h3 id="what-a-resumed-session-restores">52<h3 id="what-a-resumed-session-restores">

35 O que uma sessão retomada restaura53 O que uma sessão retomada restaura

36</h3>54</h3>

37 55 

38Uma sessão retomada restaura a conversa junto com o estado salvo nela:56Quando Claude Code carrega uma conversa de sua transcrição, a sessão retomada restaura a conversa junto com o estado salvo nela:

39 57 

40* Histórico de conversa: o histórico completo, incluindo chamadas de ferramentas e resultados. Uma ferramenta que ainda estava em execução quando o processo anterior terminou, por exemplo em uma falha, não termina ou executa novamente quando você retoma. Claude vê a chamada marcada como interrompida antes de seu resultado ser registrado e é instruído a verificar se ela teve efeito antes de executá-la novamente, a menos que [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/pt/env-vars#variables) esteja definido. Antes da v2.1.281, Claude Code descartava a chamada interrompida da conversa ou a mostrava a Claude como uma que você interrompeu.58* Histórico de conversa: o histórico completo, incluindo chamadas de ferramentas e resultados. Uma ferramenta que ainda estava em execução quando o processo anterior terminou, por exemplo em uma falha, não termina ou executa novamente quando você retoma. Claude vê a chamada marcada como interrompida antes de seu resultado ser registrado e é instruído a verificar se ela teve efeito antes de executá-la novamente, a menos que [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/pt/env-vars#variables) esteja definido. Antes da v2.1.281, Claude Code descartava a chamada interrompida da conversa ou a mostrava a Claude como uma que você interrompeu.

41* Modelo: a sessão continua no modelo que estava usando. O modelo não é restaurado quando foi descontinuado ou não é permitido por `availableModels`, quando uma flag `--model` ou uma variável de ambiente da família `ANTHROPIC_MODEL` escolhe um no lançamento, ou em provedores que usam IDs de implantação específicos do provedor, como [Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry](/docs/pt/third-party-integrations); veja [configuração de modelo](/docs/pt/model-config#setting-your-model) para a ordem de resolução.59* Modelo: a sessão continua no modelo que estava usando. O modelo não é restaurado quando foi descontinuado ou não é permitido por `availableModels`, quando uma flag `--model` ou uma variável de ambiente da família `ANTHROPIC_MODEL` escolhe um no lançamento, ou em provedores que usam IDs de implantação específicos do provedor, como [Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry](/docs/pt/third-party-integrations); veja [configuração de modelo](/docs/pt/model-config#setting-your-model) para a ordem de resolução.

51 Modo de permissão ao retomar69 Modo de permissão ao retomar

52</h4>70</h4>

53 71 

54Qual modo de permissão Claude Code inicia uma sessão retomada depende de como você retoma:72Qual modo de permissão Claude Code inicia uma sessão retomada depende de como você retoma. Os casos abaixo se aplicam quando Claude Code carrega a conversa de sua transcrição; quando você [abre uma sessão em background que ainda está em execução](#resume-a-running-background-session) em vez disso, essa sessão mantém o modo de permissão em que está.

55 73 

56* Terminal: `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` quando o nome corresponde a uma sessão, sem `-p`. Claude Code restaura o modo de permissão em que a sessão estava, exceto nos casos da tabela. Passe `--permission-mode` ou `--dangerously-skip-permissions` para substituir o modo restaurado.74* Terminal: `claude --continue`, `claude --resume <session-id>` ou `claude --resume <name>` quando o nome corresponde a uma sessão, sem `-p`. Claude Code restaura o modo de permissão em que a sessão estava, exceto nos casos da tabela. Passe `--permission-mode` ou `--dangerously-skip-permissions` para substituir o modo restaurado.

57* Não interativo: `claude -p --resume` ou `claude -p --continue`. Claude Code inicia a execução no modo de permissão em que uma nova execução `claude -p` iniciaria, exceto que uma sessão que terminou em modo de plano retoma em modo de plano sob as [condições abaixo](#resume-in-plan-mode-with-p).75* Não interativo: `claude -p --resume` ou `claude -p --continue`. Claude Code inicia a execução no modo de permissão em que uma nova execução `claude -p` iniciaria, exceto que uma sessão que terminou em modo de plano retoma em modo de plano sob as [condições abaixo](#resume-in-plan-mode-with-p).

740 740 

741* **Diretório de trabalho**: Claude Code executa cada comando no diretório de trabalho atual do shell da sessão. Esse diretório se move quando Claude executa `cd`. Use [`${CLAUDE_SKILL_DIR}` ou `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) em caminhos que devem ser resolvidos da mesma forma sempre.741* **Diretório de trabalho**: Claude Code executa cada comando no diretório de trabalho atual do shell da sessão. Esse diretório se move quando Claude executa `cd`. Use [`${CLAUDE_SKILL_DIR}` ou `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) em caminhos que devem ser resolvidos da mesma forma sempre.

742* **stderr**: com o shell `bash` padrão, Claude Code mescla stderr em stdout. Qualquer coisa que o comando escreva em stderr aparece no texto injetado.742* **stderr**: com o shell `bash` padrão, Claude Code mescla stderr em stdout. Qualquer coisa que o comando escreva em stderr aparece no texto injetado.

743* **Timeout**: cada comando é executado sob o [timeout](/docs/pt/tools-reference#timeout-and-output-limits) padrão de 2 minutos da ferramenta Bash. Quando a ferramenta Bash [move um comando com timeout para o background](/docs/pt/tools-reference#background-commands), a skill ainda é renderizada. O texto injetado relata a mudança e nomeia a tarefa em background e o arquivo coletando a saída do comando. Quando o comando é um que a ferramenta Bash nunca coloca automaticamente em background, Claude Code o mata no timeout. Essa falha [aborta a invocação](#when-an-injected-command-fails).743* **Timeout**: cada comando é executado sob o [timeout](/docs/pt/tools-reference#timeout-and-output-limits) padrão de 2 minutos da ferramenta Bash. Quando a ferramenta Bash [move um comando com timeout para o background](/docs/pt/tools-reference#foreground-commands-that-move-to-the-background), a skill ainda é renderizada. O texto injetado relata a mudança e nomeia a tarefa em background e o arquivo coletando a saída do comando. Quando o comando é um que a ferramenta Bash nunca coloca automaticamente em background, Claude Code o mata no timeout. Essa falha [aborta a invocação](#when-an-injected-command-fails).

744* **Tamanho da saída**: saída além do limite inline da ferramenta Bash chega como um caminho de arquivo mais uma visualização curta, não texto truncado. [Output limits](/docs/pt/tools-reference#output-limits) cobre o limite e como ajustar cada limite.744* **Tamanho da saída**: saída além do limite inline da ferramenta Bash chega como um caminho de arquivo mais uma visualização curta, não texto truncado. [Output limits](/docs/pt/tools-reference#output-limits) cobre o limite e como ajustar cada limite.

745 745 

746A ferramenta PowerShell aplica o mesmo comportamento de timeout, backgrounding e output-ceiling aos comandos que executa. Veja a seção [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) para seus detalhes.746A ferramenta PowerShell aplica o mesmo comportamento de timeout, backgrounding e output-ceiling aos comandos que executa. Veja a seção [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) para seus detalhes.

20Aqui está um exemplo de uma [linha de status de múltiplas linhas](#display-multiple-lines) que exibe informações do git na primeira linha e uma barra de contexto codificada por cores na segunda.20Aqui está um exemplo de uma [linha de status de múltiplas linhas](#display-multiple-lines) que exibe informações do git na primeira linha e uma barra de contexto codificada por cores na segunda.

21 21 

22<Frame>22<Frame>

23 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Uma linha de status de múltiplas linhas mostrando nome do modelo, diretório, ramificação git na primeira linha, e uma barra de progresso de uso de contexto com custo e duração na segunda linha" width="776" height="212" data-path="images/statusline-multiline.png" />23 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Uma linha de status de múltiplas linhas mostrando nome do modelo, diretório, ramificação git na primeira linha, e uma barra de progresso de uso de contexto com custo e duração na segunda linha" width="1224" height="262" data-path="images/statusline-multiline.png" />

24</Frame>24</Frame>

25 25 

26Esta página orienta você sobre [configurar uma linha de status básica](#set-up-a-status-line), explica [como os dados fluem](#how-status-lines-work) do Claude Code para seu script, lista [todos os campos que você pode exibir](#available-data) e fornece [exemplos prontos para usar](#examples) para padrões comuns como status do git, rastreamento de custos e barras de progresso.26Esta página orienta você sobre [configurar uma linha de status básica](#set-up-a-status-line), explica [como os dados fluem](#how-status-lines-work) do Claude Code para seu script, lista [todos os campos que você pode exibir](#available-data) e fornece [exemplos prontos para usar](#examples) para padrões comuns como status do git, rastreamento de custos e barras de progresso.

93Estes exemplos usam scripts Bash, que funcionam no macOS e Linux. No Windows, consulte [Configuração do Windows](#windows-configuration) para exemplos de PowerShell e Git Bash.93Estes exemplos usam scripts Bash, que funcionam no macOS e Linux. No Windows, consulte [Configuração do Windows](#windows-configuration) para exemplos de PowerShell e Git Bash.

94 94 

95<Frame>95<Frame>

96 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-quickstart.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=696445e59ca0059213250651ad23db6b" alt="Uma linha de status mostrando nome do modelo, diretório e porcentagem de contexto" width="726" height="164" data-path="images/statusline-quickstart.png" />96 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-quickstart.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=88a7eab9c1038dd098ee8e284d96b7e6" alt="Uma linha de status mostrando nome do modelo, diretório e porcentagem de contexto" width="1224" height="224" data-path="images/statusline-quickstart.png" />

97</Frame>97</Frame>

98 98 

99<Steps>99<Steps>

444Exiba o modelo atual e o uso da janela de contexto com uma barra de progresso visual. Cada script lê JSON de stdin, extrai o campo `used_percentage` e constrói uma barra de 10 caracteres onde blocos preenchidos (▓) representam o uso:444Exiba o modelo atual e o uso da janela de contexto com uma barra de progresso visual. Cada script lê JSON de stdin, extrai o campo `used_percentage` e constrói uma barra de 10 caracteres onde blocos preenchidos (▓) representam o uso:

445 445 

446<Frame>446<Frame>

447 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-context-window-usage.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=15b58ab3602f036939145dde3165c6f7" alt="Uma linha de status mostrando nome do modelo e uma barra de progresso com porcentagem" width="448" height="152" data-path="images/statusline-context-window-usage.png" />447 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-context-window-usage.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f3918a549912dc47e90f2b69e68bc847" alt="Uma linha de status mostrando nome do modelo e uma barra de progresso com porcentagem" width="1224" height="224" data-path="images/statusline-context-window-usage.png" />

448</Frame>448</Frame>

449 449 

450<CodeGroup>450<CodeGroup>

513Mostre a ramificação git com indicadores codificados por cores para arquivos preparados e modificados. Este script usa [códigos de escape ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) para cores de terminal: `\033[32m` é verde, `\033[33m` é amarelo e `\033[0m` redefine para padrão.513Mostre a ramificação git com indicadores codificados por cores para arquivos preparados e modificados. Este script usa [códigos de escape ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) para cores de terminal: `\033[32m` é verde, `\033[33m` é amarelo e `\033[0m` redefine para padrão.

514 514 

515<Frame>515<Frame>

516 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-git-context.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e656f34f90d1d9a1d0e220988914345f" alt="Uma linha de status mostrando modelo, diretório, ramificação git e indicadores coloridos para arquivos preparados e modificados" width="742" height="178" data-path="images/statusline-git-context.png" />516 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-git-context.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f13c190724d9ec7188c17cd2f98b7bf4" alt="Uma linha de status mostrando modelo, diretório, ramificação git e indicadores coloridos para arquivos preparados e modificados" width="1224" height="224" data-path="images/statusline-git-context.png" />

517</Frame>517</Frame>

518 518 

519Cada script verifica se o diretório atual é um repositório git, conta arquivos preparados e modificados e exibe indicadores codificados por cores:519Cada script verifica se o diretório atual é um repositório git, conta arquivos preparados e modificados e exibe indicadores codificados por cores:

611Cada script formata o custo como moeda e converte milissegundos em minutos e segundos:611Cada script formata o custo como moeda e converte milissegundos em minutos e segundos:

612 612 

613<Frame>613<Frame>

614 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-cost-tracking.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e3444a51fe6f3440c134bd5f1f08ad29" alt="Uma linha de status mostrando nome do modelo, custo da sessão e duração" width="588" height="180" data-path="images/statusline-cost-tracking.png" />614 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-cost-tracking.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=925f7024c3b38be0f0eca63564bfb52f" alt="Uma linha de status mostrando nome do modelo, custo da sessão e duração" width="1224" height="224" data-path="images/statusline-cost-tracking.png" />

615</Frame>615</Frame>

616 616 

617<CodeGroup>617<CodeGroup>

672Seu script pode exibir múltiplas linhas para criar uma exibição mais rica.672Seu script pode exibir múltiplas linhas para criar uma exibição mais rica.

673 673 

674<Frame>674<Frame>

675 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Uma linha de status de múltiplas linhas mostrando nome do modelo, diretório, ramificação git na primeira linha, e uma barra de progresso de uso de contexto com custo e duração na segunda linha" width="776" height="212" data-path="images/statusline-multiline.png" />675 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Uma linha de status de múltiplas linhas mostrando nome do modelo, diretório, ramificação git na primeira linha, e uma barra de progresso de uso de contexto com custo e duração na segunda linha" width="1224" height="262" data-path="images/statusline-multiline.png" />

676</Frame>676</Frame>

677 677 

678Este exemplo combina várias técnicas: cores baseadas em limite (verde abaixo de 70%, amarelo 70-89%, vermelho 90%+), uma barra de progresso e informações de ramificação git. Cada instrução `print` ou `echo` cria uma linha separada:678Este exemplo combina várias técnicas: cores baseadas em limite (verde abaixo de 70%, amarelo 70-89%, vermelho 90%+), uma barra de progresso e informações de ramificação git. Cada instrução `print` ou `echo` cria uma linha separada:

781Este exemplo cria um link clicável para seu repositório GitHub. Mantenha Cmd (macOS) ou Ctrl (Windows/Linux) pressionado e clique para abrir o link em seu navegador.781Este exemplo cria um link clicável para seu repositório GitHub. Mantenha Cmd (macOS) ou Ctrl (Windows/Linux) pressionado e clique para abrir o link em seu navegador.

782 782 

783<Frame>783<Frame>

784 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-links.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=4bcc6e7deb7cf52f41ab85a219b52661" alt="Uma linha de status mostrando um link clicável para um repositório GitHub" width="726" height="198" data-path="images/statusline-links.png" />784 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-links.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=4778a144a28cb498c99d5fa018bb374a" alt="Uma linha de status mostrando um link clicável para um repositório GitHub" width="1224" height="224" data-path="images/statusline-links.png" />

785</Frame>785</Frame>

786 786 

787Cada script obtém a URL remota do git, converte o formato SSH para HTTPS e envolve o nome do repositório em códigos de escape OSC 8. A versão Bash usa `printf '%b'` que interpreta escapes de barra invertida de forma mais confiável que `echo -e` em diferentes shells:787Cada script obtém a URL remota do git, converte o formato SSH para HTTPS e envolve o nome do repositório em códigos de escape OSC 8. A versão Bash usa `printf '%b'` que interpreta escapes de barra invertida de forma mais confiável que `echo -e` em diferentes shells:

159 * Se `cd` sair desses diretórios, Claude Code redefine para o diretório do projeto e anexa `Shell cwd was reset to <dir>` ao resultado da ferramenta.159 * Se `cd` sair desses diretórios, Claude Code redefine para o diretório do projeto e anexa `Shell cwd was reset to <dir>` ao resultado da ferramenta.

160 * Para desabilitar esse carregamento de forma que cada comando Bash comece no diretório do projeto, defina `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.160 * Para desabilitar esse carregamento de forma que cada comando Bash comece no diretório do projeto, defina `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.

161* Variáveis de ambiente não persistem. Um `export` em um comando não estará disponível no próximo.161* Variáveis de ambiente não persistem. Um `export` em um comando não estará disponível no próximo.

162* Aliases e funções de shell definidas no arquivo de inicialização do seu shell estão disponíveis. No início da sessão, Claude Code carrega `~/.zshrc`, `~/.bashrc`, ou `~/.profile` dependendo do seu shell, captura os aliases, funções e opções de shell resultantes e os aplica a cada comando Bash.162* Aliases e funções de shell definidas no seu arquivo de inicialização de shell estão disponíveis. No início da sessão, Claude Code carrega `~/.zshrc`, `~/.bashrc`, ou `~/.profile` dependendo do seu shell, captura os aliases, funções e opções de shell resultantes e os aplica a cada comando Bash.

163 163 

164Ative seu virtualenv ou ambiente conda antes de iniciar Claude Code. Para fazer variáveis de ambiente persistirem entre comandos Bash, defina [`CLAUDE_ENV_FILE`](/docs/pt/env-vars) para um script de shell antes de iniciar Claude Code, ou use um [hook SessionStart](/docs/pt/hooks#persist-environment-variables) para preenchê-lo dinamicamente.164Ative seu virtualenv ou ambiente conda antes de iniciar Claude Code. Para fazer variáveis de ambiente persistirem entre comandos Bash, defina [`CLAUDE_ENV_FILE`](/docs/pt/env-vars) para um script de shell antes de iniciar Claude Code, ou use um [hook SessionStart](/docs/pt/hooks#persist-environment-variables) para preenchê-lo dinamicamente.

165 165 

167 Limites de timeout e saída167 Limites de timeout e saída

168</h3>168</h3>

169 169 

170Cada comando é executado sob um timeout, e Claude o gerencia: quando quer mais tempo do que o padrão para um comando, ele passa o parâmetro `timeout` com essa chamada. Você nunca define um timeout por comando.170Cada comando é executado sob um timeout, e Claude o gerencia: quando precisa de mais tempo do que o padrão para um comando, ele passa o parâmetro `timeout` com essa chamada. Você nunca define um timeout por comando.

171 171 

172Duas [variáveis de ambiente](/docs/pt/env-vars) controlam o que Claude obtém para um comando que é executado em primeiro plano:172Duas [variáveis de ambiente](/docs/pt/env-vars) controlam o que Claude obtém para um comando que é executado em primeiro plano:

173 173 

174* `BASH_DEFAULT_TIMEOUT_MS` — o padrão quando Claude não passa timeout; dois minutos por padrão174* `BASH_DEFAULT_TIMEOUT_MS` — o padrão quando Claude não passa timeout; dois minutos por padrão

175* `BASH_MAX_TIMEOUT_MS` — com o padrão, define o limite máximo que limita o que Claude solicita: o limite efetivo é o maior dos dois, dez minutos por padrão175* `BASH_MAX_TIMEOUT_MS` — com o padrão, define o limite máximo que limita o que Claude solicita: o limite efetivo é o maior dos dois, dez minutos por padrão

176 176 

177Para um comando que Claude inicia em segundo plano, `timeout` define por quanto tempo o comando pode ser executado lá, com o padrão e máximo separados descritos em [Comandos em segundo plano](#background-commands). A [ferramenta PowerShell](#powershell-tool) segue as mesmas regras de timeout e lê as mesmas duas variáveis.177Para um comando que Claude inicia em segundo plano, `timeout` define por quanto tempo o comando pode ser executado lá, com o padrão e máximo separados descritos em [Limite de tempo para comandos em segundo plano](#time-limit-for-background-commands). A [ferramenta PowerShell](#powershell-tool) segue as mesmas regras de timeout e lê as mesmas duas variáveis.

178 178 

179<h4 id="output-limits">179<h4 id="output-limits">

180 Limites de saída180 Limites de saída

185| Resultado | O que Claude obtém |185| Resultado | O que Claude obtém |

186| :- | :- |186| :- | :- |

187| Válido | Inline até aproximadamente 30.000 caracteres por padrão; além disso, o caminho de um arquivo salvo no diretório da sessão e truncado após 64 MiB, mais uma visualização de até os primeiros 2.000 caracteres, e Claude lê ou pesquisa o arquivo quando precisa do resto |187| Válido | Inline até aproximadamente 30.000 caracteres por padrão; além disso, o caminho de um arquivo salvo no diretório da sessão e truncado após 64 MiB, mais uma visualização de até os primeiros 2.000 caracteres, e Claude lê ou pesquisa o arquivo quando precisa do resto |

188| Falha | Inline até aproximadamente 10.000 caracteres; além disso, um trecho de cabeça e cauda desse tamanho cortado da janela de releitura, sem caminho de arquivo |188| Falha | Inline até aproximadamente 10.000 caracteres; além disso, um trecho de cabeçalho e cauda desse tamanho cortado da janela de releitura, sem caminho de arquivo |

189 189 

190Um comando que sai com código 1 conta como um resultado válido para a ferramenta Bash apenas quando Claude Code reconhece o código de saída 1 como um resultado benigno para esse comando: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test`, e `[`, mais `git diff` e `git grep`. Todo outro comando que sai com código 1 conta como uma falha, mesmo quando o código de saída 1 é um resultado informacional benigno: sem correspondências para `pgrep` e `jq -e`, arquivos que diferem para `cmp`.190Um comando que sai com código 1 conta como um resultado válido para a ferramenta Bash apenas quando Claude Code reconhece o código de saída 1 como um resultado benigno para esse comando: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test`, e `[`, mais `git diff` e `git grep`. Todo outro comando que sai com código 1 conta como uma falha, mesmo quando o código de saída 1 é um resultado informacional benigno: sem correspondências para `pgrep` e `jq -e`, arquivos que diferem para `cmp`.

191 191 

192[`BASH_MAX_OUTPUT_LENGTH`](/docs/pt/env-vars) define quantos caracteres de saída Claude Code relê do arquivo de trabalho para o resultado de um comando: 30.000 por padrão, até um limite máximo de 150.000. Aumente quando seus comandos rotineiramente ultrapassam essa janela, como um build verboso ou um log de suite de testes completo. Aumentá-lo amplia a janela de releitura, que também é a janela de onde um trecho de comando com falha é cortado. Não aumenta os limites inline: um resultado válido acima do limite inline chega como um caminho de arquivo mais visualização independentemente dessa variável.192[`BASH_MAX_OUTPUT_LENGTH`](/docs/pt/env-vars) define quantos caracteres de saída Claude Code relê do arquivo de trabalho para o resultado de um comando: 30.000 por padrão, até um limite máximo de 150.000. Aumente quando seus comandos rotineiramente ultrapassarem essa janela, como um build verboso ou um log de suite de testes completo. Aumentá-lo amplia a janela de releitura, que também é a janela de onde um trecho de comando com falha é cortado. Não aumenta os limites inline: um resultado válido acima do limite inline chega como um caminho de arquivo mais visualização independentemente dessa variável.

193 193 

194Para alterar quanto de um resultado válido Claude recebe inline, defina a configuração [`bashOutputMaxChars`](/docs/pt/settings-reference#bashoutputmaxchars) em vez disso, até 128.000 caracteres. Ela dimensiona o limite inline e a janela de releitura juntos, e Claude Code então ignora `BASH_MAX_OUTPUT_LENGTH`. Requer Claude Code v2.1.261 ou posterior.194Para alterar quanto de um resultado válido Claude recebe inline, defina a configuração [`bashOutputMaxChars`](/docs/pt/settings-reference#bashoutputmaxchars) em vez disso, até 128.000 caracteres. Ele dimensiona o limite inline e a janela de releitura juntos, e Claude Code então ignora `BASH_MAX_OUTPUT_LENGTH`. Requer Claude Code v2.1.261 ou posterior.

195 195 

196<h3 id="background-commands">196<h3 id="background-commands">

197 Comandos em segundo plano197 Comandos em segundo plano

198</h3>198</h3>

199 199 

200Para processos de longa duração, como servidores de desenvolvimento ou builds de observação, Claude pode definir `run_in_background: true` para iniciar o comando como uma tarefa em segundo plano e continuar trabalhando enquanto é executado. Liste e interrompa tarefas em segundo plano com `/tasks`. Depois que você interromper uma lá, ou de um cliente conectado como o aplicativo de desktop, Claude continua em vez de esperar. Se um subagentos iniciou o comando, é esse subagentos que continua.200Para processos de longa duração, como servidores de desenvolvimento ou builds de observação, Claude pode definir `run_in_background: true` para iniciar o comando como uma tarefa em segundo plano e continuar trabalhando enquanto é executado. Liste e interrompa tarefas em segundo plano com `/tasks`. Depois de interromper uma lá, ou de um cliente conectado como o aplicativo de desktop, Claude continua em vez de esperar. Se um subagentos iniciou o comando, é esse subagentos que continua.

201 201 

202Um comando que um [subagentos em primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) iniciou para quando a execução desse subagentos termina, independentemente de ter terminado, falhado ou sido interrompido. Um comando que a conversa principal ou um subagentos em segundo plano iniciou continua sendo executado após uma resposta final, até sair, ser interrompido ou atingir seu limite de tempo. No modo não interativo com a flag `-p`, [comandos em segundo plano terminam logo após o resultado final da execução](/docs/pt/headless#background-tasks-at-exit).202<h4 id="when-a-background-command-stops">

203 Quando um comando em segundo plano para

204</h4>

205 

206Um comando que um [subagentos em primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) iniciou para quando a execução desse subagentos termina, quer tenha terminado, falhado ou sido interrompido. Um comando que a conversa principal ou um subagentos em segundo plano iniciou continua sendo executado após uma resposta final, até sair, ser interrompido ou atingir seu [limite de tempo](#time-limit-for-background-commands). No modo não interativo com a flag `-p`, [comandos em segundo plano terminam logo após o resultado final da execução](/docs/pt/headless#background-tasks-at-exit).

207 

208<h4 id="time-limit-for-background-commands">

209 Limite de tempo para comandos em segundo plano

210</h4>

203 211 

204Comandos Bash e PowerShell em segundo plano têm um limite de tempo, contado a partir do momento em que o comando entra em segundo plano:212Comandos Bash e PowerShell em segundo plano têm um limite de tempo, contado a partir do momento em que o comando entra em segundo plano:

205 213 

206* Um comando que Claude inicia em segundo plano obtém 30 minutos, ou o `timeout` que Claude passa com `run_in_background`, até um máximo de 2 horas214* Um comando que Claude inicia em segundo plano obtém 30 minutos, ou o `timeout` que Claude passa com `run_in_background`, até um máximo de 2 horas

207* Um comando que começa em primeiro plano e depois se move para segundo plano, por exemplo com `Ctrl+B` ou em seu timeout, obtém 30 minutos a partir da mudança215* Um comando que começa em primeiro plano e depois se move para segundo plano, por exemplo com `Ctrl+B` ou em seu timeout, obtém 30 minutos a partir da mudança

208 216 

217Quando um comando em segundo plano atinge seu limite de tempo, Claude Code o interrompe e diz a Claude por quê, e Claude pode iniciar o comando novamente com um `timeout` mais longo se o trabalho ainda precisar. O aviso de parada lê `Background command "<description>" was stopped after reaching its background time limit`.

218 

219<h4 id="raise-the-time-limit-for-background-commands">

220 Aumente o limite de tempo para comandos em segundo plano

221</h4>

222 

209Duas [variáveis de ambiente](/docs/pt/env-vars) aumentam esses limites, para comandos Bash e PowerShell igualmente. Ambas usam milissegundos, e nenhuma pode encurtar um limite: um valor mais baixo deixa o padrão de 30 minutos e o máximo de 2 horas em vigor.223Duas [variáveis de ambiente](/docs/pt/env-vars) aumentam esses limites, para comandos Bash e PowerShell igualmente. Ambas usam milissegundos, e nenhuma pode encurtar um limite: um valor mais baixo deixa o padrão de 30 minutos e o máximo de 2 horas em vigor.

210 224 

211* Defina `BASH_DEFAULT_TIMEOUT_MS` acima de `1800000` para substituir o padrão de 30 minutos por esse valor, tanto para comandos que Claude inicia sem um `timeout` quanto para comandos movidos225* Defina `BASH_DEFAULT_TIMEOUT_MS` acima de `1800000` para substituir o padrão de 30 minutos por esse valor, tanto para comandos que Claude inicia sem um `timeout` quanto para comandos movidos

212* Defina `BASH_MAX_TIMEOUT_MS` acima de `7200000` para aumentar o máximo de 2 horas para esse valor. Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `7200000` aumenta o máximo da mesma forma226* Defina `BASH_MAX_TIMEOUT_MS` acima de `7200000` para aumentar o máximo de 2 horas para esse valor. Definir `BASH_DEFAULT_TIMEOUT_MS` acima de `7200000` aumenta o máximo da mesma forma

213 227 

214Quando um comando em segundo plano atinge seu limite de tempo, Claude Code o interrompe e diz a Claude por quê, e Claude pode iniciar o comando novamente com um `timeout` mais longo se o trabalho ainda precisar. O aviso de parada lê `Background command "<description>" was stopped after reaching its background time limit`.228<h4 id="foreground-commands-that-move-to-the-background">

229 Comandos em primeiro plano que se movem para segundo plano

230</h4>

215 231 

216Quando um comando em primeiro plano atinge seu timeout sem terminar, Claude Code o move para segundo plano em vez de interrompê-lo, a menos que o comando comece com `sleep`. O limite de tempo de um comando movido é contado a partir da mudança, e um comando movido de um subagentos em primeiro plano ainda para quando a execução desse subagentos termina.232Quando um comando em primeiro plano atinge seu timeout sem terminar, Claude Code o move para segundo plano em vez de interrompê-lo, a menos que o comando comece com `sleep`. O [limite de tempo](#time-limit-for-background-commands) de um comando movido é contado a partir da mudança, e um comando movido de um subagentos em primeiro plano ainda para quando a execução desse subagentos termina.

217 233 

218Definir [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/pt/env-vars#variables) desabilita o auto-backgrounding junto com o resto da funcionalidade de tarefas em segundo plano.234Definir [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/pt/env-vars#variables) desabilita o auto-backgrounding junto com o resto da funcionalidade de tarefas em segundo plano.

219 235 

220O resultado de um comando movido para segundo plano indica o que aconteceu:236O resultado de um comando movido para segundo plano declara o que aconteceu:

221 237 

222* Quando o timeout dispara a mudança, o resultado relata explicitamente: `Command did not complete within its 120s timeout and was moved to the background`, com os segundos correspondendo ao timeout que se aplicava, seguido pela ID da tarefa e o caminho do arquivo para o qual a saída está sendo escrita.238* Quando o timeout dispara a mudança, o resultado relata explicitamente: `Command did not complete within its 120s timeout and was moved to the background`, com os segundos correspondendo ao timeout que se aplicava, seguido pela ID da tarefa e o caminho do arquivo para o qual a saída está sendo escrita.

223* Um `cd`, `pushd`, `popd`, ou `chdir` dentro de um comando que é movido para segundo plano nunca é mantido: o resultado afirma `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, então Claude não age em uma mudança de diretório que não aconteceu.239* Um `cd`, `pushd`, `popd`, ou `chdir` dentro de um comando que é movido para segundo plano nunca é mantido: o resultado declara `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, então Claude não age em uma mudança de diretório que não aconteceu.

224 240 

225<h3 id="memory-limit-on-linux-and-wsl">241<h3 id="memory-limit-on-linux-and-wsl">

226 Limite de memória em Linux e WSL242 Limite de memória no Linux e WSL

227</h3>243</h3>

228 244 

229Em Linux e WSL, defina [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/pt/env-vars#variables) para um tamanho como `4G` para limitar a memória que comandos Bash, PowerShell e [Monitor](#monitor-tool) podem usar, para que um build descontrolado não consuma a memória que o resto da sessão precisa. Requer Claude Code v2.1.233 ou posterior. Antes de v2.1.246, comandos da ferramenta Monitor eram executados fora do limite.245No Linux e WSL, defina [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/pt/env-vars#variables) para um tamanho como `4G` para limitar a memória que comandos Bash, PowerShell e [Monitor](#monitor-tool) podem usar, para que um build descontrolado não consuma a memória que o resto da sessão precisa. Requer Claude Code v2.1.233 ou posterior. Antes de v2.1.246, comandos da ferramenta Monitor eram executados fora do limite.

230 246 

231* Escreva o tamanho como um número de bytes ou com um sufixo `K`, `M`, `G`, ou `T`. Defina `0`, `off`, `false`, `no`, ou `none` para desativar o limite. Claude Code ignora qualquer outro valor que não consiga ler como um tamanho, como `4e9`.247* Escreva o tamanho como um número de bytes ou com um sufixo `K`, `M`, `G`, ou `T`. Defina `0`, `off`, `false`, `no`, ou `none` para desativar o limite. Claude Code ignora qualquer outro valor que não consiga ler como um tamanho, como `4e9`.

232* Claude Code conta todos os comandos Bash, PowerShell e Monitor de uma sessão contra o único limite, não cada comando por si só.248* Claude Code conta todos os comandos Bash, PowerShell e Monitor de uma sessão contra o único limite, não cada comando por si só.

247 263 

248* **Nomes desconhecidos**: Claude Code ignora nomes que não reconhece264* **Nomes desconhecidos**: Claude Code ignora nomes que não reconhece

249* **Bash, PowerShell e Monitor**: Claude Code mantém comandos Bash, PowerShell e Monitor tool sob o limite seja qual for sua lista265* **Bash, PowerShell e Monitor**: Claude Code mantém comandos Bash, PowerShell e Monitor tool sob o limite seja qual for sua lista

250* **Variável não definida**: Claude Code pega o conjunto de outros tipos limitados da configuração que Anthropic entrega do servidor, e esse conjunto pode mudar ao longo do tempo, então defina a variável quando você precisa de um conjunto que não muda266* **Variável não definida**: Claude Code pega o conjunto de outros tipos limitados da configuração que Anthropic entrega do servidor, e esse conjunto pode mudar ao longo do tempo, então defina a variável quando precisar de um conjunto que não mude

251* **Hooks com permissão**: mesmo com cada tipo limitado, Claude Code exclui do limite um hook que pode bloquear ou alterar o resultado de uma ação, e qualquer servidor MCP que tal hook chama, então o kernel matando um hook com permissão não pode permitir a ação que estava bloqueando267* **Hooks com permissão**: mesmo com cada tipo limitado, Claude Code exclui do limite um hook que pode bloquear ou alterar o resultado de uma ação, e qualquer servidor MCP que tal hook chama, então o kernel matando um hook com permissão não pode permitir a ação que estava bloqueando

252 268 

253<h2 id="edit-tool-behavior">269<h2 id="edit-tool-behavior">

362 362 

363Na aba Plugins:363Na aba Plugins:

364 364 

365* **Plugins instalados** aparecem no topo com interruptores de alternância para ativá-los ou desativá-los365* **Plugins instalados** aparecem no topo com interruptores de alternância para ativá-los ou desativá-los.

366 * Se você desativar um plugin que o arquivo `.claude/settings.json` compartilhado do seu projeto ativa, a extensão pergunta primeiro: **Desativar para mim** o desativa apenas para você, enquanto **Desativar para todos** altera o arquivo compartilhado.

366* **Plugins disponíveis** de seus marketplaces configurados aparecem abaixo367* **Plugins disponíveis** de seus marketplaces configurados aparecem abaixo

367* Pesquise para filtrar plugins por nome ou descrição368* Pesquise para filtrar plugins por nome ou descrição

368* Clique em **Instalar** em qualquer plugin disponível369* Clique em **Instalar** em qualquer plugin disponível

373* **Instalar para este projeto**: compartilhado com colaboradores do projeto (escopo de projeto)374* **Instalar para este projeto**: compartilhado com colaboradores do projeto (escopo de projeto)

374* **Instalar localmente**: apenas para você, apenas neste repositório (escopo local)375* **Instalar localmente**: apenas para você, apenas neste repositório (escopo local)

375 376 

377Após a conclusão da instalação, um formulário solicita qualquer uma das [opções de configuração](/docs/pt/plugins/components#user-configuration) do plugin que ainda não estão definidas. Para revisar ou alterar as opções posteriormente, clique no ícone de engrenagem na linha do plugin.

378 

379Os campos de texto sensíveis são mascarados, e um segredo que você salvou anteriormente mostra **(inalterado)**. Deixe o campo em branco para manter o valor salvo.

380 

381Depois de salvar as alterações, as sessões abertas recarregam seus plugins e o diálogo mostra **Reinicie Claude para aplicar alterações de plugin**.

382 

383<h3 id="uninstall-plugins">

384 Desinstalar plugins

385</h3>

386 

387Cada linha instalada nomeia o [escopo](/docs/pt/plugins/install#choose-an-install-scope) em que está instalada. Para desinstalar essa instalação, clique no ícone de lixeira da linha. Um ícone de lixeira esmaecido marca uma linha que você não pode desinstalar deste workspace, como um plugin que sua organização gerencia ou um instalado para outro projeto.

388 

389A extensão pergunta primeiro em dois casos:

390 

391* **Um plugin que o arquivo `.claude/settings.json` compartilhado do seu projeto ativa**: escolha **Desativar para mim**, que mantém o plugin instalado para seus colaboradores, ou **Desinstalar para todos**, que remove a instalação do projeto com [`--keep-data`](/docs/pt/plugins/cli-reference#what-an-uninstall-deletes-and-keeps), para que o diretório de dados salvos do plugin permaneça. Se você já desativou o plugin para si mesmo, o ícone de lixeira remove sua própria instalação sem a pergunta.

392* **Caso contrário, a última instalação de um plugin com dados salvos**: escolha se deseja manter ou excluir os dados; **Manter** é o padrão

393 

376<h3 id="share-a-plugin-install-link">394<h3 id="share-a-plugin-install-link">

377 Compartilhar um link de instalação de plugin395 Compartilhar um link de instalação de plugin

378</h3>396</h3>

407 425 

408* Digite um repositório GitHub, URL ou caminho local para adicionar um novo marketplace426* Digite um repositório GitHub, URL ou caminho local para adicionar um novo marketplace

409* Clique no ícone de atualização para atualizar a lista de plugins de um marketplace427* Clique no ícone de atualização para atualizar a lista de plugins de um marketplace

410* Clique no ícone de lixeira para remover um marketplace428* Clique no ícone de lixeira para remover um marketplace. Removê-lo [desinstala todos os plugins que você instalou dele](/docs/pt/plugins/install#manage-marketplaces), portanto uma confirmação nomeia esses plugins primeiro

429 

430As alterações de plugin que você faz no diálogo se aplicam imediatamente às sessões Claude Code abertas naquela janela VS Code.

411 431 

412As alterações de plugin que você faz no diálogo se aplicam imediatamente às sessões Claude Code abertas naquela janela VS Code. Se a sessão a partir da qual você abriu o diálogo não conseguir recarregar seus plugins, o diálogo oferece tentar novamente ou reiniciar Claude naquela sessão.432Se a sessão a partir da qual você abriu o diálogo não conseguir recarregar seus plugins, o diálogo oferece tentar novamente ou reiniciar Claude naquela sessão.

413 433 

414<Note>434<Note>

415 O gerenciamento de plugins no VS Code usa os mesmos comandos CLI sob o capô. Plugins e marketplaces que você configura na extensão também estão disponíveis na CLI, e vice-versa.435 O gerenciamento de plugins no VS Code usa os mesmos comandos CLI sob o capô. Plugins e marketplaces que você configura na extensão também estão disponíveis na CLI, e vice-versa.