SpyBara
Go Premium

Documentation 2026-11-08 22:58 UTC to 2026-11-09 23:02 UTC

35 files changed +451 −119. View all changes and history on the product overview
2026
Thu 12 21:00 Wed 11 22:59 Tue 10 21:57 Mon 9 23:02 Sun 8 22:58 Sat 7 23:58 Fri 6 23:01 Thu 5 23:03 Wed 4 23:59 Tue 3 23:58 Mon 2 23:57 Sun 1 23:57

advisor.md +4 −3

Details

98| Opus 4.7 ou Opus 4.8 | Fable, Opus 4.7 ou posterior, Sonnet 5.5 |98| Opus 4.7 ou Opus 4.8 | Fable, Opus 4.7 ou posterior, Sonnet 5.5 |

99| Sonnet 5.5 | Fable, Opus 5 ou posterior, Sonnet 5.5 |99| Sonnet 5.5 | Fable, Opus 5 ou posterior, Sonnet 5.5 |

100| Opus 5 ou Opus 5.5 | Fable, Opus 5 ou posterior |100| Opus 5 ou Opus 5.5 | Fable, Opus 5 ou posterior |

101| Fable 5 | Fable 5.1 ou Fable 5 |101| Fable 5 | Fable 5.2, Fable 5.1 ou Fable 5 |

102| Fable 5.1 | Fable 5.1 |102| Fable 5.1 | Fable 5.2 ou Fable 5.1 |

103| Fable 5.2 | Fable 5.2 |

103 104 

