Documentation 2026-11-02 23:57 UTC to 2026-11-03 23:58 UTC

79* Implante `wslInheritsWindowsSettings: true` através do registro HKLM ou do arquivo `C:\Program Files\ClaudeCode` para que as sessões WSL herdem a mesma política que as sessões do host.79* Implante `wslInheritsWindowsSettings: true` através do registro HKLM ou do arquivo `C:\Program Files\ClaudeCode` para que as sessões WSL herdem a mesma política que as sessões do host.

80* Verifique executando `/status` dentro de uma sessão WSL e lendo a linha `Setting sources`. Para interpretar o que ela lista, consulte [Leia a fonte em /status](https://code.claude.com/docs/pt/managed-settings.md#read-the-source-in-/status).80* Verifique executando `/status` dentro de uma sessão WSL e lendo a linha `Setting sources`. Para interpretar o que ela lista, consulte [Leia a fonte em /status](https://code.claude.com/docs/pt/managed-settings.md#read-the-source-in-/status).

81 81 

82Se uma sessão WSL iniciar em um dispositivo com a lista [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/configuration#allowedworkspacefolders) do Claude Desktop, uma entrada `~` significa o diretório pessoal dentro da distribuição.

83 

82Os processos dentro da VM utilitária WSL 2 não são visíveis para os sensores de detecção de endpoint do lado do Windows. Para observar a atividade de processo e arquivo dentro da distribuição, verifique a orientação WSL do seu fornecedor de detecção de endpoint para um sensor Linux que você possa executar dentro da distribuição e as exclusões que ele precisa. A [telemetria de execução de ferramentas OpenTelemetry](https://code.claude.com/docs/pt/monitoring-usage.md) do Claude Code é emitida de forma idêntica para sessões WSL e nativas.84Os processos dentro da VM utilitária WSL 2 não são visíveis para os sensores de detecção de endpoint do lado do Windows. Para observar a atividade de processo e arquivo dentro da distribuição, verifique a orientação WSL do seu fornecedor de detecção de endpoint para um sensor Linux que você possa executar dentro da distribuição e as exclusões que ele precisa. A [telemetria de execução de ferramentas OpenTelemetry](https://code.claude.com/docs/pt/monitoring-usage.md) do Claude Code é emitida de forma idêntica para sessões WSL e nativas.

83 85 

84## Decida o que aplicar86## Decida o que aplicar

127 129 

128### Contas do GitHub conectadas130### Contas do GitHub conectadas

129 131 

130Nos planos Team e Enterprise, a seção GitHub de [**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) lista as organizações do GitHub e as contas pessoais vinculadas à sua organização Claude por meio do [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) e Claude Security compartilham essa lista. Para abrir a página, é necessária uma função de administrador na sua organização Claude.132Nos planos Team e Enterprise, a seção GitHub de [**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) lista as organizações do GitHub e as contas pessoais vinculadas à sua organização Claude por meio do [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) e Claude Security compartilham essa lista. Para abrir a página, é necessária a [função Owner](https://code.claude.com/docs/pt/server-managed-settings.md#access-control) na sua organização Claude. A função Admin não consegue abri-la.

131 133 

132Um administrador ou um membro pode vincular uma conta:134Alguém pode vincular uma conta pela página de provedores Git ou conectando o GitHub ao Claude:

133 135 

134* **Conexão de administrador**: um administrador clica em **Connect** nessa seção, ou em **Add organization** depois que uma conta estiver conectada, e instala o Claude GitHub App em uma organização do GitHub. Vincular uma organização dessa forma requer alguém que seja ao mesmo tempo proprietário da organização do GitHub e administrador da sua organização Claude.136* **Conexão de Owner**: um Owner clica em **Connect** nessa seção, ou em **Add organization** depois que uma conta estiver conectada, e instala o Claude GitHub App em uma organização do GitHub. Vincular uma organização dessa forma requer um Owner da sua organização Claude que também seja proprietário da organização do GitHub.

135* **Conexão de membro**: quando um membro conecta sua conta do GitHub ao Claude, por exemplo ao [configurar sessões na nuvem](https://code.claude.com/docs/pt/web-quickstart.md#connect-github), o Claude vincula as contas do GitHub que esse membro possui nas quais o Claude GitHub App já está instalado. Isso pode incluir a conta pessoal dele e as organizações do GitHub das quais ele é proprietário.137* **Conexão de membro**: quando um membro conecta sua conta do GitHub ao Claude, por exemplo ao [configurar sessões na nuvem](https://code.claude.com/docs/pt/web-quickstart.md#connect-github), o Claude vincula as contas do GitHub que esse membro possui nas quais o Claude GitHub App já está instalado. Isso pode incluir a conta pessoal dele e as organizações do GitHub das quais ele é proprietário.

136 138 

137Uma linha marcada como **Not linked** vem do seu próprio login no GitHub. É uma conta que você pode ver no GitHub na qual o Claude GitHub App está instalado.139Uma linha marcada como **Not linked** vem do seu próprio login no GitHub. É uma conta que você pode ver no GitHub na qual o Claude GitHub App está instalado.

222>222>

223> `effort` troca latência e custo de token por profundidade de raciocínio dentro de cada resposta. [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) é um recurso separado que produz blocos `thinking` na saída, e o campo `display` em `ThinkingConfig` para [Python](https://code.claude.com/docs/pt/agent-sdk/python.md#thinkingconfig) ou [TypeScript](https://code.claude.com/docs/pt/agent-sdk/typescript.md#thinkingconfig) controla se você recebe seu texto. Eles são independentes: você pode definir `effort: "low"` com extended thinking habilitado, ou `effort: "max"` sem ele.223> `effort` troca latência e custo de token por profundidade de raciocínio dentro de cada resposta. [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) é um recurso separado que produz blocos `thinking` na saída, e o campo `display` em `ThinkingConfig` para [Python](https://code.claude.com/docs/pt/agent-sdk/python.md#thinkingconfig) ou [TypeScript](https://code.claude.com/docs/pt/agent-sdk/typescript.md#thinkingconfig) controla se você recebe seu texto. Eles são independentes: você pode definir `effort: "low"` com extended thinking habilitado, ou `effort: "max"` sem ele.

224 224 

225Use esforço mais baixo para agentes que fazem tarefas simples e bem definidas (como listar arquivos ou executar um único grep) para reduzir custo e latência. Defina `effort` nas opções de nível superior `query()` para toda a sessão, ou por subagent com o campo `effort` em [`AgentDefinition`](https://code.claude.com/docs/pt/agent-sdk/subagents#agentdefinition-configuration) para substituir o nível de sessão.225Use esforço mais baixo para agentes que fazem tarefas simples e bem definidas, como listar arquivos ou executar um único grep, para reduzir custo e latência. Defina `effort` nas opções de nível superior `query()` para a [sessão](https://code.claude.com/docs/pt/sub-agents.md#choose-an-effort-level), ou por subagente com o campo `effort` em [`AgentDefinition`](https://code.claude.com/docs/pt/agent-sdk/subagents#agentdefinition-configuration) para sobrescrever o nível da sessão.

226 226 

227### Modo de permissão227### Modo de permissão

228 228 

224| `matcher` | `string` | `undefined` | Padrão correspondido contra o campo de filtro do evento, seguindo as [regras para matchers em arquivos de configuração](https://code.claude.com/docs/pt/hooks.md#matcher-patterns). Para hooks de ferramenta, esse campo é o nome da ferramenta. As ferramentas integradas incluem `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` e outras. Veja [Tipos de Entrada de Ferramenta](https://code.claude.com/docs/pt/agent-sdk/typescript.md#tool-input-types) para a lista completa. Ferramentas MCP usam o padrão `mcp__<server>__<action>`, onde `<server>` é a chave que você usa na configuração `mcpServers`, escrita conforme descrito na [convenção de nomenclatura de ferramentas](https://code.claude.com/docs/pt/agent-sdk/mcp.md#tool-naming-convention). |224| `matcher` | `string` | `undefined` | Padrão correspondido contra o campo de filtro do evento, seguindo as [regras para matchers em arquivos de configuração](https://code.claude.com/docs/pt/hooks.md#matcher-patterns). Para hooks de ferramenta, esse campo é o nome da ferramenta. As ferramentas integradas incluem `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` e outras. Veja [Tipos de Entrada de Ferramenta](https://code.claude.com/docs/pt/agent-sdk/typescript.md#tool-input-types) para a lista completa. Ferramentas MCP usam o padrão `mcp__<server>__<action>`, onde `<server>` é a chave que você usa na configuração `mcpServers`, escrita conforme descrito na [convenção de nomenclatura de ferramentas](https://code.claude.com/docs/pt/agent-sdk/mcp.md#tool-naming-convention). |

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

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

227| `onFailure` | `"continue" \| "block"` | `undefined` | O que um callback com falha faz. Defina `"block"` para [bloquear a ação quando um callback falhar](#block-the-action-when-a-callback-fails). Em Python, use `on_failure` |

227 228 

228Use o padrão `matcher` para direcionar ferramentas específicas sempre que possível. Um matcher com `'Bash'` é executado apenas para comandos Bash, enquanto omitir o padrão executa seus callbacks para cada ocorrência do evento.229Use o padrão `matcher` para direcionar ferramentas específicas sempre que possível. Um matcher com `'Bash'` é executado apenas para comandos Bash, enquanto omitir o padrão executa seus callbacks para cada ocorrência do evento.

229 230 

283>284>

284> Saídas assíncronas não podem bloquear, modificar ou injetar contexto na operação, pois o agente já avançou. Use-as apenas para efeitos colaterais como registro, métricas ou notificações.285> Saídas assíncronas não podem bloquear, modificar ou injetar contexto na operação, pois o agente já avançou. Use-as apenas para efeitos colaterais como registro, métricas ou notificações.

285 286 

287### Bloquear a ação quando um callback falhar

288 

289Na maioria dos eventos, se um callback lançar uma exceção ou retornar uma saída que falhe na validação, a ação prossegue e sua aplicação recebe um aviso [`SDKInformationalMessage`](https://code.claude.com/docs/pt/agent-sdk/typescript#sdkinformationalmessage) cujo `tag` é `hook_callback_failed`. Um guard `PreToolUse` que trava permite então que a chamada de ferramenta chegue ao fluxo de permissão normal. Um callback que não retorna nada, como um caminho sem `return`, também conta como falha. Em Python, leia `tag` de `SystemMessage.data`.

290 

291Para bloquear a ação em vez disso, defina `onFailure: "block"` em TypeScript ou `on_failure="block"` em Python no matcher. Requer Agent SDK TypeScript v0.3.317 ou posterior, ou Agent SDK Python v0.2.177 ou posterior. Este exemplo bloqueia uma chamada Bash quando `check_policy` em Python ou `checkPolicy` em TypeScript falha:

292 

293```python Python theme={null}

294options = ClaudeAgentOptions(

295 hooks={

296 "PreToolUse": [

297 HookMatcher(matcher="Bash", hooks=[check_policy], on_failure="block")

298 ]

299 }

300)

301```

302 

303```typescript TypeScript theme={null}

304import type { Options } from "@anthropic-ai/claude-agent-sdk";

305 

306const options: Options = {

307 hooks: {

308 PreToolUse: [{ matcher: "Bash", hooks: [checkPolicy], onFailure: "block" }]

309 }

310};

311```

312 

313Para testar, faça o callback lançar um erro e peça a Claude para executar um comando Bash. O resultado da ferramenta inclui `failed; blocking because onFailure is "block"`, e Claude não vê o texto do seu erro.

314 

315Retorne `{}` quando o callback não tiver opinião. Com `"block"` definido, um caminho sem `return` bloqueia a ação. Um callback que captura seu próprio erro e retorna `{}` não está falhando, então deixe o erro se propagar a partir de um guard.

316 

317#### Eventos que se comportam de forma diferente

318 

319Estes eventos nem sempre bloqueiam com `"block"` definido:

320 

321* **`Stop`, `SubagentStop`, `TaskCompleted` e `TeammateIdle`**: estes eventos ignoram a opção, então a ação prossegue.

322* **`PermissionRequest`**: o bloqueio só conta se chegar antes que seu callback `canUseTool` responda.

323* **`PostToolUse`**: a ferramenta já foi executada, então Claude recebe a falha como feedback.

324 

325Um callback que excede seu timeout segue [Timeout de hook](#hook-timeout). Com `"block"` definido, um timeout também bloqueia `PreCompact`, `Elicitation` e `WorktreeCreate`.

326 

327#### Erros de inicialização para `onFailure`

328 

329Com `"block"` definido, a consulta falha na inicialização e não envia nenhum prompt quando não consegue honrar a opção:

330 

331* **Claude Code não suporta a opção**: o erro inclui `does not honor`. Atualize o Claude Code ou remova a opção.

332* **A sessão já estava em execução e não registrou seus hooks**: o erro inclui `did not register your hooks`. Inicie uma nova sessão.

333 

286## Exemplos334## Exemplos

287 335 

288Vários exemplos nesta seção mostram apenas a função de callback. Para executar um, registre o callback sob o evento correspondente no campo `hooks` de suas opções, conforme mostrado em [Configurar hooks](#configure-hooks).336Vários exemplos nesta seção mostram apenas a função de callback. Para executar um, registre o callback sob o evento correspondente no campo `hooks` de suas opções, conforme mostrado em [Configurar hooks](#configure-hooks).

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

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

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

782* Outros eventos, como `Notification`, `PreCompact` e `PostModelSwitch`: Claude Code registra a falha e continua.830* Outros eventos, como `Notification`, `PreCompact` e `PostModelSwitch`: Claude Code registra a falha e continua. Com [`onFailure: "block"`](#block-the-action-when-a-callback-fails), um timeout em `PreCompact`, `Elicitation` ou `WorktreeCreate` bloqueia a ação.

783 831 

784A primeira vez que um callback `Stop` ou `SessionStart` expira na sessão principal, Claude Code também adiciona uma [`SDKInformationalMessage`](https://code.claude.com/docs/pt/agent-sdk/typescript#sdkinformationalmessage) ao fluxo de mensagens dizendo que o aplicativo que dirige a sessão não respondeu. Timeouts posteriores não repetem essa mensagem enquanto seu aplicativo permanecer sem resposta.832A primeira vez que um callback `Stop` ou `SessionStart` expira na sessão principal, Claude Code também adiciona uma [`SDKInformationalMessage`](https://code.claude.com/docs/pt/agent-sdk/typescript#sdkinformationalmessage) ao fluxo de mensagens dizendo que o aplicativo que dirige a sessão não respondeu. Timeouts posteriores não repetem essa mensagem enquanto seu aplicativo permanecer sem resposta.

785 833 

2161 None # Timeout in seconds. When omitted, the per-event default applies:2161 None # Timeout in seconds. When omitted, the per-event default applies:

2162 # 600 for most events, 30 for UserPromptSubmit2162 # 600 for most events, 30 for UserPromptSubmit

2163 )2163 )

2164 on_failure: Literal["continue", "block"] | None = (

2165 None # "block" blocks the action when a callback fails

2166 )

2164```2167```

2165 2168 

2169Para decidir o que `on_failure` abrange, veja [Bloquear a ação quando um callback falha](https://code.claude.com/docs/pt/agent-sdk/hooks.md#block-the-action-when-a-callback-fails).

2170 

2166### `HookInput`2171### `HookInput`

2167 2172 

2168Tipo de união de todos os tipos de entrada de hook. O tipo real depende do campo `hook_event_name`.2173Tipo de união de todos os tipos de entrada de hook. O tipo real depende do campo `hook_event_name`.

2183 level: "info" | "notice" | "suggestion" | "warning";2183 level: "info" | "notice" | "suggestion" | "warning";

2184 tool_use_id?: string;2184 tool_use_id?: string;

2185 prevent_continuation?: boolean;2185 prevent_continuation?: boolean;

2186 tag?: string;

2186 uuid: UUID;2187 uuid: UUID;

2187 session_id: string;2188 session_id: string;

2188};2189};

2558 matcher?: string;2559 matcher?: string;

2559 hooks: HookCallback[];2560 hooks: HookCallback[];

2560 timeout?: number; // Timeout em segundos para todos os hooks neste matcher2561 timeout?: number; // Timeout em segundos para todos os hooks neste matcher

2562 onFailure?: "continue" | "block"; // "block" bloqueia a ação quando um callback falha

2561}2563}

2562```2564```

2563 2565 

2566Para decidir o que `onFailure` abrange, veja [Bloquear a ação quando um callback falha](https://code.claude.com/docs/pt/agent-sdk/hooks.md#block-the-action-when-a-callback-fails).

2567 

2564### `HookInput`2568### `HookInput`

2565 2569 

2566Tipo de união de todos os tipos de entrada de hook.2570Tipo de união de todos os tipos de entrada de hook.

158* **Alias de família como `opus`**: Na API Anthropic e Claude Platform na AWS, Claude Code executa o companheiro de equipe na versão mais recente dessa família que a lista de permissões permite. Em provedores com IDs de modelo específicos do provedor, onde a [substituição não opera](https://code.claude.com/docs/pt/model-config.md#restrict-model-selection), um alias bloqueado volta como qualquer outro valor bloqueado de acordo com o próximo ponto158* **Alias de família como `opus`**: Na API Anthropic e Claude Platform na AWS, Claude Code executa o companheiro de equipe na versão mais recente dessa família que a lista de permissões permite. Em provedores com IDs de modelo específicos do provedor, onde a [substituição não opera](https://code.claude.com/docs/pt/model-config.md#restrict-model-selection), um alias bloqueado volta como qualquer outro valor bloqueado de acordo com o próximo ponto

159* **Qualquer outro valor bloqueado, incluindo um alias de família em provedores onde a substituição não opera, ou um cuja família não tem versão permitida**: Claude Code executa o companheiro de equipe no modelo do líder em vez disso. Se você definir `CLAUDE_CODE_SUBAGENT_MODEL`, Claude Code tenta esse modelo primeiro, sob essas mesmas regras159* **Qualquer outro valor bloqueado, incluindo um alias de família em provedores onde a substituição não opera, ou um cuja família não tem versão permitida**: Claude Code executa o companheiro de equipe no modelo do líder em vez disso. Se você definir `CLAUDE_CODE_SUBAGENT_MODEL`, Claude Code tenta esse modelo primeiro, sob essas mesmas regras

160 160 

161Por padrão, os companheiros de equipe herdam o [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) do líder. No modo split-pane isso se aplica a partir da v2.1.186; versões anteriores não passavam o esforço da sessão do líder para companheiros de equipe em split-pane.161Por padrão, um companheiro de equipe no modelo do líder herda o [nível de esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) do líder. No modo split-pane isso se aplica a partir da v2.1.186; versões anteriores não passavam o esforço da sessão do líder para companheiros de equipe em split-pane. Para um companheiro de equipe em outro modelo, veja [Nível de esforço de subagentes e companheiros de equipe](https://code.claude.com/docs/pt/model-config.md#effort-level-of-subagents-and-teammates).

162 162 

163### Tenha companheiros de equipe planejando antes de implementar163### Tenha companheiros de equipe planejando antes de implementar

164 164 

165Para tarefas complexas ou arriscadas, você pode ter companheiros de equipe planejando antes de implementar. Um companheiro de equipe que Claude gera enquanto o líder está em [modo de plano](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode) funciona em modo de plano somente leitura até que seu plano esteja pronto. Mude o líder para modo de plano primeiro, depois peça pelo companheiro de equipe:165Para tarefas complexas ou arriscadas, você pode ter companheiros de equipe planejando antes de implementar. Um companheiro de equipe que Claude gera enquanto o líder está em [modo de planejamento](https://code.claude.com/docs/pt/permission-modes.md#analyze-before-you-edit-with-plan-mode) também funciona em modo de planejamento até que seu plano esteja pronto. Mude o líder para modo de planejamento primeiro, depois peça pelo companheiro de equipe:

166 166 

167```text wrap theme={null}167```text wrap theme={null}

168Spawn an architect teammate to refactor the authentication module.168Spawn an architect teammate to refactor the authentication module.

169```169```

170 170 

171Quando esse companheiro de equipe termina o planejamento, ele envia uma solicitação de aprovação de plano ao líder. Se você não alterou o modo de permissão desse companheiro de equipe desde que ele foi gerado, Claude Code aprova o plano assim que a solicitação chega, sem o líder revisá-lo. Os edits e comandos do companheiro de equipe ainda passam pelos prompts de permissão descritos em [Permissions](#permissions). Uma vez aprovado, o companheiro de equipe sai do modo de planejamento e começa a implementação.171Quando esse companheiro de equipe termina o planejamento, ele envia uma solicitação de aprovação de plano ao líder. Se você não alterou o modo de permissão desse companheiro de equipe desde que ele foi gerado, Claude Code aprova o plano assim que a solicitação chega, sem o líder revisá-lo. Uma vez aprovado, o companheiro de equipe sai do modo de planejamento e começa a implementação. Claude Code passa a ele o [modo de permissão](#permissions) atual do líder, ou Manual se esse for o modo de planejamento.

172 172 

173Se você colocar um companheiro de equipe in-process em execução no modo de planejamento pressionando [`Shift+Tab`](https://code.claude.com/docs/pt/permission-modes#switch-permission-modes) enquanto visualiza sua sessão, o líder revisa o plano dessa execução em vez de Claude Code aprová-lo. Não é solicitado que você o aprove; o líder o aprova ou o devolve para revisão.173Se você colocar um companheiro de equipe in-process em execução no modo de planejamento pressionando [`Shift+Tab`](https://code.claude.com/docs/pt/permission-modes#switch-permission-modes) enquanto visualiza sua sessão, o líder revisa o plano dessa execução em vez de Claude Code aprová-lo. Não é solicitado que você o aprove; o líder o aprova ou o devolve para revisão.

174 174 

288 288 

289### Permissões289### Permissões

290 290 

291Os companheiros de equipe começam com o modo de permissão do líder, exceto o modo [`dontAsk`](https://code.claude.com/docs/pt/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), que eles não herdam. Se o líder for executado com `--dangerously-skip-permissions`, todos os companheiros de equipe também. Após gerar, você pode alterar o modo de permissão de um companheiro de equipe individual, mas não pode definir modos de permissão por companheiro de equipe no tempo de geração.291Para alternar o modo de permissão de um companheiro de equipe em execução, pressione [`Shift+Tab`](https://code.claude.com/docs/pt/permission-modes#switch-permission-modes), embora um companheiro de equipe em processo possa ser executado no modo do líder em vez disso. Para um companheiro de equipe em painel dividido, pressione-o no painel dele. Para um companheiro de equipe [em processo](#choose-a-display-mode), pressione-o enquanto [visualiza a sessão dele](#talk-to-teammates-directly), e o companheiro de equipe verifica seu modo quando inicia seu próximo turno.

292 

293> [!NOTE]

294>

295> Um companheiro de equipe em processo que não está no [modo de planejamento](#have-teammates-plan-before-implementing) é executado no modo do líder enquanto o líder está no modo [`acceptEdits`](https://code.claude.com/docs/pt/permission-modes#auto-approve-file-edits-with-acceptedits-mode), [`auto`](https://code.claude.com/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) ou [`bypassPermissions`](https://code.claude.com/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode). Mudar o companheiro de equipe para Manual não altera isso, mesmo que sua barra de status mostre Manual.

296>

297> Para que ele pergunte antes de editar, pressione Enter na linha `main` do painel de agentes e mude o líder para o modo Manual também. O líder então também pergunta, assim como qualquer outro companheiro de equipe no modo Manual.

298 

299Você não pode definir modos de permissão por companheiro de equipe no momento da geração. Um novo companheiro de equipe começa com o modo do líder, incluindo o modo `bypassPermissions`, que `--dangerously-skip-permissions` ativa. Se o líder estiver no [modo `dontAsk`](https://code.claude.com/docs/pt/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), o companheiro de equipe começa no [modo Manual](https://code.claude.com/docs/pt/permission-modes.md#available-modes) em vez disso.

292 300 

293Um companheiro de equipe [em processo](#choose-a-display-mode) é executado sob as regras de allow e deny ativas do líder, portanto [`--disallowedTools`](https://code.claude.com/docs/pt/cli-reference#cli-flags), `--tools` e `--allowedTools` se aplicam a ele. Para um companheiro de equipe em painel dividido, verifique cada flag:301Um companheiro de equipe [em processo](#choose-a-display-mode) é executado sob as regras de allow e deny ativas do líder, portanto [`--disallowedTools`](https://code.claude.com/docs/pt/cli-reference#cli-flags), `--tools` e `--allowedTools` se aplicam a ele. Para um companheiro de equipe em painel dividido, verifique cada flag:

294 302 

486* **Sem equipes aninhadas**: os companheiros de equipe não podem gerar seus próprios companheiros de equipe. Apenas o líder pode gerenciar a equipe.494* **Sem equipes aninhadas**: os companheiros de equipe não podem gerar seus próprios companheiros de equipe. Apenas o líder pode gerenciar a equipe.

487* **Sem subagentes em segundo plano de companheiros de equipe in-process**: os próprios subagentes de um companheiro de equipe in-process são executados em primeiro plano, porque o trabalho em segundo plano de um companheiro de equipe não pode sobreviver ao processo do líder. Claude Code retorna um erro quando um companheiro de equipe gera um subagente cuja definição define `background: true`. Uma requisição `run_in_background: true` de um companheiro de equipe também falha, seja com um erro ou executando silenciosamente em primeiro plano. Subagentes lançados da conversa principal seguem o [padrão de segundo plano](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background).495* **Sem subagentes em segundo plano de companheiros de equipe in-process**: os próprios subagentes de um companheiro de equipe in-process são executados em primeiro plano, porque o trabalho em segundo plano de um companheiro de equipe não pode sobreviver ao processo do líder. Claude Code retorna um erro quando um companheiro de equipe gera um subagente cuja definição define `background: true`. Uma requisição `run_in_background: true` de um companheiro de equipe também falha, seja com um erro ou executando silenciosamente em primeiro plano. Subagentes lançados da conversa principal seguem o [padrão de segundo plano](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background).

488* **Líder é fixo**: a sessão principal é o líder por sua vida útil. Você não pode promover um companheiro de equipe a líder ou transferir liderança.496* **Líder é fixo**: a sessão principal é o líder por sua vida útil. Você não pode promover um companheiro de equipe a líder ou transferir liderança.

489* **Permissões definidas no tempo de geração**: os companheiros de equipe começam com o modo de permissão descrito em [Permissões](#permissions). Você pode alterar o modo de permissão de um companheiro de equipe individual após gerar, mas não pode definir modos de permissão por companheiro de equipe no tempo de geração.497* **Sem modos de permissão por companheiro de equipe no tempo de geração**: os companheiros de equipe começam com o modo de permissão descrito em [Permissões](#permissions).

490* **Split panes requerem tmux ou iTerm2**: o modo in-process padrão funciona em qualquer terminal. O modo split-pane não é suportado no terminal integrado do VS Code, Windows Terminal ou Ghostty.498* **Split panes requerem tmux ou iTerm2**: o modo in-process padrão funciona em qualquer terminal. O modo split-pane não é suportado no terminal integrado do VS Code, Windows Terminal ou Ghostty.

491 499 

492## Próximos passos500## Próximos passos

442 442 

443Execute `/background` ou seu alias `/bg` para mover a conversa atual para uma sessão em segundo plano. Passe um prompt como `/bg run the test suite and fix any failures` para dar uma instrução adicional primeiro. Se Claude estiver respondendo quando você executar `/bg`, a resposta continua na sessão em segundo plano.443Execute `/background` ou seu alias `/bg` para mover a conversa atual para uma sessão em segundo plano. Passe um prompt como `/bg run the test suite and fix any failures` para dar uma instrução adicional primeiro. Se Claude estiver respondendo quando você executar `/bg`, a resposta continua na sessão em segundo plano.

444 444 

445Sair de uma sessão que ainda tem trabalho em segundo plano em execução, como subagentes, comandos de shell em segundo plano, fluxos de trabalho ou [monitores](https://code.claude.com/docs/pt/tools-reference.md#monitor-tool), mostra um diálogo `Background work is running` em vez de sair imediatamente. Escolha `Move to background and exit` para colocar a sessão em segundo plano da mesma forma que `/background` faz e retornar ao seu shell. A opção não é mostrada quando a visualização de agentes está [desativada](#turn-off-agent-view).445Se você sair de uma sessão enquanto alguns tipos de trabalho em segundo plano estão em execução, como subagentes ou fluxos de trabalho, um diálogo `Background work is running` avisa que o trabalho será interrompido. Escolha `Move to background and exit` para colocar a sessão em segundo plano da mesma forma que `/background` faz e retornar ao seu shell. A opção não é mostrada quando a visualização de agentes está [desativada](#turn-off-agent-view).

446 446 

447Se uma sessão em segundo plano na lista já tiver o nome da conversa, Claude Code numera o nome da nova linha, como `my-session (2)`, e deixa o nome da linha existente intacto. Para renomear a nova linha, selecione-a na visualização de agentes e pressione `Ctrl+R`.447Se uma sessão em segundo plano na lista já tiver o nome da conversa, Claude Code numera o nome da nova linha, como `my-session (2)`, e deixa o nome da linha existente intacto. Para renomear a nova linha, selecione-a na visualização de agentes e pressione `Ctrl+R`.

448 448 

315* Uma fixação no bloco `env` das [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md)315* Uma fixação no bloco `env` das [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md)

316* Uma fixação que aponta para um [ARN de perfil de inferência de aplicação](#map-each-model-version-to-an-inference-profile), pois é gerenciada pelo seu administrador316* Uma fixação que aponta para um [ARN de perfil de inferência de aplicação](#map-each-model-version-to-an-inference-profile), pois é gerenciada pelo seu administrador

317 317 

318Se o prompt de atualização ainda aparecer para uma fixação nas configurações gerenciadas, atualize Claude Code para v2.1.314 ou posterior. Antes da v2.1.314, a fixação gerenciada continuava em vigor depois que você aceitava, então o prompt voltava na próxima inicialização.

319 

318Se você não fixou um modelo e o padrão atual não está disponível em sua conta, Claude Code faz fallback para a sessão atual e mostra um aviso. Ele tenta versões anteriores do modelo padrão primeiro e, quando o padrão é um modelo Opus e nenhuma versão Opus está disponível, faz fallback para o modelo Sonnet padrão. O fallback não é persistido. Ative o modelo mais recente em sua conta Amazon Bedrock ou [fixe uma versão](#4-pin-model-versions) para tornar a escolha permanente.320Se você não fixou um modelo e o padrão atual não está disponível em sua conta, Claude Code faz fallback para a sessão atual e mostra um aviso. Ele tenta versões anteriores do modelo padrão primeiro e, quando o padrão é um modelo Opus e nenhuma versão Opus está disponível, faz fallback para o modelo Sonnet padrão. O fallback não é persistido. Ative o modelo mais recente em sua conta Amazon Bedrock ou [fixe uma versão](#4-pin-model-versions) para tornar a escolha permanente.

319 321 

322### Iniciar uma sessão em um modelo específico

323 

320Quando você inicia a sessão em uma versão específica de Sonnet ou Opus, por exemplo com `--model`, `ANTHROPIC_MODEL`, ou a [configuração `model`](https://code.claude.com/docs/pt/settings-reference#model), essa versão atua como o padrão fixado da sessão para o alias `sonnet` ou `opus` correspondente. Claude Code ignora a verificação de disponibilidade do padrão integrado que seu modelo substitui e inicia no modelo que você configurou, sem aviso de fallback.324Quando você inicia a sessão em uma versão específica de Sonnet ou Opus, por exemplo com `--model`, `ANTHROPIC_MODEL`, ou a [configuração `model`](https://code.claude.com/docs/pt/settings-reference#model), essa versão atua como o padrão fixado da sessão para o alias `sonnet` ou `opus` correspondente. Claude Code ignora a verificação de disponibilidade do padrão integrado que seu modelo substitui e inicia no modelo que você configurou, sem aviso de fallback.

321 325 

322Estes não atuam como fixações quando você inicia uma sessão neles:326Estes não atuam como fixações quando você inicia uma sessão neles:

324* Um alias de modelo como `opus`328* Um alias de modelo como `opus`

325* Um ID de modelo que Claude Code não reconhece, como um ARN de perfil de inferência de aplicação329* Um ID de modelo que Claude Code não reconhece, como um ARN de perfil de inferência de aplicação

326 330 

327Quando essas verificações encontram um modelo que sua conta não pode invocar, Claude Code lembra a recusa nesta máquina por até um dia, e durante esse tempo inicia ignorando o modelo lembrado sem perguntar ao Amazon Bedrock novamente. Claude Code verifica uma recusa lembrada de um modelo padrão atual novamente na inicialização uma vez que dez minutos tenham passado desde a última verificação, portanto um padrão que seu administrador reativa volta. Para desativar a memória, defina [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/pt/env-vars).331### Recusas de modelo lembradas

332 

333Quando as verificações de modelo na inicialização encontram um modelo que sua conta não pode invocar, Claude Code pode lembrar a recusa nesta máquina por até um dia. Uma vez que dez minutos tenham passado desde a última verificação, Claude Code verifica novamente na inicialização uma recusa lembrada de um modelo padrão atual. Um padrão que seu administrador reativa então volta. Para desativar a memória, defina [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/pt/env-vars).

328 334 

329### Quando sua organização impõe uma allowlist de modelos335### Quando sua organização impõe uma allowlist de modelos

330 336 

457 463 

458## AWS Guardrails464## AWS Guardrails

459 465 

460[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) permitem que você implemente filtragem de conteúdo para Claude Code. Crie um Guardrail no [console do Amazon Bedrock](https://console.aws.amazon.com/bedrock/), publique uma versão, então adicione os cabeçalhos do Guardrail ao seu [arquivo de configurações](https://code.claude.com/docs/pt/settings.md). Habilite inferência entre regiões em seu Guardrail se você estiver usando perfis de inferência entre regiões.466[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) permitem que você implemente filtragem de conteúdo para Claude Code. Crie um Guardrail no [console do Amazon Bedrock](https://console.aws.amazon.com/bedrock/) e publique uma versão. Habilite inferência entre regiões em seu Guardrail se você estiver usando perfis de inferência entre regiões.

461 467 

462Exemplo de configuração:468Para aplicar o Guardrail por meio de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway), siga [Aplicar um guardrail do Amazon Bedrock](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#apply-an-amazon-bedrock-guardrail). Sem um gateway de aplicativos Claude, adicione os cabeçalhos do Guardrail ao seu [arquivo de configurações](https://code.claude.com/docs/pt/settings.md).

469 

470Exemplo de configuração do arquivo de configurações:

463 471 

464```json theme={null}472```json theme={null}

465{473{

469}477}

470```478```

471 479 

472Se sua organização entrega os cabeçalhos do guardrail através de uma política de [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway), eles contam como [configurações que precisam de aprovação](https://code.claude.com/docs/pt/server-managed-settings.md#environment-variables-and-the-approval-dialog).

473 

474Quando o guardrail bloqueia uma resposta no meio do caminho, o texto transmitido até então permanece e a resposta termina com a mensagem configurada no guardrail para respostas bloqueadas.480Quando o guardrail bloqueia uma resposta no meio do caminho, o texto transmitido até então permanece e a resposta termina com a mensagem configurada no guardrail para respostas bloqueadas.

475 481 

476## Usar o endpoint Mantle482## Usar o endpoint Mantle

2512. Variável de ambiente `ANTHROPIC_AUTH_TOKEN`. Enviada como o cabeçalho `Authorization: Bearer`. Use isso ao rotear através de um [gateway LLM ou proxy](https://code.claude.com/docs/pt/llm-gateway) que autentica com tokens bearer em vez de chaves de API Anthropic.2512. Variável de ambiente `ANTHROPIC_AUTH_TOKEN`. Enviada como o cabeçalho `Authorization: Bearer`. Use isso ao rotear através de um [gateway LLM ou proxy](https://code.claude.com/docs/pt/llm-gateway) que autentica com tokens bearer em vez de chaves de API Anthropic.

2523. Variável de ambiente `ANTHROPIC_API_KEY`. Enviada como o cabeçalho `X-Api-Key`. Use isso para acesso direto à API Anthropic com uma chave do [Claude Console](https://platform.claude.com). No modo interativo, você é solicitado uma vez a aprovar ou recusar a chave, e sua escolha é lembrada. Para alterá-la depois, use o toggle "Use custom API key" em `/config`. O toggle aparece apenas enquanto `ANTHROPIC_API_KEY` está definido em seu ambiente. No modo não interativo (`-p`), a chave é sempre usada quando presente.2523. Variável de ambiente `ANTHROPIC_API_KEY`. Enviada como o cabeçalho `X-Api-Key`. Use isso para acesso direto à API Anthropic com uma chave do [Claude Console](https://platform.claude.com). No modo interativo, você é solicitado uma vez a aprovar ou recusar a chave, e sua escolha é lembrada. Para alterá-la depois, use o toggle "Use custom API key" em `/config`. O toggle aparece apenas enquanto `ANTHROPIC_API_KEY` está definido em seu ambiente. No modo não interativo (`-p`), a chave é sempre usada quando presente.

2534. Saída do script [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper). Use isso para credenciais dinâmicas ou rotativas, como tokens de curta duração obtidos de um cofre.2534. Saída do script [`apiKeyHelper`](https://code.claude.com/docs/pt/settings-reference#apikeyhelper). Use isso para credenciais dinâmicas ou rotativas, como tokens de curta duração obtidos de um cofre.

2545. Variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`. Um token OAuth de longa duração gerado por [`claude setup-token`](#generate-a-long-lived-token). Use isso para pipelines de CI e scripts onde login do navegador não está disponível. Se você executar `/login` enquanto a variável está definida, Claude Code muda a sessão atual para o novo login, mas lê a variável novamente em cada nova sessão até que você a remova do seu perfil de shell ou do bloco `env` de um [arquivo de configurações](https://code.claude.com/docs/pt/settings.md).2545. Variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`. Um token OAuth de longa duração gerado por [`claude setup-token`](#generate-a-long-lived-token). Use isso para pipelines de CI e scripts onde login do navegador não está disponível. Se você executar `/login` enquanto a variável está definida, Claude Code muda a sessão atual para o novo login. Para manter esse login em novas sessões, remova a variável do seu perfil de shell e dos [arquivos de configurações que podem defini-la](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env), como suas configurações de usuário.

2556. Credenciais de perfil Anthropic e de federação, as credenciais que a CLI `ant` e Workload Identity Federation usam. Um perfil que `ant auth login` escreveu é classificado aqui apenas quando você o nomeia em `ANTHROPIC_PROFILE`; caso contrário, é classificado abaixo de `/login`. Consulte [Perfis Anthropic e credenciais de federação](#anthropic-profiles-and-federation-credentials).2556. Credenciais de perfil Anthropic e de federação, as credenciais que a CLI `ant` e Workload Identity Federation usam. Um perfil que `ant auth login` escreveu é classificado aqui apenas quando você o nomeia em `ANTHROPIC_PROFILE`; caso contrário, é classificado abaixo de `/login`. Consulte [Perfis Anthropic e credenciais de federação](#anthropic-profiles-and-federation-credentials).

2567. Credenciais OAuth de assinatura de `/login`. Este é o padrão para usuários Claude Pro, Max, Ultra, Team e Enterprise.2567. Credenciais OAuth de assinatura de `/login`. Este é o padrão para usuários Claude Pro, Max, Ultra, Team e Enterprise.

257 257 

603>603>

604> Uma execução `claude -p --worktree` é uma que você mesmo limpa, já que ela sai sem perguntar. Remova esses worktrees com `git worktree remove <path>` e, se o git recusar porque o worktree está bloqueado, execute `git worktree unlock <path>` primeiro.604> Uma execução `claude -p --worktree` é uma que você mesmo limpa, já que ela sai sem perguntar. Remova esses worktrees com `git worktree remove <path>` e, se o git recusar porque o worktree está bloqueado, execute `git worktree unlock <path>` primeiro.

605 605 

606Para uma grande alteração mecânica em muitos arquivos, [`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/pt/commands) divide o trabalho em 5 a 30 unidades e mostra o plano. Depois, executa cada unidade no próprio worktree e abre um PR para ela. A partir do seu shell, [`claude agents`](https://code.claude.com/docs/pt/agent-view) (ainda em prévia de pesquisa) oferece uma única tela para tudo o que está sendo executado em segundo plano na sua máquina.606Para uma grande alteração mecânica em muitos arquivos, [`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/pt/commands) divide o trabalho em 5 a 30 unidades e mostra o plano. Depois que você o aprova, cada unidade ganha o próprio worktree e abre um PR ou relata o que aconteceu. A partir do seu shell, [`claude agents`](https://code.claude.com/docs/pt/agent-view) (ainda em prévia de pesquisa) oferece uma única tela para tudo o que está sendo executado em segundo plano na sua máquina.

607 607 

608Uma segunda sessão também é o revisor independente mais fácil que você pode conseguir. Uma sessão escreve o rate limiter, outra revisa `@src/middleware/rateLimiter.ts` sem ter acompanhado a escrita, e você cola os apontamentos de volta na primeira. Mesma ideia do `/code-review`, com você levando as mensagens.608Uma segunda sessão também é o revisor independente mais fácil que você pode conseguir. Uma sessão escreve o rate limiter, outra revisa `@src/middleware/rateLimiter.ts` sem ter acompanhado a escrita, e você cola os apontamentos de volta na primeira. Mesma ideia do `/code-review`, com você levando as mensagens.

609 609 

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

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

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

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

89| `--enable-auto-mode` | Removido em v2.1.111. Auto mode agora está no ciclo `Shift+Tab` por padrão; use `--permission-mode auto` para iniciar nele | `claude --permission-mode auto` |89| `--enable-auto-mode` | Removido em v2.1.111. Auto mode agora está no ciclo `Shift+Tab` por padrão; use `--permission-mode auto` para iniciar nele | `claude --permission-mode auto` |

90| `--environment <environment-id>` | Criar uma nova sessão em nuvem que é executada no [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments) com o ID fornecido. IDs de ambiente começam com `ccpool_`. Veja [comportamento de dispatch de `--environment`](https://code.claude.com/docs/pt/self-hosted-environments-testing#environment-dispatch-behavior) para comportamento de dispatch e as combinações de sinalizadores que ele rejeita. Requer Claude Code v2.1.224 ou posterior | `claude -p "Fix the login bug" --environment ccpool_abc123` |90| `--environment <environment-id>` | Criar uma nova sessão em nuvem que é executada no [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments) com o ID fornecido. IDs de ambiente começam com `ccpool_`. Veja [comportamento de dispatch de `--environment`](https://code.claude.com/docs/pt/self-hosted-environments-testing#environment-dispatch-behavior) para comportamento de dispatch e as combinações de sinalizadores que ele rejeita. Requer Claude Code v2.1.224 ou posterior | `claude -p "Fix the login bug" --environment ccpool_abc123` |

91| `--exclude-dynamic-system-prompt-sections` | Mover contexto por usuário, como a localização de memória automática, para fora do prompt do sistema e para a primeira mensagem do usuário. Melhora a reutilização de prompt-cache em diferentes usuários e máquinas executando a mesma tarefa. Aplica-se apenas com o prompt do sistema padrão; ignorado quando `--system-prompt` ou `--system-prompt-file` está definido. Use com `-p` para cargas de trabalho com script e multi-usuário | `claude -p --exclude-dynamic-system-prompt-sections "query"` |91| `--exclude-dynamic-system-prompt-sections` | Mover contexto por usuário, como a localização de memória automática, para fora do prompt do sistema e para a primeira mensagem do usuário. Melhora a reutilização de prompt-cache em diferentes usuários e máquinas executando a mesma tarefa. Aplica-se apenas com o prompt do sistema padrão; ignorado quando `--system-prompt` ou `--system-prompt-file` está definido. Use com `-p` para cargas de trabalho com script e multi-usuário | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

33 33 

34**2. Continue trabalhando**34**2. Continue trabalhando**

35 35 

36A revisão é executada como um [subagente](https://code.claude.com/docs/pt/sub-agents.md) em segundo plano com sua própria janela de contexto, portanto não enche sua conversa. As descobertas chegam à sua conversa quando a revisão é concluída.36Em uma sessão de terminal, a revisão é executada como um [subagente](https://code.claude.com/docs/pt/sub-agents.md) em segundo plano com sua própria janela de contexto, portanto não enche sua conversa. As descobertas chegam à sua conversa quando a revisão é concluída.

37 37 

38**3. Aja com base nas descobertas**38**3. Aja com base nas descobertas**

39 39 

59| `/autocompact [auto\|<tokens>]` | Defina a janela de compactação automática: o quão cheia fica a janela de contexto antes de Claude Code compactar automaticamente. Passe um tamanho como `500k`, ou `auto` para retornar à janela ajustada para seu modelo. Claude Code salva o valor nas configurações de usuário e o aplica à sessão atual. Consulte [Defina a janela de compactação automática](https://code.claude.com/docs/pt/model-config.md#set-the-auto-compact-window) para valores aceitos e o que a sobrescreve. Sem um argumento, abre um diálogo que mostra a janela atual. Requer Claude Code v2.1.221 ou posterior |59| `/autocompact [auto\|<tokens>]` | Defina a janela de compactação automática: o quão cheia fica a janela de contexto antes de Claude Code compactar automaticamente. Passe um tamanho como `500k`, ou `auto` para retornar à janela ajustada para seu modelo. Claude Code salva o valor nas configurações de usuário e o aplica à sessão atual. Consulte [Defina a janela de compactação automática](https://code.claude.com/docs/pt/model-config.md#set-the-auto-compact-window) para valores aceitos e o que a sobrescreve. Sem um argumento, abre um diálogo que mostra a janela atual. Requer Claude Code v2.1.221 ou posterior |

60| `/autofix-pr [prompt]` | Inicie uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md#auto-fix-pull-requests) que monitora o PR do branch atual e envia correções quando o CI falha ou revisores deixam comentários. Detecta o PR aberto do seu branch em checkout com `gh pr view`; para monitorar um PR diferente, primeiro faça checkout do branch dele. Por padrão, a sessão na nuvem é instruída a corrigir todas as falhas de CI e comentários de revisão; passe um prompt para dar instruções diferentes, por exemplo `/autofix-pr only fix lint and type errors`. Requer a CLI `gh` e acesso a [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) |60| `/autofix-pr [prompt]` | Inicie uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md#auto-fix-pull-requests) que monitora o PR do branch atual e envia correções quando o CI falha ou revisores deixam comentários. Detecta o PR aberto do seu branch em checkout com `gh pr view`; para monitorar um PR diferente, primeiro faça checkout do branch dele. Por padrão, a sessão na nuvem é instruída a corrigir todas as falhas de CI e comentários de revisão; passe um prompt para dar instruções diferentes, por exemplo `/autofix-pr only fix lint and type errors`. Requer a CLI `gh` e acesso a [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) |

61| `/background [prompt]` | Desanexe a sessão atual para ser executada como um [agente em segundo plano](https://code.claude.com/docs/pt/agent-view.md) e libere este terminal. Passe um prompt para enviar uma instrução adicional antes de desanexar. Monitore a sessão com `claude agents`. Para copiar a conversa em uma nova sessão em segundo plano enquanto esta continua em execução, use `/fork`. Alias: `/bg` |61| `/background [prompt]` | Desanexe a sessão atual para ser executada como um [agente em segundo plano](https://code.claude.com/docs/pt/agent-view.md) e libere este terminal. Passe um prompt para enviar uma instrução adicional antes de desanexar. Monitore a sessão com `claude agents`. Para copiar a conversa em uma nova sessão em segundo plano enquanto esta continua em execução, use `/fork`. Alias: `/bg` |

62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Orquestre mudanças em larga escala em uma base de código em paralelo. Pesquisa a base de código, decompõe o trabalho em 5 a 30 unidades independentes e apresenta um plano. Uma vez aprovado, inicia um [subagente em segundo plano](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) por unidade em um [worktree](https://code.claude.com/docs/pt/worktrees.md) isolado. Cada subagente implementa sua unidade, executa testes e publica sua mudança. Requer um repositório git ou um [hook `WorktreeCreate`](https://code.claude.com/docs/pt/worktrees#non-git-version-control) que cria os worktrees. Fora de um repositório git, `/batch` requer Claude Code v2.1.281 ou posterior. Exemplo: `/batch migrate src/ from JavaScript to TypeScript` |62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Orquestre mudanças em larga escala em uma base de código em paralelo. Pesquisa a base de código, decompõe o trabalho em 5 a 30 unidades independentes e apresenta um plano. Uma vez aprovado, inicia um [subagente em segundo plano](https://code.claude.com/docs/pt/sub-agents.md#run-subagents-in-foreground-or-background) por unidade em um [worktree](https://code.claude.com/docs/pt/worktrees.md) isolado. Cada subagente implementa sua unidade, executa testes e abre um PR ou relata o que aconteceu. Requer um repositório git ou um [hook `WorktreeCreate`](https://code.claude.com/docs/pt/worktrees#non-git-version-control) que cria os worktrees. Fora de um repositório git, `/batch` requer Claude Code v2.1.281 ou posterior. Exemplo: `/batch migrate src/ from JavaScript to TypeScript` |

63| `/branch [name]` | Crie um branch da conversa atual neste ponto, para que você possa tentar uma direção diferente sem perder a conversa como está. Muda você para o branch e preserva o original, ao qual você pode retornar com `/resume`. Para executar uma cópia como uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) separada em vez de mudar para ela, use `/fork`; para entregar uma tarefa lateral a um [subagente](https://code.claude.com/docs/pt/sub-agents.md) que relata de volta para esta conversa, use `/subtask` |63| `/branch [name]` | Crie um branch da conversa atual neste ponto, para que você possa tentar uma direção diferente sem perder a conversa como está. Muda você para o branch e preserva o original, ao qual você pode retornar com `/resume`. Para executar uma cópia como uma [sessão em segundo plano](https://code.claude.com/docs/pt/agent-view.md) separada em vez de mudar para ela, use `/fork`; para entregar uma tarefa lateral a um [subagente](https://code.claude.com/docs/pt/sub-agents.md) que relata de volta para esta conversa, use `/subtask` |

64| `/btw [question]` | Faça uma [pergunta lateral](https://code.claude.com/docs/pt/interactive-mode.md#side-questions-with-%2Fbtw) sobre a sessão atual sem adicionar à conversa. Se você executar `/btw` sem uma pergunta, Claude Code mostra sua pergunta lateral mais recente para que você possa procurar respostas anteriores; se você ainda não fez uma, Claude Code imprime uma linha de uso |64| `/btw [question]` | Faça uma [pergunta lateral](https://code.claude.com/docs/pt/interactive-mode.md#side-questions-with-%2Fbtw) sobre a sessão atual sem adicionar à conversa. Se você executar `/btw` sem uma pergunta, Claude Code mostra sua pergunta lateral mais recente para que você possa procurar respostas anteriores; se você ainda não fez uma, Claude Code imprime uma linha de uso |

65| `/bug [report]` | Relate um bug ou compartilhe sua conversa. Você escolhe quanto histórico de sessão incluir e confirma em uma tela de consentimento antes de qualquer coisa ser enviada. Quando você está conectado ao Anthropic em uma conexão de primeira parte, o relatório vai para Anthropic; em um provedor de terceiros, ou sem credenciais Anthropic, Claude Code escreve o relatório em um [arquivo local sob `~/.claude/feedback-bundles/`](https://code.claude.com/docs/pt/data-usage#telemetry-services) que você encaminha você mesmo. Na [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md#use-the-prompt-box), `/bug` abre o diálogo de feedback próprio da extensão; requer Claude Code v2.1.229 ou posterior. Quando você o executa enquanto Claude está respondendo, Claude Code abre o diálogo imediatamente. Antes da v2.1.232, Claude Code enfileirava o comando até que o turno terminasse. Alias: `/share`. Antes da v2.1.212, `/bug` e `/share` eram aliases de `/feedback` |65| `/bug [report]` | Relate um bug ou compartilhe sua conversa. Você escolhe quanto histórico de sessão incluir e confirma em uma tela de consentimento antes de qualquer coisa ser enviada. Quando você está conectado ao Anthropic em uma conexão de primeira parte, o relatório vai para Anthropic; em um provedor de terceiros, ou sem credenciais Anthropic, Claude Code escreve o relatório em um [arquivo local sob `~/.claude/feedback-bundles/`](https://code.claude.com/docs/pt/data-usage#telemetry-services) que você encaminha você mesmo. Na [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md#use-the-prompt-box), `/bug` abre o diálogo de feedback próprio da extensão; requer Claude Code v2.1.229 ou posterior. Quando você o executa enquanto Claude está respondendo, Claude Code abre o diálogo imediatamente. Antes da v2.1.232, Claude Code enfileirava o comando até que o turno terminasse. Alias: `/share`. Antes da v2.1.212, `/bug` e `/share` eram aliases de `/feedback` |

335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Defina como `1` para gravar a saída do terminal por meio de um segundo descritor de arquivo não bloqueante, para que um terminal que para de ler, como um painel do tmux em modo de controle pausado ou uma conexão SSH travada, não possa congelar o Claude Code no meio da sessão. Aplica-se no macOS, Linux e WSL quando o stdout é um terminal. Requer Claude Code v2.1.261 ou posterior |335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Defina como `1` para gravar a saída do terminal por meio de um segundo descritor de arquivo não bloqueante, para que um terminal que para de ler, como um painel do tmux em modo de controle pausado ou uma conexão SSH travada, não possa congelar o Claude Code no meio da sessão. Aplica-se no macOS, Linux e WSL quando o stdout é um terminal. Requer Claude Code v2.1.261 ou posterior |

336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quantas vezes o Claude Code reenvia uma [requisição sem streaming](https://code.claude.com/docs/pt/errors.md#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Com `0`, a requisição falha no primeiro timeout. Consulte [Ajustar o comportamento de novas tentativas](https://code.claude.com/docs/pt/errors.md#tune-retry-behavior) para o timeout. Requer Claude Code v2.1.285 ou posterior |336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quantas vezes o Claude Code reenvia uma [requisição sem streaming](https://code.claude.com/docs/pt/errors.md#streaming-response-ended-before-any-complete-data-was-received) que atinge o timeout. Com `0`, a requisição falha no primeiro timeout. Consulte [Ajustar o comportamento de novas tentativas](https://code.claude.com/docs/pt/errors.md#tune-retry-behavior) para o timeout. Requer Claude Code v2.1.285 ou posterior |

337| `CLAUDE_CODE_NO_FLICKER` | Defina como `1` para ativar a [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), uma prévia de pesquisa que reduz a cintilação e mantém o uso de memória estável em conversas longas. Sobrescreve a configuração [`tui`](https://code.claude.com/docs/pt/settings-reference#tui); você também pode alternar com `/tui fullscreen` |337| `CLAUDE_CODE_NO_FLICKER` | Defina como `1` para ativar a [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), uma prévia de pesquisa que reduz a cintilação e mantém o uso de memória estável em conversas longas. Sobrescreve a configuração [`tui`](https://code.claude.com/docs/pt/settings-reference#tui); você também pode alternar com `/tui fullscreen` |

338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token de atualização OAuth para autenticação no Claude.ai. Quando definido, `claude auth login` troca esse token diretamente em vez de abrir um navegador. Requer `CLAUDE_CODE_OAUTH_SCOPES`. Útil para provisionar autenticação em ambientes automatizados |338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token de atualização OAuth para autenticação no claude.ai. Quando definido, `claude auth login` troca esse token diretamente em vez de abrir um navegador. Requer `CLAUDE_CODE_OAUTH_SCOPES`. Útil para provisionar autenticação em ambientes automatizados. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

339| `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ória quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definida |339| `CLAUDE_CODE_OAUTH_SCOPES` | Escopos OAuth, separados por espaços, com os quais o token de atualização foi emitido, como `"user:profile user:inference user:sessions:claude_code"`. Obrigatória quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definida. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env) |

340| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acesso OAuth para autenticação no claude.ai. Alternativa ao `/login` para SDK e ambientes automatizados. Tem precedência sobre credenciais armazenadas no keychain. Gere um com [`claude setup-token`](https://code.claude.com/docs/pt/authentication#generate-a-long-lived-token). A menos que você execute [`/login`](https://code.claude.com/docs/pt/authentication#authentication-precedence), o Claude Code usa o token que você definiu durante toda a sessão. Para substituir um token expirado, gere um novo e reinicie |340| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acesso OAuth para autenticação no claude.ai. Alternativa a `/login` para o SDK e ambientes automatizados. Ignorada nas [configurações de projeto e locais](https://code.claude.com/docs/pt/settings-reference.md#variables-claude-code-ignores-in-env). Tem precedência sobre credenciais armazenadas no keychain. Gere um com [`claude setup-token`](https://code.claude.com/docs/pt/authentication#generate-a-long-lived-token). A menos que você execute [`/login`](https://code.claude.com/docs/pt/authentication#authentication-precedence), o Claude Code usa o token definido durante toda a sessão. Para substituir um token expirado, gere um novo e reinicie |

341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Removida na v2.1.160 e agora sem efeito. Anteriormente fixava o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) no Claude Opus 4.6 em vez do padrão atual. O Opus 4.6 não oferece mais suporte ao modo rápido |341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Removida na v2.1.160 e agora sem efeito. Anteriormente fixava o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) no Claude Opus 4.6 em vez do padrão atual. O Opus 4.6 não oferece mais suporte ao modo rápido |

342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Comprimento máximo dos atributos do OpenTelemetry que carregam conteúdo (respostas do modelo, conteúdo de ferramentas, system prompts, corpos brutos da API), incluindo o marcador de truncamento, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). Aumente-o apenas se seu backend de telemetria aceitar valores de atributo maiores que 64 KB, ou reduza-o para diminuir o volume de telemetria. Requer Claude Code v2.1.214 ou posterior. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Comprimento máximo dos atributos do OpenTelemetry que carregam conteúdo (respostas do modelo, conteúdo de ferramentas, system prompts, corpos brutos da API), incluindo o marcador de truncamento, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). Aumente-o apenas se seu backend de telemetria aceitar valores de atributo maiores que 64 KB, ou reduza-o para diminuir o volume de telemetria. Requer Claude Code v2.1.214 ou posterior. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |

343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Defina como `1` para gravar erros de diagnóstico do exportador OpenTelemetry no stderr. Por padrão, esses erros só aparecem com `--debug`, então um exportador mal configurado, como um conflito de porta do Prometheus, falha silenciosamente. Requer Claude Code v2.1.179 ou posterior. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Defina como `1` para gravar erros de diagnóstico do exportador OpenTelemetry no stderr. Por padrão, esses erros só aparecem com `--debug`, então um exportador mal configurado, como um conflito de porta do Prometheus, falha silenciosamente. Requer Claude Code v2.1.179 ou posterior. Consulte [Monitoramento](https://code.claude.com/docs/pt/monitoring-usage.md) |

66| `This organization has been disabled` | [Authentication](#this-organization-has-been-disabled) |66| `This organization has been disabled` | [Authentication](#this-organization-has-been-disabled) |

67| `Your organization has disabled API key authentication` | [Authentication](#your-organization-has-disabled-api-key-authentication) |67| `Your organization has disabled API key authentication` | [Authentication](#your-organization-has-disabled-api-key-authentication) |

68| `Your organization has disabled Claude subscription access` | [Authentication](#your-organization-has-disabled-claude-subscription-access) |68| `Your organization has disabled Claude subscription access` | [Authentication](#your-organization-has-disabled-claude-subscription-access) |

69| `Routines are disabled by your organization's policy` | [Authentication](#routines-are-disabled-by-your-organizations-policy) |69| `Scheduled tasks are off for your organization` | [Autenticação](#routines-are-disabled-by-your-organizations-policy) |

70| `Routines are off for your organization` | [Autenticação](#routines-are-disabled-by-your-organizations-policy) |

70| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentication](#remote-control-requires-the-anthropic-api) |71| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentication](#remote-control-requires-the-anthropic-api) |

71| `OAuth token refresh failed — run /login to re-authenticate` | [Authentication](#remote-control-couldnt-refresh-your-login) |72| `OAuth token refresh failed — run /login to re-authenticate` | [Authentication](#remote-control-couldnt-refresh-your-login) |

72| `JWT refresh failed: no OAuth token — run /login` | [Authentication](#remote-control-couldnt-refresh-your-login) |73| `JWT refresh failed: no OAuth token — run /login` | [Authentication](#remote-control-couldnt-refresh-your-login) |

755Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.756Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

756```757```

757 758 

759Algumas negações não contam para as dez, incluindo [uma negação causada pela alteração de um hook ou mod](#hook-changed-input-after-review).

760 

758A mensagem de parada aparece em um lugar diferente em cada tipo de sessão:761A mensagem de parada aparece em um lugar diferente em cada tipo de sessão:

759 762 

760* Em uma sessão interativa, a mensagem aparece como um aviso na transcrição e o turno termina763* Em uma sessão interativa, a mensagem aparece como um aviso na transcrição e o turno termina

774 777 

775Antes da v2.1.302, em uma conexão direta com a API Anthropic, Claude Code não compactava uma conversa que havia ficado longa demais para a verificação do servidor.778Antes da v2.1.302, em uma conexão direta com a API Anthropic, Claude Code não compactava uma conversa que havia ficado longa demais para a verificação do servidor.

776 779 

780#### `a hook changed this call's input after auto mode reviewed it`

781 

782Esta negação significa que um hook ou mod [alterou a entrada da chamada](https://code.claude.com/docs/pt/hooks.md#pretooluse-updatedinput-in-auto-mode) depois que o servidor a revisou, então a revisão não cobre o que seria executado. Não é um julgamento de que a ação é insegura.

783 

784Chamadas posteriores na mesma resposta de Claude podem ser negadas com este motivo:

785 

786```text theme={null}

787another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged

788```

789 

790Claude pode então emitir cada chamada negada novamente para que o servidor a revise. Se um prompt de permissão for aberto, responda a ele. Você não precisa fazer mais nada, a menos que Claude diga na resposta que o modo auto não conseguiu verificar a chamada. Nesse caso, interrompa a alteração ou aprove a chamada você mesmo, e peça a Claude para tentar a chamada novamente:

791 

792* **Interromper a alteração**: desative o [hook](https://code.claude.com/docs/pt/hooks.md#disable-or-remove-hooks) ou o [mod](https://code.claude.com/docs/pt/plugins/mods/overview.md#turn-mods-on-or-off) que alterou a chamada ou uma chamada anterior na mesma resposta de Claude, ou peça ao seu administrador para desativá-lo. Para procurar um hook, execute [`/hooks`](https://code.claude.com/docs/pt/hooks#the-%2Fhooks-menu) no prompt do Claude Code. Em uma sessão de terminal, execute `/plugin` para ver os mods ativos.

793* **Aprovar a chamada você mesmo**: [mude para o modo Manual](https://code.claude.com/docs/pt/permission-modes.md#switch-permission-modes)

794 

777### Was not reviewed and did not run795### Was not reviewed and did not run

778 796 

779Uma negação `was not reviewed and did not run` significa que a conversa é longa demais para que o classificador do [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) verifique a ação, então a ação não foi executada. Claude Code retorna esta mensagem a Claude:797Uma negação `was not reviewed and did not run` significa que a conversa é longa demais para que o classificador do [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) verifique a ação, então a ação não foi executada. Claude Code retorna esta mensagem a Claude:

1188* Autentique-se com uma chave de API do Console em vez da sua assinatura. Consulte [Autenticação do Claude Console](https://code.claude.com/docs/pt/authentication.md#claude-console-authentication) para a configuração.1206* Autentique-se com uma chave de API do Console em vez da sua assinatura. Consulte [Autenticação do Claude Console](https://code.claude.com/docs/pt/authentication.md#claude-console-authentication) para a configuração.

1189* Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com o [suporte da Anthropic](https://support.claude.com)1207* Se você for o administrador e não vir uma opção para habilitar o acesso, entre em contato com o [suporte da Anthropic](https://support.claude.com)

1190 1208 

1191### Routines are disabled by your organization's policy1209### Scheduled tasks are off for your organization

1192 1210 

1193Um Owner da sua organização Team ou Enterprise desativou as [tarefas agendadas na nuvem](https://code.claude.com/docs/pt/routines.md), antes chamadas de rotinas, no nível da organização. O erro aparece quando você tenta criar ou executar uma, por exemplo em [claude.ai/code/routines](https://claude.ai/code/routines). No Claude Code v2.1.227 ou posterior, a mesma configuração também [oculta o `/schedule`](https://code.claude.com/docs/pt/routines#troubleshooting) na CLI.1211As [tarefas agendadas na nuvem](https://code.claude.com/docs/pt/routines.md) estão desativadas para sua organização, então você não pode criá-las nem executá-las. A mensagem do claude.ai as chama de tarefas agendadas ou rotinas, e uma frase sobre seu administrador vem em seguida:

1194 1212 

1195```text theme={null}1213```text theme={null}

1196Routines are disabled by your organization's policy.1214Scheduled tasks are off for your organization. …

1215Routines are off for your organization. …

1197```1216```

1198 1217 

1199Esta é uma configuração no lado do servidor, então não pode ser sobrescrita por configurações locais, variáveis de ambiente ou flags da CLI.1218Você não pode ativá-las com configurações locais, variáveis de ambiente ou flags da CLI.

1200 1219 

1201**O que fazer:**1220**O que fazer:**

1202 1221 

1203* Peça a um Owner da sua organização que ative a opção **Scheduled tasks (Was Routines)** em [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities)1222* Pergunte ao Owner do seu plano Team ou Enterprise se ele pode ativar a opção rotulada **Scheduled tasks (Was Routines)** ou **Routines** em [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities)

1204 1223 

1205### Remote Control requires the Anthropic API1224### Remote Control requires the Anthropic API

1206 1225 

197* **Se você aceitar**: Claude Code escreve o novo ID de modelo no seu [arquivo de configurações do usuário](https://code.claude.com/docs/pt/settings.md) e reinicia197* **Se você aceitar**: Claude Code escreve o novo ID de modelo no seu [arquivo de configurações do usuário](https://code.claude.com/docs/pt/settings.md) e reinicia

198* **Se você recusar**: Claude Code lembra sua escolha até a próxima mudança de versão padrão198* **Se você recusar**: Claude Code lembra sua escolha até a próxima mudança de versão padrão

199 199 

200Para uma fixação no bloco `env` das [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), Claude Code não executa nenhuma verificação e não mostra nenhum prompt.200Para uma fixação no bloco `env` das [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), Claude Code não executa nenhuma verificação e não mostra nenhum prompt. Se o prompt de atualização ainda aparecer para essa fixação, atualize o Claude Code para a v2.1.314 ou posterior. Antes da v2.1.314, a fixação gerenciada permanecia em vigor depois que você aceitava, então o prompt voltava na próxima inicialização.

201 201 

202Se você não fixou um modelo e o padrão atual não está disponível no seu projeto, Claude Code volta para a versão anterior para a sessão atual e mostra um aviso. Ele tenta versões anteriores do modelo padrão primeiro e, quando o padrão é um modelo Opus e nenhuma versão Opus está disponível, volta para o modelo Sonnet padrão. O fallback não é persistido. Ative o modelo mais recente no [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) ou [fixe uma versão](#5-pin-model-versions) para tornar a escolha permanente.202Se você não fixou um modelo e o padrão atual não está disponível no seu projeto, Claude Code volta para a versão anterior para a sessão atual e mostra um aviso. Ele tenta versões anteriores do modelo padrão primeiro e, quando o padrão é um modelo Opus e nenhuma versão Opus está disponível, volta para o modelo Sonnet padrão. O fallback não é persistido. Ative o modelo mais recente no [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) ou [fixe uma versão](#5-pin-model-versions) para tornar a escolha permanente.

203 203 

204### Iniciar uma sessão em um modelo específico

205 

204Quando você inicia a sessão em uma versão específica do Sonnet ou Opus, por exemplo com `--model`, `ANTHROPIC_MODEL`, ou a [configuração `model`](https://code.claude.com/docs/pt/settings-reference#model), essa versão atua como o padrão fixado da sessão para o alias `sonnet` ou `opus` correspondente. Claude Code pula a verificação de disponibilidade para o padrão integrado que seu modelo substitui e inicia no modelo que você configurou, sem aviso de fallback.206Quando você inicia a sessão em uma versão específica do Sonnet ou Opus, por exemplo com `--model`, `ANTHROPIC_MODEL`, ou a [configuração `model`](https://code.claude.com/docs/pt/settings-reference#model), essa versão atua como o padrão fixado da sessão para o alias `sonnet` ou `opus` correspondente. Claude Code pula a verificação de disponibilidade para o padrão integrado que seu modelo substitui e inicia no modelo que você configurou, sem aviso de fallback.

205 207 

206Aliases de modelo como `opus` não atuam como fixações, e nem um ID de modelo que Claude Code não reconhece.208Quando você inicia uma sessão em um alias de modelo como `opus` ou em um ID de modelo que Claude Code não reconhece, esse valor não atua como uma fixação.

209 

210### Recusas de modelo lembradas

207 211 

208Quando essas verificações encontram um modelo que seu projeto não pode invocar, Claude Code lembra a recusa nesta máquina por até um dia, e inicia durante esse tempo pulando o modelo lembrado sem perguntar à Plataforma de Agentes novamente. Claude Code verifica uma recusa lembrada de um modelo padrão atual novamente na inicialização uma vez que dez minutos tenham passado desde a última verificação, então um padrão que seu administrador reativa volta. Para desativar a memória, defina [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/pt/env-vars).212Quando as verificações de modelo na inicialização encontram um modelo que seu projeto não pode invocar, Claude Code pode lembrar a recusa nesta máquina por até um dia. Depois que dez minutos tiverem passado desde a última verificação, Claude Code verifica novamente, na inicialização, uma recusa lembrada de um modelo padrão atual. Um padrão que seu administrador reativa então volta. Para desativar a memória, defina [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/pt/env-vars).

209 213 

210### Quando sua organização aplica uma allowlist de modelos214### Quando sua organização aplica uma allowlist de modelos

211 215 

901 901 

902#### Bloquear a ação quando um hook falha902#### Bloquear a ação quando um hook falha

903 903 

904Na maioria dos eventos, quando um hook falha ou atinge o timeout, Claude Code ainda executa a ação. Um hook de política com um caminho errado ou um script que trava então deixa tudo passar. Para bloquear a ação em vez disso, defina `"onFailure": "block"` em um hook `command` ou `http`. Requer Claude Code v2.1.295 ou posterior.904Na maioria dos eventos, quando um hook falha ou atinge o timeout, Claude Code ainda executa a ação. Um hook de política com um caminho errado ou um script que trava então deixa tudo passar. Para bloquear a ação em vez disso, defina `"onFailure": "block"` em um hook `command` ou `http`. Requer Claude Code v2.1.295 ou posterior. Para hooks de callback do Agent SDK, consulte [Bloquear a ação quando um callback falha](https://code.claude.com/docs/pt/agent-sdk/hooks.md#block-the-action-when-a-callback-fails).

905 905 

906> [!NOTE]906> [!NOTE]

907>907>

1960| :- | :- |1960| :- | :- |

1961| `permissionDecision` | `"allow"` pula o prompt de permissão, exceto para [ações que nenhum modo aprova automaticamente](https://code.claude.com/docs/pt/permission-modes.md#actions-no-mode-auto-approves) e [leituras de caminhos de rede](https://code.claude.com/docs/pt/permissions.md#network-paths). Ele também não pula a aprovação de chamadas a [ferramentas que um aplicativo do Agent SDK marca como `always_ask`](https://code.claude.com/docs/pt/agent-sdk/custom-tools#require-approval-for-specific-tools), a menos que o [modo de permissão aprove a chamada](https://code.claude.com/docs/pt/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call). `AskUserQuestion` e `ExitPlanMode` precisam de [`updatedInput` combinado com `"allow"`](#allow-with-updatedinput). Para o modo de planejamento, consulte [Aprovações de hooks no modo de planejamento](https://code.claude.com/docs/pt/permissions.md#hook-approvals-in-plan-mode). `"deny"` impede a chamada de ferramenta. `"ask"` pede ao usuário que confirme. `"defer"` encerra o turno para que a ferramenta possa ser retomada depois e exige o [modo não interativo](#defer-a-tool-call-for-later) com a flag `-p`. As [regras de deny e ask](https://code.claude.com/docs/pt/permissions.md#manage-permissions) continuam sendo avaliadas, independentemente do que o hook retorne |1961| `permissionDecision` | `"allow"` pula o prompt de permissão, exceto para [ações que nenhum modo aprova automaticamente](https://code.claude.com/docs/pt/permission-modes.md#actions-no-mode-auto-approves) e [leituras de caminhos de rede](https://code.claude.com/docs/pt/permissions.md#network-paths). Ele também não pula a aprovação de chamadas a [ferramentas que um aplicativo do Agent SDK marca como `always_ask`](https://code.claude.com/docs/pt/agent-sdk/custom-tools#require-approval-for-specific-tools), a menos que o [modo de permissão aprove a chamada](https://code.claude.com/docs/pt/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call). `AskUserQuestion` e `ExitPlanMode` precisam de [`updatedInput` combinado com `"allow"`](#allow-with-updatedinput). Para o modo de planejamento, consulte [Aprovações de hooks no modo de planejamento](https://code.claude.com/docs/pt/permissions.md#hook-approvals-in-plan-mode). `"deny"` impede a chamada de ferramenta. `"ask"` pede ao usuário que confirme. `"defer"` encerra o turno para que a ferramenta possa ser retomada depois e exige o [modo não interativo](#defer-a-tool-call-for-later) com a flag `-p`. As [regras de deny e ask](https://code.claude.com/docs/pt/permissions.md#manage-permissions) continuam sendo avaliadas, independentemente do que o hook retorne |

1962| `permissionDecisionReason` | Para `"ask"`, mostrado ao usuário no prompt de permissão. Quando o Claude Code [nega a chamada](https://code.claude.com/docs/pt/headless.md#turn-off-permission-prompts-in-unattended-runs) em uma execução `-p` em que ninguém pode responder a esse prompt, o Claude lê o motivo no resultado da ferramenta. Para `"deny"`, mostrado ao Claude. Para `"allow"` e `"defer"`, gravado apenas no [log de depuração](#debug-hooks) |1962| `permissionDecisionReason` | Para `"ask"`, mostrado ao usuário no prompt de permissão. Quando o Claude Code [nega a chamada](https://code.claude.com/docs/pt/headless.md#turn-off-permission-prompts-in-unattended-runs) em uma execução `-p` em que ninguém pode responder a esse prompt, o Claude lê o motivo no resultado da ferramenta. Para `"deny"`, mostrado ao Claude. Para `"allow"` e `"defer"`, gravado apenas no [log de depuração](#debug-hooks) |

1963| `updatedInput` | Modifica os parâmetros de entrada da ferramenta antes da execução. Substitui o objeto de entrada inteiro, portanto inclua os campos inalterados junto com os modificados. O Claude Code avalia as regras de permissão e a [elegibilidade para segundo plano automático](https://code.claude.com/docs/pt/tools-reference.md#foreground-commands-that-move-to-the-background) de um comando Bash com base na entrada que seu hook retorna, e não na entrada que o Claude enviou. Combine com `"allow"` para aprovar automaticamente, ou com `"ask"` para mostrar a entrada modificada ao usuário. Para `"defer"`, é ignorado |1963| `updatedInput` | Modifica os parâmetros de entrada da ferramenta antes da execução. Substitui o objeto de entrada inteiro, portanto inclua os campos inalterados junto com os modificados. O Claude Code avalia as regras de permissão e a [elegibilidade para segundo plano automático](https://code.claude.com/docs/pt/tools-reference.md#foreground-commands-that-move-to-the-background) de um comando Bash em relação à entrada que o seu hook retorna, não à entrada que o Claude enviou. Combine com `"allow"` para aprovar automaticamente, ou com `"ask"` para mostrar a entrada modificada ao usuário. Para `"defer"`, é ignorado. Sem `permissionDecision`, o [modo auto pode negar a chamada alterada](#pretooluse-updatedinput-in-auto-mode) |

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

1965 1965 

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

1987>1987>

1988> O PreToolUse usava anteriormente os campos de nível superior `decision` e `reason`, mas eles estão descontinuados para esse evento. Use `hookSpecificOutput.permissionDecision` e `hookSpecificOutput.permissionDecisionReason`. Os valores descontinuados `"approve"` e `"block"` correspondem a `"allow"` e `"deny"`, respectivamente. Outros eventos, como PostToolUse e Stop, continuam a usar `decision` e `reason` de nível superior como seu formato atual.1988> O PreToolUse usava anteriormente os campos de nível superior `decision` e `reason`, mas eles estão descontinuados para esse evento. Use `hookSpecificOutput.permissionDecision` e `hookSpecificOutput.permissionDecisionReason`. Os valores descontinuados `"approve"` e `"block"` correspondem a `"allow"` e `"deny"`, respectivamente. Outros eventos, como PostToolUse e Stop, continuam a usar `decision` e `reason` de nível superior como seu formato atual.

1989 1989 

1990#### `updatedInput` do PreToolUse no modo auto

1991 

1992Quando o seu hook retorna `updatedInput` sem `permissionDecision` no [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode), o Claude Code pode negar a chamada alterada. [O servidor revisou](https://code.claude.com/docs/pt/permission-modes.md#server-side-classifier-review) a entrada que o Claude escreveu, não a entrada que o seu hook retornou. Em sessões interativas no terminal e sessões do VS Code com conexão direta à API da Anthropic, a negação inclui este texto:

1993 

1994```text theme={null}

1995a hook changed this call's input after auto mode reviewed it

1996```

1997 

1998Após uma negação com esse texto, o Claude pode emitir a chamada alterada novamente para que o servidor a revise. Se o Claude repetir exatamente a entrada alterada em sua próxima resposta, o seu hook ainda é executado:

1999 

2000* Ele pode negar a chamada ou enviá-la para o prompt de permissão

2001* Qualquer `updatedInput` que ele retornar é descartado, portanto o que é executado é o que o servidor revisou

2002 

2003Você não precisa alterar o seu hook por causa dessa negação, a menos que [o Claude informe em sua resposta que o modo auto não conseguiu verificar a chamada](https://code.claude.com/docs/pt/errors.md#hook-changed-input-after-review).

2004 

2005Nas sessões que mostram esse texto, um [hook `command`](#command-hook-fields) nas configurações ou no arquivo de hooks de um plugin pode alterar chamadas de Bash, PowerShell, Monitor, Edit, Write e NotebookEdit sem essa negação. A negação ainda pode aparecer, como quando algum hook alterou uma chamada anterior na mesma resposta do Claude ou quando um comando Bash pede para ser executado fora do sandbox.

2006 

1990#### Decisões `ask` do PreToolUse no modo auto2007#### Decisões `ask` do PreToolUse no modo auto

1991 2008 

1992No [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode), o `"ask"` de um hook PreToolUse normalmente envia a chamada de ferramenta para o prompt de permissão, e o [classificador](https://code.claude.com/docs/pt/permission-modes.md#how-the-classifier-evaluates-actions) não decide sobre ela. Algumas chamadas seguem um caminho diferente:2009No [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode), o `"ask"` de um hook PreToolUse normalmente envia a chamada de ferramenta para o prompt de permissão, e o [classificador](https://code.claude.com/docs/pt/permission-modes.md#how-the-classifier-evaluates-actions) não decide sobre ela. Algumas chamadas seguem um caminho diferente:

287 287 

288### Busca reversa com Ctrl+R288### Busca reversa com Ctrl+R

289 289 

290Pressione `Ctrl+R` para pesquisar interativamente através do seu histórico de comandos. Na [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), `Ctrl+R` abre um diálogo de pesquisa: digite para filtrar, pressione `Seta para cima` e `Seta para baixo` para se mover através das correspondências, e pressione `Ctrl+S` para alternar o escopo através desta sessão, este projeto e todos os projetos. Pressione `Enter` ou `Tab` para colocar uma correspondência na entrada do prompt, ou `Esc` para cancelar. Os passos abaixo descrevem a pesquisa inline do renderizador clássico:290Pressione `Ctrl+R` para pesquisar interativamente através do seu histórico de comandos. Na [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), `Ctrl+R` abre um diálogo de pesquisa em vez disso. Digite para filtrar no diálogo e pressione `Seta para cima` e `Seta para baixo` para se mover pela lista de correspondências, com um painel de visualização mostrando o início da correspondência destacada.

291 

292No diálogo, pressione `Ctrl+S` para alternar o escopo entre esta sessão, este projeto e todos os projetos. Pressione `Enter` ou `Tab` para colocar uma correspondência na entrada do prompt, ou `Esc` para cancelar. Os passos abaixo descrevem a pesquisa inline do renderizador clássico:

291 293 

2921. **Iniciar pesquisa**: pressione `Ctrl+R` para ativar a busca reversa de histórico2941. **Iniciar pesquisa**: pressione `Ctrl+R` para ativar a busca reversa de histórico

2932. **Digite a consulta**: insira o texto a ser pesquisado em comandos anteriores. O termo de pesquisa é destacado nos resultados correspondentes2952. **Digite a consulta**: insira o texto a ser pesquisado em comandos anteriores. A correspondência atual aparece na entrada do prompt.

2943. **Navegue pelas correspondências**: pressione `Ctrl+R` novamente para alternar entre correspondências mais antigas2963. **Navegue pelas correspondências**: pressione `Ctrl+R` novamente para alternar entre correspondências mais antigas

2954. **Escopo de pesquisa**: a pesquisa inline sempre pesquisa prompts de todos os projetos2974. **Escopo de pesquisa**: a pesquisa inline sempre pesquisa prompts de todos os projetos

2965. **Aceitar correspondência**:2985. **Aceitar correspondência**:

300 * Pressione `Ctrl+C` para cancelar e restaurar sua entrada original302 * Pressione `Ctrl+C` para cancelar e restaurar sua entrada original

301 * Pressione `Backspace` em pesquisa vazia para cancelar303 * Pressione `Backspace` em pesquisa vazia para cancelar

302 304 

303A pesquisa inline verifica seu histórico de prompt completo, mais recente primeiro, com duplicatas recolhidas para a ocorrência mais recente. O diálogo em tela cheia pesquisa todo o seu histórico de prompt no escopo selecionado, mais recente primeiro, com duplicatas recolhidas para a ocorrência mais recente: os prompts mais recentes aparecem imediatamente, e correspondências de prompts mais antigos preenchem conforme Claude Code carrega o resto. Os prompts correspondentes são exibidos com o termo de pesquisa destacado, para que você possa encontrar e reutilizar entradas anteriores.

304 

305Aceitar uma correspondência ou cancelar a pesquisa entra em efeito imediatamente, mesmo enquanto Claude Code ainda está carregando o histórico.305Aceitar uma correspondência ou cancelar a pesquisa entra em efeito imediatamente, mesmo enquanto Claude Code ainda está carregando o histórico.

306 306 

307## Comandos Bash em segundo plano307## Comandos Bash em segundo plano

39 39 

40Instale o [plugin Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) do JetBrains Marketplace e reinicie seu IDE.40Instale o [plugin Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) do JetBrains Marketplace e reinicie seu IDE.

41 41 

42> [!NOTE]

43>

44> O JetBrains Marketplace é um software de terceiros, que a Anthropic não endossa, mantém ou audita. A Anthropic envia o plugin Claude Code para publicação no JetBrains Marketplace.

45 

42Se `claude` estiver instalado em algum lugar que seu IDE não consiga encontrar, defina o caminho completo na [configuração do comando Claude](#general-settings) do plugin.46Se `claude` estiver instalado em algum lugar que seu IDE não consiga encontrar, defina o caminho completo na [configuração do comando Claude](#general-settings) do plugin.

43 47 

44Claude Code funciona com qualquer assinatura Claude paga (Pro, Max, Ultra, Team ou Enterprise) ou uma conta Claude Console, e nenhuma chave de API é necessária. Você será solicitado a [fazer login](https://code.claude.com/docs/pt/authentication.md#log-in-to-claude-code) na primeira vez que executar `claude`.48Claude Code funciona com qualquer assinatura Claude paga (Pro, Max, Ultra, Team ou Enterprise) ou uma conta Claude Console, e nenhuma chave de API é necessária. Você será solicitado a [fazer login](https://code.claude.com/docs/pt/authentication.md#log-in-to-claude-code) na primeira vez que executar `claude`.

278 278 

279Na v2.1.305 ou posterior, Claude Code reenvia uma requisição sem [campos `defer_loading` e blocos `tool_reference`](https://code.claude.com/docs/pt/mcp#tool-search-through-a-gateway) após um `400` ou `422` que nomeia a busca de ferramentas ou cuja causa ele não reconhece. Após uma nova tentativa bem-sucedida, as requisições posteriores nessa conversa também os omitem.279Na v2.1.305 ou posterior, Claude Code reenvia uma requisição sem [campos `defer_loading` e blocos `tool_reference`](https://code.claude.com/docs/pt/mcp#tool-search-through-a-gateway) após um `400` ou `422` que nomeia a busca de ferramentas ou cuja causa ele não reconhece. Após uma nova tentativa bem-sucedida, as requisições posteriores nessa conversa também os omitem.

280 280 

281As requisições do desenvolvedor continuam funcionando sem nenhuma alteração no gateway, com suas ferramentas MCP carregadas antecipadamente. Quando Claude Code tenta a busca de ferramentas novamente, o gateway vê outra requisição rejeitada seguida de sua nova tentativa. Para a busca de ferramentas em si, Claude Code espera que o gateway encaminhe os campos `defer_loading` e os blocos `tool_reference` com seu valor `anthropic-beta`.281As requisições do desenvolvedor continuam funcionando sem nenhuma alteração no gateway, com suas ferramentas MCP carregadas antecipadamente. Quando Claude Code tenta a busca de ferramentas novamente, o gateway pode ver outra requisição rejeitada seguida de sua nova tentativa. Para a busca de ferramentas em si, Claude Code espera que o gateway encaminhe os campos `defer_loading` e os blocos `tool_reference` com seu valor `anthropic-beta`.

282 282 

283### Desabilitar capacidades de pré-lançamento283### Desabilitar capacidades de pré-lançamento

284 284 

171* Os caminhos binários de sandbox `sandbox.bwrapPath` e `sandbox.socatPath`171* Os caminhos binários de sandbox `sandbox.bwrapPath` e `sandbox.socatPath`

172* O binário `ripgrep` de sandbox, [`sandbox.ripgrep`](https://code.claude.com/docs/pt/settings-reference#sandbox-ripgrep)172* O binário `ripgrep` de sandbox, [`sandbox.ripgrep`](https://code.claude.com/docs/pt/settings-reference#sandbox-ripgrep)

173* `sandbox.filesystem.disabled` e `sandbox.network.strictAllowlist`173* `sandbox.filesystem.disabled` e `sandbox.network.strictAllowlist`

174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/pt/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](https://code.claude.com/docs/pt/settings-reference#syncclaudeaiskills), e [`syncClaudeAiPlugins`](https://code.claude.com/docs/pt/settings-reference#syncclaudeaiplugins), onde um `false` de qualquer fonte de administrador desativa o comportamento. Um `false` nas configurações de usuário ou local do desenvolvedor também o desativa; cada chave pode apenas negar174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/pt/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](https://code.claude.com/docs/pt/settings-reference#syncclaudeaiskills), e [`syncClaudeAiPlugins`](https://code.claude.com/docs/pt/settings-reference#syncclaudeaiplugins), onde um `false` de qualquer fonte de administrador desativa o comportamento. Cada chave pode apenas negar:

175 * Um `false` nas configurações de usuário ou local do desenvolvedor também o desativa

176 * Para `useAutoModeDuringPlan`, um `false` em um arquivo de usuário ou local que o desenvolvedor deixa de fora com uma opção como [`--setting-sources`](https://code.claude.com/docs/pt/cli-reference#cli-flags) não conta. Ignorar um arquivo deixado de fora requer Claude Code v2.1.314 ou posterior

175* [`enableArtifact`](https://code.claude.com/docs/pt/settings-reference#enableartifact), onde um `false` de qualquer fonte de administrador desativa a [ferramenta Artifact](https://code.claude.com/docs/pt/artifacts.md). Um `false` nas configurações de usuário, projeto ou local do desenvolvedor também o desativa, e nenhuma fonte o ativa novamente; veja [quais valores de nível mais baixo ainda contam](https://code.claude.com/docs/pt/settings.md#exceptions-to-managed-settings-precedence). Requer Claude Code v2.1.242 ou posterior177* [`enableArtifact`](https://code.claude.com/docs/pt/settings-reference#enableartifact), onde um `false` de qualquer fonte de administrador desativa a [ferramenta Artifact](https://code.claude.com/docs/pt/artifacts.md). Um `false` nas configurações de usuário, projeto ou local do desenvolvedor também o desativa, e nenhuma fonte o ativa novamente; veja [quais valores de nível mais baixo ainda contam](https://code.claude.com/docs/pt/settings.md#exceptions-to-managed-settings-precedence). Requer Claude Code v2.1.242 ou posterior

176* [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel), onde o limite mais baixo em qualquer fonte de administrador se aplica. Se um desenvolvedor define um limite mais baixo em suas próprias configurações ou com `--settings`, Claude Code aplica aquele; nenhuma fonte pode aumentar o limite. Requer Claude Code v2.1.267 ou posterior178* [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel), onde o limite mais baixo em qualquer fonte de administrador se aplica. Se um desenvolvedor define um limite mais baixo em suas próprias configurações ou com `--settings`, Claude Code aplica aquele; nenhuma fonte pode aumentar o limite. Requer Claude Code v2.1.267 ou posterior

177* Um opt-out de trailer de commit em `attribution`, ou no `includeCoAuthoredBy` descontinuado, de qualquer nível179* Um opt-out de trailer de commit em `attribution`, ou no `includeCoAuthoredBy` descontinuado, de qualquer nível

6134. Suas configurações: o nível que você salvou para o modelo ou uma chave [`effortLevel`](https://code.claude.com/docs/pt/settings-reference#effortlevel), com a precedência entre eles e entre arquivos de configurações declarada em [`modelSettings`](https://code.claude.com/docs/pt/settings-reference#modelsettings)6134. Suas configurações: o nível que você salvou para o modelo ou uma chave [`effortLevel`](https://code.claude.com/docs/pt/settings-reference#effortlevel), com a precedência entre eles e entre arquivos de configurações declarada em [`modelSettings`](https://code.claude.com/docs/pt/settings-reference#modelsettings)

6145. O esforço padrão do modelo: `high` em cada modelo que suporta esforço, exceto que Opus 5.5, Sonnet 5.5 e Haiku 5.5 têm `medium` como padrão e Opus 4.7 tem `xhigh` como padrão. Se sua organização define um nível de esforço padrão para seu [modelo padrão da organização](#organization-default-model), esse nível é o padrão quando você executa esse modelo.6145. O esforço padrão do modelo: `high` em cada modelo que suporta esforço, exceto que Opus 5.5, Sonnet 5.5 e Haiku 5.5 têm `medium` como padrão e Opus 4.7 tem `xhigh` como padrão. Se sua organização define um nível de esforço padrão para seu [modelo padrão da organização](#organization-default-model), esse nível é o padrão quando você executa esse modelo.

615 615 

616Após um fallback automático de modelo, consulte [Nível de esforço após um fallback](#effort-level-after-a-fallback) para saber qual nível se aplica.616Após um fallback automático de modelo, consulte [Nível de esforço após um fallback](#effort-level-after-a-fallback) para saber qual nível se aplica. Para subagentes e colegas de equipe, consulte [Nível de esforço de subagentes e colegas de equipe](#effort-level-of-subagents-and-teammates).

617 617 

618Opus 5.5 começa em `medium` a menos que uma das fontes acima defina um nível para ele, e um `effortLevel` de nível superior em seu arquivo de configurações de usuário não conta para Opus 5.5. Essa chave é a forma mais antiga que `/effort` escreveu antes de Claude Code salvar níveis por modelo: continua se aplicando onde se aplicava antes, em Opus 5, Fable 5.1 e modelos anteriores, enquanto Opus 5.5 e modelos lançados após ele começam em seu próprio padrão até você escolher um nível para eles com `/effort` ou o seletor `/model`. Um `effortLevel` de nível superior em configurações de projeto, local ou gerenciadas, ou um passado com `--settings`, se aplica a cada modelo.618Opus 5.5 começa em `medium` a menos que uma das fontes acima defina um nível para ele, e um `effortLevel` de nível superior em seu arquivo de configurações de usuário não conta para Opus 5.5. Essa chave é a forma mais antiga que `/effort` escreveu antes de Claude Code salvar níveis por modelo: continua se aplicando onde se aplicava antes, em Opus 5, Fable 5.1 e modelos anteriores, enquanto Opus 5.5 e modelos lançados após ele começam em seu próprio padrão até você escolher um nível para eles com `/effort` ou o seletor `/model`. Um `effortLevel` de nível superior em configurações de projeto, local ou gerenciadas, ou um passado com `--settings`, se aplica a cada modelo.

619 619 

700 700 

701Um [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel) ou [limite de esforço da organização](#organization-effort-limits) ainda limita o nível em que a skill ou subagente é executado. Se você definir `effortLevel` em [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), Claude Code o aplica na etapa de configurações da [ordem de resolução de esforço](#adjust-effort-level), e os usuários ainda podem alterar o nível com `/effort` ou `--effort`. Para manter os usuários em ou abaixo de um nível, defina [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel).701Um [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel) ou [limite de esforço da organização](#organization-effort-limits) ainda limita o nível em que a skill ou subagente é executado. Se você definir `effortLevel` em [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), Claude Code o aplica na etapa de configurações da [ordem de resolução de esforço](#adjust-effort-level), e os usuários ainda podem alterar o nível com `/effort` ou `--effort`. Para manter os usuários em ou abaixo de um nível, defina [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel).

702 702 

703#### Nível de esforço de subagentes e colegas de equipe

704 

705No modelo da conversa principal, um [subagente](https://code.claude.com/docs/pt/sub-agents.md#choose-an-effort-level) ou [colega de equipe](https://code.claude.com/docs/pt/agent-teams.md#specify-teammates-and-models) sem `effort` próprio é executado no nível que você escolhe na sessão ou define com `--effort`. Em outro modelo, esse nível não se aplica. Para escolher o nível de um subagente, defina `effort` em sua definição.

706 

703#### Verificar o nível de esforço que você definiu707#### Verificar o nível de esforço que você definiu

704 708 

705O controle deslizante de esforço aparece em `/model` quando um modelo suportado é selecionado. Um nível no cabeçalho da sessão, por exemplo "with low effort", vem da sua configuração de esforço, mesmo que Claude esteja [ainda trabalhando no nível antigo](#when-a-new-effort-level-starts). Na inicialização e quando você o altera, o rodapé também mostra brevemente o nível definido para sua sessão.709O controle deslizante de esforço aparece em `/model` quando um modelo suportado é selecionado. Um nível no cabeçalho da sessão, por exemplo "with low effort", vem da sua configuração de esforço, mesmo que Claude esteja [ainda trabalhando no nível antigo](#when-a-new-effort-level-starts). Na inicialização e quando você o altera, o rodapé também mostra brevemente o nível definido para sua sessão.

330 330 

331Em sessões interativas da CLI, o tracing beta detalhado também requer que sua organização esteja na lista de permissões para o recurso. O Agent SDK e sessões não interativas `-p` não exigem a lista de permissões.331Em sessões interativas da CLI, o tracing beta detalhado também requer que sua organização esteja na lista de permissões para o recurso. O Agent SDK e sessões não interativas `-p` não exigem a lista de permissões.

332 332 

333> [!WARNING]

334>

335> Defina `ENABLE_BETA_TRACING_DETAILED` somente para depuração, não em produção. O tracing beta detalhado tem um alto volume de exportação, e seus [atributos de conteúdo](#new-context-gates) não fazem parte do esquema estável de spans.

336 

333| Atributo | Descrição | Condicionado por |337| Atributo | Descrição | Condicionado por |

334| - | - | - |338| - | - | - |

335| `hook_event` | Tipo de evento do hook, como `PreToolUse` | |339| `hook_event` | Tipo de evento do hook, como `PreToolUse` | |

131 131 

132Claude Code anota cada chave ignorada no log de depuração da sessão.132Claude Code anota cada chave ignorada no log de depuração da sessão.

133 133 

134Em sessões do [Claude Desktop](https://code.claude.com/docs/pt/desktop.md) onde o aplicativo gerencia a conexão do provedor, como a aba Code em um [provedor de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md) e sessões Cowork, Claude Code lê essas variáveis e as variáveis de proxy `HTTP_PROXY`, `HTTPS_PROXY` e `NO_PROXY` apenas de [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) e `~/.claude/settings.json`: ele as ignora nos arquivos de configurações próprios de um repositório, portanto um repositório verificado não pode redirecionar o caminho TLS ou proxy de uma sessão cujas credenciais vêm do aplicativo. Em uma sessão local, SSH ou WSL Code tab conectada através de claude.ai, o aplicativo não gerencia a conexão, e Claude Code lê essas variáveis de cada escopo de configurações, como qualquer sessão de terminal; [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) seguem as regras de sessão na nuvem acima onde quer que você as inicie. Antes da v2.1.217, Claude Code ignorava essas variáveis em todos os arquivos de configurações quando o aplicativo gerenciava a conexão.134Em sessões do [Claude Desktop](https://code.claude.com/docs/pt/desktop.md) onde o aplicativo gerencia a conexão do provedor, como a aba Code em um [provedor de terceiros](https://code.claude.com/docs/pt/third-party-integrations.md) e sessões Cowork, Claude Code lê essas variáveis, exceto `CLAUDE_CODE_OAUTH_SCOPES`, e as variáveis de proxy `HTTP_PROXY`, `HTTPS_PROXY` e `NO_PROXY` apenas de [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) e `~/.claude/settings.json`. Ele as ignora nos arquivos de configurações próprios de um repositório, portanto um repositório clonado não pode redirecionar o caminho TLS ou de proxy de uma sessão cujas credenciais vêm do aplicativo. Antes da v2.1.217, Claude Code ignorava essas variáveis em todos os arquivos de configurações quando o aplicativo gerenciava a conexão.

135 

136Em uma sessão local, SSH ou WSL da aba Code conectada através de claude.ai, você pode definir essas variáveis e as variáveis de proxy em qualquer arquivo de configurações, exceto `CLAUDE_CODE_OAUTH_SCOPES`. O Desktop define `CLAUDE_CODE_OAUTH_SCOPES` por conta própria em sessões da aba Code e Cowork, portanto você não pode defini-la.

137 

138Quando o ambiente de inicialização da sessão já define uma variável, Claude Code [ignora o valor do arquivo de configurações](https://code.claude.com/docs/pt/settings-reference.md#how-env-values-interact-with-your-shell) e nomeia a variável no [log de depuração](https://code.claude.com/docs/pt/debug-your-config.md). Para usar seu próprio valor de proxy ou certificado em uma sessão local, [adicione-o a um ambiente local salvo](https://code.claude.com/docs/pt/desktop.md#set-environment-variables-for-local-sessions). [Sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) seguem as regras de sessão na nuvem acima onde quer que você as inicie.

135 139 

136## Verificar sua configuração140## Verificar sua configuração

137 141 

383* **O servidor não revisa a sessão**: uma resposta é concluída sem resultados de revisão, ou o servidor responde que não revisa essa sessão. As causas mais comuns são um gateway de LLM ou proxy que descarta a requisição de revisão ou os resultados, e uma plataforma, região ou credencial que ainda não tem verificações no servidor. Claude Code recorre às suas próprias requisições do classificador. Uma vez que esse fallback se mantém pelo resto da sessão, ele mostra um [aviso sobre cobranças de requisições do classificador](https://code.claude.com/docs/pt/auto-mode-classifier-billing.md) em contas onde essas requisições são cobradas.383* **O servidor não revisa a sessão**: uma resposta é concluída sem resultados de revisão, ou o servidor responde que não revisa essa sessão. As causas mais comuns são um gateway de LLM ou proxy que descarta a requisição de revisão ou os resultados, e uma plataforma, região ou credencial que ainda não tem verificações no servidor. Claude Code recorre às suas próprias requisições do classificador. Uma vez que esse fallback se mantém pelo resto da sessão, ele mostra um [aviso sobre cobranças de requisições do classificador](https://code.claude.com/docs/pt/auto-mode-classifier-billing.md) em contas onde essas requisições são cobradas.

384* **O servidor não dá veredito para uma ação**: Claude Code nega a ação em vez de executá-la sem revisão. Em qualquer conexão, isso acontece quando a resposta termina antes de os resultados de revisão chegarem ou quando os resultados chegam em uma forma que Claude Code não consegue ler. Um gateway de LLM ou proxy que corta respostas ou reescreve os resultados pode causar qualquer um dos dois. Em uma conexão direta com a API Anthropic, também acontece quando a verificação do servidor falha para a ação, por exemplo ao expirar o tempo limite. [O servidor não retornou veredito de segurança](https://code.claude.com/docs/pt/errors.md#the-server-returned-no-safety-verdict) cobre a mensagem de negação, o que acontece quando negações se repetem e o que fazer.384* **O servidor não dá veredito para uma ação**: Claude Code nega a ação em vez de executá-la sem revisão. Em qualquer conexão, isso acontece quando a resposta termina antes de os resultados de revisão chegarem ou quando os resultados chegam em uma forma que Claude Code não consegue ler. Um gateway de LLM ou proxy que corta respostas ou reescreve os resultados pode causar qualquer um dos dois. Em uma conexão direta com a API Anthropic, também acontece quando a verificação do servidor falha para a ação, por exemplo ao expirar o tempo limite. [O servidor não retornou veredito de segurança](https://code.claude.com/docs/pt/errors.md#the-server-returned-no-safety-verdict) cobre a mensagem de negação, o que acontece quando negações se repetem e o que fazer.

385 385 

386 Se um [hook](https://code.claude.com/docs/pt/hooks.md#pretooluse-updatedinput-in-auto-mode) ou [mod](https://code.claude.com/docs/pt/plugins/mods/overview.md) alterar a entrada de uma ação após a revisão do servidor, Claude Code pode negar a ação sem veredito. Em sessões de terminal interativo e VS Code em uma conexão direta com a API Anthropic, o texto da negação inclui `a hook changed this call's input after auto mode reviewed it`. [Sua entrada de erro](https://code.claude.com/docs/pt/errors.md#hook-changed-input-after-review) cobre o que fazer.

387 

386Para deixar de consultar o servidor e sempre usar as próprias requisições do classificador de Claude Code, defina [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/pt/env-vars). Em uma conexão direta com a API Anthropic, a variável requer Claude Code v2.1.281 ou posterior. Defini-la como `1` nesse caso ativa a revisão do servidor em uma sessão que ainda não a tem, a menos que você também tenha definido `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Se você definir `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` e deixar `CLAUDE_CODE_AUTO_MODE_SERVER` indefinido, Claude Code também para de pedir ao servidor, exceto como [Desabilitar capacidades de pré-lançamento](https://code.claude.com/docs/pt/llm-gateway-protocol.md#disable-pre-release-capabilities) descreve.388Para deixar de consultar o servidor e sempre usar as próprias requisições do classificador de Claude Code, defina [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/pt/env-vars). Em uma conexão direta com a API Anthropic, a variável requer Claude Code v2.1.281 ou posterior. Defini-la como `1` nesse caso ativa a revisão do servidor em uma sessão que ainda não a tem, a menos que você também tenha definido `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Se você definir `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` e deixar `CLAUDE_CODE_AUTO_MODE_SERVER` indefinido, Claude Code também para de pedir ao servidor, exceto como [Desabilitar capacidades de pré-lançamento](https://code.claude.com/docs/pt/llm-gateway-protocol.md#disable-pre-release-capabilities) descreve.

387 389 

388### Modelo classificador padrão390### Modelo classificador padrão

557* **Uma ação bloqueada**: Claude Code mostra uma notificação e lista a ação em `/permissions` na aba **Recently blocked**, onde você pode [aprovar a ação para que Claude possa tentar novamente](https://code.claude.com/docs/pt/auto-mode-config.md#review-denials).559* **Uma ação bloqueada**: Claude Code mostra uma notificação e lista a ação em `/permissions` na aba **Recently blocked**, onde você pode [aprovar a ação para que Claude possa tentar novamente](https://code.claude.com/docs/pt/auto-mode-config.md#review-denials).

558* **Bloqueios repetidos**: se o classificador bloquear uma ação 3 vezes seguidas ou 20 vezes no total, o modo auto pausa e Claude Code volta a solicitar confirmação. Aprovar a ação solicitada retoma o modo auto. Consulte [Limites de bloqueio repetido](#repeated-block-thresholds) para saber como os bloqueios são contados.560* **Bloqueios repetidos**: se o classificador bloquear uma ação 3 vezes seguidas ou 20 vezes no total, o modo auto pausa e Claude Code volta a solicitar confirmação. Aprovar a ação solicitada retoma o modo auto. Consulte [Limites de bloqueio repetido](#repeated-block-thresholds) para saber como os bloqueios são contados.

559* **Sem veredito do classificador**: quando uma verificação de segurança separada do modo auto recusa a própria requisição do classificador, ou a resposta do classificador não pode ser analisada, Claude Code bloqueia a ação sem a notificação ou a entrada em **Recently blocked**. Consulte [Auto mode cannot determine the safety of an action](https://code.claude.com/docs/pt/errors.md#auto-mode-cannot-determine-the-safety-of-an-action) para a mensagem que cada caso mostra e o que fazer.561* **Sem veredito do classificador**: quando uma verificação de segurança separada do modo auto recusa a própria requisição do classificador, ou a resposta do classificador não pode ser analisada, Claude Code bloqueia a ação sem a notificação ou a entrada em **Recently blocked**. Consulte [Auto mode cannot determine the safety of an action](https://code.claude.com/docs/pt/errors.md#auto-mode-cannot-determine-the-safety-of-an-action) para a mensagem que cada caso mostra e o que fazer.

560* **Sem veredito do servidor**: sob a [revisão do classificador no servidor](#server-side-classifier-review), Claude Code nega uma ação para a qual o servidor não dá veredito, e interrompe o turno após dez respostas seguidas sem veredito. Consulte [O servidor não retornou veredito de segurança](https://code.claude.com/docs/pt/errors.md#the-server-returned-no-safety-verdict).562* **Sem veredito do servidor**: sob a [revisão do classificador no servidor](#server-side-classifier-review), Claude Code nega uma ação para a qual o servidor não dá veredito, e pode interromper o turno após dez respostas seguidas sem veredito. Consulte [O servidor não retornou veredito de segurança](https://code.claude.com/docs/pt/errors.md#the-server-returned-no-safety-verdict).

561* **Uma mudança de modo durante uma verificação**: se você mudar de modo de permissão enquanto uma verificação do classificador está pendente, Claude Code descarta um veredito que o novo modo não teria solicitado. Em vez disso, você recebe um prompt de aprovação, ou a ação é negada automaticamente no [modo `dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).563* **Uma mudança de modo durante uma verificação**: se você mudar de modo de permissão enquanto uma verificação do classificador está pendente, Claude Code descarta um veredito que o novo modo não teria solicitado. Em vez disso, você recebe um prompt de aprovação, ou a ação é negada automaticamente no [modo `dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).

562 564 

563#### Limites de bloqueio repetido565#### Limites de bloqueio repetido

199 199 

200A mensagem diz a Claude para emitir a chamada novamente conforme registrado. Se isso também for recusado, o hook altera a entrada toda vez, então desative o mod ou hook, ou saia do modo automático e aprove a chamada você mesmo.200A mensagem diz a Claude para emitir a chamada novamente conforme registrado. Se isso também for recusado, o hook altera a entrada toda vez, então desative o mod ou hook, ou saia do modo automático e aprove a chamada você mesmo.

201 201 

202> [!NOTE]

203>

204> Em [algumas sessões interativas de terminal e sessões do VS Code](https://code.claude.com/docs/pt/hooks.md#pretooluse-updatedinput-in-auto-mode), a mesma recusa fornece o motivo `a hook changed this call's input after auto mode reviewed it`. A chamada repetida ali carrega a primeira alteração do mod, e um hook `tool.call` ainda é executado nela, mas uma alteração adicional é descartada. Você não precisa alterar seu mod, a menos que Claude informe em sua resposta que [o modo auto não conseguiu verificar a chamada](https://code.claude.com/docs/pt/errors.md#hook-changed-input-after-review).

205 

202### Uma mensagem sobre as regras de negação em suas configurações206### Uma mensagem sobre as regras de negação em suas configurações

203 207 

204`tried to lift a deny rule in your settings` e `the deny rules in your settings could not be checked for this call, so it is refused` ambas vêm do guarda integrado.208`tried to lift a deny rule in your settings` e `the deny rules in your settings could not be checked for this call, so it is refused` ambas vêm do guarda integrado.

31>31>

32> Dois outros recursos agendam trabalho na sua máquina em vez de na nuvem: [tarefas agendadas do Desktop](https://code.claude.com/docs/pt/desktop-scheduled-tasks.md) e [`/loop`](https://code.claude.com/docs/pt/scheduled-tasks). Para escolher entre os três, consulte [Comparar opções de agendamento](https://code.claude.com/docs/pt/scheduled-tasks.md#compare-scheduling-options).32> Dois outros recursos agendam trabalho na sua máquina em vez de na nuvem: [tarefas agendadas do Desktop](https://code.claude.com/docs/pt/desktop-scheduled-tasks.md) e [`/loop`](https://code.claude.com/docs/pt/scheduled-tasks). Para escolher entre os três, consulte [Comparar opções de agendamento](https://code.claude.com/docs/pt/scheduled-tasks.md#compare-scheduling-options).

33 33 

34Os Owners de Team e Enterprise podem desativar as tarefas agendadas para todos os membros com o botão de alternância **Scheduled tasks (Was Routines)** em [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities). Quando o botão está desativado, as tarefas agendadas existentes param de ser executadas e os membros não podem criar novas.34Os Owners de Team e Enterprise podem desativar as tarefas agendadas para todos os membros com o botão de alternância **Scheduled tasks (Was Routines)** ou **Routines** em [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities). Quando o botão está desativado, as tarefas agendadas existentes param de ser executadas e os membros não podem criar novas.

35 35 

36Se a sua organização Enterprise gerencia o seu acesso com [funções personalizadas](https://support.claude.com/en/articles/13930452), você também precisa de uma função que inclua a permissão de tarefas agendadas. Um Owner pode adicioná-la na seção **Remote sessions** de uma função em [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).36Se a sua organização Enterprise gerencia o seu acesso com [funções personalizadas](https://support.claude.com/en/articles/13930452), você também precisa de uma função que inclua a permissão de tarefas agendadas. Um Owner pode adicioná-la na seção **Remote sessions** de uma função em [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).

37 37 

485* **Endereço web**: `claude.ai/code/routines`485* **Endereço web**: `claude.ai/code/routines`

486* **CLI**: o alias `/routines` para `/schedule`, a descrição do comando e as respostas do Claude enquanto ele configura uma tarefa486* **CLI**: o alias `/routines` para `/schedule`, a descrição do comando e as respostas do Claude enquanto ele configura uma tarefa

487* **API**: o caminho do endpoint `/fire`, seu cabeçalho beta, o `type` da resposta, a tag `<routine-fire-payload>` e a página de referência [Trigger a routine through the API](https://platform.claude.com/docs/en/api/claude-code/routines-fire)487* **API**: o caminho do endpoint `/fire`, seu cabeçalho beta, o `type` da resposta, a tag `<routine-fire-payload>` e a página de referência [Trigger a routine through the API](https://platform.claude.com/docs/en/api/claude-code/routines-fire)

488* **Configurações da organização**: o botão de alternância **Scheduled tasks (Was Routines)**488* **Configurações da organização**: o botão de alternância **Scheduled tasks (Was Routines)** ou **Routines**

489 489 

490## Solução de problemas490## Solução de problemas

491 491 

504 504 

505Se a causa for o seu login na CLI ou o fato de estar dentro de uma sessão na nuvem, você ainda pode criar e gerenciar tarefas agendadas em [claude.ai/code/routines](https://claude.ai/code/routines). Você precisa de uma conta Pro, Max, Ultra, Team ou Enterprise lá. Se as tarefas agendadas ou as sessões na nuvem estiverem desativadas para sua organização ou ausentes das suas funções, você também não poderá criá-las na web.505Se a causa for o seu login na CLI ou o fato de estar dentro de uma sessão na nuvem, você ainda pode criar e gerenciar tarefas agendadas em [claude.ai/code/routines](https://claude.ai/code/routines). Você precisa de uma conta Pro, Max, Ultra, Team ou Enterprise lá. Se as tarefas agendadas ou as sessões na nuvem estiverem desativadas para sua organização ou ausentes das suas funções, você também não poderá criá-las na web.

506 506 

507### "Routines are disabled by your organization's policy"507### As tarefas agendadas estão desativadas para sua organização

508 508 

509Um Owner da sua organização Team ou Enterprise provavelmente desativou o botão de alternância **Scheduled tasks (Was Routines)** em [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities). No Claude Code v2.1.227 ou posterior, o mesmo botão também oculta `/schedule` na CLI. Esta é uma configuração da organização no lado do servidor, portanto não pode ser substituída pela sua configuração local. Peça a um Owner que reative as tarefas agendadas para sua organização.509As tarefas agendadas na nuvem estão desativadas para sua organização, e você não pode alterar isso pela sua configuração local. Pergunte ao Owner da sua organização Team ou Enterprise se ele pode ativar o botão de alternância **Scheduled tasks (Was Routines)** ou **Routines** em [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities).

510 510 

511### Avisos "The last run"511### Avisos "The last run"

512 512 

1074* **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.1074* **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.

1075* **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. Esta opção enfraquece consideravelmente a segurança e deve ser usada apenas quando isolamento adicional é de outra forma imposto.1075* **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. Esta opção enfraquece consideravelmente a segurança e deve ser usada apenas quando isolamento adicional é de outra forma imposto.

1076* **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.1076* **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.

1077* **Serviços Mach e XPC no macOS**: comandos em sandbox podem alcançar, fora do sandbox, cada serviço que você listar em [`network.allowMachLookup`](https://code.claude.com/docs/pt/settings-reference#sandbox-network-allowmachlookup), e o sandbox não restringe o que esses serviços fazem para esses comandos.

1077* **User namespaces no Linux e WSL2**: por padrão, comandos em sandbox não podem criar user namespaces. Se você definir [`allowNestedUserNamespaces`](https://code.claude.com/docs/pt/settings-reference#sandbox-allownestedusernamespaces) como `true`, você desativa um limite de segurança: código de um comando em sandbox pode acabar sendo executado fora do sandbox. Antes de ativar essa configuração, leia o aviso em [Chromium ou Podman rootless falha dentro do sandbox no Linux](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux).1078* **User namespaces no Linux e WSL2**: por padrão, comandos em sandbox não podem criar user namespaces. Se você definir [`allowNestedUserNamespaces`](https://code.claude.com/docs/pt/settings-reference#sandbox-allownestedusernamespaces) como `true`, você desativa um limite de segurança: código de um comando em sandbox pode acabar sendo executado fora do sandbox. Antes de ativar essa configuração, leia o aviso em [Chromium ou Podman rootless falha dentro do sandbox no Linux](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux).

1078 1079 

1079### Escopo1080### Escopo

16 16 

17## Wrapper scripts17## Wrapper scripts

18 18 

19Use um script wrapper quando cada sessão precisar de configuração que o runner não consegue fazer por conta própria: provisionamento de credenciais de curta duração com escopo para o criador da sessão, exportação de segredos específicos do ambiente, preparação de cadeias de ferramentas de linguagem ou aplicação de limites de recursos ao redor do processo filho. O runner inicia seu wrapper no lugar do binário Claude Code, uma vez por sessão. Termine o wrapper com `exec` em `$CLAUDE_RUNNER_CLAUDE_BIN`, o binário próprio do runner, para que sinais e códigos de saída se propaguem corretamente.19Use um script wrapper quando cada sessão precisar de configuração que o runner não consegue fazer por conta própria:

20 

21* Provisionamento de credenciais de curta duração com escopo para o criador da sessão

22* Exportação de segredos específicos do ambiente

23* Preparação de cadeias de ferramentas de linguagem

24* Aplicação de limites de recursos ao redor do processo filho

25 

26O runner inicia seu wrapper no lugar do binário Claude Code cada vez que inicia uma sessão, inclusive quando uma sessão é retomada ou recolocada na fila. Termine o wrapper com `exec` em `$CLAUDE_RUNNER_CLAUDE_BIN`, o binário próprio do runner, para que sinais e códigos de saída se propaguem corretamente.

20 27 

21Aponte `--exec-path`, ou `SELF_HOSTED_RUNNER_EXEC_PATH`, para o wrapper quando você inicia o runner, substituindo `<writable-dir>` conforme descrito no [guia de início rápido](https://code.claude.com/docs/pt/self-hosted-environments-quickstart.md#set-up-manually):28Aponte `--exec-path`, ou `SELF_HOSTED_RUNNER_EXEC_PATH`, para o wrapper quando você inicia o runner, substituindo `<writable-dir>` conforme descrito no [guia de início rápido](https://code.claude.com/docs/pt/self-hosted-environments-quickstart.md#set-up-manually):

22 29 

139 146 

140### checkout147### checkout

141 148 

142Executado uma vez por repositório, no lugar do clone e fetch integrados do runner. Use o hook para clonar de um espelho de leitura que você acessa por HTTPS ou SSH, semear uma árvore de trabalho a partir de um arquivo ou aplicar autenticação git por sessão. O runner define estas variáveis, e pode definir outras variáveis `CLAUDE_RUNNER_` que a tabela não lista:149Executado para cada repositório toda vez que o runner inicia uma sessão, inclusive quando a sessão é retomada ou recolocada na fila, no lugar do clone e fetch integrados do runner. Use o hook para clonar de um espelho de leitura que você acessa por HTTPS ou SSH, semear uma árvore de trabalho a partir de um arquivo ou aplicar autenticação git por sessão.

150 

151O runner define estas variáveis, e pode definir outras variáveis `CLAUDE_RUNNER_` que a tabela não lista:

143 152 

144| Variável | Descrição |153| Variável | Descrição |

145| :- | :- |154| :- | :- |

179 188 

180### post-session189### post-session

181 190 

182Executado uma vez por sessão, após o filho Claude Code ter saído e antes do runner desmontar o workspace. Este hook é sua única chance de salvar trabalho não confirmado: em `--capacity` acima de um, o runner deleta worktrees por sessão logo após o hook retornar, e em `--capacity 1` o [clone canônico](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout) reutilizado é hard-reset quando a próxima sessão começa, então mudanças rastreadas não confirmadas não sobrevivem em nenhum caminho. Usos típicos são fazer push de um branch de snapshot de mudanças não confirmadas, arquivar logs ou emitir um evento de fim de sessão para seus próprios sistemas.191Executado após o filho Claude Code ter saído e antes do runner desmontar o workspace. Este hook é sua única chance de salvar trabalho sem commit, porque mudanças rastreadas sem commit não sobrevivem em nenhum dos caminhos:

192 

193* **Em `--capacity` acima de um**: o runner deleta worktrees por sessão logo após o hook retornar

194* **Em `--capacity 1`**: o [clone canônico](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout) reutilizado é hard-reset quando a próxima sessão começa

195 

196Usos típicos são fazer push de um branch de snapshot de mudanças sem commit, arquivar logs ou emitir um evento de fim de sessão para seus próprios sistemas.

183 197 

184O hook dispara em cada fim de sessão onde um processo filho foi gerado, qualquer que seja a causa; os valores `CLAUDE_RUNNER_EXIT_REASON` abaixo enumeram os casos. Não pode disparar quando o runner termina abruptamente, como uma preempção de VM ou perda de energia; se você precisa de garantias contra terminação abrupta, faça snapshot periodicamente de dentro da sessão com um hook Claude Code `PostToolUse` em vez disso. O runner define:198O hook dispara em cada fim de sessão onde um processo filho foi gerado, qualquer que seja a causa; os valores `CLAUDE_RUNNER_EXIT_REASON` abaixo enumeram os casos. Não pode disparar quando o runner termina abruptamente, como uma preempção de VM ou perda de energia; se você precisa de garantias contra terminação abrupta, faça snapshot periodicamente de dentro da sessão com um hook Claude Code `PostToolUse` em vez disso. O runner define:

185 199 

275 289 

276### command290### command

277 291 

278Executado uma vez por sessão após checkout, no lugar do spawn do filho integrado. O hook recebe o mesmo ambiente que um [wrapper script](#wrapper-scripts) e deve fazer `exec` em `"$CLAUDE_RUNNER_CLAUDE_BIN"` da mesma forma. Use o hook `command` para manter toda a customização em um diretório de hooks; use `--exec-path` quando o wrapper vive em outro lugar. Se `--exec-path` também está definido, a flag tem precedência e o hook `command` é ignorado.292Executado após o checkout toda vez que uma sessão é iniciada ou retomada, no lugar do spawn do filho integrado. O hook recebe o mesmo ambiente que um [wrapper script](#wrapper-scripts) e deve fazer `exec` em `"$CLAUDE_RUNNER_CLAUDE_BIN"` da mesma forma. Use o hook `command` para manter toda a customização em um diretório de hooks; use `--exec-path` quando o wrapper vive em outro lugar. Se `--exec-path` também está definido, a flag tem precedência e o hook `command` é ignorado.

279 293 

280Sempre faça `exec` do binário próprio do runner em vez de um `claude` resolvido por PATH; caso contrário você derrota o [pinning de versão](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#pin-the-version).294Sempre faça `exec` do binário próprio do runner em vez de um `claude` resolvido por PATH; caso contrário você derrota o [pinning de versão](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#pin-the-version).

281 295 

523 537 

524* **Endpoint de metadados**: se você negar totalmente às sessões o acesso ao [endpoint de metadados da nuvem](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#harden-your-deployment), as credenciais fornecidas por ele, como um perfil de instância, também não chegam ao Claude Code. Uma identidade web baseada em arquivo, como IAM Roles for Service Accounts (IRSA) no Amazon EKS ou um arquivo de credencial de Workload Identity Federation, não depende dele.538* **Endpoint de metadados**: se você negar totalmente às sessões o acesso ao [endpoint de metadados da nuvem](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#harden-your-deployment), as credenciais fornecidas por ele, como um perfil de instância, também não chegam ao Claude Code. Uma identidade web baseada em arquivo, como IAM Roles for Service Accounts (IRSA) no Amazon EKS ou um arquivo de credencial de Workload Identity Federation, não depende dele.

525* **Renovação**: uma sessão pode durar mais que uma credencial, portanto use um método que se renove sozinho, como uma identidade web baseada em arquivo539* **Renovação**: uma sessão pode durar mais que uma credencial, portanto use um método que se renove sozinho, como uma identidade web baseada em arquivo

526* **Script wrapper**: o runner inicia o seu [script wrapper](#provision-credentials-scoped-to-the-session-creator) uma vez por sessão, portanto as credenciais que ele exporta não são renovadas. O Claude Code lê as credenciais da AWS do seu ambiente, então, se o seu wrapper já exporta credenciais da AWS para outro trabalho, o Claude Code pode assinar as requisições de modelo com elas.540* **Script wrapper**: os valores de credenciais que o seu [script wrapper](#provision-credentials-scoped-to-the-session-creator) exporta não são renovados enquanto o Claude Code é executado, portanto, para uma sessão longa, use um método que se renove sozinho. O Claude Code lê as credenciais da AWS do seu ambiente, então, se o seu wrapper já exporta credenciais da AWS para outro trabalho, o Claude Code pode assinar as requisições de modelo com elas.

527 541 

528**3. Defina as variáveis de um único provedor no ambiente do runner**542**3. Defina as variáveis de um único provedor no ambiente do runner**

529 543 

827 827 

828### Algumas sessões não contam como ociosas828### Algumas sessões não contam como ociosas

829 829 

830Uma sessão mantendo uma tarefa de fundo que nunca termina não conta como ociosa, então `--release-idle-session-min` não liberará o slot dessa sessão. Uma sessão que está aguardando uma aprovação solicitada de dentro de uma chamada de ferramenta em execução também não conta como ociosa. Sempre defina `--kill-session-after-min` ao lado dela como um backstop duro para que nenhuma sessão possa manter um slot indefinidamente.830Uma sessão mantendo uma tarefa em segundo plano que continua em execução não conta como ociosa, então `--release-idle-session-min` não liberará o slot dessa sessão. Uma sessão que está aguardando uma aprovação solicitada de dentro de uma chamada de ferramenta em execução também não conta como ociosa. Defina `--kill-session-after-min` ao lado dela como um backstop duro.

831 831 

832`--kill-session-after-min` é um backstop para sessões descontroladas. Em um runner na v2.1.260 ou posterior, uma sessão que atinge o limite não é encerrada imediatamente. O runner oferece uma janela de graça, 15 minutos por padrão, que você pode alterar com [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/pt/self-hosted-environments-reference#environment-variable-only-settings):832`--kill-session-after-min` é um backstop para sessões descontroladas. Em um runner na v2.1.260 ou posterior, uma sessão que atinge o limite não é encerrada imediatamente. O runner oferece uma janela de graça, 15 minutos por padrão, que você pode alterar com [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/pt/self-hosted-environments-reference#environment-variable-only-settings):

833 833 

153}153}

154```154```

155 155 

156Use `last_poll_age_ms` como um sinal de vivacidade em sondas personalizadas; um valor que cresce sem limite indica que o loop de pesquisa está preso. Tanto `last_poll_at` quanto `last_poll_age_ms` são `null` até a primeira pesquisa ser concluída.156Configure alertas com base em `last_poll_age_ms`, mas não o use em uma sonda de vivacidade; mantenha essa sonda no código de status HTTP. O valor é o tempo desde a última pesquisa bem-sucedida, portanto ele também aumenta enquanto o executor não consegue alcançar a Anthropic. Tanto `last_poll_at` quanto `last_poll_age_ms` são `null` até a primeira pesquisa ser bem-sucedida. Para detectar pesquisas que falham desde o início, configure também alertas em `claude_code_self_hosted_runner_poll_errors_total`, listada em [métricas do Prometheus](#prometheus-metrics).

157 157 

158O próprio `/healthz` do orquestrador, em sua porta de saúde, sempre retorna `200`. O corpo carrega um campo `connected` relatando se a pesquisa mais recente foi bem-sucedida, mais contagens de fila de geração por estado em `queue_counts`. Para ver por que `connected` é `false`, leia o campo de nível superior `last_error`, que cada pesquisa bem-sucedida redefine para `null`. Controle prontidão e alertas em `connected` em vez do código de status.158O próprio `/healthz` do orquestrador, em sua porta de saúde, sempre retorna `200`. O corpo carrega um campo `connected` relatando se a pesquisa mais recente foi bem-sucedida, mais contagens de fila de geração por estado em `queue_counts`. Para ver por que `connected` é `false`, leia o campo de nível superior `last_error`, que cada pesquisa bem-sucedida redefine para `null`. Controle prontidão e alertas em `connected` em vez do código de status.

159 159 

313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/pt/settings-reference#automode-classifyallshell) | `true` de `~/.claude/settings.json` ou `--settings` | Respeitado mesmo quando uma fonte gerenciada define `false` |313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/pt/settings-reference#automode-classifyallshell) | `true` de `~/.claude/settings.json` ou `--settings` | Respeitado mesmo quando uma fonte gerenciada define `false` |

314| [`remoteControlAtStartup`](https://code.claude.com/docs/pt/settings-reference#remotecontrolatstartup) | `false` de `.claude/settings.json` ou `.claude/settings.local.json` | Respeitado mesmo quando uma fonte gerenciada define `true`; um `true` de projeto ou local é ignorado |314| [`remoteControlAtStartup`](https://code.claude.com/docs/pt/settings-reference#remotecontrolatstartup) | `false` de `.claude/settings.json` ou `.claude/settings.local.json` | Respeitado mesmo quando uma fonte gerenciada define `true`; um `true` de projeto ou local é ignorado |

315| [`crossSessionInbound`](https://code.claude.com/docs/pt/settings-reference#crosssessioninbound) | Um valor mais restritivo de `.claude/settings.json` ou `.claude/settings.local.json`, na escala `accept` \< `hold` \< `refuse` | Respeitado sobre valores gerenciados, de `--settings` e de usuário; um valor de projeto ou local que não seja mais restritivo é ignorado |315| [`crossSessionInbound`](https://code.claude.com/docs/pt/settings-reference#crosssessioninbound) | Um valor mais restritivo de `.claude/settings.json` ou `.claude/settings.local.json`, na escala `accept` \< `hold` \< `refuse` | Respeitado sobre valores gerenciados, de `--settings` e de usuário; um valor de projeto ou local que não seja mais restritivo é ignorado |

316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/pt/settings-reference#useautomodeduringplan) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respeitado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado |316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/pt/settings-reference#useautomodeduringplan) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respeitado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado. Consulte [a entrada da chave](https://code.claude.com/docs/pt/settings-reference.md#useautomodeduringplan) para um arquivo que você omite na inicialização |

317| [`syncClaudeAiSkills`](https://code.claude.com/docs/pt/settings-reference#syncclaudeaiskills) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respeitado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado |317| [`syncClaudeAiSkills`](https://code.claude.com/docs/pt/settings-reference#syncclaudeaiskills) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respeitado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado |

318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/pt/settings-reference#syncclaudeaiplugins) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respeitado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado |318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/pt/settings-reference#syncclaudeaiplugins) | `false` de qualquer fonte gerenciada, `--settings`, `~/.claude/settings.json` ou `.claude/settings.local.json` | Respeitado mesmo quando a fonte gerenciada vencedora define `true`; um `false` em `.claude/settings.json` é ignorado |

319| [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel) | Um limite mais baixo de qualquer escopo, incluindo `--settings` | Respeitado mesmo quando as configurações gerenciadas que o Claude Code aplica definem um limite mais alto; o limite mais baixo se aplica. Requer Claude Code v2.1.267 ou posterior |319| [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel) | Um limite mais baixo de qualquer escopo, incluindo `--settings` | Respeitado mesmo quando as configurações gerenciadas que o Claude Code aplica definem um limite mais alto; o limite mais baixo se aplica. Requer Claude Code v2.1.267 ou posterior |

925Escolha se Claude Code usa o classificador do modo automático para revisar comandos de shell no modo de planejamento. Com o padrão `true`, o classificador revisa cada comando durante o planejamento quando o modo automático está disponível e você não vê nenhum prompt, exceto para [remoções de caminho crítico](https://code.claude.com/docs/pt/permission-modes.md#critical-paths). Defina `false` para obter um prompt de permissão para cada comando fora do conjunto integrado somente leitura. Aparece em `/config` como **Use auto mode during plan**.925Escolha se Claude Code usa o classificador do modo automático para revisar comandos de shell no modo de planejamento. Com o padrão `true`, o classificador revisa cada comando durante o planejamento quando o modo automático está disponível e você não vê nenhum prompt, exceto para [remoções de caminho crítico](https://code.claude.com/docs/pt/permission-modes.md#critical-paths). Defina `false` para obter um prompt de permissão para cada comando fora do conjunto integrado somente leitura. Aparece em `/config` como **Use auto mode during plan**.

926 926 

927* **Escopo**: [`User, local, or managed`](#scopes). Um repositório não pode desativá-lo para você.927* **Escopo**: [`User, local, or managed`](#scopes). Um repositório não pode desativá-lo para você.

928 * Um `false` em qualquer um desses arquivos ou em `--settings` o desativa, a menos que você deixe esse arquivo de usuário ou local de fora com uma opção como [`--setting-sources`](https://code.claude.com/docs/pt/cli-reference#cli-flags). Ignorar um arquivo deixado de fora requer Claude Code v2.1.314 ou posterior

928* **Tipo**: Booleano929* **Tipo**: Booleano

929 * `true`: o mesmo que não definido; quando o modo automático está disponível, o classificador revisa cada comando de shell durante o planejamento em vez de solicitar a você, exceto [remoções de caminho crítico](https://code.claude.com/docs/pt/permission-modes.md#critical-paths). Um `false` em qualquer um desses arquivos ainda o desativa930 * `true`: o mesmo que não definido; quando o modo auto está disponível, o classificador revisa comandos de shell durante o planejamento

930 * `false`: você obtém um prompt de permissão para cada comando fora do conjunto integrado somente leitura931 * `false`: você obtém um prompt de permissão para cada comando fora do conjunto integrado somente leitura

931* **Padrão**: `true`932* **Padrão**: `true`

932 933 

2073 2074 

2074### `sandbox.network.allowMachLookup`2075### `sandbox.network.allowMachLookup`

2075 2076 

2076Liste nomes de serviço XPC e Mach adicionais que o sandbox macOS pode procurar. Ferramentas que se comunicam sobre XPC, como o iOS Simulator ou Playwright, precisam de seus serviços listados aqui.2077Lista nomes adicionais de serviços XPC e Mach que o sandbox do macOS pode consultar. Ferramentas que se comunicam via XPC, como o iOS Simulator ou o Playwright, precisam que seus serviços estejam listados aqui. Os comandos em sandbox podem alcançar, fora do sandbox, cada serviço que você listar, e o sandbox [não restringe o que esses serviços fazem para esses comandos](https://code.claude.com/docs/pt/sandboxing.md#security-limitations).

2077 2078 

2078* **Scope**: [`Any file`](#scopes), com [limites em configurações de projeto e locais](https://code.claude.com/docs/pt/sandboxing.md#repository-settings-under-an-admin-required-sandbox)2079* **Scope**: [`Any file`](#scopes), com [limites em configurações de projeto e locais](https://code.claude.com/docs/pt/sandboxing.md#repository-settings-under-an-admin-required-sandbox)

2079* **Type**: array de strings, cada um um nome de serviço; um único `*` final corresponde a um prefixo e `"*"` sozinho corresponde a cada serviço2080* **Type**: array de strings, cada um um nome de serviço; um único `*` final corresponde a um prefixo e `"*"` sozinho corresponde a cada serviço

2422 2423 

2423 Ignorar este grupo em configurações de projeto e locais requer o Claude Code v2.1.282 ou posterior.2424 Ignorar este grupo em configurações de projeto e locais requer o Claude Code v2.1.282 ou posterior.

2424 * Variáveis que alteram como o Claude Code inicia ou sincroniza, como `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` e `CLAUDE_CODE_PLUGIN_SEED_DIR`.2425 * Variáveis que alteram como o Claude Code inicia ou sincroniza, como `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` e `CLAUDE_CODE_PLUGIN_SEED_DIR`.

2426 * Variáveis que definem o seu login no claude.ai, como [`CLAUDE_CODE_OAUTH_TOKEN`, `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` e `CLAUDE_CODE_OAUTH_SCOPES`](https://code.claude.com/docs/pt/env-vars#variables).

2425 * A variável do [modo de leitor de tela](https://code.claude.com/docs/pt/accessibility.md) `CLAUDE_AX_SCREEN_READER` e as outras variáveis cujos nomes começam com `CLAUDE_AX_`, como [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/pt/env-vars#variables).2427 * A variável do [modo de leitor de tela](https://code.claude.com/docs/pt/accessibility.md) `CLAUDE_AX_SCREEN_READER` e as outras variáveis cujos nomes começam com `CLAUDE_AX_`, como [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/pt/env-vars#variables).

2426 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars#variables), que define o temporizador de um diálogo não respondido.2428 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/pt/env-vars#variables), que define o temporizador de um diálogo não respondido.

2427 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/pt/env-vars#variables), que desativa o processamento de anexos.2429 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/pt/env-vars#variables), que desativa o processamento de anexos.

40>40>

41> **macOS, Linux, WSL:**41> **macOS, Linux, WSL:**

42>42>

43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}43> ```bash theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>

48>48>

49> **Windows PowerShell:**49> **Windows PowerShell:**

50>50>

51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}51> ```powershell theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD:**55> **Windows CMD:**

56>56>

57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}57> ```batch theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>

72 72 

73> [tab] Homebrew73> [tab] Homebrew

74>74>

75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}75> ```bash theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>

84 84 

85> [tab] WinGet85> [tab] WinGet

86>86>

87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}87> ```powershell theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>

416 416 

417Quando você pede ao Claude para executar um subagente que não seja um fork em um nível de esforço específico, ele também pode passar um parâmetro `effort` para essa invocação. O parâmetro sobrescreve o campo `effort` e permanece em vigor quando o subagente é [retomado](#resume-subagents). A variável de ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/pt/env-vars#variables) tem precedência sobre ambos. O parâmetro por invocação requer o Claude Code v2.1.292 ou posterior.417Quando você pede ao Claude para executar um subagente que não seja um fork em um nível de esforço específico, ele também pode passar um parâmetro `effort` para essa invocação. O parâmetro sobrescreve o campo `effort` e permanece em vigor quando o subagente é [retomado](#resume-subagents). A variável de ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/pt/env-vars#variables) tem precedência sobre ambos. O parâmetro por invocação requer o Claude Code v2.1.292 ou posterior.

418 418 

419#### Quando um subagente não tem campo ou parâmetro `effort`

420 

421No modelo da conversa principal, o subagente é executado no nível que você escolhe na sessão, como com `/effort`, ou define com `--effort`. Em outro modelo, [esse nível não se aplica](https://code.claude.com/docs/pt/model-config.md#effort-level-of-subagents-and-teammates). Para escolher o nível dele, defina o campo `effort`.

422 

419### Controlar as capacidades dos subagentes423### Controlar as capacidades dos subagentes

420 424 

421Você pode controlar o que os subagentes podem fazer por meio do acesso a ferramentas, dos modos de permissão e de regras condicionais.425Você pode controlar o que os subagentes podem fazer por meio do acesso a ferramentas, dos modos de permissão e de regras condicionais.

69 69 

70Com essa conexão, uma sessão pode clonar qualquer repositório público, mas pode trabalhar em um repositório privado apenas quando o Claude GitHub App está instalado nele. [Instale o Claude GitHub App](https://github.com/apps/claude/installations/new) em cada conta GitHub ou organização cujos repositórios privados você deseja usar. Em uma organização GitHub, um proprietário da organização pode precisar aprovar a instalação. Instalar o App também ativa [Auto-fix](https://code.claude.com/docs/pt/claude-code-on-the-web.md#auto-fix-pull-requests), que permite que Claude responda a falhas de CI e comentários de revisão em pull requests nesses repositórios.70Com essa conexão, uma sessão pode clonar qualquer repositório público, mas pode trabalhar em um repositório privado apenas quando o Claude GitHub App está instalado nele. [Instale o Claude GitHub App](https://github.com/apps/claude/installations/new) em cada conta GitHub ou organização cujos repositórios privados você deseja usar. Em uma organização GitHub, um proprietário da organização pode precisar aprovar a instalação. Instalar o App também ativa [Auto-fix](https://code.claude.com/docs/pt/claude-code-on-the-web.md#auto-fix-pull-requests), que permite que Claude responda a falhas de CI e comentários de revisão em pull requests nesses repositórios.

71 71 

72Quando você se conecta, Claude também vincula as contas GitHub que você possui à sua organização Claude, se elas tiverem o Claude GitHub App instalado. Em planos Team e Enterprise, os administradores veem essas contas na [lista de contas GitHub conectadas](https://code.claude.com/docs/pt/admin-setup.md#connected-github-accounts).72Quando você se conecta, Claude também vincula as contas GitHub que você possui à sua organização Claude, se elas tiverem o Claude GitHub App instalado. Em planos Team e Enterprise, os Owners da sua organização Claude veem essas contas na [lista de contas GitHub conectadas](https://code.claude.com/docs/pt/admin-setup.md#connected-github-accounts).

73 73 

74Se a integração solicitar que você instale o Claude GitHub App neste ponto e você preferir fazer isso mais tarde, clique em **Skip**.74Se a integração solicitar que você instale o Claude GitHub App neste ponto e você preferir fazer isso mais tarde, clique em **Skip**.

75 75