SpyBara
Go Premium

Documentation 2026-06-22 23:59 UTC to 2026-06-23 22:00 UTC

45 files changed +2,103 −99. View all changes and history on the product overview
2026
Thu 25 06:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51
Details

86`settingSources` cobre configurações de usuário, projeto e local. Algumas entradas são lidas independentemente de seu valor:86`settingSources` cobre configurações de usuário, projeto e local. Algumas entradas são lidas independentemente de seu valor:

87 87 

88| Entrada | Comportamento | Para desabilitar |88| Entrada | Comportamento | Para desabilitar |

89| :-------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------- |89| :-------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

90| Configurações de política gerenciada | Sempre carregadas quando presentes no host | Remova o arquivo de configurações gerenciadas |90| Configurações de política gerenciada | Sempre carregadas quando presentes no host | Remova o arquivo de configurações gerenciadas |

91| Configuração global `~/.claude.json` | Sempre lida | Relocalize com `CLAUDE_CONFIG_DIR` em `env` |91| Configuração global `~/.claude.json` | Sempre lida | Relocalize com `CLAUDE_CONFIG_DIR` em `env` |

92| Memória automática em `~/.claude/projects/<project>/memory/` | Carregada por padrão no prompt do sistema | Defina `autoMemoryEnabled: false` nas configurações, ou `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` em `env` |92| Memória automática em `~/.claude/projects/<project>/memory/` | Carregada por padrão no prompt do sistema | Defina `autoMemoryEnabled: false` nas configurações, ou `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` em `env` |

93| [Conectores MCP do claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) | Carregados quando o método de autenticação ativo é uma assinatura do claude.ai. Passar `mcpServers: {}` não os suprime | Defina `strictMcpConfig: true`, ou `ENABLE_CLAUDEAI_MCP_SERVERS=false` em `env` |93| [Conectores MCP do claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) | Carregados quando o método de autenticação ativo é uma assinatura do claude.ai. Passar `mcpServers: {}` não os suprime | Defina `strictMcpConfig: true`, [`disableClaudeAiConnectors: true`](/pt/mcp#disable-claude-ai-connectors) nas configurações, ou `ENABLE_CLAUDEAI_MCP_SERVERS=false` em `env` |

94 94 

95<Warning>95<Warning>

96 Não confie nas opções padrão de `query()` para isolamento multi-tenant. Porque as entradas acima são lidas independentemente de `settingSources`, um processo SDK pode pegar configuração de nível de host e memória por diretório. Para implantações multi-tenant, execute cada tenant em seu próprio sistema de arquivos e defina `settingSources: []` mais `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` em `env`. Veja [Implantação segura](/pt/agent-sdk/secure-deployment).96 Não confie nas opções padrão de `query()` para isolamento multi-tenant. Porque as entradas acima são lidas independentemente de `settingSources`, um processo SDK pode pegar configuração de nível de host e memória por diretório. Para implantações multi-tenant, execute cada tenant em seu próprio sistema de arquivos e defina `settingSources: []` mais `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` em `env`. Veja [Implantação segura](/pt/agent-sdk/secure-deployment).

Details

958```958```

959 959 

960* `API_TIMEOUT_MS`: timeout por solicitação no cliente Anthropic, em milissegundos. Padrão `600000`. Aplica-se ao loop principal e a todos os subagentes.960* `API_TIMEOUT_MS`: timeout por solicitação no cliente Anthropic, em milissegundos. Padrão `600000`. Aplica-se ao loop principal e a todos os subagentes.

961* `CLAUDE_CODE_MAX_RETRIES`: máximo de tentativas de API. Padrão `10`. Cada tentativa obtém sua própria janela `API_TIMEOUT_MS`, então o tempo de parede no pior caso é aproximadamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` mais backoff.961* `CLAUDE_CODE_MAX_RETRIES`: máximo de tentativas de API. Padrão `10`, limitado a `15`. Cada tentativa obtém sua própria janela `API_TIMEOUT_MS`, então o tempo de parede no pior caso é aproximadamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` mais backoff. Para execuções autônomas que precisam aguardar interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG=1` para tentar capacidade de erros indefinidamente.

962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog de travamento para subagentes lançados com `run_in_background`. Padrão `600000`. Redefine em cada evento de stream; em caso de travamento, aborta o subagente, marca a tarefa como falha e expõe o erro ao pai com qualquer resultado parcial. Não se aplica a subagentes síncronos.962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog de travamento para subagentes lançados com `run_in_background`. Padrão `600000`. Redefine em cada evento de stream; em caso de travamento, aborta o subagente, marca a tarefa como falha e expõe o erro ao pai com qualquer resultado parcial. Não se aplica a subagentes síncronos.

963* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborta a solicitação quando os cabeçalhos chegaram mas o corpo da resposta para de fazer stream. Quando `CLAUDE_ENABLE_STREAM_WATCHDOG` não está definido, o padrão é controlado pelo servidor na API Anthropic direta e desativado em outros provedores. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` padrão é `300000` e é fixado nesse mínimo. A solicitação abortada passa pelo caminho de tentativa normal.963* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborta a solicitação quando os cabeçalhos chegaram mas o corpo da resposta para de fazer stream. Quando `CLAUDE_ENABLE_STREAM_WATCHDOG` não está definido, o padrão é controlado pelo servidor na API Anthropic direta e desativado em outros provedores. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` padrão é `300000` e é fixado nesse mínimo. A solicitação abortada passa pelo caminho de tentativa normal.

964 964 

Details

196No SDK Python, esses nomes de campo usam camelCase para corresponder ao formato de transmissão. Veja a referência [`AgentDefinition`](/pt/agent-sdk/python#agentdefinition) para detalhes.196No SDK Python, esses nomes de campo usam camelCase para corresponder ao formato de transmissão. Veja a referência [`AgentDefinition`](/pt/agent-sdk/python#agentdefinition) para detalhes.

197 197 

198<Note>198<Note>

199 {/* min-version: 2.1.172 */}A partir do Claude Code v2.1.172, subagentes podem gerar seus próprios subagentes. Um subagente de fundo cinco níveis abaixo do agente principal não pode gerar mais subagentes; subagentes em primeiro plano podem gerar em qualquer profundidade. Para evitar que um subagente gere outros, omita `Agent` de seu array `tools` ou adicione-o a `disallowedTools`. Veja [subagentes aninhados](/pt/sub-agents#spawn-nested-subagents) para as regras de profundidade completas.199 {/* min-version: 2.1.172 */}A partir do Claude Code v2.1.172, subagentes podem gerar seus próprios subagentes. Um subagente cinco níveis abaixo do agente principal não pode gerar mais subagentes, independentemente de ser executado em primeiro plano ou em fundo. Para evitar que um subagente gere outros, omita `Agent` de seu array `tools` ou adicione-o a `disallowedTools`. Veja [subagentes aninhados](/pt/sub-agents#spawn-nested-subagents) para as regras de profundidade completas.

200</Note>200</Note>

201 201 

202<h3 id="filesystem-based-definition-alternative">202<h3 id="filesystem-based-definition-alternative">

Details

551```551```

552 552 

553* `API_TIMEOUT_MS`: timeout por solicitação no cliente Anthropic, em milissegundos. Padrão `600000`. Aplica-se ao loop principal e a todos os subagentes.553* `API_TIMEOUT_MS`: timeout por solicitação no cliente Anthropic, em milissegundos. Padrão `600000`. Aplica-se ao loop principal e a todos os subagentes.

554* `CLAUDE_CODE_MAX_RETRIES`: máximo de tentativas de API. Padrão `10`. Cada tentativa obtém sua própria janela `API_TIMEOUT_MS`, então o tempo de parede no pior caso é aproximadamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` mais backoff.554* `CLAUDE_CODE_MAX_RETRIES`: máximo de tentativas de API. Padrão `10`, limitado a `15`. Cada tentativa obtém sua própria janela `API_TIMEOUT_MS`, então o tempo de parede no pior caso é aproximadamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` mais backoff. Para execuções sem supervisão que precisam aguardar através de interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG=1` para tentar capacidade de erros indefinidamente.

555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog de travamento para subagentes lançados com `run_in_background`. Padrão `600000`. Redefine em cada evento de stream; em caso de travamento, aborta o subagente, marca a tarefa como falhada e expõe o erro ao pai com qualquer resultado parcial. Não se aplica a subagentes síncronos.555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog de travamento para subagentes lançados com `run_in_background`. Padrão `600000`. Redefine em cada evento de stream; em caso de travamento, aborta o subagente, marca a tarefa como falhada e expõe o erro ao pai com qualquer resultado parcial. Não se aplica a subagentes síncronos.

556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborta a solicitação quando os cabeçalhos chegaram mas o corpo da resposta para de fazer stream. Quando `CLAUDE_ENABLE_STREAM_WATCHDOG` não está definido, o padrão é controlado pelo servidor na API Anthropic direta e desativado em outros provedores. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` padrão é `300000` e é fixado nesse mínimo. A solicitação abortada passa pelo caminho de tentativa normal.556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: aborta a solicitação quando os cabeçalhos chegaram mas o corpo da resposta para de fazer stream. Quando `CLAUDE_ENABLE_STREAM_WATCHDOG` não está definido, o padrão é controlado pelo servidor na API Anthropic direta e desativado em outros provedores. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` padrão é `300000` e é fixado nesse mínimo. A solicitação abortada passa pelo caminho de tentativa normal.

557 557 


1418```1418```

1419 1419 

1420| `kind` | Significado |1420| `kind` | Significado |

1421| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1421| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1422| `human` | Entrada direta do usuário final. Em mensagens de usuário, uma `origin` ausente também significa entrada humana. |1422| `human` | Entrada direta do usuário final. Em mensagens de usuário, uma `origin` ausente também significa entrada humana. |

1423| `channel` | Mensagem chegando em um [canal](/pt/channels). `server` é o nome do servidor MCP de origem. |1423| `channel` | Mensagem chegando em um [canal](/pt/channels). `server` é o nome do servidor MCP de origem. |

1424| `peer` | Reservado para mensagens de outra sessão de agente. `from` é o endereço do remetente e `name` é o nome de exibição do remetente quando disponível. `senderTaskId` é o ID da tarefa do subagente em processo em segundo plano que enviou a mensagem; ausente para pares entre sessões. O Agent SDK não emite essa origem; trate como uma origem desconhecida. |1424| `peer` | Mensagem de outro agente. Para um [colega de equipe](/pt/agent-teams) em processo enviando para `main` via `SendMessage`, `from` é o nome do colega de equipe e `senderTaskId` é seu ID de tarefa. Para um par entre sessões, como outro processo Claude Code local, `from` é o endereço do remetente e `senderTaskId` está ausente. O campo `name` é reservado. |

1425| `task-notification` | Turno sintético injetado após a conclusão de uma tarefa em segundo plano. Consulte [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |1425| `task-notification` | Turno sintético injetado após a conclusão de uma tarefa em segundo plano. Consulte [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |

1426| `coordinator` | Mensagem de um coordenador de equipe em uma [equipe de agente](/pt/agent-teams). |1426| `coordinator` | Mensagem de um coordenador de equipe em uma [equipe de agente](/pt/agent-teams). |

1427| `auto-continuation` | Turno sintético injetado quando a sessão continua sem entrada de usuário nova, como um resultado de comando que aciona um prompt de acompanhamento. |1427| `auto-continuation` | Turno sintético injetado quando a sessão continua sem entrada de usuário nova, como um resultado de comando que aciona um prompt de acompanhamento. |


3654 status: "allowed" | "allowed_warning" | "rejected";3654 status: "allowed" | "allowed_warning" | "rejected";

3655 resetsAt?: number;3655 resetsAt?: number;

3656 utilization?: number;3656 utilization?: number;

3657 errorCode?: "credits_required";

3658 canUserPurchaseCredits?: boolean;

3659 hasChargeableSavedPaymentMethod?: boolean;

3657 };3660 };

3658 uuid: UUID;3661 uuid: UUID;

3659 session_id: string;3662 session_id: string;

3660};3663};

3661```3664```

3662 3665 

3666{/* min-version: 2.1.181 */}Quando `errorCode` é `"credits_required"`, a rejeição é de uma assinatura claude.ai cujo uso incluído está esgotado, e a sessão não pode continuar até que o usuário compre créditos de uso. `canUserPurchaseCredits` indica se o usuário autenticado pode comprar créditos para a conta, e `hasChargeableSavedPaymentMethod` indica se um método de pagamento salvo está registrado. Todos os três campos estão ausentes em eventos de limite de taxa que não são rejeições de créditos necessários. Requer Claude Code v2.1.181 ou posterior.

3667 

3663<h3 id="sdklocalcommandoutputmessage">3668<h3 id="sdklocalcommandoutputmessage">

3664 `SDKLocalCommandOutputMessage`3669 `SDKLocalCommandOutputMessage`

3665</h3>3670</h3>

agent-teams.md +20 −9

Details

90 90 

91A partir daí, Claude popula uma [lista de tarefas compartilhada](/pt/interactive-mode#task-list), cria companheiros de equipe para cada perspectiva, faz com que explorem o problema e sintetiza descobertas quando terminar.91A partir daí, Claude popula uma [lista de tarefas compartilhada](/pt/interactive-mode#task-list), cria companheiros de equipe para cada perspectiva, faz com que explorem o problema e sintetiza descobertas quando terminar.

92 92 

93O terminal do líder lista todos os companheiros de equipe e no que estão trabalhando. Use Shift+Down para percorrer os companheiros de equipe e envie mensagens para eles diretamente. Após o último companheiro de equipe, Shift+Down volta para o líder.93O terminal do líder lista companheiros de equipe no painel do agente abaixo da entrada do prompt. A partir do painel:

94 

95* **Setas para cima e para baixo**: selecione um companheiro de equipe

96* **Enter**: abra a transcrição do companheiro de equipe selecionado e envie uma mensagem diretamente

97* **Escape**: interrompa o turno atual do companheiro de equipe selecionado

98 

99{/* min-version: 2.1.181 */}A partir da v2.1.181, a linha de um companheiro de equipe ocioso se oculta após 30 segundos e reaparece em seu próximo turno. O companheiro de equipe continua em execução e endereçável enquanto oculto.

94 100 

95Se você quiser cada companheiro de equipe em seu próprio painel dividido, veja [Escolha um modo de exibição](#choose-a-display-mode).101Se você quiser cada companheiro de equipe em seu próprio painel dividido, veja [Escolha um modo de exibição](#choose-a-display-mode).

96 102 


106 112 

107Equipes de agentes suportam dois modos de exibição:113Equipes de agentes suportam dois modos de exibição:

108 114 

109* **In-process**: todos os companheiros de equipe são executados dentro do seu terminal principal. Use Shift+Down para percorrer os companheiros de equipe e digite para enviar mensagens para eles diretamente. Funciona em qualquer terminal, nenhuma configuração extra necessária.115* **In-process**: todos os companheiros de equipe são executados dentro do seu terminal principal. Use as teclas de seta para cima e para baixo no painel de agentes para selecionar um companheiro de equipe, depois pressione Enter para visualizá-lo e digite para enviar mensagens para ele diretamente. Funciona em qualquer terminal, nenhuma configuração extra necessária.

110* **Split panes**: cada companheiro de equipe recebe seu próprio painel. Você pode ver a saída de todos de uma vez e clicar em um painel para interagir diretamente. Requer tmux ou iTerm2.116* **Split panes**: cada companheiro de equipe recebe seu próprio painel. Você pode ver a saída de todos de uma vez e clicar em um painel para interagir diretamente. Requer tmux ou iTerm2.

111 117 

112<Note>118<Note>

113 `tmux` tem limitações conhecidas em certos sistemas operacionais e tradicionalmente funciona melhor no macOS. Usar `tmux -CC` no iTerm2 é o ponto de entrada sugerido para `tmux`.119 `tmux` tem limitações conhecidas em certos sistemas operacionais e tradicionalmente funciona melhor no macOS. Usar `tmux -CC` no iTerm2 é o ponto de entrada sugerido para `tmux`.

114</Note>120</Note>

115 121 

116O padrão é `"auto"`, que usa split panes se você já estiver executando dentro de uma sessão tmux ou seu terminal for iTerm2, e in-process caso contrário. A configuração `"tmux"` ativa o modo split-pane e detecta automaticamente se deve usar tmux ou iTerm2 com base no seu terminal. Para substituir, defina [`teammateMode`](/pt/settings#available-settings) em `~/.claude/settings.json`:122O padrão é `"in-process"`. Antes da v2.1.179, o padrão era `"auto"`, portanto sessões atualizadas que anteriormente abriam split panes agora permanecem em um terminal, a menos que você defina o modo explicitamente. Defina `"auto"` para ativar split panes quando você já estiver executando dentro de uma sessão tmux ou seu terminal for iTerm2, voltando para in-process caso contrário. A configuração `"tmux"` ativa o modo split-pane e detecta automaticamente se deve usar tmux ou iTerm2 com base no seu terminal.

123 

124{/* min-version: 2.1.186 */}A partir da v2.1.186, defina `"iterm2"` para usar explicitamente split panes nativos do iTerm2. Este modo requer o [CLI `it2`](https://github.com/mkusaka/it2) e mostra um erro com o comando de instalação se `it2` estiver faltando. O prompt de configuração que oferece instalar `it2` ou mudar para tmux aparece em `"auto"` ou `"tmux"` quando seu terminal é iTerm2 e tmux está disponível como fallback.

125 

126Para substituir o padrão, defina [`teammateMode`](/pt/settings#available-settings) em `~/.claude/settings.json`:

117 127 

118```json theme={null}128```json theme={null}

119{129{

120 "teammateMode": "in-process"130 "teammateMode": "auto"

121}131}

122```132```

123 133 

124Para forçar o modo in-process para uma única sessão, passe como um sinalizador:134Para definir o modo para uma única sessão, passe como um sinalizador:

125 135 

126```bash theme={null}136```bash theme={null}

127claude --teammate-mode in-process137claude --teammate-mode auto

128```138```

129 139 

130O modo split-pane requer [tmux](https://github.com/tmux/tmux/wiki) ou iTerm2 com o CLI [`it2`](https://github.com/mkusaka/it2). Para instalar manualmente:140O modo split-pane requer [tmux](https://github.com/tmux/tmux/wiki) ou iTerm2 com o CLI [`it2`](https://github.com/mkusaka/it2). Para instalar manualmente:


166 176 

167Cada companheiro de equipe é uma sessão Claude Code completa e independente. Você pode enviar mensagens para qualquer companheiro de equipe diretamente para dar instruções adicionais, fazer perguntas de acompanhamento ou redirecionar sua abordagem.177Cada companheiro de equipe é uma sessão Claude Code completa e independente. Você pode enviar mensagens para qualquer companheiro de equipe diretamente para dar instruções adicionais, fazer perguntas de acompanhamento ou redirecionar sua abordagem.

168 178 

169* **Modo in-process**: use Shift+Down para percorrer os companheiros de equipe, depois digite para enviar uma mensagem. Pressione Enter para visualizar a sessão de um companheiro de equipe, depois Escape para interromper seu turno atual. Pressione Ctrl+T para alternar a lista de tarefas.179* **Modo in-process**: use as teclas de seta para cima e para baixo no painel de agentes para selecionar um companheiro de equipe, depois pressione Enter para visualizar sua sessão e digite para enviar uma mensagem. Pressione `x` em um companheiro de equipe selecionado para interrompê-lo. Pressione Ctrl+T para alternar a lista de tarefas.

170* **Modo split-pane**: clique em um painel de companheiro de equipe para interagir com sua sessão diretamente. Cada companheiro de equipe tem uma visualização completa de seu próprio terminal.180* **Modo split-pane**: clique em um painel de companheiro de equipe para interagir com sua sessão diretamente. Cada companheiro de equipe tem uma visualização completa de seu próprio terminal.

171 181 

172<h3 id="assign-and-claim-tasks">182<h3 id="assign-and-claim-tasks">


422 432 

423Se os companheiros de equipe não aparecerem depois que você pedir ao Claude para criar uma equipe:433Se os companheiros de equipe não aparecerem depois que você pedir ao Claude para criar uma equipe:

424 434 

425* No modo in-process, os companheiros de equipe podem estar em execução, mas não visíveis. Pressione Shift+Down para percorrer os companheiros de equipe ativos.435* No modo in-process, os companheiros de equipe aparecem no painel de agentes abaixo da entrada de prompt. Use as teclas de seta para cima e para baixo para selecionar um e pressione Enter para visualizá-lo.

436* Uma linha de companheiro de equipe que desapareceu após ficar inativa foi ocultada, não interrompida. As linhas inativas se ocultam após 30 segundos e reaparecem na próxima vez do companheiro de equipe. Envie uma mensagem ao companheiro de equipe pelo nome para trazê-lo de volta.

426* Verifique se a tarefa que você deu ao Claude era complexa o suficiente para justificar uma equipe. Claude decide se deve gerar companheiros de equipe com base na tarefa.437* Verifique se a tarefa que você deu ao Claude era complexa o suficiente para justificar uma equipe. Claude decide se deve gerar companheiros de equipe com base na tarefa.

427* Se você explicitamente solicitou split panes, certifique-se de que tmux está instalado e disponível no seu PATH:438* Se você explicitamente solicitou split panes, certifique-se de que tmux está instalado e disponível no seu PATH:

428 ```bash theme={null}439 ```bash theme={null}


440 Companheiros de equipe parando em erros451 Companheiros de equipe parando em erros

441</h3>452</h3>

442 453 

443Os companheiros de equipe podem parar após encontrar erros em vez de se recuperar. Verifique sua saída usando Shift+Down no modo in-process ou clicando no painel no modo split, depois:454Os companheiros de equipe podem parar após encontrar erros em vez de se recuperar. Verifique sua saída selecionando o companheiro de equipe no painel de agentes e pressionando Enter no modo in-process, ou clicando no painel no modo split, depois:

444 455 

445* Dê a eles instruções adicionais diretamente456* Dê a eles instruções adicionais diretamente

446* Gere um companheiro de equipe de substituição para continuar o trabalho457* Gere um companheiro de equipe de substituição para continuar o trabalho

agent-view.md +37 −4

Details

281| `#<number>` ou uma URL de pull request | Se uma sessão já está trabalhando naquele PR, selecione-a em vez de despachar |281| `#<number>` ou uma URL de pull request | Se uma sessão já está trabalhando naquele PR, selecione-a em vez de despachar |

282| `Shift+Enter` | Despachar e anexar imediatamente à nova sessão |282| `Shift+Enter` | Despachar e anexar imediatamente à nova sessão |

283 283 

284Um pequeno conjunto de comandos é executado em agent view em vez de ser despachado: `/exit` e `/quit` fecham agent view, e `/logout` desconecta você. Todos os outros comandos e skills são enviados para uma nova sessão em background como seu primeiro prompt.284Um pequeno conjunto de comandos é executado em agent view em vez de ser despachado: `/exit` e `/quit` fecham agent view, `/logout` desconecta você, e `/model` define o [modelo de despacho](#set-the-model). Skills, seus próprios comandos e built-ins que expandem prompts como `/init` são enviados para uma nova sessão em background como seu primeiro prompt. Outros comandos built-in mostram uma dica `attach to a session to run it` em vez disso.

285 285 

286Empacotar uma tarefa recorrente como uma [skill](/pt/skills) permite que você inicie o mesmo fluxo de trabalho a partir de agent view repetidamente sem redigitar o prompt.286Empacotar uma tarefa recorrente como uma [skill](/pt/skills) permite que você inicie o mesmo fluxo de trabalho a partir de agent view repetidamente sem redigitar o prompt.

287 287 


412 412 

413O nome do modelo mostrado no cabeçalho de agent view é o padrão de despacho. Novas sessões que você inicia a partir da entrada usam este modelo, que vem da configuração [`model`](/pt/settings#available-settings) em suas settings de usuário. Defina-o selecionando um modelo no seletor [`/model`](/pt/model-config), ou edite a configuração diretamente. Para substituir para toda a sessão de agent view, passe `--model` ao abrir agent view. Veja [Permission mode, model, and effort](#permission-mode-model-and-effort).413O nome do modelo mostrado no cabeçalho de agent view é o padrão de despacho. Novas sessões que você inicia a partir da entrada usam este modelo, que vem da configuração [`model`](/pt/settings#available-settings) em suas settings de usuário. Defina-o selecionando um modelo no seletor [`/model`](/pt/model-config), ou edite a configuração diretamente. Para substituir para toda a sessão de agent view, passe `--model` ao abrir agent view. Veja [Permission mode, model, and effort](#permission-mode-model-and-effort).

414 414 

415Para alterar o padrão de despacho de dentro de agent view, digite `/model` seguido de um nome de modelo na entrada de despacho e pressione `Enter`. O cabeçalho é atualizado para mostrar esse modelo com um marcador `(session)`, e as sessões que você despacha depois usam-no. Digite `/model default` para limpar a substituição e retornar ao padrão de despacho. Essa substituição dura o resto da execução atual de `claude agents`, não escreve no seu arquivo de settings e requer Claude Code v2.1.172 ou posterior. {/* min-version: 2.1.172 */} O exemplo a seguir despacha uma sessão em Opus e a próxima em Sonnet:

416 

417```text theme={null}

418/model opus

419refactor auth

420/model sonnet

421run the test suite

422```

423 

415Cada sessão em background pode ser executada em um modelo diferente. Para substituir para uma sessão:424Cada sessão em background pode ser executada em um modelo diferente. Para substituir para uma sessão:

416 425 

417* Do shell, passe `--model` com `claude --bg`.426* Do shell, passe `--model` com `claude --bg`.


422 Permission mode, model, and effort431 Permission mode, model, and effort

423</h3>432</h3>

424 433 

425Uma sessão em background lê suas [settings](/pt/settings) do diretório em que é executada, da mesma forma que se você tivesse iniciado `claude` lá.434Uma sessão em background lê suas [settings](/pt/settings) do diretório em que é executada, da mesma forma que se você tivesse iniciado `claude` lá. Isso inclui valores [`env`](/pt/settings#available-settings) em settings de projeto, portanto uma `ANTHROPIC_MODEL` ou variável de provedor definida lá se aplica a sessões em background naquele diretório.

435 

436A seleção de provedor de nuvem, como `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, e aliases `ANTHROPIC_DEFAULT_*_MODEL` seguem o shell que despachou a sessão. Variáveis de endpoint de gateway como `ANTHROPIC_BASE_URL` e seu `ANTHROPIC_AUTH_TOKEN` pareado não. Veja [o processo supervisor](#the-supervisor-process) para como sessões em background obtêm configurações de provedor e credenciais.

426 437 

427O [permission mode](/pt/permissions) depende de como você iniciou a sessão. Colocar em background uma sessão existente com `/bg` ou `←` mantém o permission mode atual, portanto uma sessão que você alterou para `acceptEdits` ou `auto` permanece naquele modo após desanexar. Despachar a partir da entrada de agent view ou executar `claude --bg` do seu shell usa o `defaultMode` das settings daquele diretório, ou o `permissionMode` do [frontmatter do subagent despachado](/pt/sub-agents#supported-frontmatter-fields).438O [permission mode](/pt/permissions) depende de como você iniciou a sessão. Colocar em background uma sessão existente com `/bg` ou `←` mantém o permission mode atual, portanto uma sessão que você alterou para `acceptEdits` ou `auto` permanece naquele modo após desanexar. Despachar a partir da entrada de agent view ou executar `claude --bg` do seu shell usa o `defaultMode` das settings daquele diretório, ou o `permissionMode` do [frontmatter do subagent despachado](/pt/sub-agents#supported-frontmatter-fields).

428 439 


508 519 

509Sessões em background são hospedadas por um processo supervisor por usuário, separado do seu terminal e da visualização de agente. O supervisor é iniciado automaticamente na primeira vez que você coloca uma sessão em background ou abre a visualização de agente, e você não o gerencia diretamente.520Sessões em background são hospedadas por um processo supervisor por usuário, separado do seu terminal e da visualização de agente. O supervisor é iniciado automaticamente na primeira vez que você coloca uma sessão em background ou abre a visualização de agente, e você não o gerencia diretamente.

510 521 

511O supervisor e suas sessões se autenticam com as mesmas credenciais que suas sessões interativas e não fazem conexões de rede adicionais além da API do modelo.522O supervisor mantém um processo worker pré-aquecido pronto para que um dispatch da visualização de agente ou `claude --bg` seja iniciado sem o atraso de um cold launch. Quando você faz um dispatch, o supervisor atribui o worker pré-aquecido à sua sessão, aplica o diretório, configurações e credenciais dessa sessão a ele e, em seguida, inicia um substituto para o próximo dispatch. Se nenhum worker pré-aquecido saudável estiver disponível, o supervisor inicia um novo processo.

523 

524O supervisor e suas sessões se autenticam com as mesmas credenciais armazenadas que suas sessões interativas e não fazem conexões de rede adicionais além da API do modelo. Variáveis de seleção de provedor, como `CLAUDE_CODE_USE_BEDROCK` e aliases `ANTHROPIC_DEFAULT_*_MODEL`, são lidas do shell que fez dispatch de cada sessão e são aplicadas ao seu worker.

525 

526{/* min-version: 2.1.174 */}Uma sessão em background não herda variáveis de endpoint de gateway, como `ANTHROPIC_BASE_URL`, as variáveis de URL base equivalentes do Bedrock, Vertex e Foundry, ou um `ANTHROPIC_AUTH_TOKEN` pareado do shell que iniciou o supervisor ou do shell que fez dispatch. A sessão usa suas credenciais armazenadas e quaisquer valores `env` no [settings](/pt/settings) do diretório do projeto. Para apontar sessões em background em um projeto para um [gateway LLM](/pt/llm-gateway), defina `ANTHROPIC_BASE_URL` no bloco `env` do `settings.json` do `.claude/` desse projeto em vez de exportá-lo no seu shell. Antes da v2.1.174, uma sessão em background herdava essas variáveis do shell de inicialização do supervisor, então poderia usar o gateway que você tinha configurado naquele shell em vez do configurado para o diretório do projeto.

512 527 

513Cada sessão em background é seu próprio processo Claude Code, gerenciado pelo supervisor em vez de estar vinculado ao seu terminal. Uma sessão que está ativamente funcionando, aguardando sua entrada ou tem um terminal anexado mantém seu processo em execução. Um comando de shell em background em execução, subagente, workflow dinâmico ou monitor conta como trabalho ativo, então um processo de longa duração, como um servidor de desenvolvimento, mantém a sessão ativa.528Cada sessão em background é seu próprio processo Claude Code, gerenciado pelo supervisor em vez de estar vinculado ao seu terminal. Uma sessão que está ativamente funcionando, aguardando sua entrada ou tem um terminal anexado mantém seu processo em execução. Um comando de shell em background em execução, subagente, workflow dinâmico ou monitor conta como trabalho ativo, então um processo de longa duração, como um servidor de desenvolvimento, mantém a sessão ativa.

514 529 


535 550 

536Cada sessão em background tem a variável de ambiente `CLAUDE_JOB_DIR` definida para seu diretório `~/.claude/jobs/<id>`, então comandos de shell que a sessão executa podem escrever arquivos temporários em `$CLAUDE_JOB_DIR/tmp` sem colidir com sessões paralelas.551Cada sessão em background tem a variável de ambiente `CLAUDE_JOB_DIR` definida para seu diretório `~/.claude/jobs/<id>`, então comandos de shell que a sessão executa podem escrever arquivos temporários em `$CLAUDE_JOB_DIR/tmp` sem colidir com sessões paralelas.

537 552 

538Para inspecionar este estado sem ler os arquivos diretamente, execute `claude daemon status`. Ele relata se o supervisor está acessível, seu ID de processo e versão, o diretório do socket e quantas sessões em background estão ativas. `/doctor` inclui um resumo da mesma verificação. No Windows, `claude daemon status` expõe o erro de arquivo subjacente quando o arquivo de chave de pipe do daemon está bloqueado ou ilegível em vez de relatar uma falha de conexão genérica.553Para inspecionar este estado sem ler os arquivos diretamente, execute `claude daemon status`. Ele relata se o supervisor está acessível, seu ID de processo e versão, o diretório do socket e quantas sessões em background estão ativas. `/doctor` inclui um resumo da mesma verificação.

554 

555O comando também avisa quando o supervisor em execução está em uma versão diferente do `claude` que você invocou, o que acontece após uma atualização que o supervisor ainda não reiniciou. O aviso mostra ambas as versões e diz para você executar `claude daemon stop --any` para pegar a nova versão. Quando Claude Code é instalado como um serviço do SO, o comando sugerido é `claude daemon stop` sem a flag.

556 

557No Windows, `claude daemon status` expõe o erro de arquivo subjacente quando o arquivo de chave de pipe do daemon está bloqueado ou ilegível em vez de relatar uma falha de conexão genérica.

539 558 

540<h3 id="turn-off-agent-view">559<h3 id="turn-off-agent-view">

541 Desativar a visualização de agente560 Desativar a visualização de agente


595 614 

596No Windows, se o supervisor não responder à solicitação de parada, o comando imprime seu ID de processo. Encerre esse processo com `taskkill /PID <pid>` para concluir a recuperação. As sessões em background ainda são preservadas quando você passou `--keep-workers`.615No Windows, se o supervisor não responder à solicitação de parada, o comando imprime seu ID de processo. Encerre esse processo com `taskkill /PID <pid>` para concluir a recuperação. As sessões em background ainda são preservadas quando você passou `--keep-workers`.

597 616 

617<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

618 Dispatch fails with `Could not resolve authentication method`

619</h3>

620 

621{/* min-version: 2.1.174 */}Se um dispatch em background falhar com `Could not resolve authentication method` enquanto sessões interativas autenticam normalmente, o worker que recebeu o dispatch não pegou as credenciais. Na v2.1.174 e posterior, o supervisor fornece um snapshot de credencial fresco quando atribui um [pre-warmed worker](#the-supervisor-process), então este erro significa que nenhuma credencial armazenada estava disponível para o próprio processo supervisor. Confirme que você executou `/login` ou configurou uma chave de API, depois interrompa o supervisor:

622 

623```bash theme={null}

624claude daemon stop --any --keep-workers

625```

626 

627O próximo `claude agents` ou `claude --bg` inicia um novo supervisor que lê suas credenciais armazenadas. Se você autenticar com uma variável de ambiente como `ANTHROPIC_API_KEY` em vez de `/login`, execute esse próximo comando a partir de um shell onde a variável está definida.

628 

629Veja a [referência de erro](/pt/errors#could-not-resolve-authentication-method) para a lista completa de causas e correções. Antes da v2.1.174, um pre-warmed worker que ficou ocioso poderia exibir este erro quando foi atribuído a um dispatch mesmo quando suas credenciais eram válidas. Atualize para recuperar.

630 

598<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">631<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">

599 Background sessions cannot read Desktop, Documents, or Downloads on macOS632 Background sessions cannot read Desktop, Documents, or Downloads on macOS

600</h3>633</h3>

Details

219}219}

220```220```

221 221 

222{/* min-version: 2.1.181 */}A partir do Claude Code v2.1.181, a saída plana de `aws configure export-credentials --format process` também é aceita, com as mesmas chaves no nível superior em vez de aninhadas sob `Credentials`.

223 

222`Expiration` é opcional. {/* min-version: 2.1.176 */}A partir do Claude Code v2.1.176, quando o comando retorna um `Expiration` ISO 8601 válido, Claude Code armazena em cache as credenciais até cinco minutos antes dessa hora. Sem ele, ou em versões anteriores, as credenciais são armazenadas em cache por uma hora.224`Expiration` é opcional. {/* min-version: 2.1.176 */}A partir do Claude Code v2.1.176, quando o comando retorna um `Expiration` ISO 8601 válido, Claude Code armazena em cache as credenciais até cinco minutos antes dessa hora. Sem ele, ou em versões anteriores, as credenciais são armazenadas em cache por uma hora.

223 225 

224<h3 id="3-configure-claude-code">226<h3 id="3-configure-claude-code">

artifacts.md +270 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Compartilhar saída de sessão como artefatos

6 

7> Artefatos transformam o trabalho do Claude Code em páginas ao vivo e interativas em uma URL privada que você pode compartilhar dentro de sua organização.

8 

9{/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}

10 

11<Note>

12 Artefatos estão em beta. Eles exigem um plano Team ou Enterprise e uma sessão conectada com [`/login`](/pt/setup#authenticate). Consulte [Disponibilidade](#availability) para o conjunto completo de requisitos.

13</Note>

14 

15Um artefato é uma página da web ao vivo e interativa que Claude Code publica de sua sessão para uma URL privada em claude.ai. Você a abre em um navegador e ela é atualizada no local conforme a sessão continua. Compartilhe-a do cabeçalho da página quando quiser que um colega de trabalho a veja também. Por exemplo, use um artefato para guiar um revisor através de uma solicitação de pull com diffs anotados, criar um painel a partir de dados de sessão ou manter uma linha do tempo de investigação que se preenche conforme Claude trabalha.

16 

17<Frame>

18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="Um artefato aberto em um navegador em claude.ai/code/artifact. O cabeçalho do visualizador mostra o título do artefato acme-funnel-fix, um botão Compartilhar e o avatar do autor. O menu Compartilhar está aberto com a alternância Sempre compartilhar a versão mais recente, um seletor de versão lendo Compartilhando versão 2, um seletor de público Todos na Acme e um botão Copiar link. Abaixo do cabeçalho, a página do artefato mostra dois mockups de celular lado a lado, um gráfico de funil e uma linha de cartões de métrica." width="2511" height="1890" data-path="images/artifacts-viewer.png" />

19</Frame>

20 

21Esta página aborda como:

22 

23* Decidir [quando usar um artefato](#when-to-use-an-artifact)

24* [Criar](#create-an-artifact), [atualizar](#update-an-artifact) e [compartilhar](#share-an-artifact) um artefato

25* Aplicar [padrões de prompting](#what-you-can-build) para páginas mais ricas

26* [Aplicar seu próprio sistema de design](#improve-the-visual-design) para que os artefatos correspondam à marca do seu produto

27* Entender as [restrições de página](#page-constraints) e [requisitos de disponibilidade](#availability)

28* [Desabilitar](#disable-artifacts) ou [gerenciar artefatos para sua organização](#manage-artifacts-for-your-organization)

29 

30<h2 id="when-to-use-an-artifact">

31 Quando usar um artefato

32</h2>

33 

34Use um artefato quando o texto do terminal é o meio errado para o que Claude produziu: saída que é mais fácil de visualizar e interagir do que ler linha por linha. Claude constrói a página a partir de qualquer coisa que sua sessão possa alcançar, incluindo sua base de código e dados que ela extrai através de suas [ferramentas conectadas](/pt/mcp), para que a página possa mostrar coisas que levariam parágrafos para descrever. Por exemplo, peça a Claude para:

35 

36* Guiar um revisor através de uma solicitação de pull com diffs anotados

37* Renderizar um painel a partir de dados que a sessão já extraiu

38* Dispor várias opções de design ou implementação lado a lado

39* Manter uma linha do tempo de investigação que se preenche enquanto uma tarefa longa é executada

40* Enviar a um colega de trabalho um link em vez de colar a saída no Slack

41 

42Consulte [O que você pode construir](#what-you-can-build) para prompts que correspondem a cada um desses.

43 

44<h3 id="what-an-artifact-is-not">

45 O que um artefato não é

46</h3>

47 

48Um artefato é uma captura de trabalho, não um aplicativo. É uma página única e autossuficiente sem backend, portanto não pode armazenar entrada de formulário, chamar uma API no momento da visualização ou servir múltiplas rotas. Para uma ferramenta interna hospedada com um backend, implante-a em sua própria infraestrutura. Consulte [Restrições de página](#page-constraints) para o conjunto completo de limites.

49 

50<h2 id="create-an-artifact">

51 Criar um artefato

52</h2>

53 

54Claude pode publicar um artefato por conta própria quando a saída se adequa a uma página, ou você pode pedir um diretamente. Para pedir, nomeie o recurso ou descreva a saída visual que você deseja em linguagem simples. Um bom candidato é qualquer coisa mais fácil de ver do que ler como texto, como um diff anotado, um gráfico ou um conjunto de opções para comparar. Os prompts abaixo são dois exemplos; consulte [O que você pode construir](#what-you-can-build) para mais padrões.

55 

56```text wrap theme={null}

57Make an artifact that walks through this PR with the diff annotated inline.

58```

59 

60```text wrap theme={null}

61Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.

62```

63 

64Claude escreve a página em um arquivo HTML ou Markdown em seu projeto e depois a publica. Antes de publicar um novo artefato, Claude Code pede permissão; pode dizer algo como `Claude wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on claude.ai`. Republicar um artefato que você já aprovou não solicita novamente.

65 

66Selecione **Sim** para publicar. Claude imprime a URL e seu navegador abre para a nova página. Pressione `Ctrl+]` a qualquer momento para reabrir o artefato mais recente do terminal.

67 

68Claude escolhe o título do artefato e um emoji para seu ícone de aba do navegador. Ambos aparecem em sua [galeria de artefatos](#share-an-artifact) em claude.ai e em links compartilhados, portanto peça a Claude para usar um título ou ícone específico se quiser um.

69 

70Para impedir que o navegador abra automaticamente quando um novo artefato é publicado, defina `CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0` em seu ambiente.

71 

72Se Claude responder que não pode publicar ou escrever um arquivo HTML local sem um link, a ferramenta não está habilitada para sua sessão. Verifique os requisitos de [Disponibilidade](#availability).

73 

74<h2 id="update-an-artifact">

75 Atualizar um artefato

76</h2>

77 

78Peça a Claude para revisar a página ou deixe uma tarefa de longa duração republicar conforme faz progresso. Claude edita o arquivo subjacente e publica novamente para a mesma URL.

79 

80```text wrap theme={null}

81Add a per-region breakdown below the summary chart and republish.

82```

83 

84Qualquer pessoa com a página aberta vê a atualização no local. Cada publicação se torna uma versão, e a partir do controle **Compartilhar** no cabeçalho da página você pode escolher qual versão os visualizadores veem.

85 

86Para atualizar um artefato de uma sessão diferente, dê a Claude a URL do artefato e peça para revisá-lo. Sem a URL, uma nova sessão sempre cria um novo artefato em vez de atualizar um existente.

87 

88```text wrap theme={null}

89Update https://claude.ai/code/artifact/5fbea6f3-... with today's numbers.

90```

91 

92<h2 id="share-an-artifact">

93 Compartilhar um artefato

94</h2>

95 

96Um novo artefato é visível apenas para você. Abra-o em seu navegador e use o controle **Compartilhar** no cabeçalho da página para conceder acesso a pessoas específicas em sua organização ou a todos nela. O cabeçalho o nomeia como o autor do artefato, portanto qualquer pessoa com quem você o compartilhar pode ver quem publicou a página. Também vincula à sua galeria em [claude.ai/code/artifacts](https://claude.ai/code/artifacts), que lista todos os artefatos que você criou.

97 

98O compartilhamento para na sua organização. Os visualizadores devem estar conectados a claude.ai como membros da mesma organização que publicou o artefato, e não há opção de tornar um artefato visível fora dela. Para enviar o conteúdo subjacente a alguém fora de sua organização, peça a Claude o arquivo HTML e compartilhe esse arquivo diretamente.

99 

100Artefatos são visualizáveis, não co-editados. As pessoas com quem você compartilha veem cada versão que você publica, mas não podem alterar a página; você permanece como o único escritor.

101 

102<h2 id="what-you-can-build">

103 O que você pode construir

104</h2>

105 

106Um artefato é uma única página HTML, portanto qualquer coisa que você possa expressar em HTML, CSS e JavaScript inline está no escopo. Os padrões abaixo surgem com mais frequência.

107 

108<h3 id="walk-through-a-change">

109 Percorrer uma mudança

110</h3>

111 

112Peça uma página que renderize um diff ou uma mudança de design com anotações ao lado das linhas relevantes, para que os revisores possam ler seu raciocínio ao lado do código em vez de reconstruí-lo a partir de uma descrição.

113 

114```text wrap theme={null}

115Make an artifact that walks through this PR. Render the diff with margin annotations and color-code findings by severity.

116```

117 

118<h3 id="compare-alternatives">

119 Comparar alternativas

120</h3>

121 

122Peça várias variantes em uma página para que você possa avaliá-las uma contra a outra. Isso funciona para layouts, cópia, formas de API ou planos de implementação.

123 

124```text wrap theme={null}

125Make an artifact with four distinctly different layouts for the settings panel. Vary density and grouping, and lay them out as a grid with a one-line tradeoff under each.

126```

127 

128<h3 id="tune-with-interactive-controls">

129 Ajustar com controles interativos

130</h3>

131 

132Peça sliders, alternâncias ou campos de entrada vinculados ao que você está ajustando, para que você possa explorar valores diretamente em vez de descrevê-los.

133 

134```text wrap theme={null}

135Build an artifact with sliders for the easing curve, duration, and delay so I can try values on this transition. Show the animation live as I move them.

136```

137 

138<h3 id="bring-the-result-back-to-your-session">

139 Trazer o resultado de volta para sua sessão

140</h3>

141 

142Um artefato pode atuar como um editor leve para uma decisão que você então devolve a Claude. Peça um controle de exportação que produza texto que você possa colar no terminal, para que o resultado de interagir com a página flua de volta para a sessão em vez de permanecer na página.

143 

144```text wrap theme={null}

145Make a triage board artifact with each open issue as a draggable card across Now, Next, Later, and Cut columns. Add a "Copy as prompt" button that gives me the final ordering to paste back here.

146```

147 

148<h3 id="track-work-in-progress">

149 Rastrear trabalho em progresso

150</h3>

151 

152Peça a Claude para manter um artefato atualizado enquanto uma tarefa longa é executada, para que qualquer pessoa com o link possa acompanhar sem ler o terminal.

153 

154```text wrap theme={null}

155Turn this migration plan into a checklist artifact. Check items off as you complete them and add a note for anything you skip.

156```

157 

158<h2 id="improve-the-visual-design">

159 Melhorar o design visual

160</h2>

161 

162Claude aplica uma skill de design integrada quando constrói um artefato, portanto as páginas recebem uma paleta deliberada, tipografia e layout sem prompting extra. Essa skill também procura por um sistema de design existente em seu projeto antes de escolher o seu próprio. Para manter os artefatos consistentes com a marca do seu produto, registre seus tokens de design onde Claude possa encontrá-los, como o [CLAUDE.md](/pt/memory) do projeto ou um arquivo de tema em seu repositório:

163 

164```markdown theme={null}

165## Design system

166 

167- Colors: primary #1a4d8f, accent #f59e0b, surface #f8fafc

168- Typography: Inter for body, JetBrains Mono for code

169- Spacing: 8px scale, 6px border radius

170```

171 

172Claude trata seu sistema de design como tendo precedência mais alta do que suas próprias escolhas, e seu prompt como tendo precedência mais alta do que ambos. O cabeçalho e o formato acima são um exemplo; qualquer lista clara de cores, fontes e espaçamento funciona.

173 

174<h2 id="page-constraints">

175 Restrições de página

176</h2>

177 

178Cada artefato é uma página única e autossuficiente. Claude Code envolve o arquivo que você publica em um shell de documento HTML e o serve sob uma Política de Segurança de Conteúdo (CSP) rigorosa, que molda o que a página pode fazer.

179 

180| Restrição | Efeito |

181| :------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

182| Sem solicitações externas | O CSP bloqueia scripts, folhas de estilo, fontes e imagens carregadas de qualquer outro host, junto com chamadas `fetch`, XHR e WebSocket. Claude incorpora CSS e JavaScript e incorpora imagens como URIs de dados para que a página seja renderizada sem nenhuma solicitação externa. |

183| Sem backend | Um artefato é uma página estática. Não pode armazenar dados enviados através de um formulário, autenticar visualizadores por si só ou chamar uma API no momento da visualização. |

184| Página única | Links relativos não são resolvidos, porque nada é implantado ao lado da página. Para conteúdo de múltiplas seções, Claude usa âncoras na página em vez de arquivos separados. |

185| Tipos de arquivo de origem | O arquivo publicado deve ser `.html`, `.htm` ou `.md`. Arquivos Markdown são renderizados como HTML estilizado. |

186| Tamanho renderizado | A página renderizada deve ter 16 MiB ou menos. Imagens incorporadas grandes são a causa usual quando uma publicação falha por tamanho. |

187 

188Gerar um artefato usa tokens de saída como qualquer outra resposta, e uma página estilizada é mais intensiva em tokens do que o mesmo conteúdo como texto de terminal. CSS inline, JavaScript para controles interativos e especialmente imagens incorporadas como URIs de dados são os principais contribuintes. Para reduzir o custo de token de um artefato:

189 

190* Prefira SVG ou HTML e CSS para diagramas em vez de imagens raster incorporadas

191* Omita interatividade que você não precisa

192* Faça a página resumir grandes conjuntos de dados em vez de incorporá-los completamente

193 

194<h2 id="availability">

195 Disponibilidade

196</h2>

197 

198Artefatos exigem todas as condições abaixo. Quando uma não é atendida, Claude escreve um arquivo HTML local ou diz que não pode publicar.

199 

200| Requisito | Disponível quando |

201| :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

202| Plano | Team ou Enterprise. Em planos Team, artefatos estão ativados por padrão. Em planos Enterprise, um admin [os habilita](#manage-artifacts-for-your-organization) nas configurações de admin do claude.ai. |

203| Autenticação | Conectado a claude.ai com `/login`. Sessões usando uma chave de API, [token de gateway](/pt/llm-gateway) ou credencial de provedor de nuvem não podem publicar. |

204| Provedor de modelo | API Anthropic. Não disponível em [Amazon Bedrock](/pt/amazon-bedrock), [Google Cloud Vertex AI](/pt/google-vertex-ai) ou [Microsoft Foundry](/pt/microsoft-foundry). |

205| Política da organização | Chaves de criptografia gerenciadas pelo cliente (CMEK), HIPAA e [Retenção Zero de Dados](/pt/zero-data-retention) não estão habilitadas para a organização. |

206| Superfície | CLI do Claude Code ou aplicativo de desktop Claude versão 1.13576.0 ou posterior. Desativado por padrão em contextos [Agent SDK](/pt/agent-sdk/overview), GitHub Action e MCP-server, e quando [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/pt/env-vars) está definido. |

207 

208<h2 id="disable-artifacts">

209 Desabilitar artefatos

210</h2>

211 

212Para desativar artefatos para suas próprias sessões independentemente da configuração de sua organização, use qualquer um dos:

213 

214| Método | Configuração |

215| :--------------------------------------- | :--------------------------------------- |

216| [Arquivo de configurações](/pt/settings) | `"disableArtifact": true` |

217| [Variável de ambiente](/pt/env-vars) | `CLAUDE_CODE_DISABLE_ARTIFACT=1` |

218| [Regra de permissão](/pt/permissions) | Adicione `Artifact` a `permissions.deny` |

219 

220<h2 id="manage-artifacts-for-your-organization">

221 Gerenciar artefatos para sua organização

222</h2>

223 

224Admins em planos Team e Enterprise controlam artefatos a partir das [configurações de admin do claude.ai](https://claude.ai/admin-settings/claude-code). O conteúdo do artefato é armazenado em infraestrutura operada pela Anthropic e é visível apenas para membros autenticados da organização de publicação.

225 

226<h3 id="enable-or-disable-artifacts">

227 Habilitar ou desabilitar artefatos

228</h3>

229 

230Para habilitar ou desabilitar artefatos para toda a organização, vá para **Settings > Claude Code > Capabilities** e use a alternância **Artifacts**. Em planos Enterprise com controle de acesso baseado em função, você pode escopo adicional de artefatos para funções específicas: vá para **Settings > Roles**, edite uma função e defina a permissão **Artifacts** sob o grupo **Claude Code**.

231 

232<h3 id="set-a-retention-policy">

233 Definir uma política de retenção

234</h3>

235 

236Para definir quanto tempo os artefatos são mantidos antes da exclusão automática, vá para **Settings > Data & privacy controls**. Você pode definir períodos de retenção separados para artefatos que ainda são privados para seu autor e artefatos que foram compartilhados.

237 

238<h3 id="review-the-audit-log">

239 Revisar o log de auditoria

240</h3>

241 

242Publicar, compartilhar e excluir um artefato aparecem cada um no log de auditoria de sua organização sob os tipos de evento `claude_artifact_*`, a mesma família usada para artefatos criados em conversas do claude.ai.

243 

244<h3 id="allowlist-the-viewer-domain">

245 Adicionar o domínio do visualizador à lista de permissões

246</h3>

247 

248O visualizador em claude.ai carrega cada artefato de uma origem `*.claudeusercontent.com` em sandbox. Se sua organização restringe o acesso à rede de saída, adicione esse domínio à sua lista de permissões junto com `claude.ai`. Consulte [Requisitos de acesso à rede](/pt/network-config#network-access-requirements) para a lista completa.

249 

250<h3 id="list-and-delete-artifacts-with-the-compliance-api">

251 Listar e excluir artefatos com a API de Conformidade

252</h3>

253 

254A [API de Conformidade](https://docs.claude.com/en/api/compliance) fornece endpoints para listar os artefatos de uma organização, recuperar o conteúdo de uma versão específica e excluir um artefato:

255 

256| Método | Endpoint |

257| :------- | :------------------------------------------------------------------ |

258| `GET` | `/v1/compliance/code/artifacts` |

259| `GET` | `/v1/compliance/code/artifacts/{artifact_id}/versions/{version_id}` |

260| `DELETE` | `/v1/compliance/code/artifacts/{artifact_id}` |

261 

262Para os esquemas de solicitação e resposta, consulte a [referência da API de Conformidade](https://docs.claude.com/en/api/compliance/code/artifacts).

263 

264<h2 id="related-resources">

265 Recursos relacionados

266</h2>

267 

268* Procure [padrões de prompting e fluxos de trabalho](/pt/prompt-library) que se emparelham com artefatos

269* Transforme um prompt de artefato que você reutiliza em uma [skill](/pt/skills) para que você possa invocá-lo como um comando

270* [Conecte servidores MCP](/pt/mcp) para que Claude possa extrair dados ao vivo para um artefato

chrome.md +1 −1

Details

198 Extensão não detectada198 Extensão não detectada

199</h3>199</h3>

200 200 

201Se a linha de setup-issues do Claude Code listar `chrome`:201Se Claude Code não conseguir detectar a extensão Chrome:

202 202 

2031. Verifique se a extensão Chrome está instalada e ativada em `chrome://extensions`2031. Verifique se a extensão Chrome está instalada e ativada em `chrome://extensions`

2042. Verifique se Claude Code está atualizado executando `claude --version`2042. Verifique se Claude Code está atualizado executando `claude --version`

Details

124 </Step>124 </Step>

125</Steps>125</Steps>

126 126 

127<h3 id="link-artifacts-back-to-the-session">127<h3 id="link-output-back-to-the-session">

128 Vincule artefatos de volta à sessão128 Vincule a saída de volta à sessão

129</h3>129</h3>

130 130 

131Cada sessão em nuvem tem uma URL de transcrição em claude.ai, e a sessão pode ler seu próprio ID a partir da variável de ambiente `CLAUDE_CODE_REMOTE_SESSION_ID`. Use isso para colocar um link rastreável em corpos de PR, mensagens de commit, posts do Slack ou relatórios gerados para que um revisor possa abrir a execução que os produziu.131Cada sessão em nuvem tem uma URL de transcrição em claude.ai, e a sessão pode ler seu próprio ID a partir da variável de ambiente `CLAUDE_CODE_REMOTE_SESSION_ID`. Use isso para colocar um link rastreável em corpos de PR, mensagens de commit, posts do Slack ou relatórios gerados para que um revisor possa abrir a execução que os produziu.

132 132 

133O valor da variável usa um prefixo `cse_`, enquanto o caminho da URL de transcrição usa o mesmo ID com um prefixo `session_`. Substitua o prefixo ao construir o link. O seguinte comando imprime a URL:133A partir da v2.1.179, commits que Claude cria em uma sessão web incluem um trailer git `Claude-Session: <url>`, e corpos de PR incluem a URL da sessão em sua própria linha. {/* min-version: 2.1.182 */}A partir da v2.1.182, defina [`attribution.sessionUrl`](/pt/settings#attribution-settings) como `false` para omitir o trailer e o link do corpo de PR.

134 

135Para incluir o link da sessão em algo diferente de um commit ou PR, como uma mensagem do Slack que Claude posta ou um arquivo de relatório que ele escreve, peça a Claude para executar o seguinte comando e use sua saída. O comando converte o prefixo `cse_` no valor da variável de ambiente para o prefixo `session_` que a URL de transcrição espera:

134 136 

135```bash theme={null}137```bash theme={null}

136echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"138echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"


902* [Referência de configurações](/pt/settings): todas as opções de configuração904* [Referência de configurações](/pt/settings): todas as opções de configuração

903* [Segurança](/pt/security): garantias de isolamento e tratamento de dados905* [Segurança](/pt/security): garantias de isolamento e tratamento de dados

904* [Uso de dados](/pt/data-usage): o que Anthropic retém de sessões em nuvem906* [Uso de dados](/pt/data-usage): o que Anthropic retém de sessões em nuvem

907* [Claude Tag](https://claude.com/docs/claude-tag/overview): um @Claude gerenciado pela organização no Slack que é executado no mesmo ambiente em nuvem

Details

238}238}

239```239```

240 240 

241Com `awsAuthRefresh` configurado, `/login` mostra uma opção **Claude Platform on AWS · atualizar credenciais** em **Usando plataformas de terceiros**. Selecioná-la executa o comando configurado e relê suas credenciais AWS sem reiniciar Claude Code.

242 

241**Opção B: Chave de API do Workspace**243**Opção B: Chave de API do Workspace**

242 244 

243Uma chave de API do workspace é um segredo de longa duração, útil quando você não quer gerenciar credenciais AWS federadas. Gere uma no Console AWS em **Claude Platform on AWS → API keys** e defina-a como `ANTHROPIC_AWS_API_KEY`:245Uma chave de API do workspace é um segredo de longa duração, útil quando você não quer gerenciar credenciais AWS federadas. Gere uma no Console AWS em **Claude Platform on AWS → API keys** e defina-a como `ANTHROPIC_AWS_API_KEY`:


251Trate chaves de API do workspace como qualquer outra credencial de produção. O bloco `env` do [arquivo de configurações do usuário](/pt/settings) é uma maneira conveniente de escopar a chave para sua máquina sem exportá-la globalmente.253Trate chaves de API do workspace como qualquer outra credencial de produção. O bloco `env` do [arquivo de configurações do usuário](/pt/settings) é uma maneira conveniente de escopar a chave para sua máquina sem exportá-la globalmente.

252 254 

253<Note>255<Note>

254 Os comandos `/login` e `/logout` não alteram a autenticação do Claude Platform on AWS. A autenticação é executada através de suas credenciais AWS ou chave de API do workspace, não através de uma assinatura Claude.ai.256 Os comandos `/login` e `/logout` não o autenticam em uma assinatura Claude.ai para Claude Platform on AWS. A autenticação é executada através de suas credenciais AWS ou chave de API do workspace. A exceção é a opção **atualizar credenciais** que `/login` mostra quando `awsAuthRefresh` está configurado, que relê suas credenciais AWS conforme descrito acima.

255</Note>257</Note>

256 258 

257<h3 id="2-configure-claude-code">259<h3 id="2-configure-claude-code">

Details

33| `claude daemon stop --any` | Parar o [supervisor](/pt/agent-view#the-supervisor-process) de sessão de fundo e as sessões que ele hospeda. Passe `--keep-workers` para deixar as sessões de fundo em execução para que o próximo supervisor se reconecte a elas. `--any` confirma a parada de um supervisor sob demanda, que é o padrão. Use isto para recuperar de um [supervisor não responsivo](/pt/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |33| `claude daemon stop --any` | Parar o [supervisor](/pt/agent-view#the-supervisor-process) de sessão de fundo e as sessões que ele hospeda. Passe `--keep-workers` para deixar as sessões de fundo em execução para que o próximo supervisor se reconecte a elas. `--any` confirma a parada de um supervisor sob demanda, que é o padrão. Use isto para recuperar de um [supervisor não responsivo](/pt/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |

34| `claude logs <id>` | Imprimir saída recente de uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |34| `claude logs <id>` | Imprimir saída recente de uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |

35| `claude mcp` | Configurar servidores Model Context Protocol (MCP) | Veja a [documentação Claude Code MCP](/pt/mcp). |35| `claude mcp` | Configurar servidores Model Context Protocol (MCP) | Veja a [documentação Claude Code MCP](/pt/mcp). |

36| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Executar o fluxo OAuth de um servidor MCP configurado sem abrir o painel interativo `/mcp`. Funciona para servidores HTTP, SSE e conectores claude.ai. Adicione `--no-browser` via SSH para imprimir a URL de autorização em vez de abrir um navegador, depois cole a URL de redirecionamento de volta no prompt. Requer Claude Code v2.1.186 ou posterior. Veja [Autenticar a partir da linha de comando](/pt/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |

37| `claude mcp logout <name>` | {/* min-version: 2.1.186 */}Limpar credenciais OAuth armazenadas para um servidor MCP. Requer Claude Code v2.1.186 ou posterior | `claude mcp logout sentry` |

36| `claude plugin` | Gerenciar Claude Code [plugins](/pt/plugins). Alias: `claude plugins`. Veja [referência de plugin](/pt/plugins-reference#cli-commands-reference) para subcomandos | `claude plugin install code-review@claude-plugins-official` |38| `claude plugin` | Gerenciar Claude Code [plugins](/pt/plugins). Alias: `claude plugins`. Veja [referência de plugin](/pt/plugins-reference#cli-commands-reference) para subcomandos | `claude plugin install code-review@claude-plugins-official` |

37| `claude project purge [path]` | Excluir todo o estado local do Claude Code para um projeto: transcrições, listas de tarefas, logs de depuração, histórico de edição de arquivo, linhas de histórico de prompt e a entrada do projeto em `~/.claude.json`. Omita `[path]` para escolher em uma lista interativa. Sinalizadores: `--dry-run` para visualizar, `-y`/`--yes` para pular confirmação, `-i`/`--interactive` para confirmar cada item, `--all` para cada projeto. Veja [Limpar dados locais](/pt/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |39| `claude project purge [path]` | Excluir todo o estado local do Claude Code para um projeto: transcrições, listas de tarefas, logs de depuração, histórico de edição de arquivo, linhas de histórico de prompt e a entrada do projeto em `~/.claude.json`. Omita `[path]` para escolher em uma lista interativa. Sinalizadores: `--dry-run` para visualizar, `-y`/`--yes` para pular confirmação, `-i`/`--interactive` para confirmar cada item, `--all` para cada projeto. Veja [Limpar dados locais](/pt/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

38| `claude remote-control` | Iniciar um servidor [Remote Control](/pt/remote-control) para controlar Claude Code a partir de Claude.ai ou do aplicativo Claude. Executa em modo servidor (sem sessão interativa local). Veja [Sinalizadores de modo servidor](/pt/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |40| `claude remote-control` | Iniciar um servidor [Remote Control](/pt/remote-control) para controlar Claude Code a partir de Claude.ai ou do aplicativo Claude. Executa em modo servidor (sem sessão interativa local). Veja [Sinalizadores de modo servidor](/pt/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |


60| `--allowedTools`, `--allowed-tools` | Ferramentas que executam sem solicitar permissão. Veja [sintaxe de regra de permissão](/pt/settings#permission-rule-syntax) para correspondência de padrões. Para restringir quais ferramentas estão disponíveis, use `--tools` em vez disso | `"Bash(git log *)" "Bash(git diff *)" "Read"` |62| `--allowedTools`, `--allowed-tools` | Ferramentas que executam sem solicitar permissão. Veja [sintaxe de regra de permissão](/pt/settings#permission-rule-syntax) para correspondência de padrões. Para restringir quais ferramentas estão disponíveis, use `--tools` em vez disso | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

61| `--append-system-prompt` | Anexar texto personalizado ao final do prompt do sistema padrão | `claude --append-system-prompt "Always use TypeScript"` |63| `--append-system-prompt` | Anexar texto personalizado ao final do prompt do sistema padrão | `claude --append-system-prompt "Always use TypeScript"` |

62| `--append-system-prompt-file` | Carregar texto de prompt do sistema adicional de um arquivo e anexar ao prompt padrão | `claude --append-system-prompt-file ./extra-rules.txt` |64| `--append-system-prompt-file` | Carregar texto de prompt do sistema adicional de um arquivo e anexar ao prompt padrão | `claude --append-system-prompt-file ./extra-rules.txt` |

65| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. Força o renderizador clássico, portanto a configuração [`tui`](/pt/settings#available-settings) não tem efeito para a sessão. Tem precedência sobre [`CLAUDE_AX_SCREEN_READER`](/pt/env-vars) e a configuração [`axScreenReader`](/pt/settings#available-settings). Requer Claude Code v2.1.181 ou posterior | `claude --ax-screen-reader` |

63| `--bare` | Modo mínimo: pular auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md para que chamadas com script iniciem mais rapidamente. Claude tem acesso a ferramentas Bash, leitura de arquivo e edição de arquivo. Define [`CLAUDE_CODE_SIMPLE`](/pt/env-vars). Veja [modo bare](/pt/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |66| `--bare` | Modo mínimo: pular auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md para que chamadas com script iniciem mais rapidamente. Claude tem acesso a ferramentas Bash, leitura de arquivo e edição de arquivo. Define [`CLAUDE_CODE_SIMPLE`](/pt/env-vars). Veja [modo bare](/pt/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

64| `--betas` | Cabeçalhos beta para incluir em solicitações de API (apenas usuários de chave de API) | `claude --betas interleaved-thinking` |67| `--betas` | Cabeçalhos beta para incluir em solicitações de API (apenas usuários de chave de API) | `claude --betas interleaved-thinking` |

65| `--bg` | Iniciar a sessão como um [agente de fundo](/pt/agent-view) e retornar imediatamente. Imprime o ID da sessão e comandos de gerenciamento. Combine com `--exec` para executar um comando shell como um trabalho de fundo em vez de uma sessão Claude, ou com `--agent` para executar um subagent específico | `claude --bg "investigate the flaky test"` |68| `--bg` | Iniciar a sessão como um [agente de fundo](/pt/agent-view) e retornar imediatamente. Imprime o ID da sessão e comandos de gerenciamento. Combine com `--exec` para executar um comando shell como um trabalho de fundo em vez de uma sessão Claude, ou com `--agent` para executar um subagent específico | `claude --bg "investigate the flaky test"` |


114| `--system-prompt` | Substituir todo o prompt do sistema por texto personalizado | `claude --system-prompt "You are a Python expert"` |117| `--system-prompt` | Substituir todo o prompt do sistema por texto personalizado | `claude --system-prompt "You are a Python expert"` |

115| `--system-prompt-file` | Carregar prompt do sistema de um arquivo, substituindo o prompt padrão | `claude --system-prompt-file ./custom-prompt.txt` |118| `--system-prompt-file` | Carregar prompt do sistema de um arquivo, substituindo o prompt padrão | `claude --system-prompt-file ./custom-prompt.txt` |

116| `--teleport` | Retomar uma [sessão web](/pt/claude-code-on-the-web) em seu terminal local | `claude --teleport` |119| `--teleport` | Retomar uma [sessão web](/pt/claude-code-on-the-web) em seu terminal local | `claude --teleport` |

117| `--teammate-mode` | Definir como [equipe de agentes](/pt/agent-teams) colegas de equipe são exibidos: `auto` (padrão), `in-process` ou `tmux`. Substitui a configuração [`teammateMode`](/pt/settings#available-settings) para esta sessão. Veja [Escolher um modo de exibição](/pt/agent-teams#choose-a-display-mode) | `claude --teammate-mode in-process` |120| `--teammate-mode` | Definir como [equipe de agentes](/pt/agent-teams) colegas de equipe são exibidos: `in-process` (padrão), `auto`, `tmux` ou {/* min-version: 2.1.186 */}`iterm2` (adicionado em v2.1.186). O padrão mudou de `auto` em v2.1.179. Substitui a configuração [`teammateMode`](/pt/settings#available-settings) para esta sessão. Veja [Escolher um modo de exibição](/pt/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

118| `--tmux` | Criar uma sessão tmux para o worktree. Requer `--worktree`. Usa painéis nativos do iTerm2 quando disponível; passe `--tmux=classic` para tmux tradicional | `claude -w feature-auth --tmux` |121| `--tmux` | Criar uma sessão tmux para o worktree. Requer `--worktree`. Usa painéis nativos do iTerm2 quando disponível; passe `--tmux=classic` para tmux tradicional | `claude -w feature-auth --tmux` |

119| `--tools` | Restringir quais ferramentas integradas Claude pode usar. Use `""` para desativar todas, `"default"` para todas, ou nomes de ferramentas como `"Bash,Edit,Read"`. Ferramentas MCP não são afetadas; para negar essas também, use `--disallowedTools "mcp__*"` ou passe `--strict-mcp-config` sem `--mcp-config` para que nenhum servidor MCP carregue | `claude --tools "Bash,Edit,Read"` |122| `--tools` | Restringir quais ferramentas integradas Claude pode usar. Use `""` para desativar todas, `"default"` para todas, ou nomes de ferramentas como `"Bash,Edit,Read"`. Ferramentas MCP não são afetadas; para negar essas também, use `--disallowedTools "mcp__*"` ou passe `--strict-mcp-config` sem `--mcp-config` para que nenhum servidor MCP carregue | `claude --tools "Bash,Edit,Read"` |

120| `--verbose` | Ativar logging detalhado, mostra saída completa turno por turno. Substitui a configuração [`viewMode`](/pt/settings#available-settings) para esta sessão | `claude --verbose` |123| `--verbose` | Ativar logging detalhado, mostra saída completa turno por turno. Substitui a configuração [`viewMode`](/pt/settings#available-settings) para esta sessão | `claude --verbose` |

commands.md +3 −3

Details

24 24 

25**Executando trabalho em paralelo.** `/agents` abre o gerenciador para os [subagentes](/pt/sub-agents) aos quais Claude pode delegar tarefas secundárias, e `/tasks` lista o que está em execução no segundo plano da sessão atual. `/background` desanexa a sessão inteira para continuar em execução como um [agente de fundo](/pt/agent-view) e libera seu terminal. Para uma grande alteração que abrange a base de código, `/batch` a decompõe em unidades independentes e executa cada uma em seu próprio [worktree](/pt/worktrees). Consulte [Executar agentes em paralelo](/pt/agents) para saber como essas abordagens se relacionam.25**Executando trabalho em paralelo.** `/agents` abre o gerenciador para os [subagentes](/pt/sub-agents) aos quais Claude pode delegar tarefas secundárias, e `/tasks` lista o que está em execução no segundo plano da sessão atual. `/background` desanexa a sessão inteira para continuar em execução como um [agente de fundo](/pt/agent-view) e libera seu terminal. Para uma grande alteração que abrange a base de código, `/batch` a decompõe em unidades independentes e executa cada uma em seu próprio [worktree](/pt/worktrees). Consulte [Executar agentes em paralelo](/pt/agents) para saber como essas abordagens se relacionam.

26 26 

27**Antes de você enviar.** `/diff` mostra o que mudou, `/code-review` verifica o diff quanto a bugs de correção e limpezas e pode aplicar as descobertas com `--fix`, e `/review` ou `/security-review` fornecem uma passagem mais profunda somente leitura. `/code-review ultra` executa uma revisão multi-agente na nuvem.27**Antes de você enviar.** `/diff` mostra o que mudou, `/code-review` verifica o diff quanto a bugs de correção e limpezas e pode aplicar as descobertas com `--fix`, `/review` executa a mesma revisão somente leitura em uma solicitação de pull do GitHub, e `/security-review` fornece uma passagem mais profunda somente leitura. `/code-review ultra` executa uma revisão multi-agente na nuvem.

28 28 

29**Entre sessões.** `/clear` começa do zero em uma nova tarefa enquanto mantém a memória do projeto. `/resume` e `/branch` permitem que você retorne ou bifurque uma conversa anterior. `/teleport` puxa uma sessão web para este terminal, e `/remote-control` permite que você continue esta sessão local de outro dispositivo.29**Entre sessões.** `/clear` começa do zero em uma nova tarefa enquanto mantém a memória do projeto. `/resume` e `/branch` permitem que você retorne ou bifurque uma conversa anterior. `/teleport` puxa uma sessão web para este terminal, e `/remote-control` permite que você continue esta sessão local de outro dispositivo.

30 30 


64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/pt/skills#bundled-skills).** Revisar o diff atual para bugs de correção e para relatar descobertas de reutilização, simplificação e eficiência. Passe `--fix` para aplicar descobertas à sua árvore de trabalho, `--comment` para postá-las como comentários inline do GitHub PR, ou `ultra` para executar uma [revisão em nuvem](/pt/ultrareview) profunda. {/* min-version: 2.1.154 */}A partir da v2.1.154, `/simplify` executa uma revisão separada apenas de limpeza que aplica correções sem procurar por bugs. Consulte [Revisar um diff localmente](/pt/code-review#review-a-diff-locally) para níveis de esforço e direcionamento |64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/pt/skills#bundled-skills).** Revisar o diff atual para bugs de correção e para relatar descobertas de reutilização, simplificação e eficiência. Passe `--fix` para aplicar descobertas à sua árvore de trabalho, `--comment` para postá-las como comentários inline do GitHub PR, ou `ultra` para executar uma [revisão em nuvem](/pt/ultrareview) profunda. {/* min-version: 2.1.154 */}A partir da v2.1.154, `/simplify` executa uma revisão separada apenas de limpeza que aplica correções sem procurar por bugs. Consulte [Revisar um diff localmente](/pt/code-review#review-a-diff-locally) para níveis de esforço e direcionamento |

65| `/color [color\|default]` | Definir a cor da barra de prompt para a sessão atual. Cores disponíveis: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Use `default` para redefinir, ou execute sem argumento para escolher uma cor aleatória. Quando [Remote Control](/pt/remote-control) está conectado, a cor sincroniza com claude.ai/code |65| `/color [color\|default]` | Definir a cor da barra de prompt para a sessão atual. Cores disponíveis: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Use `default` para redefinir, ou execute sem argumento para escolher uma cor aleatória. Quando [Remote Control](/pt/remote-control) está conectado, a cor sincroniza com claude.ai/code |

66| `/compact [instructions]` | Liberar contexto resumindo a conversa até agora. Opcionalmente, passe instruções de foco para o resumo. Consulte [como a compactação lida com regras, skills e arquivos de memória](/pt/context-window#what-survives-compaction) |66| `/compact [instructions]` | Liberar contexto resumindo a conversa até agora. Opcionalmente, passe instruções de foco para o resumo. Consulte [como a compactação lida com regras, skills e arquivos de memória](/pt/context-window#what-survives-compaction) |

67| `/config` | Abrir a interface de [Configurações](/pt/settings) para ajustar tema, modelo, [estilo de saída](/pt/output-styles) e outras preferências. Alias: `/settings` |67| `/config [key=value ...]` | Abrir a interface de [Configurações](/pt/settings) para ajustar tema, modelo, [estilo de saída](/pt/output-styles) e outras preferências. {/* min-version: 2.1.181 */}A partir da v2.1.181, passe um ou mais pares `key=value` para definir uma configuração diretamente sem abrir a interface, por exemplo `/config thinking=false`. {/* min-version: 2.1.182 */}A partir da v2.1.182, chaves de atalho nomeadas também são aceitas, como `/config theme=dark` ou `/config model=sonnet`. O formulário `key=value` também funciona em modo não interativo (`-p`) e do [Remote Control](/pt/remote-control). Execute `/config --help` para listar todas as chaves configuráveis com suas opções. Alias: `/settings` |

68| `/context [all]` | Visualizar o uso atual de contexto como uma grade colorida. Mostra sugestões de otimização para ferramentas pesadas em contexto, inchaço de memória e avisos de capacidade. No [modo tela cheia](/pt/fullscreen), o detalhamento por item é recolhido para manter a grade visível. Passe `all` para expandi-lo |68| `/context [all]` | Visualizar o uso atual de contexto como uma grade colorida. Mostra sugestões de otimização para ferramentas pesadas em contexto, inchaço de memória e avisos de capacidade. No [modo tela cheia](/pt/fullscreen), o detalhamento por item é recolhido para manter a grade visível. Passe `all` para expandi-lo |

69| `/copy [N]` | Copiar a última resposta do assistente para a área de transferência. Passe um número `N` para copiar a N-ésima resposta mais recente: `/copy 2` copia a segunda mais recente. Quando há blocos de código, mostra um seletor interativo para selecionar blocos individuais ou a resposta completa. Pressione `w` no seletor para escrever a seleção em um arquivo em vez da área de transferência, o que é útil via SSH |69| `/copy [N]` | Copiar a última resposta do assistente para a área de transferência. Passe um número `N` para copiar a N-ésima resposta mais recente: `/copy 2` copia a segunda mais recente. Quando há blocos de código, mostra um seletor interativo para selecionar blocos individuais ou a resposta completa. Pressione `w` no seletor para escrever a seleção em um arquivo em vez da área de transferência, o que é útil via SSH |

70| `/cost` | Alias para `/usage` |70| `/cost` | Alias para `/usage` |


114| `/remote-env` | Escolher o ambiente padrão para [agentes em nuvem](/pt/claude-code-on-the-web#configure-your-environment) |114| `/remote-env` | Escolher o ambiente padrão para [agentes em nuvem](/pt/claude-code-on-the-web#configure-your-environment) |

115| `/rename [name]` | Renomear a sessão atual e mostrar o nome na barra de prompt. Sem um nome, gera automaticamente um a partir do histórico de conversa |115| `/rename [name]` | Renomear a sessão atual e mostrar o nome na barra de prompt. Sem um nome, gera automaticamente um a partir do histórico de conversa |

116| `/resume [session]` | Retomar uma conversa por ID ou nome, ou abrir o seletor de sessão. A partir da v2.1.144, [sessões de fundo](/pt/agent-view) aparecem no seletor marcadas com `bg`. Alias: `/continue` |116| `/resume [session]` | Retomar uma conversa por ID ou nome, ou abrir o seletor de sessão. A partir da v2.1.144, [sessões de fundo](/pt/agent-view) aparecem no seletor marcadas com `bg`. Alias: `/continue` |

117| `/review [PR]` | Revisar uma solicitação de pull localmente em sua sessão atual. Para uma revisão mais profunda baseada em nuvem, consulte [`/code-review ultra`](/pt/ultrareview) |117| `/review [PR]` | Revisar uma solicitação de pull do GitHub por número, usando o mesmo mecanismo de revisão que `/code-review`. Sem argumentos, lista PRs abertos para escolher. Para uma revisão baseada em nuvem, consulte [`/code-review ultra`](/pt/ultrareview) |

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

119| `/run` | **[Skill](/pt/skills#bundled-skills).** Iniciar e conduzir o aplicativo do seu projeto para ver uma alteração funcionando no aplicativo em execução, não apenas em testes. Consulte [Executar e verificar seu aplicativo](/pt/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Requer Claude Code v2.1.145 ou posterior |119| `/run` | **[Skill](/pt/skills#bundled-skills).** Iniciar e conduzir o aplicativo do seu projeto para ver uma alteração funcionando no aplicativo em execução, não apenas em testes. Consulte [Executar e verificar seu aplicativo](/pt/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Requer Claude Code v2.1.145 ou posterior |

120| `/run-skill-generator` | **[Skill](/pt/skills#bundled-skills).** Ensinar `/run` e `/verify` como construir, iniciar e conduzir o aplicativo do seu projeto a partir de um ambiente limpo escrevendo uma [skill](/pt/skills#run-and-verify-your-app) por projeto. {/* min-version: 2.1.145 */}Requer Claude Code v2.1.145 ou posterior |120| `/run-skill-generator` | **[Skill](/pt/skills#bundled-skills).** Ensinar `/run` e `/verify` como construir, iniciar e conduzir o aplicativo do seu projeto a partir de um ambiente limpo escrevendo uma [skill](/pt/skills#run-and-verify-your-app) por projeto. {/* min-version: 2.1.145 */}Requer Claude Code v2.1.145 ou posterior |

env-vars.md +15 −6

Details

148| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Defina como `1` para desabilitar todos os tipos de [subagente](/pt/sub-agents) integrados, como Explore e Plan. Aplica-se apenas em modo não interativo (a flag `-p`). Útil para usuários do SDK que desejam uma tela em branco |148| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Defina como `1` para desabilitar todos os tipos de [subagente](/pt/sub-agents) integrados, como Explore e Plan. Aplica-se apenas em modo não interativo (a flag `-p`). Útil para usuários do SDK que desejam uma tela em branco |

149| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Defina como `1` para pular o prefixo `mcp__<server>__` em nomes de ferramentas de servidores MCP criados pelo SDK. As ferramentas usam seus nomes originais. Apenas uso do SDK |149| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Defina como `1` para pular o prefixo `mcp__<server>__` em nomes de ferramentas de servidores MCP criados pelo SDK. As ferramentas usam seus nomes originais. Apenas uso do SDK |

150| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Tempo limite de travamento em milissegundos para subagentes em segundo plano. Padrão `600000` (10 minutos). O temporizador é reiniciado em cada evento de progresso de streaming; se nenhum progresso chegar dentro da janela, o subagente é abortado e a tarefa é marcada como falha, exibindo qualquer resultado parcial para o pai |150| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Tempo limite de travamento em milissegundos para subagentes em segundo plano. Padrão `600000` (10 minutos). O temporizador é reiniciado em cada evento de progresso de streaming; se nenhum progresso chegar dentro da janela, o subagente é abortado e a tarefa é marcada como falha, exibindo qualquer resultado parcial para o pai |

151| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Defina a porcentagem (1-100) da janela de auto-compactação na qual a auto-compactação é acionada. Use valores mais baixos como `50` para compactar mais cedo. Esta variável só causa compactação mais cedo quando Claude Code compacta proativamente: quando `CLAUDE_CODE_AUTO_COMPACT_WINDOW` está definido, em [sessões em nuvem](/pt/claude-code-on-the-web), em sessões [Remote Control](/pt/remote-control) e em Sonnet 4.6 e Opus 4.6 sem [contexto estendido](/pt/model-config#extended-context), que compactam no limite de 200K por padrão. Em outros casos, como uma sessão local em Opus 4.8 ou qualquer modelo com contexto estendido, a auto-compactação é acionada quando a conversa atinge o limite de contexto do modelo. O override só pode baixar o limite, então valores acima do padrão não têm efeito. Aplica-se a conversas principais e subagentes |151| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Defina a porcentagem (1-100) da janela de auto-compactação na qual a auto-compactação é acionada. Use valores mais baixos como `50` para compactar mais cedo. Esta variável só causa compactação mais cedo quando Claude Code compacta proativamente: quando `CLAUDE_CODE_AUTO_COMPACT_WINDOW` está definido, em [sessões em nuvem](/pt/claude-code-on-the-web) e em Sonnet 4.6 e Opus 4.6 sem [contexto estendido](/pt/model-config#extended-context), que compactam no limite de 200K por padrão. Em outros casos, como uma sessão local em Opus 4.8 ou qualquer modelo com contexto estendido, a auto-compactação é acionada quando a conversa atinge o limite de contexto do modelo. O override só pode baixar o limite, então valores acima do padrão não têm efeito. Aplica-se a conversas principais e subagentes |

152| `CLAUDE_AUTO_BACKGROUND_TASKS` | Defina como `1` para forçar a habilitação do envio automático para segundo plano de tarefas de agente de longa duração. Quando habilitado, subagentes são movidos para o segundo plano após executarem por aproximadamente dois minutos |152| `CLAUDE_AUTO_BACKGROUND_TASKS` | Defina como `1` para forçar a habilitação do envio automático para segundo plano de tarefas de agente de longa duração. Quando habilitado, subagentes são movidos para o segundo plano após executarem por aproximadamente dois minutos |

153| `CLAUDE_AX_SCREEN_READER` | {/* min-version: 2.1.181 */}Defina como `1` para renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. Defina como `0` para forçar o modo leitor de tela desativado mesmo quando [`axScreenReader`](/pt/settings#available-settings) é `true`. A flag [`--ax-screen-reader`](/pt/cli-reference#cli-flags) tem precedência. Requer Claude Code v2.1.181 ou posterior |

153| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Retorne ao diretório de trabalho original após cada comando Bash ou PowerShell na sessão principal |154| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Retorne ao diretório de trabalho original após cada comando Bash ou PowerShell na sessão principal |

155| `CLAUDE_CLIENT_PRESENCE_FILE` | {/* min-version: 2.1.181 */}Caminho para um arquivo que uma ferramenta externa, como um ouvinte de bloqueio de tela, cria quando você desbloqueia sua tela e exclui quando você a bloqueia. Enquanto o arquivo existe, Claude Code pula [notificações push móveis de Remote Control](/pt/remote-control#mobile-push-notifications), para que você pare de receber pushes enquanto está usando ativamente o computador. Quando o arquivo está ausente ou ilegível, as notificações são enviadas normalmente. Claude Code verifica o arquivo uma vez por evento de disparo de push em vez de fazer polling. Requer Claude Code v2.1.181 ou posterior |

154| `CLAUDE_CODE_ACCESSIBILITY` | Defina como `1` para manter o cursor do terminal nativo visível e desabilitar o indicador de cursor de texto invertido. Permite que ampliadores de tela como macOS Zoom rastreiem a posição do cursor |156| `CLAUDE_CODE_ACCESSIBILITY` | Defina como `1` para manter o cursor do terminal nativo visível e desabilitar o indicador de cursor de texto invertido. Permite que ampliadores de tela como macOS Zoom rastreiem a posição do cursor |

155| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Defina como `1` para carregar arquivos de memória de diretórios especificados com `--add-dir`. Carrega `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Por padrão, diretórios adicionais não carregam arquivos de memória |157| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Defina como `1` para carregar arquivos de memória de diretórios especificados com `--add-dir`. Carrega `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Por padrão, diretórios adicionais não carregam arquivos de memória |

156| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Defina como `1` para repintar a tela inteira em cada quadro em [renderização em tela cheia](/pt/fullscreen) em vez de enviar atualizações incrementais. Use isso se o modo tela cheia mostrar fragmentos de texto obsoletos ou deslocados. Claude Code habilita isso automaticamente para sessões em segundo plano e [visualização de agentes](/pt/agent-view) no Windows |158| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Defina como `1` para repintar a tela inteira em cada quadro em [renderização em tela cheia](/pt/fullscreen) em vez de enviar atualizações incrementais. Use isso se o modo tela cheia mostrar fragmentos de texto obsoletos ou deslocados. Claude Code habilita isso automaticamente para sessões em segundo plano e [visualização de agentes](/pt/agent-view) no Windows |

157| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro [esforço](/pt/model-config#adjust-effort-level) com cada solicitação, mesmo quando Claude Code não reconhece o ID do modelo como capaz de esforço. Use isso ao rotear através de um [gateway LLM](/pt/llm-gateway) ou provedor de terceiros que serve modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo modelos Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, ainda são excluídos para que as solicitações não falhem |159| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro [esforço](/pt/model-config#adjust-effort-level) com cada solicitação, mesmo quando Claude Code não reconhece o ID do modelo como capaz de esforço. Use isso ao rotear através de um [gateway LLM](/pt/llm-gateway) ou provedor de terceiros que serve modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo modelos Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, ainda são excluídos para que as solicitações não falhem |

158| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar [`apiKeyHelper`](/pt/settings#available-settings)) |160| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar [`apiKeyHelper`](/pt/settings#available-settings)) |

161| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Defina como `0` para parar Claude Code de abrir o navegador automaticamente quando um novo [artefato](/pt/artifacts) é publicado. Republicar um artefato existente não abre o navegador independentemente dessa configuração |

159| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Defina como `0` para omitir o bloco de atribuição (versão do cliente e impressão digital do prompt) do início do prompt do sistema. Desabilitá-lo melhora as taxas de acerto do cache de prompt ao rotear através de um [gateway LLM](/pt/llm-gateway). O cache da API Anthropic não é afetado |162| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Defina como `0` para omitir o bloco de atribuição (versão do cliente e impressão digital do prompt) do início do prompt do sistema. Desabilitá-lo melhora as taxas de acerto do cache de prompt ao rotear através de um [gateway LLM](/pt/llm-gateway). O cache da API Anthropic não é afetado |

160| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Defina a capacidade de contexto em tokens usada para cálculos de auto-compactação. Padrão é a janela de contexto do modelo: 200K para modelos padrão ou 1M para modelos de [contexto estendido](/pt/model-config#extended-context). Use um valor mais baixo como `500000` em um modelo de 1M para tratar a janela como 500K para fins de compactação. O valor é limitado à janela de contexto real do modelo. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` é aplicado como uma porcentagem deste valor. Definir esta variável desacopla o limite de compactação do `used_percentage` da linha de status, que sempre usa a janela de contexto completa do modelo |163| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Defina a capacidade de contexto em tokens usada para cálculos de auto-compactação. Padrão é a janela de contexto do modelo: 200K para modelos padrão ou 1M para modelos de [contexto estendido](/pt/model-config#extended-context). Use um valor mais baixo como `500000` em um modelo de 1M para tratar a janela como 500K para fins de compactação. O valor é limitado à janela de contexto real do modelo. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` é aplicado como uma porcentagem deste valor. Definir esta variável desacopla o limite de compactação do `used_percentage` da linha de status, que sempre usa a janela de contexto completa do modelo |

161| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Substitua a [conexão IDE](/pt/vs-code) automática. Por padrão, Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de uma IDE suportada. Defina como `false` para evitar isso. Defina como `true` para forçar uma tentativa de conexão quando a detecção automática falha, como quando tmux obscurece o terminal pai. Tem precedência sobre a configuração global [`autoConnectIde`](/pt/settings#global-config-settings) |164| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Substitua a [conexão IDE](/pt/vs-code) automática. Por padrão, Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de uma IDE suportada. Defina como `false` para evitar isso. Defina como `true` para forçar uma tentativa de conexão quando a detecção automática falha, como quando tmux obscurece o terminal pai. Tem precedência sobre a configuração global [`autoConnectIde`](/pt/settings#global-config-settings) |


164| `CLAUDE_CODE_CLIENT_CERT` | Caminho para arquivo de certificado do cliente para autenticação mTLS |167| `CLAUDE_CODE_CLIENT_CERT` | Caminho para arquivo de certificado do cliente para autenticação mTLS |

165| `CLAUDE_CODE_CLIENT_KEY` | Caminho para arquivo de chave privada do cliente para autenticação mTLS |168| `CLAUDE_CODE_CLIENT_KEY` | Caminho para arquivo de chave privada do cliente para autenticação mTLS |

166| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Frase-passe para `CLAUDE_CODE_CLIENT_KEY` criptografada (opcional) |169| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Frase-passe para `CLAUDE_CODE_CLIENT_KEY` criptografada (opcional) |

170| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | {/* max-version: 2.1.185 */}Removido em v2.1.186 e agora é um no-op. Anteriormente definia um tempo limite separado para a fase de conexão, TLS e cabeçalho de resposta de uma solicitação de API de streaming. Use `API_TIMEOUT_MS` para o tempo limite por solicitação |

167| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Substitua o caminho do arquivo de log de depuração. Apesar do nome, este é um caminho de arquivo, não um diretório. Requer que o modo de depuração seja habilitado separadamente via `--debug`, `/debug` ou a variável de ambiente `DEBUG`: definir apenas essa variável não habilita o logging. A flag [`--debug-file`](/pt/cli-reference#cli-flags) faz ambos de uma vez. Padrão é `~/.claude/debug/<session-id>.txt` |171| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Substitua o caminho do arquivo de log de depuração. Apesar do nome, este é um caminho de arquivo, não um diretório. Requer que o modo de depuração seja habilitado separadamente via `--debug`, `/debug` ou a variável de ambiente `DEBUG`: definir apenas essa variável não habilita o logging. A flag [`--debug-file`](/pt/cli-reference#cli-flags) faz ambos de uma vez. Padrão é `~/.claude/debug/<session-id>.txt` |

168| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Nível de log mínimo escrito no arquivo de log de depuração. Valores: `verbose`, `debug` (padrão), `info`, `warn`, `error`. Defina como `verbose` para incluir diagnósticos de alto volume como saída completa de comando de linha de status, ou aumente para `error` para reduzir ruído |172| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Nível de log mínimo escrito no arquivo de log de depuração. Valores: `verbose`, `debug` (padrão), `info`, `warn`, `error`. Defina como `verbose` para incluir diagnósticos de alto volume como saída completa de comando de linha de status, ou aumente para `error` para reduzir ruído |

169| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Defina como `1` para desabilitar suporte a [janela de contexto de 1M](/pt/model-config#extended-context). Quando definido, variantes de modelo de 1M não estão disponíveis no seletor de modelo. Útil para ambientes corporativos com requisitos de conformidade |173| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Defina como `1` para desabilitar suporte a [janela de contexto de 1M](/pt/model-config#extended-context). Quando definido, variantes de modelo de 1M não estão disponíveis no seletor de modelo. Útil para ambientes corporativos com requisitos de conformidade |


171| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}Defina como `1` para desabilitar a [ferramenta advisor](/pt/advisor). O comando `/advisor` e a flag `--advisor` ficam indisponíveis e qualquer `advisorModel` configurado é ignorado. Requer Claude Code v2.1.98 ou posterior |175| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}Defina como `1` para desabilitar a [ferramenta advisor](/pt/advisor). O comando `/advisor` e a flag `--advisor` ficam indisponíveis e qualquer `advisorModel` configurado é ignorado. Requer Claude Code v2.1.98 ou posterior |

172| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Defina como `1` para desativar [agentes em segundo plano e visualização de agentes](/pt/agent-view): `claude agents`, `--bg`, `/background` e o supervisor sob demanda. Equivalente à configuração [`disableAgentView`](/pt/settings#available-settings) |176| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Defina como `1` para desativar [agentes em segundo plano e visualização de agentes](/pt/agent-view): `claude agents`, `--bg`, `/background` e o supervisor sob demanda. Equivalente à configuração [`disableAgentView`](/pt/settings#available-settings) |

173| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desabilitar [renderização em tela cheia](/pt/fullscreen) e usar o renderizador de tela principal clássico. A conversa permanece no scrollback nativo do seu terminal para que `Cmd+f` e modo de cópia tmux funcionem como de costume. Tem precedência sobre `CLAUDE_CODE_NO_FLICKER` e a configuração [`tui`](/pt/settings#available-settings). Você também pode alternar com `/tui default`. Não se aplica a sessões em segundo plano abertas de [visualização de agentes](/pt/agent-view), que sempre usam renderização em tela cheia |177| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desabilitar [renderização em tela cheia](/pt/fullscreen) e usar o renderizador de tela principal clássico. A conversa permanece no scrollback nativo do seu terminal para que `Cmd+f` e modo de cópia tmux funcionem como de costume. Tem precedência sobre `CLAUDE_CODE_NO_FLICKER` e a configuração [`tui`](/pt/settings#available-settings). Você também pode alternar com `/tui default`. Não se aplica a sessões em segundo plano abertas de [visualização de agentes](/pt/agent-view), que sempre usam renderização em tela cheia |

178| `CLAUDE_CODE_DISABLE_ARTIFACT` | Defina como `1` para desabilitar a ferramenta [Artifact](/pt/artifacts), que publica saída de sessão como uma página web privada em claude.ai. Equivalente à configuração [`disableArtifact`](/pt/settings#available-settings) |

174| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Defina como `1` para desabilitar o processamento de anexos. Menções de arquivo com sintaxe `@` são enviadas como texto simples em vez de serem expandidas para conteúdo de arquivo |179| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Defina como `1` para desabilitar o processamento de anexos. Menções de arquivo com sintaxe `@` são enviadas como texto simples em vez de serem expandidas para conteúdo de arquivo |

175| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Defina como `1` para desabilitar [memória automática](/pt/memory#auto-memory). Defina como `0` para forçar a memória automática mesmo quando `--bare` mode ou [`autoMemoryEnabled: false`](/pt/settings#available-settings) desabilitaria de outra forma. Quando desabilitada, Claude não cria ou carrega arquivos de memória automática |180| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Defina como `1` para desabilitar [memória automática](/pt/memory#auto-memory). Defina como `0` para forçar a memória automática mesmo quando `--bare` mode ou [`autoMemoryEnabled: false`](/pt/settings#available-settings) desabilitaria de outra forma. Quando desabilitada, Claude não cria ou carrega arquivos de memória automática |

176| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para desabilitar toda a funcionalidade de tarefas em segundo plano, incluindo o parâmetro `run_in_background` em ferramentas Bash e subagent, auto-backgrounding e o atalho Ctrl+B |181| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Defina como `1` para desabilitar toda a funcionalidade de tarefas em segundo plano, incluindo o parâmetro `run_in_background` em ferramentas Bash e subagent, auto-backgrounding e o atalho Ctrl+B |


207| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Defina como `1` para habilitar [equipes de agentes](/pt/agent-teams). As equipes de agentes são experimentais e desabilitadas por padrão |212| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Defina como `1` para habilitar [equipes de agentes](/pt/agent-teams). As equipes de agentes são experimentais e desabilitadas por padrão |

208| `CLAUDE_CODE_EXTRA_BODY` | Objeto JSON para mesclar no nível superior de cada corpo de solicitação de API. Útil para passar parâmetros específicos do provedor que Claude Code não expõe diretamente |213| `CLAUDE_CODE_EXTRA_BODY` | Objeto JSON para mesclar no nível superior de cada corpo de solicitação de API. Útil para passar parâmetros específicos do provedor que Claude Code não expõe diretamente |

209| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Substitua o limite de token padrão para leituras de arquivo. Útil quando você precisa ler arquivos maiores na íntegra |214| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Substitua o limite de token padrão para leituras de arquivo. Útil quando você precisa ler arquivos maiores na íntegra |

210| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}Defina como `1` para forçar persistência de transcrição, histórico de prompt e registro `claude agents` mesmo quando este `claude` foi iniciado de dentro de outra sessão Claude Code. Use quando um valor `CLAUDE_CODE_CHILD_SESSION` herdado, por exemplo de um servidor tmux iniciado pela primeira vez pela ferramenta Bash do Claude Code, causa uma sessão genuína de nível superior a ser classificada incorretamente como aninhada. Também honrado em v2.1.169 e anterior; não tem efeito em v2.1.170 e v2.1.171, onde a detecção de sessão aninhada que ele substitui foi removida |215| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}Defina como `1` para forçar persistência de transcrição, histórico de prompt e registro `claude agents` mesmo quando este `claude` foi iniciado de dentro de outra sessão Claude Code. Use quando um valor `CLAUDE_CODE_CHILD_SESSION` herdado, por exemplo de uma sessão `screen` ou um lançador em segundo plano iniciado pela primeira vez pela ferramenta Bash do Claude Code, causa uma sessão genuína de nível superior a ser classificada incorretamente como aninhada. {/* min-version: 2.1.178 */}A partir de v2.1.178, Claude Code detecta o caso tmux automaticamente e ignora o marcador herdado, então tmux não precisa mais dessa variável. Também honrado em v2.1.169 e anterior; não tem efeito em v2.1.170 e v2.1.171, onde a detecção de sessão aninhada que ele substitui foi removida |

216| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {/* min-version: 2.1.186 */}Defina como `1` para forçar renderização de tachado para `~~text~~` nas respostas do Claude quando seu terminal suporta mas não é detectado automaticamente, como sobre SSH sem `TERM_PROGRAM` encaminhado. Sem isso, terminais não detectados mostram os marcadores `~~` literais em vez de renderizar o texto como tachado. Requer Claude Code v2.1.186 ou posterior |

211| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Defina como `1` para forçar a habilitação do modo privado DEC 2026 [saída sincronizada](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) quando seu terminal suporta mas não é detectado automaticamente. Útil para emuladores como `eat` do Emacs que implementam BSU/ESU mas não respondem à sonda de capacidade. Não tem efeito sob tmux |217| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Defina como `1` para forçar a habilitação do modo privado DEC 2026 [saída sincronizada](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) quando seu terminal suporta mas não é detectado automaticamente. Útil para emuladores como `eat` do Emacs que implementam BSU/ESU mas não respondem à sonda de capacidade. Não tem efeito sob tmux |

212| `CLAUDE_CODE_FORK_SUBAGENT` | Defina como `1` para permitir [subagentes bifurcados](/pt/sub-agents#fork-the-current-conversation), ou `0` para desabilitá-los, substituindo qualquer rollout do lado do servidor. Quando habilitado, Claude pode solicitar o tipo de subagente `fork` para gerar uma bifurcação, um subagente que herda o contexto de conversa completo em vez de começar do zero. Spawns sem um tipo de subagente ainda usam o subagente de propósito geral, e todos os spawns de subagente são executados em segundo plano. O comando [`/fork`](/pt/commands) explícito funciona sem essa variável. Funciona em modo interativo e via SDK ou `claude -p` |218| `CLAUDE_CODE_FORK_SUBAGENT` | Defina como `1` para permitir [subagentes bifurcados](/pt/sub-agents#fork-the-current-conversation), ou `0` para desabilitá-los, substituindo qualquer rollout do lado do servidor. Quando habilitado, Claude pode solicitar o tipo de subagente `fork` para gerar uma bifurcação, um subagente que herda o contexto de conversa completo em vez de começar do zero. Spawns sem um tipo de subagente ainda usam o subagente de propósito geral, e todos os spawns de subagente são executados em segundo plano. O comando [`/fork`](/pt/commands) explícito funciona sem essa variável. Funciona em modo interativo e via SDK ou `claude -p` |

213| `CLAUDE_CODE_GIT_BASH_PATH` | Apenas Windows: caminho para o executável Git Bash (`bash.exe`). Use quando Git Bash está instalado mas não está no seu PATH. Veja [Configuração do Windows](/pt/setup#set-up-on-windows) |219| `CLAUDE_CODE_GIT_BASH_PATH` | Apenas Windows: caminho para o executável Git Bash (`bash.exe`). Use quando Git Bash está instalado mas não está no seu PATH. Veja [Configuração do Windows](/pt/setup#set-up-on-windows) |


220| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Defina como `1` para pular validação de entradas de arquivo de bloqueio IDE durante a conexão. Use quando a auto-conexão falha em encontrar sua IDE apesar dela estar em execução |226| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Defina como `1` para pular validação de entradas de arquivo de bloqueio IDE durante a conexão. Use quando a auto-conexão falha em encontrar sua IDE apesar dela estar em execução |

221| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. Só tem efeito quando `DISABLE_COMPACT` também está definido. Use isso ao rotear para um modelo através de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para seu nome |227| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. Só tem efeito quando `DISABLE_COMPACT` também está definido. Use isso ao rotear para um modelo através de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para seu nome |

222| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Defina o número máximo de tokens de saída para a maioria das solicitações. Padrões e limites variam por modelo; veja [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Aumentar este valor reduz a janela de contexto efetiva disponível antes que [auto-compactação](/pt/costs#reduce-token-usage) seja acionada. |228| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Defina o número máximo de tokens de saída para a maioria das solicitações. Padrões e limites variam por modelo; veja [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Aumentar este valor reduz a janela de contexto efetiva disponível antes que [auto-compactação](/pt/costs#reduce-token-usage) seja acionada. |

223| `CLAUDE_CODE_MAX_RETRIES` | Substitua o número de vezes para tentar novamente solicitações de API falhadas (padrão: 10) |229| `CLAUDE_CODE_MAX_RETRIES` | Substitua o número de vezes para tentar novamente solicitações de API falhadas (padrão: 10). {/* min-version: 2.1.186 */}Limitado a 15 a partir de v2.1.186. Para sessões não supervisionadas que precisam aguardar através de interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG` em vez disso |

224| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Número máximo de ferramentas somente leitura e subagentes que podem executar em paralelo (padrão: 10). Valores mais altos aumentam o paralelismo mas consomem mais recursos |230| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Número máximo de ferramentas somente leitura e subagentes que podem executar em paralelo (padrão: 10). Valores mais altos aumentam o paralelismo mas consomem mais recursos |

225| `CLAUDE_CODE_MAX_TURNS` | Limite o número de voltas agentes quando nenhum limite explícito é passado. Equivalente a passar [`--max-turns`](/pt/cli-reference#cli-flags), que tem precedência quando ambos estão definidos. Um valor que não é um inteiro positivo é rejeitado na inicialização com um erro em vez de ser tratado como sem limite |231| `CLAUDE_CODE_MAX_TURNS` | Limite o número de voltas agentes quando nenhum limite explícito é passado. Equivalente a passar [`--max-turns`](/pt/cli-reference#cli-flags), que tem precedência quando ambos estão definidos. Um valor que não é um inteiro positivo é rejeitado na inicialização com um erro em vez de ser tratado como sem limite |

226| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Defina como `1` para gerar servidores MCP stdio com apenas um ambiente de linha de base segura mais o `env` configurado do servidor, em vez de herdar seu ambiente de shell |232| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Defina como `1` para gerar servidores MCP stdio com apenas um ambiente de linha de base segura mais o `env` configurado do servidor, em vez de herdar seu ambiente de shell |


231| `CLAUDE_CODE_OAUTH_SCOPES` | Escopos OAuth separados por espaço com os quais o token de atualização foi emitido, como `"user:profile user:inference user:sessions:claude_code"`. Obrigatório quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definido |237| `CLAUDE_CODE_OAUTH_SCOPES` | Escopos OAuth separados por espaço com os quais o token de atualização foi emitido, como `"user:profile user:inference user:sessions:claude_code"`. Obrigatório quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definido |

232| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acesso OAuth para autenticação Claude.ai. Alternativa a `/login` para SDK e ambientes automatizados. Tem precedência sobre credenciais armazenadas em keychain. Gere um com [`claude setup-token`](/pt/authentication#generate-a-long-lived-token) |238| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acesso OAuth para autenticação Claude.ai. Alternativa a `/login` para SDK e ambientes automatizados. Tem precedência sobre credenciais armazenadas em keychain. Gere um com [`claude setup-token`](/pt/authentication#generate-a-long-lived-token) |

233| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}Removido em v2.1.160 e agora é um no-op. Anteriormente fixava [modo rápido](/pt/fast-mode) em Claude Opus 4.6 em vez do padrão atual. Para executar modo rápido em Opus 4.6 até sua aposentadoria, selecione o modelo com `/model` primeiro, depois `/fast on` |239| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}Removido em v2.1.160 e agora é um no-op. Anteriormente fixava [modo rápido](/pt/fast-mode) em Claude Opus 4.6 em vez do padrão atual. Para executar modo rápido em Opus 4.6 até sua aposentadoria, selecione o modelo com `/model` primeiro, depois `/fast on` |

240| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}Defina como `1` para escrever erros de diagnóstico do exportador OpenTelemetry para stderr. Por padrão, esses erros aparecem apenas com `--debug`, então um exportador mal configurado, como uma colisão de porta Prometheus, falha silenciosamente de outra forma. Requer Claude Code v2.1.179 ou posterior. Veja [Monitoramento](/pt/monitoring-usage) |

234| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Tempo limite em milissegundos para liberar spans OpenTelemetry pendentes (padrão: 5000). Veja [Monitoramento](/pt/monitoring-usage) |241| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Tempo limite em milissegundos para liberar spans OpenTelemetry pendentes (padrão: 5000). Veja [Monitoramento](/pt/monitoring-usage) |

235| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalo para atualizar cabeçalhos OpenTelemetry dinâmicos em milissegundos (padrão: 1740000 / 29 minutos). Veja [Cabeçalhos dinâmicos](/pt/monitoring-usage#dynamic-headers) |242| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalo para atualizar cabeçalhos OpenTelemetry dinâmicos em milissegundos (padrão: 1740000 / 29 minutos). Veja [Cabeçalhos dinâmicos](/pt/monitoring-usage#dynamic-headers) |

236| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Tempo limite em milissegundos para o exportador OpenTelemetry terminar no desligamento (padrão: 2000). Aumente se métricas forem descartadas na saída. Veja [Monitoramento](/pt/monitoring-usage) |243| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Tempo limite em milissegundos para o exportador OpenTelemetry terminar no desligamento (padrão: 2000). Aumente se métricas forem descartadas na saída. Veja [Monitoramento](/pt/monitoring-usage) |


242| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Defina como `1` para clonar fontes de plugin GitHub `owner/repo` via HTTPS em vez de SSH. Aplica-se a instalação de plugin e atualização, e a `/plugin marketplace add` e `update`. Útil em executores CI, contêineres ou qualquer ambiente sem uma chave SSH configurada para `github.com` |249| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Defina como `1` para clonar fontes de plugin GitHub `owner/repo` via HTTPS em vez de SSH. Aplica-se a instalação de plugin e atualização, e a `/plugin marketplace add` e `update`. Útil em executores CI, contêineres ou qualquer ambiente sem uma chave SSH configurada para `github.com` |

243| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Caminho para um ou mais diretórios de seed de plugin somente leitura, separados por `:` em Unix ou `;` no Windows. Use isso para agrupar um diretório de plugins pré-populado em uma imagem de contêiner. Claude Code registra marketplaces desses diretórios na inicialização e usa plugins pré-armazenados em cache sem re-clonar. Veja [Pré-popular plugins para contêineres](/pt/plugin-marketplaces#pre-populate-plugins-for-containers) |250| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Caminho para um ou mais diretórios de seed de plugin somente leitura, separados por `:` em Unix ou `;` no Windows. Use isso para agrupar um diretório de plugins pré-populado em uma imagem de contêiner. Claude Code registra marketplaces desses diretórios na inicialização e usa plugins pré-armazenados em cache sem re-clonar. Veja [Pré-popular plugins para contêineres](/pt/plugin-marketplaces#pre-populate-plugins-for-containers) |

244| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Defina como `1` para parar Claude Code de passar `-ExecutionPolicy Bypass` ao gerar PowerShell para chamadas de ferramenta, hooks e comandos de linha de status, e respeitar a política de execução efetiva da máquina em vez disso. Por padrão, Claude Code contorna a política de execução no escopo do processo para que scripts `.ps1` e importações de módulo funcionem em instalações Windows padrão com Restricted. O bypass no escopo do processo nunca substitui a Política de Grupo `MachinePolicy` ou `UserPolicy` independentemente dessa configuração |251| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Defina como `1` para parar Claude Code de passar `-ExecutionPolicy Bypass` ao gerar PowerShell para chamadas de ferramenta, hooks e comandos de linha de status, e respeitar a política de execução efetiva da máquina em vez disso. Por padrão, Claude Code contorna a política de execução no escopo do processo para que scripts `.ps1` e importações de módulo funcionem em instalações Windows padrão com Restricted. O bypass no escopo do processo nunca substitui a Política de Grupo `MachinePolicy` ou `UserPolicy` independentemente dessa configuração |

252| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Tempo máximo em milissegundos que [modo não interativo](/pt/headless#background-tasks-at-exit) com a flag `-p` aguarda após a volta final para subagentes em segundo plano e workflows cujo resultado faz parte da saída. Padrão: `600000`, ou 10 minutos. Quando o limite é excedido, tarefas em segundo plano restantes são encerradas e o processo sai. Defina como `0` para aguardar indefinidamente. Este limite é separado do período de carência de cinco segundos que se aplica a shells em segundo plano simples |

245| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Defina como `1` para propagar contexto de rastreamento W3C quando `ANTHROPIC_BASE_URL` aponta para um proxy personalizado. A propagação cobre o cabeçalho `traceparent` em solicitações de modelo e MCP HTTP e a variável de ambiente `TRACEPARENT` para subprocessos Bash, PowerShell e hook. Por padrão, a propagação é habilitada apenas quando conectado diretamente à API Anthropic. Adicionado em v2.1.152. Veja [Rastreamentos (beta)](/pt/monitoring-usage#traces-beta) |253| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Defina como `1` para propagar contexto de rastreamento W3C quando `ANTHROPIC_BASE_URL` aponta para um proxy personalizado. A propagação cobre o cabeçalho `traceparent` em solicitações de modelo e MCP HTTP e a variável de ambiente `TRACEPARENT` para subprocessos Bash, PowerShell e hook. Por padrão, a propagação é habilitada apenas quando conectado diretamente à API Anthropic. Adicionado em v2.1.152. Veja [Rastreamentos (beta)](/pt/monitoring-usage#traces-beta) |

246| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Definido por plataformas host que incorporam Claude Code e gerenciam roteamento de provedor de modelo em seu nome. Quando definido, seleção de provedor, endpoint e variáveis de autenticação como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` em arquivos de configuração são ignorados para que configurações de usuário não possam substituir o roteamento do host. O opt-out automático de telemetria para Bedrock, Vertex e Foundry também é ignorado, então a telemetria segue o opt-out padrão `DISABLE_TELEMETRY`. Veja [Comportamentos padrão por provedor de API](/pt/data-usage#default-behaviors-by-api-provider) |254| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Definido por plataformas host que incorporam Claude Code e gerenciam roteamento de provedor de modelo em seu nome. Quando definido, seleção de provedor, endpoint e variáveis de autenticação como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` em arquivos de configuração são ignorados para que configurações de usuário não possam substituir o roteamento do host. O opt-out automático de telemetria para Bedrock, Vertex e Foundry também é ignorado, então a telemetria segue o opt-out padrão `DISABLE_TELEMETRY`. Veja [Comportamentos padrão por provedor de API](/pt/data-usage#default-behaviors-by-api-provider) |

247| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy execute resolução DNS em vez do chamador. Opt-in para ambientes onde o proxy deve lidar com resolução de nome de host |255| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy execute resolução DNS em vez do chamador. Opt-in para ambientes onde o proxy deve lidar com resolução de nome de host |

248| `CLAUDE_CODE_REMOTE` | Definido automaticamente como `true` quando Claude Code está em execução como uma [sessão em nuvem](/pt/claude-code-on-the-web). Leia isso de um hook ou script de configuração para detectar se você está em um ambiente em nuvem |256| `CLAUDE_CODE_REMOTE` | Definido automaticamente como `true` quando Claude Code está em execução como uma [sessão em nuvem](/pt/claude-code-on-the-web). Leia isso de um hook ou script de configuração para detectar se você está em um ambiente em nuvem |

249| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definido automaticamente em [sessões em nuvem](/pt/claude-code-on-the-web) para o ID da sessão atual. Leia isso para construir um link de volta para a transcrição da sessão. Veja [Vincular artefatos de volta à sessão](/pt/claude-code-on-the-web#link-artifacts-back-to-the-session) |257| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definido automaticamente em [sessões em nuvem](/pt/claude-code-on-the-web) para o ID da sessão atual. Leia isso para construir um link de volta para a transcrição da sessão. Veja [Vincular saída de volta à sessão](/pt/claude-code-on-the-web#link-output-back-to-the-session) |

250| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Defina como `1` para retomar automaticamente se a sessão anterior terminou no meio de uma volta. Usado em modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt |258| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Defina como `1` para retomar automaticamente se a sessão anterior terminou no meio de uma volta. Usado em modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt |

251| `CLAUDE_CODE_RESUME_PROMPT` | Substitua a mensagem de continuação injetada ao retomar uma sessão que terminou no meio de uma volta. Padrão é `Continue from where you left off.`. Scripts de spawn para agentes de longa duração podem definir isso para uma mensagem de inicialização mais diretiva. Uma string vazia usa o padrão |259| `CLAUDE_CODE_RESUME_PROMPT` | Substitua a mensagem de continuação injetada ao retomar uma sessão que terminou no meio de uma volta. Padrão é `Continue from where you left off.`. Scripts de spawn para agentes de longa duração podem definir isso para uma mensagem de inicialização mais diretiva. Uma string vazia usa o padrão |

260| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}Defina como `1` para sessões não supervisionadas, como harnesses de avaliação, trabalhos CI ou workers remotos. Tenta novamente erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. O watchdog recua até 5 minutos entre tentativas, ou até o limite ser redefinido quando a resposta carrega um tempo de redefinição de limite de taxa, então uma sessão que atinge um limite de uso aguarda a janela restante. Requer Claude Code v2.1.186 ou posterior |

252| `CLAUDE_CODE_SAFE_MODE` | Defina como `1` para iniciar em modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos personalizados e agentes, 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, para solucionar problemas de uma configuração quebrada. 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. Equivalente a passar [`--safe-mode`](/pt/cli-reference#cli-flags). Processos filhos gerados diretamente herdam a variável |261| `CLAUDE_CODE_SAFE_MODE` | Defina como `1` para iniciar em modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos personalizados e agentes, 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, para solucionar problemas de uma configuração quebrada. 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. Equivalente a passar [`--safe-mode`](/pt/cli-reference#cli-flags). Processos filhos gerados diretamente herdam a variável |

253| `CLAUDE_CODE_SCRIPT_CAPS` | Objeto JSON limitando quantas vezes scripts específicos podem ser invocados por sessão quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` está definido. As chaves são substrings correspondidas contra o texto do comando; os valores são limites de chamadas inteiras. Por exemplo, `{"deploy.sh": 2}` permite que `deploy.sh` seja chamado no máximo duas vezes. A correspondência é baseada em substring, então truques de expansão de shell como `./scripts/deploy.sh $(evil)` ainda contam contra o limite. Fan-out em tempo de execução via `xargs` ou `find -exec` não é detectado; este é um controle de defesa em profundidade |262| `CLAUDE_CODE_SCRIPT_CAPS` | Objeto JSON limitando quantas vezes scripts específicos podem ser invocados por sessão quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` está definido. As chaves são substrings correspondidas contra o texto do comando; os valores são limites de chamadas inteiras. Por exemplo, `{"deploy.sh": 2}` permite que `deploy.sh` seja chamado no máximo duas vezes. A correspondência é baseada em substring, então truques de expansão de shell como `./scripts/deploy.sh $(evil)` ainda contam contra o limite. Fan-out em tempo de execução via `xargs` ou `find -exec` não é detectado; este é um controle de defesa em profundidade |

254| `CLAUDE_CODE_SCROLL_SPEED` | Defina o multiplicador de rolagem da roda do mouse em [renderização em tela cheia](/pt/fullscreen#mouse-wheel-scrolling). Aceita valores de 1 a 20 e valores fracionários abaixo de 1, como `0.5` para desacelerar a rolagem acelerada de trackpad e roda em terminais que já amplificam eventos de roda. Defina como `3` para corresponder a `vim` se seu terminal enviar um evento de roda por entalhe sem amplificação. Ignorado no terminal IDE JetBrains, onde Claude Code usa seu próprio tratamento de rolagem |263| `CLAUDE_CODE_SCROLL_SPEED` | Defina o multiplicador de rolagem da roda do mouse em [renderização em tela cheia](/pt/fullscreen#mouse-wheel-scrolling). Aceita valores de 1 a 20 e valores fracionários abaixo de 1, como `0.5` para desacelerar a rolagem acelerada de trackpad e roda em terminais que já amplificam eventos de roda. Defina como `3` para corresponder a `vim` se seu terminal enviar um evento de roda por entalhe sem amplificação. Ignorado no terminal IDE JetBrains, onde Claude Code usa seu próprio tratamento de rolagem |


316| `DISABLE_UPDATES` | Defina como `1` para bloquear todas as atualizações, incluindo manual `claude update` e `claude install`. Mais rigoroso que `DISABLE_AUTOUPDATER`. Use ao distribuir Claude Code através de seus próprios canais e usuários não devem auto-atualizar |325| `DISABLE_UPDATES` | Defina como `1` para bloquear todas as atualizações, incluindo manual `claude update` e `claude install`. Mais rigoroso que `DISABLE_AUTOUPDATER`. Use ao distribuir Claude Code através de seus próprios canais e usuários não devem auto-atualizar |

317| `DISABLE_UPGRADE_COMMAND` | Defina como `1` para ocultar o comando `/upgrade` |326| `DISABLE_UPGRADE_COMMAND` | Defina como `1` para ocultar o comando `/upgrade` |

318| `DO_NOT_TRACK` | Defina como `1` para optar por não participar da telemetria. Equivalente a definir `DISABLE_TELEMETRY`. Claude Code honra isso como a convenção padrão entre ferramentas reconhecida por muitos CLIs de desenvolvedor |327| `DO_NOT_TRACK` | Defina como `1` para optar por não participar da telemetria. Equivalente a definir `DISABLE_TELEMETRY`. Claude Code honra isso como a convenção padrão entre ferramentas reconhecida por muitos CLIs de desenvolvedor |

319| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para desabilitar [servidores MCP claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) no Claude Code. Habilitado por padrão para usuários conectados |328| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para desabilitar [servidores MCP claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) no Claude Code. Habilitado por padrão para usuários conectados. Para desabilitar por projeto ou por organização, defina [`disableClaudeAiConnectors`](/pt/settings#available-settings) em configurações em vez disso |

320| `ENABLE_PROMPT_CACHING_1H` | Defina como `1` para solicitar um TTL de cache de prompt de 1 hora em vez do padrão de 5 minutos. Destinado para usuários de chave de API, [Bedrock](/pt/amazon-bedrock), [Vertex](/pt/google-vertex-ai), [Foundry](/pt/microsoft-foundry) e [Claude Platform on AWS](/pt/claude-platform-on-aws). Usuários de assinatura recebem TTL de 1 hora automaticamente. Escritas de cache de 1 hora são cobradas a uma taxa mais alta |329| `ENABLE_PROMPT_CACHING_1H` | Defina como `1` para solicitar um TTL de cache de prompt de 1 hora em vez do padrão de 5 minutos. Destinado para usuários de chave de API, [Bedrock](/pt/amazon-bedrock), [Vertex](/pt/google-vertex-ai), [Foundry](/pt/microsoft-foundry) e [Claude Platform on AWS](/pt/claude-platform-on-aws). Usuários de assinatura recebem TTL de 1 hora automaticamente. Escritas de cache de 1 hora são cobradas a uma taxa mais alta |

321| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuado. Use `ENABLE_PROMPT_CACHING_1H` em vez disso |330| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuado. Use `ENABLE_PROMPT_CACHING_1H` em vez disso |

322| `ENABLE_TOOL_SEARCH` | Controla [busca de ferramentas MCP](/pt/mcp#scale-with-mcp-tool-search). Não definido: todas as ferramentas MCP adiadas por padrão, mas carregadas antecipadamente em Vertex AI ou quando `ANTHROPIC_BASE_URL` aponta para um host que não é de primeira parte. Valores: `true` (sempre adia e envia o cabeçalho beta, solicitações falham em modelos Vertex AI anteriores a Sonnet 4.5 ou Opus 4.5, ou em proxies que não suportam `tool_reference`), `auto` (modo de limite: carrega antecipadamente se as ferramentas se encaixarem em 10% do contexto), `auto:N` (limite personalizado, por exemplo, `auto:5` para 5%), `false` (carrega tudo antecipadamente) |331| `ENABLE_TOOL_SEARCH` | Controla [busca de ferramentas MCP](/pt/mcp#scale-with-mcp-tool-search). Não definido: todas as ferramentas MCP adiadas por padrão, mas carregadas antecipadamente em Vertex AI ou quando `ANTHROPIC_BASE_URL` aponta para um host que não é de primeira parte. Valores: `true` (sempre adia e envia o cabeçalho beta, solicitações falham em modelos Vertex AI anteriores a Sonnet 4.5 ou Opus 4.5, ou em proxies que não suportam `tool_reference`), `auto` (modo de limite: carrega antecipadamente se as ferramentas se encaixarem em 10% do contexto), `auto:N` (limite personalizado, por exemplo, `auto:5` para 5%), `false` (carrega tudo antecipadamente) |


340| `NO_PROXY` | Lista de domínios e IPs para os quais as solicitações serão emitidas diretamente, contornando proxy |349| `NO_PROXY` | Lista de domínios e IPs para os quais as solicitações serão emitidas diretamente, contornando proxy |

341| `OTEL_LOG_RAW_API_BODIES` | Emita solicitação e resposta JSON da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body`. Defina como `1` para corpos inline truncados em 60 KB, ou `file:<dir>` para escrever corpos não truncados em disco e emitir um caminho `body_ref` em vez disso. Desabilitado por padrão; corpos incluem todo o histórico de conversa. Veja [Monitoramento](/pt/monitoring-usage#api-request-body-event) |350| `OTEL_LOG_RAW_API_BODIES` | Emita solicitação e resposta JSON da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body`. Defina como `1` para corpos inline truncados em 60 KB, ou `file:<dir>` para escrever corpos não truncados em disco e emitir um caminho `body_ref` em vez disso. Desabilitado por padrão; corpos incluem todo o histórico de conversa. Veja [Monitoramento](/pt/monitoring-usage#api-request-body-event) |

342| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir conteúdo de entrada e saída de ferramenta em eventos de span OpenTelemetry. Desabilitado por padrão para proteger dados sensíveis. Veja [Monitoramento](/pt/monitoring-usage) |351| `OTEL_LOG_TOOL_CONTENT` | Defina como `1` para incluir conteúdo de entrada e saída de ferramenta em eventos de span OpenTelemetry. Desabilitado por padrão para proteger dados sensíveis. Veja [Monitoramento](/pt/monitoring-usage) |

343| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, strings de erro bruto em falhas de ferramenta e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. Veja [Monitoramento](/pt/monitoring-usage) |352| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, strings de erro bruto em falhas de ferramenta, a categoria de recusa em eventos `api_refusal` e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. Veja [Monitoramento](/pt/monitoring-usage) |

344| `OTEL_LOG_USER_PROMPTS` | Defina como `1` para incluir texto de prompt do usuário em rastreamentos e logs OpenTelemetry. Desabilitado por padrão (prompts são redatados). Veja [Monitoramento](/pt/monitoring-usage) |353| `OTEL_LOG_USER_PROMPTS` | Defina como `1` para incluir texto de prompt do usuário em rastreamentos e logs OpenTelemetry. Desabilitado por padrão (prompts são redatados). Veja [Monitoramento](/pt/monitoring-usage) |

345| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Defina como `false` para excluir UUID da conta dos atributos de métricas (padrão: incluído). Veja [Monitoramento](/pt/monitoring-usage) |354| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Defina como `false` para excluir UUID da conta dos atributos de métricas (padrão: incluído). Veja [Monitoramento](/pt/monitoring-usage) |

346| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Defina como `true` para incluir o ponto de entrada da sessão em atributos de métricas (padrão: excluído). Adicionado em v2.1.152. Veja [Monitoramento](/pt/monitoring-usage) |355| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Defina como `true` para incluir o ponto de entrada da sessão em atributos de métricas (padrão: excluído). Adicionado em v2.1.152. Veja [Monitoramento](/pt/monitoring-usage) |

errors.md +7 −3

Details

43| `OAuth token revoked` / `OAuth token has expired` | [Autenticação](#oauth-token-revoked-or-expired) |43| `OAuth token revoked` / `OAuth token has expired` | [Autenticação](#oauth-token-revoked-or-expired) |

44| `does not meet scope requirement user:profile` | [Autenticação](#oauth-scope-requirement) |44| `does not meet scope requirement user:profile` | [Autenticação](#oauth-scope-requirement) |

45| `Unable to connect to API` | [Rede](#unable-to-connect-to-api) |45| `Unable to connect to API` | [Rede](#unable-to-connect-to-api) |

46| `Waiting for API response · will retry in` | [Tentativas automáticas](#automatic-retries), ou [Rede](#unable-to-connect-to-api) se persistir |

46| `SSL certificate verification failed` | [Rede](#ssl-certificate-errors) |47| `SSL certificate verification failed` | [Rede](#ssl-certificate-errors) |

47| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Rede](#host-not-allowed-in-a-cloud-session) |48| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Rede](#host-not-allowed-in-a-cloud-session) |

48| `Prompt is too long` | [Erros de solicitação](#prompt-is-too-long) |49| `Prompt is too long` | [Erros de solicitação](#prompt-is-too-long) |


66 67 

67O Claude Code tenta novamente falhas transitórias antes de mostrar um erro. Erros de servidor, respostas sobrecarregadas, tempos limite de solicitação, throttles 429 temporários e conexões perdidas são todos repetidos até 10 vezes com backoff exponencial. Enquanto tenta novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y`.68O Claude Code tenta novamente falhas transitórias antes de mostrar um erro. Erros de servidor, respostas sobrecarregadas, tempos limite de solicitação, throttles 429 temporários e conexões perdidas são todos repetidos até 10 vezes com backoff exponencial. Enquanto tenta novamente, o spinner mostra uma contagem regressiva `Retrying in Ns · attempt x/y`.

68 69 

69Quando você um dos erros nesta página, essas tentativas foram esgotadas. Você pode ajustar o comportamento com duas variáveis de ambiente:70{/* min-version: 2.1.185 */}Se nenhum dado chegar no fluxo de resposta por 20 segundos enquanto uma solicitação ainda está pendente, o spinner mostra `Waiting for API response · will retry in … · check your network` antes de qualquer tentativa ter começado. A solicitação ainda não falhou: a contagem regressiva é executada até o ponto em que o Claude Code interrompe a conexão travada e tenta novamente, portanto o banner desaparece por conta própria assim que os dados retomam ou a tentativa é bem-sucedida. A partir da v2.1.185, o limite é de 20 segundos; versões anteriores mostram o banner após 10 segundos com uma redação diferente. Se reaparecer em cada tentativa, trate-o como um [problema de rede](#unable-to-connect-to-api).

71 

72Quando você vê um dos erros nesta página, essas tentativas já foram esgotadas. Você pode ajustar o comportamento com estas variáveis de ambiente:

70 73 

71| Variável | Padrão | Efeito |74| Variável | Padrão | Efeito |

72| :---------------------------------------- | :----- | :----------------------------------------------------------------------------------------------------------------------------------------- |75| :------------------------------------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

73| [`CLAUDE_CODE_MAX_RETRIES`](/pt/env-vars) | 10 | Número de tentativas de repetição. Reduza-o para expor falhas mais rapidamente em scripts; aumente-o para aguardar incidentes mais longos. |76| [`CLAUDE_CODE_MAX_RETRIES`](/pt/env-vars) | 10 | Número de tentativas de repetição. {/* min-version: 2.1.186 */}Limitado a 15 a partir da v2.1.186. Reduza-o para expor falhas mais rapidamente em scripts. |

77| [`CLAUDE_CODE_RETRY_WATCHDOG`](/pt/env-vars) | não definido | Defina como `1` em sessões autônomas, como trabalhos de CI, para repetir erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. |

74| [`API_TIMEOUT_MS`](/pt/env-vars) | 600000 | Tempo limite por solicitação em milissegundos. Aumente-o para redes lentas ou proxies. |78| [`API_TIMEOUT_MS`](/pt/env-vars) | 600000 | Tempo limite por solicitação em milissegundos. Aumente-o para redes lentas ou proxies. |

75 79 

76<h2 id="server-errors">80<h2 id="server-errors">

Details

46| **[Code intelligence](/pt/tools-reference#lsp-tool-behavior)** | Navegação e diagnósticos do language server | Linguagens tipadas, grandes bases de código onde grep é lento ou impreciso | Ir para a definição de um símbolo em vez de ler o arquivo inteiro |46| **[Code intelligence](/pt/tools-reference#lsp-tool-behavior)** | Navegação e diagnósticos do language server | Linguagens tipadas, grandes bases de código onde grep é lento ou impreciso | Ir para a definição de um símbolo em vez de ler o arquivo inteiro |

47| **MCP** | Conectar a serviços externos | Dados ou ações externas | Consultar seu banco de dados, postar no Slack, controlar um navegador |47| **MCP** | Conectar a serviços externos | Dados ou ações externas | Consultar seu banco de dados, postar no Slack, controlar um navegador |

48| **Hook** | Script, solicitação HTTP, prompt ou subagent disparado por eventos | Automação que deve ser executada em cada evento correspondente | Executar ESLint após cada edição de arquivo |48| **Hook** | Script, solicitação HTTP, prompt ou subagent disparado por eventos | Automação que deve ser executada em cada evento correspondente | Executar ESLint após cada edição de arquivo |

49| **[Artifact](/pt/artifacts)** | Publicar saída de sessão como uma página web privada e interativa | Saída que você quer ver ou compartilhar visualmente em vez de como texto de terminal | Uma linha do tempo de incidente que se atualiza conforme Claude investiga |

49 50 

50**[Plugins](/pt/plugins)** são a camada de empacotamento. Um plugin agrupa skills, hooks, subagents e servidores MCP em uma única unidade instalável. Skills de plugin são nomeadas (como `/my-plugin:review`) para que múltiplos plugins possam coexistir. Use plugins quando quiser reutilizar a mesma configuração em múltiplos repositórios ou distribuir para outros via um **[marketplace](/pt/plugin-marketplaces)**.51**[Plugins](/pt/plugins)** são a camada de empacotamento. Um plugin agrupa skills, hooks, subagents e servidores MCP em uma única unidade instalável. Skills de plugin são nomeadas (como `/my-plugin:review`) para que múltiplos plugins possam coexistir. Use plugins quando quiser reutilizar a mesma configuração em múltiplos repositórios ou distribuir para outros via um **[marketplace](/pt/plugin-marketplaces)**.

51 52 

fullscreen.md +2 −2

Details

44| :----------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------- |44| :----------------------------------------------------------- | :------------------------------------------------------------------------------------------- | :----------------------------------------------------------------- |

45| `Cmd+f` ou busca tmux para encontrar texto | `Ctrl+o` para modo de transcrição, depois `/` para buscar ou `[` para escrever no scrollback | [Buscar e revisar a conversa](#search-and-review-the-conversation) |45| `Cmd+f` ou busca tmux para encontrar texto | `Ctrl+o` para modo de transcrição, depois `/` para buscar ou `[` para escrever no scrollback | [Buscar e revisar a conversa](#search-and-review-the-conversation) |

46| Clique e arraste nativo do terminal para selecionar e copiar | Seleção no aplicativo, copia automaticamente ao soltar o mouse | [Usar o mouse](#use-the-mouse) |46| Clique e arraste nativo do terminal para selecionar e copiar | Seleção no aplicativo, copia automaticamente ao soltar o mouse | [Usar o mouse](#use-the-mouse) |

47| `Cmd`-clique para abrir uma URL | Clique na URL | [Usar o mouse](#use-the-mouse) |47| `Cmd`-clique para abrir uma URL | `Cmd`-clique no macOS, `Ctrl`-clique em outro lugar | [Usar o mouse](#use-the-mouse) |

48 48 

49Se a captura de mouse interferir no seu fluxo de trabalho, você pode [desativá-la](#keep-native-text-selection) mantendo a renderização sem cintilação.49Se a captura de mouse interferir no seu fluxo de trabalho, você pode [desativá-la](#keep-native-text-selection) mantendo a renderização sem cintilação.

50 50 


57* **Clique na entrada do prompt** para posicionar seu cursor em qualquer lugar no texto que você está digitando.57* **Clique na entrada do prompt** para posicionar seu cursor em qualquer lugar no texto que você está digitando.

58* **Clique em uma sugestão no comando `/` ou na lista de arquivo `@`** para aceitá-la. Passar o mouse destaca a linha sob seu cursor.58* **Clique em uma sugestão no comando `/` ou na lista de arquivo `@`** para aceitá-la. Passar o mouse destaca a linha sob seu cursor.

59* **Clique em um resultado de ferramenta recolhido** para expandi-lo e ver a saída completa. Clique novamente para recolher. A chamada de ferramenta e seu resultado se expandem juntos. Apenas mensagens que têm mais a mostrar são clicáveis.59* **Clique em um resultado de ferramenta recolhido** para expandi-lo e ver a saída completa. Clique novamente para recolher. A chamada de ferramenta e seu resultado se expandem juntos. Apenas mensagens que têm mais a mostrar são clicáveis.

60* **Clique em uma URL ou caminho de arquivo** para abri-lo. Caminhos de arquivo na saída da ferramenta, como os impressos após um Edit ou Write, abrem no seu aplicativo padrão. URLs simples `http://` e `https://` abrem no seu navegador. Na maioria dos terminais, isso substitui o `Cmd`-clique ou `Ctrl`-clique nativo, que a captura de mouse intercepta. No terminal integrado do VS Code e terminais semelhantes baseados em xterm.js, continue usando `Cmd`-clique. Claude Code defere para o próprio manipulador de links do terminal para evitar abrir links duas vezes.60* **Mantenha `Cmd` no macOS, ou `Ctrl` no Linux e Windows, e clique em uma URL ou caminho de arquivo** para abri-lo. Caminhos de arquivo na saída da ferramenta, como os impressos após um Edit ou Write, abrem no seu aplicativo padrão. URLs simples `http://` e `https://` abrem no seu navegador. A partir da v2.1.181, um clique simples sem manter `Cmd` ou `Ctrl` não abre mais links, correspondendo ao comportamento do terminal nativo. No terminal integrado do VS Code e terminais semelhantes baseados em xterm.js, Claude Code defere para o próprio manipulador de links do terminal, que usa o mesmo gesto.

61* **Clique e arraste** para selecionar texto em qualquer lugar da conversa. Clique duplo seleciona uma palavra, correspondendo aos limites de palavra do iTerm2 para que um caminho de arquivo seja selecionado como uma unidade. Clique triplo seleciona a linha.61* **Clique e arraste** para selecionar texto em qualquer lugar da conversa. Clique duplo seleciona uma palavra, correspondendo aos limites de palavra do iTerm2 para que um caminho de arquivo seja selecionado como uma unidade. Clique triplo seleciona a linha.

62* **Role com a roda do mouse** para se mover pela conversa.62* **Role com a roda do mouse** para se mover pela conversa.

63 63 

glossary.md +8 −0

Details

44 44 

45Saiba mais: [How Claude Code works](/pt/how-claude-code-works#the-agentic-loop)45Saiba mais: [How Claude Code works](/pt/how-claude-code-works#the-agentic-loop)

46 46 

47<h3 id="artifact">

48 Artifact

49</h3>

50 

51Uma página web ao vivo e interativa que Claude Code publica de sua sessão para uma URL privada em claude.ai, para que você possa ver a saída visualmente ou compartilhá-la dentro de sua organização em vez de ler texto de terminal. A página é atualizada no local quando a sessão republica. Os artefatos que você cria a partir do Claude Code aparecem na mesma galeria que os artefatos criados em conversas do claude.ai, mas seu compartilhamento se limita à sua organização e não podem ser tornados públicos.

52 

53Saiba mais: [Share session output as artifacts](/pt/artifacts)

54 

47<h3 id="auto-memory">55<h3 id="auto-memory">

48 Auto memory56 Auto memory

49</h3>57</h3>

headless.md +3 −1

Details

68 68 

69Se Claude iniciar uma [tarefa Bash em segundo plano](/pt/tools-reference#bash-tool-behavior) durante uma execução de `claude -p`, por exemplo um servidor de desenvolvimento ou uma compilação de observação, essa tarefa será encerrada cerca de cinco segundos após Claude retornar seu resultado final e stdin ter sido fechado. O período de carência permite que uma tarefa que termina logo após o resultado ainda entregue sua saída. Antes da v2.1.163, um processo em segundo plano que nunca sairia manteria a invocação de `claude -p` aberta indefinidamente.69Se Claude iniciar uma [tarefa Bash em segundo plano](/pt/tools-reference#bash-tool-behavior) durante uma execução de `claude -p`, por exemplo um servidor de desenvolvimento ou uma compilação de observação, essa tarefa será encerrada cerca de cinco segundos após Claude retornar seu resultado final e stdin ter sido fechado. O período de carência permite que uma tarefa que termina logo após o resultado ainda entregue sua saída. Antes da v2.1.163, um processo em segundo plano que nunca sairia manteria a invocação de `claude -p` aberta indefinidamente.

70 70 

71[Subagentos](/pt/sub-agents) em segundo plano e fluxos de trabalho estão isentos do período de carência de cinco segundos porque seu resultado faz parte da saída final, então `claude -p` aguarda sua conclusão. A partir da v2.1.182, essa espera é limitada a dez minutos por padrão para que um agente em segundo plano travado não possa manter o processo aberto indefinidamente. Ajuste o limite com [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/pt/env-vars), ou defina-o como `0` para aguardar sem limite.

72 

71<h2 id="examples">73<h2 id="examples">

72 Exemplos74 Exemplos

73</h2>75</h2>


232O sinalizador `--allowedTools` usa [sintaxe de regra de permissão](/pt/settings#permission-rule-syntax). O ` *` à direita habilita correspondência de prefixo, então `Bash(git diff *)` permite qualquer comando começando com `git diff`. O espaço antes de `*` é importante: sem ele, `Bash(git diff*)` também corresponderia a `git diff-index`.234O sinalizador `--allowedTools` usa [sintaxe de regra de permissão](/pt/settings#permission-rule-syntax). O ` *` à direita habilita correspondência de prefixo, então `Bash(git diff *)` permite qualquer comando começando com `git diff`. O espaço antes de `*` é importante: sem ele, `Bash(git diff*)` também corresponderia a `git diff-index`.

233 235 

234<Note>236<Note>

235 Skills invocadas pelo usuário e comandos personalizados funcionam no modo `-p`: inclua `/skill-name` na string de prompt e Claude Code o expande antes de executar. Comandos integrados que abrem um diálogo interativo, como `/config` e `/login`, não estão disponíveis no modo `-p`.237 Skills invocadas pelo usuário e comandos personalizados funcionam no modo `-p`: inclua `/skill-name` na string de prompt e Claude Code o expande antes de executar. Comandos integrados que abrem um diálogo interativo, como `/login`, não estão disponíveis no modo `-p`. {/* min-version: 2.1.181 */}Para alterar uma configuração de uma invocação `-p`, passe `key=value` para `/config`, por exemplo `/config thinking=false`.

236</Note>238</Note>

237 239 

238<h3 id="customize-the-system-prompt">240<h3 id="customize-the-system-prompt">

Details

326* Saia com `Escape`, `Backspace` ou `Ctrl+U` em um prompt vazio326* Saia com `Escape`, `Backspace` ou `Ctrl+U` em um prompt vazio

327* Colar texto que começa com `!` em um prompt vazio entra no modo bash automaticamente, correspondendo ao comportamento digitado `!`327* Colar texto que começa com `!` em um prompt vazio entra no modo bash automaticamente, correspondendo ao comportamento digitado `!`

328 328 

329A partir da v2.1.186, Claude responde à saída do comando automaticamente assim que ela chega à transcrição, para que você possa executar `! npm test` e obter uma explicação das falhas sem um segundo prompt. A resposta custa o mesmo que enviar um prompt normal. Para restaurar o comportamento anterior onde a saída é adicionada ao contexto sem uma resposta, defina [`respondToBashCommands`](/pt/settings#available-settings) para `false` em `settings.json`. Antes da v2.1.186, o modo shell sempre adicionava saída ao contexto sem uma resposta.

330 

329Isto é útil para operações rápidas de shell mantendo contexto de conversa.331Isto é útil para operações rápidas de shell mantendo contexto de conversa.

330 332 

331<h2 id="prompt-suggestions">333<h2 id="prompt-suggestions">

keybindings.md +5 −4

Details

347 Ações de configurações347 Ações de configurações

348</h3>348</h3>

349 349 

350Ações disponíveis no contexto `Settings`:350Ações disponíveis no contexto `Settings`. As ações `select:accept` e `confirm:no` são reutilizadas dos contextos [Select](#select-actions) e [Confirmation](#confirmation-actions) com comportamento específico de Configurações: as alterações se aplicam a cada configuração assim que você a altera, portanto Escape fecha o painel com suas alterações salvas em vez de recusar.

351 351 

352| Ação | Padrão | Descrição |352| Ação | Padrão | Descrição |

353| :---------------- | :----- | :-------------------------------------------------------------------------------------- |353| :---------------- | :----------- | :------------------------------------------------------ |

354| `settings:search` | / | Entrar no modo de busca |354| `settings:search` | / | Entrar no modo de busca |

355| `settings:retry` | R | Tentar novamente carregar dados de uso (em caso de erro) |355| `settings:retry` | R | Tentar novamente carregar dados de uso em caso de erro |

356| `settings:close` | Enter | Salvar alterações e fechar o painel de configuração. Escape descarta alterações e fecha |356| `select:accept` | Enter, Space | Alterar a configuração selecionada ou abrir seu submenu |

357| `confirm:no` | Escape | Fechar o painel. As alterações já foram salvas |

357 358 

358<h3 id="doctor-actions">359<h3 id="doctor-actions">

359 Ações de doctor360 Ações de doctor

managed-mcp.md +8 −1

Details

161| `deniedMcpServers` | Nenhum servidor bloqueado | Nenhum servidor bloqueado | Servidores correspondentes bloqueados |161| `deniedMcpServers` | Nenhum servidor bloqueado | Nenhum servidor bloqueado | Servidores correspondentes bloqueados |

162 162 

163<Warning>163<Warning>

164 Uma lista de permissão que usa apenas entradas `serverName` não é um controle de segurança. O nome é o rótulo que um usuário atribui ao executar `claude mcp add` ou editar um arquivo de configuração, não o servidor subjacente, portanto um usuário pode chamar qualquer servidor de `github`. Para aplicar quais servidores realmente são executados, adicione entradas `serverCommand` ou `serverUrl`.164 Uma entrada `serverName`, em qualquer lista, não é um controle de segurança. O nome é o rótulo que um usuário atribui ao executar `claude mcp add` ou editar um arquivo de configuração, não o servidor subjacente, portanto um usuário pode chamar qualquer servidor de `github`. Para conectores claude.ai, o nome é o nome de exibição retornado por claude.ai, que pode mudar. Para aplicar quais servidores realmente são executados, adicione entradas `serverCommand` ou `serverUrl`.

165</Warning>165</Warning>

166 166 

167A validação de `serverName` difere entre as duas listas:

168 

169* {/* min-version: 2.1.182 */}Em `deniedMcpServers`, `serverName` aceita qualquer string não vazia, portanto você pode bloquear [conectores claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) por seu nome de exibição. Por exemplo, `{ "serverName": "claude.ai Slack" }` bloqueia o conector Slack. Prefira uma entrada `serverUrl` quando você precisar que a negação seja robusta a renomeações, ou quando um nome de conector colide e ganha um sufixo ` (N)`.

170* Em `allowedMcpServers`, `serverName` é limitado a letras, números, hífens e sublinhados. Use `serverUrl` para adicionar um conector claude.ai à lista de permissão.

171 

172Para desativar todos os conectores claude.ai, veja [`disableClaudeAiConnectors`](/pt/mcp#disable-claude-ai-connectors).

173 

167<h3 id="how-a-server-is-evaluated">174<h3 id="how-a-server-is-evaluated">

168 Como um servidor é avaliado175 Como um servidor é avaliado

169</h3>176</h3>

mcp.md +39 −1

Details

554 * A autenticação OAuth funciona com servidores HTTP554 * A autenticação OAuth funciona com servidores HTTP

555</Tip>555</Tip>

556 556 

557<h3 id="authenticate-from-the-command-line">

558 Autenticar a partir da linha de comando

559</h3>

560 

561A partir da v2.1.186, `claude mcp login <name>` executa o fluxo OAuth de um servidor configurado diretamente do seu shell, para que você não precise abrir o painel `/mcp` dentro de uma sessão.

562 

563```bash theme={null}

564claude mcp login sentry

565```

566 

567Para limpar credenciais armazenadas depois, execute `claude mcp logout <name>`.

568 

569Quando você está conectado via SSH, adicione `--no-browser` para que o comando imprima a URL de autorização em vez de abrir um navegador. Abra a URL na sua máquina local, depois cole a URL de redirecionamento completa da barra de endereços do seu navegador de volta no prompt. O comando precisa de um terminal interativo para a etapa de colagem, então conecte com `ssh -t`.

570 

571```bash theme={null}

572claude mcp login sentry --no-browser

573```

574 

557<h3 id="use-a-fixed-oauth-callback-port">575<h3 id="use-a-fixed-oauth-callback-port">

558 Usar uma porta de callback OAuth fixa576 Usar uma porta de callback OAuth fixa

559</h3>577</h3>


852 870 

853Alguns conectores hospedados pela Anthropic, como Microsoft 365, Gmail e Google Calendar, não suportam OAuth local do Claude Code porque o provedor de identidade upstream aceita apenas a URL de redirecionamento que o claude.ai registrou. A partir da v2.1.162, autenticar um desses hosts em `/mcp` mostra uma mensagem direcionando você para conectá-lo em Configurações → Conectores no claude.ai. Uma vez conectado lá, o conector aparece no Claude Code automaticamente.871Alguns conectores hospedados pela Anthropic, como Microsoft 365, Gmail e Google Calendar, não suportam OAuth local do Claude Code porque o provedor de identidade upstream aceita apenas a URL de redirecionamento que o claude.ai registrou. A partir da v2.1.162, autenticar um desses hosts em `/mcp` mostra uma mensagem direcionando você para conectá-lo em Configurações → Conectores no claude.ai. Uma vez conectado lá, o conector aparece no Claude Code automaticamente.

854 872 

855Para desabilitar servidores MCP do claude.ai no Claude Code, defina a variável de ambiente `ENABLE_CLAUDEAI_MCP_SERVERS` como `false`:873<h3 id="disable-claude-ai-connectors">

874 Desabilitar conectores do claude.ai

875</h3>

876 

877Para desabilitar servidores MCP do claude.ai no Claude Code, defina [`disableClaudeAiConnectors`](/pt/settings#available-settings) como `true` em qualquer escopo de configurações:

878 

879```json theme={null}

880{

881 "disableClaudeAiConnectors": true

882}

883```

884 

885Esta configuração usa semântica any-source-true: `true` em qualquer fonte de configurações tem precedência. Um `.claude/settings.json` de projeto verificado pode optar um repositório por fora de conectores em nuvem, mas um `false` em nível de projeto não pode re-habilitar conectores que um `true` em nível de usuário ou política desabilitou. Servidores passados explicitamente via `--mcp-config` não são afetados.

886 

887Você também pode definir a variável de ambiente `ENABLE_CLAUDEAI_MCP_SERVERS` como `false`, que tem o mesmo efeito para a sessão de shell atual:

856 888 

857```bash theme={null}889```bash theme={null}

858ENABLE_CLAUDEAI_MCP_SERVERS=false claude890ENABLE_CLAUDEAI_MCP_SERVERS=false claude

859```891```

860 892 

893Para bloquear conectores individuais do claude.ai em vez de todos eles, adicione-os a [`deniedMcpServers`](/pt/managed-mcp) por nome ou por padrão de URL. Por exemplo, uma entrada `serverName` de `"claude.ai Slack"` bloqueia o conector Slack. Para alternar um conector ligado ou desligado apenas para o projeto atual, use o painel `/mcp`.

894 

895<Note>

896 Estas configurações do lado do cliente governam sessões locais do Claude Code. Em sessões do [Claude Code na web](/pt/claude-code-on-the-web), conectores do claude.ai são provisionados pelo host remoto e chegam como entradas explícitas `--mcp-config`, então `disableClaudeAiConnectors` não se aplica lá. URLs de conectores também são reescritas através do proxy de sessão, então um padrão `serverUrl` de `deniedMcpServers` direcionado à URL do fornecedor não corresponderá. Gerencie quais conectores uma sessão em nuvem pode usar a partir das configurações da sua organização no claude.ai.

897</Note>

898 

861<h2 id="use-claude-code-as-an-mcp-server">899<h2 id="use-claude-code-as-an-mcp-server">

862 Usar Claude Code como um servidor MCP900 Usar Claude Code como um servidor MCP

863</h2>901</h2>

Details

61 O servidor aparece com um indicador de status:61 O servidor aparece com um indicador de status:

62 62 

63 | Status | Significado |63 | Status | Significado |

64 | :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |64 | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

65 | `✓ Connected` | Pronto para usar. Isto é o que você deve ver para `claude-code-docs` |65 | `✓ Connected` | Pronto para usar. Isto é o que você deve ver para `claude-code-docs` |

66 | `! Connected · tools fetch failed` | O servidor conectou mas não conseguiu listar suas ferramentas. Execute `claude mcp get <name>` para obter o detalhe do erro |

66 | `! Needs authentication` | O servidor é alcançável mas precisa de um login no navegador, ou um token passado com `--header`. Consulte [Conectar um servidor que requer login](#connect-a-server-that-requires-sign-in) |67 | `! Needs authentication` | O servidor é alcançável mas precisa de um login no navegador, ou um token passado com `--header`. Consulte [Conectar um servidor que requer login](#connect-a-server-that-requires-sign-in) |

67 | `✗ Failed to connect` | O servidor não respondeu. Consulte [Troubleshooting](#troubleshooting) |68 | `✗ Failed to connect` | O servidor não respondeu. Consulte [Troubleshooting](#troubleshooting) |

68 | `✗ Connection error` | A tentativa de conexão lançou um erro. Consulte [Troubleshooting](#troubleshooting) |69 | `✗ Connection error` | A tentativa de conexão lançou um erro. Consulte [Troubleshooting](#troubleshooting) |

model-config.md +2 −0

Details

94 94 

95Quando o modelo ativo na inicialização vem das configurações do projeto ou gerenciadas em vez de sua própria seleção, o cabeçalho de inicialização mostra qual arquivo de configurações o definiu. Execute `/model` para substituir; a configuração do projeto ou gerenciada reaplicada no próximo lançamento.95Quando o modelo ativo na inicialização vem das configurações do projeto ou gerenciadas em vez de sua própria seleção, o cabeçalho de inicialização mostra qual arquivo de configurações o definiu. Execute `/model` para substituir; a configuração do projeto ou gerenciada reaplicada no próximo lançamento.

96 96 

97Quando o modelo solicitado tem uma data de aposentadoria programada ou é automaticamente remapeado para uma versão mais recente, Claude Code mostra um aviso que nomeia o modelo solicitado. As sessões interativas o mostram como um aviso de inicialização. A partir da v2.1.182, o mesmo aviso é escrito em stderr no [modo não interativo](/pt/headless) ao usar o formato de saída de texto padrão. A verificação também cobre um `model` definido no [frontmatter de subagentos](/pt/sub-agents). O aviso stderr é suprimido para `--output-format json` e `stream-json`; leia o modelo real do campo `modelUsage` da [mensagem de resultado](/pt/headless#get-structured-output).

98 

97Exemplo de uso:99Exemplo de uso:

98 100 

99```bash theme={null}101```bash theme={null}

Details

701 Evento de recusa de API701 Evento de recusa de API

702</h4>702</h4>

703 703 

704Registrado quando uma solicitação de API retorna `stop_reason: "refusal"`. Recusas chegam em um fluxo de resposta bem-sucedido em vez de como um erro HTTP, então o evento `api_error` não dispara para elas. Este evento permite rastrear a frequência de recusa.704Registrado quando uma solicitação de API retorna `stop_reason: "refusal"`. Recusas chegam em um fluxo de resposta bem-sucedido em vez de como um erro HTTP, então o evento `api_error` não dispara para elas. Este evento permite rastrear a frequência de recusa e agrupar recusas pelos mesmos atributos que `api_request` e `api_error`.

705 705 

706**Nome do Evento**: `claude_code.api_refusal`706**Nome do Evento**: `claude_code.api_refusal`

707 707 


713* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão713* `event.sequence`: Contador monotonicamente crescente para ordenar eventos dentro de uma sessão

714* `model`: Identificador do modelo da solicitação714* `model`: Identificador do modelo da solicitação

715* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.715* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta, como `"req_011..."`. Presente apenas quando a API retorna um.

716* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente. Veja [`api_request`](#api-request-event) para definições.

717* `speed`: Ou `"fast"` quando [Fast mode](/pt/fast-mode) está ativo, ou `"normal"`

718* `attempt`: Número de tentativa de repetição. A primeira tentativa é `1`.

719* `effort`: [Nível de esforço](/pt/model-config#adjust-effort-level) aplicado à solicitação. Ausente quando o modelo não suporta esforço.

720* `server_fallback_hop`: `true` quando o fallback de modelo do lado do servidor da API já tentou novamente esta recusa em um modelo diferente, então o usuário não viu esta recusa particular. `false` quando a solicitação terminou em uma recusa. Uma única rodada pode emitir tanto um evento hop `true` quanto um evento final `false` posterior quando o modelo de fallback também recusa.

721* `has_category`: `true` quando a resposta da API carregava um `stop_details.category` de `"cyber"`, `"bio"`, `"frontier_llm"` ou `"reasoning_extraction"`. `false` quando a resposta não carregava categoria ou um valor fora desse conjunto. Ausente quando `server_fallback_hop` é `true`, porque blocos hop não carregam `stop_details`.

722* `has_explanation`: `true` quando a resposta da API carregava um `stop_details.explanation`, caso contrário `false`. Ausente quando `server_fallback_hop` é `true`.

723* `category`: O valor `stop_details.category` da resposta da API. Um de `"cyber"`, `"bio"`, `"frontier_llm"` ou `"reasoning_extraction"`. Presente apenas quando `OTEL_LOG_TOOL_DETAILS=1` está definido e `has_category` é `true`.

724* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Atribuição de skill, plugin, agente e MCP para a solicitação. Veja [Contador de custo](#cost-counter) para definições e comportamento de redação.

716 725 

717<h4 id="api-request-body-event">726<h4 id="api-request-body-event">

718 Evento de corpo de solicitação de API727 Evento de corpo de solicitação de API


1155 1164 

1156Claude Code retenta solicitações de API falhadas internamente e emite um único evento `claude_code.api_error` apenas depois de desistir, então o evento em si é o sinal terminal para essa solicitação. Tentativas de repetição intermediárias não são registradas como eventos separados.1165Claude Code retenta solicitações de API falhadas internamente e emite um único evento `claude_code.api_error` apenas depois de desistir, então o evento em si é o sinal terminal para essa solicitação. Tentativas de repetição intermediárias não são registradas como eventos separados.

1157 1166 

1158O atributo `attempt` no evento registra quantas tentativas foram feitas no total. Um valor maior que `CLAUDE_CODE_MAX_RETRIES` (padrão `10`) indica que a solicitação esgotou todas as tentativas em um erro transitório. Um valor menor indica um erro não retentável como uma resposta `400`.1167O atributo `attempt` no evento registra quantas tentativas foram feitas no total. Um valor maior que `CLAUDE_CODE_MAX_RETRIES` (padrão `10`, limitado a `15`) indica que a solicitação esgotou todas as tentativas em um erro transitório. Um valor menor indica um erro não retentável como uma resposta `400`.

1159 1168 

1160Para distinguir uma sessão que se recuperou de uma que travou, agrupe eventos por `session.id` e verifique se um evento `api_request` posterior existe após o erro.1169Para distinguir uma sessão que se recuperou de uma que travou, agrupe eventos por `session.id` e verifique se um evento `api_request` posterior existe após o erro.

1161 1170 

Details

117Claude Code requer acesso aos seguintes URLs. Coloque esses URLs na lista de permissões em sua configuração de proxy e regras de firewall, especialmente em ambientes de rede containerizados ou restritos.117Claude Code requer acesso aos seguintes URLs. Coloque esses URLs na lista de permissões em sua configuração de proxy e regras de firewall, especialmente em ambientes de rede containerizados ou restritos.

118 118 

119| URL | Necessário para |119| URL | Necessário para |

120| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |120| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

121| `api.anthropic.com` | Solicitações da API Claude |121| `api.anthropic.com` | Solicitações da API Claude |

122| `claude.ai` | Autenticação de conta claude.ai |122| `claude.ai` | Autenticação de conta claude.ai |

123| `platform.claude.com` | Autenticação de conta do Anthropic Console |123| `platform.claude.com` | Autenticação de conta do Anthropic Console |

124| `downloads.claude.ai` | Downloads de executáveis de plugins; instalador nativo e atualizador automático nativo |124| `downloads.claude.ai` | Downloads de executáveis de plugins; instalador nativo e atualizador automático nativo |

125| `storage.googleapis.com` | {/* max-version: 2.1.115 */}Instalador nativo e atualizador automático nativo em versões anteriores a 2.1.116 |125| `storage.googleapis.com` | {/* max-version: 2.1.115 */}Instalador nativo e atualizador automático nativo em versões anteriores a 2.1.116 |

126| `bridge.claudeusercontent.com` | Ponte WebSocket da extensão [Claude no Chrome](/pt/chrome) |126| `bridge.claudeusercontent.com` | Ponte WebSocket da extensão [Claude no Chrome](/pt/chrome) |

127| `*.claudeusercontent.com` | Visualização de [artefatos](/pt/artifacts) no claude.ai. O visualizador carrega o conteúdo de cada artefato de um subdomínio isolado dessa origem. Necessário no navegador do visualizador, não pelo próprio CLI |

127| `raw.githubusercontent.com` | Feed de changelog para [`/release-notes`](/pt/commands) e as notas de lançamento mostradas após atualizar; contagens de instalação do marketplace de plugins |128| `raw.githubusercontent.com` | Feed de changelog para [`/release-notes`](/pt/commands) e as notas de lançamento mostradas após atualizar; contagens de instalação do marketplace de plugins |

128 129 

129Se você instalar Claude Code através do npm ou gerenciar sua própria distribuição binária, os usuários finais podem não precisar de acesso a `downloads.claude.ai` ou `storage.googleapis.com`.130Se você instalar Claude Code através do npm ou gerenciar sua própria distribuição binária, os usuários finais podem não precisar de acesso a `downloads.claude.ai` ou `storage.googleapis.com`.

Details

235* Modificação de infraestrutura compartilhada235* Modificação de infraestrutura compartilhada

236* Destruição irreversível de arquivos que existiam antes da sessão236* Destruição irreversível de arquivos que existiam antes da sessão

237* Force push ou push direto para `main`237* Force push ou push direto para `main`

238* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop`, ou `git stash clear`, que o classificador presume que descartariam alterações não confirmadas

239* `git commit --amend` quando o commit no HEAD não foi criado nesta sessão

240* `terraform destroy`, `pulumi destroy`, `cdk destroy`, ou `terragrunt destroy`, e aplicar um plano que destrói recursos

238 241 

239**Permitido por padrão**:242**Permitido por padrão**:

240 243 

permissions.md +2 −2

Details

400Os seguintes tipos de configuração são carregados de diretórios `--add-dir`:400Os seguintes tipos de configuração são carregados de diretórios `--add-dir`:

401 401 

402| Configuração | Carregado de `--add-dir` |402| Configuração | Carregado de `--add-dir` |

403| :--------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |403| :--------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

404| [Skills](/pt/skills) em `.claude/skills/` | Sim, com recarga ao vivo |404| [Skills](/pt/skills) em `.claude/skills/` | Sim, com recarga ao vivo |

405| [Subagentes](/pt/sub-agents) em `.claude/agents/` | Sim |405| [Subagentes](/pt/sub-agents) em `.claude/agents/` | Sim |

406| Configurações de plugin em `.claude/settings.json` | Apenas `enabledPlugins` e `extraKnownMarketplaces` |406| [Configurações](/pt/settings) em `.claude/settings.json` e `.claude/settings.local.json` | Apenas chaves `enabledPlugins` e `extraKnownMarketplaces` |

407| Arquivos [CLAUDE.md](/pt/memory), `.claude/rules/` e `CLAUDE.local.md` | Apenas quando `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` está definido. `CLAUDE.local.md` adicionalmente requer a fonte de configuração `local`, que é ativada por padrão |407| Arquivos [CLAUDE.md](/pt/memory), `.claude/rules/` e `CLAUDE.local.md` | Apenas quando `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` está definido. `CLAUDE.local.md` adicionalmente requer a fonte de configuração `local`, que é ativada por padrão |

408 408 

409Comandos e estilos de saída são descobertos do diretório de trabalho atual e seus pais, seu diretório de usuário em `~/.claude/` e configurações gerenciadas. Hooks e outras chaves `settings.json` são carregadas da pasta `.claude/` do diretório de trabalho atual sem fallback de diretório pai, juntamente com seu `~/.claude/settings.json` de usuário e configurações gerenciadas. Para compartilhar essa configuração entre projetos, use uma destas abordagens:409Comandos e estilos de saída são descobertos do diretório de trabalho atual e seus pais, seu diretório de usuário em `~/.claude/` e configurações gerenciadas. Hooks e outras chaves `settings.json` são carregadas da pasta `.claude/` do diretório de trabalho atual sem fallback de diretório pai, juntamente com seu `~/.claude/settings.json` de usuário e configurações gerenciadas. Para compartilhar essa configuração entre projetos, use uma destas abordagens:

Details

201 Entradas de plugin201 Entradas de plugin

202</h2>202</h2>

203 203 

204Cada entrada de plugin no array `plugins` descreve um plugin e onde encontrá-lo. Você pode incluir qualquer campo do [esquema de manifesto de plugin](/pt/plugins-reference#plugin-manifest-schema) (como `description`, `version`, `author`, `commands`, `hooks`, etc.), além destes campos específicos do marketplace: `source`, `category`, `tags` e `strict`.204Cada entrada de plugin no array `plugins` descreve um plugin e onde encontrá-lo. Você pode incluir qualquer campo do [esquema de manifesto de plugin](/pt/plugins-reference#plugin-manifest-schema) (como `description`, `version`, `author`, `commands`, `hooks`, etc.), além destes campos específicos do marketplace: `source`, `category`, `tags`, `strict` e `relevance`.

205 205 

206<h3 id="required-fields">206<h3 id="required-fields-1">

207 Campos obrigatórios207 Campos obrigatórios

208</h3>208</h3>

209 209 


231| `category` | string | Categoria do plugin para organização |231| `category` | string | Categoria do plugin para organização |

232| `tags` | array | Tags para pesquisabilidade |232| `tags` | array | Tags para pesquisabilidade |

233| `strict` | boolean | Controla se `plugin.json` é a autoridade para definições de componentes (padrão: true). Veja [Strict mode](#strict-mode) abaixo. |233| `strict` | boolean | Controla se `plugin.json` é a autoridade para definições de componentes (padrão: true). Veja [Strict mode](#strict-mode) abaixo. |

234| `relevance` | object | {/* min-version: 2.1.152 */}Sinais que informam ao Claude Code quando sugerir este plugin aos usuários. Tem efeito apenas para marketplaces que um administrador coloca na lista de permissões em configurações gerenciadas. Veja [Recomendar plugins para sua organização](/pt/plugin-relevance). Requer Claude Code v2.1.152 ou posterior. |

234| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Se o plugin está habilitado após a instalação (padrão: true). Defina como `false` para instalar o plugin desabilitado até que o usuário opte por ativá-lo. Tem precedência sobre o mesmo campo no `plugin.json` do plugin. Veja [Default enablement](/pt/plugins-reference#default-enablement). Requer Claude Code v2.1.154 ou posterior. |235| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Se o plugin está habilitado após a instalação (padrão: true). Defina como `false` para instalar o plugin desabilitado até que o usuário opte por ativá-lo. Tem precedência sobre o mesmo campo no `plugin.json` do plugin. Veja [Default enablement](/pt/plugins-reference#default-enablement). Requer Claude Code v2.1.154 ou posterior. |

235 236 

236**Campos de configuração de componentes:**237**Campos de configuração de componentes:**


269 Por exemplo, um marketplace hospedado em `acme-corp/plugin-catalog` (fonte de marketplace) pode listar um plugin buscado de `acme-corp/code-formatter` (fonte de plugin). A fonte de marketplace e a fonte de plugin apontam para repositórios diferentes e são fixadas independentemente.270 Por exemplo, um marketplace hospedado em `acme-corp/plugin-catalog` (fonte de marketplace) pode listar um plugin buscado de `acme-corp/code-formatter` (fonte de plugin). A fonte de marketplace e a fonte de plugin apontam para repositórios diferentes e são fixadas independentemente.

270</Note>271</Note>

271 272 

272Os tipos de fonte baseados em git abaixo são `github`, `url` e `git-subdir`. Quando tanto `ref` quanto `sha` são definidos em qualquer um deles, o `sha` é o pino efetivo. Claude Code busca e faz checkout do commit fixado diretamente, então a instalação é bem-sucedida mesmo se o branch ou tag nomeado por `ref` tenha sido deletado upstream, desde que o commit ainda seja alcançável a partir do repositório.273Os tipos de fonte baseados em git abaixo são `github`, `url` e `git-subdir`. Quando tanto `ref` quanto `sha` são definidos em qualquer um deles, o `sha` é o pino efetivo. Claude Code busca e faz checkout do commit fixado diretamente. Na maioria dos hosts git, incluindo GitHub, GitLab e Bitbucket, isso significa que a instalação é bem-sucedida mesmo se o branch ou tag nomeado por `ref` tenha sido deletado upstream, desde que o commit ainda seja alcançável a partir do repositório. Alguns servidores, como AWS CodeCommit, não suportam busca de commits por SHA. Nesses servidores, o `ref` ainda deve existir e o commit fixado deve ser alcançável a partir dele.

273 274 

274<h3 id="relative-paths">275<h3 id="relative-paths">

275 Caminhos relativos276 Caminhos relativos


507* **`${CLAUDE_PLUGIN_ROOT}`**: use esta variável em hooks e configurações de MCP server para referenciar arquivos dentro do diretório de instalação do plugin. Isso é necessário porque os plugins são copiados para um local de cache quando instalados. Para dependências ou estado que devem sobreviver a atualizações de plugin, use [`${CLAUDE_PLUGIN_DATA}`](/pt/plugins-reference#persistent-data-directory) em vez disso.508* **`${CLAUDE_PLUGIN_ROOT}`**: use esta variável em hooks e configurações de MCP server para referenciar arquivos dentro do diretório de instalação do plugin. Isso é necessário porque os plugins são copiados para um local de cache quando instalados. Para dependências ou estado que devem sobreviver a atualizações de plugin, use [`${CLAUDE_PLUGIN_DATA}`](/pt/plugins-reference#persistent-data-directory) em vez disso.

508* **`strict: false`**: Como isso está definido como false, o plugin não precisa de seu próprio `plugin.json`. A entrada de marketplace define tudo. Veja [Strict mode](#strict-mode) abaixo.509* **`strict: false`**: Como isso está definido como false, o plugin não precisa de seu próprio `plugin.json`. A entrada de marketplace define tudo. Veja [Strict mode](#strict-mode) abaixo.

509 510 

510Por padrão, as skills de um plugin são carregadas do diretório `skills/` sob sua `source`, e quaisquer caminhos listados sob `skills` adicionam a essa varredura. A exceção é uma fonte de raiz de marketplace como `source: "./"`, onde várias entradas de plugin compartilham uma pasta `skills/`. Nesse caso, listar subdiretórios específicos sob `skills` torna essa lista o conjunto completo para a entrada, e outros diretórios sob `skills/` não são carregados. Listar o próprio diretório `skills/` ou a raiz do plugin mantém a varredura completa. Se nenhum dos caminhos listados existir, a varredura padrão é executada em vez disso.511Por padrão, as skills de um plugin são carregadas do diretório `skills/` sob sua `source`. Os caminhos listados no campo `skills` adicionam a essa varredura:

512 

513```json theme={null}

514"skills": ["./skills/", "./extra-skills/"]

515```

516 

517Quando várias entradas de plugin compartilham uma pasta `skills/` na raiz do marketplace (`source: "./"`), liste subdiretórios específicos em vez disso para que cada entrada carregue apenas suas próprias skills:

518 

519```json theme={null}

520"source": "./",

521"skills": ["./skills/code-review", "./skills/docs"]

522```

523 

524Com uma `source` de raiz de marketplace, os caminhos listados são o conjunto completo para essa entrada, e outros diretórios na pasta `skills/` compartilhada não são carregados. Listar `./skills/` em si, ou a raiz do plugin, mantém a varredura completa. Se nenhum dos caminhos listados existir, a varredura padrão é executada em vez disso.

511 525 

512<h3 id="strict-mode">526<h3 id="strict-mode">

513 Strict mode527 Strict mode


1078* Verifique se os diretórios de plugin contêm arquivos obrigatórios1092* Verifique se os diretórios de plugin contêm arquivos obrigatórios

1079* Para fontes GitHub, garanta que repositórios são públicos ou você tem acesso1093* Para fontes GitHub, garanta que repositórios são públicos ou você tem acesso

1080* Teste fontes de plugin manualmente clonando/baixando1094* Teste fontes de plugin manualmente clonando/baixando

1081* Se a fonte fixa tanto `ref` quanto `sha`, uma branch ou tag upstream deletada não bloqueia a instalação. Se a instalação ainda falhar, confirme que o commit fixado ainda existe no repositório1095* Se a fonte fixa tanto `ref` quanto `sha`, uma branch ou tag upstream deletada não bloqueia a instalação na maioria dos hosts git, incluindo GitHub, GitLab e Bitbucket. Em servidores que não suportam busca de commits por SHA, como AWS CodeCommit, o `ref` ainda deve existir e o commit fixado deve ser alcançável a partir dele. Se a instalação ainda falhar, confirme que o commit fixado ainda existe no repositório

1082 1096 

1083<h3 id="private-repository-authentication-fails">1097<h3 id="private-repository-authentication-fails">

1084 Falha de autenticação de repositório privado1098 Falha de autenticação de repositório privado

plugin-relevance.md +188 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Recomende plugins para sua organização

6 

7> Adicione um bloco de relevância às entradas de plugins do marketplace para que Claude Code os sugira quando o trabalho de um usuário corresponder.

8 

9Se você opera um marketplace de plugins para sua organização, pode fazer com que Claude Code sugira plugins específicos aos usuários com base no que estão trabalhando. Adicione um bloco `relevance` à entrada de um plugin em `marketplace.json`, depois coloque o marketplace na lista de permissões nas configurações gerenciadas. Quando a sessão de um usuário corresponder a um dos sinais declarados, Claude Code exibe uma sugestão de instalação para esse plugin.

10 

11As sugestões declaradas pelo marketplace são opcionais por marketplace através das [configurações gerenciadas](/pt/settings#settings-files). Nenhuma declaração de `relevance` de um marketplace produz sugestões até que um administrador a adicione à lista de permissões, incluindo o marketplace oficial da Anthropic. Claude Code também inclui uma sugestão integrada que é independente dessa lista de permissões; essa dica e todas as dicas declaradas pelo marketplace são desabilitadas quando [`spinnerTipsEnabled`](/pt/settings#available-settings) é definido como `false`.

12 

13{/* min-version: 2.1.152 */}Este recurso requer Claude Code v2.1.152 ou posterior. Clientes mais antigos ignoram o campo `relevance`.

14 

15Esta página é para operadores de marketplace e administradores corporativos. Se você está procurando instalar plugins, consulte [Descobrir e instalar plugins](/pt/discover-plugins).

16 

17<h2 id="how-it-works">

18 Como funciona

19</h2>

20 

21Cada entrada de plugin em `marketplace.json` pode conter um objeto `relevance`. O objeto nomeia um tópico e um ou mais sinais. Um sinal é um padrão que Claude Code testa contra a sessão atual, como o diretório de trabalho ou arquivos que Claude leu.

22 

23A correspondência de sinais acontece localmente na máquina do usuário. A correspondência não adiciona tráfego de rede e não relata quais sinais corresponderam, ou seus valores, à Anthropic ou ao operador do marketplace.

24 

25Quando um sinal corresponde e o plugin ainda não está instalado, Claude Code mostra o plugin em três lugares:

26 

27* **Dica do spinner**: uma mensagem "Trabalhando com *tópico*? Instale o plugin *plugin*" com o comando `/plugin install` aparece abaixo do spinner enquanto Claude está respondendo.

28* **Sugestão de início de sessão**: {/* min-version: 2.1.153 */}se o sinal `cwd` corresponder ao diretório de trabalho, uma notificação de uma linha `plugin suggestion: <name>@<marketplace> · /plugin` aparece antes do primeiro turno. Esta superfície requer Claude Code v2.1.153 ou posterior.

29* **Aba Discover do `/plugin`**: {/* min-version: 2.1.154 */}o plugin é fixado no topo da lista Discover com uma anotação como "sugerido para este diretório" ou "sugerido para comandos stripe". Esta superfície requer Claude Code v2.1.154 ou posterior.

30 

31A dica do spinner e a notificação de início de sessão fazem parte do sistema de dicas do spinner. Ambas são desabilitadas quando o usuário ou projeto define `spinnerTipsEnabled` como `false`, ou quando um `spinnerTipsOverride` personalizado é configurado com `excludeDefault`. O pino da aba Discover é independente das configurações de dicas.

32 

33Claude Code nunca instala um plugin automaticamente. O usuário sempre confirma.

34 

35<h2 id="add-relevance-to-a-plugin-entry">

36 Adicione relevância a uma entrada de plugin

37</h2>

38 

39Adicione um objeto `relevance` à entrada do plugin em seu `marketplace.json`. O exemplo a seguir declara que o plugin `terraform-helpers` é relevante quando Claude lê um arquivo `.tf` ou quando Claude executa `terraform`:

40 

41```json theme={null}

42{

43 "name": "acme-corp-plugins",

44 "owner": { "name": "Acme Platform Team" },

45 "plugins": [

46 {

47 "name": "terraform-helpers",

48 "source": "./plugins/terraform-helpers",

49 "description": "Acme conventions and helpers for Terraform",

50 "relevance": {

51 "topic": "Terraform",

52 "signals": {

53 "cli": ["terraform"],

54 "filesRead": ["**/*.tf"]

55 }

56 }

57 }

58 ]

59}

60```

61 

62Um plugin com um bloco `relevance` mas sem sinal correspondente se comporta como qualquer outra entrada do marketplace. Ele aparece na lista Discover em sua posição normal e nunca aparece como uma dica do spinner.

63 

64<h2 id="field-reference">

65 Referência de campos

66</h2>

67 

68<h3 id="relevance">

69 `relevance`

70</h3>

71 

72| Campo | Tipo | Descrição |

73| :-------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

74| `topic` | string | Opcional. A frase que preenche "Trabalhando com *tópico*?" na dica do spinner. Geralmente o nome do produto, por exemplo `Stripe`. Use um domínio como `design` quando o nome do plugin não se lê naturalmente como um tópico. Padrão é o nome do plugin com cada segmento de hífen capitalizado. A notificação de início de sessão não usa este valor. Máximo 64 caracteres. |

75| `signals` | object | Correspondentes que determinam quando o plugin é relevante. Pelo menos um sinal é necessário para que o plugin seja sugerível. Veja a tabela abaixo. |

76 

77<h3 id="relevance-signals">

78 `relevance.signals`

79</h3>

80 

81| Campo | Tipo | Descrição |

82| :------------- | :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

83| `cwd` | array of strings | {/* min-version: 2.1.153 */}Padrões Glob correspondidos contra o diretório de trabalho da sessão. Correspondido como um caminho absoluto e, quando dentro de um repositório git, como um caminho relativo à raiz do repositório. Normalizado com barra invertida e insensível a maiúsculas/minúsculas. Cada padrão corresponde ao diretório em si e a tudo sob ele, então `infra`, `infra/`, e `infra/**` se comportam de forma idêntica. Este é o único sinal que pode corresponder no início da sessão, antes do primeiro turno. Máximo 10 padrões de 256 caracteres cada. |

84| `cli` | array of strings | Nomes de comando de comandos shell que Claude executou nesta sessão, por exemplo `["stripe"]`. Aplica-se em todas as plataformas: comandos executados no Windows através do PowerShell ou Git Bash são registrados da mesma forma. Claude Code registra um nome de comando por invocação de ferramenta shell: o primeiro token após qualquer atribuição de variável de ambiente inicial e `sudo`. Comandos compostos contribuem apenas com seu comando inicial, então `cd infra && terraform plan` registra `cd`, não `terraform`. Correspondência exata. Máximo 10 entradas de 64 caracteres cada. |

85| `hosts` | array of strings | Nomes de host vistos em URLs `http://` ou `https://` em comandos Bash nesta sessão, por exemplo `["api.stripe.com"]`. Apenas nome de host em minúsculas: sem esquema, porta ou caminho. Correspondência exata insensível a maiúsculas/minúsculas. Máximo 20 entradas de 128 caracteres cada. |

86| `filesRead` | array of strings | {/* min-version: 2.1.153 */}Padrões Glob correspondidos contra os caminhos de arquivos que Claude leu nesta sessão, por exemplo `["**/*.tf"]`. Normalizado com barra invertida e insensível a maiúsculas/minúsculas. Máximo 10 padrões de 256 caracteres cada. |

87| `manifestDeps` | array of objects | Dependências declaradas em manifestos de pacote que Claude leu nesta sessão. Cada entrada é `{ "file": "...", "pattern": "..." }`, onde `file` é uma expressão regular correspondida contra o caminho do arquivo de manifesto conforme registrado no estado da sessão, normalmente um caminho absoluto, e `pattern` é uma expressão regular correspondida contra o conteúdo desse arquivo. Âncora `file` no final, por exemplo `[/\\\\]package\\.json$` em forma com escape JSON, porque um padrão ancorado no início nunca corresponde a um caminho absoluto. Os caminhos não são normalizados por separador para este sinal, então os caminhos do Windows usam barras invertidas. Arquivos de manifesto maiores que 512 KB são ignorados. Ambos os valores são strings de origem `RegExp` do JavaScript de no máximo 256 caracteres. `file` corresponde insensível a maiúsculas/minúsculas. `pattern` é sensível a maiúsculas/minúsculas. Máximo 10 entradas. |

88 

89Os sinais `cli`, `hosts`, `filesRead` e `manifestDeps` precisam de histórico de sessão, então eles só podem corresponder na dica do spinner e na aba Discover. Apenas `cwd` pode corresponder no início da sessão. Os sinais `filesRead` e `manifestDeps` testam o estado de arquivo registrado da sessão, que também inclui arquivos que Claude escreveu ou editou e arquivos de memória `CLAUDE.md` carregados automaticamente.

90 

91O exemplo a seguir usa `manifestDeps` para sugerir um plugin Stripe uma vez que Claude leu um `package.json` que depende de `stripe`. O padrão `file` usa `[/\\\\]` para que corresponda tanto a separadores de caminho com barra invertida quanto com barra invertida, e `\\.` para que o ponto seja literal. Em JSON, cada barra invertida na expressão regular é escrita duas vezes.

92 

93```json theme={null}

94{

95 "name": "stripe-helpers",

96 "source": "./plugins/stripe-helpers",

97 "relevance": {

98 "topic": "Stripe",

99 "signals": {

100 "manifestDeps": [

101 {

102 "file": "[/\\\\]package\\.json$",

103 "pattern": "\"stripe\"\\s*:"

104 }

105 ]

106 }

107 }

108}

109```

110 

111<Note>

112 Campos desconhecidos sob `relevance` e `relevance.signals` são ignorados no tempo de carregamento para que clientes Claude Code mais antigos continuem carregando seu marketplace. Execute `claude plugin validate` para exibi-los como avisos.

113</Note>

114 

115<h2 id="enable-suggestions-in-managed-settings">

116 Ative sugestões nas configurações gerenciadas

117</h2>

118 

119Declarar `relevance` em `marketplace.json` não é suficiente por si só. Um administrador deve colocar o marketplace na lista de permissões nas [configurações gerenciadas](/pt/settings#settings-files) antes que suas sugestões apareçam aos usuários.

120 

121Adicione o nome do marketplace a `pluginSuggestionMarketplaces`. Para qualquer marketplace que não seja o marketplace oficial da Anthropic, também declare a fonte do marketplace nas mesmas configurações gerenciadas, seja como entrada desse nome em `extraKnownMarketplaces` ou como entrada em `strictKnownMarketplaces`. O nome colocado na lista de permissões é ignorado se o marketplace registrado na máquina veio de uma fonte diferente. Isso impede que uma fonte não relacionada se registre sob um nome colocado na lista de permissões para ter seus plugins sugeridos em toda sua organização.

122 

123O `managed-settings.json` a seguir registra um marketplace de organização de um repositório GitHub e ativa suas sugestões:

124 

125```json theme={null}

126{

127 "extraKnownMarketplaces": {

128 "acme-corp-plugins": {

129 "source": {

130 "source": "github",

131 "repo": "acme-corp/claude-plugins"

132 }

133 }

134 },

135 "pluginSuggestionMarketplaces": ["acme-corp-plugins"]

136}

137```

138 

139O marketplace oficial está isento do requisito de declaração de fonte porque seu nome só pode ser registrado da fonte oficial da Anthropic. Colocar apenas o nome na lista de permissões é suficiente:

140 

141```json theme={null}

142{

143 "pluginSuggestionMarketplaces": ["claude-plugins-official"]

144}

145```

146 

147Consulte a [referência de configurações](/pt/settings) para `pluginSuggestionMarketplaces` e [`extraKnownMarketplaces`](/pt/settings#extraknownmarketplaces) para detalhes completos de configuração.

148 

149<h2 id="what-the-user-sees">

150 O que o usuário vê

151</h2>

152 

153Quando um sinal corresponde durante uma sessão, a dica do spinner lê:

154 

155```text theme={null}

156Working with Terraform? Install the terraform-helpers plugin:

157/plugin install terraform-helpers@acme-corp-plugins

158```

159 

160No início da sessão, um sinal `cwd` correspondente exibe a notificação de uma linha:

161 

162```text theme={null}

163plugin suggestion: terraform-helpers@acme-corp-plugins · /plugin

164```

165 

166A sugestão de um determinado plugin aparece no máximo uma vez a cada três sessões entre a dica do spinner e a notificação de início de sessão combinadas, e nenhuma se repete uma vez que o plugin está instalado. A notificação de início de sessão também para de aparecer após a sugestão ter sido mostrada duas vezes.

167 

168{/* min-version: 2.1.154 */}Na aba Discover do `/plugin`, o plugin é fixado acima dos outros resultados com uma anotação que nomeia o sinal correspondente, como `suggested for this directory` ou `suggested for terraform commands`. A aba Discover fixa um determinado plugin uma vez; visitas posteriores o listam em ordem normal. O pino da aba Discover requer Claude Code v2.1.154 ou posterior. Na v2.1.152 apenas a dica do spinner aparece; a notificação de início de sessão é adicionada na v2.1.153.

169 

170<h2 id="validate-your-marketplace">

171 Valide seu marketplace

172</h2>

173 

174Execute `claude plugin validate` contra seu diretório de marketplace para verificar o bloco `relevance` antes de publicar:

175 

176```

177claude plugin validate ./my-marketplace

178```

179 

180O validador relata chaves desconhecidas sob `relevance` e `relevance.signals` como avisos, sinaliza um valor `relevance` que não é um objeto, e rejeita uma entrada `signals.hosts` que inclui um esquema, porta ou caminho.

181 

182<h2 id="see-also">

183 Veja também

184</h2>

185 

186* [Crie e distribua um marketplace de plugins](/pt/plugin-marketplaces): construa o marketplace que hospeda seus plugins

187* [Recomende seu plugin a partir de sua CLI](/pt/plugin-hints): solicite aos usuários a partir de sua própria CLI em vez de dos sinais de sessão do Claude Code

188* [Configurações](/pt/settings): referência completa para `pluginSuggestionMarketplaces` e `extraKnownMarketplaces`

Details

632Se um caminho personalizado substitui ou estende o diretório padrão do plugin depende do campo:632Se um caminho personalizado substitui ou estende o diretório padrão do plugin depende do campo:

633 633 

634* **Substitui o padrão**: `commands`, `agents`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Por exemplo, quando o manifesto especifica `commands`, o diretório padrão `commands/` não é verificado. Para manter o padrão e adicionar mais, liste-o explicitamente: `"commands": ["./commands/", "./extras/"]`634* **Substitui o padrão**: `commands`, `agents`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Por exemplo, quando o manifesto especifica `commands`, o diretório padrão `commands/` não é verificado. Para manter o padrão e adicionar mais, liste-o explicitamente: `"commands": ["./commands/", "./extras/"]`

635* **Adiciona ao padrão**: `skills`. O diretório padrão `skills/` é sempre verificado, e diretórios listados em `skills` são carregados junto com ele. Exceção: para uma [entrada do marketplace cuja `source` resolve para a raiz do marketplace](/pt/plugin-marketplaces#advanced-plugin-entries), declarar subdiretórios específicos substitui a verificação635* **Adiciona ao padrão**: `skills`. O diretório padrão `skills/` é sempre verificado, e diretórios listados em `skills` são carregados junto com ele. Exceção: para uma [entrada do marketplace cuja `source` resolve para a raiz do marketplace](/pt/plugin-marketplaces#advanced-plugin-entries), declarar subdiretórios específicos substitui a verificação padrão `skills/`

636* **Regras de mesclagem próprias**: [hooks](#hooks), [MCP servers](#mcp-servers) e [LSP servers](#lsp-servers). Veja cada seção para como múltiplas fontes se combinam636* **Regras de mesclagem próprias**: [hooks](#hooks), [MCP servers](#mcp-servers) e [LSP servers](#lsp-servers). Veja cada seção para como múltiplas fontes se combinam

637 637 

638Quando um plugin tem tanto uma pasta padrão quanto a chave de manifesto correspondente, Claude Code v2.1.140 e posterior sinaliza a pasta ignorada em `/doctor`, `claude plugin list` e a visualização de detalhes `/plugin`. O plugin ainda carrega usando os caminhos do manifesto. Nenhum aviso é mostrado quando a chave de manifesto aponta para a pasta padrão, por exemplo `"commands": ["./commands/deploy.md"]`, porque a pasta é abordada explicitamente nesse caso.638Quando um plugin tem tanto uma pasta padrão quanto a chave de manifesto correspondente, Claude Code v2.1.140 e posterior sinaliza a pasta ignorada em `/doctor`, `claude plugin list` e a visualização de detalhes `/plugin`. O plugin ainda carrega usando os caminhos do manifesto. Nenhum aviso é mostrado quando a chave de manifesto aponta para a pasta padrão, por exemplo `"commands": ["./commands/deploy.md"]`, porque a pasta é abordada explicitamente nesse caso.

prompt-library.md +1319 −0

Details

6 6 

7> Copie e cole prompts para Claude Code, marcados por tarefa e função.7> Copie e cole prompts para Claude Code, marcados por tarefa e função.

8 8 

9export const PromptLibrary = ({text = {}, labels = {}, tagLabels = {}, phaseLabels = {}, sourceLabels = {}, catLabels = {}}) => {

10 const RAW = useMemo(() => [{

11 id: 'get-oriented-in-a',

12 sdlc: 'discover',

13 cat: 'Onboard',

14 startN: 1,

15 roles: [],

16 prompt: 'give me an overview of this codebase: architecture, key directories, and how the pieces connect',

17 nextHref: '/en/memory',

18 src: 'workflows'

19 }, {

20 id: 'explain-unfamiliar-code',

21 sdlc: 'discover',

22 cat: 'Understand',

23 roles: [],

24 prompt: 'explain what {path} does and how data flows through it. write it up as {format}',

25 slots: {

26 path: 'src/scheduler/queue.ts',

27 format: 'an HTML page with a diagram, then open it in my browser'

28 },

29 nextHref: '/en/output-styles',

30 src: 'workflows'

31 }, {

32 id: 'find-where-something-happens',

33 sdlc: 'discover',

34 cat: 'Understand',

35 startN: 2,

36 roles: [],

37 prompt: 'where do we {behavior}?',

38 slots: {

39 behavior: 'validate uploaded file types'

40 },

41 src: 'workflows'

42 }, {

43 id: 'see-what-depends-on',

44 sdlc: 'discover',

45 cat: 'Understand',

46 roles: [],

47 prompt: 'what would break if I deleted {target}?',

48 slots: {

49 target: 'the retryWithBackoff helper'

50 },

51 src: 'workflows'

52 }, {

53 id: 'trace-how-code-evolved',

54 sdlc: 'discover',

55 cat: 'Understand',

56 roles: [],

57 prompt: 'look through the commit history of {path} and summarize how it evolved and why',

58 slots: {

59 path: 'internal/auth/session.go'

60 },

61 src: 'best-practices'

62 }, {

63 id: 'scope-a-change-before',

64 sdlc: 'discover',

65 cat: 'Understand',

66 roles: ['pm', 'design'],

67 prompt: 'which files would I need to touch to {change}?',

68 slots: {

69 change: 'add a dark mode toggle to settings'

70 },

71 src: 'teams'

72 }, {

73 id: 'ask-the-codebase-a',

74 sdlc: 'discover',

75 cat: 'Understand',

76 roles: ['pm'],

77 prompt: 'I am a {role}. walk me through what happens when a user {action}, from the UI down to the result',

78 slots: {

79 role: 'PM',

80 action: 'clicks Export to PDF'

81 },

82 nextHref: '/en/output-styles',

83 src: 'teams'

84 }, {

85 id: 'plan-a-multi-file',

86 sdlc: 'design',

87 cat: 'Plan',

88 roles: ['pm', 'design'],

89 prompt: 'plan how to refactor the {target} to {goal}. list the files you would change, but don\'t edit anything yet',

90 slots: {

91 target: 'payment module',

92 goal: 'support multiple currencies'

93 },

94 src: 'workflows'

95 }, {

96 id: 'draft-a-spec-by',

97 sdlc: 'design',

98 cat: 'Plan',

99 roles: ['pm'],

100 prompt: 'I want to build {feature}. interview me about implementation, UX, edge cases, and tradeoffs until we have covered everything, then write the spec to SPEC.md',

101 slots: {

102 feature: 'per-workspace rate limits'

103 },

104 nextHref: '/en/skills',

105 src: 'best-practices'

106 }, {

107 id: 'turn-a-meeting-into',

108 sdlc: 'design',

109 cat: 'Plan',

110 roles: ['pm'],

111 prompt: 'read {input} and write up the action items, then create a {tracker} ticket for each with acceptance criteria',

112 slots: {

113 input: '@meeting-notes.md',

114 tracker: 'Linear'

115 },

116 needs: 'tracker',

117 nextHref: '/en/skills',

118 src: 'teams'

119 }, {

120 id: 'map-edge-cases-before',

121 sdlc: 'design',

122 cat: 'Plan',

123 roles: ['design', 'pm'],

124 prompt: 'list the error states, empty states, and edge cases for {feature} that the design needs to cover',

125 slots: {

126 feature: 'the file upload flow'

127 },

128 src: 'teams'

129 }, {

130 id: 'turn-a-mockup-into',

131 sdlc: 'design',

132 cat: 'Prototype',

133 roles: ['design', 'pm', 'marketing'],

134 paste: 'mockup',

135 prompt: 'here is a mockup. build a working prototype I can click through, matching the layout and states shown',

136 src: 'teams'

137 }, {

138 id: 'implement-from-a-screenshot',

139 sdlc: 'design',

140 cat: 'Prototype',

141 roles: ['design'],

142 paste: 'design',

143 needs: 'browser',

144 prompt: 'implement this design, then take a screenshot of the result, compare it to the original, and fix any differences',

145 nextHref: '/en/goal',

146 src: 'best-practices'

147 }, {

148 id: 'follow-an-existing-pattern',

149 sdlc: 'build',

150 cat: 'Implement',

151 roles: [],

152 prompt: 'look at how {example} is implemented to understand the pattern, then build {new} the same way',

153 slots: {

154 example: 'the GitHub webhook handler',

155 new: 'a Stripe webhook handler'

156 },

157 nextHref: '/en/memory',

158 src: 'best-practices'

159 }, {

160 id: 'generate-docs-for-code',

161 sdlc: 'build',

162 cat: 'Implement',

163 roles: ['docs'],

164 prompt: 'find {scope} without {format} comments and add them, matching the style already used in the file',

165 slots: {

166 scope: 'the public functions in src/auth/',

167 format: 'JSDoc'

168 },

169 src: 'workflows'

170 }, {

171 id: 'add-a-small-well',

172 sdlc: 'build',

173 cat: 'Implement',

174 roles: [],

175 prompt: 'add a {endpoint} endpoint that returns {payload}',

176 slots: {

177 endpoint: '/health',

178 payload: 'the app version and uptime'

179 },

180 src: 'workflows'

181 }, {

182 id: 'build-a-small-internal',

183 sdlc: 'build',

184 cat: 'Implement',

185 roles: ['pm', 'design', 'marketing', 'docs'],

186 prompt: 'create a {tool} using HTML, CSS, and vanilla JavaScript, then open it in my browser',

187 slots: {

188 tool: 'drag-and-drop Kanban board with three columns'

189 },

190 src: 'teams'

191 }, {

192 id: 'work-an-issue-end',

193 sdlc: 'build',

194 cat: 'Implement',

195 roles: [],

196 prompt: 'read issue #{issue}, implement the fix, and run the tests',

197 slots: {

198 issue: '312'

199 },

200 needs: 'gh',

201 src: 'workflows'

202 }, {

203 id: 'find-and-update-copy',

204 sdlc: 'build',

205 cat: 'Implement',

206 roles: ['design', 'docs', 'marketing'],

207 prompt: 'find every place we say "{copy}" or a close variant, show me each one in context, then update them all to "{new}". leave tests and the changelog alone',

208 slots: {

209 copy: 'Sign up free',

210 new: 'Start free trial'

211 },

212 src: 'teams'

213 }, {

214 id: 'draft-from-past-examples',

215 sdlc: 'build',

216 cat: 'Implement',

217 roles: ['docs', 'marketing', 'pm'],

218 prompt: 'read the {examples} in {folder} to learn the structure and voice, then draft a new one for {topic}',

219 slots: {

220 examples: 'privacy impact assessments',

221 folder: 'legal/pia/',

222 topic: 'the new analytics integration'

223 },

224 nextHref: '/en/skills',

225 src: 'legal'

226 }, {

227 id: 'write-tests-run-them',

228 sdlc: 'build',

229 cat: 'Test',

230 startN: 4,

231 roles: [],

232 prompt: 'write tests for {path}, run them, and fix any failures',

233 slots: {

234 path: 'app/parsers/feed.py'

235 },

236 nextHref: '/en/memory',

237 src: 'workflows'

238 }, {

239 id: 'drive-implementation-from-tests',

240 sdlc: 'build',

241 cat: 'Test',

242 roles: [],

243 prompt: 'write tests for {feature} first, then implement it until they pass',

244 slots: {

245 feature: 'the password reset flow'

246 },

247 src: 'ebook'

248 }, {

249 id: 'fill-gaps-from-a',

250 sdlc: 'build',

251 cat: 'Test',

252 roles: [],

253 prompt: 'read {report} and add tests for the lowest-covered files until each is above {target}%',

254 slots: {

255 report: 'coverage/coverage-summary.json',

256 target: '80'

257 },

258 nextHref: '/en/goal',

259 src: 'workflows'

260 }, {

261 id: 'migrate-a-pattern-across',

262 sdlc: 'build',

263 cat: 'Refactor',

264 roles: [],

265 prompt: 'migrate everything from {from} to {to}: identify every place that needs to change, then make the changes',

266 slots: {

267 from: 'the old logging API',

268 to: 'the structured logger'

269 },

270 src: 'workflows'

271 }, {

272 id: 'port-code-between-languages',

273 sdlc: 'build',

274 cat: 'Refactor',

275 roles: [],

276 prompt: 'port {source} to {target}, keeping the same {keep}',

277 slots: {

278 source: 'this Python module',

279 target: 'Rust',

280 keep: 'public API and test behavior'

281 },

282 src: 'teams'

283 }, {

284 id: 'optimize-against-a-measurable',

285 sdlc: 'build',

286 cat: 'Refactor',

287 roles: ['data'],

288 prompt: 'optimize {target} to bring {metric} from {current} down to under {goal}',

289 slots: {

290 target: 'the search query',

291 metric: 'p95 latency',

292 current: '2s',

293 goal: '500ms'

294 },

295 nextHref: '/en/goal',

296 src: 'ebook'

297 }, {

298 id: 'fix-a-precise-visual',

299 sdlc: 'build',

300 cat: 'Refactor',

301 roles: ['design'],

302 prompt: 'the {element} extends {amount} beyond the {container} on {viewport}. fix it.',

303 slots: {

304 element: 'login button',

305 amount: '20px',

306 container: 'card border',

307 viewport: 'mobile'

308 },

309 nextHref: '/en/desktop#preview-your-app',

310 src: 'ebook'

311 }, {

312 id: 'review-your-changes-before',

313 sdlc: 'build',

314 cat: 'Review',

315 startN: 5,

316 roles: [],

317 prompt: 'review my uncommitted changes and flag anything that looks risky before I commit',

318 nextHref: '/en/commands',

319 src: 'workflows'

320 }, {

321 id: 'review-a-pull-request',

322 sdlc: 'build',

323 cat: 'Review',

324 roles: [],

325 prompt: 'review PR #{pr} and summarize what changed, then list any concerns',

326 slots: {

327 pr: '247'

328 },

329 needs: 'gh',

330 nextHref: '/en/code-review',

331 src: 'workflows'

332 }, {

333 id: 'review-infrastructure-changes-before',

334 sdlc: 'build',

335 cat: 'Review',

336 roles: ['security', 'ops'],

337 paste: 'plan',

338 prompt: 'here is my Terraform plan output. what is this going to do, and is anything here going to cause problems?',

339 src: 'teams'

340 }, {

341 id: 'run-a-security-review',

342 sdlc: 'build',

343 cat: 'Review',

344 roles: ['security'],

345 prompt: 'use a subagent to review {path} for security issues and report what it finds',

346 slots: {

347 path: 'src/api/'

348 },

349 nextHref: '/en/sub-agents',

350 src: 'best-practices'

351 }, {

352 id: 'review-content-before-sending',

353 sdlc: 'build',

354 cat: 'Review',

355 roles: ['marketing', 'docs'],

356 prompt: 'review {file} for {concerns} and list anything I should fix before it goes to {reviewer}',

357 slots: {

358 file: 'launch-post.md',

359 concerns: 'unsupported claims, missing attributions, and brand-guideline issues',

360 reviewer: 'legal'

361 },

362 nextHref: '/en/skills',

363 src: 'legal'

364 }, {

365 id: 'course-correct-a-wrong',

366 sdlc: 'build',

367 cat: 'Steer',

368 roles: [],

369 prompt: 'that is not right: {feedback}. try a different approach',

370 slots: {

371 feedback: 'the function signature needs to stay backward-compatible'

372 },

373 nextHref: '/en/checkpointing',

374 src: 'best-practices'

375 }, {

376 id: 'narrow-the-scope-of',

377 sdlc: 'build',

378 cat: 'Steer',

379 roles: [],

380 prompt: 'that is too much. keep only the changes to {scope} and undo your other edits',

381 slots: {

382 scope: 'the validation logic in src/forms/'

383 },

384 src: 'best-practices'

385 }, {

386 id: 'turn-a-correction-into',

387 sdlc: 'build',

388 cat: 'Steer',

389 roles: [],

390 prompt: 'you keep {mistake}. add a rule to CLAUDE.md so this stops happening',

391 slots: {

392 mistake: 'using default exports when this project uses named exports'

393 },

394 nextHref: '/en/memory',

395 src: 'best-practices'

396 }, {

397 id: 'resolve-merge-conflicts',

398 sdlc: 'ship',

399 cat: 'Git',

400 roles: [],

401 prompt: 'resolve the merge conflicts in this branch and explain what you kept from each side',

402 src: 'workflows'

403 }, {

404 id: 'commit-with-a-generated',

405 sdlc: 'ship',

406 cat: 'Git',

407 roles: [],

408 prompt: 'commit these changes with a message that summarizes what I did',

409 src: 'workflows'

410 }, {

411 id: 'open-a-pull-request',

412 sdlc: 'ship',

413 cat: 'Git',

414 roles: [],

415 prompt: 'find the {tracker} ticket about {topic} and open a PR that implements it',

416 slots: {

417 tracker: 'Linear',

418 topic: 'the login timeout'

419 },

420 needs: 'tracker',

421 src: 'workflows'

422 }, {

423 id: 'draft-release-notes-from',

424 sdlc: 'ship',

425 cat: 'Release',

426 roles: ['pm', 'docs', 'marketing'],

427 prompt: 'compare {from} to {to} and draft release notes grouped by feature, fix, and breaking change',

428 slots: {

429 from: 'v2.3.0',

430 to: 'v2.4.0'

431 },

432 nextHref: '/en/skills',

433 src: 'workflows'

434 }, {

435 id: 'write-a-ci-workflow',

436 sdlc: 'ship',

437 cat: 'Release',

438 roles: ['ops'],

439 prompt: 'write a GitHub Actions workflow that {steps} on every push to {branch}',

440 slots: {

441 steps: 'runs the tests and deploys to staging',

442 branch: 'main'

443 },

444 src: 'workflows'

445 }, {

446 id: 'find-and-fix-a',

447 sdlc: 'operate',

448 cat: 'Debug',

449 startN: 3,

450 roles: [],

451 prompt: 'the {test} test is failing, find out why and fix it',

452 slots: {

453 test: 'UserAuth'

454 },

455 src: 'workflows'

456 }, {

457 id: 'investigate-a-reported-error',

458 sdlc: 'operate',

459 cat: 'Debug',

460 roles: ['ops'],

461 prompt: 'users are seeing {symptom} on {where}. investigate and tell me what is going on',

462 slots: {

463 symptom: '500 errors',

464 where: '/api/settings'

465 },

466 nextHref: '/en/web-quickstart#pre-fill-sessions',

467 src: 'workflows'

468 }, {

469 id: 'fix-a-build-error',

470 sdlc: 'operate',

471 cat: 'Debug',

472 roles: ['ops'],

473 paste: 'error',

474 prompt: 'here is a build error. fix the root cause and verify the build succeeds',

475 src: 'best-practices'

476 }, {

477 id: 'investigate-a-production-incident',

478 sdlc: 'operate',

479 cat: 'Incident',

480 roles: ['ops', 'security'],

481 prompt: '{symptom}. check the logs, recent deploys, and config changes, then tell me the most likely cause',

482 slots: {

483 symptom: 'the checkout endpoint started returning 500s an hour ago'

484 },

485 nextHref: '/en/mcp',

486 src: 'workflows'

487 }, {

488 id: 'diagnose-from-a-console',

489 sdlc: 'operate',

490 cat: 'Incident',

491 roles: ['ops', 'data'],

492 paste: 'screenshot',

493 prompt: 'here is a screenshot of {console}. walk me through why {resource} is failing and give me the exact commands to fix it',

494 slots: {

495 console: 'the GCP Kubernetes dashboard',

496 resource: 'this pod'

497 },

498 src: 'teams'

499 }, {

500 id: 'query-logs-in-plain',

501 sdlc: 'operate',

502 cat: 'Incident',

503 roles: ['security', 'ops', 'data'],

504 prompt: 'show me all {events} for {scope} over {timeframe}. write the query, run it, and tell me what stands out',

505 slots: {

506 events: 'failed logins',

507 scope: 'the auth service',

508 timeframe: 'the past 24 hours'

509 },

510 needs: 'db',

511 src: 'cybersecurity'

512 }, {

513 id: 'analyze-a-data-file',

514 sdlc: 'operate',

515 cat: 'Data',

516 roles: ['data', 'pm', 'marketing'],

517 paste: 'csv',

518 prompt: 'read {file}, summarize the key patterns, and write the results to {output}',

519 slots: {

520 file: '@reports/q1-signups.csv',

521 output: 'an HTML page with charts, then open it in my browser'

522 },

523 nextHref: '/en/mcp',

524 src: 'teams'

525 }, {

526 id: 'generate-variations-from-performance',

527 sdlc: 'operate',

528 cat: 'Data',

529 roles: ['marketing', 'data'],

530 paste: 'csv',

531 prompt: 'read {file}, find the underperforming {items}, and generate {n} new variations that stay under {limit} characters',

532 slots: {

533 file: '@ads-performance.csv',

534 items: 'headlines',

535 n: '20',

536 limit: '90'

537 },

538 nextHref: '/en/mcp',

539 src: 'teams'

540 }, {

541 id: 'turn-a-recurring-task',

542 sdlc: 'operate',

543 cat: 'Automate',

544 roles: [],

545 prompt: 'create a /{name} skill for this project that {steps}',

546 slots: {

547 name: 'ship',

548 steps: 'runs the linter and tests, then drafts a commit message'

549 },

550 src: 'workflows'

551 }, {

552 id: 'add-a-hook-for',

553 sdlc: 'operate',

554 cat: 'Automate',

555 roles: [],

556 prompt: 'write a hook that {action} after every {event}',

557 slots: {

558 action: 'runs prettier',

559 event: 'edit to a .ts or .tsx file'

560 },

561 src: 'best-practices'

562 }, {

563 id: 'connect-a-tool-with',

564 sdlc: 'operate',

565 cat: 'Automate',

566 roles: [],

567 prompt: 'set up the {server} MCP server so you can read my {data} directly',

568 slots: {

569 server: 'Sentry',

570 data: 'error reports'

571 },

572 src: 'workflows'

573 }, {

574 id: 'capture-what-to-remember',

575 sdlc: 'operate',

576 cat: 'Automate',

577 roles: ['pm', 'docs'],

578 prompt: 'summarize what we did this session and suggest what to add to CLAUDE.md',

579 src: 'teams'

580 }], []);

581 const PROMPTS = useMemo(() => {

582 if (typeof window !== 'undefined') {

583 const rawIds = new Set(RAW.map(p => p.id));

584 RAW.forEach(p => {

585 if (!text[p.id]) console.warn('[prompt-library] no text[] entry for id:', p.id);

586 });

587 Object.keys(text).forEach(k => {

588 if (!rawIds.has(k)) console.warn('[prompt-library] orphaned text[] key:', k);

589 });

590 }

591 return RAW.map(p => ({

592 ...p,

593 title: p.id,

594 teaches: '',

595 ...text[p.id] || ({})

596 }));

597 }, [RAW, text]);

598 const L = labels;

599 const TL = k => tagLabels[k] || k;

600 const CAT_TAG = useMemo(() => ({

601 Onboard: 'understand',

602 Understand: 'understand',

603 Plan: 'plan',

604 Prototype: 'prototype',

605 Implement: 'build',

606 Test: 'test',

607 Refactor: 'refactor',

608 Review: 'review',

609 Steer: 'steer',

610 Git: 'git',

611 Release: 'release',

612 Debug: 'debug',

613 Incident: 'debug',

614 Data: 'data',

615 Automate: 'automate'

616 }), []);

617 const TAGS = useMemo(() => ['understand', 'plan', 'prototype', 'build', 'test', 'refactor', 'review', 'steer', 'debug', 'git', 'release', 'data', 'automate', 'pm', 'design', 'docs', 'marketing', 'security', 'ops'], []);

618 const tagsOf = p => [CAT_TAG[p.cat], ...p.roles || []];

619 const doc = useMemo(() => {

620 const p = typeof window !== 'undefined' ? window.location.pathname : '';

621 const base = p.startsWith('/docs/') ? '/docs' : '';

622 const m = p.slice(base.length).match(/^\/([a-z]{2}(?:-[A-Z]{2})?)\//);

623 const locale = m ? m[1] : 'en';

624 return href => {

625 if (!href || href[0] !== '/' || href[1] === '/') return href;

626 return base + (href.startsWith('/en/') ? '/' + locale + href.slice(3) : href);

627 };

628 }, []);

629 const linkify = s => {

630 const out = [];

631 let last = 0;

632 const re = /\[([^\]]+)\]\(([^)]+)\)/g;

633 for (let m; m = re.exec(s); ) {

634 if (m.index > last) out.push(s.slice(last, m.index));

635 out.push(<a key={m.index} href={doc(m[2])}>{m[1]}</a>);

636 last = re.lastIndex;

637 }

638 if (last < s.length) out.push(s.slice(last));

639 return out;

640 };

641 const codeify = s => s.split(/(`[^`]+`)/g).map((part, i) => part[0] === '`' ? <code key={i}>{part.slice(1, -1)}</code> : part);

642 const SOURCES = useMemo(() => ({

643 'workflows': '/en/common-workflows',

644 'teams': 'https://claude.com/blog/how-anthropic-teams-use-claude-code',

645 'legal': 'https://claude.com/blog/how-anthropic-uses-claude-legal',

646 'cybersecurity': 'https://claude.com/blog/how-anthropic-uses-claude-cybersecurity',

647 'best-practices': '/en/best-practices',

648 'ebook': 'https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf'

649 }), []);

650 const [mounted, setMounted] = useState(false);

651 const [q, setQ] = useState('');

652 const [start, setStart] = useState(true);

653 const [sel, setSel] = useState(null);

654 const [openId, setOpenId] = useState(null);

655 const [copied, setCopied] = useState(null);

656 const [fills, setFills] = useState({});

657 const copyTimer = useRef(null);

658 useEffect(() => {

659 setMounted(true);

660 return () => clearTimeout(copyTimer.current);

661 }, []);

662 const setFill = (id, key, val) => setFills(f => ({

663 ...f,

664 [id + '.' + key]: val

665 }));

666 const fillOf = (p, key) => {

667 const v = fills[p.id + '.' + key];

668 return v !== undefined ? v : p.slots && p.slots[key] !== undefined ? p.slots[key] : '';

669 };

670 const assemble = p => p.prompt.replace(/\{(\w+)\}/g, (_, k) => fillOf(p, k) || p.slots && p.slots[k] || k);

671 const preview = p => p.prompt.replace(/\{(\w+)\}/g, (_, k) => p.slots && p.slots[k] || k);

672 const bodyText = p => preview(p) + ' ' + p.teaches.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') + ' ' + (p.next || '');

673 const widthFor = s => (s || '').length + 3 + 'ch';

674 const ql = q.trim().toLowerCase();

675 const toggleTag = k => {

676 setStart(false);

677 setSel(s => !ql && s === k ? null : k);

678 };

679 const clear = () => {

680 setStart(false);

681 setSel(null);

682 setQ('');

683 };

684 const results = useMemo(() => {

685 const list = PROMPTS.filter(p => {

686 if (ql) return p.title.toLowerCase().includes(ql) || bodyText(p).toLowerCase().includes(ql);

687 if (start) return !!p.startN;

688 if (sel) return tagsOf(p).includes(sel);

689 return true;

690 });

691 if (ql) return list;

692 if (start) return list.sort((a, b) => a.startN - b.startN);

693 if (sel) return list.sort((a, b) => (a.roles || []).length - (b.roles || []).length || (b.sdlc === 'operate') - (a.sdlc === 'operate'));

694 return list;

695 }, [PROMPTS, ql, start, sel]);

696 const matchSnippet = p => {

697 if (!ql || p.title.toLowerCase().includes(ql)) return null;

698 const txt = bodyText(p);

699 const at = txt.toLowerCase().indexOf(ql);

700 if (at < 0) return null;

701 const lo = Math.max(0, at - 30), hi = Math.min(txt.length, at + ql.length + 50);

702 return [lo > 0 ? '…' : '', txt.slice(lo, at), <mark key="m">{txt.slice(at, at + ql.length)}</mark>, txt.slice(at + ql.length, hi), hi < txt.length ? '…' : ''];

703 };

704 const grouped = useMemo(() => {

705 if (start && !q.trim()) return [];

706 const g = {};

707 for (const p of results) {

708 const key = p.sdlc + '|' + p.cat;

709 (g[key] = g[key] || ({

710 sdlc: p.sdlc,

711 cat: p.cat,

712 items: []

713 })).items.push(p);

714 }

715 return Object.values(g);

716 }, [results, start, q]);

717 const copy = async (str, id) => {

718 try {

719 await navigator.clipboard.writeText(str);

720 } catch {

721 const ta = document.createElement('textarea');

722 ta.value = str;

723 ta.setAttribute('readonly', '');

724 ta.style.position = 'fixed';

725 ta.style.opacity = '0';

726 document.body.appendChild(ta);

727 ta.select();

728 document.execCommand('copy');

729 document.body.removeChild(ta);

730 }

731 clearTimeout(copyTimer.current);

732 setCopied(id);

733 copyTimer.current = setTimeout(() => setCopied(null), 1600);

734 };

735 const promptBody = p => {

736 if (!p.slots) return <code>{p.prompt}</code>;

737 const parts = p.prompt.split(/(\{\w+\})/g);

738 return <code>

739 {parts.map((part, idx) => {

740 const m = part.match(/^\{(\w+)\}$/);

741 if (!m) return <span key={idx}>{part}</span>;

742 const k = m[1];

743 const val = fillOf(p, k);

744 return <input key={idx} type="text" className="pl-slot" value={val} placeholder={p.slots[k] || k} aria-label={k} style={{

745 width: widthFor(val || p.slots[k])

746 }} onChange={e => setFill(p.id, k, e.target.value)} onFocus={e => e.target.select()} onClick={e => e.stopPropagation()} />;

747 })}

748 </code>;

749 };

750 const card = p => {

751 const open = openId === p.id;

752 const srcHref = SOURCES[p.src];

753 const srcLabel = sourceLabels[p.src];

754 const snip = matchSnippet(p);

755 return <div key={p.id} className={'pl-card' + (open ? ' pl-open' : '')}>

756 <button type="button" className="pl-head" onClick={() => setOpenId(open ? null : p.id)} aria-expanded={open}>

757 <span className="pl-title">{p.title}</span>

758 {!!p.startN && <span className="pl-chip">{L.startHere} · {p.startN}</span>}

759 </button>

760 {snip ? <div className="pl-match">{snip}</div> : <code className="pl-prompt-preview">{preview(p)}</code>}

761 {open && <div className="pl-body">

762 <div className="pl-label">{p.slots ? L.fillAndCopy : L.copyThis}</div>

763 {p.needs && L.needs && L.needs[p.needs] && <div className="pl-hint pl-needs">

764 <span className="pl-needs-label">{L.needsLabel}</span> {linkify(L.needs[p.needs])}

765 </div>}

766 {p.paste && L.paste && L.paste[p.paste] && <div className="pl-hint pl-paste">{L.paste[p.paste]}</div>}

767 {p.slots && <div className="pl-hint">

768 {L.hintBefore} <span className="pl-hint-chip">{L.hintChip}</span> {L.hintAfter}

769 </div>}

770 <div className="pl-prompt-box">

771 <span className="pl-caret">{'❯'}</span>

772 {promptBody(p)}

773 <button type="button" className="pl-copy" onClick={() => copy(assemble(p), p.id)}>

774 {copied === p.id ? L.copied : L.copy}

775 </button>

776 </div>

777 <div className="pl-label">{L.whyWorks}</div>

778 <div className="pl-teaches">{linkify(p.teaches)}</div>

779 {p.nextHref && p.next && <div className="pl-next">

780 <span className="pl-next-label">{L.makeItStick}</span>

781 <a href={doc(p.nextHref)}>{codeify(p.next)} →</a>

782 </div>}

783 {srcLabel && <div className="pl-src">{L.from} {srcHref ? <a href={doc(srcHref)}>{srcLabel}</a> : srcLabel}</div>}

784 </div>}

785 </div>;

786 };

787 const STYLES = useMemo(() => `

788.pl {

789 --pl-accent: #D97757;

790 --pl-accent-bg: rgba(217,119,87,0.07);

791 --pl-bg: #fff;

792 --pl-surface: #FAFAF7;

793 --pl-border: #E8E6DC;

794 --pl-border-subtle: rgba(31,30,29,0.08);

795 --pl-text: #141413;

796 --pl-text-2: #5E5D59;

797 --pl-text-3: #73726C;

798 --pl-text-4: #9C9A92;

799 --pl-mono: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);

800 font-family: 'Anthropic Sans', -apple-system, BlinkMacSystemFont, sans-serif;

801 font-size: 16px; color: var(--pl-text); margin: 8px 0 32px;

802}

803.dark .pl {

804 --pl-bg: #1f1e1d;

805 --pl-surface: #262624;

806 --pl-border: #3d3d3a;

807 --pl-border-subtle: rgba(240,238,230,0.08);

808 --pl-text: #f0eee6;

809 --pl-text-2: #bfbdb4;

810 --pl-text-3: #91908a;

811 --pl-text-4: #73726c;

812}

813.pl *, .pl *::before, .pl *::after { box-sizing: border-box; }

814.pl button { font-family: inherit; cursor: pointer; }

815.pl a { color: var(--pl-accent); text-decoration: none; }

816.pl a:hover { text-decoration: underline; }

817 

818.pl-search {

819 display: flex; align-items: center; gap: 10px;

820 padding: 14px 18px; background: var(--pl-surface);

821 border: 1px solid var(--pl-border); border-radius: 12px;

822 margin-bottom: 14px;

823}

824.pl-search input {

825 flex: 1; border: none; outline: none; background: transparent;

826 font-size: 16px; color: var(--pl-text);

827}

828.pl-search input::placeholder { color: var(--pl-text-4); }

829 

830.pl-tags { display: flex; gap: 8px; flex-wrap: wrap; align-items: center; margin-bottom: 18px; }

831.pl-tag {

832 padding: 7px 14px; border: 1px solid var(--pl-border); background: var(--pl-bg);

833 font-size: 14px; color: var(--pl-text-2); border-radius: 999px;

834}

835.pl-tag:hover { background: var(--pl-surface); }

836.pl-tag.pl-on { background: var(--pl-text); border-color: var(--pl-text); color: var(--pl-bg); }

837.pl-tag.pl-start { color: var(--pl-accent); font-weight: 500; }

838.pl-tag.pl-start.pl-on { background: var(--pl-accent); border-color: var(--pl-accent); color: #fff; }

839.pl-tags.pl-dim .pl-tag { opacity: 0.5; }

840.pl-tags.pl-dim .pl-tag:hover { opacity: 1; }

841.pl-sep { width: 1px; height: 22px; background: var(--pl-border); margin: 0 4px; }

842.pl-clear { border: none; background: none; font-size: 13px; color: var(--pl-text-4); padding: 4px 6px; }

843.pl-clear:hover { color: var(--pl-text-2); }

844.pl-count { margin-left: auto; font-size: 14px; color: var(--pl-text-4); }

845 

846.pl-group-h {

847 font-size: 12px; letter-spacing: 0.08em; text-transform: uppercase;

848 color: var(--pl-text-4); margin: 24px 0 12px;

849}

850.pl-group-h .pl-phase { color: var(--pl-text-3); }

851.pl-card {

852 border: 1px solid var(--pl-border-subtle); border-radius: 10px;

853 margin-bottom: 12px; background: var(--pl-bg); overflow: hidden;

854 padding: 14px 18px;

855}

856.pl-card.pl-open { border-color: var(--pl-border); background: var(--pl-surface); }

857.pl-head {

858 width: 100%; display: flex; align-items: baseline; gap: 12px;

859 border: none; background: transparent; text-align: left; padding: 0;

860}

861.pl-head:focus-visible { outline: 2px solid var(--pl-accent); outline-offset: 2px; border-radius: 6px; }

862.pl-title {

863 flex: 1; font-size: 17px; font-weight: 500; color: var(--pl-text);

864 white-space: nowrap; overflow: hidden; text-overflow: ellipsis;

865}

866.pl-prompt-preview {

867 display: block; font-family: var(--pl-mono); font-size: 13.5px; color: var(--pl-text-3);

868 margin-top: 6px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;

869}

870.pl-chip {

871 font-size: 11px; letter-spacing: 0.05em; text-transform: uppercase;

872 padding: 3px 9px; border-radius: 999px; flex-shrink: 0;

873 background: var(--pl-accent-bg); color: var(--pl-accent);

874}

875 

876.pl-body { margin-top: 14px; padding-top: 14px; border-top: 1px solid var(--pl-border-subtle); }

877.pl-label {

878 font-size: 11.5px; letter-spacing: 0.08em; text-transform: uppercase;

879 color: var(--pl-text-4); margin: 12px 0 8px;

880}

881.pl-prompt-box {

882 display: flex; align-items: center; gap: 10px;

883 padding: 14px 16px; background: #141413; color: #f0eee6;

884 border-radius: 8px; font-family: var(--pl-mono); font-size: 15px;

885}

886.pl-caret { color: var(--pl-accent); flex-shrink: 0; }

887.pl-prompt-box code { flex: 1; background: none; padding: 0; color: inherit; white-space: pre-wrap; line-height: 1.9; }

888.pl-slot {

889 font-family: var(--pl-mono); font-size: inherit;

890 background: rgba(217,119,87,0.15); color: #f0eee6;

891 border: none; border-bottom: 1.5px dashed var(--pl-accent);

892 border-radius: 4px 4px 0 0; padding: 2px 6px; margin: 0 1px;

893 outline: none; min-width: 6ch; max-width: 100%;

894 box-sizing: content-box; cursor: text;

895}

896.pl-slot:hover { background: rgba(217,119,87,0.22); }

897.pl-slot:focus { background: rgba(217,119,87,0.28); border-bottom-style: solid; }

898.pl-slot::placeholder { color: rgba(240,238,230,0.4); font-style: italic; }

899.pl-hint { font-size: 14px; color: var(--pl-text-3); margin: 0 0 10px; }

900.pl-paste { color: var(--pl-text-2); }

901.pl-needs { color: var(--pl-text-2); }

902.pl-needs-label {

903 display: inline-block; font-size: 10.5px; letter-spacing: 0.06em;

904 text-transform: uppercase; padding: 2px 7px; margin-right: 6px;

905 border-radius: 4px; background: var(--pl-accent-bg); color: var(--pl-accent);

906}

907.pl-hint-chip {

908 font-family: var(--pl-mono); font-size: 0.92em;

909 background: var(--pl-accent-bg); color: var(--pl-accent);

910 border-bottom: 1.5px dashed var(--pl-accent);

911 border-radius: 3px 3px 0 0; padding: 1px 5px;

912}

913.pl-copy {

914 font-size: 12.5px; padding: 6px 12px; border-radius: 6px;

915 background: var(--pl-accent); color: #fff; border: none; flex-shrink: 0;

916}

917.pl-teaches { display: block; font-size: 15.5px; color: var(--pl-text-2); margin: 4px 0 0; line-height: 1.6; }

918.pl-match {

919 display: block; font-size: 13.5px; color: var(--pl-text-3);

920 margin-top: 6px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;

921}

922.pl-match mark { background: var(--pl-accent-bg); color: var(--pl-text); padding: 1px 2px; border-radius: 3px; }

923.pl-next {

924 display: flex; align-items: baseline; gap: 10px;

925 margin: 14px 0 0; padding: 10px 12px;

926 background: var(--pl-accent-bg); border-radius: 8px; font-size: 14.5px;

927}

928.pl-next-label {

929 font-size: 11px; letter-spacing: 0.06em; text-transform: uppercase;

930 color: var(--pl-accent); font-weight: 600; flex-shrink: 0;

931}

932.pl-src { display: block; font-size: 14px; color: var(--pl-text-4); margin: 14px 0 0; }

933 

934.pl-show-all {

935 display: block; width: 100%; padding: 14px; margin-top: 4px;

936 border: 1px dashed var(--pl-border); border-radius: 10px;

937 background: transparent; font-size: 15px; color: var(--pl-accent);

938 text-align: center;

939}

940.pl-show-all:hover { background: var(--pl-accent-bg); border-style: solid; }

941 

942.pl-empty {

943 padding: 32px; text-align: center; color: var(--pl-text-4);

944 border: 1px dashed var(--pl-border); border-radius: 10px;

945}

946`, []);

947 if (!mounted) return <div className="pl" style={{

948 minHeight: 480

949 }} />;

950 return <div className="pl">

951 <style>{STYLES}</style>

952 

953 <div className="pl-search">

954 <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" style={{

955 color: 'var(--pl-text-4)'

956 }}>

957 <circle cx="11" cy="11" r="7" /><line x1="21" y1="21" x2="16.65" y2="16.65" />

958 </svg>

959 <input type="text" placeholder={L.search} value={q} onChange={e => {

960 setQ(e.target.value);

961 if (e.target.value) setStart(false);

962 }} aria-label={L.search} />

963 </div>

964 

965 <div className={'pl-tags' + (ql ? ' pl-dim' : '')}>

966 <button type="button" className={'pl-tag pl-start' + (!ql && start ? ' pl-on' : '')} onClick={() => {

967 setQ('');

968 setStart(!start);

969 if (!start) setSel(null);

970 }}>

971 ★ {L.startHere}

972 </button>

973 <span className="pl-sep" />

974 {TAGS.map(k => <button key={k} type="button" aria-pressed={!ql && sel === k} className={'pl-tag' + (!ql && sel === k ? ' pl-on' : '')} onClick={() => {

975 setQ('');

976 toggleTag(k);

977 }}>

978 {TL(k)}

979 </button>)}

980 {(start || sel || q) && <button type="button" className="pl-clear" onClick={clear}>{L.clear}</button>}

981 <span className="pl-count">{results.length} {results.length === 1 ? L.prompt : L.prompts}</span>

982 </div>

983 

984 {results.length === 0 ? <div className="pl-empty">

985 {L.noMatch} {ql ? <code>{q}</code> : null} <button type="button" className="pl-clear" onClick={clear}>{L.clear}</button>

986 </div> : !ql && start ? <div>

987 <div className="pl-group-h">{L.startHereHeader}</div>

988 {results.map(card)}

989 <button type="button" className="pl-show-all" onClick={clear}>

990 {L.showAll && L.showAll.replace('{n}', PROMPTS.length)} →

991 </button>

992 </div> : grouped.map(g => <div key={g.sdlc + '|' + g.cat}>

993 <div className="pl-group-h"><span className="pl-phase">{phaseLabels[g.sdlc] || g.sdlc}</span> · {catLabels[g.cat] || g.cat}</div>

994 {g.items.map(card)}

995 </div>)}

996 </div>;

997};

998 

9Esta é uma biblioteca de prompts para copiar no Claude Code. Use-a para explorar formas de trabalho que você ainda não experimentou, ou quando não tem certeza por onde começar.999Esta é uma biblioteca de prompts para copiar no Claude Code. Use-a para explorar formas de trabalho que você ainda não experimentou, ou quando não tem certeza por onde começar.

10 1000 

11Os prompts foram coletados de vários guias da Anthropic, incluindo [Fluxos de trabalho comuns](/pt/common-workflows), [Melhores práticas](/pt/best-practices) e [Como os times da Anthropic usam Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code). Eles são pontos de partida, não scripts. Abra **Por que isso funciona** em qualquer prompt para ver o padrão por trás dele, para que você possa escrever o seu próprio.1001Os prompts foram coletados de vários guias da Anthropic, incluindo [Fluxos de trabalho comuns](/pt/common-workflows), [Melhores práticas](/pt/best-practices) e [Como os times da Anthropic usam Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code). Eles são pontos de partida, não scripts. Abra **Por que isso funciona** em qualquer prompt para ver o padrão por trás dele, para que você possa escrever o seu próprio.

12 1002 

1003export const labels = {

1004 startHere: "Comece aqui",

1005 startHereHeader: "Cinco prompts para tentar primeiro",

1006 showAll: "Mostrar todos os {n} prompts",

1007 search: "Pesquisar prompts…",

1008 clear: "Limpar",

1009 prompt: "prompt",

1010 prompts: "prompts",

1011 noMatch: "Nenhum prompt corresponde",

1012 fillAndCopy: "Preencher e copiar",

1013 copyThis: "Copiar este prompt",

1014 hintBefore: "Digite nos",

1015 hintChip: "campos destacados",

1016 hintAfter: "para personalizar e depois copie.",

1017 copy: "Copiar",

1018 copied: "Copiado",

1019 whyWorks: "Por que isso funciona",

1020 makeItStick: "Fixe isso",

1021 from: "De",

1022 paste: {

1023 mockup: "Cole, arraste ou @-mencione sua imagem de mockup e depois envie isto:",

1024 design: "Cole, arraste ou @-mencione sua imagem de design e depois envie isto:",

1025 screenshot: "Cole, arraste ou @-mencione sua captura de tela e depois envie isto:",

1026 plan: "Cole sua saída de plano no prompt primeiro e depois envie isto:",

1027 error: "Cole a saída de erro no prompt primeiro e depois envie isto:",

1028 csv: "Arraste seu arquivo para o prompt ou substitua o caminho abaixo por uma @-menção do seu:"

1029 },

1030 needsLabel: "Precisa",

1031 needs: {

1032 tracker: "seu rastreador de problemas adicionado como um [conector claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) ou [servidor MCP](/pt/mcp).",

1033 gh: "a [CLI gh](https://cli.github.com) autenticada, ou GitHub adicionado como um [conector claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai).",

1034 browser: "uma forma para Claude renderizar e fazer captura de tela do resultado. O [aplicativo Desktop](/pt/desktop#preview-your-app) tem isso integrado. No terminal, instale a [extensão Chrome](/pt/chrome) ou um servidor MCP [Playwright](/pt/mcp).",

1035 db: "seu data warehouse ou armazenamento de logs adicionado como um [conector claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) ou [servidor MCP](/pt/mcp)."

1036 }

1037};

1038 

1039export const tagLabels = {

1040 understand: "Entender",

1041 plan: "Planejar",

1042 prototype: "Protótipo",

1043 build: "Construir",

1044 test: "Testar",

1045 refactor: "Refatorar",

1046 review: "Revisar",

1047 steer: "Orientar",

1048 debug: "Depurar",

1049 git: "Git",

1050 release: "Lançamento",

1051 data: "Dados",

1052 automate: "Automatizar",

1053 pm: "Produto",

1054 design: "Design",

1055 docs: "Documentação",

1056 marketing: "Marketing",

1057 security: "Segurança",

1058 ops: "Plantão"

1059};

1060 

1061export const phaseLabels = {

1062 discover: "Descobrir",

1063 design: "Design",

1064 build: "Construir",

1065 ship: "Lançar",

1066 operate: "Operar"

1067};

1068 

1069export const sourceLabels = {

1070 workflows: "Fluxos de trabalho comuns",

1071 teams: "Como os times da Anthropic usam Claude Code",

1072 legal: "Como a Anthropic usa Claude em Jurídico",

1073 cybersecurity: "Como a Anthropic usa Claude em Segurança Cibernética",

1074 "best-practices": "Melhores práticas",

1075 ebook: "Guia de codificação agentic em escala"

1076};

1077 

1078export const catLabels = {

1079 Onboard: "Integração",

1080 Understand: "Entender",

1081 Plan: "Planejar",

1082 Prototype: "Protótipo",

1083 Implement: "Implementar",

1084 Test: "Testar",

1085 Refactor: "Refatorar",

1086 Review: "Revisar",

1087 Steer: "Orientar",

1088 Git: "Git",

1089 Release: "Lançamento",

1090 Debug: "Depurar",

1091 Incident: "Incidente",

1092 Data: "Dados",

1093 Automate: "Automatizar"

1094};

1095 

1096export const text = {

1097 "get-oriented-in-a": {

1098 title: "Orientar-se em um novo repositório",

1099 teaches: "Descreva o que você quer saber, não quais arquivos ler. Claude explora o projeto por conta própria e retorna um resumo de como ele se encaixa.",

1100 next: "Execute `/init` para configurar `CLAUDE.md` para que Claude se lembre disso a cada sessão"

1101 },

1102 "explain-unfamiliar-code": {

1103 title: "Explicar código desconhecido",

1104 teaches: "Nomeie o arquivo e diga em qual formato você quer a resposta. Troque a página HTML por um diagrama, pontos de bala ou o que se adequar a como você aprende.",

1105 next: "Defina um estilo de saída para que Claude sempre explique em seu formato preferido"

1106 },

1107 "find-where-something-happens": {

1108 title: "Encontrar onde algo acontece",

1109 teaches: "Pesquise por comportamento em vez de por nome de arquivo. A pesquisa funciona mesmo quando você não sabe como o arquivo é chamado ou em qual diretório ele está."

1110 },

1111 "see-what-depends-on": {

1112 title: "Verificar o que quebra antes de você deletar",

1113 teaches: "Pergunte antes de remover qualquer coisa. A lista de chamadores e efeitos downstream diz se você está olhando para uma limpeza de uma linha ou uma mudança que você precisa coordenar."

1114 },

1115 "trace-how-code-evolved": {

1116 title: "Rastrear como o código evoluiu",

1117 teaches: "Aponte para o histórico de commits quando a pergunta é por quê, não o quê. Claude lê o log e blame para qualquer controle de versão que você use e explica as decisões por trás da implementação atual."

1118 },

1119 "scope-a-change-before": {

1120 title: "Definir o escopo de uma mudança antes de começar",

1121 teaches: "Dimensione o trabalho antes de comprometê-lo com um roadmap. A lista de arquivos diz se você está olhando para um componente ou uma mudança transversal."

1122 },

1123 "ask-the-codebase-a": {

1124 title: "Fazer uma pergunta de produto à base de código",

1125 teaches: "Declare seu papel para que a resposta seja no nível certo. Claude explica o que o produto realmente faz a partir do código-fonte, sem você precisar lê-lo.",

1126 next: "Defina um estilo de saída para que Claude sempre apresente respostas neste nível"

1127 },

1128 "plan-a-multi-file": {

1129 title: "Planejar uma mudança em vários arquivos antes de tocar no código",

1130 teaches: "Adicionar \"não edite ainda\" separa exploração de mudanças, para que você veja a abordagem antes de qualquer código se mover. Para fazer o planejamento primeiro o padrão em cada prompt, pressione Shift+Tab para [modo de plano](/pt/permission-modes#analyze-before-you-edit-with-plan-mode)."

1131 },

1132 "draft-a-spec-by": {

1133 title: "Rascunhar uma especificação por entrevista",

1134 teaches: "Peça para ser entrevistado em vez de escrever a especificação você mesmo. Claude faz perguntas estruturadas até que os requisitos estejam completos e depois escreve o resultado em um arquivo.",

1135 next: "Salve suas perguntas de entrevista como uma skill `/spec` para que cada especificação comece da mesma forma"

1136 },

1137 "turn-a-meeting-into": {

1138 title: "Transformar uma reunião em tickets",

1139 teaches: "Pule a etapa de transcrição. Claude extrai itens de ação da entrada não estruturada e os escreve diretamente em seu rastreador via [MCP](/pt/mcp), para que você revise os tickets, não a transcrição.",

1140 next: "Salve isto como uma skill `/tickets`"

1141 },

1142 "map-edge-cases-before": {

1143 title: "Mapear casos extremos antes de construir",

1144 teaches: "Peça pelo que está faltando, não pelo que está lá. Claude lista os estados de erro, estados vazios e casos extremos que um design de caminho feliz tende a pular."

1145 },

1146 "turn-a-mockup-into": {

1147 title: "Transformar um mockup em um protótipo funcional",

1148 teaches: "Um protótipo clicável responde perguntas que um mockup estático não consegue. Entregue o código funcional à engenharia em vez de explicar as interações em um documento."

1149 },

1150 "implement-from-a-screenshot": {

1151 title: "Implementar a partir de uma captura de tela e auto-verificar",

1152 teaches: "Isto dá a Claude um loop de verificação: ele renderiza, compara com a imagem de origem e itera sem você apontar cada lacuna.",

1153 next: "Use `/goal` para manter Claude iterando até que as capturas de tela correspondam"

1154 },

1155 "follow-an-existing-pattern": {

1156 title: "Seguir um padrão existente",

1157 teaches: "Aponte para código que você já gosta. Sem uma referência, Claude usa como padrão as melhores práticas gerais. Com uma, ele corresponde às convenções que sua base de código realmente usa.",

1158 next: "Peça a Claude para escrever o padrão que seguiu em `CLAUDE.md` para que futuras sessões o correspondam sem a referência"

1159 },

1160 "add-a-small-well": {

1161 title: "Adicionar um recurso pequeno e bem definido",

1162 teaches: "Declare as entradas e saídas, não como construir. Claude encontra onde código similar vive e adiciona o seu ao lado."

1163 },

1164 "build-a-small-internal": {

1165 title: "Construir uma pequena ferramenta interna do zero",

1166 teaches: "Você não precisa de um projeto, um framework ou uma etapa de construção. Descreva a ferramenta e peça a Claude para abri-la para que você a veja funcionando imediatamente."

1167 },

1168 "work-an-issue-end": {

1169 title: "Trabalhar um problema de ponta a ponta",

1170 teaches: "Dê o número do problema, não um resumo. Claude lê o ticket completo em si, para que requisitos que você esqueceria de mencionar apareçam e valide a mudança antes de relatar."

1171 },

1172 "find-and-update-copy": {

1173 title: "Encontrar e atualizar cópia em toda a base de código",

1174 teaches: "Peça por variantes e diga o que pular. Claude encontra fraseados que uma pesquisa literal perderia e deixa fixtures de teste e histórico intocados, para que você revise apenas a cópia que os usuários realmente veem."

1175 },

1176 "draft-from-past-examples": {

1177 title: "Rascunhar um documento a partir de exemplos passados",

1178 teaches: "Aponte para uma pasta de trabalho concluída em vez de descrever seu estilo. Claude aprende a estrutura e a voz do que você já lançou, para que o primeiro rascunho pareça um dos seus.",

1179 next: "Salve a voz como uma skill para que cada rascunho comece lá"

1180 },

1181 "write-tests-run-them": {

1182 title: "Escrever testes, executá-los, corrigir falhas",

1183 teaches: "Peça para escrever, executar e corrigir juntos para que Claude itere sem parar para instruções.",

1184 next: "Execute `/init` para que Claude aprenda seu comando de teste automaticamente"

1185 },

1186 "drive-implementation-from-tests": {

1187 title: "Conduzir implementação a partir de testes",

1188 teaches: "Desenvolvimento orientado por testes: os testes definem quando o trabalho está completo e Claude itera na implementação até que passem."

1189 },

1190 "fill-gaps-from-a": {

1191 title: "Preencher lacunas a partir de um relatório de cobertura",

1192 teaches: "Aponte para o relatório de cobertura em vez de adivinhar o que não foi testado. Claude lê os números reais e escreve testes para os arquivos que mais precisam.",

1193 next: "Defina isto como um `/goal` para que Claude continue escrevendo testes até que a cobertura atinja o alvo"

1194 },

1195 "port-code-between-languages": {

1196 title: "Portar código para outra linguagem",

1197 teaches: "Diga o que preservar, não apenas a linguagem de destino. Nomear a API ou comportamento que deve permanecer igual dá a Claude um contrato para verificar a porta."

1198 },

1199 "generate-docs-for-code": {

1200 title: "Gerar documentação para código não documentado",

1201 teaches: "Nomeie o escopo e o formato. Claude encontra o que está faltando e corresponde ao estilo de comentário já no arquivo, para que a nova documentação pareça o resto."

1202 },

1203 "migrate-a-pattern-across": {

1204 title: "Migrar um padrão em toda a base de código",

1205 teaches: "Descreva o padrão antigo e o novo. Pedir a Claude para identificar cada lugar primeiro significa que os sites de chamada são listados na resposta, para que você possa verificar se nenhum foi perdido."

1206 },

1207 "optimize-against-a-measurable": {

1208 title: "Otimizar contra um alvo mensurável",

1209 teaches: "Declarar a métrica e o alvo dá a Claude uma definição clara de conclusão.",

1210 next: "Defina isto como um `/goal` para que Claude continue medindo e iterando até atingir o número"

1211 },

1212 "fix-a-precise-visual": {

1213 title: "Corrigir um bug visual preciso",

1214 teaches: "Feedback visual preciso obtém uma correção precisa. Declare o elemento exato, medição e viewport.",

1215 next: "Adicione uma ferramenta de visualização para que Claude faça captura de tela e verifique a correção em si"

1216 },

1217 "review-your-changes-before": {

1218 title: "Revisar suas mudanças antes de fazer commit",

1219 teaches: "Pegue problemas enquanto ainda são baratos de corrigir. Claude lê os arquivos alterados na íntegra, não apenas as linhas de diff, para que detecte problemas que uma auto-revisão rápida perde.",

1220 next: "Execute `/code-review` para a mesma verificação em um comando"

1221 },

1222 "review-a-pull-request": {

1223 title: "Revisar um pull request",

1224 teaches: "Claude revisa com toda a base de código em contexto, não apenas o diff. Ele lê o código alterado e o que ele chama, para que detecte problemas que uma revisão apenas de diff perderia.",

1225 next: "Ative isto para cada PR com Code Review"

1226 },

1227 "review-infrastructure-changes-before": {

1228 title: "Revisar mudanças de infraestrutura antes de aplicar",

1229 teaches: "A saída do plano é densa e difícil de escanear. Colá-la obtém um resumo em linguagem simples do que realmente vai mudar antes de você aplicar."

1230 },

1231 "run-a-security-review": {

1232 title: "Executar uma revisão de segurança com um subagente",

1233 teaches: "Um [subagente](/pt/sub-agents) executa a auditoria em sua própria janela de contexto e relata um resumo, para que uma revisão de segurança longa não preencha sua sessão principal. O subagente de propósito geral integrado lida com isto sem configuração extra.",

1234 next: "Configure um subagente dedicado de revisão de segurança que todo o seu time possa usar"

1235 },

1236 "review-content-before-sending": {

1237 title: "Detectar problemas antes da revisão formal",

1238 teaches: "Obtenha uma primeira passagem antes de um humano gastar tempo com isto. Nomeie as preocupações que você quer verificadas para que a revisão seja focada e depois corrija o que encontra e envie um rascunho mais limpo.",

1239 next: "Capture sua lista de verificação de revisão como uma skill que todo o seu time possa executar"

1240 },

1241 "course-correct-a-wrong": {

1242 title: "Corrigir uma abordagem errada",

1243 teaches: "Nomeie a restrição que Claude perdeu, não apenas que está errado. Uma razão específica dá a Claude uma restrição concreta a satisfazer na tentativa novamente, em vez de adivinhar novamente.",

1244 next: "Pressione `Esc` duas vezes para abrir o menu de retrocesso e restaurar código e conversa para que a tentativa novamente comece limpa"

1245 },

1246 "narrow-the-scope-of": {

1247 title: "Estreitar o escopo de uma mudança",

1248 teaches: "Quando a direção está certa mas a mudança ficou muito ampla, peça a Claude para manter parte dela em vez de retroceder tudo. Um limite declarado mantém uma pequena correção de se tornar uma refatoração."

1249 },

1250 "turn-a-correction-into": {

1251 title: "Transformar uma correção em uma regra",

1252 teaches: "Uma correção no chat não é compartilhada com seu time. Uma regra no [CLAUDE.md](/pt/memory) do projeto é compartilhada uma vez que você a faz commit e Claude a lê no início de cada sessão.",

1253 next: "Abra `/memory` para revisar o que Claude escreveu"

1254 },

1255 "resolve-merge-conflicts": {

1256 title: "Resolver conflitos de merge",

1257 teaches: "Diga qual estado você quer, não quais marcadores manter. Pedir o raciocínio torna o merge revisável em vez de uma caixa preta."

1258 },

1259 "commit-with-a-generated": {

1260 title: "Fazer commit com uma mensagem gerada",

1261 teaches: "Deixe Claude derivar a mensagem do diff. Ela corresponde ao estilo de commit existente do seu repositório."

1262 },

1263 "open-a-pull-request": {

1264 title: "Abrir um pull request a partir de um ticket",

1265 teaches: "Pule a troca de contexto entre rastreador, editor e GitHub. Um prompt lê a especificação, faz a mudança e abre o PR."

1266 },

1267 "draft-release-notes-from": {

1268 title: "Rascunhar notas de lançamento do histórico git",

1269 teaches: "Dê dois pontos de referência e a estrutura que você quer. Claude lê o log de commit entre eles e rascunha um changelog que você pode editar.",

1270 next: "Salve isto como uma skill `/changelog`"

1271 },

1272 "write-a-ci-workflow": {

1273 title: "Escrever um workflow de CI",

1274 teaches: "Descreva quando deve ser executado e o que deve fazer; o YAML é gerado para você, correspondido aos comandos de construção e teste do seu projeto."

1275 },

1276 "find-and-fix-a": {

1277 title: "Encontrar e corrigir um teste falhando",

1278 teaches: "Descreva o sintoma; você não precisa saber qual arquivo está quebrado. Claude executa o teste para ver a falha, rastreia-a para a origem e a corrige."

1279 },

1280 "investigate-a-reported-error": {

1281 title: "Investigar um erro relatado",

1282 teaches: "Descreva o sintoma e localização; Claude lê o caminho de código relevante e rastreia as causas prováveis. Cole stack traces ou logs se você tiver.",

1283 next: "Coloque um deeplink em seu runbook que abre Claude com este prompt pré-preenchido"

1284 },

1285 "fix-a-build-error": {

1286 title: "Corrigir um erro de construção na raiz",

1287 teaches: "Pedir causa raiz e verificação previne patches de nível de superfície que suprimem o erro sem corrigi-lo."

1288 },

1289 "investigate-a-production-incident": {

1290 title: "Investigar um incidente de produção",

1291 teaches: "Liste as fontes de evidência para correlacionar, não os passos a tomar. Claude lê logs, histórico git e config juntos para estreitar a causa.",

1292 next: "Conecte Sentry ou seu armazenamento de logs via MCP"

1293 },

1294 "query-logs-in-plain": {

1295 title: "Consultar logs em inglês simples",

1296 teaches: "Faça a pergunta em vez de escrever o SQL. Claude constrói a consulta, a executa contra seus logs conectados e mostra tanto a consulta quanto o resultado para que você possa verificar o que foi executado."

1297 },

1298 "diagnose-from-a-console": {

1299 title: "Diagnosticar a partir de uma captura de tela do console",

1300 teaches: "Consoles em nuvem mostram o problema mas não os comandos para corrigi-lo. Claude lê a captura de tela e traduz o dashboard nos comandos kubectl, gcloud ou aws para executar."

1301 },

1302 "analyze-a-data-file": {

1303 title: "Analisar um arquivo de dados",

1304 teaches: "Uma pergunta única não precisa de um script único. Aponte para um arquivo em sua pasta de projeto e Claude o lê diretamente, encontra os padrões e escreve a saída onde você pedir.",

1305 next: "Conecte a fonte de dados via MCP em vez de exportar arquivos"

1306 },

1307 "generate-variations-from-performance": {

1308 title: "Gerar variações a partir de dados de desempenho",

1309 teaches: "Declare a restrição no início para que a geração permaneça dentro do limite. Claude lê as métricas, escolhe o que substituir e produz alternativas que se encaixam.",

1310 next: "Conecte a plataforma de anúncios via MCP em vez de exportar um arquivo"

1311 },

1312 "turn-a-recurring-task": {

1313 title: "Transformar uma tarefa recorrente em uma skill",

1314 teaches: "Nomeie os passos uma vez; reutilize-os como um comando. Claude escreve uma [skill](/pt/skills) que qualquer pessoa do seu time possa executar."

1315 },

1316 "add-a-hook-for": {

1317 title: "Adicionar um hook para comportamento repetido",

1318 teaches: "Hooks tornam um comportamento automático em vez de algo que você tem que se lembrar de pedir. Descreva o gatilho e ação e Claude escreve a configuração do [hook](/pt/hooks)."

1319 },

1320 "connect-a-tool-with": {

1321 title: "Conectar uma ferramenta com MCP",

1322 teaches: "Conecte a fonte uma vez em vez de colar dados a cada sessão. Após a configuração do [MCP](/pt/mcp), Claude lê da ferramenta diretamente quando você pergunta sobre ela."

1323 },

1324 "capture-what-to-remember": {

1325 title: "Capturar o que lembrar para a próxima vez",

1326 teaches: "Pergunte antes de esquecer. Claude sabe o que teve que descobrir nesta sessão e propõe entradas [CLAUDE.md](/pt/memory) para que a próxima sessão comece com esse contexto."

1327 }

1328};

1329 

1330<PromptLibrary text={text} labels={labels} tagLabels={tagLabels} phaseLabels={phaseLabels} sourceLabels={sourceLabels} catLabels={catLabels} />

1331 

13<h2 id="what-makes-these-prompts-work">1332<h2 id="what-makes-these-prompts-work">

14 O que torna esses prompts funcionarem1333 O que torna esses prompts funcionarem

15</h2>1334</h2>

Details

119 119 

120Em uma sessão de terminal interativa, um indicador `/rc active` fica no rodapé abaixo da caixa de entrada enquanto a conexão está ativa, e fica oculto se o terminal for muito estreito para ajustá-lo. O texto do indicador é um link para a sessão em claude.ai. Selecione-o com a tecla de seta para baixo e pressione Enter, ou execute `/remote-control` novamente, para abrir um painel de status com a URL da sessão e um código QR que você pode usar para [conectar de outro dispositivo](#connect-from-another-device).120Em uma sessão de terminal interativa, um indicador `/rc active` fica no rodapé abaixo da caixa de entrada enquanto a conexão está ativa, e fica oculto se o terminal for muito estreito para ajustá-lo. O texto do indicador é um link para a sessão em claude.ai. Selecione-o com a tecla de seta para baixo e pressione Enter, ou execute `/remote-control` novamente, para abrir um painel de status com a URL da sessão e um código QR que você pode usar para [conectar de outro dispositivo](#connect-from-another-device).

121 121 

122Se a conexão falhar, o indicador fica vermelho e lê `/rc failed`. Selecione-o com a tecla de seta para baixo e pressione Enter para ver o motivo da falha e uma opção de descartar, ou execute `/remote-control` novamente para tentar novamente.122Se a conexão falhar, uma notificação aparece com o motivo da falha e o indicador desaparece do rodapé. Execute `/remote-control` novamente para tentar novamente.

123 123 

124<h3 id="connect-from-another-device">124<h3 id="connect-from-another-device">

125 Conectar de outro dispositivo125 Conectar de outro dispositivo


206* No iOS, os modos Focus e resumos de notificações podem suprimir ou atrasar pushes. Verifique Configurações → Notificações → Claude.206* No iOS, os modos Focus e resumos de notificações podem suprimir ou atrasar pushes. Verifique Configurações → Notificações → Claude.

207* No Android, a otimização agressiva de bateria pode atrasar a entrega. Isente o aplicativo Claude da otimização de bateria nas configurações do sistema.207* No Android, a otimização agressiva de bateria pode atrasar a entrega. Isente o aplicativo Claude da otimização de bateria nas configurações do sistema.

208 208 

209Claude Code pula notificações push móveis enquanto você está digitando ou focado no terminal conectado. {/* min-version: 2.1.181 */}A partir da v2.1.181, você pode definir [`CLAUDE_CLIENT_PRESENCE_FILE`](/pt/env-vars) para um caminho de arquivo marcador para estender isso para qualquer momento em que você esteja na máquina, mesmo em outra janela: notificações são puladas enquanto o arquivo existe. Configure um ouvinte de bloqueio de tela ou ferramenta similar para criar o arquivo quando sua tela desbloqueia e deletá-lo quando sua tela bloqueia.

210 

209<h2 id="limitations">211<h2 id="limitations">

210 Limitações212 Limitações

211</h2>213</h2>


214* **O processo local deve continuar em execução**: Remote Control é executado como um processo local. Se você fechar o terminal, sair do VS Code ou parar o processo `claude`, a sessão termina.216* **O processo local deve continuar em execução**: Remote Control é executado como um processo local. Se você fechar o terminal, sair do VS Code ou parar o processo `claude`, a sessão termina.

215* **Interrupção de rede estendida**: se sua máquina estiver ligada mas não conseguir alcançar a rede por mais de aproximadamente 10 minutos, a sessão expira e o processo sai. Execute `claude remote-control` novamente para iniciar uma nova sessão.217* **Interrupção de rede estendida**: se sua máquina estiver ligada mas não conseguir alcançar a rede por mais de aproximadamente 10 minutos, a sessão expira e o processo sai. Execute `claude remote-control` novamente para iniciar uma nova sessão.

216* **Ultraplan desconecta Remote Control**: iniciar uma sessão [ultraplan](/pt/ultraplan) desconecta qualquer sessão de Remote Control ativa porque ambos os recursos ocupam a interface claude.ai/code e apenas um pode estar conectado por vez.218* **Ultraplan desconecta Remote Control**: iniciar uma sessão [ultraplan](/pt/ultraplan) desconecta qualquer sessão de Remote Control ativa porque ambos os recursos ocupam a interface claude.ai/code e apenas um pode estar conectado por vez.

217* **Alguns comandos são apenas locais**: comandos que abrem um seletor interativo no terminal, como `/plugin` ou `/resume`, funcionam apenas a partir da CLI local. Comandos que produzem saída de texto, incluindo `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap` e `/reload-plugins`, funcionam a partir de dispositivos móveis e web. {/* min-version: 2.1.166 */}A partir da v2.1.166, `/mcp` também funciona a partir de dispositivos móveis e web: ele retorna um resumo de texto do status do servidor em vez de abrir o seletor, e aceita os mesmos [subcomandos](/pt/commands#all-commands) da CLI local, com uma diferença: a partir de dispositivos móveis e web, `/mcp reconnect` sem nome de servidor reconecta todos os servidores que falharam ou precisam de autenticação, enquanto a CLI local requer um nome de servidor para `reconnect`.219* **Alguns comandos são apenas locais**: comandos que abrem um seletor interativo no terminal, como `/plugin` ou `/resume`, funcionam apenas a partir da CLI local. Os seguintes funcionam a partir de dispositivos móveis e web:

220 * Comandos de saída de texto: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, `/reload-plugins`

221 * {/* min-version: 2.1.166 */}`/mcp`, a partir da v2.1.166: retorna um resumo de texto do status do servidor em vez de abrir o seletor, e aceita os [subcomandos](/pt/commands#all-commands) `reconnect`, `enable` e `disable`. Diferentemente da CLI local, `/mcp reconnect` sem um nome de servidor reconecta todos os servidores que falharam ou precisam de autenticação.

222 * {/* min-version: 2.1.181 */}`/config`, a partir da v2.1.181: passe `key=value` para definir uma configuração, ou execute sem argumentos para listar as chaves que você pode definir.

218 223 

219<h2 id="troubleshooting">224<h2 id="troubleshooting">

220 Solução de problemas225 Solução de problemas

sandboxing.md +2 −0

Details

373* **Comandos falham com um erro host-not-allowed**: muitas ferramentas CLI precisam alcançar hosts específicos. Conceder permissão quando solicitado adiciona o host à sua lista de permitidos para que a ferramenta seja executada dentro do sandbox no futuro.373* **Comandos falham com um erro host-not-allowed**: muitas ferramentas CLI precisam alcançar hosts específicos. Conceder permissão quando solicitado adiciona o host à sua lista de permitidos para que a ferramenta seja executada dentro do sandbox no futuro.

374* **`jest` trava ou falha**: `watchman` é incompatível com o sandbox. Execute `jest --no-watchman` em vez disso.374* **`jest` trava ou falha**: `watchman` é incompatível com o sandbox. Execute `jest --no-watchman` em vez disso.

375* **CLIs baseadas em Go falham na verificação TLS no macOS**: ferramentas como `gh`, `gcloud` e `terraform` podem falhar na verificação TLS sob Seatbelt. Liste essas ferramentas em `excludedCommands` para executá-las fora do sandbox. Se você estiver usando `httpProxyPort` com um proxy MITM e CA personalizado, defina [`enableWeakerNetworkIsolation`](/pt/settings#sandbox-settings) como `true` em vez disso.375* **CLIs baseadas em Go falham na verificação TLS no macOS**: ferramentas como `gh`, `gcloud` e `terraform` podem falhar na verificação TLS sob Seatbelt. Liste essas ferramentas em `excludedCommands` para executá-las fora do sandbox. Se você estiver usando `httpProxyPort` com um proxy MITM e CA personalizado, defina [`enableWeakerNetworkIsolation`](/pt/settings#sandbox-settings) como `true` em vez disso.

376* **`open`, `osascript`, ou fluxos de autenticação baseados em navegador falham com erro `-600` no macOS**: o sandbox bloqueia Apple Events por padrão. Defina [`allowAppleEvents`](/pt/settings#sandbox-settings) como `true` em suas configurações de usuário, gerenciadas ou CLI para permitir. As configurações do projeto são ignoradas para esta chave. Habilitá-lo remove o isolamento de execução de código, pois comandos em sandbox podem então iniciar outras aplicações sem sandbox sem prompt do usuário e enviar comandos AppleScript para aplicações em execução, sujeito ao prompt de consentimento de automação do macOS (TCC). Alternativamente, adicione o comando a `excludedCommands` para executá-lo fora do sandbox.

376* **Comandos `docker` falham**: `docker` é incompatível com o sandbox. Adicione `docker *` a `excludedCommands` para executá-lo fora do sandbox.377* **Comandos `docker` falham**: `docker` é incompatível com o sandbox. Adicione `docker *` a `excludedCommands` para executá-lo fora do sandbox.

377* **Bubblewrap falha ao iniciar dentro de um container**: em um container sem privilégios, bubblewrap não consegue montar um sistema de arquivos `/proc` fresco. Defina [`enableWeakerNestedSandbox`](/pt/settings#sandbox-settings) como `true` para que o sandbox interno faça bind-mount do `/proc` existente do container em vez disso. Use esta configuração apenas quando o container externo já fornece o limite de isolamento que você precisa, pois expõe informações de processo a comandos em sandbox que uma montagem `/proc` fresca ocultaria.378* **Bubblewrap falha ao iniciar dentro de um container**: em um container sem privilégios, bubblewrap não consegue montar um sistema de arquivos `/proc` fresco. Defina [`enableWeakerNestedSandbox`](/pt/settings#sandbox-settings) como `true` para que o sandbox interno faça bind-mount do `/proc` existente do container em vez disso. Use esta configuração apenas quando o container externo já fornece o limite de isolamento que você precisa, pois expõe informações de processo a comandos em sandbox que uma montagem `/proc` fresca ocultaria.

378* **Filtro seccomp no Linux**: o filtro seccomp é necessário para bloquear sockets de domínio Unix. A aba Dependencies em `/sandbox` mostra se está disponível. Se estiver faltando, execute `npm install -g @anthropic-ai/sandbox-runtime` para instalar o helper.379* **Filtro seccomp no Linux**: o filtro seccomp é necessário para bloquear sockets de domínio Unix. A aba Dependencies em `/sandbox` mostra se está disponível. Se estiver faltando, execute `npm install -g @anthropic-ai/sandbox-runtime` para instalar o helper.


397* **Escalação de privilégio via Unix sockets**: a configuração `allowUnixSockets` pode inadvertidamente conceder acesso a serviços poderosos do sistema que poderiam levar a bypasses de sandbox. Por exemplo, permitir acesso a `/var/run/docker.sock` efetivamente concede acesso ao sistema host através do socket Docker. Considere cuidadosamente quaisquer Unix sockets que você permita através do sandbox.398* **Escalação de privilégio via Unix sockets**: a configuração `allowUnixSockets` pode inadvertidamente conceder acesso a serviços poderosos do sistema que poderiam levar a bypasses de sandbox. Por exemplo, permitir acesso a `/var/run/docker.sock` efetivamente concede acesso ao sistema host através do socket Docker. Considere cuidadosamente quaisquer Unix sockets que você permita através do sandbox.

398* **Escalação de permissão de sistema de arquivos**: permissões de escrita de sistema de arquivos excessivamente amplas podem habilitar ataques de escalação de privilégio. Permitir escritas em diretórios contendo executáveis em `$PATH`, diretórios de configuração do sistema ou arquivos de configuração de shell do usuário como `.bashrc` ou `.zshrc` pode levar a execução de código em diferentes contextos de segurança quando outros usuários ou processos do sistema acessam esses arquivos.399* **Escalação de permissão de sistema de arquivos**: permissões de escrita de sistema de arquivos excessivamente amplas podem habilitar ataques de escalação de privilégio. Permitir escritas em diretórios contendo executáveis em `$PATH`, diretórios de configuração do sistema ou arquivos de configuração de shell do usuário como `.bashrc` ou `.zshrc` pode levar a execução de código em diferentes contextos de segurança quando outros usuários ou processos do sistema acessam esses arquivos.

399* **Força do sandbox Linux**: a implementação Linux fornece isolamento forte de sistema de arquivos e rede, mas inclui um modo `enableWeakerNestedSandbox` que o habilita a funcionar dentro de ambientes Docker sem namespaces privilegiados, ou em hosts Linux onde namespaces de usuário sem privilégios são desabilitados por sysctl. Esta opção enfraquece consideravelmente a segurança e deve ser usada apenas quando isolamento adicional é de outra forma imposto.400* **Força do sandbox Linux**: a implementação Linux fornece isolamento forte de sistema de arquivos e rede, mas inclui um modo `enableWeakerNestedSandbox` que o habilita a funcionar dentro de ambientes Docker sem namespaces privilegiados, ou em hosts Linux onde namespaces de usuário sem privilégios são desabilitados por sysctl. Esta opção enfraquece consideravelmente a segurança e deve ser usada apenas quando isolamento adicional é de outra forma imposto.

401* **Apple Events no macOS**: o sandbox macOS bloqueia Apple Events por padrão. A configuração `allowAppleEvents` remove essa restrição para que ferramentas como `open` e `osascript` funcionem, mas remove isolamento de execução de código: comandos em sandbox podem iniciar outras aplicações sem sandbox sem nenhum prompt do usuário, e podem enviar comandos AppleScript para aplicações em execução, sujeito ao prompt de consentimento de automação macOS por aplicativo (TCC). Isso é apenas honrado a partir de configurações de usuário, gerenciadas ou CLI. Configurações de projeto não podem habilitá-lo.

400* **Arquivos de configurações protegidos**: o sandbox automaticamente nega acesso de escrita aos arquivos `settings.json` do Claude Code em cada escopo e ao diretório de configurações gerenciadas, portanto um comando em sandbox não pode modificar sua própria política.402* **Arquivos de configurações protegidos**: o sandbox automaticamente nega acesso de escrita aos arquivos `settings.json` do Claude Code em cada escopo e ao diretório de configurações gerenciadas, portanto um comando em sandbox não pode modificar sua própria política.

401 403 

402<h3 id="platform-and-tool-compatibility">404<h3 id="platform-and-tool-compatibility">

settings.md +13 −6

Details

6 6 

7> Configure o Claude Code com configurações globais e em nível de projeto, e variáveis de ambiente.7> Configure o Claude Code com configurações globais e em nível de projeto, e variáveis de ambiente.

8 8 

9O Claude Code oferece uma variedade de configurações para personalizar seu comportamento de acordo com suas necessidades. Você pode configurar o Claude Code executando o comando `/config` ao usar o REPL interativo, que abre uma interface de Configurações com abas onde você pode visualizar informações de status e modificar opções de configuração.9O Claude Code oferece uma variedade de configurações para personalizar seu comportamento de acordo com suas necessidades. Você pode configurar o Claude Code executando o comando `/config`, que abre uma interface de Configurações com abas onde você pode visualizar informações de status e modificar opções de configuração. {/* min-version: 2.1.181 */}A partir da v2.1.181, você pode alterar uma única opção sem abrir a interface passando `key=value` para `/config`, por exemplo `/config verbose=true`.

10 10 

11<h2 id="configuration-scopes">11<h2 id="configuration-scopes">

12 Escopos de configuração12 Escopos de configuração


230| `autoMode` | Personalizar o que o classificador de [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) bloqueia e permite. Contém arrays `environment`, `allow`, `soft_deny`, e `hard_deny` de regras em prosa. Inclua a string literal `"$defaults"` em um array para herdar as regras integradas nessa posição. Veja [Configurar modo automático](/pt/auto-mode-config). Não lido de configurações de projeto compartilhadas | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |230| `autoMode` | Personalizar o que o classificador de [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) bloqueia e permite. Contém arrays `environment`, `allow`, `soft_deny`, e `hard_deny` de regras em prosa. Inclua a string literal `"$defaults"` em um array para herdar as regras integradas nessa posição. Veja [Configurar modo automático](/pt/auto-mode-config). Não lido de configurações de projeto compartilhadas | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |

231| `autoScrollEnabled` | Em [renderização fullscreen](/pt/fullscreen), seguir nova saída até o fundo da conversa. Padrão: `true`. Aparece em `/config` como **Auto-scroll**. Prompts de permissão ainda rolam para a vista quando isto está desligado | `false` |231| `autoScrollEnabled` | Em [renderização fullscreen](/pt/fullscreen), seguir nova saída até o fundo da conversa. Padrão: `true`. Aparece em `/config` como **Auto-scroll**. Prompts de permissão ainda rolam para a vista quando isto está desligado | `false` |

232| `autoUpdatesChannel` | Canal de lançamento a seguir para atualizações. Use `"stable"` para uma versão que é tipicamente cerca de uma semana antiga e pula versões com regressões maiores, ou `"latest"` (padrão) para o lançamento mais recente. Para desabilitar auto-atualizações completamente, defina [`DISABLE_AUTOUPDATER`](/pt/setup#disable-auto-updates) em `env` | `"stable"` |232| `autoUpdatesChannel` | Canal de lançamento a seguir para atualizações. Use `"stable"` para uma versão que é tipicamente cerca de uma semana antiga e pula versões com regressões maiores, ou `"latest"` (padrão) para o lançamento mais recente. Para desabilitar auto-atualizações completamente, defina [`DISABLE_AUTOUPDATER`](/pt/setup#disable-auto-updates) em `env` | `"stable"` |

233| `availableModels` | Restringir quais modelos os usuários podem selecionar para a sessão principal, [subagents](/pt/sub-agents), e o [advisor](/pt/advisor). Veja [Restringir seleção de modelo](/pt/model-config#restrict-model-selection). Veja `enforceAvailableModels` para também restringir Padrão | `["sonnet", "haiku"]` |233| `availableModels` | Restringir quais modelos os usuários podem selecionar para a sessão principal, [subagents](/pt/sub-agents), e o [advisor](/pt/advisor). Veja [Restringir seleção de modelo](/pt/model-config#restrict-model-selection). Veja `enforceAvailableModels` para também restringir o modelo Padrão | `["sonnet", "haiku"]` |

234| `awaySummaryEnabled` | Mostrar um resumo de sessão de uma linha quando você retorna ao terminal após alguns minutos ausente. Defina como `false` ou desative Resumo de sessão em `/config` para desabilitar. Mesmo que [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/pt/env-vars) | `true` |234| `awaySummaryEnabled` | Mostrar um resumo de sessão de uma linha quando você retorna ao terminal após alguns minutos ausente. Defina como `false` ou desative Resumo de sessão em `/config` para desabilitar. Mesmo que [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/pt/env-vars) | `true` |

235| `awsAuthRefresh` | Script personalizado que modifica o diretório `.aws` (veja [configuração avançada de credenciais](/pt/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |235| `awsAuthRefresh` | Script personalizado que modifica o diretório `.aws` (veja [configuração avançada de credenciais](/pt/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |

236| `awsCredentialExport` | Script personalizado que produz JSON com credenciais AWS (veja [configuração avançada de credenciais](/pt/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |236| `awsCredentialExport` | Script personalizado que produz JSON com credenciais AWS (veja [configuração avançada de credenciais](/pt/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

237| `axScreenReader` | {/* min-version: 2.1.181 */}Renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. O modo leitor de tela sempre usa o renderizador clássico, então a configuração `tui` não tem efeito enquanto está ativo. A variável de ambiente [`CLAUDE_AX_SCREEN_READER`](/pt/env-vars) e a flag [`--ax-screen-reader`](/pt/cli-reference#cli-flags) têm precedência. Requer Claude Code v2.1.181 ou posterior | `true` |

237| `blockedMarketplaces` | (Apenas configurações gerenciadas) Lista de negação de fontes de marketplace. Aplicado em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin, então um marketplace adicionado antes da política ser definida não pode ser usado para buscar plugins. Fontes bloqueadas são verificadas antes do download, então nunca tocam o sistema de arquivos. Veja [Restrições de marketplace gerenciado](/pt/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |238| `blockedMarketplaces` | (Apenas configurações gerenciadas) Lista de negação de fontes de marketplace. Aplicado em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin, então um marketplace adicionado antes da política ser definida não pode ser usado para buscar plugins. Fontes bloqueadas são verificadas antes do download, então nunca tocam o sistema de arquivos. Veja [Restrições de marketplace gerenciado](/pt/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

238| `channelsEnabled` | (Apenas configurações gerenciadas) Permitir [channels](/pt/channels) para a organização. Em planos Claude.ai Team e Enterprise, channels são bloqueados quando isto está indefinido ou `false`. Para contas [Anthropic Console](/pt/authentication#claude-console-authentication) usando autenticação de chave de API, channels são permitidos por padrão a menos que sua organização implante configurações gerenciadas, nesse caso esta chave deve ser definida como `true` | `true` |239| `channelsEnabled` | (Apenas configurações gerenciadas) Permitir [channels](/pt/channels) para a organização. Em planos Claude.ai Team e Enterprise, channels são bloqueados quando isto está indefinido ou `false`. Para contas [Anthropic Console](/pt/authentication#claude-console-authentication) usando autenticação de chave de API, channels são permitidos por padrão a menos que sua organização implante configurações gerenciadas, nesse caso esta chave deve ser definida como `true` | `true` |

239| `claudeMd` | (Apenas configurações gerenciadas) Instruções no estilo CLAUDE.md injetadas como memória gerenciada pela organização. Apenas honrado quando definido em configurações gerenciadas ou de política e ignorado em configurações de usuário, projeto e local. Veja [CLAUDE.md em toda a organização](/pt/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |240| `claudeMd` | (Apenas configurações gerenciadas) Instruções no estilo CLAUDE.md injetadas como memória gerenciada pela organização. Apenas honrado quando definido em configurações gerenciadas ou de política e ignorado em configurações de usuário, projeto e local. Veja [CLAUDE.md em toda a organização](/pt/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |


244| `deniedMcpServers` | Quando definido em managed-settings.json, lista de negação de MCP servers que são explicitamente bloqueados. Se aplica a todos os escopos incluindo servers gerenciados. A lista de negação tem precedência sobre a lista de permissões. Veja [Configuração MCP gerenciada](/pt/managed-mcp) | `[{ "serverName": "filesystem" }]` |245| `deniedMcpServers` | Quando definido em managed-settings.json, lista de negação de MCP servers que são explicitamente bloqueados. Se aplica a todos os escopos incluindo servers gerenciados. A lista de negação tem precedência sobre a lista de permissões. Veja [Configuração MCP gerenciada](/pt/managed-mcp) | `[{ "serverName": "filesystem" }]` |

245| `disableAgentView` | Defina como `true` para desligar [agentes em background e visualização de agente](/pt/agent-view): `claude agents`, `--bg`, `/background`, e o supervisor sob demanda. Tipicamente definido em [configurações gerenciadas](/pt/permissions#managed-settings). Equivalente a definir `CLAUDE_CODE_DISABLE_AGENT_VIEW` como `1` | `true` |246| `disableAgentView` | Defina como `true` para desligar [agentes em background e visualização de agente](/pt/agent-view): `claude agents`, `--bg`, `/background`, e o supervisor sob demanda. Tipicamente definido em [configurações gerenciadas](/pt/permissions#managed-settings). Equivalente a definir `CLAUDE_CODE_DISABLE_AGENT_VIEW` como `1` | `true` |

246| `disableAllHooks` | Desabilitar todos os [hooks](/pt/hooks) e qualquer [linha de status](/pt/statusline) personalizada | `true` |247| `disableAllHooks` | Desabilitar todos os [hooks](/pt/hooks) e qualquer [linha de status](/pt/statusline) personalizada | `true` |

248| `disableArtifact` | Defina como `true` para desabilitar a ferramenta [Artifact](/pt/artifacts), que publica saída de sessão como uma página web privada no claude.ai. Equivalente a definir `CLAUDE_CODE_DISABLE_ARTIFACT` como `1` | `true` |

247| `disableAutoMode` | Defina como `"disable"` para impedir que o [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) seja ativado. Remove `auto` do ciclo `Shift+Tab` e rejeita `--permission-mode auto` na inicialização. Mais útil em [configurações gerenciadas](/pt/permissions#managed-settings) onde os usuários não podem substituir | `"disable"` |249| `disableAutoMode` | Defina como `"disable"` para impedir que o [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) seja ativado. Remove `auto` do ciclo `Shift+Tab` e rejeita `--permission-mode auto` na inicialização. Mais útil em [configurações gerenciadas](/pt/permissions#managed-settings) onde os usuários não podem substituir | `"disable"` |

248| `disableBundledSkills` | Defina como `true` para desabilitar as [skills](/pt/skills) e workflows que vêm com o Claude Code: skills agrupadas e workflows são removidos completamente, enquanto comandos slash integrados como `/init` permanecem digitáveis mas são ocultados do modelo. Skills de plugins, `.claude/skills/`, e `.claude/commands/` não são afetadas. Equivalente a definir `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` como `1` | `true` |250| `disableBundledSkills` | Defina como `true` para desabilitar as [skills](/pt/skills) e workflows que vêm com o Claude Code: skills agrupadas e workflows são removidos completamente, enquanto comandos slash integrados como `/init` permanecem digitáveis mas são ocultados do modelo. Skills de plugins, `.claude/skills/`, e `.claude/commands/` não são afetadas. Equivalente a definir `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` como `1` | `true` |

251| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Desabilitar [conectores MCP claude.ai](/pt/mcp#use-mcp-servers-from-claude-ai) para que não sejam auto-buscados ou conectados. Defina em qualquer escopo de configuração. `true` em qualquer fonte tem precedência, então um `.claude/settings.json` de projeto verificado pode optar um repositório por conectores de nuvem, mas um `false` de nível de projeto não pode substituir um `true` de nível de usuário ou política. Servers passados explicitamente via `--mcp-config` não são afetados. Para negar conectores individuais em vez de todos eles, use [`deniedMcpServers`](/pt/managed-mcp). Requer Claude Code v2.1.182 ou posterior | `true` |

249| `disableDeepLinkRegistration` | Defina como `"disable"` para impedir que o Claude Code registre o manipulador de protocolo `claude-cli://` com o sistema operacional na inicialização. [Deep links](/pt/deep-links) permitem que ferramentas externas abram uma sessão do Claude Code com um prompt pré-preenchido. Útil em ambientes onde o registro de manipulador de protocolo é restrito ou gerenciado separadamente | `"disable"` |252| `disableDeepLinkRegistration` | Defina como `"disable"` para impedir que o Claude Code registre o manipulador de protocolo `claude-cli://` com o sistema operacional na inicialização. [Deep links](/pt/deep-links) permitem que ferramentas externas abram uma sessão do Claude Code com um prompt pré-preenchido. Útil em ambientes onde o registro de manipulador de protocolo é restrito ou gerenciado separadamente | `"disable"` |

250| `disabledMcpjsonServers` | Lista de MCP servers específicos de arquivos `.mcp.json` para rejeitar | `["filesystem"]` |253| `disabledMcpjsonServers` | Lista de MCP servers específicos de arquivos `.mcp.json` para rejeitar | `["filesystem"]` |

251| `disableRemoteControl` | {/* min-version: 2.1.128 */}Desabilitar [Controle Remoto](/pt/remote-control): bloqueia `claude remote-control`, a flag `--remote-control`, auto-start, e o toggle em sessão. Tipicamente colocado em [configurações gerenciadas](/pt/permissions#managed-settings) para aplicação de MDM por dispositivo, mas funciona de qualquer escopo. Requer Claude Code v2.1.128 ou posterior | `true` |254| `disableRemoteControl` | {/* min-version: 2.1.128 */}Desabilitar [Controle Remoto](/pt/remote-control): bloqueia `claude remote-control`, a flag `--remote-control`, auto-start, e o toggle em sessão. Tipicamente colocado em [configurações gerenciadas](/pt/permissions#managed-settings) para aplicação de MDM por dispositivo, mas funciona de qualquer escopo. Requer Claude Code v2.1.128 ou posterior | `true` |


288| `preferredNotifChannel` | Método para notificações de conclusão de tarefa e prompt de permissão: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"`, ou `"notifications_disabled"`. Padrão: `"auto"`, que envia uma notificação de desktop em iTerm2, Ghostty, e Kitty e não faz nada em outros terminais. Defina `"terminal_bell"` para tocar o caractere de sino em qualquer terminal. Aparece em `/config` como **Notifications**. Veja [Obter um sino de terminal ou notificação](/pt/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |291| `preferredNotifChannel` | Método para notificações de conclusão de tarefa e prompt de permissão: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"`, ou `"notifications_disabled"`. Padrão: `"auto"`, que envia uma notificação de desktop em iTerm2, Ghostty, e Kitty e não faz nada em outros terminais. Defina `"terminal_bell"` para tocar o caractere de sino em qualquer terminal. Aparece em `/config` como **Notifications**. Veja [Obter um sino de terminal ou notificação](/pt/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |

289| `prefersReducedMotion` | Reduzir ou desabilitar animações de UI (spinners, shimmer, efeitos de flash) para acessibilidade | `true` |292| `prefersReducedMotion` | Reduzir ou desabilitar animações de UI (spinners, shimmer, efeitos de flash) para acessibilidade | `true` |

290| `prUrlTemplate` | Modelo de URL para o badge de PR mostrado no rodapé e em resumos de resultado de ferramenta. Substitui `{host}`, `{owner}`, `{repo}`, `{number}`, e `{url}` da URL de PR relatada por `gh`. Use para apontar links de PR para uma ferramenta de revisão de código interna em vez de `github.com`. Não afeta autolinks `#123` na prosa do Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |293| `prUrlTemplate` | Modelo de URL para o badge de PR mostrado no rodapé e em resumos de resultado de ferramenta. Substitui `{host}`, `{owner}`, `{repo}`, `{number}`, e `{url}` da URL de PR relatada por `gh`. Use para apontar links de PR para uma ferramenta de revisão de código interna em vez de `github.com`. Não afeta autolinks `#123` na prosa do Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

294| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}Conectar [Controle Remoto](/pt/remote-control) automaticamente quando cada sessão interativa inicia, em vez de esperar por `/remote-control`. Defina como `true` para sempre auto-conectar, `false` para nunca auto-conectar, ou deixe indefinido para seguir o padrão da sua organização. Aparece em `/config` como **Enable Remote Control for all sessions**. Veja [Ativar Controle Remoto para todas as sessões](/pt/remote-control#enable-remote-control-for-all-sessions) | `false` |

291| `requiredMaximumVersion` | Apenas configurações gerenciadas. Versão máxima do Claude Code permitida para iniciar. Se a versão em execução for mais nova, o Claude Code sai na inicialização e instrui o usuário a instalar uma versão aprovada através do método aprovado da organização; `claude install <version>` também pode funcionar. Auto-atualizações em background e `claude update` pulam versões acima do teto, então uma instalação dentro do intervalo permanece dentro do intervalo. `claude update`, `claude install`, e `claude doctor` continuam funcionando acima do teto para que os usuários possam se recuperar. Versões que antecedem esta configuração a ignoram | `"2.1.150"` |295| `requiredMaximumVersion` | Apenas configurações gerenciadas. Versão máxima do Claude Code permitida para iniciar. Se a versão em execução for mais nova, o Claude Code sai na inicialização e instrui o usuário a instalar uma versão aprovada através do método aprovado da organização; `claude install <version>` também pode funcionar. Auto-atualizações em background e `claude update` pulam versões acima do teto, então uma instalação dentro do intervalo permanece dentro do intervalo. `claude update`, `claude install`, e `claude doctor` continuam funcionando acima do teto para que os usuários possam se recuperar. Versões que antecedem esta configuração a ignoram | `"2.1.150"` |

292| `requiredMinimumVersion` | Apenas configurações gerenciadas. Versão mínima do Claude Code necessária para iniciar. Se a versão em execução for mais antiga, o Claude Code sai na inicialização e instrui o usuário a atualizar através do método aprovado da organização. `claude update`, `claude install`, e `claude doctor` continuam funcionando abaixo do piso para que os usuários possam se recuperar. Difere de `minimumVersion`, que impede downgrades mas nunca bloqueia a inicialização. Versões que antecedem esta configuração a ignoram | `"2.1.150"` |296| `requiredMinimumVersion` | Apenas configurações gerenciadas. Versão mínima do Claude Code necessária para iniciar. Se a versão em execução for mais antiga, o Claude Code sai na inicialização e instrui o usuário a atualizar através do método aprovado da organização. `claude update`, `claude install`, e `claude doctor` continuam funcionando abaixo do piso para que os usuários possam se recuperar. Difere de `minimumVersion`, que impede downgrades mas nunca bloqueia a inicialização. Versões que antecedem esta configuração a ignoram | `"2.1.150"` |

297| `respondToBashCommands` | {/* min-version: 2.1.186 */}Se Claude responde após um comando shell `!` da caixa de entrada ser executado. Defina como `false` para adicionar a saída do comando ao contexto sem uma resposta. Padrão: `true`. Veja [Modo Shell com prefixo `!`](/pt/interactive-mode#shell-mode-with-prefix). Requer Claude Code v2.1.186 ou posterior | `false` |

293| `respectGitignore` | Controlar se o seletor de arquivo `@` respeita padrões `.gitignore`. Quando `true` (padrão), arquivos correspondentes a padrões `.gitignore` são excluídos das sugestões | `false` |298| `respectGitignore` | Controlar se o seletor de arquivo `@` respeita padrões `.gitignore`. Quando `true` (padrão), arquivos correspondentes a padrões `.gitignore` são excluídos das sugestões | `false` |

294| `showClearContextOnPlanAccept` | Mostrar a opção "limpar contexto" na tela de aceitação do plano. Padrão: `false`. Defina como `true` para restaurar a opção | `true` |299| `showClearContextOnPlanAccept` | Mostrar a opção "limpar contexto" na tela de aceitação do plano. Padrão: `false`. Defina como `true` para restaurar a opção | `true` |

295| `showThinkingSummaries` | Mostrar resumos de [pensamento estendido](/pt/model-config#extended-thinking) em sessões interativas. Quando indefinido ou `false` (padrão em modo interativo), blocos de pensamento são redatados pela API e mostrados como um stub recolhido. A redação apenas muda o que você vê, não o que o modelo gera: para reduzir gastos de pensamento, [reduza o orçamento ou desabilite o pensamento](/pt/model-config#extended-thinking) em vez disso. Esta configuração não tem efeito em modo não interativo (`-p`), no Agent SDK, ou em extensões IDE como VS Code | `true` |300| `showThinkingSummaries` | Mostrar resumos de [pensamento estendido](/pt/model-config#extended-thinking) em sessões interativas. Quando indefinido ou `false` (padrão em modo interativo), blocos de pensamento são redatados pela API e mostrados como um stub recolhido. A redação apenas muda o que você vê, não o que o modelo gera: para reduzir gastos de pensamento, [reduza o orçamento ou desabilite o pensamento](/pt/model-config#extended-thinking) em vez disso. Esta configuração não tem efeito em modo não interativo (`-p`), no Agent SDK, ou em extensões IDE como VS Code | `true` |


305| `strictKnownMarketplaces` | (Apenas configurações gerenciadas) Lista de permissões de marketplaces de plugin. Indefinido = sem restrições, array vazio = bloqueio. Aplicado em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin, então um marketplace adicionado antes da política ser definida não pode ser usado para buscar plugins. Veja [Restrições de marketplace gerenciado](/pt/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |310| `strictKnownMarketplaces` | (Apenas configurações gerenciadas) Lista de permissões de marketplaces de plugin. Indefinido = sem restrições, array vazio = bloqueio. Aplicado em adição de marketplace e em instalação, atualização, atualização e auto-atualização de plugin, então um marketplace adicionado antes da política ser definida não pode ser usado para buscar plugins. Veja [Restrições de marketplace gerenciado](/pt/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

306| `strictPluginOnlyCustomization` | (Apenas configurações gerenciadas) Bloquear skills, agents, hooks, e MCP servers de fontes de usuário e projeto, para que possam vir apenas de plugins ou configurações gerenciadas. `true` bloqueia todas as quatro superfícies; um array bloqueia apenas as nomeadas. Veja [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |311| `strictPluginOnlyCustomization` | (Apenas configurações gerenciadas) Bloquear skills, agents, hooks, e MCP servers de fontes de usuário e projeto, para que possam vir apenas de plugins ou configurações gerenciadas. `true` bloqueia todas as quatro superfícies; um array bloqueia apenas as nomeadas. Veja [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

307| `syntaxHighlightingDisabled` | Desabilitar destaque de sintaxe em diffs, blocos de código e visualizações de arquivo | `true` |312| `syntaxHighlightingDisabled` | Desabilitar destaque de sintaxe em diffs, blocos de código e visualizações de arquivo | `true` |

308| `teammateMode` | Como [colegas de equipe de agente](/pt/agent-teams) são exibidos: `auto` (escolhe painéis divididos em tmux ou iTerm2, em processo caso contrário), `in-process`, ou `tmux` (painéis divididos usando tmux ou iTerm2, detectado do seu terminal). `--teammate-mode` substitui isto para uma sessão. Veja [escolher um modo de exibição](/pt/agent-teams#choose-a-display-mode) | `"in-process"` |313| `teammateMode` | Como [colegas de equipe de agente](/pt/agent-teams) são exibidos: `in-process` (o padrão), `auto` (painéis divididos ao executar dentro de tmux ou iTerm2, em processo caso contrário), `tmux` (painéis divididos usando tmux ou iTerm2, detectado do seu terminal), ou {/* min-version: 2.1.186 */}`iterm2` (painéis divididos nativos do iTerm2 via CLI `it2`, adicionado em v2.1.186). O padrão mudou de `auto` em v2.1.179. `--teammate-mode` substitui isto para uma sessão. Veja [escolher um modo de exibição](/pt/agent-teams#choose-a-display-mode) | `"auto"` |

309| `terminalProgressBarEnabled` | Mostrar a barra de progresso do terminal em terminais suportados: ConEmu, Ghostty 1.2.0+, e iTerm2 3.6.6+. Padrão: `true`. Aparece em `/config` como **Terminal progress bar** | `false` |314| `terminalProgressBarEnabled` | Mostrar a barra de progresso do terminal em terminais suportados: ConEmu, Ghostty 1.2.0+, e iTerm2 3.6.6+. Padrão: `true`. Aparece em `/config` como **Terminal progress bar** | `false` |

310| `theme` | {/* min-version: 2.1.119 */}Tema de cor para a interface: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"`, ou uma referência de tema personalizado como `"custom:<slug>"` ou `"custom:<plugin-name>:<slug>"`. Padrão: `"dark"`. Veja [Criar um tema personalizado](/pt/terminal-config#create-a-custom-theme). Aparece em `/config` como **Theme** | `"dark"` |315| `theme` | {/* min-version: 2.1.119 */}Tema de cor para a interface: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"`, ou uma referência de tema personalizado como `"custom:<slug>"` ou `"custom:<plugin-name>:<slug>"`. Padrão: `"dark"`. Veja [Criar um tema personalizado](/pt/terminal-config#create-a-custom-theme). Aparece em `/config` como **Theme** | `"dark"` |

311| `tui` | Renderizador de UI de terminal. Use `"fullscreen"` para o renderizador [alt-screen](/pt/fullscreen) sem cintilação com scrollback virtualizado. Use `"default"` para o renderizador clássico de tela principal. Defina via `/tui`. Você também pode definir a variável de ambiente [`CLAUDE_CODE_NO_FLICKER`](/pt/env-vars) | `"fullscreen"` |316| `tui` | Renderizador de UI de terminal. Use `"fullscreen"` para o renderizador [alt-screen](/pt/fullscreen) sem cintilação com scrollback virtualizado. Use `"default"` para o renderizador clássico de tela principal. Defina via `/tui`. Você também pode definir a variável de ambiente [`CLAUDE_CODE_NO_FLICKER`](/pt/env-vars) | `"fullscreen"` |


389Configure comportamento avançado de sandboxing. Sandboxing isola comandos bash do seu sistema de arquivos e rede. Veja [Sandboxing](/pt/sandboxing) para detalhes.394Configure comportamento avançado de sandboxing. Sandboxing isola comandos bash do seu sistema de arquivos e rede. Veja [Sandboxing](/pt/sandboxing) para detalhes.

390 395 

391| Chaves | Descrição | Exemplo |396| Chaves | Descrição | Exemplo |

392| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |397| :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |

393| `enabled` | Ativar sandboxing bash (macOS, Linux, e WSL2). Padrão: false | `true` |398| `enabled` | Ativar sandboxing bash (macOS, Linux, e WSL2). Padrão: false | `true` |

394| `failIfUnavailable` | Sair com um erro na inicialização se `sandbox.enabled` é true mas o sandbox não pode iniciar (dependências faltantes ou plataforma não suportada). Quando false (padrão), um aviso é mostrado e comandos executam sem sandbox. Destinado para implantações de configurações gerenciadas que exigem sandboxing como um portão duro | `true` |399| `failIfUnavailable` | Sair com um erro na inicialização se `sandbox.enabled` é true mas o sandbox não pode iniciar (dependências faltantes ou plataforma não suportada). Quando false (padrão), um aviso é mostrado e comandos executam sem sandbox. Destinado para implantações de configurações gerenciadas que exigem sandboxing como um portão duro | `true` |

395| `autoAllowBashIfSandboxed` | Aprovar automaticamente comandos bash quando sandboxed. Padrão: true | `true` |400| `autoAllowBashIfSandboxed` | Aprovar automaticamente comandos bash quando sandboxed. Padrão: true | `true` |


411| `network.socksProxyPort` | Porta de proxy SOCKS5 usada se você deseja trazer seu próprio proxy. Se não especificado, Claude executará seu próprio proxy. | `8081` |416| `network.socksProxyPort` | Porta de proxy SOCKS5 usada se você deseja trazer seu próprio proxy. Se não especificado, Claude executará seu próprio proxy. | `8081` |

412| `enableWeakerNestedSandbox` | Ativar sandbox mais fraco para ambientes Docker sem privilégios (apenas Linux e WSL2). **Reduz segurança.** Padrão: false | `true` |417| `enableWeakerNestedSandbox` | Ativar sandbox mais fraco para ambientes Docker sem privilégios (apenas Linux e WSL2). **Reduz segurança.** Padrão: false | `true` |

413| `enableWeakerNetworkIsolation` | (Apenas macOS) Permitir acesso ao serviço de confiança TLS do sistema (`com.apple.trustd.agent`) no sandbox. Necessário para ferramentas baseadas em Go como `gh`, `gcloud`, e `terraform` verificarem certificados TLS ao usar `httpProxyPort` com um proxy MITM e CA personalizada. **Reduz segurança** abrindo um possível caminho de exfiltração de dados. Padrão: false | `true` |418| `enableWeakerNetworkIsolation` | (Apenas macOS) Permitir acesso ao serviço de confiança TLS do sistema (`com.apple.trustd.agent`) no sandbox. Necessário para ferramentas baseadas em Go como `gh`, `gcloud`, e `terraform` verificarem certificados TLS ao usar `httpProxyPort` com um proxy MITM e CA personalizada. **Reduz segurança** abrindo um possível caminho de exfiltração de dados. Padrão: false | `true` |

419| `allowAppleEvents` | (Apenas macOS) Permitir que comandos sandboxed enviem Apple Events. Necessário para `open`, `osascript`, e ferramentas que abrem URLs em um navegador, que de outra forma falham com erro `-600`. **Remove isolamento de execução de código.** Comandos sandboxed podem lançar outras aplicações sem sandbox sem prompt do usuário; eles também podem enviar comandos AppleScript para aplicações em execução como Terminal, sujeito ao prompt de consentimento de automação por aplicativo do macOS (TCC). Apenas honrado de configurações de usuário, gerenciadas, ou CLI, não de configurações de projeto. Padrão: false | `true` |

414| `bwrapPath` | (Apenas configurações gerenciadas, Linux/WSL2) Caminho absoluto para o binário bubblewrap (`bwrap`). Substitui detecção automática via `PATH`. Apenas honrado de [configurações gerenciadas](/pt/settings#settings-files), não de configurações de usuário ou projeto. Útil quando `bwrap` é instalado em um local não padrão em ambientes gerenciados. | `/opt/admin/bwrap` |420| `bwrapPath` | (Apenas configurações gerenciadas, Linux/WSL2) Caminho absoluto para o binário bubblewrap (`bwrap`). Substitui detecção automática via `PATH`. Apenas honrado de [configurações gerenciadas](/pt/settings#settings-files), não de configurações de usuário ou projeto. Útil quando `bwrap` é instalado em um local não padrão em ambientes gerenciados. | `/opt/admin/bwrap` |

415| `socatPath` | (Apenas configurações gerenciadas, Linux/WSL2) Caminho absoluto para o binário `socat` usado para o proxy de rede do sandbox. Substitui detecção automática via `PATH`. Apenas honrado de configurações gerenciadas. | `/opt/admin/socat` |421| `socatPath` | (Apenas configurações gerenciadas, Linux/WSL2) Caminho absoluto para o binário `socat` usado para o proxy de rede do sandbox. Substitui detecção automática via `PATH`. Apenas honrado de configurações gerenciadas. | `/opt/admin/socat` |

416 422 


467* Descrições de pull request são texto simples473* Descrições de pull request são texto simples

468 474 

469| Chaves | Descrição |475| Chaves | Descrição |

470| :------- | :------------------------------------------------------------------------------------------------ |476| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

471| `commit` | Atribuição para commits git, incluindo qualquer trailer. String vazia oculta atribuição de commit |477| `commit` | Atribuição para commits git, incluindo qualquer trailer. String vazia oculta atribuição de commit |

472| `pr` | Atribuição para descrições de pull request. String vazia oculta atribuição de pull request |478| `pr` | Atribuição para descrições de pull request. String vazia oculta atribuição de pull request |

479| `sessionUrl` | Se deve anexar o link de sessão claude.ai como um trailer `Claude-Session` em commits e um link em descrições de pull request ao executar de uma sessão web ou Controle Remoto. Padrão: `true`. Defina como `false` para omitir o link |

473 480 

474**Atribuição de commit padrão:**481**Atribuição de commit padrão:**

475 482 


497```504```

498 505 

499<Note>506<Note>

500 A configuração `attribution` tem precedência sobre a configuração descontinuada `includeCoAuthoredBy`. Para ocultar toda atribuição, defina `commit` e `pr` como strings vazias.507 A configuração `attribution` tem precedência sobre a configuração descontinuada `includeCoAuthoredBy`. Para ocultar toda atribuição, defina `commit` e `pr` como strings vazias e `sessionUrl` como `false`.

501</Note>508</Note>

502 509 

503<h3 id="file-suggestion-settings">510<h3 id="file-suggestion-settings">

skills.md +38 −1

Details

173 173 

174O sinalizador `--add-dir` e o comando `/add-dir` [concedem acesso a arquivos](/pt/permissions#additional-directories-grant-file-access-not-configuration) em vez de descoberta de configuração, mas skills são uma exceção: `.claude/skills/` dentro de um diretório adicionado é carregado automaticamente. Esta exceção se aplica apenas a `--add-dir` e `/add-dir`. A configuração `permissions.additionalDirectories` em `settings.json` concede acesso a arquivos apenas e não carrega skills. Consulte [Detecção de mudança ao vivo](#live-change-detection) para como edições são detectadas durante uma sessão.174O sinalizador `--add-dir` e o comando `/add-dir` [concedem acesso a arquivos](/pt/permissions#additional-directories-grant-file-access-not-configuration) em vez de descoberta de configuração, mas skills são uma exceção: `.claude/skills/` dentro de um diretório adicionado é carregado automaticamente. Esta exceção se aplica apenas a `--add-dir` e `/add-dir`. A configuração `permissions.additionalDirectories` em `settings.json` concede acesso a arquivos apenas e não carrega skills. Consulte [Detecção de mudança ao vivo](#live-change-detection) para como edições são detectadas durante uma sessão.

175 175 

176Outra configuração `.claude/` como subagents, comandos e estilos de saída não é carregada de diretórios adicionais. Consulte a [tabela de exceções](/pt/permissions#additional-directories-grant-file-access-not-configuration) para a lista completa do que é e não é carregado, e as formas recomendadas de compartilhar configuração entre projetos.176Outra configuração `.claude/` como comandos e estilos de saída não é carregada de diretórios adicionais. Consulte a [tabela de exceções](/pt/permissions#additional-directories-grant-file-access-not-configuration) para a lista completa do que é e não é carregado, e as formas recomendadas de compartilhar configuração entre projetos.

177 177 

178<Note>178<Note>

179 Arquivos CLAUDE.md de diretórios `--add-dir` não são carregados por padrão. Para carregá-los, defina `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. Consulte [Carregar de diretórios adicionais](/pt/memory#load-from-additional-directories).179 Arquivos CLAUDE.md de diretórios `--add-dir` não são carregados por padrão. Para carregá-los, defina `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. Consulte [Carregar de diretórios adicionais](/pt/memory#load-from-additional-directories).


632 632 

633Skills de plugin não são afetadas por `skillOverrides`. Gerencie aquelas através de `/plugin` em vez disso.633Skills de plugin não são afetadas por `skillOverrides`. Gerencie aquelas através de `/plugin` em vez disso.

634 634 

635<h2 id="evaluate-and-iterate-on-a-skill">

636 Avalie e itere em uma skill

637</h2>

638 

639Ver uma skill disparar diz que Claude a encontrou, não que ela fez o que você pretendia. Para saber que uma skill está funcionando, meça duas coisas separadamente: se Claude a invoca nos prompts que deveria, e se a saída corresponde ao que você espera quando o faz.

640 

641A verificação de ambos é uma comparação de linha de base. Colete alguns prompts realistas, execute cada um em uma sessão nova com a skill disponível e novamente com ela [desabilitada](#override-skill-visibility-from-settings), e compare os resultados. Uma sessão nova é importante porque contexto restante da autoria da skill mascarará lacunas nas instruções escritas.

642 

643<h3 id="run-evals-with-skill-creator">

644 Execute avaliações com skill-creator

645</h3>

646 

647O [plugin `skill-creator`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/skill-creator) automatiza o loop de comparação dentro do Claude Code. Instale-o do marketplace oficial:

648 

649```text theme={null}

650/plugin install skill-creator@claude-plugins-official

651```

652 

653Se Claude Code relatar que o plugin não é encontrado em nenhum marketplace, seu marketplace está ausente ou desatualizado. Execute `/plugin marketplace update claude-plugins-official` para atualizá-lo, ou `/plugin marketplace add anthropics/claude-plugins-official` se você não o adicionou antes. Depois tente novamente a instalação.

654 

655Após instalar, execute `/reload-plugins` para tornar as skills do plugin disponíveis na sessão atual. Depois peça ao Claude para avaliar uma skill existente, por exemplo `evaluate my summarize-changes skill with skill-creator`. O plugin o guia através da escrita de casos de teste e executa o loop:

656 

657* **Casos de teste**: armazena prompts, arquivos de entrada e comportamento esperado em `evals/evals.json` dentro do diretório da skill

658* **Execuções isoladas**: gera um [subagent](/pt/sub-agents) por caso de teste para que cada execução comece com um contexto limpo, e registra contagem de token e duração

659* **Classificação**: verifica cada asserção contra a saída e escreve passar ou falhar com evidência para `grading.json`

660* **Benchmark**: agrega taxa de aprovação, tempo e tokens para com-skill versus sem-skill em `benchmark.json` para que você possa comparar a melhoria de taxa de aprovação contra a sobrecarga de token e tempo

661* **Comparação de versão**: executa um cego A/B entre duas versões da skill para que você possa confirmar que uma edição é uma melhoria antes de confirmá-la

662* **Ajuste de descrição**: gera prompts should-trigger e should-not-trigger, mede a taxa de acerto, e propõe edições de descrição quando a skill se ativa em solicitações erradas

663* **Visualizador de revisão**: abre um relatório HTML onde você inspeciona cada saída e registra feedback qualitativo que a próxima iteração lê

664 

665Para o formato do arquivo eval e o fluxo de trabalho de iteração completo, consulte [Evaluating skill output quality](https://agentskills.io/skill-creation/evaluating-skills) em agentskills.io. Para contexto sobre o benchmark e modos de comparação, consulte o [anúncio de skill-creator](https://claude.com/blog/improving-skill-creator-test-measure-and-refine-agent-skills).

666 

635<h2 id="share-skills">667<h2 id="share-skills">

636 Compartilhe skills668 Compartilhe skills

637</h2>669</h2>


8503. Tente reformular sua solicitação para corresponder mais de perto à descrição8823. Tente reformular sua solicitação para corresponder mais de perto à descrição

8514. Invoque-a diretamente com `/skill-name` se a skill é invocável pelo usuário8834. Invoque-a diretamente com `/skill-name` se a skill é invocável pelo usuário

852 884 

885Se o YAML do frontmatter está malformado, Claude Code carrega o corpo da skill com metadados vazios, então `/skill-name` ainda funciona, mas Claude não tem `description` para corresponder. Execute com `--debug` para ver o erro de análise.

886 

853<h3 id="skill-triggers-too-often">887<h3 id="skill-triggers-too-often">

854 Skill dispara muito frequentemente888 Skill dispara muito frequentemente

855</h3>889</h3>


872</h2>906</h2>

873 907 

874* **[Depure sua configuração](/pt/debug-your-config)**: diagnostique por que uma skill não está aparecendo ou sendo acionada908* **[Depure sua configuração](/pt/debug-your-config)**: diagnostique por que uma skill não está aparecendo ou sendo acionada

909* **[Avaliando a qualidade de saída de skill](https://agentskills.io/skill-creation/evaluating-skills)**: o formato do arquivo eval e fluxo de trabalho de iteração em agentskills.io

910* **[Melhores práticas de autoria de skill](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**: orientação de escrita que se aplica em produtos Claude

875* **[Subagents](/pt/sub-agents)**: delegue tarefas para agents especializados911* **[Subagents](/pt/sub-agents)**: delegue tarefas para agents especializados

876* **[Plugins](/pt/plugins)**: empacote e distribua skills com outras extensões912* **[Plugins](/pt/plugins)**: empacote e distribua skills com outras extensões

877* **[Hooks](/pt/hooks)**: automatize fluxos de trabalho em torno de eventos de ferramentas913* **[Hooks](/pt/hooks)**: automatize fluxos de trabalho em torno de eventos de ferramentas

878* **[Memory](/pt/memory)**: gerencie arquivos CLAUDE.md para contexto persistente914* **[Memory](/pt/memory)**: gerencie arquivos CLAUDE.md para contexto persistente

879* **[Comandos](/pt/commands)**: referência para comandos integrados e skills agrupadas915* **[Comandos](/pt/commands)**: referência para comandos integrados e skills agrupadas

880* **[Permissões](/pt/permissions)**: controle acesso a ferramentas e skills916* **[Permissões](/pt/permissions)**: controle acesso a ferramentas e skills

917* **[Claude Tag skills](https://claude.com/docs/claude-tag/admins/skills-repo)**: skills de projeto confirmadas em um repositório também são carregadas quando esse repositório é usado em um canal Claude Tag

slack.md +15 −1

Details

6 6 

7> Delegue tarefas de codificação diretamente do seu espaço de trabalho Slack7> Delegue tarefas de codificação diretamente do seu espaço de trabalho Slack

8 8 

9<Note>

10 Claude Code no Slack está sendo substituído por [Claude Tag](https://claude.com/docs/claude-tag/overview) para espaços de trabalho Team e Enterprise. Claude Tag executa @Claude como a identidade compartilhada da sua organização com acesso configurado pelo administrador, sob o mesmo aplicativo Slack, portanto não há nada para reinstalar e as configurações existentes continuam funcionando durante a transição. Para alternar um espaço de trabalho, consulte [Migrar do Claude anterior no Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).

11</Note>

12 

9Claude Code no Slack traz o poder do Claude Code diretamente para seu espaço de trabalho Slack. Quando você menciona `@Claude` com uma tarefa de codificação, Claude detecta automaticamente a intenção e cria uma sessão Claude Code na web, permitindo que você delegue trabalho de desenvolvimento sem sair de suas conversas em equipe.13Claude Code no Slack traz o poder do Claude Code diretamente para seu espaço de trabalho Slack. Quando você menciona `@Claude` com uma tarefa de codificação, Claude detecta automaticamente a intenção e cria uma sessão Claude Code na web, permitindo que você delegue trabalho de desenvolvimento sem sair de suas conversas em equipe.

10 14 

11Esta integração é construída no aplicativo Claude for Slack existente, mas adiciona roteamento inteligente para Claude Code na web para solicitações relacionadas a codificação.15Esta integração é construída no aplicativo Claude for Slack existente, mas adiciona roteamento inteligente para Claude Code na web para solicitações relacionadas a codificação. Cada sessão é executada sob sua própria conta Claude, usando seus repositórios conectados e seus limites de plano.

12 16 

13<h2 id="use-cases">17<h2 id="use-cases">

14 Casos de uso18 Casos de uso


217 Solução de problemas221 Solução de problemas

218</h2>222</h2>

219 223 

224<h3 id="claude-code-is-not-enabled-for-your-account">

225 "Claude Code não está habilitado para sua conta"

226</h3>

227 

228Este erro significa que sua conta Claude ainda não tem um ambiente em nuvem, não que um administrador precise habilitar algo. Faça login em [claude.ai/code](https://claude.ai/code) uma vez com a mesma conta que você conectou ao Slack. A primeira visita cria seu ambiente em nuvem padrão, e o erro desaparece na sua próxima menção. Cada usuário deve fazer isso individualmente.

229 

220<h3 id="sessions-not-starting">230<h3 id="sessions-not-starting">

221 Sessões não iniciando231 Sessões não iniciando

222</h3>232</h3>


277 Documentação geral do Claude for Slack287 Documentação geral do Claude for Slack

278 </Card>288 </Card>

279 289 

290 <Card title="Claude Tag" icon="users" href="https://claude.com/docs/claude-tag/overview">

291 @Claude gerenciado pela organização no Slack com acesso configurado pelo administrador

292 </Card>

293 

280 <Card title="Slack App Marketplace" icon="store" href="https://slack.com/marketplace/A08SF47R6P4">294 <Card title="Slack App Marketplace" icon="store" href="https://slack.com/marketplace/A08SF47R6P4">

281 Instale o aplicativo Claude no Slack Marketplace295 Instale o aplicativo Claude no Slack Marketplace

282 </Card>296 </Card>

statusline.md +1 −1

Details

15* Trabalha em várias sessões e precisa distingui-las15* Trabalha em várias sessões e precisa distingui-las

16* Quer que a ramificação git e o status estejam sempre visíveis16* Quer que a ramificação git e o status estejam sempre visíveis

17 17 

18O Claude Code também pode renderizar [crachás de links de rodapé](/pt/settings#footer-link-badges): chips clicáveis que aparecem no rodapé quando uma regex configurada corresponde ao texto na conversa. Estes são independentes da linha de status e não interagem com seu script; configure-os com a configuração [`footerLinksRegexes`](/pt/settings#footer-link-badges).18A linha de status é renderizada em sua própria linha acima dos crachás de rodapé integrados e não os substitui. Para adicionar crachás de links clicáveis ao rodapé quando uma ID aparece na conversa, sem escrever um script, configure [`footerLinksRegexes`](/pt/settings#footer-link-badges) em vez disso.

19 19 

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 

sub-agents.md +6 −11

Details

765Subagentes podem ser executados em foreground (bloqueante) ou background (concorrente):765Subagentes podem ser executados em foreground (bloqueante) ou background (concorrente):

766 766 

767* **Subagentes em foreground** bloqueiam a conversa principal até completar. Prompts de permissão são passados para você conforme surgem.767* **Subagentes em foreground** bloqueiam a conversa principal até completar. Prompts de permissão são passados para você conforme surgem.

768* **Subagentes em background** são executados concorrentemente enquanto você continua trabalhando. Eles são executados com as permissões concedidas na sessão e auto-negam qualquer chamada de ferramenta que de outra forma solicitaria. Se um subagente em background precisa fazer perguntas de esclarecimento, essa chamada de ferramenta falha mas o subagente continua.768* **Subagentes em background** são executados concorrentemente enquanto você continua trabalhando. {/* min-version: 2.1.186 */}A partir da v2.1.186, quando um subagente em background atinge uma chamada de ferramenta que precisa de permissão, o prompt aparece em sua sessão principal e nomeia o subagente que está pedindo. Aprove para deixar o subagente continuar, ou pressione Esc para negar essa chamada de ferramenta sem parar o subagente. Antes da v2.1.186, subagentes em background auto-negavam qualquer chamada de ferramenta que teria solicitado.

769 

770Se um subagente em background falha devido a permissões ausentes, você pode iniciar um novo subagente em foreground com a mesma tarefa para tentar novamente com prompts interativos.

771 769 

772Claude decide se deve executar subagentes em foreground ou background baseado na tarefa. Você também pode:770Claude decide se deve executar subagentes em foreground ou background baseado na tarefa. Você também pode:

773 771 


776 774 

777Para desabilitar toda a funcionalidade de tarefa em background, defina a variável de ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` para `1`. Veja [Variáveis de ambiente](/pt/env-vars).775Para desabilitar toda a funcionalidade de tarefa em background, defina a variável de ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` para `1`. Veja [Variáveis de ambiente](/pt/env-vars).

778 776 

779Quando [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) está definido para `1`, cada spawn de subagente é executado em background independentemente do campo `background`. Forks ainda exibem prompts de permissão em seu terminal conforme ocorrem; subagentes nomeados auto-negam qualquer coisa que solicitaria, conforme descrito acima.777Quando [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) está definido para `1`, cada spawn de subagente é executado em background independentemente do campo `background`. Prompts de permissão desses subagentes em background aparecem em sua sessão principal conforme descrito acima.

780 778 

781<h3 id="common-patterns">779<h3 id="common-patterns">

782 Padrões comuns780 Padrões comuns


849 847 

850Um subagente aninhado é configurado da mesma forma que um de nível superior e é resolvido dos mesmos [escopos](#choose-the-subagent-scope). O painel de subagente abaixo da entrada de prompt mostra a árvore completa: cada linha exibe uma contagem `(+N)` de descendentes, e abrir uma linha mostra os filhos diretos desse subagente com um caminho de volta para `main`. A aba Running em [`/agents`](#use-the-%2Fagents-command) lista subagentes em execução como uma lista plana.848Um subagente aninhado é configurado da mesma forma que um de nível superior e é resolvido dos mesmos [escopos](#choose-the-subagent-scope). O painel de subagente abaixo da entrada de prompt mostra a árvore completa: cada linha exibe uma contagem `(+N)` de descendentes, e abrir uma linha mostra os filhos diretos desse subagente com um caminho de volta para `main`. A aba Running em [`/agents`](#use-the-%2Fagents-command) lista subagentes em execução como uma lista plana.

851 849 

852A profundidade é contada como o número de níveis de subagente abaixo da conversa principal, independentemente de cada nível ser executado em [foreground ou background](#run-subagents-in-foreground-or-background):850A profundidade é contada como o número de níveis de subagente abaixo da conversa principal, independentemente de cada nível ser executado em [foreground ou background](#run-subagents-in-foreground-or-background). Um subagente na profundidade cinco não recebe a ferramenta Agent e não pode gerar mais. O limite é fixo e não configurável.

853 

854* **Subagentes em foreground**: podem gerar em qualquer profundidade. Cada nível bloqueia seu pai até retornar, então a cadeia é auto-limitante: a conversa principal aguarda toda a cadeia.

855* **Subagentes em background**: um subagente em background na profundidade cinco não recebe a ferramenta Agent e não pode gerar mais. O limite é fixo e não configurável, e existe para prevenir árvores concorrentes descontroladas.

856 851 

857Para prevenir um subagente específico de gerar outros, omita `Agent` de sua lista [`tools`](#available-tools) ou adicione-o a `disallowedTools`.852Para prevenir um subagente específico de gerar outros, omita `Agent` de sua lista [`tools`](#available-tools) ou adicione-o a `disallowedTools`.

858 853 


888 883 

889Subagentes retomados retêm seu histórico de conversa completo, incluindo todas as chamadas de ferramentas anteriores, resultados e raciocínio. O subagente continua exatamente de onde parou em vez de começar do zero.884Subagentes retomados retêm seu histórico de conversa completo, incluindo todas as chamadas de ferramentas anteriores, resultados e raciocínio. O subagente continua exatamente de onde parou em vez de começar do zero.

890 885 

891Quando um subagente completa, Claude recebe seu ID de agente. Os agentes integrados Explore e Plan são de uma única execução e não retornam ID de agente, então eles não podem ser retomados; use `general-purpose` ou um subagente personalizado quando você precisar continuar o trabalho. Claude usa a ferramenta `SendMessage` com o ID do agente como campo `to` para retomá-lo. A ferramenta `SendMessage` está disponível apenas quando [equipes de agentes](/pt/agent-teams) estão habilitadas via `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`.886Quando um subagente completa, Claude recebe seu ID de agente. Os agentes integrados Explore e Plan são de uma única execução e não retornam ID de agente, então eles não podem ser retomados; use `general-purpose` ou um subagente personalizado quando você precisar continuar o trabalho. Claude usa a ferramenta `SendMessage` com o ID do agente como campo `to` para retomá-lo. A ferramenta `SendMessage` está sempre disponível para retomar subagentes por ID ou nome de agente. Mensagens de protocolo de equipe estruturadas como `shutdown_request` e `plan_approval_response` exigem que [equipes de agentes](/pt/agent-teams) estejam habilitadas.

892 887 

893Para retomar um subagente, peça a Claude para continuar o trabalho anterior:888Para retomar um subagente, peça a Claude para continuar o trabalho anterior:

894 889 


976Uma bifurcação herda tudo que a sessão principal tem no momento em que é gerada. Um subagente nomeado começa a partir de sua própria definição.971Uma bifurcação herda tudo que a sessão principal tem no momento em que é gerada. Um subagente nomeado começa a partir de sua própria definição.

977 972 

978| | Bifurcação | Subagente nomeado |973| | Bifurcação | Subagente nomeado |

979| :---------------------- | :----------------------------------- | :------------------------------------------------------------------------------------------ |974| :---------------------- | :----------------------------------- | :---------------------------------------------------------------------------------------------------------------------- |

980| Context | Histórico de conversa completo | Contexto fresco com o prompt que você passa |975| Context | Histórico de conversa completo | Contexto fresco com o prompt que você passa |

981| System prompt and tools | Mesmo que a sessão principal | Da [definição file](#write-subagent-files) do subagente |976| System prompt and tools | Mesmo que a sessão principal | Da [definição file](#write-subagent-files) do subagente |

982| Model | Mesmo que a sessão principal | Do campo `model` do subagente |977| Model | Mesmo que a sessão principal | Do campo `model` do subagente |

983| Permissions | Prompts aparecem em seu terminal | [Auto-negados](#run-subagents-in-foreground-or-background) quando em execução em background |978| Permissions | Prompts aparecem em seu terminal | [Prompts aparecem em sua sessão principal](#run-subagents-in-foreground-or-background) quando em execução em background |

984| Prompt cache | Compartilhado com a sessão principal | Cache separado |979| Prompt cache | Compartilhado com a sessão principal | Cache separado |

985 980 

986Porque o prompt de sistema de uma bifurcação e as definições de ferramentas são idênticas ao pai, sua primeira solicitação reutiliza o [prompt cache](/pt/prompt-caching#subagents-and-the-cache) do pai. Isso torna bifurcação mais barata do que gerar um subagente fresco para tarefas que precisam do mesmo contexto.981Porque o prompt de sistema de uma bifurcação e as definições de ferramentas são idênticas ao pai, sua primeira solicitação reutiliza o [prompt cache](/pt/prompt-caching#subagents-and-the-cache) do pai. Isso torna bifurcação mais barata do que gerar um subagente fresco para tarefas que precisam do mesmo contexto.

Details

13| Ferramenta | Descrição | Permissão Necessária |13| Ferramenta | Descrição | Permissão Necessária |

14| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |14| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |

15| `Agent` | Cria um [subagent](/pt/sub-agents) com sua própria janela de contexto para lidar com uma tarefa. Veja [comportamento da ferramenta Agent](#agent-tool-behavior) | Não |15| `Agent` | Cria um [subagent](/pt/sub-agents) com sua própria janela de contexto para lidar com uma tarefa. Veja [comportamento da ferramenta Agent](#agent-tool-behavior) | Não |

16| `Artifact` | Publica um arquivo HTML ou Markdown como um [artifact](/pt/artifacts): uma página privada e interativa no claude.ai que você pode compartilhar dentro de sua organização. {/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}Requer um plano Team ou Enterprise e autenticação `/login`; veja [Disponibilidade](/pt/artifacts#availability) | Sim |

16| `AskUserQuestion` | Faz perguntas de múltipla escolha para coletar requisitos ou esclarecer ambiguidades | Não |17| `AskUserQuestion` | Faz perguntas de múltipla escolha para coletar requisitos ou esclarecer ambiguidades | Não |

17| `Bash` | Executa comandos de shell em seu ambiente. Veja [comportamento da ferramenta Bash](#bash-tool-behavior) | Sim |18| `Bash` | Executa comandos de shell em seu ambiente. Veja [comportamento da ferramenta Bash](#bash-tool-behavior) | Sim |

18| `CronCreate` | Agenda uma solicitação recorrente ou única dentro da sessão atual. As tarefas têm escopo de sessão e são restauradas em `--resume` ou `--continue` se não expiradas. Veja [tarefas agendadas](/pt/scheduled-tasks) | Não |19| `CronCreate` | Agenda uma solicitação recorrente ou única dentro da sessão atual. As tarefas têm escopo de sessão e são restauradas em `--resume` ou `--continue` se não expiradas. Veja [tarefas agendadas](/pt/scheduled-tasks) | Não |


35| `ReadMcpResourceTool` | Lê um recurso MCP específico por URI | Não |36| `ReadMcpResourceTool` | Lê um recurso MCP específico por URI | Não |

36| `RemoteTrigger` | Cria, atualiza, executa e lista [Routines](/pt/routines) no claude.ai. Suporta o comando `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines vivem no claude.ai e requerem um plano Pro, Max, Team ou Enterprise, portanto esta ferramenta não é acessível do Amazon Bedrock, Google Vertex AI ou Microsoft Foundry | Não |37| `RemoteTrigger` | Cria, atualiza, executa e lista [Routines](/pt/routines) no claude.ai. Suporta o comando `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines vivem no claude.ai e requerem um plano Pro, Max, Team ou Enterprise, portanto esta ferramenta não é acessível do Amazon Bedrock, Google Vertex AI ou Microsoft Foundry | Não |

37| `ScheduleWakeup` | Reagenda a próxima iteração de um [`/loop` auto-paced](/pt/scheduled-tasks#let-claude-choose-the-interval). Claude chama isso no final de cada iteração para escolher quando a próxima será executada, entre um minuto e uma hora; você não a chama diretamente. O wakeup pendente aparece em `session_crons` em [Stop hook input](/pt/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Não disponível no Amazon Bedrock, Google Vertex AI ou Microsoft Foundry, onde um prompt `/loop` sem intervalo é executado em um cronograma fixo | Não |38| `ScheduleWakeup` | Reagenda a próxima iteração de um [`/loop` auto-paced](/pt/scheduled-tasks#let-claude-choose-the-interval). Claude chama isso no final de cada iteração para escolher quando a próxima será executada, entre um minuto e uma hora; você não a chama diretamente. O wakeup pendente aparece em `session_crons` em [Stop hook input](/pt/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Não disponível no Amazon Bedrock, Google Vertex AI ou Microsoft Foundry, onde um prompt `/loop` sem intervalo é executado em um cronograma fixo | Não |

38| `SendMessage` | Envia uma mensagem para um [membro da equipe de agentes](/pt/agent-teams), ou [retoma um subagent](/pt/sub-agents#resume-subagents) por seu ID de agente. Subagents parados retomam automaticamente em segundo plano. Disponível apenas quando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` está definido | Não |39| `SendMessage` | Envia uma mensagem para um [membro da equipe de agentes](/pt/agent-teams), ou [retoma um subagent](/pt/sub-agents#resume-subagents) por seu ID de agente. Subagents parados retomam automaticamente em segundo plano. Mensagens de protocolo de equipe estruturadas requerem equipes de agentes | Não |

39| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Carrega `ONBOARDING.md` e retorna um link de compartilhamento que colegas podem abrir no Claude Code. Chamado de `/team-onboarding` após o guia ser escrito. Disponível para assinantes do claude.ai em planos Pro, Max, Team e Enterprise | Sim |40| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Carrega `ONBOARDING.md` e retorna um link de compartilhamento que colegas podem abrir no Claude Code. Chamado de `/team-onboarding` após o guia ser escrito. Disponível para assinantes do claude.ai em planos Pro, Max, Team e Enterprise | Sim |

40| `Skill` | Executa uma [skill](/pt/skills#control-who-invokes-a-skill) dentro da conversa principal | Sim |41| `Skill` | Executa uma [skill](/pt/skills#control-who-invokes-a-skill) dentro da conversa principal | Sim |

41| `TaskCreate` | Cria uma nova tarefa na lista de tarefas | Não |42| `TaskCreate` | Cria uma nova tarefa na lista de tarefas | Não |


102Iniciar o subagent não solicita permissão por si só. As chamadas de ferramenta do subagent são verificadas contra suas regras de permissão conforme ele é executado:103Iniciar o subagent não solicita permissão por si só. As chamadas de ferramenta do subagent são verificadas contra suas regras de permissão conforme ele é executado:

103 104 

104* **Subagents em primeiro plano** mostram os mesmos prompts de permissão que você veria na conversa principal, no momento em que cada chamada de ferramenta acontece.105* **Subagents em primeiro plano** mostram os mesmos prompts de permissão que você veria na conversa principal, no momento em que cada chamada de ferramenta acontece.

105* **Subagents em segundo plano** não mostram prompts. Eles são executados com as permissões concedidas na sessão e negam automaticamente qualquer chamada de ferramenta que de outra forma solicitaria. Após uma negação, o subagent continua sem essa ferramenta.106* **Subagents em segundo plano** {/* min-version: 2.1.186 */}exibem prompts de permissão em sua sessão principal a partir da v2.1.186. O prompt indica qual subagent está solicitando, e pressionar Esc nega essa chamada de ferramenta sem parar o subagent. Antes da v2.1.186, subagents em segundo plano negavam automaticamente qualquer chamada de ferramenta que de outra forma solicitaria e continuavam sem essa ferramenta.

106 107 

107Para limitar o que um subagent pode alcançar em primeiro lugar, restrinja seu campo `tools`, deixe Bash fora da lista ou defina regras de negação em suas configurações, conforme descrito em [Controlar capacidades de subagent](/pt/sub-agents#control-subagent-capabilities). Para mais informações sobre como escolher entre primeiro plano e segundo plano, veja [Executar subagents em primeiro plano ou segundo plano](/pt/sub-agents#run-subagents-in-foreground-or-background).108Para limitar o que um subagent pode alcançar em primeiro lugar, restrinja seu campo `tools`, deixe Bash fora da lista ou defina regras de negação em suas configurações, conforme descrito em [Controlar capacidades de subagent](/pt/sub-agents#control-subagent-capabilities). Para mais informações sobre como escolher entre primeiro plano e segundo plano, veja [Executar subagents em primeiro plano ou segundo plano](/pt/sub-agents#run-subagents-in-foreground-or-background).

108 109 

ultrareview.md +16 −13

Details

12 12 

13Ultrareview é uma revisão de código profunda que é executada no Claude Code na infraestrutura web. Quando você executa `/code-review ultra`, Claude Code inicia uma frota de agentes revisores em um sandbox remoto para encontrar bugs em sua branch ou pull request.13Ultrareview é uma revisão de código profunda que é executada no Claude Code na infraestrutura web. Quando você executa `/code-review ultra`, Claude Code inicia uma frota de agentes revisores em um sandbox remoto para encontrar bugs em sua branch ou pull request.

14 14 

15Comparado a um `/review` local, ultrareview oferece:15Comparado a um `/code-review` ou `/review` local, ultrareview oferece:

16 16 

17* **Sinal mais alto**: cada descoberta relatada é reproduzida e verificada independentemente, portanto os resultados se concentram em bugs reais em vez de sugestões de estilo17* **Sinal mais alto**: cada descoberta relatada é reproduzida e verificada independentemente, portanto os resultados se concentram em bugs reais em vez de sugestões de estilo

18* **Cobertura mais ampla**: muitos agentes revisores exploram a mudança em paralelo, o que expõe problemas que uma revisão de passagem única pode perder18* **Cobertura mais ampla**: uma frota maior de agentes revisores explora a mudança em paralelo, o que expõe problemas que uma revisão de esforço médio local pode perder

19* **Sem uso de recursos locais**: a revisão é executada inteiramente em um sandbox remoto, portanto seu terminal permanece livre para outro trabalho enquanto é executada19* **Sem uso de recursos locais**: a revisão é executada inteiramente em um sandbox remoto, portanto seu terminal permanece livre para outro trabalho enquanto é executada

20 20 

21Ultrareview requer autenticação com uma conta Claude.ai porque é executado no Claude Code na infraestrutura web. Se você está conectado apenas com uma chave de API, execute `/login` e autentique-se com Claude.ai primeiro. Ultrareview não está disponível ao usar Claude Code com Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry, e não está disponível para organizações que habilitaram Zero Data Retention.21Ultrareview requer autenticação com uma conta Claude.ai porque é executado no Claude Code na infraestrutura web. Se você está conectado apenas com uma chave de API, execute `/login` e autentique-se com Claude.ai primeiro. Ultrareview não está disponível ao usar Claude Code com Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry, e não está disponível para organizações que habilitaram Zero Data Retention.


42 42 

43<Tip>43<Tip>

44 Se seu repositório for muito grande para agrupar, Claude Code o solicita a usar o modo PR. Envie sua branch e abra uma PR de rascunho, depois execute `/code-review ultra <PR-number>`.44 Se seu repositório for muito grande para agrupar, Claude Code o solicita a usar o modo PR. Envie sua branch e abra uma PR de rascunho, depois execute `/code-review ultra <PR-number>`.

45 

46 Se o diff da pull request for muito grande, Claude Code recusa a revisão com uma dica de escopo antes de qualquer trabalho de revisão ser executado.

45</Tip>47</Tip>

46 48 

47Antes de iniciar, Claude Code mostra um diálogo de confirmação com o escopo da revisão (incluindo a contagem de arquivos e linhas ao revisar uma branch), suas execuções gratuitas restantes e o custo estimado. Depois que você confirmar, a revisão continua em segundo plano e você pode continuar usando sua sessão. O comando é executado apenas quando você o invoca com `/code-review ultra`; Claude não inicia um ultrareview por conta própria.49Antes de iniciar, Claude Code mostra um diálogo de confirmação com o escopo da revisão (incluindo a contagem de arquivos e linhas ao revisar uma branch), suas execuções gratuitas restantes e o custo estimado. Depois que você confirmar, a revisão continua em segundo plano e você pode continuar usando sua sessão. O comando é executado apenas quando você o invoca com `/code-review ultra`; Claude não inicia um ultrareview por conta própria.


95 97 

96Para revisões automáticas em pull requests do GitHub, [Code Review](/pt/code-review) integra-se diretamente com seu repositório e publica descobertas como comentários inline de PR sem uma etapa de CLI.98Para revisões automáticas em pull requests do GitHub, [Code Review](/pt/code-review) integra-se diretamente com seu repositório e publica descobertas como comentários inline de PR sem uma etapa de CLI.

97 99 

98<h2 id="how-ultrareview-compares-to-/review">100<h2 id="how-ultrareview-compares-to-/code-review-and-/review">

99 Como ultrareview se compara a /review101 Como ultrareview se compara a /code-review e /review

100</h2>102</h2>

101 103 

102Ambos os comandos revisam código, mas visam diferentes estágios do seu fluxo de trabalho.104Todos os três comandos revisam código, mas visam diferentes estágios do seu fluxo de trabalho.

103 105 

104| | `/review` | `/code-review ultra` |106| | `/code-review` | `/review <pr>` | `/code-review ultra` |

105| ------------ | -------------------------------- | --------------------------------------------------------------------------------------- |107| ------------ | --------------------------------- | --------------------------------------------- | --------------------------------------------------------------------------------------- |

106| Execuções | localmente em sua sessão | remotamente em um sandbox na nuvem |108| Alvo | seu diff de trabalho | um pull request do GitHub | seu diff de trabalho ou um pull request |

107| Profundidade | revisão de passagem única | frota multi-agente com verificação independente |109| Execuções | localmente em sua sessão | localmente em sua sessão | remotamente em um sandbox na nuvem |

108| Duração | segundos a alguns minutos | aproximadamente 5 a 10 minutos |110| Profundidade | escala com o argumento de esforço | o mecanismo `/code-review` médio | frota multi-agente com verificação independente |

109| Custo | conta para uso normal | execuções gratuitas, depois aproximadamente \$5 a \$20 por revisão como créditos de uso |111| Duração | segundos a alguns minutos | alguns minutos | aproximadamente 5 a 10 minutos |

110| Melhor para | feedback rápido durante iteração | confiança pré-merge em mudanças substanciais |112| Custo | conta para uso normal | conta para uso normal | execuções gratuitas, depois aproximadamente \$5 a \$20 por revisão como créditos de uso |

113| Melhor para | feedback rápido durante iteração | revisando um PR de um colega antes de aprovar | confiança pré-merge em mudanças substanciais |

111 114 

112Use `/review` para feedback rápido enquanto trabalha. Use `/code-review ultra` antes de fazer merge de uma mudança substancial quando você quer uma passagem mais profunda que capture problemas que uma revisão única pode perder.115Use `/code-review` para feedback rápido enquanto trabalha. Use `/review <pr>` para revisar um pull request da mesma forma que você faria antes de aprová-lo. Use `/code-review ultra` antes de fazer merge de uma mudança substancial quando você quer uma passagem mais profunda que capture problemas que uma revisão local pode perder.

113 116 

114<h2 id="related-resources">117<h2 id="related-resources">

115 Recursos relacionados118 Recursos relacionados

Details

34 <span className="digest-feature-pill">v2.1.172</span>34 <span className="digest-feature-pill">v2.1.172</span>

35 </div>35 </div>

36 36 

37 <p className="digest-feature-lede">Sub-agentes agora podem gerar seus próprios sub-agentes. O painel de subagente abaixo do prompt mostra a árvore completa: cada linha carrega uma contagem de seus descendentes e um caminho de volta para <code>main</code>. Sub-agentes em segundo plano são limitados a cinco níveis de profundidade para evitar árvores concorrentes descontroladas; cadeias em primeiro plano podem gerar em qualquer profundidade e são auto-limitantes.</p>37 <p className="digest-feature-lede">Sub-agentes agora podem gerar seus próprios sub-agentes. O painel de subagente abaixo do prompt mostra a árvore completa: cada linha carrega uma contagem de seus descendentes e um caminho de volta para <code>main</code>. Cadeias de sub-agentes são limitadas a cinco níveis de profundidade para evitar árvores concorrentes descontroladas.</p>

38 38 

39 <p className="digest-feature-try">Abra a visualização de agentes para observar a árvore aninhada conforme o trabalho se expande:</p>39 <p className="digest-feature-try">Abra a visualização de agentes para observar a árvore aninhada conforme o trabalho se expande:</p>

40 40 

workflows.md +2 −1

Details

110| `Enter` ou `→` | Aprofundar-se na fase selecionada, depois em um agente para ler seu prompt, chamadas de ferramentas recentes e resultado |110| `Enter` ou `→` | Aprofundar-se na fase selecionada, depois em um agente para ler seu prompt, chamadas de ferramentas recentes e resultado |

111| `Esc` | Voltar um nível |111| `Esc` | Voltar um nível |

112| `j` / `k` | Rolar dentro do detalhe do agente quando transborda |112| `j` / `k` | Rolar dentro do detalhe do agente quando transborda |

113| `f` | {/* min-version: 2.1.186 */}Filtrar a lista de agentes na fase selecionada por status. Pressione novamente para ciclar |

113| `p` | Pausar ou retomar a execução |114| `p` | Pausar ou retomar a execução |

114| `x` | Parar o agente selecionado, ou parar todo o fluxo de trabalho quando o foco está na execução |115| `x` | Parar o agente selecionado, ou parar todo o fluxo de trabalho quando o foco está na execução |

115| `r` | Reiniciar o agente em execução selecionado |116| `r` | Reiniciar o agente em execução selecionado |


198 199 

199Pressione Enter para salvar. O fluxo de trabalho é executado como `/<name>` em futuras sessões de qualquer local.200Pressione Enter para salvar. O fluxo de trabalho é executado como `/<name>` em futuras sessões de qualquer local.

200 201 

201{/* min-version: 2.1.178 */}A partir da v2.1.178, salvar no local do projeto escreve no diretório `.claude/workflows/` mais próximo que já existe entre seu diretório de trabalho e a raiz do repositório, ou para a raiz do repositório se nenhum existir ainda. Os fluxos de trabalho do projeto também carregam de cada `.claude/workflows/` ao longo desse caminho, e quando mais de um define o mesmo nome Claude Code executa o mais próximo do diretório de trabalho.202{/* min-version: 2.1.178 */}Em um monorepo com vários diretórios `.claude/`, você pode manter fluxos de trabalho ao lado do pacote ao qual se aplicam. A partir da v2.1.178, salvar no local do projeto escreve no diretório `.claude/workflows/` mais próximo que já existe entre seu diretório de trabalho e a raiz do repositório, ou para a raiz do repositório se nenhum existir ainda. Os fluxos de trabalho do projeto também carregam de cada `.claude/workflows/` ao longo desse caminho, e quando mais de um define o mesmo nome Claude Code executa o mais próximo do diretório de trabalho.

202 203 

203Se um fluxo de trabalho de projeto e um fluxo de trabalho pessoal compartilham um nome, o do projeto é executado.204Se um fluxo de trabalho de projeto e um fluxo de trabalho pessoal compartilham um nome, o do projeto é executado.

204 205 

Details

58Quando ZDR está ativado para uma organização do Claude Code no Claude for Enterprise, certos recursos que requerem armazenamento de prompts ou conclusões são automaticamente desabilitados no nível do backend:58Quando ZDR está ativado para uma organização do Claude Code no Claude for Enterprise, certos recursos que requerem armazenamento de prompts ou conclusões são automaticamente desabilitados no nível do backend:

59 59 

60| Recurso | Motivo |60| Recurso | Motivo |

61| ------------------------------------------------------------------- | --------------------------------------------------------------------- |61| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |

62| [Claude Code na Web](/pt/claude-code-on-the-web) | Requer armazenamento no servidor do histórico de conversas. |62| [Claude Code na Web](/pt/claude-code-on-the-web) | Requer armazenamento no servidor do histórico de conversas. |

63| [Sessões remotas](/pt/desktop#cloud-sessions) do aplicativo Desktop | Requer dados de sessão persistentes que incluem prompts e conclusões. |63| [Sessões remotas](/pt/desktop#cloud-sessions) do aplicativo Desktop | Requer dados de sessão persistentes que incluem prompts e conclusões. |

64| [Artefatos](/pt/artifacts) | Requer armazenamento de conteúdo de página publicado na infraestrutura operada pela Anthropic. |

64| Envio de feedback (`/feedback`) | Enviar feedback envia dados de conversas para a Anthropic. |65| Envio de feedback (`/feedback`) | Enviar feedback envia dados de conversas para a Anthropic. |

65 66 

66Esses recursos são bloqueados no backend independentemente da exibição no lado do cliente. Se você vir um recurso desabilitado no terminal do Claude Code durante a inicialização, tentar usá-lo retorna um erro indicando que as políticas da organização não permitem essa ação.67Esses recursos são bloqueados no backend independentemente da exibição no lado do cliente. Se você vir um recurso desabilitado no terminal do Claude Code durante a inicialização, tentar usá-lo retorna um erro indicando que as políticas da organização não permitem essa ação.