104Fable 5.1 requer Claude Code v2.1.257 ou posterior. Os modelos Fable requerem [acesso a Fable](https://code.claude.com/docs/pt/model-config.md#work-with-fable). Sonnet 5.5 como advisor para um modelo principal Opus 4.7 ou Opus 4.8 requer Claude Code v2.1.287 ou posterior. Haiku 5.5 como modelo principal ou como advisor requer Claude Code v2.1.293 ou posterior.105Fable 5.2 requer Claude Code v2.1.321 ou posterior, e Fable 5.1 requer v2.1.257 ou posterior. Os modelos Fable requerem [acesso a Fable](https://code.claude.com/docs/pt/model-config.md#work-with-fable). Sonnet 5.5 como advisor para um modelo principal Opus 4.7 ou Opus 4.8 requer Claude Code v2.1.287 ou posterior. Haiku 5.5 como modelo principal ou como advisor requer Claude Code v2.1.293 ou posterior.

105 106 

106Defina o advisor como `fable`, `opus`, ou `sonnet`. Esses aliases resolvem para a [versão padrão integrada](https://code.claude.com/docs/pt/model-config.md#model-aliases) do Claude Code para cada família de modelos, que avança com novos lançamentos do Claude Code. Você também pode passar um ID de modelo completo como `claude-opus-5-5` ou `claude-haiku-5-5`. Haiku 4.5 pode chamar o advisor, mas não pode atuar como um.107Defina o advisor como `fable`, `opus`, ou `sonnet`. Esses aliases resolvem para a [versão padrão integrada](https://code.claude.com/docs/pt/model-config.md#model-aliases) do Claude Code para cada família de modelos, que avança com novos lançamentos do Claude Code. Você também pode passar um ID de modelo completo como `claude-opus-5-5` ou `claude-haiku-5-5`. Haiku 4.5 pode chamar o advisor, mas não pode atuar como um.

107 108 

Details

56 56 

57### Exemplo de ferramenta de clima57### Exemplo de ferramenta de clima

58 58 

59Este exemplo define uma ferramenta `get_temperature` e a envolve em um servidor MCP, sem passar o servidor para `query`. Para executar a ferramenta, veja [Chamar uma ferramenta personalizada](#call-a-custom-tool) abaixo.59Este exemplo define uma ferramenta `get_temperature` e a envolve em um servidor MCP, sem passar o servidor para `query`. Para executar a ferramenta, veja [Chamar uma ferramenta personalizada](#call-a-custom-tool).

60 60 

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

62from typing import Annotated, Any62from typing import Annotated, Any


148* **TypeScript**: adicione `.optional()` ao campo Zod.148* **TypeScript**: adicione `.optional()` ao campo Zod.

149* **Python**: o esquema de dicionário exige todas as chaves. Use a forma JSON Schema, deixe o parâmetro fora de `required` e leia-o com `args.get()`. Para um esquema tipado com chaves opcionais, veja [classe TypedDict](https://code.claude.com/docs/pt/agent-sdk/python.md#input-schema-options).149* **Python**: o esquema de dicionário exige todas as chaves. Use a forma JSON Schema, deixe o parâmetro fora de `required` e leia-o com `args.get()`. Para um esquema tipado com chaves opcionais, veja [classe TypedDict](https://code.claude.com/docs/pt/agent-sdk/python.md#input-schema-options).

150 150 

151A ferramenta [`get_precipitation_chance` abaixo](#add-more-tools) mostra ambos os padrões.151A [ferramenta `get_precipitation_chance`](#add-more-tools) mostra ambos os padrões.

152 152 

153### Chamar uma ferramenta personalizada153### Chamar uma ferramenta personalizada

154 154 

155Passe o servidor MCP que você criou para `query` via a opção `mcpServers` e liste o [nome totalmente qualificado](https://code.claude.com/docs/pt/agent-sdk/mcp.md#tool-naming-convention) de cada ferramenta em `allowedTools` para que a ferramenta seja executada sem um prompt de permissão. Esse nome é `mcp__{server_name}__{tool_name}`, onde `{server_name}` é a chave que você atribui ao servidor em `mcpServers`. Se a chave contiver caracteres como `.` ou espaços, substitua-os por `_` ao escrever `{server_name}`.155Para chamar uma ferramenta personalizada, siga estes passos:

156 

1571. Passe o servidor MCP que você criou para `query` usando a opção `mcpServers`.

1582. Liste o [nome totalmente qualificado](https://code.claude.com/docs/pt/agent-sdk/mcp.md#tool-naming-convention) da ferramenta em `allowedTools` para [pré-aprovar](https://code.claude.com/docs/pt/agent-sdk/permissions.md#allow-and-deny-rules) suas chamadas. Esse nome segue a convenção `mcp__{server_name}__{tool_name}`, onde `{server_name}` é a chave que você atribui ao servidor em `mcpServers`. Se a chave contiver caracteres como `.` ou espaços, substitua-os por `_` ao escrever `{server_name}`.

156 159 

157Estes trechos reutilizam o `weatherServer` do [exemplo de ferramenta de clima](#weather-tool-example) para perguntar a Claude qual é o clima em um local específico.160Estes trechos reutilizam o `weatherServer` do [exemplo de ferramenta de clima](#weather-tool-example) para perguntar a Claude qual é o clima em um local específico.

158 161 


329| :- | :- | :- |332| :- | :- | :- |

330| `readOnlyHint` | `false` | A ferramenta não modifica seu ambiente. Controla se a ferramenta pode ser chamada em paralelo com outras ferramentas somente leitura. |333| `readOnlyHint` | `false` | A ferramenta não modifica seu ambiente. Controla se a ferramenta pode ser chamada em paralelo com outras ferramentas somente leitura. |

331| `destructiveHint` | `true` | A ferramenta pode realizar atualizações destrutivas. Defina-o explicitamente como `true` em qualquer ferramenta que você [marcar como `always_ask`](#require-approval-for-specific-tools). |334| `destructiveHint` | `true` | A ferramenta pode realizar atualizações destrutivas. Defina-o explicitamente como `true` em qualquer ferramenta que você [marcar como `always_ask`](#require-approval-for-specific-tools). |

332| `idempotentHint` | `false` | Chamadas repetidas com os mesmos argumentos não têm efeito adicional. Apenas informativo. |335| `idempotentHint` | `false` | Chamadas repetidas com os mesmos argumentos não têm efeito adicional. |

333| `openWorldHint` | `true` | A ferramenta alcança sistemas fora de seu processo. Apenas informativo. |336| `openWorldHint` | `true` | A ferramenta alcança sistemas fora de seu processo. |

334 337 

335Anotações são metadados, não imposição. Uma ferramenta marcada com `readOnlyHint: true` ainda pode escrever em disco se isso for o que o manipulador faz. Mantenha a anotação precisa em relação ao manipulador.338Anotações são metadados, não imposição. Uma ferramenta marcada com `readOnlyHint: true` ainda pode escrever em disco se isso for o que o manipulador faz. Mantenha a anotação precisa em relação ao manipulador.

336 339 


373 376 

374### Configurar ferramentas permitidas377### Configurar ferramentas permitidas

375 378 

376A opção `tools` e as listas de permitidas/não permitidas afetam duas camadas: disponibilidade, que controla se uma ferramenta aparece no contexto do Claude, e permissão, que controla se uma chamada é aprovada uma vez que Claude tenta usá-la. `tools` e entradas `disallowedTools` com nome simples alteram a disponibilidade. `allowedTools` e regras `disallowedTools` com escopo alteram a permissão. Se você nomear uma das [ferramentas de rastreamento de tarefas](https://code.claude.com/docs/pt/agent-sdk/todo-tracking.md#model-availability) em `allowedTools`, Claude Code também as habilita na sessão.379Você controla duas camadas com as opções `tools`, `allowedTools` e `disallowedTools`:

380 

381* **Disponibilidade**: se uma ferramenta aparece no contexto do Claude. Para alterá-la, use a opção `tools` ou liste um nome simples de ferramenta integrada, como `"Bash"`, em `disallowedTools`.

382* **Permissão**: se Claude Code aprova uma chamada quando Claude a faz. Para alterá-la, use `allowedTools` ou uma regra `disallowedTools` com escopo, como `"Bash(rm *)"`.

377 383 

378| Opção | Camada | Efeito |384| Opção | Camada | Efeito |

379| :- | :- | :- |385| :- | :- | :- |

380| `tools: ["Read", "Grep"]` | Disponibilidade | Apenas as ferramentas integradas listadas estão no contexto do Claude. As ferramentas integradas não listadas são removidas. As ferramentas MCP não são afetadas. |386| `tools: ["Read", "Grep"]` | Disponibilidade | Apenas as ferramentas integradas listadas estão no contexto do Claude. As ferramentas integradas não listadas são removidas. As ferramentas MCP não são afetadas. |

381| `tools: []` | Disponibilidade | Todas as ferramentas integradas são removidas. Claude pode usar apenas suas ferramentas MCP. |387| `tools: []` | Disponibilidade | Todas as ferramentas integradas são removidas. Claude pode usar apenas suas ferramentas MCP. |

382| ferramentas permitidas | Permissão | As ferramentas listadas são executadas sem um prompt de permissão. Outras ferramentas não listadas permanecem disponíveis; as chamadas passam pelo [fluxo de permissão](https://code.claude.com/docs/pt/agent-sdk/permissions.md). |388| ferramentas permitidas | Permissão | As ferramentas listadas são pré-aprovadas, exceto pelas [chamadas que nenhuma regra de permissão aprova](https://code.claude.com/docs/pt/agent-sdk/permissions.md#calls-an-allow-rule-never-approves). As chamadas a ferramentas que você deixa fora da lista passam pelo [fluxo de permissão](https://code.claude.com/docs/pt/agent-sdk/permissions.md). |

383| ferramentas não permitidas | Ambas | Um nome de ferramenta simples como `"Bash"` remove a ferramenta do contexto do Claude, o mesmo que omiti-la de `tools`. Uma regra com escopo como `"Bash(rm *)"` deixa a ferramenta no contexto e nega apenas as chamadas correspondentes [conforme escrito](https://code.claude.com/docs/pt/permissions.md#bash-rule-limits). |389| ferramentas não permitidas | Ambas | Um nome simples de ferramenta integrada como `"Bash"` remove a ferramenta do contexto do Claude. Uma regra com escopo como `"Bash(rm *)"` deixa a ferramenta no contexto e nega as chamadas correspondentes [conforme escrito](https://code.claude.com/docs/pt/permissions.md#bash-rule-limits). |

384 390 

385Para remover uma ferramenta integrada completamente, omita-a de `tools` ou liste seu nome simples em `disallowedTools` (Python: `disallowed_tools`); ambas mantêm a ferramenta fora do contexto para que Claude nunca tente usá-la. Uma regra `disallowedTools` com escopo bloqueia as chamadas correspondentes, mas deixa a ferramenta visível, então Claude pode desperdiçar um turno tentando usá-la. Consulte [Configurar permissões](https://code.claude.com/docs/pt/agent-sdk/permissions.md) para a ordem de avaliação completa.391Para remover uma ferramenta integrada do contexto do Claude, omita-a de `tools` ou liste seu nome simples em `disallowedTools` (TypeScript) ou `disallowed_tools` (Python). Para a ordem de avaliação completa, consulte [Configurar permissões](https://code.claude.com/docs/pt/agent-sdk/permissions.md#how-permissions-are-evaluated).

386 392 

387### Exigir aprovação para ferramentas específicas393### Exigir aprovação para ferramentas específicas

388 394 


637 643 

638## Retornar dados estruturados644## Retornar dados estruturados

639 645 

640`structuredContent` é um objeto JSON opcional no resultado, separado do array `content`. Use-o para retornar valores brutos que Claude possa ler como campos exatos em vez de analisá-los de uma string de texto ou imagem.646`structuredContent` é um objeto JSON opcional no resultado, separado do array `content`. Use-o para retornar valores brutos que Claude possa ler como campos exatos em vez de analisá-los de uma string de texto ou imagem. Para manipuladores Python, consulte [Conteúdo estruturado em Python](#structured-content-in-python).

641 647 

642Quando `structuredContent` é definido, Claude recebe o JSON mais qualquer bloco de imagem ou recurso de `content`. Blocos de texto em `content` não são encaminhados, pois presume-se que duplicam os dados estruturados. O exemplo abaixo renderiza um gráfico como um bloco de imagem e retorna os pontos de dados por trás dele em `structuredContent` do mesmo manipulador. No trecho, `chartPngBuffer` é um `Buffer` contendo os bytes PNG renderizados.648Quando um manipulador `tool()` em TypeScript define `structuredContent`, Claude recebe o JSON mais os blocos de imagem e recurso em `content`, e os blocos de texto em `content` não chegam a Claude. O exemplo abaixo renderiza um gráfico como um bloco de imagem e retorna os pontos de dados por trás dele em `structuredContent` do mesmo manipulador. No trecho, `chartPngBuffer` é um `Buffer` contendo os bytes PNG renderizados.

643 649 

644```typescript TypeScript theme={null}650```typescript TypeScript theme={null}

645return {651return {

Details

205 205 

206### Auto-aprovação com allowedTools206### Auto-aprovação com allowedTools

207 207 

208Use `allowedTools` para auto-aprovar ferramentas MCP específicas para que Claude possa usá-las sem um prompt de permissão:208Use `allowedTools` para auto-aprovar ferramentas MCP específicas:

209 209 

210```typescript TypeScript hidelines={1,-1} theme={null}210```typescript TypeScript hidelines={1,-1} theme={null}

211const _ = {211const _ = {

Details

18 18 

19**1. Hooks**19**1. Hooks**

20 20 

21Execute [hooks](https://code.claude.com/docs/pt/agent-sdk/hooks.md). Um hook pode negar a chamada completamente ou passá-la adiante. Um hook que retorna `allow` não ignora as regras de negação e pergunta abaixo; essas são avaliadas independentemente do resultado do hook.21Execute [hooks](https://code.claude.com/docs/pt/agent-sdk/hooks.md). Um hook pode negar a chamada completamente ou passá-la adiante. Um hook que retorna `allow` não ignora as etapas de regras de negação e de regras de pergunta, que são avaliadas independentemente do resultado do hook.

22 22 

23Um hook `PreToolUse` que retorna `allow` também não pode aprovar um comando `rm` ou `rmdir` cujo alvo Claude Code reconhece como um [caminho crítico](https://code.claude.com/docs/pt/permission-modes.md#critical-paths), como `rm -rf ~`. Para saber o que esse `allow` faz no 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).23Um hook `PreToolUse` que retorna `allow` também não pode aprovar um comando `rm` ou `rmdir` cujo alvo Claude Code reconhece como um [caminho crítico](https://code.claude.com/docs/pt/permission-modes.md#critical-paths), como `rm -rf ~`. Para saber o que esse `allow` faz no 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).

24 24 


58 58 

59**6. Callback canUseTool**59**6. Callback canUseTool**

60 60 

61Se não for resolvido por nenhum dos anteriores, chame seu callback [`canUseTool`](https://code.claude.com/docs/pt/agent-sdk/user-input) para uma decisão. No modo `dontAsk`, esta etapa é ignorada e a ferramenta é negada, embora um [mod](https://code.claude.com/docs/pt/plugins/mods/overview.md) que você instalou ainda possa aprovar [algumas dessas chamadas](https://code.claude.com/docs/pt/permissions.md#precedence-among-rules-hooks-and-mods).61Se nenhuma etapa anterior resolver a requisição, chame seu [callback `canUseTool`](https://code.claude.com/docs/pt/agent-sdk/user-input) para uma decisão. No modo `dontAsk`, esta etapa é ignorada e a ferramenta é negada, embora um [mod](https://code.claude.com/docs/pt/plugins/mods/overview.md) que você instalou ainda possa aprovar [algumas dessas chamadas](https://code.claude.com/docs/pt/permissions.md#precedence-among-rules-hooks-and-mods).

62 62 

63No SDK TypeScript, se você definir [`permissionPrompts: 'none'`](https://code.claude.com/docs/pt/agent-sdk/typescript#options), seu callback não é chamado nesta etapa. Um hook [`PermissionRequest`](https://code.claude.com/docs/pt/hooks#permissionrequest) ainda tem a chance de decidir, e se não decidir, Claude Code nega a chamada. A opção requer Claude Code v2.1.259 ou posterior.63No SDK TypeScript, se você definir [`permissionPrompts: 'none'`](https://code.claude.com/docs/pt/agent-sdk/typescript#options), seu callback não é chamado nesta etapa. Um hook [`PermissionRequest`](https://code.claude.com/docs/pt/hooks#permissionrequest) ainda tem a chance de decidir, e se não decidir, Claude Code nega a chamada. A opção requer Claude Code v2.1.259 ou posterior.

64 64 


80 80 

81## Regras de permissão e negação81## Regras de permissão e negação

82 82 

83`allowed_tools` e `disallowed_tools` (TypeScript: `allowedTools` / `disallowedTools`) adicionam entradas às listas de regras de permissão e negação no fluxo de avaliação acima. Se você nomear uma das [ferramentas de rastreamento de tarefas](https://code.claude.com/docs/pt/agent-sdk/todo-tracking.md#model-availability) em `allowed_tools`, Claude Code também as habilita na sessão. Qualquer outra ferramenta não listada em `allowed_tools` ainda está disponível para Claude, e uma chamada a ela que precisa de aprovação passa para o modo de permissão. As regras de negação se comportam de forma diferente dependendo se nomeiam uma ferramenta ou definem um padrão dentro de uma.83Quando você define `allowedTools` e `disallowedTools` (TypeScript) ou `allowed_tools` e `disallowed_tools` (Python), Claude Code adiciona suas entradas às listas de regras de permissão e negação no [fluxo de avaliação de permissões](#how-permissions-are-evaluated). Qualquer outra ferramenta não listada em `allowed_tools` ainda está disponível para Claude, e uma chamada a ela que precisa de aprovação passa para o modo de permissão.

84 84 

85| Opção | Efeito |85| Opção | Efeito |

86| :- | :- |86| :- | :- |

87| `allowed_tools=["Read", "Grep"]` | `Read` e `Grep` são aprovadas automaticamente, exceto por [leituras de caminhos de rede](https://code.claude.com/docs/pt/permissions.md#network-paths). Outras ferramentas não listadas aqui ainda existem, e chamadas a elas que precisam de aprovação passam para o modo de permissão e `canUseTool`. |87| `allowed_tools=["Read", "Grep"]` | `Read` e `Grep` são aprovadas automaticamente, exceto por [leituras de caminhos de rede](https://code.claude.com/docs/pt/permissions.md#network-paths). Outras ferramentas não listadas aqui ainda existem, e chamadas a elas que precisam de aprovação passam para o modo de permissão e `canUseTool`. |

88| `disallowed_tools=["Bash"]` | A definição da ferramenta `Bash` é removida da solicitação. Claude não vê a ferramenta e não pode tentar usá-la. |88| `disallowed_tools=["Bash"]` | A definição da ferramenta `Bash` é removida da requisição. |

89| `disallowed_tools=["Bash(rm *)"]` | `Bash` permanece disponível. Chamadas correspondentes a `rm *` [conforme escrito](https://code.claude.com/docs/pt/permissions.md#bash-rule-limits) são negadas em todos os modos de permissão, incluindo `bypassPermissions`. Outras chamadas `Bash`, incluindo `/bin/rm`, passam para o modo de permissão. |89| `disallowed_tools=["Bash(rm *)"]` | `Bash` permanece disponível. Chamadas correspondentes a `rm *` [conforme escrito](https://code.claude.com/docs/pt/permissions.md#bash-rule-limits) são negadas em todos os modos de permissão, incluindo `bypassPermissions`. Outras chamadas `Bash`, incluindo `/bin/rm`, passam para o modo de permissão. |

90| `disallowed_tools=["*"]` | Toda definição de ferramenta é removida da solicitação. Globs de nome de ferramenta são suportados em regras de negação: `"*"` corresponde a todas as ferramentas e `"mcp__*"` corresponde a todas as ferramentas MCP em todos os servidores. |90| `disallowed_tools=["*"]` | Globs de nome de ferramenta são suportados em regras de negação: `"*"` corresponde a todas as ferramentas e `"mcp__*"` corresponde a todas as ferramentas MCP em todos os servidores. |

91 91 

92As regras de permissão aceitam globs de nome de ferramenta apenas após um prefixo literal `mcp__<server>__`. O segmento do servidor deve estar livre de glob para que a regra nomeie um servidor específico que você configurou: `mcp__puppeteer__*` corresponde a todas as ferramentas do servidor `puppeteer`, e `mcp__github__get_*` corresponde às suas ferramentas `get_`. Uma entrada não ancorada como `allowed_tools=["*"]` ou `allowed_tools=["mcp__*"]` é ignorada e não aprova automaticamente nada.92As regras de permissão aceitam globs de nome de ferramenta apenas após um prefixo literal `mcp__<server>__`. O segmento do servidor deve estar livre de glob para que a regra nomeie um servidor específico que você configurou: `mcp__puppeteer__*` corresponde a todas as ferramentas do servidor `puppeteer`, e `mcp__github__get_*` corresponde às suas ferramentas `get_`. Uma entrada não ancorada como `allowed_tools=["*"]` ou `allowed_tools=["mcp__*"]` é ignorada e não aprova automaticamente nada.

93 93 

Details

2787 2787 

2788Executa uma fonte em segundo plano e entrega cada evento para Claude para que ele possa reagir sem polling: `command` executa um script e emite um evento por linha stdout, e `ws` abre um WebSocket e emite um evento por frame de texto. Forneça exatamente um de `command` ou `ws`.2788Executa uma fonte em segundo plano e entrega cada evento para Claude para que ele possa reagir sem polling: `command` executa um script e emite um evento por linha stdout, e `ws` abre um WebSocket e emite um evento por frame de texto. Forneça exatamente um de `command` ou `ws`.

2789 2789 

2790Quando Monitor executa um comando, ele segue as mesmas regras de permissão que Bash; uma observação de WebSocket solicita aprovação separadamente. A fonte `ws` requer Claude Code v2.1.195 ou posterior. Veja a [referência da ferramenta Monitor](https://code.claude.com/docs/pt/tools-reference.md#monitor-tool) para comportamento e disponibilidade de provedor.2790A fonte `ws` requer Claude Code v2.1.195 ou posterior. Quando Monitor executa um comando, ele segue as mesmas regras de permissão que Bash. Veja a [referência da ferramenta Monitor](https://code.claude.com/docs/pt/tools-reference.md#monitor-tool) para permissões de WebSocket, comportamento e disponibilidade de provedor.

2791 2791 

2792**Entrada:**2792**Entrada:**

2793 2793 

Details

3389 3389 

3390Executa uma fonte em segundo plano e entrega cada evento para Claude para que possa reagir sem polling: `command` executa um script e emite um evento por linha stdout, e `ws` abre um WebSocket e emite um evento por frame de texto. Forneça exatamente um de `command` ou `ws`. A fonte `ws` requer Claude Code v2.1.195 ou posterior.3390Executa uma fonte em segundo plano e entrega cada evento para Claude para que possa reagir sem polling: `command` executa um script e emite um evento por linha stdout, e `ws` abre um WebSocket e emite um evento por frame de texto. Forneça exatamente um de `command` ou `ws`. A fonte `ws` requer Claude Code v2.1.195 ou posterior.

3391 3391 

3392`timeout_ms` é o prazo do watch em milissegundos. O padrão é 300000 e aceita valores até 3600000. O prazo efetivo é no máximo 1800000, que é 30 minutos, então um valor aceito maior é encurtado para isso. No prazo, o watch termina e Claude recebe um aviso para que possa iniciar um novo watch se ainda precisar de um.3392`timeout_ms` é o prazo do watch em milissegundos:

3393 3393 

3394O tipo exportado marca `timeout_ms` como obrigatório porque o esquema preenche o padrão; uma chamada que o omite valida.3394* **Padrão e limites**: o padrão é 300000 e aceita valores até 3600000. O prazo efetivo é no máximo 1800000, que é 30 minutos, então um valor aceito maior é encurtado para isso

3395* **No prazo**: o watch termina e Claude recebe um aviso para que possa iniciar um novo watch se ainda precisar de um

3396* **Obrigatório no tipo**: o tipo exportado marca `timeout_ms` como obrigatório porque o esquema preenche o padrão; uma chamada que o omite valida

3395 3397 

3396Quando Monitor executa um comando, ele segue as mesmas regras de permissão que Bash; um watch de WebSocket solicita aprovação separadamente. Veja a [referência da ferramenta Monitor](https://code.claude.com/docs/pt/tools-reference.md#monitor-tool) para comportamento e disponibilidade de provedor.3398Quando Monitor executa um comando, ele segue as mesmas regras de permissão que Bash. Veja a [referência da ferramenta Monitor](https://code.claude.com/docs/pt/tools-reference.md#monitor-tool) para permissões de WebSocket, comportamento e disponibilidade de provedor.

3397 3399 

3398### TaskOutput3400### TaskOutput

3399 3401 

Details

433 433 

434### Altere o modelo e o esforço434### Altere o modelo e o esforço

435 435 

436O [esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) é o principal controle de quanto tempo Claude pensa, e substitui a maior parte do que as pessoas costumavam fazer com a formulação do prompt. Claude Opus 5.5, Sonnet 5.5 e Haiku 5.5 usam `medium` por padrão, o que é bastante para trabalho cotidiano de funcionalidades com escopo claro. As situações em que você o mudaria, com `/effort` na sessão:436O [esforço](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) é o principal controle de quanto tempo Claude pensa, e substitui a maior parte do que as pessoas costumavam fazer com a formulação do prompt. Claude Fable 5.2, Opus 5.5, Sonnet 5.5 e Haiku 5.5 usam `medium` por padrão, o que é bastante para trabalho cotidiano de funcionalidades com escopo claro. As situações em que você o mudaria, com `/effort` na sessão:

437 437 

438* Aumente com `/effort high` ou `/effort xhigh` quando acertar depende de casos fáceis de passar despercebidos. Pense em um bug em código que você não escreveu, um teste instável ou uma mudança de esquema em que Claude precisa encontrar todos os leitores do formato antigo. Claude então verifica mais casos extremos e valida mais do próprio trabalho antes de responder, e é aí que vão o tempo e os tokens extras.438* Aumente com `/effort high` ou `/effort xhigh` quando acertar depende de casos fáceis de passar despercebidos. Pense em um bug em código que você não escreveu, um teste instável ou uma mudança de esquema em que Claude precisa encontrar todos os leitores do formato antigo. Claude então verifica mais casos extremos e valida mais do próprio trabalho antes de responder, e é aí que vão o tempo e os tokens extras.

439* Diminua com `/effort low` quando você estiver indo e voltando rapidamente e revisando cada resultado de qualquer forma: brainstorming, um primeiro esboço, uma renomeação em alguns arquivos. Claude entrega um ponto de partida mais cedo e, como você está guiando cada passo, a deliberação extra não mudaria muito além da espera.439* Diminua com `/effort low` quando você estiver indo e voltando rapidamente e revisando cada resultado de qualquer forma: brainstorming, um primeiro esboço, uma renomeação em alguns arquivos. Claude entrega um ponto de partida mais cedo e, como você está guiando cada passo, a deliberação extra não mudaria muito além da espera.

440* Reserve `max` para um problema difícil que você quer que Claude resolva sem você, como caçar uma vulnerabilidade de segurança. Em tarefas comuns ele tende a pensar demais, então você paga mais por uma resposta que pode não ser melhor do que `high` teria dado.440* Reserve `max` para um problema difícil que você quer que Claude resolva sem você, como caçar uma vulnerabilidade de segurança. Em tarefas comuns ele tende a pensar demais, então você paga mais por uma resposta que pode não ser melhor do que `high` teria dado.

441* Quando só a próxima mensagem precisa disso, como uma pergunta complicada no meio de um trabalho de resto rotineiro, coloque [`ultrathink`](https://code.claude.com/docs/pt/model-config#use-ultrathink-for-one-off-deep-reasoning) nesse prompt em vez de alterar a configuração.441* Quando só a próxima mensagem precisa disso, como uma pergunta complicada no meio de um trabalho de resto rotineiro, coloque [`ultrathink`](https://code.claude.com/docs/pt/model-config#use-ultrathink-for-one-off-deep-reasoning) nesse prompt em vez de alterar a configuração.

442 442 

443Quanto ao modelo em si, o Opus 5.5 padrão lida bem com a maior parte da programação e o Sonnet custa menos em trabalho rotineiro. O [Claude Fable 5.1](https://code.claude.com/docs/pt/model-config.md#work-with-fable) está disponível quando você o seleciona explicitamente com `/model fable`, e o Haiku é uma boa opção para subagentes que fazem tarefas simples. [Configuração de modelo](https://code.claude.com/docs/pt/model-config.md) tem a lista completa por plano e provedor.443Quanto ao modelo em si, o Opus 5.5 padrão lida bem com a maior parte da programação e o Sonnet custa menos em trabalho rotineiro. Para usar o [Claude Fable 5.2](https://code.claude.com/docs/pt/model-config.md#work-with-fable), execute `/model fable`. O Haiku é uma boa opção para subagentes que fazem tarefas simples. [Configuração de modelo](https://code.claude.com/docs/pt/model-config.md) tem a lista completa por plano e provedor.

444 444 

445### Saiba quanto custam os subagentes445### Saiba quanto custam os subagentes

446 446 

Details

172 172 

173Uma inicialização bem-sucedida não valida o caminho de inferência, porque credenciais de instância do Amazon Bedrock e da Agent Platform do Google Cloud resolvem na primeira requisição, não na inicialização.173Uma inicialização bem-sucedida não valida o caminho de inferência, porque credenciais de instância do Amazon Bedrock e da Agent Platform do Google Cloud resolvem na primeira requisição, não na inicialização.

174 174 

175Observe stderr para a sequência de inicialização. As linhas de log usam o formato `[gateway] <timestamp> <level> <message>`, eventos de auditoria são JSON de linha única com um campo `evt`, e um banner de inicialização, omitido abaixo, é impresso entre as linhas de migração e escuta. Um banco de dados novo imprime uma linha `migration N applied` por migração de esquema; um banco de dados já migrado não imprime nenhuma. Você deve ver, em ordem:175Observe stderr para a sequência de inicialização. Por padrão, as linhas de log usam o formato `[gateway] <timestamp> <level> <message>`, e um banner de inicialização, omitido abaixo, é impresso entre as linhas de migração e escuta. Eventos de auditoria são JSON de linha única com um campo `evt`. Um banco de dados novo imprime uma linha `migration N applied` por migração de esquema; um banco de dados já migrado não imprime nenhuma. Você deve ver, em ordem:

176 176 

177```text theme={null}177```text theme={null}

178{"ts":"2026-06-10T17:03:21.114Z","evt":"config.load","path":"/etc/claude/gateway.yaml","sha256":"…"}178{"ts":"2026-06-10T17:03:21.114Z","evt":"config.load","path":"/etc/claude/gateway.yaml","sha256":"…"}

Details

28 28 

29**Seções opcionais:**29**Seções opcionais:**

30 30 

31* [`login_notice`](#login_notice): um aviso que os desenvolvedores veem ao fazer login

31* [`admin`](#admin): autenticação da API de administração e retenção para limites de gastos32* [`admin`](#admin): autenticação da API de administração e retenção para limites de gastos

32* [`enforcement`](#enforcement): comportamento de falha aberta ou fechada do limite de gastos33* [`enforcement`](#enforcement): comportamento de falha aberta ou fechada do limite de gastos

33* [`pricing`](#pricing): taxas contratadas e um multiplicador para o medidor de gastos e para os valores de custo que os desenvolvedores veem34* [`pricing`](#pricing): taxas contratadas e um multiplicador para o medidor de gastos e para os valores de custo que os desenvolvedores veem


847 848 

848## Seções opcionais849## Seções opcionais

849 850 

851### `login_notice`

852 

853Para mostrar aos desenvolvedores um aviso quando eles fizerem login, defina a chave de nível superior `login_notice` com o texto do aviso, de até 500 caracteres. Este exemplo informa a quem o gateway se destina e onde solicitar acesso:

854 

855```yaml theme={null}

856login_notice: This gateway is for Example Corp staff. For access questions, email it-help@example.com.

857```

858 

859Os desenvolvedores veem o texto abaixo de `Notice from <gateway hostname>` na página de verificação do gateway no navegador e na tela interativa de login no terminal. Quebras de linha no texto se tornam espaços. O aviso aparece antes do login, então qualquer pessoa que consiga acessar o gateway pode lê-lo.

860 

861Requer Claude Code v2.1.319 ou posterior no servidor do gateway e também na máquina do desenvolvedor para a tela do terminal. Um gateway anterior se recusa a iniciar quando encontra a chave. Atualize todas as réplicas antes de adicionar a chave e remova a chave antes de reverter para uma versão anterior.

862 

850### `admin`863### `admin`

851 864 

852Opcional. Habilita `/v1/organizations/spend_limits`, que espelha a Admin API pública da Anthropic, e a aplicação de limites de gastos por desenvolvedor em `/v1/messages`. Consulte [Limites de gastos](https://code.claude.com/docs/pt/claude-apps-gateway-spend-limits.md) para saber como os limites são definidos e aplicados; esta seção aborda as chaves do `gateway.yaml` que ativam o recurso e o ajustam.865Opcional. Habilita `/v1/organizations/spend_limits`, que espelha a Admin API pública da Anthropic, e a aplicação de limites de gastos por desenvolvedor em `/v1/messages`. Consulte [Limites de gastos](https://code.claude.com/docs/pt/claude-apps-gateway-spend-limits.md) para saber como os limites são definidos e aplicados; esta seção aborda as chaves do `gateway.yaml` que ativam o recurso e o ajustam.


865 # IdP groups granted full admin via the normal gateway JWT (no API key).878 # IdP groups granted full admin via the normal gateway JWT (no API key).

866 admin_groups: [platform-finops]879 admin_groups: [platform-finops]

867 blocked_message: request an increase at https://go.example.com/claude-limits880 blocked_message: request an increase at https://go.example.com/claude-limits

881 # Try eng-platform's pooled budget first, then eng-all's, then any other group's.

882 pooled_conflict_rule: priority_list

883 pooled_priority_order: [eng-platform, eng-all]

868```884```

869 885 

870| Campo | Obrigatório | Descrição |886| Campo | Obrigatório | Descrição |


877| `spend_retention_months` | Não | Padrão `13`. Linhas de contadores de `spend` mais antigas que isso são removidas. O padrão mantém um ano completo mais o mês parcial atual para relatórios ano a ano. |893| `spend_retention_months` | Não | Padrão `13`. Linhas de contadores de `spend` mais antigas que isso são removidas. O padrão mantém um ano completo mais o mês parcial atual para relatórios ano a ano. |

878| `identity_retention_days` | Não | Padrão `90`. TTL de última atividade para linhas de `principal_emails`, que contêm o e-mail, o nome de exibição e os grupos de cada desenvolvedor (PII). Deliberadamente mais curto que a retenção de gastos, para que uma identidade desprovisionada expire enquanto seus contadores de gastos anônimos permanecem. |894| `identity_retention_days` | Não | Padrão `90`. TTL de última atividade para linhas de `principal_emails`, que contêm o e-mail, o nome de exibição e os grupos de cada desenvolvedor (PII). Deliberadamente mais curto que a retenção de gastos, para que uma identidade desprovisionada expire enquanto seus contadores de gastos anônimos permanecem. |

879| `group_limit_mode` | Não | `min` (padrão) ou `max`. Quando um desenvolvedor está em vários grupos com limites, `min` aplica o mais restritivo e `max` o menos restritivo. Usado tanto pela aplicação quanto por `/effective`. |895| `group_limit_mode` | Não | `min` (padrão) ou `max`. Quando um desenvolvedor está em vários grupos com limites, `min` aplica o mais restritivo e `max` o menos restritivo. Usado tanto pela aplicação quanto por `/effective`. |

896| `pooled_conflict_rule` | Não | `default_order` (padrão) ou `priority_list`. A ordem em que o gateway tenta os orçamentos compartilhados de um desenvolvedor. Consulte [Ordem dos orçamentos compartilhados](#pooled-budget-order). Requer v2.1.319 ou posterior. |

897| `pooled_priority_order` | Com `priority_list` | Até 50 nomes de grupos, cada um listado uma vez e escrito como o seu IdP o envia. Os grupos cujos orçamentos compartilhados o gateway tenta primeiro. Consulte [Ordem dos orçamentos compartilhados](#pooled-budget-order). Requer v2.1.319 ou posterior. |

898 

899#### Ordem dos orçamentos compartilhados

900 

901Um orçamento compartilhado é um limite mensal contra o qual um grupo inteiro gasta. Para definir um, adicione `pooled_budget` à [requisição que define o limite mensal do grupo](https://code.claude.com/docs/pt/claude-apps-gateway-spend-limits.md#set-a-cap), como em `"pooled_budget": {"amount": "500000"}` para \$5.000. A requisição também recebe o `scope` do grupo, `"period": "monthly"` e `amount`, que continua sendo o limite individual de cada membro.

902 

903Para um desenvolvedor em vários desses grupos, cada requisição é contabilizada no primeiro orçamento cujo gasto esteja abaixo do limite, e é recusada quando todos os orçamentos estão esgotados. `pooled_conflict_rule` define a ordem em que o gateway tenta os orçamentos:

904 

905* **`default_order`**: o maior limite primeiro, e limites iguais em ordem crescente de nome de grupo

906* **`priority_list`**: os orçamentos dos grupos em `pooled_priority_order`, na ordem da lista, depois os orçamentos dos outros grupos por nome de grupo

907 

908Se você listar grupos sem `pooled_conflict_rule: priority_list`, o gateway ignora a lista e registra um aviso em log na inicialização.

909 

910Um servidor do gateway anterior à v2.1.319 se recusa a iniciar quando encontra `pooled_conflict_rule` ou `pooled_priority_order`. Atualize todas as réplicas antes de adicionar qualquer uma das chaves e remova ambas as chaves antes de reverter para uma versão anterior.

880 911 

881### `enforcement`912### `enforcement`

882 913 


1675# CLAUDE_GATEWAY_LOG_LEVEL (debug | info | warn | error; padrão info). debug1706# CLAUDE_GATEWAY_LOG_LEVEL (debug | info | warn | error; padrão info). debug

1676# também registra os nomes de claims em cada id_token, para diagnóstico de groups_claim.1707# também registra os nomes de claims em cada id_token, para diagnóstico de groups_claim.

1677# Isso não afeta eventos de auditoria, que são sempre emitidos.1708# Isso não afeta eventos de auditoria, que são sempre emitidos.

1709# Defina CLAUDE_GATEWAY_LOG_FORMAT=json para gravar as linhas do log operacional como

1710# objetos JSON com severity, time e message.

1678 1711 

1679listen:1712listen:

1680 host: 0.0.0.01713 host: 0.0.0.0


1715 # connect_timeout_seconds: 51748 # connect_timeout_seconds: 5

1716 # readiness_grace_seconds: 300 # continua passando na verificação de prontidão durante um failover do banco de dados1749 # readiness_grace_seconds: 300 # continua passando na verificação de prontidão durante um failover do banco de dados

1717 1750 

1751# Aviso exibido no login. Qualquer pessoa que consiga acessar o gateway pode lê-lo.

1752# login_notice: This gateway is for Example Corp staff. For access questions, email it-help@example.com.

1753 

1718# Habilita /v1/organizations/spend_limits (espelha a API Admin do Anthropic)1754# Habilita /v1/organizations/spend_limits (espelha a API Admin do Anthropic)

1719# e aplicação de gastos por desenvolvedor em /v1/messages. Omita para desabilitar.1755# e aplicação de gastos por desenvolvedor em /v1/messages. Omita para desabilitar.

1720# Os limites em si são definidos via API admin, não aqui.1756# Os limites em si são definidos via API admin, não aqui.


1729# # spend_retention_months: 131765# # spend_retention_months: 13

1730# # identity_retention_days: 901766# # identity_retention_days: 90

1731# # group_limit_mode: min1767# # group_limit_mode: min

1768# # pooled_conflict_rule: priority_list

1769# # pooled_priority_order: [eng-platform, eng-all]

1732 1770 

1733# enforcement:1771# enforcement:

1734# fail_closed_on_error: false1772# fail_closed_on_error: false

Details

173 * `admin.denied` registra uma tentativa de autenticação de API de administrador rejeitada com o IP do cliente, método, caminho e um motivo, sem o material de chave apresentado: `invalid_key` quando um `x-api-key` foi apresentado mas não correspondeu a nenhuma chave configurada, `bearer_rejected` quando apenas um cabeçalho `Authorization` foi apresentado e não verificou como uma sessão de gateway em `admin.admin_groups`, ou `no_credentials` quando nenhum cabeçalho foi apresentado173 * `admin.denied` registra uma tentativa de autenticação de API de administrador rejeitada com o IP do cliente, método, caminho e um motivo, sem o material de chave apresentado: `invalid_key` quando um `x-api-key` foi apresentado mas não correspondeu a nenhuma chave configurada, `bearer_rejected` quando apenas um cabeçalho `Authorization` foi apresentado e não verificou como uma sessão de gateway em `admin.admin_groups`, ou `no_credentials` quando nenhum cabeçalho foi apresentado

174* **Logs operacionais**: linhas legíveis por humanos com prefixo `[gateway]` para inicialização, avisos e erros upstream. A variável de ambiente `CLAUDE_GATEWAY_LOG_LEVEL` controla a verbosidade e aceita `debug`, `info`, `warn` ou `error`, com `info` como padrão. Em `debug`, cada entrada e atualização também registra os nomes, não os valores, das reivindicações no id\_token, mais os nomes das reivindicações de userinfo quando `userinfo_fallback` forneceu alguma, para que você possa diagnosticar as configurações de `email_claim` e `groups_claim` sem registrar PII. Não afeta eventos de auditoria, que são sempre emitidos.174* **Logs operacionais**: linhas legíveis por humanos com prefixo `[gateway]` para inicialização, avisos e erros upstream. A variável de ambiente `CLAUDE_GATEWAY_LOG_LEVEL` controla a verbosidade e aceita `debug`, `info`, `warn` ou `error`, com `info` como padrão. Em `debug`, cada entrada e atualização também registra os nomes, não os valores, das reivindicações no id\_token, mais os nomes das reivindicações de userinfo quando `userinfo_fallback` forneceu alguma, para que você possa diagnosticar as configurações de `email_claim` e `groups_claim` sem registrar PII. Não afeta eventos de auditoria, que são sempre emitidos.

175 175 

176#### Escreva logs operacionais como JSON

177 

178Se o seu coletor de logs lê o nível de cada linha a partir de um campo JSON, defina `CLAUDE_GATEWAY_LOG_FORMAT=json` no ambiente do gateway. Requer Claude Code v2.1.319 ou posterior no servidor do gateway.

179 

180Cada linha de log operacional passa então a ser um objeto com `severity`, `time` e `message`:

181 

182```json theme={null}

183{"severity":"INFO","time":"2026-11-04T17:03:21.512Z","message":"claude gateway listening on http://0.0.0.0:8080"}

184```

185 

186`severity` é o nível de log em maiúsculas, com `warn` escrito como `WARNING`. Uma falha na inicialização é uma linha `ERROR`.

187 

188Os eventos de auditoria, que também vão para stderr, não mudam. Eles carregam `ts` e `evt`, e nenhum `severity`.

189 

176### Saúde190### Saúde

177 191 

178O gateway serve `GET /healthz` como uma sonda de vivacidade e `GET /readyz` como uma sonda de prontidão. `/readyz` verifica se o armazenamento está acessível. Se você definir [`store.readiness_grace_seconds`](https://code.claude.com/docs/pt/claude-apps-gateway-config#store), `/readyz` continua relatando pronto por até esse número de segundos após o armazenamento parar de responder.192O gateway serve `GET /healthz` como uma sonda de vivacidade e `GET /readyz` como uma sonda de prontidão. `/readyz` verifica se o armazenamento está acessível. Se você definir [`store.readiness_grace_seconds`](https://code.claude.com/docs/pt/claude-apps-gateway-config#store), `/readyz` continua relatando pronto por até esse número de segundos após o armazenamento parar de responder.

Details

6 6 

7> Limite o gasto de cada desenvolvedor através do gateway de aplicativos Claude por dia, semana ou mês. Defina limites com uma API de administrador e o gateway os aplica em tempo real em cada solicitação.7> Limite o gasto de cada desenvolvedor através do gateway de aplicativos Claude por dia, semana ou mês. Defina limites com uma API de administrador e o gateway os aplica em tempo real em cada solicitação.

8 8 

9Limites de gastos limitam quanto cada desenvolvedor pode gastar através do seu [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway) em um determinado dia, semana ou mês. Quando um desenvolvedor ultrapassa seu limite, o gateway retorna `429` na próxima solicitação e os bloqueia até que o período seja redefinido ou um administrador aumente o limite. Use limites de gastos para dar a cada desenvolvedor, grupo ou toda a organização um teto de gastos em uma credencial que todos compartilham.9Limites de gastos limitam quanto cada desenvolvedor pode gastar através do seu [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway) em um determinado dia, semana ou mês. Quando um desenvolvedor ultrapassa seu limite, o gateway retorna `429` nas requisições seguintes dele até que um administrador aumente o limite, ou até que o limite seja redefinido, caso esteja acima de \$0. Use limites de gastos para dar a cada desenvolvedor, grupo ou toda a organização um teto de gastos em uma credencial que todos compartilham.

10 10 

11Por padrão, um gateway de aplicativos Claude encaminha toda a inferência através de uma credencial upstream compartilhada, portanto a fatura do seu provedor atribui tudo a essa credencial, não a desenvolvedores individuais. No Amazon Bedrock, [atribuição de custo AWS por desenvolvedor](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#per-developer-aws-cost-attribution) muda isso. Sem limites por desenvolvedor, uma frota de agentes descontrolada pode gastar todo o compromisso da organização. Limites de gastos são a visão por desenvolvedor do gateway e o disjuntor em cima dessa fatura compartilhada.11Por padrão, um gateway de aplicativos Claude encaminha toda a inferência através de uma credencial upstream compartilhada, portanto a fatura do seu provedor atribui tudo a essa credencial, não a desenvolvedores individuais. No Amazon Bedrock, [atribuição de custo AWS por desenvolvedor](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#per-developer-aws-cost-attribution) muda isso. Sem limites por desenvolvedor, uma frota de agentes descontrolada pode gastar todo o compromisso da organização. Limites de gastos são a visão por desenvolvedor do gateway e o disjuntor em cima dessa fatura compartilhada.

12 12 


51 51 

52Em cada solicitação `/v1/messages`, o gateway resolve os limites do desenvolvedor e o gasto até a data do período em uma consulta Postgres. Um desenvolvedor acima de qualquer limite recebe um `429` com `error.type: billing_error` e o cabeçalho `x-should-retry: false`.52Em cada solicitação `/v1/messages`, o gateway resolve os limites do desenvolvedor e o gasto até a data do período em uma consulta Postgres. Um desenvolvedor acima de qualquer limite recebe um `429` com `error.type: billing_error` e o cabeçalho `x-should-retry: false`.

53 53 

54A mensagem nomeia o período e a hora de redefinição, como `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`, seguida pelo seu [`admin.blocked_message`](https://code.claude.com/docs/pt/claude-apps-gateway-config#admin) se definido. Quando um desenvolvedor excede vários limites ao mesmo tempo, a mensagem nomeia o limite que é redefinido por último. A resposta também carrega um cabeçalho `retry-after` com os segundos restantes até essa redefinição. Antes de v2.1.225 no servidor do gateway, a mensagem era `spend limit reached` sem período, hora de redefinição ou cabeçalho `retry-after`.54Para um limite acima de `"0"`, a mensagem informa a data UTC em que esse limite é redefinido. Se você definir [`admin.blocked_message`](https://code.claude.com/docs/pt/claude-apps-gateway-config#admin), o gateway o acrescenta, como neste exemplo:

55 

56```text theme={null}

57spend limit reached · resets Dec 1 · request an increase at https://go.example.com/claude-limits

58```

59 

60Para um limite `"0"`, que uma redefinição não libera, a mensagem não tem data. Quando um desenvolvedor excede vários limites ao mesmo tempo, a mensagem descreve o limite que é redefinido por último. A resposta também carrega um cabeçalho `retry-after` com os segundos restantes até o fim do período desse limite.

61 

62Antes da v2.1.319 no servidor do gateway, a mensagem nomeava o período e a hora de redefinição, como `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`. Antes da v2.1.225, a mensagem era `spend limit reached` sem período, hora de redefinição ou cabeçalho `retry-after`.

55 63 

56Na v2.1.227 ou posterior, a referência de protocolo em `<public_url>/protocol` também lista os cabeçalhos de resposta de limite de uso exato e o corpo `429`.64Na v2.1.227 ou posterior, a referência de protocolo em `<public_url>/protocol` também lista os cabeçalhos de resposta de limite de uso exato e o corpo `429`.

57 65 


95| Avisos de uso em 75% e 95% | v2.1.225 ou posterior | v2.1.225 ou posterior |103| Avisos de uso em 75% e 95% | v2.1.225 ou posterior | v2.1.225 ou posterior |

96| Uma barra **Spend limit** em `/usage` com a porcentagem do seu limite usada e quando ele é redefinido, e um objeto `rate_limits.spend_limit` na entrada da linha de status | v2.1.251 ou posterior | v2.1.225 ou posterior |104| Uma barra **Spend limit** em `/usage` com a porcentagem do seu limite usada e quando ele é redefinido, e um objeto `rate_limits.spend_limit` na entrada da linha de status | v2.1.251 ou posterior | v2.1.225 ou posterior |

97| Seu gasto estimado e o limite em dólares americanos na barra **Spend limit**, como "\$271.40 / \$500.00 spent this month", e os mesmos valores mais o período do limite na entrada da linha de status | v2.1.284 ou posterior | v2.1.284 ou posterior |105| Seu gasto estimado e o limite em dólares americanos na barra **Spend limit**, como "\$271.40 / \$500.00 spent this month", e os mesmos valores mais o período do limite na entrada da linha de status | v2.1.284 ou posterior | v2.1.284 ou posterior |

106| Em um gateway com um bloco [`admin:`](https://code.claude.com/docs/pt/claude-apps-gateway-config#admin), quando nenhum limite se aplica ao desenvolvedor, seu gasto estimado em **Spend (UTC)** em `/usage`, como "\$13.06 today · \$80.76 this week · \$272.06 this month" | v2.1.319 ou posterior | v2.1.319 ou posterior |

98 107 

99Os avisos e a porcentagem vêm dos cabeçalhos `anthropic-ratelimit-unified-*`, que o gateway adiciona a cada resposta bem-sucedida de `/v1/messages` para um desenvolvedor que tem um limite. Os cabeçalhos sempre descrevem o limite próprio do desenvolvedor: o gateway remove os cabeçalhos de rate limit do provedor upstream, que descrevem sua cota compartilhada, e nunca os encaminha.108Os avisos e a porcentagem vêm dos cabeçalhos `anthropic-ratelimit-unified-*`, que o gateway adiciona a cada resposta bem-sucedida de `/v1/messages` para um desenvolvedor que tem um limite. Os cabeçalhos sempre descrevem o limite próprio do desenvolvedor: o gateway remove os cabeçalhos de rate limit do provedor upstream, que descrevem sua cota compartilhada, e nunca os encaminha.

100 109 

Details

41| `claude mcp logout <name>` | Limpar credenciais OAuth armazenadas para um servidor MCP | `claude mcp logout sentry` |41| `claude mcp logout <name>` | Limpar credenciais OAuth armazenadas para um servidor MCP | `claude mcp logout sentry` |

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

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

44| `claude remote-control` | Iniciar um servidor [Remote Control](https://code.claude.com/docs/pt/remote-control.md) para controlar Claude Code a partir de Claude.ai ou do aplicativo Claude. Executa em modo servidor (sem sessão interativa local). Veja [Flags de modo servidor](https://code.claude.com/docs/pt/remote-control.md#start-a-remote-control-session). Depois de parar o servidor, você pode trazer de volta as sessões que ele estava servindo. Veja [Retomar sessões após parar o servidor](https://code.claude.com/docs/pt/remote-control.md#resume-sessions-after-stopping-the-server) | `claude remote-control --name "My Project"` |44| `claude remote-control` | Iniciar um servidor [Remote Control](https://code.claude.com/docs/pt/remote-control.md) para controlar Claude Code a partir de claude.ai ou do aplicativo Claude. Alias: `claude rc`. Executa em modo servidor (sem sessão interativa local). Veja [Flags de modo servidor](https://code.claude.com/docs/pt/remote-control.md#start-a-remote-control-session). Depois de parar o servidor, você pode trazer de volta as sessões que ele estava servindo. Veja [Retomar sessões após parar o servidor](https://code.claude.com/docs/pt/remote-control.md#resume-sessions-after-stopping-the-server) | `claude remote-control --name "My Project"` |

45| `claude respawn <id>` | Reiniciar uma [sessão de fundo](https://code.claude.com/docs/pt/agent-view.md#manage-sessions-from-the-shell), em execução ou parada, com sua conversa intacta. Use `--all` para reiniciar cada sessão em execução, por exemplo, para pegar um binário Claude Code atualizado | `claude respawn 7c5dcf5d` |45| `claude respawn <id>` | Reiniciar uma [sessão de fundo](https://code.claude.com/docs/pt/agent-view.md#manage-sessions-from-the-shell), em execução ou parada, com sua conversa intacta. Use `--all` para reiniciar cada sessão em execução, por exemplo, para pegar um binário Claude Code atualizado | `claude respawn 7c5dcf5d` |

46| `claude rm <id>` | Remover uma [sessão de fundo](https://code.claude.com/docs/pt/agent-view.md#manage-sessions-from-the-shell) da lista. Quando a remoção é [recusada por causa do worktree da sessão](https://code.claude.com/docs/pt/agent-view.md#what-deleting-a-session-removes) e um segundo `claude rm` pode resolvê-la, a recusa imprime a flag exata e o valor a passar: `--discard-unpushed <commit>@<worktree-id>` descarta um worktree que tem commits não enviados junto com esses commits, e `--force-remove-worktree <worktree-id>` exclui um diretório de worktree que o git ou o hook `WorktreeRemove` não conseguiu remover. `--discard-unpushed` requer Claude Code v2.1.260 ou posterior, e `--force-remove-worktree` requer v2.1.268 ou posterior. A transcrição da conversa permanece em sua máquina local, disponível através de `claude --resume` | `claude rm 7c5dcf5d` |46| `claude rm <id>` | Remover uma [sessão de fundo](https://code.claude.com/docs/pt/agent-view.md#manage-sessions-from-the-shell) da lista. Quando a remoção é [recusada por causa do worktree da sessão](https://code.claude.com/docs/pt/agent-view.md#what-deleting-a-session-removes) e um segundo `claude rm` pode resolvê-la, a recusa imprime a flag exata e o valor a passar: `--discard-unpushed <commit>@<worktree-id>` descarta um worktree que tem commits não enviados junto com esses commits, e `--force-remove-worktree <worktree-id>` exclui um diretório de worktree que o git ou o hook `WorktreeRemove` não conseguiu remover. `--discard-unpushed` requer Claude Code v2.1.260 ou posterior, e `--force-remove-worktree` requer v2.1.268 ou posterior. A transcrição da conversa permanece em sua máquina local, disponível através de `claude --resume` | `claude rm 7c5dcf5d` |

47| `claude self-hosted-runner` | Iniciar um processo de runner que registra esta máquina ou contêiner com um [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments) e hospeda sessões na nuvem do Claude Code em sua infraestrutura. Execute `claude self-hosted-runner setup` para um passo a passo do operador guiado, `claude self-hosted-runner doctor` para [diagnosticar um runner implantado](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#troubleshooting) e `claude self-hosted-runner orchestrator` para gerar [runners sob demanda](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#on-demand-runners). Requer Claude Code v2.1.224 ou posterior | `claude self-hosted-runner setup` |47| `claude self-hosted-runner` | Iniciar um processo de runner que registra esta máquina ou contêiner com um [ambiente auto-hospedado](https://code.claude.com/docs/pt/self-hosted-environments) e hospeda sessões na nuvem do Claude Code em sua infraestrutura. Execute `claude self-hosted-runner setup` para um passo a passo do operador guiado, `claude self-hosted-runner doctor` para [diagnosticar um runner implantado](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#troubleshooting) e `claude self-hosted-runner orchestrator` para gerar [runners sob demanda](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#on-demand-runners). Requer Claude Code v2.1.224 ou posterior | `claude self-hosted-runner setup` |


111| `--no-session-persistence` | Desativar persistência de sessão para que as sessões não sejam salvas em disco e não possam ser retomadas. Apenas modo print. A variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/pt/env-vars) faz o mesmo em qualquer modo | `claude -p --no-session-persistence "query"` |111| `--no-session-persistence` | Desativar persistência de sessão para que as sessões não sejam salvas em disco e não possam ser retomadas. Apenas modo print. A variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/pt/env-vars) faz o mesmo em qualquer modo | `claude -p --no-session-persistence "query"` |

112| `--output-format` | Especificar formato de saída para modo print (opções: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |112| `--output-format` | Especificar formato de saída para modo print (opções: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

113| `--permission-mode` | Começar em um [modo de permissão](https://code.claude.com/docs/pt/permission-modes.md) especificado. Aceita `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` ou `manual` como um alias para `default`. O alias `manual` seleciona o modo de permissão que a UI rotula como Manual e requer Claude Code v2.1.200 ou posterior; `claude --help` o lista no lugar de `default` e ambos os valores funcionam. Substitui `defaultMode` dos arquivos de configuração. Sem este sinalizador ou `--dangerously-skip-permissions`, uma nova sessão inicia no modo de permissão descrito em [qual modo de permissão uma sessão inicia](https://code.claude.com/docs/pt/permission-modes.md#which-mode-a-session-starts-in), que também cobre o que uma execução `-p` inicia | `claude --permission-mode plan` |113| `--permission-mode` | Começar em um [modo de permissão](https://code.claude.com/docs/pt/permission-modes.md) especificado. Aceita `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` ou `manual` como um alias para `default`. O alias `manual` seleciona o modo de permissão que a UI rotula como Manual e requer Claude Code v2.1.200 ou posterior; `claude --help` o lista no lugar de `default` e ambos os valores funcionam. Substitui `defaultMode` dos arquivos de configuração. Sem este sinalizador ou `--dangerously-skip-permissions`, uma nova sessão inicia no modo de permissão descrito em [qual modo de permissão uma sessão inicia](https://code.claude.com/docs/pt/permission-modes.md#which-mode-a-session-starts-in), que também cobre o que uma execução `-p` inicia | `claude --permission-mode plan` |

114| `--permission-prompt-tool` | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo. Passe o nome completo, como `mcp__<server>__<tool>`, de uma ferramenta em um servidor MCP que a execução carrega. Claude Code aguarda a conexão do servidor MCP dessa ferramenta antes de executar o primeiro turno, até o timeout de inicialização [`MCP_TIMEOUT`](https://code.claude.com/docs/pt/env-vars), 30 segundos por padrão. A ferramenta de prompt não pode aprovar uma ferramenta MCP marcada como [exigindo interação do usuário](https://code.claude.com/docs/pt/mcp.md#require-approval-for-a-specific-tool): Claude Code converte um resultado `allow` para uma em uma negação. Esta restrição requer Claude Code v2.1.199 ou posterior | `claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"` |114| `--permission-prompt-tool` | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo. Passe o nome completo, como `mcp__<server>__<tool>`, de uma ferramenta em um servidor MCP que a execução carrega. Claude Code aguarda a conexão do servidor MCP dessa ferramenta antes de executar o primeiro turno, até o timeout de inicialização [`MCP_TIMEOUT`](https://code.claude.com/docs/pt/env-vars), 30 segundos por padrão. Veja [o que a ferramenta deve retornar](https://code.claude.com/docs/pt/errors.md#permission-prompt-tool-returned-an-invalid-result). A ferramenta de prompt não pode aprovar uma ferramenta MCP marcada como [exigindo interação do usuário](https://code.claude.com/docs/pt/mcp.md#require-approval-for-a-specific-tool): Claude Code converte um resultado `allow` para uma em uma negação. Esta restrição requer Claude Code v2.1.199 ou posterior | `claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"` |

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

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

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

commands.md +1 −1

Details

162| `/ultrareview [PR or branch]` | Execute uma revisão de código profunda e multi-agente em um sandbox na nuvem com [ultrareview](https://code.claude.com/docs/pt/ultrareview.md). Passe uma referência de PR para revisar esse pull request, ou um branch base ou commit para alterar a base de comparação. A invocação preferida é `/code-review ultra`, e `/ultrareview` é um alias. Inclui 3 execuções gratuitas em Pro, Max e Ultra, depois requer [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |162| `/ultrareview [PR or branch]` | Execute uma revisão de código profunda e multi-agente em um sandbox na nuvem com [ultrareview](https://code.claude.com/docs/pt/ultrareview.md). Passe uma referência de PR para revisar esse pull request, ou um branch base ou commit para alterar a base de comparação. A invocação preferida é `/code-review ultra`, e `/ultrareview` é um alias. Inclui 3 execuções gratuitas em Pro, Max e Ultra, depois requer [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

163| `/update-config [request]` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Descreva uma mudança de configurações, como permitir um comando, definir uma variável de ambiente ou adicionar um [hook](https://code.claude.com/docs/pt/hooks.md), e Claude edita o arquivo [`settings.json`](https://code.claude.com/docs/pt/settings) correspondente. Para opções como tema e modelo, use `/config` |163| `/update-config [request]` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Descreva uma mudança de configurações, como permitir um comando, definir uma variável de ambiente ou adicionar um [hook](https://code.claude.com/docs/pt/hooks.md), e Claude edita o arquivo [`settings.json`](https://code.claude.com/docs/pt/settings) correspondente. Para opções como tema e modelo, use `/config` |

164| `/upgrade` | Abra a página de atualização no seu navegador para mudar para um nível de plano superior. Quando o navegador falha em abrir, o comando mostra um prompt de login sem imprimir a URL |164| `/upgrade` | Abra a página de atualização no seu navegador para mudar para um nível de plano superior. Quando o navegador falha em abrir, o comando mostra um prompt de login sem imprimir a URL |

165| `/usage` | Mostre custo de sessão, limites de uso do plano e estatísticas de atividade. Em um plano Pro, Max, Ultra, Team ou Enterprise, inclui um [detalhamento do que conta contra seus limites de plano](https://code.claude.com/docs/pt/costs.md#plan-usage-breakdown). `/cost` e `/stats` são aliases |165| `/usage` | Mostre custo de sessão, limites de uso do plano e estatísticas de atividade. Em um plano Pro, Max, Ultra, Team ou Enterprise, inclui um [detalhamento do que conta contra seus limites de plano](https://code.claude.com/docs/pt/costs.md#plan-usage-breakdown). Atrás de um gateway de aplicativos Claude que rastreia gastos, mostra [seus gastos através do gateway](https://code.claude.com/docs/pt/claude-apps-gateway-spend-limits.md#usage-warnings-in-claude-code). `/cost` e `/stats` são aliases |

166| `/usage-credits` | Configure créditos de uso, ou solicite-os do seu administrador, quando você atinge um limite. Abre suas [configurações de faturamento de créditos de uso](https://code.claude.com/docs/pt/costs.md#add-usage-credits-to-your-subscription) no navegador, exceto que membros de Team e Enterprise sem acesso de faturamento enviam uma solicitação de créditos de uso para seu administrador a partir da CLI, após confirmar em um diálogo que a solicitação notifica seus administradores. Quando nenhum navegador pode abrir a página de faturamento, por exemplo sobre SSH, o comando imprime a URL para visitar; isso requer Claude Code v2.1.205 ou posterior, e versões anteriores não mostravam nada nesse caso. Anteriormente `/extra-usage` |166| `/usage-credits` | Configure créditos de uso, ou solicite-os do seu administrador, quando você atinge um limite. Abre suas [configurações de faturamento de créditos de uso](https://code.claude.com/docs/pt/costs.md#add-usage-credits-to-your-subscription) no navegador, exceto que membros de Team e Enterprise sem acesso de faturamento enviam uma solicitação de créditos de uso para seu administrador a partir da CLI, após confirmar em um diálogo que a solicitação notifica seus administradores. Quando nenhum navegador pode abrir a página de faturamento, por exemplo sobre SSH, o comando imprime a URL para visitar; isso requer Claude Code v2.1.205 ou posterior, e versões anteriores não mostravam nada nesse caso. Anteriormente `/extra-usage` |

167| `/verify` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Confirme que uma mudança de código faz o que deveria fazendo o build do aplicativo do seu projeto, executando-o e observando o resultado, em vez de confiar em testes ou verificações de tipo. Consulte [Execute e verifique seu aplicativo](https://code.claude.com/docs/pt/skills.md#run-and-verify-your-app) |167| `/verify` | **[Skill](https://code.claude.com/docs/pt/skills.md#bundled-skills).** Confirme que uma mudança de código faz o que deveria fazendo o build do aplicativo do seu projeto, executando-o e observando o resultado, em vez de confiar em testes ou verificações de tipo. Consulte [Execute e verifique seu aplicativo](https://code.claude.com/docs/pt/skills.md#run-and-verify-your-app) |

168| `/vim` | Removido na v2.1.92. Para alternar entre modos de edição Vim e Normal, use `/config` → Editor mode |168| `/vim` | Removido na v2.1.92. Para alternar entre modos de edição Vim e Normal, use `/config` → Editor mode |

costs.md +1 −1

Details

236 * Execute `/usage-credits` para solicitar uso além da cota, se você tiver [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) ativados.236 * Execute `/usage-credits` para solicitar uso além da cota, se você tiver [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) ativados.

237 * No Claude Code v2.1.234 ou posterior, [aguarde e continue a tarefa interrompida automaticamente após o reset](https://code.claude.com/docs/pt/interactive-mode.md#wait-for-a-usage-limit-to-reset); essa seção lista quando Claude Code inicia a espera por conta própria e quando o desenvolvedor a escolhe em `/rate-limit-options`. Para controlar sua frota se Claude Code inicia essa espera por conta própria, defina [`autoContinueAtUsageLimit`](https://code.claude.com/docs/pt/settings-reference#autocontinueatusagelimit) em [configurações gerenciadas](https://code.claude.com/docs/pt/settings.md#settings-precedence).237 * No Claude Code v2.1.234 ou posterior, [aguarde e continue a tarefa interrompida automaticamente após o reset](https://code.claude.com/docs/pt/interactive-mode.md#wait-for-a-usage-limit-to-reset); essa seção lista quando Claude Code inicia a espera por conta própria e quando o desenvolvedor a escolhe em `/rate-limit-options`. Para controlar sua frota se Claude Code inicia essa espera por conta própria, defina [`autoContinueAtUsageLimit`](https://code.claude.com/docs/pt/settings-reference#autocontinueatusagelimit) em [configurações gerenciadas](https://code.claude.com/docs/pt/settings.md#settings-precedence).

238* **"Você atingiu seu limite de gastos individual", "limite de gastos mensal da organização", ou "orçamento compartilhado da equipe"**: a requisição do desenvolvedor seria faturada para créditos de uso, e esses créditos atingiram um limite de gastos que você definiu. Para permitir que o desenvolvedor continue, vá para [**Configurações da organização > Uso**](https://claude.ai/admin-settings/usage) e aumente o limite que a mensagem nomeia. Quando a mensagem também nomeia um tempo de reset do plano, o desenvolvedor pode, em vez disso, esperar até então. Veja [a referência de erro](https://code.claude.com/docs/pt/errors.md#youve-hit-your-monthly-spend-limit) para cada variante.238* **"Você atingiu seu limite de gastos individual", "limite de gastos mensal da organização", ou "orçamento compartilhado da equipe"**: a requisição do desenvolvedor seria faturada para créditos de uso, e esses créditos atingiram um limite de gastos que você definiu. Para permitir que o desenvolvedor continue, vá para [**Configurações da organização > Uso**](https://claude.ai/admin-settings/usage) e aumente o limite que a mensagem nomeia. Quando a mensagem também nomeia um tempo de reset do plano, o desenvolvedor pode, em vez disso, esperar até então. Veja [a referência de erro](https://code.claude.com/docs/pt/errors.md#youve-hit-your-monthly-spend-limit) para cada variante.

239* **Uma mensagem de limite de gastos de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway)**: o desenvolvedor passou um limite de gastos que você definiu em seu gateway auto-hospedado, e o gateway bloqueia suas solicitações até o período ser redefinido ou você aumentar o limite. Veja [limites de gastos do gateway](https://code.claude.com/docs/pt/claude-apps-gateway-spend-limits.md) para limites, cronogramas de reset e a mensagem que o desenvolvedor vê.239* **Uma mensagem de limite de gastos de um [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway)**: o desenvolvedor ultrapassou um limite de gastos que você definiu em seu gateway auto-hospedado. O gateway bloqueia as requisições dele até que você aumente o limite, ou até que o limite seja redefinido, se estiver acima de \$0. Veja [limites de gastos do gateway](https://code.claude.com/docs/pt/claude-apps-gateway-spend-limits.md) para limites, cronogramas de reset e a mensagem que o desenvolvedor vê.

240* **Um aviso de contexto ou auto-compact**: não é um limite de uso. A conversa cresceu perto da [janela de auto-compact](https://code.claude.com/docs/pt/model-config.md#set-the-auto-compact-window) da sessão, o limite onde Claude Code resume o histórico mais antigo para liberar espaço. Aponte o desenvolvedor para [reduzir uso de tokens](#reduce-token-usage).240* **Um aviso de contexto ou auto-compact**: não é um limite de uso. A conversa cresceu perto da [janela de auto-compact](https://code.claude.com/docs/pt/model-config.md#set-the-auto-compact-window) da sessão, o limite onde Claude Code resume o histórico mais antigo para liberar espaço. Aponte o desenvolvedor para [reduzir uso de tokens](#reduce-token-usage).

241* **Gastos inesperadamente altos em um plano de API ou provedor de nuvem**: geralmente rastreia de volta para sessões longas que nunca foram limpas ou para Opus deixado como o modelo padrão. Os hábitos de maior impacto para compartilhar são limpar entre tarefas não relacionadas e corresponder o modelo ao trabalho, ambos cobertos em [reduzir uso de tokens](#reduce-token-usage).241* **Gastos inesperadamente altos em um plano de API ou provedor de nuvem**: geralmente rastreia de volta para sessões longas que nunca foram limpas ou para Opus deixado como o modelo padrão. Os hábitos de maior impacto para compartilhar são limpar entre tarefas não relacionadas e corresponder o modelo ao trabalho, ambos cobertos em [reduzir uso de tokens](#reduce-token-usage).

242 242 

env-vars.md +2 −1

Details

365| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Defina `5m` ou `1h`, os únicos valores que o Claude Code aceita, para escolher o [TTL do cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) para a conversa principal: seus turnos interativos, `-p` e do SDK, além dos auxiliares que são executados junto com eles. Tem precedência sobre a configuração `promptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a sobrescreve. A API cobra gravações de cache de 1 hora com uma tarifa mais alta. Requer Claude Code v2.1.242 ou posterior |365| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Defina `5m` ou `1h`, os únicos valores que o Claude Code aceita, para escolher o [TTL do cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md#cache-lifetime) para a conversa principal: seus turnos interativos, `-p` e do SDK, além dos auxiliares que são executados junto com eles. Tem precedência sobre a configuração `promptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a sobrescreve. A API cobra gravações de cache de 1 hora com uma tarifa mais alta. Requer Claude Code v2.1.242 ou posterior |

366| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Defina como `1` para propagar o contexto de rastreamento W3C quando `ANTHROPIC_BASE_URL` apontar para um proxy personalizado. A propagação abrange o cabeçalho `traceparent` nas requisições ao modelo e nas requisições MCP via HTTP, e a variável de ambiente `TRACEPARENT` para subprocessos de Bash, PowerShell e hooks. Por padrão, a propagação só é ativada quando há conexão direta com a API da Anthropic. Adicionada na v2.1.152. Consulte [Traces (beta)](https://code.claude.com/docs/pt/monitoring-usage.md#traces-beta) |366| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Defina como `1` para propagar o contexto de rastreamento W3C quando `ANTHROPIC_BASE_URL` apontar para um proxy personalizado. A propagação abrange o cabeçalho `traceparent` nas requisições ao modelo e nas requisições MCP via HTTP, e a variável de ambiente `TRACEPARENT` para subprocessos de Bash, PowerShell e hooks. Por padrão, a propagação só é ativada quando há conexão direta com a API da Anthropic. Adicionada na v2.1.152. Consulte [Traces (beta)](https://code.claude.com/docs/pt/monitoring-usage.md#traces-beta) |

367| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Definida por plataformas host que incorporam o Claude Code e gerenciam o roteamento do provedor de modelos em seu nome. Quando definida, o Claude Code ignora variáveis de seleção de provedor, de endpoint e de autenticação, como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY`, em arquivos de configurações, de modo que as configurações de usuário não possam sobrescrever o roteamento do host. O Claude Code também ignora chaves de seleção de modelo, como `model`, `fallbackModel` e `modelOverrides`, nas [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), seja qual for a fonte gerenciada que as entregue, para que a configuração de modelos do host tenha precedência sobre uma fixação de modelo gerenciada desatualizada. O Claude Code também ignora variáveis de seleção de modelo, como `ANTHROPIC_MODEL` e a família `ANTHROPIC_DEFAULT_*_MODEL`, em um bloco `env` gerenciado; uma allowlist [`availableModels`](https://code.claude.com/docs/pt/model-config#restrict-model-selection) nas configurações gerenciadas ainda se aplica, a menos que o host forneça a sua própria. O Claude Code também pula a desativação automática de telemetria que normalmente aplica em provedores de terceiros, como Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud e Microsoft Foundry, de modo que a telemetria segue a desativação padrão via `DISABLE_TELEMETRY`. Consulte [Comportamentos padrão por provedor de API](https://code.claude.com/docs/pt/data-usage.md#default-behaviors-by-api-provider) |367| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Definida por plataformas host que incorporam o Claude Code e gerenciam o roteamento do provedor de modelos em seu nome. Quando definida, o Claude Code ignora variáveis de seleção de provedor, de endpoint e de autenticação, como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY`, em arquivos de configurações, de modo que as configurações de usuário não possam sobrescrever o roteamento do host. O Claude Code também ignora chaves de seleção de modelo, como `model`, `fallbackModel` e `modelOverrides`, nas [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md), seja qual for a fonte gerenciada que as entregue, para que a configuração de modelos do host tenha precedência sobre uma fixação de modelo gerenciada desatualizada. O Claude Code também ignora variáveis de seleção de modelo, como `ANTHROPIC_MODEL` e a família `ANTHROPIC_DEFAULT_*_MODEL`, em um bloco `env` gerenciado; uma allowlist [`availableModels`](https://code.claude.com/docs/pt/model-config#restrict-model-selection) nas configurações gerenciadas ainda se aplica, a menos que o host forneça a sua própria. O Claude Code também pula a desativação automática de telemetria que normalmente aplica em provedores de terceiros, como Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud e Microsoft Foundry, de modo que a telemetria segue a desativação padrão via `DISABLE_TELEMETRY`. Consulte [Comportamentos padrão por provedor de API](https://code.claude.com/docs/pt/data-usage.md#default-behaviors-by-api-provider) |

368| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy faça a resolução de DNS em vez do chamador. Opcional para ambientes em que o proxy deve lidar com a resolução de nomes de host |368| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Defina como `1` para permitir que o proxy faça a resolução DNS em vez do chamador. Opção para ambientes em que o proxy deve lidar com a resolução de nomes de host. Quando `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` estiver definida, defina esta no ambiente do processo que inicia o Claude Code |

369| `CLAUDE_CODE_REMOTE` | Definida automaticamente como `true` quando o Claude Code está sendo executado como uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md). Leia-a a partir de um hook ou script de configuração para detectar se você está em uma sessão na nuvem |369| `CLAUDE_CODE_REMOTE` | Definida automaticamente como `true` quando o Claude Code está sendo executado como uma [sessão na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md). Leia-a a partir de um hook ou script de configuração para detectar se você está em uma sessão na nuvem |

370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definida automaticamente em [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) com o ID da sessão atual. Leia-a para construir um link de volta para a transcrição da sessão. Consulte [Vincular a saída de volta à sessão](https://code.claude.com/docs/pt/cloud-environments.md#link-output-back-to-the-session) |370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Definida automaticamente em [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md) com o ID da sessão atual. Leia-a para construir um link de volta para a transcrição da sessão. Consulte [Vincular a saída de volta à sessão](https://code.claude.com/docs/pt/cloud-environments.md#link-output-back-to-the-session) |

371| `CLAUDE_CODE_RESTRICTED` | Defina como `1` para iniciar a sessão no modo restrito, o mesmo que passar [`--restricted`](https://code.claude.com/docs/pt/cli-reference#cli-flags). O Claude Code ignora esta variável no bloco `env` de um arquivo de configurações. Requer Claude Code v2.1.248 ou posterior |371| `CLAUDE_CODE_RESTRICTED` | Defina como `1` para iniciar a sessão no modo restrito, o mesmo que passar [`--restricted`](https://code.claude.com/docs/pt/cli-reference#cli-flags). O Claude Code ignora esta variável no bloco `env` de um arquivo de configurações. Requer Claude Code v2.1.248 ou posterior |


529| `VERTEX_REGION_CLAUDE_5_SONNET` | Sobrescreve a região do Claude Sonnet 5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.197 |529| `VERTEX_REGION_CLAUDE_5_SONNET` | Sobrescreve a região do Claude Sonnet 5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.197 |

530| `VERTEX_REGION_CLAUDE_FABLE_5` | Sobrescreve a região do Claude Fable 5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.170 |530| `VERTEX_REGION_CLAUDE_FABLE_5` | Sobrescreve a região do Claude Fable 5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.170 |

531| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sobrescreve a região do Claude Fable 5.1 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.257 |531| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sobrescreve a região do Claude Fable 5.1 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.257 |

532| `VERTEX_REGION_CLAUDE_FABLE_5_2` | Sobrescreve a região do Claude Fable 5.2 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.321 |

532| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sobrescreve a região do Claude Haiku 4.5 ao usar o Google Cloud's Agent Platform |533| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sobrescreve a região do Claude Haiku 4.5 ao usar o Google Cloud's Agent Platform |

533| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Sobrescreve a região do Claude Haiku 5.5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.293 |534| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Sobrescreve a região do Claude Haiku 5.5 ao usar o Google Cloud's Agent Platform. Adicionada na v2.1.293 |

534 535 

errors.md +92 −15

Details

52| `Credit balance is too low` | [Usage limits](#credit-balance-is-too-low) |52| `Credit balance is too low` | [Usage limits](#credit-balance-is-too-low) |

53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Usage limits](#youve-hit-your-monthly-spend-limit) |53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Usage limits](#youve-hit-your-monthly-spend-limit) |

54| `Could not update your spend limit` | [Usage limits](#could-not-update-your-spend-limit) |54| `Could not update your spend limit` | [Usage limits](#could-not-update-your-spend-limit) |

55| `spend limit reached` / `spend limit unavailable` | [Usage limits](#spend-limit-reached) |55| `spend limit reached` / `spend limit unavailable` / `This request exceeds your group's budget` | [Limites de uso](#spend-limit-reached) |

56| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |56| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |

57| `Couldn't save your login` | [Authentication](#couldnt-save-your-login) |57| `Couldn't save your login` | [Authentication](#couldnt-save-your-login) |

58| `Sign in again to take your previous account or API key off the config file.` | [Autenticação](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |58| `Sign in again to take your previous account or API key off the config file.` | [Autenticação](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |


336| `MCP server "<name>" connection closed before the tool call was answered` | [Tool errors](#connection-closed-before-the-tool-call-was-answered) |336| `MCP server "<name>" connection closed before the tool call was answered` | [Tool errors](#connection-closed-before-the-tool-call-was-answered) |

337| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [Erros de ferramenta](#mcp-server-is-disabled) |337| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [Erros de ferramenta](#mcp-server-is-disabled) |

338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Tool errors](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Tool errors](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |

339| `Permission prompt tool returned an invalid result` | [Erros de ferramenta](#permission-prompt-tool-returned-an-invalid-result) |

339| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |340| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |

340| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |341| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |

341| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Erros de ferramenta](#setting-blocks-writes-outside-the-working-directories) |342| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Erros de ferramenta](#setting-blocks-writes-outside-the-working-directories) |


420| `The Claude Code program for this computer, the <build> build, could not be found` | [Erros de wrapper e IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |421| `The Claude Code program for this computer, the <build> build, could not be found` | [Erros de wrapper e IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |

421| `Restored the code, but skipped N files` | [Rewind warnings and errors](#restored-the-code-but-skipped-files) |422| `Restored the code, but skipped N files` | [Rewind warnings and errors](#restored-the-code-but-skipped-files) |

422| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind warnings and errors](#no-files-were-restored) |423| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind warnings and errors](#no-files-were-restored) |

424| `The file backups are still being copied. Nothing was changed. Try again in a moment.` | Selecione o mesmo ponto em [`/rewind`](https://code.claude.com/docs/pt/checkpointing) novamente. Quando você restaura o código logo após [`/branch`](https://code.claude.com/docs/pt/sessions#branch-a-session), o Claude Code ainda pode estar copiando os backups de arquivos para a nova sessão. |

423| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |425| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |

424| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |426| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |

425| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |427| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |


431| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Configuration warnings](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |433| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Configuration warnings](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |

432| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Configuration warnings](#skill-or-command-name-refused) |434| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Configuration warnings](#skill-or-command-name-refused) |

433| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |435| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |

436| `Two Claude Code config files exist: this run uses <path>, not <path>` | [Avisos de configuração](#two-claude-code-config-files-exist) |

434| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Avisos de configuração](#make-this-change-again-later) |437| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Avisos de configuração](#make-this-change-again-later) |

435| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |438| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |

436| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |439| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |


468| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Valores e avisos para `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/pt/model-config#claude_code_auto_compact_window-values) |471| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Valores e avisos para `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/pt/model-config#claude_code_auto_compact_window-values) |

469| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Correct the window for a gateway or custom model ID](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |472| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Correct the window for a gateway or custom model ID](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |

470| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Correct the window for a gateway or custom model ID](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |473| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Correct the window for a gateway or custom model ID](https://code.claude.com/docs/pt/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |

474| `Model "<model>" isn't recognized · did you mean "<suggestion>"?` / `Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?` | [Corrigir um nome de modelo digitado incorretamente](https://code.claude.com/docs/pt/model-config.md#fix-a-mistyped-model-name) |

471| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |475| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |

472| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Configuration warnings](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |476| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Configuration warnings](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |

473| `Sandbox mask files left behind at write-deny paths` | [Configuration warnings](#stale-sandbox-mask-files-left-by-a-killed-session) |477| `Sandbox mask files left behind at write-deny paths` | [Configuration warnings](#stale-sandbox-mask-files-left-by-a-killed-session) |


909Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change913Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

910```914```

911 915 

912As mensagens nomeiam o modelo Fable da sessão, portanto, em Fable 5 elas leem `continuing on Fable 5` e `Fable 5 now uses usage credits`. Antes da v2.1.257, a primeira mensagem começava `Fable 5 limit reached`.916As mensagens nomeiam o modelo Fable da sessão, portanto, em Fable 5.2 elas leem `continuing on Fable 5.2` e `Fable 5.2 now uses usage credits`. Antes da v2.1.257, a primeira mensagem começava `Fable 5 limit reached`.

913 917 

914Isso acontece em sessões [Remote Control](https://code.claude.com/docs/pt/remote-control.md), [background sessions](https://code.claude.com/docs/pt/agent-view.md), sessões de colegas de [agent team](https://code.claude.com/docs/pt/agent-teams.md), e sessões que outro aplicativo hospeda através do Agent SDK. Para quando Claude Code fecha o prompt, veja [Fable and usage credits](https://code.claude.com/docs/pt/model-config.md#fable-and-usage-credits).918Isso acontece em sessões [Remote Control](https://code.claude.com/docs/pt/remote-control.md), [background sessions](https://code.claude.com/docs/pt/agent-view.md), sessões de colegas de [agent team](https://code.claude.com/docs/pt/agent-teams.md), e sessões que outro aplicativo hospeda através do Agent SDK. Para quando Claude Code fecha o prompt, veja [Fable and usage credits](https://code.claude.com/docs/pt/model-config.md#fable-and-usage-credits).

915 919 


983 987 

984### Spend limit reached988### Spend limit reached

985 989 

986Você se conecta através de um [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway) e passou por um [spend cap](https://code.claude.com/docs/pt/claude-apps-gateway-spend-limits.md) que seu operador de gateway definiu. O gateway bloqueia suas requisições até que o período nomeado seja resetado ou o operador aumente o limite. Ele marca cada resposta `429` bloqueada com `x-should-retry: false`, portanto, Claude Code mostra esta mensagem sem tentar novamente.990Você se conecta através de um [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway) e atingiu um [spend cap](https://code.claude.com/docs/pt/claude-apps-gateway-spend-limits.md) que seu operador de gateway definiu. O gateway bloqueia suas requisições até que o operador aumente o limite, ou até que o limite seja resetado, se estiver acima de \$0. Ele marca cada resposta `429` bloqueada com `x-should-retry: false`, portanto, no terminal, Claude Code mostra esta mensagem sem tentar novamente.

987 991 

988```text theme={null}992```text theme={null}

989spend limit reached (daily; resets 2026-08-09 00:00 UTC)993spend limit reached · resets Dec 1

990```994```

991 995 

992A mensagem nomeia o período do limite e o horário de reset, e quando o operador configurou um `blocked_message`, suas instruções o seguem. Antes da v2.1.225, a mensagem lia apenas `spend limit reached`; um gateway em uma versão mais antiga ainda envia essa forma mais curta.996Verifique se a mensagem contém uma data:

997 

998* **Com uma data**: o limite é resetado às 00:00 UTC nessa data

999* **Sem data**: seu limite é \$0, ou seu gateway executa uma versão anterior à v2.1.225

1000 

1001Qualquer texto adicional na mensagem é uma nota do seu operador de gateway.

1002 

1003Da v2.1.225 até a v2.1.319 no servidor do gateway, a mensagem nomeava o período do limite e o horário de reset, como em `spend limit reached (daily; resets 2026-08-09 00:00 UTC)`.

993 1004 

994**O que fazer:**1005**O que fazer:**

995 1006 

996* Aguarde o horário de reset que a mensagem nomeia, ou siga as instruções do operador se a mensagem as carregar1007* Se a mensagem tiver uma data, aguarde o reset, ou siga a nota do operador se a mensagem contiver uma

997* Peça ao seu operador de gateway para aumentar o limite se você o atingir rotineiramente1008* Peça ao seu operador de gateway para aumentar o limite se a mensagem não tiver data, se você ainda estiver bloqueado após a data, ou se você atingir o limite rotineiramente

1009 

1010Uma segunda mensagem do gateway, `This request exceeds your group's budget`, significa que o [orçamento agrupado](https://code.claude.com/docs/pt/claude-apps-gateway-config.md#pooled-budget-order) do seu grupo foi esgotado. Siga os passos que ela indica:

1011 

1012```text theme={null}

1013This request exceeds your group's budget. Ask your organization's admins to raise it, or try again after it resets on November 1 at 00:00 UTC.

1014```

998 1015 

999Uma mensagem relacionada, `spend limit unavailable`, significa que o gateway não conseguiu ler seus registros de gastos e bloqueou a requisição como precaução em vez de sobre seu limite. Geralmente se limpa por conta própria; se persistir, informe seu operador de gateway.1016Uma mensagem relacionada, `spend limit unavailable`, significa que o gateway não conseguiu ler seus registros de gastos e bloqueou a requisição como precaução em vez de sobre seu limite. Geralmente se limpa por conta própria; se persistir, informe seu operador de gateway.

1000 1017 


2287 2304 

2288### Couldn't send feedback2305### Couldn't send feedback

2289 2306 

2290Uma mensagem que começa com `Couldn't send feedback` significa que o serviço de feedback não confirmou o relatório que você enviou pelo [diálogo `/feedback`, `/bug` ou `/share`](https://code.claude.com/docs/pt/commands#all-commands), ou um [rascunho de feedback](https://code.claude.com/docs/pt/tools-reference.md#sendfeedback-tool-behavior) na fila. Trate-o como não recebido. Quando uma frase sobre sua organização vem após os dois-pontos, sua organização recusa feedback e o mesmo relatório recebe a mesma resposta.2307Uma mensagem que começa com `Couldn't send feedback` significa que o serviço de feedback não confirmou o relatório que você enviou pelo [diálogo `/feedback`, `/bug` ou `/share`](https://code.claude.com/docs/pt/commands#all-commands), ou um [rascunho de feedback](https://code.claude.com/docs/pt/tools-reference.md#sendfeedback-tool-behavior) na fila. Trate-o como não recebido. Quando uma frase sobre sua organização vem após os dois-pontos, sua organização recusa feedback.

2291 2308 

2292O segundo destes dois exemplos é uma recusa da organização:2309O segundo exemplo é uma recusa da organização:

2293 2310 

2294```text wrap theme={null}2311```text wrap theme={null}

2295Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.2312Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.


2300**O que fazer:**2317**O que fazer:**

2301 2318 

2302* **Não autenticado**: a mensagem continua com `: not signed in. Run /login, then retry.` Execute `/login` e envie novamente2319* **Não autenticado**: a mensagem continua com `: not signed in. Run /login, then retry.` Execute `/login` e envie novamente

2303* **Recusa da sua organização**: por exemplo `: Feedback has not been enabled for your organization.` ou `: Feedback collection is not available for organizations with custom data retention policies.` Se a mensagem acrescentar `To report a bug, open an issue`, faça isso em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Um rascunho na fila permanece na fila, e você pode [descartá-lo](https://code.claude.com/docs/pt/tools-reference.md#discard-or-keep-a-draft)2320* **Recusa da sua organização**: por exemplo `: Feedback has not been enabled for your organization.` ou `: Feedback collection is not available for organizations with custom data retention policies.` Se a mensagem acrescentar `To report a bug, open an issue`, faça isso em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Depois disso, `/feedback` pode responder que está [desativado pela política da sua organização](#feedback-is-disabled-by-your-organizations-policy) por sete dias. Um rascunho na fila permanece na fila e ainda [expira conforme o previsto](https://code.claude.com/docs/pt/tools-reference.md#discard-or-keep-a-draft)

2304* **Credenciais recusadas**: a mensagem continua com `: the sign-in this session uses is not allowed to send feedback` ou `: the server did not accept the credentials this session uses`. Execute `/status` no prompt do Claude Code para ver qual login, token ou chave de API esta sessão envia2321* **Credenciais recusadas**: a mensagem continua com `: the sign-in this session uses is not allowed to send feedback` ou `: the server did not accept the credentials this session uses`. Execute `/status` no prompt do Claude Code para ver qual login, token ou chave de API esta sessão envia

2305* **`(request timed out)` ou `(couldn't reach the service)` logo após `Couldn't send feedback`**: envie o relatório ou o rascunho na fila novamente. O diálogo mantém seu texto, e a mensagem de um rascunho na fila diz `The draft is still queued.` Se outras requisições também estiverem falhando, verifique sua conexão de rede e veja [Unable to connect to API](#unable-to-connect-to-api). Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2322* **`(request timed out)` ou `(couldn't reach the service)` logo após `Couldn't send feedback`**: envie o relatório ou o rascunho na fila novamente. O diálogo mantém seu texto, e a mensagem de um rascunho na fila diz `The draft is still queued.` Se outras requisições também estiverem falhando, verifique sua conexão de rede e veja [Unable to connect to API](#unable-to-connect-to-api). Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

2306* **`(server returned <status>)`, ou nenhum motivo, logo após `Couldn't send feedback`**: o status é o código de resposta do serviço. A própria mensagem do serviço vem depois dele quando foi enviada, como em `(server returned 403: Access Forbidden)`. Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2323* **`(server returned <status>)`, ou nenhum motivo, logo após `Couldn't send feedback`**: o status é o código de resposta do serviço. A própria mensagem do serviço vem depois dele quando foi enviada, como em `(server returned 403: Access Forbidden)`. Se continuar falhando, registre o relatório em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)


3431* **`Error: Workspace not trusted. <folder> is your home directory`**: como a confiança para seu diretório pessoal nunca é salva, executar `claude` ali primeiro não ajuda. Execute `claude ultrareview` a partir de um diretório de projeto, depois de executar `claude` ali uma vez para aceitar a caixa de diálogo de confiança, ou acrescente `--trust-workspace`.3448* **`Error: Workspace not trusted. <folder> is your home directory`**: como a confiança para seu diretório pessoal nunca é salva, executar `claude` ali primeiro não ajuda. Execute `claude ultrareview` a partir de um diretório de projeto, depois de executar `claude` ali uma vez para aceitar a caixa de diálogo de confiança, ou acrescente `--trust-workspace`.

3432* **`No answer in time.` seguido de `Error: Workspace not trusted`**: a pergunta `Trust <folder>? [y/N]` ficou sem resposta por 5 minutos. Execute `claude ultrareview` novamente e responda.3449* **`No answer in time.` seguido de `Error: Workspace not trusted`**: a pergunta `Trust <folder>? [y/N]` ficou sem resposta por 5 minutos. Execute `claude ultrareview` novamente e responda.

3433* **`Ultrareview did not start: <folder> is not trusted`**: você recusou na pergunta `Trust <folder>? [y/N]`, por exemplo respondendo `n` ou pressionando Enter. Para iniciar a revisão, execute `claude ultrareview` novamente e responda `y`.3450* **`Ultrareview did not start: <folder> is not trusted`**: você recusou na pergunta `Trust <folder>? [y/N]`, por exemplo respondendo `n` ou pressionando Enter. Para iniciar a revisão, execute `claude ultrareview` novamente e responda `y`.

3434* **``Ultrareview did not start: `--trust-workspace` takes no value``**: algo que não é uma flag vem depois de `--trust-workspace`, como um número de PR ou `false`. Se você não confia na pasta, não use a flag. Para confiar nela durante esta execução, coloque o número do PR ou o branch base antes da flag: `claude ultrareview 1234 --trust-workspace`.3451* **``Ultrareview did not start: `--trust-workspace` takes no value``**: algo que não é uma flag segue `--trust-workspace`, como um número de PR ou `false`. Se você não confia na pasta, omita a flag. Para confiar nela nesta execução, coloque o número do PR ou o branch base antes da flag: `claude ultrareview 1234 --trust-workspace`.

3435 3452 

3436Antes da v2.1.309, `claude ultrareview` não aceitava `--trust-workspace`.3453Antes da v2.1.309, `claude ultrareview` não aceitava `--trust-workspace`.

3437 3454 


3724 3741 

3725Mensagens semelhantes são disparadas antes mesmo de o comando ser executado:3742Mensagens semelhantes são disparadas antes mesmo de o comando ser executado:

3726 3743 

3727* `Shell command permission check failed for pattern "..."`: a verificação de permissão do comando não o permitiu. [Permission checks on injected commands](https://code.claude.com/docs/pt/skills.md#permission-checks-on-injected-commands) explica quais resultados abortam em cada modo de permissão e como pré-aprovar um comando com `allowed-tools`3744* `Shell command permission check failed for pattern "..."`: a verificação de permissão do comando não o permitiu. [Verificações de permissão em comandos injetados](https://code.claude.com/docs/pt/skills.md#permission-checks-on-injected-commands) explica quais resultados abortam em cada modo de permissão e como pré-aprovar um comando com `allowed-tools`

3728* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: o frontmatter da skill exige bash em uma máquina que não o tem. Instale o Git for Windows ou altere o frontmatter para `shell: powershell`. Consulte [How injected commands run](https://code.claude.com/docs/pt/skills.md#how-injected-commands-run)3745* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: o frontmatter da skill exige bash em uma máquina que não o tem. Instale o Git for Windows ou altere o frontmatter para `shell: powershell`. Consulte [How injected commands run](https://code.claude.com/docs/pt/skills.md#how-injected-commands-run)

3729 3746 

3730**O que fazer:**3747**O que fazer:**


3878 3895 

3879* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar seu branch base explicitamente, como no exemplo acima3896* **Você não passou um branch base**: o Claude Code comparou com o branch padrão do repositório e sugere passar seu branch base explicitamente, como no exemplo acima

3880* **Você passou um branch base que já estava no seu clone**: a dica diz ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3897* **Você passou um branch base que já estava no seu clone**: a dica diz ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3881* **Você passou um branch base que não estava no seu clone**: o Claude Code o buscou do origin antes de comparar. A dica diz ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando o Claude Code não consegue determinar se o seu clone é raso, ele sugere `git fetch --unshallow origin` em vez disso. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para todo branch base buscado, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.3898* **Você passou um branch base que não estava no seu clone**: o Claude Code o buscou do origin antes de comparar. A dica diz ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando o Claude Code não consegue dizer se seu clone é raso (shallow), ele sugere `git fetch --unshallow origin` em vez disso. Antes da v2.1.221, a dica sugeria `git fetch --unshallow origin` para todo branch base buscado, e em um clone completo esse comando falha com `fatal: --unshallow on a complete repository does not make sense`.

3882 3899 

3883**O que fazer:**3900**O que fazer:**

3884 3901 


4227 4244 

4228### /feedback está desativado pela política da sua organização4245### /feedback está desativado pela política da sua organização

4229 4246 

4230Esta mensagem significa que a política da sua organização não permite feedback sobre o produto a partir do Claude Code, então `/feedback`, `/bug` e `/share` não abrem a caixa de diálogo de feedback. A mensagem indica o comando que você digitou no prompt do Claude Code:4247Esta mensagem significa que o feedback sobre o produto está desativado, então o comando que você digitou não abre a caixa de diálogo de feedback. Tanto uma política da organização quanto uma recusa anterior produzem a mensagem:

4248 

4249* **Política da organização**: a política da sua organização não permite feedback sobre o produto a partir do Claude Code. `/feedback`, `/bug` e `/share` respondem todos com a mensagem.

4250* **Recusa anterior**: o serviço de feedback recusou um relatório que você enviou, por exemplo com [`Couldn't send feedback: Feedback has not been enabled for your organization.`](#couldnt-send-feedback) `/feedback` e `/bug` podem então responder com a mensagem. Isso dura sete dias a partir dessa recusa nesta máquina. Isso se aplica a todos os planos, incluindo Pro e Max.

4251 

4252A mensagem indica o comando que você digitou no prompt do Claude Code:

4231 4253 

4232```text wrap theme={null}4254```text wrap theme={null}

4233/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.4255/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.


4238**O que fazer:**4260**O que fazer:**

4239 4261 

4240* Para relatar um bug, abra uma issue em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Qualquer pessoa pode ler as issues ali, então omita código, transcrições e qualquer outra coisa confidencial.4262* Para relatar um bug, abra uma issue em [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Qualquer pessoa pode ler as issues ali, então omita código, transcrições e qualquer outra coisa confidencial.

4263* Após uma recusa anterior, aguarde até que os sete dias tenham passado e envie um relatório novamente para ver se o serviço ainda o recusa

4264 

4265Antes da v2.1.319, uma recusa anterior não produzia esta mensagem.

4241 4266 

4242Antes da v2.1.302, a mensagem completa dizia `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`4267Antes da v2.1.302, a mensagem completa dizia `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`

4243 4268 


4654* Para dar mais tempo a uma resposta, defina um [`timeout`](https://code.claude.com/docs/pt/mcp#time-limits-on-mcp-tool-calls) maior em milissegundos na entrada de configuração do servidor, como `"timeout": 600000` para 10 minutos4679* Para dar mais tempo a uma resposta, defina um [`timeout`](https://code.claude.com/docs/pt/mcp#time-limits-on-mcp-tool-calls) maior em milissegundos na entrada de configuração do servidor, como `"timeout": 600000` para 10 minutos

4655* Execute a tarefa em uma sessão interativa em vez disso e responda você mesmo ao [diálogo](https://code.claude.com/docs/pt/mcp.md#respond-to-mcp-elicitation-requests) do servidor4680* Execute a tarefa em uma sessão interativa em vez disso e responda você mesmo ao [diálogo](https://code.claude.com/docs/pt/mcp.md#respond-to-mcp-elicitation-requests) do servidor

4656 4681 

4682### Permission prompt tool returned an invalid result

4683 

4684A ferramenta que você passou para [`--permission-prompt-tool`](https://code.claude.com/docs/pt/cli-reference#cli-flags) retornou uma resposta que Claude Code não conseguiu ler, então a chamada de ferramenta que aguardava por ela não foi executada, mesmo que a resposta permitisse a chamada:

4685 

4686```text wrap theme={null}

4687Permission prompt tool returned an invalid result. Expected a single text block param with type="text" and a string text value.

4688```

4689 

4690**O que fazer:**

4691 

4692* Retorne um bloco de texto cujo texto seja `{"behavior": "allow"}` ou `{"behavior": "deny", "message": "<reason>"}`. Para alterar a entrada, adicione `updatedInput` ao objeto `allow`. Da v2.1.86 até a v2.1.206, um `allow` precisava de `"updatedInput": {}` para manter a entrada.

4693* Não retorne [`structuredContent`](https://code.claude.com/docs/pt/agent-sdk/custom-tools#return-structured-data), que seu MCP SDK pode adicionar por conta própria. Por exemplo, registre a ferramenta:

4694 * **`FastMCP` ou `MCPServer` de `mcp.server`**: com `structured_output=False`

4695 * **`FastMCP` de `fastmcp`**: com `output_schema=None`, e retorne uma string

4696 * **MCP TypeScript SDK**: sem `outputSchema`

4697* Se o erro ocorre apenas com entradas de cerca de 40 KB ou mais, não copie a entrada para `updatedInput` ou para a `message` de uma negação. Para alterar uma entrada tão grande, [aumente o limite de saída da sua ferramenta de prompt](https://code.claude.com/docs/pt/mcp.md#raise-the-limit-for-a-specific-tool).

4698 

4657### Agent seria iniciado com zero ferramentas4699### Agent seria iniciado com zero ferramentas

4658 4700 

4659Cada entrada na lista [`tools` do subagente](https://code.claude.com/docs/pt/sub-agents#supported-frontmatter-fields) falhou em corresponder a uma ferramenta utilizável, então Claude Code recusou iniciar o subagente: sem ferramentas, ele não poderia agir. A mensagem agrupa suas entradas pelo que deu errado:4701Cada entrada na lista [`tools` do subagente](https://code.claude.com/docs/pt/sub-agents#supported-frontmatter-fields) falhou em corresponder a uma ferramenta utilizável, então Claude Code recusou iniciar o subagente: sem ferramentas, ele não poderia agir. A mensagem agrupa suas entradas pelo que deu errado:


6432 6474 

6433Antes da v2.1.257, `claude doctor` não sinalizava esses arquivos; versões anteriores deixam os mesmos espaços reservados para trás quando uma sessão é morta.6475Antes da v2.1.257, `claude doctor` não sinalizava esses arquivos; versões anteriores deixam os mesmos espaços reservados para trás quando uma sessão é morta.

6434 6476 

6477### Two Claude Code config files exist

6478 

6479Claude Code está usando o primeiro arquivo que esta mensagem nomeia, então o que está no segundo arquivo não está em vigor. O primeiro é `.config.json`, um nome mais antigo para [`.claude.json`](https://code.claude.com/docs/pt/claude-directory#ce-claude-json). A mensagem inclui uma verificação de qual arquivo contém sua configuração:

6480 

6481```text wrap theme={null}

6482Two Claude Code config files exist: this run uses /home/you/.claude/.config.json, not /home/you/.claude.json. The file with the higher count here is usually yours, and this prints nothing else from them: grep -c -E '"(hasCompletedOnboarding|mcpServers)"' "/home/you/.claude/.config.json" "/home/you/.claude.json". To end this: if several hosts share this home, first get every host to version 2.1.319 or later, since an older one can write a moved .config.json back. Then stop your Claude processes on every host, move aside the one you do not want, and start none until no host lists it.

6483```

6484 

6485No Windows, `The one with hasCompletedOnboarding or mcpServers in it is usually yours.` substitui a frase com o comando `grep`.

6486 

6487**O que fazer:**

6488 

6489**1. Encontre o arquivo que contém sua configuração**

6490 

6491* **No Windows**: abra os dois arquivos e veja qual deles contém `hasCompletedOnboarding` ou `mcpServers`

6492* **Em outras plataformas**: no seu shell, execute o comando `grep` da mensagem e veja qual arquivo tem a contagem mais alta

6493 

6494**2. Atualize todos os hosts que compartilham o diretório pessoal**

6495 

6496Se vários hosts compartilham este diretório pessoal, primeiro atualize Claude Code em todos os hosts para a versão que a mensagem nomeia ou posterior. Uma versão mais antiga pode escrever de volta um `.config.json` movido.

6497 

6498**3. Pare Claude Code**

6499 

6500Pare seus processos de Claude Code em todos os hosts.

6501 

6502**4. Mova o arquivo que você não quer**

6503 

6504Mova o arquivo que você não quer para fora de sua pasta. Mova-o em vez de excluí-lo, para que você possa colocá-lo de volta.

6505 

6506**5. Aguarde antes de iniciar Claude Code novamente**

6507 

6508Não inicie Claude Code em nenhum host até que nenhum host ainda liste o arquivo movido em seu caminho antigo.

6509 

6510A mensagem para assim que um dos dois arquivos deixa de existir.

6511 

6435### Make this change again later: \~/.claude.json could not be updated6512### Make this change again later: \~/.claude.json could not be updated

6436 6513 

6437Este aviso em stderr significa que uma alteração em [`~/.claude.json`](https://code.claude.com/docs/pt/claude-directory#ce-claude-json), como um login ou uma resposta a um prompt de confiança, não foi salva no arquivo:6514Este aviso em stderr significa que uma alteração em [`~/.claude.json`](https://code.claude.com/docs/pt/claude-directory#ce-claude-json), como um login ou uma resposta a um prompt de confiança, não foi salva no arquivo:


6450 6527 

6451* Um [`--fallback-model`](https://code.claude.com/docs/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição6528* Um [`--fallback-model`](https://code.claude.com/docs/pt/cli-reference#cli-flags) configurado assume o controle após um erro de disponibilidade, apenas para esse turno, com um aviso na transcrição

6452* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível, ou sua conta [perde acesso a ele durante a sessão](https://code.claude.com/docs/pt/amazon-bedrock.md#when-a-model-is-disabled-mid-session)6529* Uma verificação de inicialização do Amazon Bedrock ou da Agent Platform do Google Cloud encontra seu modelo padrão indisponível, ou sua conta [perde acesso a ele durante a sessão](https://code.claude.com/docs/pt/amazon-bedrock.md#when-a-model-is-disabled-mid-session)

6453* [Fallback automático de modelo](https://code.claude.com/docs/pt/model-config.md#automatic-model-fallback) no Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 e Opus 5 move a sessão para o modelo de fallback da categoria sinalizada, quando essa categoria tem um, e mostra um aviso na transcrição6530* [Fallback automático de modelo](https://code.claude.com/docs/pt/model-config.md#automatic-model-fallback) nos modelos Fable, Opus 5.5, Sonnet 5.5 e Opus 5 move a sessão para o modelo de fallback da categoria sinalizada, quando essa categoria tem um. Um aviso aparece na transcrição

6454 6531 

6455A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](https://code.claude.com/docs/pt/model-config.md) explica quando cada fallback se aplica.6532A verificação de seleção de modelo abaixo captura o segundo e terceiro casos; o primeiro aparece como um aviso de transcrição em vez de uma mudança de `/model`. [Configuração de modelo](https://code.claude.com/docs/pt/model-config.md) explica quando cada fallback se aplica.

6456 6533 

fast-mode.md +21 −16

Details

4 4 

5# Acelere respostas com modo rápido5# Acelere respostas com modo rápido

6 6 

7> Obtenha respostas mais rápidas do Opus no Claude Code alternando o modo rápido.7> Obtenha respostas mais rápidas do Opus e do Fable no Claude Code alternando o modo rápido com `/fast`.

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> O modo rápido para Claude Opus 5.5 está disponível, e o modo rápido para Claude Opus 5 e Claude Opus 4.8 está em [prévia de pesquisa](#research-preview).11> O modo rápido para Claude Fable 5.2 e Claude Opus 5.5 está disponível. O modo rápido para Claude Opus 5 e Claude Opus 4.8 está em [prévia de pesquisa](#research-preview).

12 12 

13O modo rápido é uma configuração de alta velocidade para Claude Opus, tornando o modelo até 2,5x mais rápido a um custo maior por token. Ative-o com `/fast` quando você precisar de velocidade para trabalho interativo como iteração rápida ou depuração ao vivo, e desative-o quando o custo importa mais do que a latência.13O modo rápido é uma configuração de alta velocidade para modelos suportados, tornando o modelo até 2,5x mais rápido a um custo maior por token. Ative-o com `/fast` quando você precisar de velocidade para trabalho interativo como iteração rápida ou depuração ao vivo, e desative-o quando o custo importa mais do que a latência.

14 14 

15O modo rápido não é um modelo diferente. Ele usa Claude Opus com uma configuração de API diferente que prioriza a velocidade sobre a eficiência de custo. Você obtém qualidade e capacidades idênticas com respostas mais rápidas. O modo rápido é suportado no Opus 5.5, Opus 5 e Opus 4.8. Não está disponível no Sonnet, Haiku ou outros modelos.15O modo rápido usa o mesmo modelo com uma configuração de API diferente que prioriza a velocidade sobre a eficiência de custo, portanto a qualidade e as capacidades permanecem as mesmas. O modo rápido é suportado no Fable 5.2, Opus 5.5, Opus 5 e Opus 4.8. Não está disponível no Sonnet, Haiku ou outros modelos.

16 16 

17> [!WARNING]17> [!WARNING]

18>18>


26O que você precisa saber:26O que você precisa saber:

27 27 

28* Use `/fast` para alternar o modo rápido no CLI do Claude Code. A [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) oferece um comando **Toggle fast mode** quando o modelo selecionado suporta modo rápido. O Claude Code salva essa alternância na sua configuração [`fastMode`](#toggle-fast-mode).28* Use `/fast` para alternar o modo rápido no CLI do Claude Code. A [extensão VS Code](https://code.claude.com/docs/pt/vs-code.md) oferece um comando **Toggle fast mode** quando o modelo selecionado suporta modo rápido. O Claude Code salva essa alternância na sua configuração [`fastMode`](#toggle-fast-mode).

29* O preço do modo rápido por MTok de entrada/saída é \$8/\$40 no Opus 5.5 e \$10/\$50 no Opus 5 e Opus 4.8.29* O preço do modo rápido por MTok de entrada/saída é \$16/\$80 no Fable 5.2, \$8/\$40 no Opus 5.5 e \$10/\$50 no Opus 5 e Opus 4.8.

30* Disponível para usuários do Claude Code em planos de assinatura (Pro/Max/Ultra/Team/Enterprise) e no Claude Console. Organizações Team e Enterprise precisam que um Owner o ative primeiro, e organizações Console precisam ter acesso provisionado primeiro para usá-lo com Opus 5 ou Opus 4.8. [Requisitos](#requirements) descreve ambos.30* Disponível para usuários do Claude Code em planos de assinatura (Pro/Max/Ultra/Team/Enterprise) e no Claude Console. Organizações Team e Enterprise precisam que um Owner o ative primeiro, e organizações Console precisam ter acesso provisionado primeiro para usá-lo com Opus 5 ou Opus 4.8. [Requisitos](#requirements) descreve ambos.

31* Para usuários do Claude Code em planos de assinatura (Pro/Max/Ultra/Team/Enterprise), o modo rápido está disponível apenas via créditos de uso e não está incluído nos rate limits da assinatura.31* Para usuários do Claude Code em planos de assinatura (Pro/Max/Ultra/Team/Enterprise), o modo rápido está disponível apenas via créditos de uso e não está incluído nos rate limits da assinatura.

32 32 


35Na CLI, alterne o modo rápido de uma destas formas:35Na CLI, alterne o modo rápido de uma destas formas:

36 36 

37* Execute `/fast`, pressione Space para alternar ativado ou desativado, depois pressione Enter para confirmar37* Execute `/fast`, pressione Space para alternar ativado ou desativado, depois pressione Enter para confirmar

38* Em um modelo que suporta modo rápido, defina `"fastMode": true` no seu [arquivo de configurações do usuário](https://code.claude.com/docs/pt/settings.md). Se você defini-lo em qualquer outro modelo, você permanece nesse modelo com o modo rápido desativado.38* Em um modelo que suporta modo rápido, defina `"fastMode": true` no seu [arquivo de configurações do usuário](https://code.claude.com/docs/pt/settings.md). Se você defini-lo em qualquer outro modelo, você permanece nesse modelo com o modo rápido desativado. No Fable 5.2, essa configuração sozinha não tem efeito até que você execute `/fast` enquanto usa o Fable 5.2.

39 39 

40Por padrão, o modo rápido que você ativa em uma sessão interativa persiste entre sessões em um modelo suportado. Você pode configurar o modo rápido para ser redefinido a cada sessão. Consulte [require per-session opt-in](#require-per-session-opt-in) para obter detalhes.40Por padrão, o modo rápido que você ativa em uma sessão interativa persiste entre sessões em um modelo suportado. No Fable 5.2, ele persiste apenas se você [o ativou enquanto usava o Fable 5.2](#switch-models-while-fast-mode-is-on). Você pode configurar o modo rápido para ser redefinido a cada sessão. Consulte [require per-session opt-in](#require-per-session-opt-in) para obter detalhes.

41 41 

42Fora de uma [sessão em nuvem](#use-fast-mode-in-cloud-sessions), no [modo não interativo](https://code.claude.com/docs/pt/headless.md) com a flag `-p`, `/fast` funciona apenas em uma sessão iniciada com modo rápido em seu valor [`--settings`](https://code.claude.com/docs/pt/cli-reference#cli-flags), por exemplo `claude -p --settings '{"fastMode": true}'`; a alternância então se aplica apenas a essa sessão e não é salva como seu padrão. O formulário `-p` requer Claude Code v2.1.205 ou posterior. Em qualquer outro lugar no modo não interativo, o comando relata que o modo rápido não está disponível.42Fora de uma [sessão em nuvem](#use-fast-mode-in-cloud-sessions), no [modo não interativo](https://code.claude.com/docs/pt/headless.md) com a flag `-p`, `/fast` funciona apenas em uma sessão iniciada com modo rápido em seu valor [`--settings`](https://code.claude.com/docs/pt/cli-reference#cli-flags), por exemplo `claude -p --settings '{"fastMode": true}'`; a alternância então se aplica apenas a essa sessão e não é salva como seu padrão. O formulário `-p` requer Claude Code v2.1.205 ou posterior. Em qualquer outro lugar no modo não interativo, o comando relata que o modo rápido não está disponível.

43 43 


48Quando você ativa o modo rápido com `/fast`:48Quando você ativa o modo rápido com `/fast`:

49 49 

50* Se seu modelo atual não suportar modo rápido, Claude Code alterna para Opus50* Se seu modelo atual não suportar modo rápido, Claude Code alterna para Opus

51* O modo rápido no Fable 5.2 requer Claude Code v2.1.321 ou posterior

51* Você verá uma mensagem de confirmação: "Fast mode ON"52* Você verá uma mensagem de confirmação: "Fast mode ON"

52* Um pequeno ícone `↯` aparece ao lado do prompt enquanto o modo rápido está ativo53* Um pequeno ícone `↯` aparece ao lado do prompt enquanto o modo rápido está ativo

53* Execute `/fast` novamente a qualquer momento para verificar se o modo rápido está ativado ou desativado54* Execute `/fast` novamente a qualquer momento para verificar se o modo rápido está ativado ou desativado

54 55 

55Opus 5.5 é o padrão do modo rápido no Claude Code v2.1.280 e posterior. Antes da v2.1.280, o modo rápido usava como padrão Opus 5 a partir da v2.1.219.56Opus 5.5 é o padrão do modo rápido no Claude Code v2.1.280 e posterior. Antes da v2.1.280, o modo rápido usava como padrão Opus 5 a partir da v2.1.219.

56 57 

57Quando você desativa o modo rápido com `/fast` novamente, você permanece no Opus. Para alternar para um modelo diferente, use `/model`.58Quando você desativa o modo rápido com `/fast` novamente, você permanece no seu modelo atual. Para alternar para um modelo diferente, use `/model`.

58 59 

59### Alternar modelos enquanto o modo rápido está ativado60### Alternar modelos enquanto o modo rápido está ativado

60 61 

61O modo rápido segue suas alternâncias de modelo em ambas as direções:62O modo rápido segue suas alternâncias de modelo:

62 63 

63* **Alternar para outro**: quando você alterna para um modelo que não suporta modo rápido, Claude Code desativa o modo rápido. Isso inclui Opus 4.7; antes da v2.1.221, o modo rápido permanecia ativado após uma alternância para Opus 4.7 e a API rejeitava as solicitações.64* **Alternar para outro**: quando você alterna para um modelo que não suporta modo rápido, Claude Code desativa o modo rápido. Isso inclui Opus 4.7; antes da v2.1.221, o modo rápido permanecia ativado após uma alternância para Opus 4.7 e a API rejeitava as solicitações.

64* **Alternar de volta**: alternar de volta para um modelo Opus suportado ativa o modo rápido novamente quando sua preferência de modo rápido salva está ativada, a mesma preferência que uma nova sessão inicia por padrão. Uma alternância de modelo nunca ativa o modo rápido para uma sessão cuja preferência salva está desativada, e com [per-session opt-in](#require-per-session-opt-in) configurado, alternar de volta não ativa o modo rápido novamente; execute `/fast` para reativá-lo.65* **Alternar de volta**: o modo rápido volta a ser ativado em um modelo Opus suportado quando sua preferência salva está ativada. Com [per-session opt-in](#require-per-session-opt-in), execute `/fast` em vez disso.

66* **Alternar para o Fable 5.2**: o modo rápido é desativado, a menos que você o tenha ativado enquanto usava o Fable 5.2. Para ativá-lo, execute `/fast` no Fable 5.2. A menos que você tenha configurado [per-session opt-in](#require-per-session-opt-in), isso persiste entre sessões até que você o desative ou o ative com outro modelo.

65 67 

66Sempre que uma alternância de modelo ativa ou desativa o modo rápido, Claude Code mostra uma confirmação `Fast mode ON` ou `Fast mode OFF`, e o ícone `↯` aparece enquanto o modo rápido está ativado. Isso vale se você alternar com `/model`, com [`/config model=<model>`](https://code.claude.com/docs/pt/settings), ou de um dispositivo conectado através de [Remote Control](https://code.claude.com/docs/pt/remote-control.md).68Sempre que uma alternância de modelo ativa ou desativa o modo rápido, Claude Code mostra uma confirmação `Fast mode ON` ou `Fast mode OFF`, e o ícone `↯` aparece enquanto o modo rápido está ativado. Isso vale se você alternar com `/model`, com [`/config model=<model>`](https://code.claude.com/docs/pt/settings), ou de um dispositivo conectado através de [Remote Control](https://code.claude.com/docs/pt/remote-control.md).

67 69 


77 79 

78## Entender o tradeoff de custo80## Entender o tradeoff de custo

79 81 

80O modo rápido tem preços por token mais altos do que o Opus padrão:82O modo rápido tem preços por token mais altos do que a velocidade padrão:

81 83 

82| Modelo | Entrada (MTok) | Saída (MTok) |84| Modelo | Entrada (MTok) | Saída (MTok) |

83| - | - | - |85| - | - | - |

86| Fable 5.2 | \$16 | \$80 |

84| Opus 5.5 | \$8 | \$40 |87| Opus 5.5 | \$8 | \$40 |

85| Opus 5 | \$10 | \$50 |88| Opus 5 | \$10 | \$50 |

86| Opus 4.8 | \$10 | \$50 |89| Opus 4.8 | \$10 | \$50 |

87 90 

88O preço do modo rápido é fixo em toda a janela de contexto de 1M token. Para a taxa padrão do Opus para comparar, consulte a [referência de preços do Claude](https://platform.claude.com/docs/pt/about-claude/pricing).91O preço do modo rápido é fixo em toda a janela de contexto de 1M token. Para a taxa padrão para comparar, consulte a [referência de preços do Claude](https://platform.claude.com/docs/pt/about-claude/pricing).

89 92 

90A primeira vez que você ativa o modo rápido em uma conversa, você paga o preço total do token de entrada não armazenado em cache do modo rápido para todo o contexto da conversa. Quanto mais profundo você estiver em uma conversa, mais isso custa, portanto a cobrança é menor quando você ativa o modo rápido no início. O modo rápido e a velocidade padrão mantêm [caches separados](https://code.claude.com/docs/pt/prompt-caching.md#turning-on-fast-mode), portanto cada alternância posterior lê parte ou toda a conversa novamente sem cache.93A primeira vez que você ativa o modo rápido em uma conversa, você paga o preço total do token de entrada não armazenado em cache do modo rápido para todo o contexto da conversa. Quanto mais profundo você estiver em uma conversa, mais isso custa, portanto a cobrança é menor quando você ativa o modo rápido no início. O modo rápido e a velocidade padrão mantêm [caches separados](https://code.claude.com/docs/pt/prompt-caching.md#turning-on-fast-mode), portanto cada alternância posterior lê parte ou toda a conversa novamente sem cache.

91 94 


137 140 

138* **Organização Console paga**: contas do Claude Console não usam créditos de uso, e sua organização paga pelo modo rápido por token junto com o resto do seu uso de API. No plano Evaluation gratuito do Console, `/fast` mostra "Fast mode unavailable during evaluation. Please purchase credits." Para limpar isso, compre créditos nas suas [configurações de cobrança do Console](https://platform.claude.com/settings/billing).141* **Organização Console paga**: contas do Claude Console não usam créditos de uso, e sua organização paga pelo modo rápido por token junto com o resto do seu uso de API. No plano Evaluation gratuito do Console, `/fast` mostra "Fast mode unavailable during evaluation. Please purchase credits." Para limpar isso, compre créditos nas suas [configurações de cobrança do Console](https://platform.claude.com/settings/billing).

139 142 

140 O modo rápido com Opus 5.5 também depende do [nível de uso](https://platform.claude.com/docs/en/api/rate-limits) da sua organização.143 O modo rápido com Fable 5.2 ou Opus 5.5 também depende do [nível de uso](https://platform.claude.com/docs/en/api/rate-limits) da sua organização.

141* **Habilitação de proprietário para Team e Enterprise**: o modo rápido está desativado por padrão para organizações Team e Enterprise. Um proprietário deve explicitamente [ativar o modo rápido](#enable-fast-mode-for-your-organization) antes que os usuários possam acessá-lo.144* **Habilitação de proprietário para Team e Enterprise**: o modo rápido está desativado por padrão para organizações Team e Enterprise. Um proprietário deve explicitamente [ativar o modo rápido](#enable-fast-mode-for-your-organization) antes que os usuários possam acessá-lo.

142 145 

143> [!NOTE]146> [!NOTE]


147> * **Modo rápido não ativado**: se o modo rápido não tiver sido ativado para sua organização, ativar o modo rápido com `/fast` mostra "Fast mode has been disabled by your organization."150> * **Modo rápido não ativado**: se o modo rápido não tiver sido ativado para sua organização, ativar o modo rápido com `/fast` mostra "Fast mode has been disabled by your organization."

148> * **Modo rápido desativado por configurações gerenciadas**: se sua organização implanta [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) que definem [`fastMode: false`](https://code.claude.com/docs/pt/settings-reference#fastmode), ativar o modo rápido com `/fast` mostra a mesma mensagem "Fast mode has been disabled by your organization".151> * **Modo rápido desativado por configurações gerenciadas**: se sua organização implanta [configurações gerenciadas](https://code.claude.com/docs/pt/managed-settings.md) que definem [`fastMode: false`](https://code.claude.com/docs/pt/settings-reference#fastmode), ativar o modo rápido com `/fast` mostra a mesma mensagem "Fast mode has been disabled by your organization".

149> * **Opt-in obrigatório por sessão**: configurações gerenciadas que definem [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) recusam `/fast on` com a mesma mensagem em todos os lugares, exceto em uma sessão de terminal interativa.152> * **Opt-in obrigatório por sessão**: configurações gerenciadas que definem [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) recusam `/fast on` com a mesma mensagem em todos os lugares, exceto em uma sessão de terminal interativa.

150> * **Modelo de modo rápido não permitido**: se a lista de permissões [`availableModels`](https://code.claude.com/docs/pt/model-config#restrict-model-selection) da sua organização excluir o modelo Opus do modo rápido, ativá-lo é recusado com "is not in your organization's allowed models". Em uma sessão já em execução em um modelo Opus permitido que suporte modo rápido, `/fast` ativa o modo rápido no seu modelo atual sem alternar modelos.153> * **Modelo de modo rápido não permitido**: se a allowlist [`availableModels`](https://code.claude.com/docs/pt/model-config#restrict-model-selection) da sua organização excluir o modelo Opus do modo rápido, ativá-lo é recusado com "is not in your organization's allowed models". Em uma sessão já em execução em um modelo permitido que suporte modo rápido, `/fast` em vez disso ativa o modo rápido no seu modelo atual sem alternar modelos.

151 154 

152### Ativar modo rápido para sua organização155### Ativar modo rápido para sua organização

153 156 


196 199 

197### Exigir opt-in por sessão200### Exigir opt-in por sessão

198 201 

199Por padrão, o modo rápido que um usuário ativa em uma sessão interativa persiste entre sessões em um modelo compatível. Para alterar isso, defina `fastModePerSessionOptIn` como `true` em qualquer [arquivo de configurações](https://code.claude.com/docs/pt/settings.md#where-settings-live), o que faz com que cada sessão comece com o modo rápido desativado e exija que os usuários o ativem explicitamente com `/fast`. Os proprietários em planos [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) ou [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) podem implantá-lo em toda a organização através de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md).202Por padrão, o modo rápido que um usuário ativa em uma sessão interativa persiste entre sessões em um modelo compatível. No Fable 5.2, ele persiste apenas se o usuário [o ativou enquanto usava o Fable 5.2](#switch-models-while-fast-mode-is-on).

203 

204Para fazer com que cada sessão comece com o modo rápido desativado, defina `fastModePerSessionOptIn` como `true` em qualquer [arquivo de configurações](https://code.claude.com/docs/pt/settings.md#where-settings-live). Os usuários então o ativam com `/fast` em cada sessão. Os Owners em planos [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) ou [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) podem implantá-lo em toda a organização através de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md).

200 205 

201```json theme={null}206```json theme={null}

202{207{


210 215 

211## Lidar com limites de taxa216## Lidar com limites de taxa

212 217 

213O modo rápido tem rate limits separados do Opus padrão; para organizações do Console, a página de [rate limits](https://platform.claude.com/docs/en/api/rate-limits) da Claude Platform os descreve. Quando você atinge o rate limit do modo rápido:218O modo rápido tem rate limits separados da velocidade padrão; para organizações do Console, a página de [rate limits](https://platform.claude.com/docs/en/api/rate-limits) da Claude Platform os descreve. Quando você atinge o rate limit do modo rápido:

214 219 

2151. O modo rápido automaticamente volta para velocidade padrão2201. O modo rápido automaticamente volta para velocidade padrão

2162. O ícone `↯` fica cinza para indicar cooldown2212. O ícone `↯` fica cinza para indicar cooldown

hooks.md +12 −4

Details

1089 1089 

1090#### Emitir notificações de terminal1090#### Emitir notificações de terminal

1091 1091 

1092Hooks executam sem um terminal controlador, portanto escrever sequências de escape diretamente para `/dev/tty` falha. Em vez disso, retorne a sequência de escape no campo `terminalSequence` e Claude Code a emite para você através de seu próprio caminho de escrita de terminal. Isso é livre de corrida, funciona dentro de tmux e GNU screen, e funciona no Windows onde não há `/dev/tty`.1092Hooks executam sem um terminal controlador, portanto escrever sequências de escape diretamente para `/dev/tty` falha. Em vez disso, retorne a sequência de escape no campo `terminalSequence` e Claude Code a emite para você através de seu próprio caminho de escrita de terminal. Isso é livre de corrida e funciona no Windows onde não há `/dev/tty`.

1093 1093 

1094O campo aceita uma string de uma ou mais sequências de escape da allowlist:1094O campo aceita uma string de uma ou mais sequências de escape da allowlist:

1095 1095 


1101 1101 

1102Sequências podem ser terminadas com BEL ou com ST. Qualquer coisa fora da allowlist, incluindo sequências de cursor e cor CSI, sequências de paleta OSC, hiperlinks OSC 8, escritas de área de transferência OSC 52 e OSC 1337, é rejeitada e o campo é ignorado.1102Sequências podem ser terminadas com BEL ou com ST. Qualquer coisa fora da allowlist, incluindo sequências de cursor e cor CSI, sequências de paleta OSC, hiperlinks OSC 8, escritas de área de transferência OSC 52 e OSC 1337, é rejeitada e o campo é ignorado.

1103 1103 

1104Claude Code escreve a sequência em si quando processa a saída do seu hook, portanto o campo funciona em eventos que descartam `systemMessage` e `continue`, como `Notification` e `StopFailure`. Tem dois limites:1104Claude Code escreve a sequência em si quando processa a saída do seu hook, portanto o campo funciona em eventos que descartam `systemMessage` e `continue`, como `Notification` e `StopFailure`. Tem alguns limites:

1105 1105 

1106* Claude Code escreve a sequência apenas em uma sessão interativa, e apenas enquanto sua interface está na tela. Em modo não interativo com a flag `-p` e no Agent SDK, ignora o campo.1106* Claude Code escreve a sequência apenas em uma sessão interativa, e apenas enquanto sua interface está aberta. Em modo não interativo com a flag `-p` e no Agent SDK, ignora o campo.

1107* O campo funciona apenas a partir de um hook que não é executado em [segundo plano](#run-hooks-in-the-background), portanto deixe `async` e `asyncRewake` desativados.

1107* Um hook de comando `WorktreeCreate` não pode retornar JSON, porque Claude Code lê seu stdout como o caminho de worktree. Um hook HTTP `WorktreeCreate` retorna JSON e pode incluir o campo.1108* Um hook de comando `WorktreeCreate` não pode retornar JSON, porque Claude Code lê seu stdout como o caminho de worktree. Um hook HTTP `WorktreeCreate` retorna JSON e pode incluir o campo.

1108 1109 

1109O exemplo abaixo dispara uma notificação de desktop de um hook `Notification`. A sequência de escape é construída com `printf` escapes octais para que os bytes de controle nunca apareçam na linha de comando do shell, e `jq -n --arg` constrói a saída JSON para que aspas, barras invertidas e quebras de linha na mensagem de notificação sejam escapadas corretamente:1110Se você usa tmux ou GNU screen, conclua primeiro [a configuração para eles](#get-terminal-notifications-inside-tmux-or-gnu-screen). O exemplo abaixo dispara uma notificação de desktop de um hook `Notification` em um terminal que lê OSC `777`, como Ghostty ou Warp. A chamada `jq -nc --arg` do script constrói a saída JSON e escapa quaisquer aspas, barras invertidas e quebras de linha na mensagem de notificação:

1110 1111 

1111```bash theme={null}1112```bash theme={null}

1112#!/bin/bash1113#!/bin/bash


1120 1121 

1121A forma `{ "terminalSequence": "..." }` é a mesma de qualquer shell ou linguagem.1122A forma `{ "terminalSequence": "..." }` é a mesma de qualquer shell ou linguagem.

1122 1123 

1124#### Receber notificações de terminal dentro de tmux ou GNU screen

1125 

1126Quando Claude Code é executado dentro de tmux ou GNU screen, as sequências OSC precisam do seguinte para chegar ao seu aplicativo de terminal:

1127 

1128* **tmux 3.3 ou posterior**: adicione `set -g allow-passthrough on` a `~/.tmux.conf` e então execute `tmux source-file ~/.tmux.conf` a partir de um shell. A opção se aplica a todos os programas nesses painéis, não apenas ao Claude Code. Com `on`, apenas os painéis que o tmux está mostrando podem enviá-las. Para permitir que outros painéis em uma sessão à qual você está conectado também as enviem, use `all` no lugar de `on`, no tmux 3.4 ou posterior.

1129* **GNU screen**: mantenha a janela do Claude Code visível no screen, porque sequências de uma janela em segundo plano não chegam ao seu aplicativo de terminal

1130 

1123#### Adicionar contexto para Claude1131#### Adicionar contexto para Claude

1124 1132 

1125O campo `additionalContext` passa uma string do seu hook para a janela de contexto do Claude. Claude Code envolve a string em um [lembrete do sistema](https://code.claude.com/docs/pt/glossary.md#system-reminder) e a insere na conversa no ponto onde o hook disparou. Claude lê o lembrete na próxima requisição ao modelo, mas não aparece como uma mensagem de chat na interface.1133O campo `additionalContext` passa uma string do seu hook para a janela de contexto do Claude. Claude Code envolve a string em um [lembrete do sistema](https://code.claude.com/docs/pt/glossary.md#system-reminder) e a insere na conversa no ponto onde o hook disparou. Claude lê o lembrete na próxima requisição ao modelo, mas não aparece como uma mensagem de chat na interface.

Details

223| Campos de [ferramenta](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) beta | Headers beta relacionados a ferramentas emparelhados com campos de esquema de ferramenta como `strict` e `defer_loading` | `400` nomeando o campo de esquema de ferramenta não reconhecido quando o corpo passa sem seu header. Para `defer_loading`, consulte [Tentar novamente sem busca de ferramentas](#retry-without-tool-search) | Encaminhe ambos, ou [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |223| Campos de [ferramenta](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) beta | Headers beta relacionados a ferramentas emparelhados com campos de esquema de ferramenta como `strict` e `defer_loading` | `400` nomeando o campo de esquema de ferramenta não reconhecido quando o corpo passa sem seu header. Para `defer_loading`, consulte [Tentar novamente sem busca de ferramentas](#retry-without-tool-search) | Encaminhe ambos, ou [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

224| [Esforço](https://platform.claude.com/docs/en/build-with-claude/effort) e [saídas estruturadas](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | O campo de corpo `output_config` carrega esforço, formato de saída estruturada e configurações de orçamento de tarefa; cada um emparelhado com seu próprio header beta | `400` nomeando `output_config`, frequentemente `Extra inputs are not permitted`, em upstreams Amazon Bedrock e Agent Platform do Google Cloud | Encaminhe o campo e seus headers juntos, ou peça aos desenvolvedores que definam [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities), que remove as configurações de formato e de orçamento de tarefa, mas não o esforço. Para remover apenas o formato, eles podem definir [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](https://code.claude.com/docs/pt/env-vars) em vez disso, o que requer v2.1.288 ou posterior |224| [Esforço](https://platform.claude.com/docs/en/build-with-claude/effort) e [saídas estruturadas](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | O campo de corpo `output_config` carrega esforço, formato de saída estruturada e configurações de orçamento de tarefa; cada um emparelhado com seu próprio header beta | `400` nomeando `output_config`, frequentemente `Extra inputs are not permitted`, em upstreams Amazon Bedrock e Agent Platform do Google Cloud | Encaminhe o campo e seus headers juntos, ou peça aos desenvolvedores que definam [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities), que remove as configurações de formato e de orçamento de tarefa, mas não o esforço. Para remover apenas o formato, eles podem definir [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](https://code.claude.com/docs/pt/env-vars) em vez disso, o que requer v2.1.288 ou posterior |

225| Mensagens de sistema no meio da conversa | Sem header beta. Claude Code envia parte do texto de lembretes e anexos como entradas `role: "system"` em `messages` para Claude Opus 4.8, modelos lançados depois dele e IDs de modelo não reconhecidos | `400` como `Unexpected role "system"` | Claude Code [tenta novamente sem mensagens de sistema](#automatic-retry-and-error-forwarding). Para interromper as mensagens de sistema em um alias de um modelo lançado antes do Claude Opus 4.8, adicione uma [entrada `modelOverrides`](#settings-for-unrecognized-model-ids) às configurações que você distribui |225| Mensagens de sistema no meio da conversa | Sem header beta. Claude Code envia parte do texto de lembretes e anexos como entradas `role: "system"` em `messages` para Claude Opus 4.8, modelos lançados depois dele e IDs de modelo não reconhecidos | `400` como `Unexpected role "system"` | Claude Code [tenta novamente sem mensagens de sistema](#automatic-retry-and-error-forwarding). Para interromper as mensagens de sistema em um alias de um modelo lançado antes do Claude Opus 4.8, adicione uma [entrada `modelOverrides`](#settings-for-unrecognized-model-ids) às configurações que você distribui |

226| [Esforço definido por turno](https://code.claude.com/docs/pt/prompt-caching.md#changing-effort-level) | Em Opus 5.5, Sonnet 5.5, Haiku 5.5 e Fable 5.1, um header beta emparelhado com `output_config.effort` em entradas `role: "system"`, seja uma mensagem de sistema ou uma entrada com conteúdo vazio | `400` com `messages.N: system content must contain at least one block` quando seu gateway remove o campo de uma entrada vazia | Encaminhe ambos, ou peça aos desenvolvedores que definam [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) para interromper o envio do campo e das entradas vazias |226| [Esforço definido por turno](https://code.claude.com/docs/pt/prompt-caching.md#changing-effort-level) | Em Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 e Fable 5.1, um header beta emparelhado com `output_config.effort` em entradas `role: "system"`. Uma entrada é uma mensagem de sistema ou uma entrada com conteúdo vazio | `400` com `messages.N: system content must contain at least one block` quando seu gateway remove o campo de uma entrada vazia | Encaminhe ambos, ou peça aos desenvolvedores que definam [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) para interromper o envio do campo e das entradas vazias |

227| [Prompt caching](https://code.claude.com/docs/pt/prompt-caching.md) | Sem emparelhamento beta. Claude Code anexa marcadores `cache_control` a blocos `system` e a entradas `messages`, incluindo entradas `role: "system"` anexadas no meio da conversa | Sem erro: a conversa é cobrada como entrada não armazenada em cache a cada turno, visível como `input_tokens` alto com pouca ou nenhuma atividade de cache em `usage` | Encaminhe `cache_control` inalterado onde quer que apareça, e não converta `system` em forma de bloco ou conteúdo de mensagem para strings simples |227| [Prompt caching](https://code.claude.com/docs/pt/prompt-caching.md) | Sem emparelhamento beta. Claude Code anexa marcadores `cache_control` a blocos `system` e a entradas `messages`, incluindo entradas `role: "system"` anexadas no meio da conversa | Sem erro: a conversa é cobrada como entrada não armazenada em cache a cada turno, visível como `input_tokens` alto com pouca ou nenhuma atividade de cache em `usage` | Encaminhe `cache_control` inalterado onde quer que apareça, e não converta `system` em forma de bloco ou conteúdo de mensagem para strings simples |

228| [Contagem de tokens](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Sem emparelhamento beta; usa o endpoint `count_tokens` | Sem erro: Claude Code volta a uma estimativa baseada em caracteres, então `/context` mostra contagens aproximadas | Exponha o endpoint para contagens de tokens exatas |228| [Contagem de tokens](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Sem emparelhamento beta; usa o endpoint `count_tokens` | Sem erro: Claude Code volta a uma estimativa baseada em caracteres, então `/context` mostra contagens aproximadas | Exponha o endpoint para contagens de tokens exatas |

229 229 

model-config.md +52 −23

Details

30| Alias de modelo | Comportamento |30| Alias de modelo | Comportamento |

31| - | - |31| - | - |

32| **`default`** | Valor especial que limpa qualquer substituição de modelo e reverte para o [padrão de tempo de execução para sua conta](#default-model-setting). Não é em si um alias de modelo |32| **`default`** | Valor especial que limpa qualquer substituição de modelo e reverte para o [padrão de tempo de execução para sua conta](#default-model-setting). Não é em si um alias de modelo |

33| **`best`** | Usa o modelo para o qual o alias [`fable` é resolvido](#fable-alias-resolution) onde Fable está disponível para você, caso contrário, o mesmo modelo que `opus` |33| **`best`** | Usa o mesmo modelo que `opus` |

34| **`fable`** | Usa o [modelo Fable para seu provedor](#fable-alias-resolution) para suas tarefas mais difíceis e de execução mais longa |34| **`fable`** | Usa o [modelo Fable para seu provedor](#fable-alias-resolution) para suas tarefas mais difíceis e de execução mais longa |

35| **`sonnet`** | Usa o modelo Sonnet mais recente para tarefas diárias de codificação |35| **`sonnet`** | Usa o modelo Sonnet mais recente para tarefas diárias de codificação |

36| **`opus`** | Usa o modelo Opus mais recente para tarefas de raciocínio complexo |36| **`opus`** | Usa o modelo Opus mais recente para tarefas de raciocínio complexo |


48| Amazon Bedrock, Agent Platform do Google Cloud | Opus 5.5 | Sonnet 4.5 | Haiku 4.5 |48| Amazon Bedrock, Agent Platform do Google Cloud | Opus 5.5 | Sonnet 4.5 | Haiku 4.5 |

49| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 | Haiku 4.5 |49| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 | Haiku 4.5 |

50 50 

51A menos que você defina `ANTHROPIC_DEFAULT_FABLE_MODEL`, o alias `fable` é resolvido para Fable 5.1, exceto em sessões do [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway), onde `fable` e `best` são resolvidos para Fable 5.51A menos que você defina `ANTHROPIC_DEFAULT_FABLE_MODEL`, o alias `fable` é resolvido para Fable 5 em sessões do [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway) e para Fable 5.2 em todos os outros lugares.

52 52 

53Um gateway que não está configurado para servir `claude-fable-5-1` rejeita requisições para esse modelo. Para usar Fable 5.1 através de um gateway que o serve, selecione-o com `/model claude-fable-5-1`.53Um gateway que não está configurado para servir `claude-fable-5-2` rejeita requisições para esse modelo. Para usar Fable 5.2 através de um gateway que o serve, selecione-o com `/model claude-fable-5-2`.

54 54 

55Onde `opus` ou `sonnet` é resolvido para um modelo mais antigo, modelos mais novos estão disponíveis selecionando o nome completo do modelo explicitamente ou definindo `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.55Onde `opus` ou `sonnet` é resolvido para um modelo mais antigo, modelos mais novos estão disponíveis selecionando o nome completo do modelo explicitamente ou definindo `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.

56 56 


64 64 

65### Trabalhar com Fable65### Trabalhar com Fable

66 66 

67[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) e Claude Fable 5 são os modelos mais capazes no Claude Code, adequados para tarefas maiores que uma única sessão. Eles sustentam sessões autônomas longas, investigam antes de agir e verificam seu trabalho com mais frequência do que modelos menores. Fable 5.1 é o lançamento mais recente.67Os [modelos Claude Fable](https://platform.claude.com/docs/en/about-claude/models/overview) são os modelos mais capazes no Claude Code, adequados para tarefas maiores que uma única sessão. Eles sustentam sessões autônomas longas, investigam antes de agir e verificam seu trabalho com mais frequência do que modelos menores.

68 68 

69Nenhum modelo Fable é o padrão do tipo de conta em nenhum plano ou provedor. Selecione um explicitamente:69Nenhum modelo Fable é o padrão do tipo de conta em nenhum plano ou provedor. Selecione um explicitamente:

70 70 

71* **Fable 5.1**: execute `/model fable`, ou inicie com `claude --model fable`. Em sessões do [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway), onde o alias é resolvido para Fable 5, execute `/model claude-fable-5-1` em vez disso.71* **Fable 5.2**: execute `/model fable`, ou inicie com `claude --model fable`. Em sessões do [gateway de aplicativos Claude](https://code.claude.com/docs/pt/claude-apps-gateway), execute `/model claude-fable-5-2` em vez disso.

72* **Fable 5**: selecione-o pelo ID do modelo. Na API Anthropic, execute `/model claude-fable-5` ou inicie com `claude --model claude-fable-5`. Em outros provedores, use o ID do modelo Fable 5 do seu provedor ou [fixe-o](#pin-models-for-third-party-deployments) com `ANTHROPIC_DEFAULT_FABLE_MODEL`.72* **Fable 5.1 ou Fable 5**: selecione-o pelo ID do modelo. Na API Anthropic, execute `/model claude-fable-5-1` ou `/model claude-fable-5`, ou inicie com `claude --model claude-fable-5-1`. Em outros provedores, use o ID do modelo do seu provedor ou [fixe-o](#pin-models-for-third-party-deployments) com `ANTHROPIC_DEFAULT_FABLE_MODEL`.

73 73 

74Se você se conectar à API Anthropic diretamente e suas configurações de usuário contiverem `claude-fable-5` ou `claude-fable-5[1m]` como o modelo, por exemplo porque você selecionou Fable no seletor `/model` antes da v2.1.257, Claude Code muda esse valor salvo para o alias `fable` ou `fable[1m]` na primeira vez que você executa v2.1.257 ou posterior. A linha do modelo de inicialização mostra `(auto-updated)` uma vez. Um valor `claude-fable-5` nas configurações de projeto, local ou gerenciadas permanece como está.74Nos planos Pro, Max, Team e Enterprise, um modelo `claude-fable-5-1` salvo em suas configurações de usuário passa para o alias `fable`:

75 

76* **Plano Pro ou Max**: a mudança acontece na primeira vez que você executa v2.1.321 ou posterior. No terminal, a linha do modelo de inicialização pode mostrar `(auto-updated)` uma vez.

77* **Plano Team ou Enterprise**: a mudança aguarda as configurações da sua organização, então pode ocorrer em uma inicialização posterior, ou não ocorrer. Ela se aplica a partir da próxima sessão, sem a linha `(auto-updated)`. Para verificar seu modelo, execute `/model`.

78 

79Após a mudança, as sessões começam no esforço padrão do Fable 5.2, a menos que você tenha [definido um nível](#adjust-effort-level) para ele. Contas do Console, provedores de terceiros e configurações de projeto, locais ou gerenciadas mantêm `claude-fable-5-1`.

75 80 

76Requisições que os classificadores de segurança de um modelo Fable sinalizam, mais frequentemente em domínios de cibersegurança e biologia, acionam [fallback automático de modelo](#automatic-model-fallback).81Requisições que os classificadores de segurança de um modelo Fable sinalizam, mais frequentemente em domínios de cibersegurança e biologia, acionam [fallback automático de modelo](#automatic-model-fallback).

77 82 


84 89 

85> [!NOTE]90> [!NOTE]

86>91>

87> Fable 5.1 requer Claude Code v2.1.257 ou posterior. Se uma requisição para ele de uma versão mais antiga falhar, consulte [Claude Code does not support this model](https://code.claude.com/docs/pt/errors.md#claude-code-does-not-support-this-model). Execute `claude update` para atualizar. Para disponibilidade sob retenção zero de dados, consulte [Model availability under ZDR](https://code.claude.com/docs/pt/zero-data-retention.md#model-availability-under-zdr).92> Fable 5.2 requer Claude Code v2.1.321 ou posterior, e Fable 5.1 requer v2.1.257 ou posterior. Se uma requisição para um deles de uma versão mais antiga falhar, consulte [Claude Code does not support this model](https://code.claude.com/docs/pt/errors.md#claude-code-does-not-support-this-model). Execute `claude update` para atualizar. Para disponibilidade sob retenção zero de dados, consulte [Model availability under ZDR](https://code.claude.com/docs/pt/zero-data-retention.md#model-availability-under-zdr).

88 93 

89Na API Anthropic, um modelo Fable aparece no seletor `/model` a menos que [`availableModels`](#restrict-model-selection) ou [restrições de modelo da organização](#organization-model-restrictions) o excluam. Quando sua organização não pode usar Fable em absoluto, por exemplo sob [retenção zero de dados](https://code.claude.com/docs/pt/zero-data-retention.md#model-availability-under-zdr), a linha permanece no seletor acinzentada, com uma nota sobre o motivo.94Na API Anthropic, um modelo Fable aparece no seletor `/model` a menos que [`availableModels`](#restrict-model-selection) ou [restrições de modelo da organização](#organization-model-restrictions) o excluam. Quando sua organização não pode usar Fable em absoluto, por exemplo sob [retenção zero de dados](https://code.claude.com/docs/pt/zero-data-retention.md#model-availability-under-zdr), a linha permanece no seletor acinzentada, com uma nota sobre o motivo.

90 95 


163 168 

164Consulte [Model is not a recognized model id](https://code.claude.com/docs/pt/errors.md#model-is-not-a-recognized-model-id) e [Model not found](https://code.claude.com/docs/pt/errors.md#model-not-found) para as mensagens.169Consulte [Model is not a recognized model id](https://code.claude.com/docs/pt/errors.md#model-is-not-a-recognized-model-id) e [Model not found](https://code.claude.com/docs/pt/errors.md#model-not-found) para as mensagens.

165 170 

166Se você definir o modelo com a flag `--model`, a variável de ambiente `ANTHROPIC_MODEL`, ou a configuração `model`, Claude Code não o verifica antecipadamente, e um valor digitado incorretamente produz [There's an issue with the selected model](https://code.claude.com/docs/pt/errors.md#theres-an-issue-with-the-selected-model) na primeira requisição.171Se você definir o modelo com a flag `--model`, a variável de ambiente `ANTHROPIC_MODEL`, ou a configuração `model`, Claude Code não rejeita antecipadamente um valor digitado incorretamente. A sessão é iniciada, e a primeira requisição produz [There's an issue with the selected model](https://code.claude.com/docs/pt/errors.md#theres-an-issue-with-the-selected-model). Na API Anthropic, um valor que não começa com `claude-` e quase corresponde a um nome ou alias de modelo também pode produzir um [aviso de inicialização que o sugere](#fix-a-mistyped-model-name).

167 172 

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

169 174 


225 230 

226## Restringir seleção de modelo231## Restringir seleção de modelo

227 232 

228Administradores podem usar `availableModels` em [configurações gerenciadas ou de política](https://code.claude.com/docs/pt/managed-settings.md) para restringir quais modelos os usuários podem selecionar. As entradas correspondem a uma família de modelos como `sonnet`, um prefixo de versão como `claude-sonnet-4-5`, ou um ID de modelo completo como `claude-sonnet-4-5-20250929`. Um prefixo de versão também corresponde a IDs de modelo posteriores que o estendem com outro segmento, portanto `claude-fable-5` permite tanto Fable 5 quanto Fable 5.1, enquanto `claude-fable-5-1` permite apenas Fable 5.1. Para bloquear um modelo que a lista permite, ou para fazer cada entrada de ID de modelo permitir apenas a versão que nomeia, veja [Bloquear modelos ou versões específicas](#block-specific-models-or-versions).233Administradores podem usar `availableModels` em [configurações gerenciadas ou de política](https://code.claude.com/docs/pt/managed-settings.md) para restringir quais modelos os usuários podem selecionar. Cada entrada corresponde a um destes:

234 

235* Uma família de modelos como `sonnet`

236* Um prefixo de versão como `claude-sonnet-4-5`. Ele também corresponde a IDs de modelo posteriores que o estendem com outro segmento. Por exemplo, `claude-fable-5` permite Fable 5, Fable 5.1 e Fable 5.2, enquanto `claude-fable-5-1` permite apenas Fable 5.1

237* Um ID de modelo completo como `claude-sonnet-4-5-20250929`

238 

239Para bloquear um modelo que a lista permite, ou para fazer cada entrada de ID de modelo permitir apenas a versão que nomeia, veja [Bloquear modelos ou versões específicas](#block-specific-models-or-versions).

229 240 

230Em plataformas que incorporam Claude Code e definem [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/pt/env-vars), a configuração de modelo do host tem precedência sobre as configurações de modelo gerenciadas, enquanto uma lista de permissões `availableModels` gerenciada permanece em vigor a menos que o host forneça a sua própria; [Exceções à precedência de configurações gerenciadas](https://code.claude.com/docs/pt/settings.md#exceptions-to-managed-settings-precedence) diz quais chaves e variáveis o host substitui.241Em plataformas que incorporam Claude Code e definem [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/pt/env-vars), a configuração de modelo do host tem precedência sobre as configurações de modelo gerenciadas, enquanto uma lista de permissões `availableModels` gerenciada permanece em vigor a menos que o host forneça a sua própria; [Exceções à precedência de configurações gerenciadas](https://code.claude.com/docs/pt/settings.md#exceptions-to-managed-settings-precedence) diz quais chaves e variáveis o host substitui.

231 242 


465 476 

466Quando nada é registrado em sua conta, as configurações gerenciadas [aplicam a allowlist para o modelo Default](#enforce-the-allowlist-for-the-default-model), e o padrão do tipo de conta não está em `availableModels`, `default` é resolvido para o Default aplicado em vez do padrão do tipo de conta acima. Quando um padrão da organização e aplicação se aplicam, o padrão da organização substitui o padrão do tipo de conta primeiro e a aplicação é feita em seguida: um padrão da organização na allowlist é mantido, enquanto um fora da lista é resolvido para o Default aplicado.477Quando nada é registrado em sua conta, as configurações gerenciadas [aplicam a allowlist para o modelo Default](#enforce-the-allowlist-for-the-default-model), e o padrão do tipo de conta não está em `availableModels`, `default` é resolvido para o Default aplicado em vez do padrão do tipo de conta acima. Quando um padrão da organização e aplicação se aplicam, o padrão da organização substitui o padrão do tipo de conta primeiro e a aplicação é feita em seguida: um padrão da organização na allowlist é mantido, enquanto um fora da lista é resolvido para o Default aplicado.

467 478 

468Os modelos Fable não são o padrão do tipo de conta em nenhum plano ou provedor. Escolher um com `/model` o salva como o modelo selecionado em suas configurações de usuário, para que as sessões posteriores iniciem nele. Para a alteração única que Claude Code faz em uma seleção Fable 5 salva na v2.1.257, consulte [Trabalhar com Fable](#work-with-fable).479> [!NOTE]

480>

481> Os modelos Fable não são o padrão do tipo de conta em nenhum plano ou provedor. Escolher um com `/model` o salva como o modelo selecionado em suas configurações de usuário, para que as sessões posteriores iniciem nele, exceto pela [alteração única em uma seleção Fable 5.1 salva](#work-with-fable).

469 482 

470### Configuração do modelo `opusplan`483### Configuração do modelo `opusplan`

471 484 


521 534 

522Os modelos Fable, Opus 5.5, Sonnet 5.5 e Opus 5 são executados com classificadores de segurança, que na maioria das vezes sinalizam conteúdo de cibersegurança e biologia. Para essas duas categorias, o modelo de fallback depende de qual modelo recusou:535Os modelos Fable, Opus 5.5, Sonnet 5.5 e Opus 5 são executados com classificadores de segurança, que na maioria das vezes sinalizam conteúdo de cibersegurança e biologia. Para essas duas categorias, o modelo de fallback depende de qual modelo recusou:

523 536 

524* **Fable 5.1, Fable 5 e Opus 5.5**: requisições sinalizadas por biologia são executadas novamente em Opus 5, e requisições sinalizadas por cibersegurança são executadas novamente em Opus 4.8.537* **Modelos Fable e Opus 5.5**: requisições sinalizadas por biologia são executadas novamente em Opus 5, e requisições sinalizadas por cibersegurança são executadas novamente em Opus 4.8.

525* **Sonnet 5.5**: requisições sinalizadas por cibersegurança são executadas novamente em Sonnet 5. Requisições sinalizadas por biologia terminam com uma recusa, porque Sonnet 5.5 não tem modelo de fallback de biologia.538* **Sonnet 5.5**: requisições sinalizadas por cibersegurança são executadas novamente em Sonnet 5. Requisições sinalizadas por biologia terminam com uma recusa, porque Sonnet 5.5 não tem modelo de fallback de biologia.

526* **Opus 5**: requisições sinalizadas por cibersegurança são executadas novamente em Opus 4.8. Requisições sinalizadas por biologia terminam com uma recusa, porque Opus 5 executa seus próprios classificadores de biologia sem modelo de fallback.539* **Opus 5**: requisições sinalizadas por cibersegurança são executadas novamente em Opus 4.8. Requisições sinalizadas por biologia terminam com uma recusa, porque Opus 5 executa seus próprios classificadores de biologia sem modelo de fallback.

527 540 


582 595 

583No [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/pt/google-vertex-ai.md) e [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md), IDs de modelo são específicos do provedor, portanto o fallback automático opera apenas quando Claude Code pode identificar cada modelo envolvido:596No [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/pt/google-vertex-ai.md) e [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md), IDs de modelo são específicos do provedor, portanto o fallback automático opera apenas quando Claude Code pode identificar cada modelo envolvido:

584 597 

585* Claude Code deve reconhecer o modelo atual como uma fonte de fallback. Fable 5.1 e Fable 5 são reconhecidos quando o ID do modelo contém `claude-fable-5`, corresponde ao valor de `ANTHROPIC_DEFAULT_FABLE_MODEL` ou é mapeado com [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 e Opus 5 são reconhecidos por seu ID de modelo do provedor ou um mapeamento [`modelOverrides`](#override-model-ids-per-version).598* Claude Code deve reconhecer o modelo atual como uma fonte de fallback. Os modelos Fable são reconhecidos quando o ID do modelo contém `claude-fable-5`, corresponde ao valor de `ANTHROPIC_DEFAULT_FABLE_MODEL` ou é mapeado com [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 e Opus 5 são reconhecidos por seu ID de modelo do provedor ou um mapeamento [`modelOverrides`](#override-model-ids-per-version).

586* Um destino Opus deve ser resolvido em sua implantação, qualquer que seja o modelo que recusou: defina `ANTHROPIC_DEFAULT_OPUS_MODEL` ou mantenha uma entrada Opus 4.8 na lista de modelos do provedor. Sem um, o fallback permanece desativado para cada modelo de origem, incluindo Sonnet 5.5, e requisições sinalizadas terminam com uma recusa.599* Um destino Opus deve ser resolvido em sua implantação, qualquer que seja o modelo que recusou: defina `ANTHROPIC_DEFAULT_OPUS_MODEL` ou mantenha uma entrada Opus 4.8 na lista de modelos do provedor. Sem um, o fallback permanece desativado para cada modelo de origem, incluindo Sonnet 5.5, e requisições sinalizadas terminam com uma recusa.

587* O modelo de fallback da categoria sinalizada deve ser resolvido em sua implantação. De um modelo Fable, Opus 5.5 ou Opus 5, se você definir `ANTHROPIC_DEFAULT_OPUS_MODEL`, requisições sinalizadas são executadas novamente nesse modelo para cada categoria que tem um fallback; uma sinalização de biologia em Opus 5 ainda termina com uma recusa. Se você não o definir, requisições sinalizadas por cibersegurança são executadas novamente na entrada Opus 4.8, e requisições sinalizadas por biologia de um modelo Fable ou Opus 5.5 em uma entrada Opus 5. De Sonnet 5.5, requisições sinalizadas por cibersegurança são executadas novamente no modelo que você definiu em `ANTHROPIC_DEFAULT_SONNET_MODEL`, ou em uma entrada Sonnet 5 na lista de modelos do provedor se você não o definir.600* O modelo de fallback da categoria sinalizada deve ser resolvido em sua implantação. De um modelo Fable, Opus 5.5 ou Opus 5, se você definir `ANTHROPIC_DEFAULT_OPUS_MODEL`, requisições sinalizadas são executadas novamente nesse modelo para cada categoria que tem um fallback; uma sinalização de biologia em Opus 5 ainda termina com uma recusa. Se você não o definir, requisições sinalizadas por cibersegurança são executadas novamente na entrada Opus 4.8, e requisições sinalizadas por biologia de um modelo Fable ou Opus 5.5 em uma entrada Opus 5. De Sonnet 5.5, requisições sinalizadas por cibersegurança são executadas novamente no modelo que você definiu em `ANTHROPIC_DEFAULT_SONNET_MODEL`, ou em uma entrada Sonnet 5 na lista de modelos do provedor se você não o definir.

588 601 


596 609 

597#### Pesquisa de segurança e cargas de trabalho de biologia610#### Pesquisa de segurança e cargas de trabalho de biologia

598 611 

599Cargas de trabalho em segurança ofensiva ou biologia, incluindo testes de penetração, exercícios Capture the Flag (CTF) e bases de código adjacentes à biologia, acionam fallback frequentemente, geralmente na primeira requisição. Para trabalho substantivo de biologia em Fable 5.1, Fable 5 ou Opus 5.5, a primeira requisição sinalizada que alterna modelos move a sessão para Opus 5, e requisições posteriores sinalizadas por biologia terminam em recusas lá, porque Opus 5 não tem fallback de biologia. Em Opus 5 e Sonnet 5.5, você recebe essas recusas desde a primeira requisição sinalizada.612Cargas de trabalho em segurança ofensiva ou biologia, incluindo testes de penetração, exercícios Capture the Flag (CTF) e bases de código adjacentes à biologia, acionam fallback frequentemente, geralmente na primeira requisição. Este é o roteamento esperado para esses domínios, não uma sinalização de conta. Se sua organização precisar de capacidade de classe Fable para este trabalho, peça ao seu time de contas da Anthropic sobre programas de acesso confiável.

600 613 

601Este é o roteamento esperado para esses domínios, não uma sinalização de conta. Se sua organização precisar de capacidade de classe Fable para este trabalho, peça ao seu time de contas da Anthropic sobre programas de acesso confiável.614Para trabalho substantivo de biologia em um modelo Fable ou Opus 5.5, a primeira requisição sinalizada que alterna modelos move a sessão para Opus 5. Requisições posteriores sinalizadas por biologia terminam em recusas lá, porque Opus 5 não tem fallback de biologia. Em Opus 5 e Sonnet 5.5, essas recusas começam desde a primeira requisição sinalizada.

602 615 

603### Ajustar nível de esforço616### Ajustar nível de esforço

604 617 


608 621 

609| Modelo | Níveis |622| Modelo | Níveis |

610| :- | :- |623| :- | :- |

611| Fable 5.1 e Fable 5 | `low`, `medium`, `high`, `xhigh`, `max` |624| Modelos Fable | `low`, `medium`, `high`, `xhigh`, `max` |

612| Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 e Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |625| Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 e Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |

613| Opus 4.6 e Sonnet 4.6 | `low`, `medium`, `high`, `max` |626| Opus 4.6 e Sonnet 4.6 | `low`, `medium`, `high`, `max` |

614 627 


6202. Um nível que você escolhe na sessão, como com `/effort`, o seletor `/model` ou [`applyFlagSettings()`](https://code.claude.com/docs/pt/agent-sdk/typescript#applyflagsettings)6332. Um nível que você escolhe na sessão, como com `/effort`, o seletor `/model` ou [`applyFlagSettings()`](https://code.claude.com/docs/pt/agent-sdk/typescript#applyflagsettings)

6213. Lançamento com `--effort`6343. Lançamento com `--effort`

6224. 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)6354. 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)

6235. 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.6365. O esforço padrão do modelo: Fable 5.2, 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. Outros modelos na [tabela de níveis de esforço](#adjust-effort-level) têm `high` 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.

624 637 

625Apó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).638Apó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).

626 639 


671| Nível | Quando usá-lo |684| Nível | Quando usá-lo |

672| :- | :- |685| :- | :- |

673| `low` | Trocas rápidas onde você revisa cada resultado, como brainstorming, um primeiro esboço ou uma pequena alteração como uma renomeação |686| `low` | Trocas rápidas onde você revisa cada resultado, como brainstorming, um primeiro esboço ou uma pequena alteração como uma renomeação |

674| `medium` | O padrão em Opus 5.5, Sonnet 5.5 e Haiku 5.5. Em Opus 5.5 e Sonnet 5.5, se encaixa no trabalho de engenharia do dia a dia com um escopo claro, como implementar um novo recurso. Em modelos com um padrão mais alto, reduz o uso de tokens para trabalho sensível a custos que pode fazer concessões em inteligência |687| `medium` | O padrão nos modelos Fable 5.2, Opus 5.5, Sonnet 5.5 e Haiku 5.5. Em Opus 5.5 e Sonnet 5.5, se encaixa no trabalho de engenharia do dia a dia com um escopo claro, como implementar um novo recurso. Em modelos com um padrão mais alto, reduz o uso de tokens para trabalho sensível a custos que pode fazer concessões em inteligência |

675| `high` | Trabalho onde a verificação é importante ou casos extremos são prováveis, como corrigir um bug em uma base de código existente. O padrão em cada modelo exceto Opus 5.5, Sonnet 5.5, Haiku 5.5 e Opus 4.7 |688| `high` | Trabalho onde a verificação é importante ou casos extremos são prováveis, como corrigir um bug em uma base de código existente. O padrão nos outros modelos da tabela de esforço |

676| `xhigh` | Raciocínio mais profundo com gasto de tokens mais alto. O padrão em Opus 4.7 |689| `xhigh` | Raciocínio mais profundo com gasto de tokens mais alto. O padrão em Opus 4.7 |

677| `max` | Problemas difíceis que você quer que Claude trabalhe sem você, como encontrar vulnerabilidades de segurança. `max` pode mostrar retornos decrescentes e é propenso a excesso de pensamento, portanto teste antes de adotar amplamente |690| `max` | Problemas difíceis que você quer que Claude trabalhe sem você, como encontrar vulnerabilidades de segurança. `max` pode mostrar retornos decrescentes e é propenso a excesso de pensamento, portanto teste antes de adotar amplamente |

678| `ultracode` | Uma configuração de Claude Code em vez de um nível: planeja um [fluxo de trabalho dinâmico](https://code.claude.com/docs/pt/workflows.md) para cada tarefa substantiva em qualquer nível de esforço |691| `ultracode` | Uma configuração de Claude Code em vez de um nível: planeja um [fluxo de trabalho dinâmico](https://code.claude.com/docs/pt/workflows.md) para cada tarefa substantiva em qualquer nível de esforço |


691 704 

692* Digite-a novamente fora de qualquer elemento como aspas, colchetes, um caminho ou um comando, em um prompt que não comece com `/`705* Digite-a novamente fora de qualquer elemento como aspas, colchetes, um caminho ou um comando, em um prompt que não comece com `/`

693* Remova a definição de `CLAUDE_CODE_EFFORT_LEVEL` se estiver definida abaixo de `xhigh`, aumente seu próprio [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel) para `xhigh` ou acima, ou peça a um administrador da organização para aumentar o [limite da sua organização](#organization-effort-limits)706* Remova a definição de `CLAUDE_CODE_EFFORT_LEVEL` se estiver definida abaixo de `xhigh`, aumente seu próprio [`maxEffortLevel`](https://code.claude.com/docs/pt/settings-reference#maxeffortlevel) para `xhigh` ou acima, ou peça a um administrador da organização para aumentar o [limite da sua organização](#organization-effort-limits)

694* Execute `/model` em sua sessão para alternar para um modelo Opus 5.5, Sonnet 5.5, Haiku 5.5 ou Fable 5.1. Onde a palavra não pode elevar um turno, como no Amazon Bedrock, [defina o nível de esforço](#set-the-effort-level) em vez disso707* Execute `/model` em sua sessão para alternar para um modelo Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 ou Fable 5.1. Onde a palavra não pode elevar um turno, como no Amazon Bedrock, [defina o nível de esforço](#set-the-effort-level) em vez disso

695 708 

696#### Definir o nível de esforço709#### Definir o nível de esforço

697 710 


767 780 

768### Contexto estendido781### Contexto estendido

769 782 

770Fable 5.1, Fable 5, Sonnet 5 e posterior, Haiku 5.5, Opus 4.6 e posterior, e Sonnet 4.6 suportam uma [janela de contexto de 1 milhão de tokens](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) para sessões longas com bases de código grandes.783Sessões longas com bases de código grandes podem usar uma [janela de contexto de 1 milhão de tokens](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model). Os modelos Fable, Sonnet 5 e posterior, Haiku 5.5, Opus 4.6 e posterior, e Sonnet 4.6 a suportam.

771 784 

772Fable 5.1, Fable 5, Sonnet 5 e posterior, Haiku 5.5, e Opus 4.7 e posterior são executados com a janela de 1M por padrão, sem necessidade do sufixo `[1m]`. Isso inclui sessões no Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, e sessões do [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway). Para executá-los com uma janela de 200K em vez disso, consulte [Desativar o contexto de 1M](#turn-off-1m-context).785Os modelos Fable, Sonnet 5 e posterior, Haiku 5.5, e Opus 4.7 e posterior são executados com a janela de 1M por padrão, sem necessidade do sufixo `[1m]`. Isso inclui sessões no Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, e sessões do [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway). Para executá-los com uma janela de 200K em vez disso, consulte [Desativar o contexto de 1M](#turn-off-1m-context).

773 786 

774Opus 4.6 e Sonnet 4.6 alcançam 1M apenas através de sua variante `[1m]`, e o acesso a essa variante depende do seu plano. Nos planos Max, Ultra, Team e Enterprise, incluindo assentos Team Standard e Team Premium, Opus 4.6 com contexto de 1M está incluído em sua assinatura. Sonnet 4.6 com contexto de 1M requer [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) em cada plano de assinatura, incluindo Max e Ultra.787Opus 4.6 e Sonnet 4.6 alcançam 1M apenas através de sua variante `[1m]`, e o acesso a essa variante depende do seu plano. Nos planos Max, Ultra, Team e Enterprise, incluindo assentos Team Standard e Team Premium, Opus 4.6 com contexto de 1M está incluído em sua assinatura. Sonnet 4.6 com contexto de 1M requer [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) em cada plano de assinatura, incluindo Max e Ultra.

775 788 


798 811 

799#### Janela de contexto atrás de um gateway de LLM812#### Janela de contexto atrás de um gateway de LLM

800 813 

801Se você definir `ANTHROPIC_BASE_URL` para um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) ou outro proxy, Claude Code dá a cada modelo que reconhece a mesma janela de contexto que o modelo tem na Anthropic API. Fable 5.1, Fable 5, Sonnet 5 e posterior, Haiku 5.5, e Opus 4.7 e posterior recebem a janela de 1M sem nenhuma variante `[1m]` para selecionar, e um modelo que alcança 1M apenas através de sua variante `[1m]`, como Opus 4.6, é executado em 200K sem ela. Claude Code não pode detectar um limite inferior que o gateway ou o servidor atrás dele impõe. Se seu gateway rejeita requisições acima de 200K tokens, defina [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](https://code.claude.com/docs/pt/env-vars) no ambiente que inicia Claude Code, para que as sessões em cada modelo [compactem nesse limite](#set-the-auto-compact-window).814Se você definir `ANTHROPIC_BASE_URL` para um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) ou outro proxy, Claude Code dá a cada modelo que reconhece a mesma janela de contexto que o modelo tem na Anthropic API. Os modelos Fable, Sonnet 5 e posterior, Haiku 5.5, e Opus 4.7 e posterior recebem a janela de 1M sem nenhuma variante `[1m]`. Um modelo que alcança 1M apenas através de sua variante `[1m]`, como Opus 4.6, é executado em 200K sem ela.

815 

816Claude Code não pode detectar um limite inferior que o gateway ou o servidor atrás dele impõe. Se seu gateway rejeita requisições acima de 200K tokens, defina [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](https://code.claude.com/docs/pt/env-vars) no ambiente que inicia Claude Code, para que as sessões em cada modelo [compactem nesse limite](#set-the-auto-compact-window).

802 817 

803#### Desativar o contexto de 1M818#### Desativar o contexto de 1M

804 819 


885 900 

886Assim que Claude Code reconhecer o ID ou usar a janela que você informou, o aviso deixa de aparecer quando você inicia uma sessão nesse ID.901Assim que Claude Code reconhecer o ID ou usar a janela que você informou, o aviso deixa de aparecer quando você inicia uma sessão nesse ID.

887 902 

903#### Corrigir um nome de modelo digitado incorretamente

904 

905Qualquer um destes avisos significa que Claude Code não reconhece o ID de modelo que você definiu, e o ID quase corresponde à grafia de um nome de modelo ou alias que ele reconhece:

906 

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

911 

912* **Você digitou o ID incorretamente**: altere-o para a sugestão [onde quer que você defina o modelo](#setting-your-model)

913* **O ID é intencional**: deixe-o como está. A sessão o envia como você o escreveu. Se a janela de contexto que Claude Code assume para ele estiver errada, [corrija a janela](#correct-the-window-for-a-gateway-or-custom-model-id)

914 

888#### A quais IDs `CLAUDE_CODE_MAX_CONTEXT_TOKENS` se aplica915#### A quais IDs `CLAUDE_CODE_MAX_CONTEXT_TOKENS` se aplica

889 916 

890Em um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) ou outra implantação personalizada, Claude Code pode assumir uma janela de contexto para o ID do modelo que difere da janela real do modelo, independentemente de resolver ou não o ID para um modelo Claude. Defina [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/pt/env-vars) para a janela que Claude Code deve assumir em vez disso.917Em um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) ou outra implantação personalizada, Claude Code pode assumir uma janela de contexto para o ID do modelo que difere da janela real do modelo, independentemente de resolver ou não o ID para um modelo Claude. Defina [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/pt/env-vars) para a janela que Claude Code deve assumir em vez disso.


1100 1127 

1101| Versão | Alteração |1128| Versão | Alteração |

1102| :- | :- |1129| :- | :- |

1130| v2.1.321 | `fable` é resolvido para Fable 5.2, exceto em sessões de gateway de aplicativos Claude |

1131| v2.1.321 | `best` é resolvido para o mesmo modelo que `opus`. Versões anteriores usam o modelo para o qual `fable` é resolvido, onde Fable estiver disponível |

1103| v2.1.293 | `haiku` é resolvido para Haiku 5.5 na API Anthropic |1132| v2.1.293 | `haiku` é resolvido para Haiku 5.5 na API Anthropic |

1104| v2.1.284 | `sonnet` é resolvido para Sonnet 5.5 na API Anthropic |1133| v2.1.284 | `sonnet` é resolvido para Sonnet 5.5 na API Anthropic |

1105| v2.1.280 | `opus` é resolvido para Opus 5.5 na API Anthropic, Claude Platform na AWS, Amazon Bedrock e Agent Platform do Google Cloud |1134| v2.1.280 | `opus` é resolvido para Opus 5.5 na API Anthropic, Claude Platform na AWS, Amazon Bedrock e Agent Platform do Google Cloud |

permissions.md +2 −1

Details

253| :- | :- | :- |253| :- | :- | :- |

254| `Bash(curl *)` | `curl https://example.com` | `/usr/bin/curl https://example.com`, `sh -c 'curl https://example.com'` |254| `Bash(curl *)` | `curl https://example.com` | `/usr/bin/curl https://example.com`, `sh -c 'curl https://example.com'` |

255| `Bash(rm *)` | `rm -rf build/` | `/bin/rm -rf build/`, `bash -c 'rm -rf build/'` |255| `Bash(rm *)` | `rm -rf build/` | `/bin/rm -rf build/`, `bash -c 'rm -rf build/'` |

256| `Bash(git push *)` | `git push origin main` | `git -C . push origin main`, `git -c push.default=current push origin main`, `git 'push' origin main` |256| `Bash(git push *)` | `git push origin main` | `git -C . push origin main`, `git -c push.default=current push origin main` |

257 257 

258Suas outras regras e o modo de permissão decidem os comandos na última coluna.258Suas outras regras e o modo de permissão decidem os comandos na última coluna.

259 259 


273* **`docker` apontado para outro daemon**: formas somente leitura de `docker` solicitam quando o comando carrega uma flag que seleciona um daemon diferente, como `-H`, `--context` ou `--url` e `--connection` do Podman.273* **`docker` apontado para outro daemon**: formas somente leitura de `docker` solicitam quando o comando carrega uma flag que seleciona um daemon diferente, como `-H`, `--context` ou `--url` e `--connection` do Podman.

274* **`file` com flags de abertura de caminho**: `file` solicita quando passa `-m`/`--magic-file` ou `-f`/`--files-from`, porque essas flags fazem `file` abrir os caminhos nomeados no valor da flag.274* **`file` com flags de abertura de caminho**: `file` solicita quando passa `-m`/`--magic-file` ou `-f`/`--files-from`, porque essas flags fazem `file` abrir os caminhos nomeados no valor da flag.

275* **`ps` que poderia imprimir variáveis de ambiente**: `ps` solicita quando um de seus argumentos poderia atuar como a opção `e`, como em `ps auxe` ou `ps aux -e`, porque essa opção imprime as variáveis de ambiente dos processos. `ps aux` e `ps -ef` são executados sem um prompt. A verificação em formas com hífen como `ps aux -e` requer Claude Code v2.1.290 ou posterior.275* **`ps` que poderia imprimir variáveis de ambiente**: `ps` solicita quando um de seus argumentos poderia atuar como a opção `e`, como em `ps auxe` ou `ps aux -e`, porque essa opção imprime as variáveis de ambiente dos processos. `ps aux` e `ps -ef` são executados sem um prompt. A verificação em formas com hífen como `ps aux -e` requer Claude Code v2.1.290 ou posterior.

276* **`which` com flags além de consulta e exibição**: `which` solicita quando passa uma flag como `-i`/`--read-alias` ou `--read-functions`. `which node` e `which -a node` são executados sem um prompt.

276* **Caminhos de rede no Windows**: um comando cujos argumentos incluem um caminho de rede (UNC), como `\\server\share\file`, solicita porque acessar um caminho de rede pode enviar suas credenciais do Windows para o host que ele nomeia. A mesma verificação se aplica a comandos da [ferramenta PowerShell](https://code.claude.com/docs/pt/tools-reference.md#powershell-tool).277* **Caminhos de rede no Windows**: um comando cujos argumentos incluem um caminho de rede (UNC), como `\\server\share\file`, solicita porque acessar um caminho de rede pode enviar suas credenciais do Windows para o host que ele nomeia. A mesma verificação se aplica a comandos da [ferramenta PowerShell](https://code.claude.com/docs/pt/tools-reference.md#powershell-tool).

277* **Escrita em variáveis de shell especiais**: um comando que define, desdefine ou itera sobre certas variáveis de shell especiais, como `PATH` ou `IFS`, solicita mesmo quando o resto do comando é somente leitura.278* **Escrita em variáveis de shell especiais**: um comando que define, desdefine ou itera sobre certas variáveis de shell especiais, como `PATH` ou `IFS`, solicita mesmo quando o resto do comando é somente leitura.

278* **Comandos que a análise não consegue analisar**: quando Claude Code não consegue analisar completamente um comando, solicita aprovação em vez de tratar o comando como somente leitura. Comandos mais longos que 10.000 caracteres sempre solicitam porque excedem o que a análise analisa.279* **Comandos que a análise não consegue analisar**: quando Claude Code não consegue analisar completamente um comando, solicita aprovação em vez de tratar o comando como somente leitura. Comandos mais longos que 10.000 caracteres sempre solicitam porque excedem o que a análise analisa.

Details

279* **Seu hook retorna um `drop` depois que sua chamada `next(e)` deixou o prompt passar**: o turno ainda é executado, e o hook [falha](#handle-a-hook-that-fails) com uma mensagem que inclui `a drop after its next() was answered`279* **Seu hook retorna um `drop` depois que sua chamada `next(e)` deixou o prompt passar**: o turno ainda é executado, e o hook [falha](#handle-a-hook-that-fails) com uma mensagem que inclui `a drop after its next() was answered`

280* **Seu hook lança um erro ou excede o tempo limite**: o Claude Code o ignora e envia o prompt. [Adicione um handler `.catch`](#handle-a-hook-that-fails) para que uma falha não envie um prompt que o hook teria impedido.280* **Seu hook lança um erro ou excede o tempo limite**: o Claude Code o ignora e envia o prompt. [Adicione um handler `.catch`](#handle-a-hook-that-fails) para que uma falha não envie um prompt que o hook teria impedido.

281 281 

282[Outros eventos](https://code.claude.com/docs/pt/plugins/mods/reference.md#prompts-and-what-claude-reads) cobrem o restante do que o Claude lê: `prompt.section` para cada seção do system prompt, `prompt.context` para o contexto enviado com a primeira mensagem e `skill.prompt` para o texto de uma skill. Texto desses hooks que muda entre requisições [invalida o cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md). Em um hook `skill.prompt`, você também pode ler [de qual plugin ou arquivo a skill veio](https://code.claude.com/docs/pt/plugins/mods/reference.md#skill-prompt-fields).282[Outros eventos](https://code.claude.com/docs/pt/plugins/mods/reference.md#prompts-and-what-claude-reads) cobrem o restante do que o Claude lê: `prompt.section` para cada seção do system prompt, `prompt.context` para o contexto enviado com a primeira mensagem e `skill.prompt` para o texto de uma skill. Para alterar uma seção depois que uma conversa já começou, consulte [Enviar uma seção do system prompt ou descrição de ferramenta alterada](https://code.claude.com/docs/pt/plugins/mods/reference.md#break-prompt-cache). Em um hook `skill.prompt`, você também pode ler [de qual plugin ou arquivo a skill veio](https://code.claude.com/docs/pt/plugins/mods/reference.md#skill-prompt-fields).

283 283 

284### Acompanhar um turno284### Acompanhar um turno

285 285 

Details

197>197>

198> Para desenhar na faixa, filtre em `{ component: 'AbovePrompt' }`.198> Para desenhar na faixa, filtre em `{ component: 'AbovePrompt' }`.

199 199 

200Um mod também pode [colocar uma linha própria na transcrição](#place-a-row-in-the-transcript).

201 

200### Alterar o que o Claude Code já desenha202### Alterar o que o Claude Code já desenha

201 203 

202O Claude Code desenha a maior parte de sua interface por si só: mensagens, linhas de chamada de ferramenta, o spinner e muito mais. Cada uma dessas partes é um site de renderização também, então um mod pode restylar ou substituí-la. Para alterar uma, filtre seu hook `ui.render` em seu nome desta tabela:204O Claude Code desenha a maior parte de sua interface por si só: mensagens, linhas de chamada de ferramenta, o spinner e muito mais. Cada uma dessas partes é um site de renderização também, então um mod pode restylar ou substituí-la. Para alterar uma, filtre seu hook `ui.render` em seu nome desta tabela:


349* **Sugestões de prompt**: `$.prompt.suggest` resolve com `isShown: false` e não mostra nada, porque o painel de chat reserva o texto de sugestão esmaecido da caixa do prompt para as próprias sugestões do Claude.351* **Sugestões de prompt**: `$.prompt.suggest` resolve com `isShown: false` e não mostra nada, porque o painel de chat reserva o texto de sugestão esmaecido da caixa do prompt para as próprias sugestões do Claude.

350* **Limites de texto**: o painel de chat corta uma linha de status em 200 caracteres ou duas linhas, e um toast em 500 caracteres.352* **Limites de texto**: o painel de chat corta uma linha de status em 200 caracteres ou duas linhas, e um toast em 500 caracteres.

351 353 

354### Colocar uma linha na transcrição

355 

356Uma linha é uma linha que seu mod adiciona à transcrição no terminal, após a mensagem mais recente. Ela permanece nesse lugar conforme a conversa avança, e o Claude não a vê. `$.ui.place` requer o Claude Code v2.1.314 ou posterior.

357 

358**1. Colocar a linha**

359 

360Chame [`$.ui.place`](https://code.claude.com/docs/pt/plugins/mods/reference#mods-api-methods) com um `id`. O `id` é um nome que você inventa para a linha, como `build-status`. Ele pode ter de 1 a 64 letras, dígitos, `_` ou `-`, e cada linha que seu mod tem na transcrição precisa do seu próprio.

361 

362**2. Desenhar a linha**

363 

364Desenhe a linha no ponto de renderização [`Placed`](https://code.claude.com/docs/pt/plugins/mods/reference#render-sites).

365 

366Este exemplo adiciona um comando `/build-status`. Quando o usuário executa o comando, o mod adiciona uma linha que mostra `Build: passing`. O texto é fixo para manter o exemplo curto, então um mod real desenharia seu próprio resultado:

367 

368```javascript theme={null}

369export function register(on) {

370 on('session.start', async ($, e, next) => {

371 await $.command.register({ name: 'build-status', description: 'Show the build status' })

372 return next(e)

373 })

374 

375 on('command.run', { command: 'build-status' }, async ($) => {

376 const placed = await $.ui.place({ id: 'build-status' })

377 // Where nothing draws the row, reply with text instead

378 return placed.isPlaced ? {} : { text: 'Build: passing' }

379 })

380 

381 on('ui.render', { component: 'Placed' }, async ($, e, next) => {

382 // This hook runs for every mod's rows, and another mod can use the same id

383 if (e.props.plugin !== $.plugin.name || e.props.id !== 'build-status') return next(e)

384 const { Text } = $.ui.resolve(e)

385 return Text({ children: ['Build: passing'] })

386 })

387}

388```

389 

390Para experimentar o exemplo, coloque este código em um [mod](https://code.claude.com/docs/pt/plugins/mods/create.md). Em uma sessão no terminal, execute `/build-status` no prompt do Claude Code. `Build: passing` aparece como uma linha no final da transcrição.

391 

392A chamada nem sempre mostra uma linha, e uma linha pode desaparecer depois, então trate estes casos no seu mod:

393 

394* **O resultado**: `{ isPlaced: true, requestId }` quando o terminal desenha a linha. Caso contrário, `isPlaced` é `false` e `reason` diz por quê, como em `no attached surface draws placed rows yet`. Um dos motivos é o [limite de linhas](https://code.claude.com/docs/pt/plugins/mods/reference.md#limits) que um mod pode ter ao mesmo tempo.

395* **Uma segunda chamada com o mesmo `id`**: enquanto a primeira linha ainda está na transcrição, a chamada não adiciona nenhuma linha e resolve com o `requestId` dessa linha. Para alterar o que a linha mostra, [redesenhe a linha](#redraw-when-something-changes).

396* **Quando a linha desaparece**: quando a conversa termina, quando o usuário volta para antes da linha ou, fora da [renderização em tela cheia](https://code.claude.com/docs/pt/fullscreen.md), quando a conversa é compactada. `--resume` não traz a linha de volta. Para mostrar a linha novamente, chame `$.ui.place` de novo.

397 

398### Colocar um plano de fundo atrás da conversa

399 

400> [!NOTE]

401>

402> `$.theme.set` e `$.theme.clear` substituem `$.ui.backdrop`, que o Claude Code v2.1.319 removeu. Altere `$.ui.backdrop({ id: 'your-backdrop' })` para `$.theme.set({ backdrop: { id: 'your-backdrop' } })`, e `$.ui.backdrop(undefined)` para `$.theme.clear()`, que remove o plano de fundo de qualquer mod.

403 

404Para colocar um plano de fundo atrás da conversa no app Desktop ou no app móvel, chame [`$.theme.set`](https://code.claude.com/docs/pt/plugins/mods/reference#mods-api-methods) com um `backdrop` e, em seguida, desenhe o plano de fundo no ponto de renderização [`Backdrop`](https://code.claude.com/docs/pt/plugins/mods/reference#render-sites). Para remover o plano de fundo, chame `$.theme.clear()`. O terminal não desenha plano de fundo. `$.theme.set` e `$.theme.clear` requerem o Claude Code v2.1.319 ou posterior.

405 

406Este mod define um plano de fundo quando a sessão começa, desenha o plano de fundo e adiciona um comando `/plain` que remove o plano de fundo:

407 

408```javascript theme={null}

409export function register(on) {

410 // Neither a reload of this mod nor --resume keeps the backdrop, so set it here

411 on('session.start', async ($, e, next) => {

412 await $.theme.set({ backdrop: { id: 'night-sky', colorScheme: 'dark' } })

413 await $.command.register({ name: 'plain', description: 'Take the backdrop off' })

414 return next(e)

415 })

416 

417 on('ui.render', { component: 'Backdrop' }, async ($, e, next) => {

418 // This hook runs for every mod's backdrop, and another mod can use the same id

419 if (e.props.plugin !== $.plugin.name || e.props.id !== 'night-sky') return next(e)

420 const { Box, Text } = $.ui.resolve(e)

421 return Box({ backgroundColor: 'blue', children: [Text({ children: ['Night sky'] })] })

422 })

423 

424 on('command.run', { command: 'plain' }, async ($) => {

425 const cleared = await $.theme.clear()

426 return { text: cleared.reason }

427 })

428}

429```

430 

431Para experimentar o exemplo, coloque este código em um [mod](https://code.claude.com/docs/pt/plugins/mods/create.md) e inicie uma sessão no app Desktop ou no app móvel. Para remover o plano de fundo, execute `/plain` no prompt do Claude Code. A transcrição mostra `the theme is cleared` após o nome do mod, como em `night-sky: the theme is cleared` para um mod chamado `night-sky`.

432 

433Verifique o que `backdrop` aceita, o que o resultado da chamada informa e o que outros mods podem alterar:

434 

435* **Os campos de `backdrop`**: `id`, um [nome](https://code.claude.com/docs/pt/plugins/mods/reference.md#limits) que você escolhe, é obrigatório, e os outros campos são opcionais. `colorScheme` é `'light'` ou `'dark'` e diz se seu desenho é claro ou escuro. Para `glass`, consulte [os tipos para o seu build](https://code.claude.com/docs/pt/plugins/mods/create.md#get-the-types-for-your-build).

436* **Se o plano de fundo é desenhado**: `$.theme.set` resolve com `isDrawn: true` quando um app Desktop ou móvel conectado à sessão informa que desenha planos de fundo. Caso contrário, `isDrawn` é `false` e `reason` diz por quê.

437* **Um plano de fundo para cada sessão**: uma chamada `$.theme.set` substitui o plano de fundo da sessão e `$.theme.clear()` remove esse plano de fundo, independentemente de qual mod o definiu. Chame `$.theme.clear()` apenas quando o usuário pedir.

438 

352## Construir uma árvore a partir de elementos439## Construir uma árvore a partir de elementos

353 440 

354O que um hook `ui.render` retorna é uma árvore de elementos: uma descrição do que desenhar, feita de caixas, texto e controles aninhados um dentro do outro. Você descreve o desenho, e o Claude Code o renderiza no app que o usuário tiver aberto: o terminal, o app Desktop ou a extensão do VS Code.441O que um hook `ui.render` retorna é uma árvore de elementos: uma descrição do que desenhar, feita de caixas, texto e controles aninhados um dentro do outro. Você descreve o desenho, e o Claude Code o renderiza no app que o usuário tiver aberto: o terminal, o app Desktop ou a extensão do VS Code.

Details

57| :- | :- | :- |57| :- | :- | :- |

58| [`tool.call`](https://code.claude.com/docs/pt/plugins/mods/events#guard-or-change-a-tool-call) | Uma ferramenta está prestes a ser executada | `next(e)`, `{ deny: reason }` ou `{ result }` |58| [`tool.call`](https://code.claude.com/docs/pt/plugins/mods/events#guard-or-change-a-tool-call) | Uma ferramenta está prestes a ser executada | `next(e)`, `{ deny: reason }` ou `{ result }` |

59| [`tool.check`](https://code.claude.com/docs/pt/plugins/mods/events#where-settings-hooks-run-in-the-order) | O Claude Code decide se uma chamada de ferramenta pode ser executada, após os hooks `tool.call` e `PreToolUse`. `next(e)` resolve para a decisão a que chegaram as regras, o modo de permissão e esses hooks. | `next(e)` ou `{ decision }`, com `decision` definido como `allow`, `ask` ou `deny` e um `reason` opcional |59| [`tool.check`](https://code.claude.com/docs/pt/plugins/mods/events#where-settings-hooks-run-in-the-order) | O Claude Code decide se uma chamada de ferramenta pode ser executada, após os hooks `tool.call` e `PreToolUse`. `next(e)` resolve para a decisão a que chegaram as regras, o modo de permissão e esses hooks. | `next(e)` ou `{ decision }`, com `decision` definido como `allow`, `ask` ou `deny` e um `reason` opcional |

60| `tool.describe` | Uma vez para cada ferramenta, quando sua descrição é enviada pela primeira vez ao Claude. Uma segunda vez para uma ferramenta MCP quando o Claude a carrega por meio da [busca de ferramentas](https://code.claude.com/docs/pt/mcp.md#scale-with-mcp-tool-search), com `e.description` definido como o texto que o Claude lê para a ferramenta carregada. | `{ description }`, opcionalmente com `isDeferred` definido como `true` para colocar a ferramenta por trás da busca de ferramentas ou `false` para carregá-la antecipadamente |60| `tool.describe` | Uma vez para cada ferramenta, quando sua descrição é enviada pela primeira vez ao Claude. Uma segunda vez para uma ferramenta MCP quando o Claude a carrega por meio da [busca de ferramentas](https://code.claude.com/docs/pt/mcp.md#scale-with-mcp-tool-search), com `e.description` definido como o texto que o Claude lê para a ferramenta carregada. | `{ description }`, opcionalmente com `isDeferred` definido como `true` para colocar a ferramenta por trás da busca de ferramentas ou `false` para carregá-la antecipadamente. Adicione [`breakPromptCache: true`](#break-prompt-cache) para enviar uma descrição alterada no próximo turno. |

61 61 

62#### Campos de agente e de organização em `tool.check`62#### Campos de agente e de organização em `tool.check`

63 63 


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

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

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

88| [`prompt.section`](https://code.claude.com/docs/pt/plugins/mods/events#rewrite-or-add-to-a-prompt) | Uma vez para cada seção nomeada do system prompt. `e.name` é o `id` da seção em `prompt.compose`. | `{ text }`, ou `{ text: null }` para omitir a seção |88| [`prompt.section`](https://code.claude.com/docs/pt/plugins/mods/events#rewrite-or-add-to-a-prompt) | Uma vez para cada seção nomeada do system prompt. `e.name` é o `id` da seção em `prompt.compose`. | `{ text }`, ou `{ text: null }` para omitir a seção. Adicione [`breakPromptCache: true`](#break-prompt-cache) para enviar uma seção alterada no próximo turno. |

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

90| `prompt.attachment` | O Claude Code adiciona uma mensagem própria para o Claude, como um lembrete. `e.type` indica o tipo e, para os tipos que as declarações de tipos declaram, `e.detail` contém os fatos a partir dos quais o texto foi escrito. | `{ text }`, ou `{ text: null }` para omiti-la |90| `prompt.attachment` | O Claude Code adiciona uma mensagem própria para o Claude, como um lembrete. `e.type` indica o tipo e, para os tipos que as declarações de tipos declaram, `e.detail` contém os fatos a partir dos quais o texto foi escrito. | `{ text }`, ou `{ text: null }` para omiti-la |

91| `prompt.mention` | O Claude Code está prestes a ler um arquivo que um prompt menciona com @. Requer o Claude Code v2.1.290 ou posterior. | `next({ ...e, path })` para ler um arquivo diferente, ou `{ deny: reason }` |91| `prompt.mention` | O Claude Code está prestes a ler um arquivo que um prompt menciona com @. Requer o Claude Code v2.1.290 ou posterior. | `next({ ...e, path })` para ler um arquivo diferente, ou `{ deny: reason }` |


108 108 

109Em `skill.prompt`, `e.source`, `e.pluginName`, `e.path`, `e.frontmatter` e `e.frontmatterProblem` exigem o Claude Code v2.1.299 ou posterior.109Em `skill.prompt`, `e.source`, `e.pluginName`, `e.path`, `e.frontmatter` e `e.frontmatterProblem` exigem o Claude Code v2.1.299 ou posterior.

110 110 

111#### Enviar uma seção do system prompt ou uma descrição de ferramenta alterada com `breakPromptCache`

112 

113Para alterar uma seção ou uma descrição de ferramenta em uma conversa em andamento, chame `$.ui.invalidate('prompt.section')` ou `$.ui.invalidate('tool.describe')` para que seu hook seja executado novamente. Retorne `{ text, breakPromptCache: true }` ou `{ description, breakPromptCache: true }` a partir dele. Sem o campo, o Claude continua lendo o texto [salvo com a conversa](https://code.claude.com/docs/pt/cli-reference.md#system-prompt-flags-in-resumed-conversations) para uma seção ou uma ferramenta carregada antecipadamente até uma nova conversa ou uma [compactação](https://code.claude.com/docs/pt/prompt-caching.md#compacting-the-conversation).

114 

115O texto alterado chega ao Claude no próximo turno, e o [cache de prompt](https://code.claude.com/docs/pt/prompt-caching.md) recomeça, então esse turno é mais lento e mais caro. O campo requer o Claude Code v2.1.321 ou posterior. Da v2.1.299 até a v2.1.321, uma conversa em andamento recebia o texto alterado no próximo turno.

116 

111### Comandos e configuração117### Comandos e configuração

112 118 

113| Evento | Dispara quando | Um hook pode retornar |119| Evento | Dispara quando | Um hook pode retornar |


212| Namespace | Métodos |218| Namespace | Métodos |

213| :- | :- |219| :- | :- |

214| `$.plugin` | `name`, `root`: o nome e o diretório deste plugin |220| `$.plugin` | `name`, `root`: o nome e o diretório deste plugin |

215| [`$.ui`](https://code.claude.com/docs/pt/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `notify`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit` |221| [`$.ui`](https://code.claude.com/docs/pt/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, [`place`](https://code.claude.com/docs/pt/plugins/mods/interface#place-a-row-in-the-transcript), `focus`, `scroll`, `toast`, `notify`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit`, `view`. `view` exige o Claude Code v2.1.300 ou posterior e `place`, a v2.1.314 ou posterior. |

222| [`$.theme`](https://code.claude.com/docs/pt/plugins/mods/interface#put-a-backdrop-behind-the-conversation) | `set`, `clear`: define um plano de fundo para o aplicativo Desktop ou móvel desenhar e remove o plano de fundo. Exige o Claude Code v2.1.319 ou posterior. |

216| [`$.command`](https://code.claude.com/docs/pt/plugins/mods/api#add-a-command) | `register`, `run`, `list` |223| [`$.command`](https://code.claude.com/docs/pt/plugins/mods/api#add-a-command) | `register`, `run`, `list` |

217| [`$.tool`](https://code.claude.com/docs/pt/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |224| [`$.tool`](https://code.claude.com/docs/pt/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |

218| `$.agent` | `register`, `spawn`, `list`. `list()` retorna os subagentes e colegas de equipe desta sessão, cada um com um `status` de `pending`, `running`, `waiting`, `idle`, `completed`, `failed` ou `killed`, sendo que `idle` e `waiting` exigem o Claude Code v2.1.289 ou posterior. |225| `$.agent` | `register`, `spawn`, `list`. `list()` retorna os subagentes e colegas de equipe desta sessão, cada um com um `status` de `pending`, `running`, `waiting`, `idle`, `completed`, `failed` ou `killed`, sendo que `idle` e `waiting` exigem o Claude Code v2.1.289 ou posterior. |


243| :- | :- | :- | :- |250| :- | :- | :- | :- |

244| [`Pane`](https://code.claude.com/docs/pt/plugins/mods/interface#pick-where-to-draw) | `title`, `isFocused`, `bodyColumns`, `placement`, `scroll`, `view` | O `id` do painel | Terminal, Desktop, VS Code |251| [`Pane`](https://code.claude.com/docs/pt/plugins/mods/interface#pick-where-to-draw) | `title`, `isFocused`, `bodyColumns`, `placement`, `scroll`, `view` | O `id` do painel | Terminal, Desktop, VS Code |

245| [`AbovePrompt`](https://code.claude.com/docs/pt/plugins/mods/interface#pick-where-to-draw) | `hasSurvey`, `isWorking`, `maxRows`, `bodyColumns`, `scroll`, `view` | Uma instância | Terminal, Desktop |252| [`AbovePrompt`](https://code.claude.com/docs/pt/plugins/mods/interface#pick-where-to-draw) | `hasSurvey`, `isWorking`, `maxRows`, `bodyColumns`, `scroll`, `view` | Uma instância | Terminal, Desktop |

253| [`Placed`](https://code.claude.com/docs/pt/plugins/mods/interface#place-a-row-in-the-transcript) | `id`, `plugin`, `onScreen` | O `requestId` que `$.ui.place` retornou | Terminal |

254| [`Backdrop`](https://code.claude.com/docs/pt/plugins/mods/interface#put-a-backdrop-behind-the-conversation) | `id`, `plugin`, `glass`, `colorScheme` | `backdrop` | Superfícies `desktop` e `mobile`. Seu hook é executado quando o aplicativo Desktop ou mobile solicita desenhar um plano de fundo. |

246| `UserMessage` | `text`, `origin`, `isExpanded` e `task` ou `from` conforme a origem | O id da mensagem | Terminal, Desktop, VS Code |255| `UserMessage` | `text`, `origin`, `isExpanded` e `task` ou `from` conforme a origem | O id da mensagem | Terminal, Desktop, VS Code |

247| `AssistantMessage` | O texto da resposta | O id da mensagem | Terminal, Desktop, VS Code |256| `AssistantMessage` | O texto da resposta | O id da mensagem | Terminal, Desktop, VS Code |

248| `ToolUse`, `ToolResult`, `ToolGroup` | O nome, a entrada e o resultado da ferramenta | O id da chamada de ferramenta | Terminal, Desktop, VS Code |257| `ToolUse`, `ToolResult`, `ToolGroup` | O nome, a entrada e o resultado da ferramenta | O id da chamada de ferramenta | Terminal, Desktop, VS Code |


399| Redesenhos de `$.ui.invalidate('ui.render')` | Limitados a 10 por segundo, ou 30 no terminal para o painel visível, a faixa expandida e a linha de dica abaixo do prompt. Chamadas que chegam antes disso são agrupadas. |408| Redesenhos de `$.ui.invalidate('ui.render')` | Limitados a 10 por segundo, ou 30 no terminal para o painel visível, a faixa expandida e a linha de dica abaixo do prompt. Chamadas que chegam antes disso são agrupadas. |

400| `$.ui.toast` | Exibido por 4 segundos, a menos que você passe `{ timeoutMs }`. No [renderizador clássico](https://code.claude.com/docs/pt/fullscreen.md#enable-fullscreen-rendering), um toast mais recente de um mod pode [tomar o lugar do mais antigo](https://code.claude.com/docs/pt/plugins/mods/troubleshoot.md#a-toast-doesn’t-appear) que está sendo exibido ou aguardando para ser exibido. |409| `$.ui.toast` | Exibido por 4 segundos, a menos que você passe `{ timeoutMs }`. No [renderizador clássico](https://code.claude.com/docs/pt/fullscreen.md#enable-fullscreen-rendering), um toast mais recente de um mod pode [tomar o lugar do mais antigo](https://code.claude.com/docs/pt/plugins/mods/troubleshoot.md#a-toast-doesn’t-appear) que está sendo exibido ou aguardando para ser exibido. |

401| Um painel aberto sem que o usuário tenha pedido | Posicionado a partir de 144 colunas do terminal, 110 depois que o usuário o tiver aberto uma vez |410| Um painel aberto sem que o usuário tenha pedido | Posicionado a partir de 144 colunas do terminal, 110 depois que o usuário o tiver aberto uma vez |

411| Linhas de `$.ui.place` que um mod tem em uma conversa ao mesmo tempo | 500. No limite, uma chamada com um novo `id` é resolvida como `{ isPlaced: false, reason: 'a plugin holds at most 500 placed rows' }`. |

402| Profundidade de aninhamento dos argumentos de uma chamada à API de mods | 28.000 níveis. Além disso, a chamada é rejeitada com uma mensagem que termina em `nesting deeper than 28000 levels is not supported`. Requer o Claude Code v2.1.299 ou posterior. |412| Profundidade de aninhamento dos argumentos de uma chamada à API de mods | 28.000 níveis. Além disso, a chamada é rejeitada com uma mensagem que termina em `nesting deeper than 28000 levels is not supported`. Requer o Claude Code v2.1.299 ou posterior. |

403| Profundidade de aninhamento de um evento alterado passado para `next`, fora de [hooks de gerador assíncrono](#events) como um em `turn.step` | 28.000 níveis. Além disso, `next` é rejeitado com uma mensagem que termina em `nesting deeper than 28000 levels is not supported`. Requer o Claude Code v2.1.299 ou posterior. |413| Profundidade de aninhamento de um evento alterado passado para `next`, fora de [hooks de gerador assíncrono](#events) como um em `turn.step` | 28.000 níveis. Além disso, `next` é rejeitado com uma mensagem que termina em `nesting deeper than 28000 levels is not supported`. Requer o Claude Code v2.1.299 ou posterior. |

404| Profundidade de aninhamento do valor de retorno de um hook, fora de `ui.render`, `ui.resolve` e hooks de gerador assíncrono | 28.000 níveis. Além disso, o resultado do hook é recusado, e [o aviso que o relata](https://code.claude.com/docs/pt/plugins/mods/troubleshoot.md#find-out-why-a-mod-does-nothing) inclui `nesting deeper than 28000 levels is not supported`. Requer o Claude Code v2.1.299 ou posterior. |414| Profundidade de aninhamento do valor de retorno de um hook, fora de `ui.render`, `ui.resolve` e hooks de gerador assíncrono | 28.000 níveis. Além disso, o resultado do hook é recusado, e [o aviso que o relata](https://code.claude.com/docs/pt/plugins/mods/troubleshoot.md#find-out-why-a-mod-does-nothing) inclui `nesting deeper than 28000 levels is not supported`. Requer o Claude Code v2.1.299 ou posterior. |

405| Escopos, como funções, blocos e loops, aninhados uns dentro dos outros em um arquivo de um módulo de hooks | 2.000 |415| Escopos, como funções, blocos e loops, aninhados uns dentro dos outros em um arquivo de um módulo de hooks | 2.000 |

406| Nomes de comandos, ferramentas, tipos de subagente e painéis | Letras, dígitos, `_` e `-`, até 64 caracteres |416| Nomes de comandos, ferramentas, tipos de subagente e painéis, e o `id` de uma linha posicionada ou de um pano de fundo | Letras, dígitos, `_` e `-`, até 64 caracteres |

407| Um teste do `claude plugin test` | 5 segundos, a menos que o teste defina `timeoutMs` |417| Um teste do `claude plugin test` | 5 segundos, a menos que o teste defina `timeoutMs` |

408 418 

409## Configurações e variáveis de ambiente419## Configurações e variáveis de ambiente

Details

33Duas configurações não aparecem na tabela de camadas, mas ainda afetam o que permanece em cache:33Duas configurações não aparecem na tabela de camadas, mas ainda afetam o que permanece em cache:

34 34 

35* **Modelo**: cada modelo tem seu próprio cache. Trocar modelos recomputa toda a requisição mesmo quando o conteúdo é idêntico. Veja [Switching models](#switching-models) abaixo.35* **Modelo**: cada modelo tem seu próprio cache. Trocar modelos recomputa toda a requisição mesmo quando o conteúdo é idêntico. Veja [Switching models](#switching-models) abaixo.

36* **Nível de esforço**: na maioria dos modelos, cada nível de esforço tem seu próprio cache, então mudar o esforço no meio da sessão recomputa toda a requisição. No Opus 5.5, Sonnet 5.5, Haiku 5.5 e Fable 5.1 com uma chave de API ou uma assinatura Claude, o cache permanece intacto por padrão. Veja [Changing effort level](#changing-effort-level) abaixo.36* **Nível de esforço**: na maioria dos modelos, cada nível de esforço tem seu próprio cache, então mudar o esforço no meio da sessão recomputa toda a requisição. Com uma chave de API ou uma assinatura Claude, o cache permanece intacto por padrão no Fable 5.1 e posteriores, Opus 5.5, Sonnet 5.5 e Haiku 5.5. Veja [Changing effort level](#changing-effort-level) abaixo.

37 37 

38> [!TIP]38> [!TIP]

39>39>


94 94 

95Na maioria dos modelos, alterar o [effort level](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) no meio da sessão significa que a próxima solicitação lê todo o histórico de conversa sem acertos de cache. Enquanto o cache ainda está quente, Claude Code pede que você confirme a mudança primeiro.95Na maioria dos modelos, alterar o [effort level](https://code.claude.com/docs/pt/model-config.md#adjust-effort-level) no meio da sessão significa que a próxima solicitação lê todo o histórico de conversa sem acertos de cache. Enquanto o cache ainda está quente, Claude Code pede que você confirme a mudança primeiro.

96 96 

97No Opus 5.5, Sonnet 5.5, Haiku 5.5 e Fable 5.1 com uma chave de API ou uma assinatura Claude, você mantém o cache ao alterar o esforço. Claude Code [aplica o novo nível](https://code.claude.com/docs/pt/model-config.md#when-a-new-effort-level-starts) sem perguntar. No Amazon Bedrock, na plataforma de agentes do Google Cloud ou em um [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway), ou quando você define [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) ou sua organização tem uma configuração HIPAA, funciona como na maioria dos modelos.97Com uma chave de API ou uma assinatura Claude, alterar o esforço mantém o cache no Fable 5.1 e posteriores, Opus 5.5, Sonnet 5.5 e Haiku 5.5. Claude Code [aplica o novo nível](https://code.claude.com/docs/pt/model-config.md#when-a-new-effort-level-starts) sem perguntar. No Amazon Bedrock, na plataforma de agentes do Google Cloud ou em um [Claude apps gateway](https://code.claude.com/docs/pt/claude-apps-gateway), ou quando você define [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/pt/llm-gateway-protocol#disable-pre-release-capabilities) ou sua organização tem uma configuração HIPAA, funciona como na maioria dos modelos.

98 98 

99Antes da v2.1.260, alterar o esforço no Fable 5.1 com uma chave de API ou uma assinatura Claude também invalidava o cache.99Antes da v2.1.260, alterar o esforço no Fable 5.1 com uma chave de API ou uma assinatura Claude também invalidava o cache.

100 100 

Details

49> claude remote-control49> claude remote-control

50> ```50> ```

51>51>

52> `claude rc` é um alias para este comando.

53>

52> Até que você aceite a confirmação única do Remote Control, `claude remote-control` explica o que faz e pergunta `Enable Remote Control? (y/n)` antes de iniciar o servidor. Responda `y` para aceitar e iniciar o servidor. Se você recusar, Claude Code sai sem iniciar o servidor e pergunta novamente na próxima vez que você executar o comando.54> Até que você aceite a confirmação única do Remote Control, `claude remote-control` explica o que faz e pergunta `Enable Remote Control? (y/n)` antes de iniciar o servidor. Responda `y` para aceitar e iniciar o servidor. Se você recusar, Claude Code sai sem iniciar o servidor e pergunta novamente na próxima vez que você executar o comando.

53>55>

54> O processo continua em execução no seu terminal em modo servidor, aguardando conexões remotas. Ele exibe uma URL que você pode usar para [conectar de outro dispositivo](#connect-from-another-device), e você pode pressionar a barra de espaço para mostrar um código QR para acesso rápido do seu telefone. Enquanto uma sessão remota está ativa, o terminal mostra o status da conexão e a atividade da ferramenta.56> O processo continua em execução no seu terminal em modo servidor, aguardando conexões remotas. Ele exibe uma URL que você pode usar para [conectar de outro dispositivo](#connect-from-another-device), e você pode pressionar a barra de espaço para mostrar um código QR para acesso rápido do seu telefone. Enquanto uma sessão remota está ativa, o terminal mostra o status da conexão e a atividade da ferramenta.


462* **Seu plano claude.ai é Pro, Max ou Ultra**: o Claude Code ainda está conectado sob uma organização Team ou Enterprise de um login anterior, então verifica a política de Remote Control dessa organização. Execute `/status` para ver qual plano e organização seu login usa. Execute `claude auth logout` e depois `claude auth login` para fazer login novamente sob seu plano atual.464* **Seu plano claude.ai é Pro, Max ou Ultra**: o Claude Code ainda está conectado sob uma organização Team ou Enterprise de um login anterior, então verifica a política de Remote Control dessa organização. Execute `/status` para ver qual plano e organização seu login usa. Execute `claude auth logout` e depois `claude auth login` para fazer login novamente sob seu plano atual.

463* **A mensagem não diz para entrar em contato com o administrador da sua organização**: sua organização tem a [configuração HIPAA](https://code.claude.com/docs/pt/hipaa-setup.md) aplicada, que desativa o Remote Control. Para confirmar, execute `/status` e procure `HIPAA` na linha `Organization configuration`. Um Owner vê a opção **Remote Control** acinzentada nas [configurações de administrador](https://claude.ai/admin-settings/claude-code) e não consegue ativá-la. Se você tiver dúvidas sobre a configuração, pergunte a um Owner, que pode entrar em contato com a equipe de conta da Anthropic da sua organização. Antes da v2.1.267, este caso mostrava "Remote Control isn't available for your organization due to its compliance policy" em vez disso.465* **A mensagem não diz para entrar em contato com o administrador da sua organização**: sua organização tem a [configuração HIPAA](https://code.claude.com/docs/pt/hipaa-setup.md) aplicada, que desativa o Remote Control. Para confirmar, execute `/status` e procure `HIPAA` na linha `Organization configuration`. Um Owner vê a opção **Remote Control** acinzentada nas [configurações de administrador](https://claude.ai/admin-settings/claude-code) e não consegue ativá-la. Se você tiver dúvidas sobre a configuração, pergunte a um Owner, que pode entrar em contato com a equipe de conta da Anthropic da sua organização. Antes da v2.1.267, este caso mostrava "Remote Control isn't available for your organization due to its compliance policy" em vez disso.

464* **O Remote Control funciona para outras pessoas da sua organização, mas não para você**: se sua organização Enterprise gerencia seu acesso com [funções personalizadas](https://support.claude.com/en/articles/13930452), suas funções podem ser a causa. O Remote Control precisa tanto da permissão de sessões na nuvem quanto da permissão **Claude Code remote control**. Peça a um Owner para verificar se suas funções incluem ambas e adicionar o que estiver faltando em [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).466* **O Remote Control funciona para outras pessoas da sua organização, mas não para você**: se sua organização Enterprise gerencia seu acesso com [funções personalizadas](https://support.claude.com/en/articles/13930452), suas funções podem ser a causa. O Remote Control precisa tanto da permissão de sessões na nuvem quanto da permissão **Claude Code remote control**. Peça a um Owner para verificar se suas funções incluem ambas e adicionar o que estiver faltando em [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).

467* **Um Owner vê um banner de [Zero Data Retention](https://code.claude.com/docs/pt/zero-data-retention.md) nas [configurações de administrador](https://claude.ai/admin-settings/claude-code)**: o Remote Control não está disponível para sua organização, e um Owner não consegue ativá-lo.

465* **Caso contrário, um Owner não o habilitou para sua organização**: o Remote Control fica desativado por padrão nos planos Team e Enterprise. Um Owner pode habilitá-lo em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) ativando a opção **Remote Control**. Essa opção é uma configuração da organização no lado do servidor.468* **Caso contrário, um Owner não o habilitou para sua organização**: o Remote Control fica desativado por padrão nos planos Team e Enterprise. Um Owner pode habilitá-lo em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) ativando a opção **Remote Control**. Essa opção é uma configuração da organização no lado do servidor.

466 469 

467Antes da v2.1.281, esta mensagem também aparecia quando o Claude Code não havia carregado a política da sua organização nesta máquina, por exemplo, após iniciar offline. Versões posteriores relatam esse estado como [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) em vez disso.470Antes da v2.1.281, esta mensagem também aparecia quando o Claude Code não havia carregado a política da sua organização nesta máquina, por exemplo, após iniciar offline. Versões posteriores relatam esse estado como [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) em vez disso.

Details

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

155| `CLAUDE_RUNNER_REPO_URL` | URL do repositório para clonar, após qualquer `--git-host-rewrite` e `--git-ssh-rewrite` terem sido aplicados |155| `CLAUDE_RUNNER_REPO_URL` | URL do repositório para clonar, após qualquer `--git-host-rewrite` e `--git-ssh-rewrite` terem sido aplicados |

156| `CLAUDE_RUNNER_REPO_REF` | Revisão para fazer checkout, conforme a sessão a solicitou: um branch, tag, commit SHA ou nome de referência completo como `refs/heads/<branch>` ou `refs/pull/<number>/head`. Vazio significa o branch padrão do repositório. |156| `CLAUDE_RUNNER_REPO_REF` | Revisão para fazer checkout, conforme a sessão a solicitou: um branch, tag, commit SHA ou nome de referência completo como `refs/heads/<branch>` ou `refs/pull/<number>/head`. Vazio significa o branch padrão do repositório. |

157| `CLAUDE_RUNNER_CHECKOUT_PATH` | Caminho absoluto onde a árvore de trabalho deve ser deixada |157| `CLAUDE_RUNNER_CHECKOUT_PATH` | Caminho absoluto onde a árvore de trabalho deve ser deixada. Consulte [Nomes das pastas de checkout](#checkout-folder-names). |

158| `CLAUDE_RUNNER_SESSION_ID` | ID da sessão na forma marcada `session_...`, para logging e correlação |158| `CLAUDE_RUNNER_SESSION_ID` | ID da sessão na forma marcada `session_...`, para logging e correlação |

159| `CLAUDE_RUNNER_SESSION_UUID` | O mesmo ID da sessão na forma UUID canônica |159| `CLAUDE_RUNNER_SESSION_UUID` | O mesmo ID da sessão na forma UUID canônica |

160| `CLAUDE_RUNNER_API_BASE_URL` | URL base da API Anthropic para chamadas com escopo de sessão |160| `CLAUDE_RUNNER_API_BASE_URL` | URL base da API Anthropic para chamadas com escopo de sessão |


166 166 

167Depois que seu hook retorna, o runner verifica se `CLAUDE_RUNNER_CHECKOUT_PATH` contém um `.git`. Se seu hook materializa uma fonte não-git como Perforce ou um tarball desempacotado, defina `CLAUDE_RUNNER_SKIP_GIT_VERIFY=1` no ambiente do runner para pular essa verificação. Fluxos baseados em Git como criação de branch de trabalho e push de resultados requerem um checkout git, então exporte resultados de árvores não-git com um [hook `post-session`](#post-session).167Depois que seu hook retorna, o runner verifica se `CLAUDE_RUNNER_CHECKOUT_PATH` contém um `.git`. Se seu hook materializa uma fonte não-git como Perforce ou um tarball desempacotado, defina `CLAUDE_RUNNER_SKIP_GIT_VERIFY=1` no ambiente do runner para pular essa verificação. Fluxos baseados em Git como criação de branch de trabalho e push de resultados requerem um checkout git, então exporte resultados de árvores não-git com um [hook `post-session`](#post-session).

168 168 

169#### Nomes das pastas de checkout

170 

171`CLAUDE_RUNNER_CHECKOUT_PATH` termina em uma pasta chamada `<repo-owner>-<repo>`, como `acme-api`. Dois repositórios em uma sessão não podem compartilhar uma pasta, mesmo quando seus nomes diferem apenas em maiúsculas e minúsculas. Por exemplo, se uma sessão lista `acme/api` e depois `Acme/API`, o primeiro recebe `acme-api` e o segundo recebe `Acme-API-2`.

172 

169#### Obter credenciais git no hook173#### Obter credenciais git no hook

170 174 

171O runner não passa uma credencial git para o hook. O subcomando `decode-token` também não está disponível aqui, porque `CLAUDE_RUNNER_CLAUDE_BIN` não está definido no ambiente do checkout-hook. Em vez disso, emita uma credencial de clone por sessão a partir da identidade da sessão, ou recorra à própria autenticação git do host:175O runner não passa uma credencial git para o hook. O subcomando `decode-token` também não está disponível aqui, porque `CLAUDE_RUNNER_CLAUDE_BIN` não está definido no ambiente do checkout-hook. Em vez disso, emita uma credencial de clone por sessão a partir da identidade da sessão, ou recorra à própria autenticação git do host:

Details

23 * **Com [git gerenciado pela Anthropic](#use-the-anthropic-git-proxy)**: com tal credencial, Claude acessa o GitHub diretamente em vez de passar pelo git gerenciado pela Anthropic.23 * **Com [git gerenciado pela Anthropic](#use-the-anthropic-git-proxy)**: com tal credencial, Claude acessa o GitHub diretamente em vez de passar pelo git gerenciado pela Anthropic.

24 * **Sem git gerenciado pela Anthropic**: uma credencial de clone pode permanecer na imagem se você restringir seu escopo tanto quanto [Incluir a configuração do git em sua imagem](#ship-git-config-in-your-image) descreve.24 * **Sem git gerenciado pela Anthropic**: uma credencial de clone pode permanecer na imagem se você restringir seu escopo tanto quanto [Incluir a configuração do git em sua imagem](#ship-git-config-in-your-image) descreve.

25* **Mantenha o segredo do ambiente fora dos hosts que executam sessões**: o segredo do ambiente pode registrar runners e pegar qualquer sessão enfileirada no ambiente. Em uma frota fixa, ele vive em cada host runner, onde o código de qualquer sessão pode ler o arquivo secreto. Prefira [runners sob demanda](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#on-demand-runners), onde o segredo fica no host do orquestrador, que nunca executa código do usuário, e cada runner recebe uma ordem de trabalho de uso único que registra exatamente um runner. Em uma frota fixa, trate o arquivo environment-secret como legível por cada sessão e gire o segredo após qualquer suspeita de comprometimento de sessão.25* **Mantenha o segredo do ambiente fora dos hosts que executam sessões**: o segredo do ambiente pode registrar runners e pegar qualquer sessão enfileirada no ambiente. Em uma frota fixa, ele vive em cada host runner, onde o código de qualquer sessão pode ler o arquivo secreto. Prefira [runners sob demanda](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#on-demand-runners), onde o segredo fica no host do orquestrador, que nunca executa código do usuário, e cada runner recebe uma ordem de trabalho de uso único que registra exatamente um runner. Em uma frota fixa, trate o arquivo environment-secret como legível por cada sessão e gire o segredo após qualquer suspeita de comprometimento de sessão.

26 * **Após uma suspeita de comprometimento**: peça a um [Owner](https://code.claude.com/docs/pt/cloud-environments.md#organization-shared-environments) que crie um novo segredo e revogue o antigo na aba **Configuration** do ambiente e, em seguida, distribua o novo. A Anthropic recusa todos os orquestradores e runners com o segredo antigo, incluindo os runners sob demanda criados a partir de suas ordens de trabalho. Seus runners são encerrados, interrompendo suas sessões.

26* **Saída de rede padrão-negar**: restrinja o tráfego de saída do contêiner runner e sessão no seu próprio limite de rede em cada ambiente; [Saída padrão-negar](#default-deny-egress) cobre o que permitir e por quê.27* **Saída de rede padrão-negar**: restrinja o tráfego de saída do contêiner runner e sessão no seu próprio limite de rede em cada ambiente; [Saída padrão-negar](#default-deny-egress) cobre o que permitir e por quê.

27* **IAM de host com privilégio mínimo**: a identidade de computação anexada ao host runner, como um perfil de instância ou conta de serviço de nó, deve conceder apenas o que o próprio runner precisa. As sessões devem obter suas próprias credenciais através de seu script wrapper em vez de herdar a do host.28* **IAM de host com privilégio mínimo**: a identidade de computação anexada ao host runner, como um perfil de instância ou conta de serviço de nó, deve conceder apenas o que o próprio runner precisa. As sessões devem obter suas próprias credenciais através de seu script wrapper em vez de herdar a do host.

28* **Bloqueie o endpoint de metadados da nuvem das sessões**: manter as sessões fora da identidade do host requer bloquear seu acesso ao endpoint de metadados, e as políticas de saída no nível de sub-rede não interceptam o tráfego de metadados link-local, então bloqueie-o no próprio contêiner:29* **Bloqueie o endpoint de metadados da nuvem das sessões**: manter as sessões fora da identidade do host requer bloquear seu acesso ao endpoint de metadados, e as políticas de saída no nível de sub-rede não interceptam o tráfego de metadados link-local, então bloqueie-o no próprio contêiner:


203> [!WARNING]204> [!WARNING]

204>205>

205> Com `--use-anthropic-git-proxy` definido, o runner exclui e substitui a configuração git global do usuário com o qual é executado, e não mantém nenhum backup. Ele faz isso na inicialização e antes de cada sessão. Um login ou credential helper que você mantinha ali é perdido. As configurações que [`--configure-git`](#let-the-runner-configure-git) escreve sobrevivem. Execute o runner como um usuário dedicado ou em um contêiner, nunca como seu próprio usuário.206> Com `--use-anthropic-git-proxy` definido, o runner exclui e substitui a configuração git global do usuário com o qual é executado, e não mantém nenhum backup. Ele faz isso na inicialização e antes de cada sessão. Um login ou credential helper que você mantinha ali é perdido. As configurações que [`--configure-git`](#let-the-runner-configure-git) escreve sobrevivem. Execute o runner como um usuário dedicado ou em um contêiner, nunca como seu próprio usuário.

207>

208> A configuração git global abrange os três: `~/.gitconfig`, o arquivo que `GIT_CONFIG_GLOBAL` nomeia se você a definir, e todo o diretório `$XDG_CONFIG_HOME/git`, por padrão `~/.config/git`.

206 209 

207Mantenha configurações git que não são secretas, como identidade e `safe.directory`, na configuração git do sistema.210Mantenha configurações git que não são secretas, como identidade e `safe.directory`, na configuração git do sistema.

208 211 


247* **Uma linha contendo `remote: access denied by the git proxy`**: uma sessão que a Anthropic serve ainda pode ser recusada, por exemplo quando a política da organização nega acesso git para a sessão, ou a sessão não está autorizada para o repositório. O log do runner então mostra uma linha contendo `remote: access denied by the git proxy`, e o restante dessa linha diz o motivo.250* **Uma linha contendo `remote: access denied by the git proxy`**: uma sessão que a Anthropic serve ainda pode ser recusada, por exemplo quando a política da organização nega acesso git para a sessão, ou a sessão não está autorizada para o repositório. O log do runner então mostra uma linha contendo `remote: access denied by the git proxy`, e o restante dessa linha diz o motivo.

248* **`GitHub authentication required`**: isso aparece quando o criador da sessão não tem uma conexão funcional com o GitHub em claude.ai. O clone da sessão falha, e o erro git contém `GitHub authentication required. Please reconnect your GitHub account.` Peça a essa pessoa que conecte ou reconecte o GitHub nas configurações do claude.ai.251* **`GitHub authentication required`**: isso aparece quando o criador da sessão não tem uma conexão funcional com o GitHub em claude.ai. O clone da sessão falha, e o erro git contém `GitHub authentication required. Please reconnect your GitHub account.` Peça a essa pessoa que conecte ou reconecte o GitHub nas configurações do claude.ai.

249 252 

250Depois de corrigir a causa, inicie novamente as sessões que falharam.253Depois de corrigir a causa, reinicie os runners em que as sessões falharam e, em seguida, peça a cada criador que envie uma mensagem na sessão dele, ou que um Owner selecione **Retry**.

251 254 

252#### Desative o proxy git da Anthropic255#### Desative o proxy git da Anthropic

253 256 


265 268 

266Forneça credenciais que funcionem sem um prompt para cada host git que as sessões dos runners usam, incluindo github.com. Qualquer credencial que estava na configuração git global do usuário do runner se perdeu, porque o runner excluiu essa configuração enquanto `--use-anthropic-git-proxy` estava definido. [Envie credenciais em sua imagem](#ship-git-config-in-your-image) ou use um [hook de ciclo de vida `checkout`](https://code.claude.com/docs/pt/self-hosted-environments-configuration#checkout).269Forneça credenciais que funcionem sem um prompt para cada host git que as sessões dos runners usam, incluindo github.com. Qualquer credencial que estava na configuração git global do usuário do runner se perdeu, porque o runner excluiu essa configuração enquanto `--use-anthropic-git-proxy` estava definido. [Envie credenciais em sua imagem](#ship-git-config-in-your-image) ou use um [hook de ciclo de vida `checkout`](https://code.claude.com/docs/pt/self-hosted-environments-configuration#checkout).

267 270 

271Para manter as credenciais na [configuração git global](#git-proxy-replaces-global-git-config) em vez disso, [pare os runners](#shutdown-timing) primeiro, porque um runner iniciado com a flag a reescreve antes de cada sessão. Em seguida, exclua `$XDG_CONFIG_HOME/git`, por padrão `~/.config/git`, e substitua `~/.gitconfig`, ou o arquivo que `GIT_CONFIG_GLOBAL` nomeia, pelo seu próprio.

272 

268**3. Abra o caminho de rede**273**3. Abra o caminho de rede**

269 274 

270Permita que o runner alcance cada host git que as sessões dos runners usam na porta 443 ou 22. Consulte a linha do host git em [Requisitos de rede](#network-requirements).275Permita que o runner alcance cada host git que as sessões dos runners usam na porta 443 ou 22. Consulte a linha do host git em [Requisitos de rede](#network-requirements).


507 512 

508## Kubernetes513## Kubernetes

509 514 

510O runner serve `GET /healthz` na porta 8080 por padrão, configurável com `--health-port`, então as sondas Kubernetes funcionam sem configuração extra. O endpoint retorna `200` sempre que o processo está vivo, então as sondas abaixo detectam um processo morto, não um preso; para pegar um runner que parou de fazer polling, alerte na série `last_poll_age_seconds` de [`/metrics`](https://code.claude.com/docs/pt/self-hosted-environments-reference#prometheus-metrics). O Deployment abaixo monta o segredo do ambiente a partir de um Secret Kubernetes, aponta as sondas de vivacidade e prontidão para `/healthz`, e define um período de graça de encerramento de 90 segundos. Consulte [Tempo de encerramento](#shutdown-timing) para entender por que o período de graça importa.515O runner serve `GET /healthz` na porta 8080 por padrão, configurável com `--health-port`. Após a inicialização, o endpoint retorna `200` sempre que o processo está vivo, então as sondas abaixo detectam um processo morto, não um preso. Para pegar um runner que parou de fazer polling, alerte na série `last_poll_age_seconds` de [`/metrics`](https://code.claude.com/docs/pt/self-hosted-environments-reference#prometheus-metrics).

516 

517O Deployment abaixo monta o segredo do ambiente a partir de um Secret Kubernetes, aponta as sondas de vivacidade e prontidão para `/healthz`, e define um período de graça de encerramento de 90 segundos. Consulte [Tempo de encerramento](#shutdown-timing) para entender por que o período de graça importa.

511 518 

512O manifesto não define `resources` de CPU ou memória no contêiner runner. Adicione um bloco dimensionado para a capacidade que você executa, conforme [Dimensionar CPU e memória para sessões](#size-cpu-and-memory-for-sessions) descreve.519O manifesto não define `resources` de CPU ou memória no contêiner runner. Adicione um bloco dimensionado para a capacidade que você executa, conforme [Dimensionar CPU e memória para sessões](#size-cpu-and-memory-for-sessions) descreve.

513 520 


565 secretName: claude-runner-environment-secret572 secretName: claude-runner-environment-secret

566```573```

567 574 

575> [!NOTE]

576>

577> Se os eventos do pod mostrarem a sonda de vivacidade falhando durante a inicialização, aumente seu `initialDelaySeconds` ou adicione uma `startupProbe`. Nada responde na porta de saúde até que o runner tenha se registrado e concluído suas verificações de inicialização. Com as configurações acima, o Kubernetes reinicia um runner que não estiver servindo em cerca de 90 segundos.

578 

568O Deployment acima vive em um namespace `claude-runners`. Crie o namespace primeiro:579O Deployment acima vive em um namespace `claude-runners`. Crie o namespace primeiro:

569 580 

570```bash theme={null}581```bash theme={null}


942 Se cada chamada começar a falhar cerca de 30 minutos em uma sessão, um script wrapper provavelmente cortou o stdin da sessão, então as rotações de token não conseguem alcançá-lo; consulte [Keep stdin and file descriptor 3 attached](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#keep-stdin-and-file-descriptor-3-attached).953 Se cada chamada começar a falhar cerca de 30 minutos em uma sessão, um script wrapper provavelmente cortou o stdin da sessão, então as rotações de token não conseguem alcançá-lo; consulte [Keep stdin and file descriptor 3 attached](https://code.claude.com/docs/pt/self-hosted-environments-configuration.md#keep-stdin-and-file-descriptor-3-attached).

943 954 

944 Antes da v2.1.274, o runner parou de tentar novamente uma busca com falha após algumas tentativas e aguardou a próxima agendada. Uma volta com falha não acionou uma busca, então cada volta falhou com um 401 até a próxima busca agendada.955 Antes da v2.1.274, o runner parou de tentar novamente uma busca com falha após algumas tentativas e aguardou a próxima agendada. Uma volta com falha não acionou uma busca, então cada volta falhou com um 401 até a próxima busca agendada.

956* **Uma sessão mostra `The server has refused to renew this session's access to the model`**: o [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/pt/self-hosted-environments-configuration#wrapper-scripts) da sessão expirou, e o runner recebeu HTTP 400 em resposta às suas requisições de um novo token. O runner registra `the server has refused to renew the inference_token`. Os turnos nessa sessão falham. O runner continua solicitando um novo token enquanto o processo da sessão estiver em execução:

957 

958 * **Uma requisição é bem-sucedida**: uma sessão que mostrou o aviso passa a mostrar `The server renewed this session's access to the model`

959 * **Os turnos continuam falhando**: o processo eventualmente sai, e a sessão mostra uma falha como `The session process exited with code 1`

960 

961 Para continuar trabalhando sem esperar por um novo token, inicie uma nova sessão. Se uma nova sessão também falhar, verifique se algum proxy ou gateway seu deu a resposta HTTP 400. Se nenhum deu, [entre em contato com a equipe da sua conta Anthropic](#report-an-issue) com o ID da primeira sessão.

945* **Um turno falha em claude.ai/code com `This model needs a newer version of Claude Code`**: a versão do Claude Code com a qual seus runners iniciam as sessões é mais antiga do que o modelo da sessão exige, então a API [rejeita a requisição](https://code.claude.com/docs/pt/errors.md#claude-code-does-not-support-this-model). Atualize os runners para a versão que a mensagem pede, ou uma posterior, conforme descrito em [Fixe a versão](#pin-the-version). Até lá, as pessoas podem escolher um modelo diferente na sessão.962* **Um turno falha em claude.ai/code com `This model needs a newer version of Claude Code`**: a versão do Claude Code com a qual seus runners iniciam as sessões é mais antiga do que o modelo da sessão exige, então a API [rejeita a requisição](https://code.claude.com/docs/pt/errors.md#claude-code-does-not-support-this-model). Atualize os runners para a versão que a mensagem pede, ou uma posterior, conforme descrito em [Fixe a versão](#pin-the-version). Até lá, as pessoas podem escolher um modelo diferente na sessão.

946* **Pod is killed mid-drain**: aumente `terminationGracePeriodSeconds` para pelo menos o valor que o runner registra na inicialização. Consulte [Shutdown timing](#shutdown-timing).963* **Pod is killed mid-drain**: aumente `terminationGracePeriodSeconds` para pelo menos o valor que o runner registra na inicialização. Consulte [Shutdown timing](#shutdown-timing).

947* **O runner registra uma linha `[runner:log]` terminando com `was paused or too slow`**: o runner continuou em execução e não precisa ser reiniciado. Até que o fluxo stdout ou stderr mencionado na linha fosse lido novamente, o runner descartou todas as linhas desse fluxo, exceto os 256 KiB mais recentes. Se você passou [`--log-file`](https://code.claude.com/docs/pt/self-hosted-environments-reference#runner-cli-flags), procure lá as linhas descartadas.964* **O runner registra uma linha `[runner:log]` terminando com `was paused or too slow`**: o runner continuou em execução e não precisa ser reiniciado. Até que o fluxo stdout ou stderr mencionado na linha fosse lido novamente, o runner descartou todas as linhas desse fluxo, exceto os 256 KiB mais recentes. Se você passou [`--log-file`](https://code.claude.com/docs/pt/self-hosted-environments-reference#runner-cli-flags), procure lá as linhas descartadas.

Details

73 73 

74Vá para a [página **Cloud environments**](https://claude.ai/admin-settings/cloud-environments) nas configurações de administração. Em **Ambientes auto-hospedados**, selecione **Novo**, nomeie o ambiente e selecione **Criar**. Na segunda etapa do assistente, selecione **Copiar chave de ambiente** para copiar o segredo do ambiente, que a interface de administração rotula como uma chave de ambiente. claude.ai mostra o segredo uma vez, e você não pode recuperá-lo depois; ele expira 365 dias após a criação. O ID `ccpool_...` do ambiente permanece visível em seu diálogo de detalhes; você precisará dele para a verificação `aud` em [verificação de token](https://code.claude.com/docs/pt/self-hosted-environments-identity.md) e para despachar [sessões de teste a partir de CI](https://code.claude.com/docs/pt/self-hosted-environments-testing.md#run-the-test-loop).74Vá para a [página **Cloud environments**](https://claude.ai/admin-settings/cloud-environments) nas configurações de administração. Em **Ambientes auto-hospedados**, selecione **Novo**, nomeie o ambiente e selecione **Criar**. Na segunda etapa do assistente, selecione **Copiar chave de ambiente** para copiar o segredo do ambiente, que a interface de administração rotula como uma chave de ambiente. claude.ai mostra o segredo uma vez, e você não pode recuperá-lo depois; ele expira 365 dias após a criação. O ID `ccpool_...` do ambiente permanece visível em seu diálogo de detalhes; você precisará dele para a verificação `aud` em [verificação de token](https://code.claude.com/docs/pt/self-hosted-environments-identity.md) e para despachar [sessões de teste a partir de CI](https://code.claude.com/docs/pt/self-hosted-environments-testing.md#run-the-test-loop).

75 75 

76Se você perder o segredo ou precisar rotacioná-lo, crie um novo segredo na guia **Configuração** do ambiente, implante o novo segredo em seus runners e revogue o antigo. Runners que possuem um segredo revogado falham em sua próxima pesquisa autenticada e saem, registrando `poll auth failed`, e seu orquestrador os reinicia com o novo segredo.76Se o segredo puder ter vazado, siga [as etapas da página de implantação para uma suspeita de comprometimento](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#after-a-suspected-compromise), e não a rotação abaixo.

77 

78Se você perder o segredo ou planejar rotacioná-lo, crie um novo segredo na guia **Configuração** do ambiente. Distribua o novo segredo para seus runners e, em seguida, revogue o antigo. Runners que possuem um segredo revogado falham em sua próxima pesquisa autenticada e saem, registrando `poll auth failed`, e seu orquestrador os reinicia com o novo segredo.

77 79 

78**2. Iniciar um runner**80**2. Iniciar um runner**

79 81 

Details

141 141 

142## Ponto de extremidade de saúde142## Ponto de extremidade de saúde

143 143 

144O executor serve `GET /healthz` na porta de saúde configurada. A resposta é `200 OK` sempre que o processo está vivo, seja qual for o estado do loop de pesquisa, então uma sonda HTTP neste ponto de extremidade detecta apenas um processo morto. O corpo JSON descreve o estado atual:144O executor serve `GET /healthz` na porta de saúde configurada assim que se registra e conclui suas verificações de inicialização. A partir daí, a resposta é `200 OK` sempre que o processo está vivo, seja qual for o estado do loop de pesquisa, então uma sonda HTTP neste endpoint detecta apenas um processo morto. O corpo JSON descreve o estado atual:

145 145 

146```json theme={null}146```json theme={null}

147{147{

settings.md +1 −0

Details

310| [`isolatePeerMachines`](https://code.claude.com/docs/pt/settings-reference#isolatepeermachines) | `true` de qualquer escopo | Respeitado mesmo quando uma fonte gerenciada define `false` |310| [`isolatePeerMachines`](https://code.claude.com/docs/pt/settings-reference#isolatepeermachines) | `true` de qualquer escopo | Respeitado mesmo quando uma fonte gerenciada define `false` |

311| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/pt/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` de qualquer escopo | Respeitado mesmo quando uma fonte gerenciada define `false`. Requer Claude Code v2.1.257 ou posterior |311| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/pt/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` de qualquer escopo | Respeitado mesmo quando uma fonte gerenciada define `false`. Requer Claude Code v2.1.257 ou posterior |

312| [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/pt/settings-reference#permissions-blockwritesoutsideworkingdirectories) | `true` de qualquer escopo | Respeitado mesmo quando uma fonte gerenciada define `false`. Requer Claude Code v2.1.314 ou posterior |312| [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/pt/settings-reference#permissions-blockwritesoutsideworkingdirectories) | `true` de qualquer escopo | Respeitado mesmo quando uma fonte gerenciada define `false`. Requer Claude Code v2.1.314 ou posterior |

313| [`permissions.denyInsteadOfPrompting`](https://code.claude.com/docs/pt/settings-reference#permissions-denyinsteadofprompting) | `true` de `~/.claude/settings.json` ou `--settings` | Respeitado mesmo quando uma fonte gerenciada define `false`. Requer Claude Code v2.1.319 ou posterior |

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| [`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 |315| [`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 |316| [`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 |

Details

448 448 

449Ative o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) em sessões onde ele está disponível, para trabalho interativo como iteração rápida ou depuração ao vivo, em que você quer velocidade a um custo maior por token. Normalmente, você não edita esta chave manualmente. Executar `/fast` grava `fastMode: true` em `~/.claude/settings.json`, e executá-lo novamente para desativar o modo rápido remove a chave.449Ative o [modo rápido](https://code.claude.com/docs/pt/fast-mode.md) em sessões onde ele está disponível, para trabalho interativo como iteração rápida ou depuração ao vivo, em que você quer velocidade a um custo maior por token. Normalmente, você não edita esta chave manualmente. Executar `/fast` grava `fastMode: true` em `~/.claude/settings.json`, e executá-lo novamente para desativar o modo rápido remove a chave.

450 450 

451Apenas o Opus 5.5, o Opus 5 e o Opus 4.8 suportam o modo rápido. Executar `/fast` a partir de outro modelo muda você para o Opus, e mudar para um modelo não suportado desativa o modo rápido. Consulte [Trocar de modelo com o modo rápido ativado](https://code.claude.com/docs/pt/fast-mode.md#switch-models-while-fast-mode-is-on).451Apenas o Fable 5.2, o Opus 5.5, o Opus 5 e o Opus 4.8 suportam o modo rápido. Executar `/fast` a partir de outro modelo muda você para o Opus, e mudar para um modelo não suportado desativa o modo rápido. Consulte [Trocar de modelo com o modo rápido ativado](https://code.claude.com/docs/pt/fast-mode.md#switch-models-while-fast-mode-is-on).

452 452 

453* **Escopo**: [`Any file`](#scopes)453* **Escopo**: [`Any file`](#scopes)

454* **Tipo**: Boolean454* **Tipo**: Boolean

455 * `true`: o Claude Code ativa o modo rápido em sessões onde ele está disponível455 * `true`: o Claude Code ativa o modo rápido em sessões onde ele está disponível. No Fable 5.2, você também precisa [executar `/fast` enquanto usa o Fable 5.2](https://code.claude.com/docs/pt/fast-mode#switch-models-while-fast-mode-is-on)

456 * `false`: o modo rápido permanece desativado456 * `false`: o modo rápido permanece desativado

457* **Padrão**: não definido, então o modo rápido fica desativado457* **Padrão**: não definido, então o modo rápido fica desativado

458* **Substituições por sessão**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/pt/env-vars) desativa o modo rápido para uma sessão, e esta chave não pode reativá-lo458* **Substituições por sessão**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/pt/env-vars) desativa o modo rápido para uma sessão, e esta chave não pode reativá-lo


465 465 

466### `fastModePerSessionOptIn`466### `fastModePerSessionOptIn`

467 467 

468Normalmente, executar `/fast` salva [`fastMode`](#fastmode) nas configurações de usuário da pessoa, então novas sessões em um modelo suportado começam com o modo rápido ativado. Defina esta chave como `true` para impedir isso: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, e cada pessoa precisa executar `/fast` em cada sessão em que quiser usá-lo. O Claude Code mantém a chave `fastMode` no arquivo, então desativar esta chave restaura o comportamento anterior.468Normalmente, executar `/fast` salva [`fastMode`](#fastmode) nas configurações de usuário da pessoa, então novas sessões em um modelo suportado começam com o modo rápido ativado. No Fable 5.2, isso acontece apenas se a pessoa [o ativou enquanto usava o Fable 5.2](https://code.claude.com/docs/pt/fast-mode.md#switch-models-while-fast-mode-is-on). Para fazer com que cada pessoa execute `/fast` em cada sessão em que quiser usá-lo, defina esta chave como `true`. O Claude Code mantém a chave `fastMode` no arquivo, então desativar esta chave restaura o comportamento anterior.

469 469 

470Owners em planos Team ou Enterprise podem implantá-la em toda a organização por meio de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Quando as configurações gerenciadas definem a chave, `/fast on` é recusado fora de sessões interativas no terminal e informa que sua organização desativou o modo rápido. Isso abrange o [modo não interativo](https://code.claude.com/docs/pt/headless.md), a [extensão do VS Code](https://code.claude.com/docs/pt/vs-code.md) e as [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md).470Owners em planos Team ou Enterprise podem implantá-la em toda a organização por meio de [configurações gerenciadas pelo servidor](https://code.claude.com/docs/pt/server-managed-settings.md). Quando as configurações gerenciadas definem a chave, `/fast on` é recusado fora de sessões interativas no terminal e informa que sua organização desativou o modo rápido. Isso abrange o [modo não interativo](https://code.claude.com/docs/pt/headless.md), a [extensão do VS Code](https://code.claude.com/docs/pt/vs-code.md) e as [sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md).

471 471 

472* **Escopo**: [`Any file`](#scopes)472* **Escopo**: [`Any file`](#scopes)

473* **Tipo**: Boolean473* **Tipo**: Boolean

474 * `true`: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, então cada pessoa executa `/fast` em cada sessão em que quiser usá-lo; um `fastMode: true` passado com `--settings` ainda vale para aquela sessão, a menos que as configurações gerenciadas definam esta chave474 * `true`: um `fastMode: true` salvo não ativa mais o modo rápido no início da sessão, então cada pessoa executa `/fast` em cada sessão em que quiser usá-lo; um `fastMode: true` passado com `--settings` ainda vale para aquela sessão, a menos que as configurações gerenciadas definam esta chave

475 * `false`: um `fastMode: true` salvo ativa o modo rápido no início de cada nova sessão em um modelo suportado475 * `false`: um `fastMode: true` salvo funciona conforme descrito em [`fastMode`](#fastmode)

476* **Padrão**: `false`476* **Padrão**: `false`

477 477 

478```json settings.json theme={null}478```json settings.json theme={null}

sub-agents.md +2 −0

Details

592O modo de permissão da conversa principal decide se o Claude Code usa o valor que você definiu:592O modo de permissão da conversa principal decide se o Claude Code usa o valor que você definiu:

593 593 

594* Quando a conversa principal está em `bypassPermissions`, `acceptEdits` ou no [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode), o subagente é executado nesse mesmo modo e o Claude Code ignora o `permissionMode` que você definiu. No modo auto, o classificador avalia as chamadas de ferramenta do subagente com as regras de bloqueio e de permissão da conversa principal. Quando o subagente termina, o classificador também revisa seu trabalho e seu relatório final antes que o relatório seja entregue, conforme descrito em [Como o modo auto lida com subagentes](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode).594* Quando a conversa principal está em `bypassPermissions`, `acceptEdits` ou no [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode), o subagente é executado nesse mesmo modo e o Claude Code ignora o `permissionMode` que você definiu. No modo auto, o classificador avalia as chamadas de ferramenta do subagente com as regras de bloqueio e de permissão da conversa principal. Quando o subagente termina, o classificador também revisa seu trabalho e seu relatório final antes que o relatório seja entregue, conforme descrito em [Como o modo auto lida com subagentes](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode).

595 

596 Se um subagente pedir permissão enquanto a conversa principal estiver em `bypassPermissions`, verifique se a chamada de ferramenta dele é uma das [ações que nenhum modo aprova automaticamente](https://code.claude.com/docs/pt/permission-modes.md#actions-no-mode-auto-approves).

595* Quando a conversa principal está no modo `plan`, o subagente permanece no modo de planejamento independentemente do `permissionMode` que você definir, a menos que seja executado como [colega de uma equipe de agentes](#subagent-names) sob as [regras de equipes de agentes](https://code.claude.com/docs/pt/agent-teams.md#have-teammates-plan-before-implementing). Se você definir `dontAsk`, o subagente também não solicita sua confirmação: uma ação que o modo de planejamento pediria para você aprovar é negada.597* Quando a conversa principal está no modo `plan`, o subagente permanece no modo de planejamento independentemente do `permissionMode` que você definir, a menos que seja executado como [colega de uma equipe de agentes](#subagent-names) sob as [regras de equipes de agentes](https://code.claude.com/docs/pt/agent-teams.md#have-teammates-plan-before-implementing). Se você definir `dontAsk`, o subagente também não solicita sua confirmação: uma ação que o modo de planejamento pediria para você aprovar é negada.

596* Quando a conversa principal está no modo `default` ou `dontAsk`, o subagente é executado no modo de permissão que você definiu. Em vez disso, ele mantém o modo de permissão da conversa principal nestes casos:598* Quando a conversa principal está no modo `default` ou `dontAsk`, o subagente é executado no modo de permissão que você definiu. Em vez disso, ele mantém o modo de permissão da conversa principal nestes casos:

597 * Você define `bypassPermissions`. A exceção de `bypassPermissions` requer o Claude Code v2.1.267 ou posterior.599 * Você define `bypassPermissions`. A exceção de `bypassPermissions` requer o Claude Code v2.1.267 ou posterior.

Details

26| `CronDelete` | Cancela uma tarefa agendada com escopo de sessão por ID | Não |26| `CronDelete` | Cancela uma tarefa agendada com escopo de sessão por ID | Não |

27| `CronList` | Lista todas as tarefas agendadas com escopo de sessão | Não |27| `CronList` | Lista todas as tarefas agendadas com escopo de sessão | Não |

28| `Edit` | Faz edições direcionadas em arquivos específicos. Veja [Comportamento da ferramenta Edit](#edit-tool-behavior) | Sim |28| `Edit` | Faz edições direcionadas em arquivos específicos. Veja [Comportamento da ferramenta Edit](#edit-tool-behavior) | Sim |

29| `EndConversation` | Encerra a sessão, em casos raros de entrada abusiva sustentada ou quando você pede a Claude para demonstrar a ferramenta. Veja [Comportamento da ferramenta EndConversation](#endconversation-tool-behavior) | Não |29| `EndConversation` | Encerra a sessão, em casos raros de entrada abusiva sustentada ou quando você pede a Claude para encerrar a sessão e depois confirma. Veja [Comportamento da ferramenta EndConversation](#endconversation-tool-behavior) | Não |

30| `EnterPlanMode` | Muda para o modo de planejamento para projetar uma abordagem antes de codificar | Não |30| `EnterPlanMode` | Muda para o modo de planejamento para projetar uma abordagem antes de codificar | Não |

31| `EnterWorktree` | Cria um [git worktree](https://code.claude.com/docs/pt/worktrees.md) isolado e muda para ele, ou muda para um worktree existente. Veja [Comportamento da ferramenta EnterWorktree](#enterworktree-tool-behavior) | Sim |31| `EnterWorktree` | Cria um [git worktree](https://code.claude.com/docs/pt/worktrees.md) isolado e muda para ele, ou muda para um worktree existente. Veja [Comportamento da ferramenta EnterWorktree](#enterworktree-tool-behavior) | Sim |

32| `ExitPlanMode` | Apresenta um plano para aprovação e sai do modo de planejamento | Sim |32| `ExitPlanMode` | Apresenta um plano para aprovação e sai do modo de planejamento | Sim |


274 274 

275A ferramenta EndConversation encerra a sessão atual. Claude a utiliza apenas em duas situações:275A ferramenta EndConversation encerra a sessão atual. Claude a utiliza apenas em duas situações:

276 276 

277* como último recurso contra entrada abusiva sustentada, após tentativas de redirecionar a conversa terem falhado e após um aviso claro em uma mensagem anterior277* Quando você continua enviando mensagens abusivas depois que Claude dá um aviso claro e não consegue redirecionar a conversa

278* quando você solicita explicitamente ver a ferramenta demonstrada e confirma que deseja encerrar a sessão278* Quando você pede explicitamente que Claude encerre a sessão e, em seguida, confirma quando Claude pergunta se você ainda deseja prosseguir

279 279 

280Frustração geral, profanidade ou uma tarefa correndo mal não se qualificam, assim como solicitações de conteúdo prejudicial, que Claude recusa em vez de encerrar a sessão. Claude Code segue a mesma abordagem que claude.ai, que pode [encerrar um subconjunto raro de chats](https://www.anthropic.com/research/end-subset-conversations).280Frustração geral, profanidade ou uma tarefa correndo mal não se qualificam, assim como solicitações de conteúdo prejudicial, que Claude recusa em vez de encerrar a sessão. Claude Code segue a mesma abordagem que claude.ai, que pode [encerrar um subconjunto raro de chats](https://www.anthropic.com/research/end-subset-conversations).

281 281 


390 390 

391Quando Monitor executa um comando, ele usa as mesmas [regras de permissão que Bash](https://code.claude.com/docs/pt/permissions.md#tool-specific-permission-rules), portanto os padrões `allow` e `deny` que você definiu para Bash também se aplicam aqui. Enquanto o [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) está ativo, Claude Code deixa de lado as regras allow que nomeiam o próprio `Monitor`, junto com as outras [regras allow amplas que ele descarta](https://code.claude.com/docs/pt/permission-modes.md#how-the-classifier-evaluates-actions), portanto o classificador revisa comandos Monitor da mesma forma que revisa comandos Bash.391Quando Monitor executa um comando, ele usa as mesmas [regras de permissão que Bash](https://code.claude.com/docs/pt/permissions.md#tool-specific-permission-rules), portanto os padrões `allow` e `deny` que você definiu para Bash também se aplicam aqui. Enquanto o [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) está ativo, Claude Code deixa de lado as regras allow que nomeiam o próprio `Monitor`, junto com as outras [regras allow amplas que ele descarta](https://code.claude.com/docs/pt/permission-modes.md#how-the-classifier-evaluates-actions), portanto o classificador revisa comandos Monitor da mesma forma que revisa comandos Bash.

392 392 

393A [fonte WebSocket](#websocket-source) tem seu próprio prompt de aprovação, que o classificador também decide no modo auto.

394 

395O Monitor precisa de uma versão mínima ou do Git Bash nestes casos:393O Monitor precisa de uma versão mínima ou do Git Bash nestes casos:

396 394 

397* **Versão mínima**: no Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud ou Microsoft Foundry, ou com `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` definido, o Monitor requer Claude Code v2.1.310 ou posterior. O requisito se aplica quando a [busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching) está desativada395* **Versão mínima**: no Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud ou Microsoft Foundry, ou com `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` definido, o Monitor requer Claude Code v2.1.310 ou posterior. O requisito se aplica quando a [busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching) está desativada


417 415 

418O prazo `timeout_ms` também se aplica a uma observação WebSocket: a observação termina no prazo, e `TaskStop` a cancela antecipadamente.416O prazo `timeout_ms` também se aplica a uma observação WebSocket: a observação termina no prazo, e `TaskStop` a cancela antecipadamente.

419 417 

420Abrir uma WebSocket solicita aprovação; no [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) o classificador decide em vez disso. O prompt não oferece uma opção para pular prompts futuros para o mesmo host.418Sem uma regra allow de `Monitor`, você recebe um prompt antes que Claude abra uma WebSocket; no [modo auto](https://code.claude.com/docs/pt/permission-modes.md#eliminate-prompts-with-auto-mode) o classificador decide em vez disso, a menos que uma [regra ask](#bash-rules-that-deny-or-prompt-for-websocket-watches) se aplique. O prompt não oferece uma opção para pular prompts futuros para o mesmo host.

419 

420#### Endereços e hosts negados a observações WebSocket

421 

422Claude Code nega URLs que apontam para um endereço privado, link-local ou de metadados de nuvem, incluindo nomes de host que sua máquina resolve para um. Por trás de um [proxy](https://code.claude.com/docs/pt/network-config.md#proxy-configuration), uma observação pode alcançar um endereço privado, link-local ou de metadados de nuvem, a menos que o proxy o bloqueie, porque Claude Code não verifica o endereço que o proxy encontra. Claude Code também nega hosts em `sandbox.network.deniedDomains`, e quando [`allowManagedDomainsOnly`](https://code.claude.com/docs/pt/settings-reference#sandbox-network-allowmanageddomainsonly) está definido em configurações gerenciadas, qualquer host fora da allowlist gerenciada.

423 

424Se uma observação por trás de um proxy falhar com `could not resolve <host>`, reinicie o Claude Code v2.1.319 ou posterior com [`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`](https://code.claude.com/docs/pt/env-vars#variables) definido como `1` para que o proxy busque o nome de host.

425 

426#### Regras Bash que negam ou pedem confirmação para observações WebSocket

427 

428Se Claude Code recusar uma chamada `Monitor` que abre uma WebSocket, procure uma [regra deny ou ask](https://code.claude.com/docs/pt/permissions.md#manage-permissions) escrita como `Bash` ou `Bash(*)`. Faça o mesmo se ele pedir confirmação para essa chamada apesar da sua regra allow de `Monitor`. Uma regra sobre todos os comandos Bash também abrange essas observações WebSocket:

429 

430* **Regra deny**: se a regra estiver em vigor quando a sessão começar, Claude não tem a ferramenta Monitor, portanto não pode iniciar a observação. Se você adicionar a regra durante uma sessão, a próxima chamada `Monitor` de Claude é recusada. A recusa diz `Permission to use Monitor has been denied: it runs code as Bash does, and a rule denies Bash.`

431* **Regra ask**: você é solicitado a aprovar a observação. Não é possível fazer com que uma regra allow, um hook `PreToolUse`, o modo `bypassPermissions` ou o classificador do modo auto a aprove por você. Você pode aprová-la a partir de um [hook `PermissionRequest`](https://code.claude.com/docs/pt/hooks#permissionrequest). Onde ninguém pode responder, como no modo `dontAsk`, Claude Code nega a observação.

432 

433Para permitir que essas observações sejam executadas, restrinja a regra aos comandos que você pretende, como `Bash(rm *)`.

421 434 

422Claude Code nega URLs que apontam para um endereço privado, link-local ou de metadados de nuvem, incluindo nomes de host que resolvem para um. Também nega hosts em `sandbox.network.deniedDomains`, e quando [`allowManagedDomainsOnly`](https://code.claude.com/docs/pt/settings-reference#sandbox-network-allowmanageddomainsonly) está definido em configurações gerenciadas, qualquer host fora da allowlist gerenciada.435A regra ask, e uma regra deny que você adiciona durante uma sessão, abrangem essas observações no Claude Code v2.1.319 ou posterior.

423 436 

424## Comportamento da ferramenta NotebookEdit437## Comportamento da ferramenta NotebookEdit

425 438 


594* Execuções não interativas com `-p` e sessões do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), que não têm uma tela para revisar a fila607* Execuções não interativas com `-p` e sessões do [Agent SDK](https://code.claude.com/docs/pt/agent-sdk/overview.md), que não têm uma tela para revisar a fila

595* [Sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), que não podem gravar na fila da sua máquina608* [Sessões na nuvem](https://code.claude.com/docs/pt/claude-code-on-the-web.md), que não podem gravar na fila da sua máquina

596* Sessões no [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), na [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md), na [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md) ou no [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md)609* Sessões no [Amazon Bedrock](https://code.claude.com/docs/pt/amazon-bedrock.md), na [Claude Platform on AWS](https://code.claude.com/docs/pt/claude-platform-on-aws.md), na [Agent Platform do Google Cloud](https://code.claude.com/docs/pt/google-vertex-ai.md) ou no [Microsoft Foundry](https://code.claude.com/docs/pt/microsoft-foundry.md)

610* Sessões que acessam o Claude por meio de um [gateway de LLM](https://code.claude.com/docs/pt/llm-gateway) com a chave ou o token próprio do gateway

597* Sessões em que você definiu [`CLAUDE_CODE_SEND_FEEDBACK=0`](https://code.claude.com/docs/pt/env-vars) ou [`DISABLE_FEEDBACK_COMMAND=1`](https://code.claude.com/docs/pt/env-vars), definiu `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` com qualquer valor não vazio ou desativou a [busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching)611* Sessões em que você definiu [`CLAUDE_CODE_SEND_FEEDBACK=0`](https://code.claude.com/docs/pt/env-vars) ou [`DISABLE_FEEDBACK_COMMAND=1`](https://code.claude.com/docs/pt/env-vars), definiu `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` com qualquer valor não vazio ou desativou a [busca de feature flags](https://code.claude.com/docs/pt/env-vars.md#features-that-need-feature-flag-fetching)

598* Organizações que desativaram o feedback do produto, [organizações com Zero Data Retention](https://code.claude.com/docs/pt/zero-data-retention.md#features-disabled-under-zdr) e organizações com a [configuração HIPAA](https://code.claude.com/docs/pt/hipaa-setup.md) aplicada612* Organizações que desativaram o feedback do produto, [organizações com Zero Data Retention](https://code.claude.com/docs/pt/zero-data-retention.md#features-disabled-under-zdr) e organizações com a [configuração HIPAA](https://code.claude.com/docs/pt/hipaa-setup.md) aplicada

613* Sessões em que o Claude Code [parou de oferecer feedback após um relatório recusado](https://code.claude.com/docs/pt/errors.md#feedback-is-disabled-by-your-organizations-policy)

599 614 

600## Disponibilidade da ferramenta Task615## Disponibilidade da ferramenta Task

601 616 

Details

70 70 

71### Disponibilidade de modelos sob ZDR71### Disponibilidade de modelos sob ZDR

72 72 

73Claude Fable 5.1 e Fable 5 são [Modelos Cobertos](https://support.claude.com/en/articles/15425695-covered-models) que [requerem retenção de dados](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements) por padrão, e se uma organização ou workspace ZDR pode usá-los é governado pelas políticas de Modelos Cobertos em vez de pelo Claude Code. Onde sua organização não pode usá-los, os modelos estão ausentes do seletor `/model` ou são exibidos como desabilitados, e o servidor rejeita solicitações para eles independentemente da configuração do cliente.73Claude Fable 5.2, Fable 5.1 e Fable 5 são [Modelos Cobertos](https://support.claude.com/en/articles/15425695-covered-models) que [requerem retenção de dados](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements) por padrão, e se uma organização ou workspace ZDR pode usá-los é governado pelas políticas de Modelos Cobertos em vez de pelo Claude Code. Onde sua organização não pode usá-los, os modelos estão ausentes do seletor `/model` ou são exibidos como desabilitados, e o servidor rejeita requisições para eles independentemente da configuração do cliente.

74 74 

75Outros modelos permanecem disponíveis sob ZDR. Modelos Fable não são o padrão, e o alias `best`, que resolve para o modelo Fable mais recente onde está disponível, resolve para Opus para organizações onde não está.75Outros modelos permanecem disponíveis sob ZDR. Modelos Fable não são o padrão, e o alias `best` resolve para Opus.

76 76 

77## Retenção de dados para violações de política77## Retenção de dados para violações de política

78 78