SpyBara
Go Premium

Documentation 2026-10-05 23:58 UTC to 2026-10-06 18:02 UTC

77 files changed +759 −613. View all changes and history on the product overview
2026
Tue 6 19:01 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59

admin-setup.md +3 −2

Details

174| Tópico | O que saber | Por onde começar |174| Tópico | O que saber | Por onde começar |

175| :- | :- | :- |175| :- | :- | :- |

176| Data usage policy | O que Anthropic coleta, quanto tempo é retido, o que nunca é usado para treinamento | [Data usage](/docs/pt/data-usage) |176| Data usage policy | O que Anthropic coleta, quanto tempo é retido, o que nunca é usado para treinamento | [Data usage](/docs/pt/data-usage) |

177| Zero Data Retention (ZDR) | Nada armazenado após a conclusão da solicitação. Disponível para contas qualificadas no Claude for Enterprise | [Zero data retention](/docs/pt/zero-data-retention) |177| Zero Data Retention (ZDR) | Nada armazenado após a conclusão da requisição. Disponível para contas qualificadas no Claude for Enterprise | [Zero data retention](/docs/pt/zero-data-retention) |

178| Configuração HIPAA | Para organizações do Claude for Enterprise que têm HIPAA habilitado. Alguns recursos do Claude Code (modo local) são desativados e outros ficam desativados por padrão | [Configure o Claude Code (modo local) para uma organização preparada para HIPAA](/docs/pt/hipaa-setup) |

178| Security architecture | Modelo de rede, criptografia, autenticação, trilha de auditoria | [Security](/docs/pt/security) |179| Security architecture | Modelo de rede, criptografia, autenticação, trilha de auditoria | [Security](/docs/pt/security) |

179 180 

180Se você precisar de registro de auditoria em nível de solicitação ou rotear tráfego por sensibilidade de dados, coloque um gateway entre desenvolvedores e seu provedor: um [Claude apps gateway](/docs/pt/claude-apps-gateway) auto-hospedado registra um log de auditoria por solicitação com identidade IdP, ou use outro [LLM gateway](/docs/pt/llm-gateway). Para requisitos regulatórios e certificações, consulte [Legal and compliance](/docs/pt/legal-and-compliance).181Se você precisar de log de auditoria em nível de requisição ou rotear tráfego por sensibilidade de dados, recomendamos que você coloque um gateway entre os desenvolvedores e seu provedor: um [Claude apps gateway](/docs/pt/claude-apps-gateway) auto-hospedado registra um log de auditoria por requisição com identidade do IdP, ou você pode usar outro [LLM gateway](/docs/pt/llm-gateway). Sessões que passam por um gateway não são elegíveis para a configuração HIPAA. [Verifique como os desenvolvedores fazem login e se conectam](/docs/pt/hipaa-setup#check-how-developers-sign-in-and-connect) lista quais métodos de login e de conexão são. Para requisitos regulatórios e certificações, consulte [Legal and compliance](/docs/pt/legal-and-compliance).

181 182 

182<h2 id="verify-and-onboard">183<h2 id="verify-and-onboard">

183 Verifique e integre184 Verifique e integre

Details

110Arquivos `CLAUDE.md` e arquivos `.claude/rules/*.md` dão ao seu agente contexto persistente sobre seu projeto: convenções de codificação, comandos de compilação, decisões de arquitetura e instruções. Quando `settingSources` inclui `"project"`, como no [exemplo de `settingSources`](#control-filesystem-settings-with-settingsources), o SDK carrega esses arquivos em contexto no início da sessão. O agente então segue suas convenções de projeto sem você repeti-las em cada prompt.110Arquivos `CLAUDE.md` e arquivos `.claude/rules/*.md` dão ao seu agente contexto persistente sobre seu projeto: convenções de codificação, comandos de compilação, decisões de arquitetura e instruções. Quando `settingSources` inclui `"project"`, como no [exemplo de `settingSources`](#control-filesystem-settings-with-settingsources), o SDK carrega esses arquivos em contexto no início da sessão. O agente então segue suas convenções de projeto sem você repeti-las em cada prompt.

111 111 

112<h3 id="claude-md-load-locations">112<h3 id="claude-md-load-locations">

113 CLAUDE.md load locations113 Locais de carregamento do CLAUDE.md

114</h3>114</h3>

115 115 

116| Nível | Local | Quando carregado |116| Nível | Local | Quando carregado |


118| Projeto (raiz) | `<cwd>/CLAUDE.md` ou `<cwd>/.claude/CLAUDE.md` | `settingSources` inclui `"project"` |118| Projeto (raiz) | `<cwd>/CLAUDE.md` ou `<cwd>/.claude/CLAUDE.md` | `settingSources` inclui `"project"` |

119| Regras do projeto | `<cwd>/.claude/rules/*.md` e `.claude/rules/*.md` em cada diretório pai | `settingSources` inclui `"project"` |119| Regras do projeto | `<cwd>/.claude/rules/*.md` e `.claude/rules/*.md` em cada diretório pai | `settingSources` inclui `"project"` |

120| Projeto (diretórios pai) | Arquivos `CLAUDE.md` em diretórios acima de `cwd` | `settingSources` inclui `"project"`, carregado no início da sessão |120| Projeto (diretórios pai) | Arquivos `CLAUDE.md` em diretórios acima de `cwd` | `settingSources` inclui `"project"`, carregado no início da sessão |

121| Projeto (diretórios filho) | Arquivos `CLAUDE.md` em subdiretórios de `cwd` | `settingSources` inclui `"project"`, carregado sob demanda quando o agente lê um arquivo nessa subárvore |121| Projeto (diretórios filho) | Arquivos `CLAUDE.md` em subdiretórios de `cwd` | `settingSources` inclui `"project"`, carregado [sob demanda](/docs/pt/memory#how-claude-md-files-load) |

122| Local | `<cwd>/CLAUDE.local.md` e `CLAUDE.local.md` em cada diretório pai | `settingSources` inclui `"local"` |122| Local | `<cwd>/CLAUDE.local.md` e `CLAUDE.local.md` em cada diretório pai | `settingSources` inclui `"local"` |

123| Usuário | `~/.claude/CLAUDE.md` | `settingSources` inclui `"user"` |123| Usuário | `~/.claude/CLAUDE.md` | `settingSources` inclui `"user"` |

124| Regras do usuário | `~/.claude/rules/*.md` | `settingSources` inclui `"user"` |124| Regras do usuário | `~/.claude/rules/*.md` | `settingSources` inclui `"user"` |

125 125 

126Todos os níveis são aditivos: se existem arquivos `CLAUDE.md` de projeto e usuário, o agente vê ambos. Não há regra de precedência rígida entre níveis; se as instruções conflitarem, o resultado depende de como Claude as interpreta. Escreva regras não conflitantes, ou declare precedência explicitamente no arquivo mais específico ("Estas instruções de projeto substituem quaisquer padrões conflitantes de nível de usuário").126Todos os níveis são aditivos: se existem arquivos `CLAUDE.md` de projeto e usuário, o agente vê ambos. Não há regra de precedência rígida entre níveis; se as instruções conflitarem, o resultado depende de como Claude as interpreta. Escreva regras não conflitantes, ou declare precedência explicitamente no arquivo mais específico ("Estas instruções de projeto sobrescrevem quaisquer padrões conflitantes de nível de usuário").

127 127 

128<Tip>128<Tip>

129 Você também pode injetar contexto diretamente via `systemPrompt` sem usar arquivos `CLAUDE.md`. Veja [Modify system prompts](/docs/pt/agent-sdk/modifying-system-prompts). Use `CLAUDE.md` quando você quer que o mesmo contexto seja compartilhado entre sessões interativas de Claude Code e seus agentes SDK.129 Você também pode injetar contexto diretamente via `systemPrompt` sem usar arquivos `CLAUDE.md`. Veja [Modify system prompts](/docs/pt/agent-sdk/modifying-system-prompts). Use `CLAUDE.md` quando você quer que o mesmo contexto seja compartilhado entre sessões interativas de Claude Code e seus agentes SDK.

Details

10 10 

11Para documentação completa da API, consulte a [referência do SDK TypeScript](/docs/pt/agent-sdk/typescript) e a [referência do SDK Python](/docs/pt/agent-sdk/python).11Para documentação completa da API, consulte a [referência do SDK TypeScript](/docs/pt/agent-sdk/typescript) e a [referência do SDK Python](/docs/pt/agent-sdk/python).

12 12 

13<span id="estimates-not-billing" />

14 

13<Warning>15<Warning>

14 Os campos `total_cost_usd` e `costUSD` são estimativas do lado do cliente, não dados de faturamento autoritários. O SDK os calcula localmente a partir de uma tabela de preços incluída no tempo de compilação, a menos que uma tabela [`modelPricing`](/docs/pt/settings-reference#modelpricing) esteja em vigor. Eles podem divergir do que você é realmente faturado quando:16 Os campos `total_cost_usd` e `costUSD` são estimativas do lado do cliente, não dados de faturamento autoritários. O SDK os calcula localmente a partir de uma tabela de preços incluída no tempo de compilação, a menos que uma tabela [`modelPricing`](/docs/pt/settings-reference#modelpricing) esteja em vigor. Eles podem divergir do que você é realmente faturado quando:

15 17 


242* **Chamadas independentes, sem opção `resume` ou `continue`**: cada resultado cobre apenas sua própria chamada, portanto, adicione os totais você mesmo, como os exemplos abaixo fazem.244* **Chamadas independentes, sem opção `resume` ou `continue`**: cada resultado cobre apenas sua própria chamada, portanto, adicione os totais você mesmo, como os exemplos abaixo fazem.

243* **Chamadas que retomam a mesma sessão**: Claude Code salva os totais da sessão em sua [transcrição](/docs/pt/sessions#where-transcripts-are-stored) quando o processo sai normalmente e os restaura quando uma chamada posterior retoma ou bifurca a sessão. Cada resultado já inclui o gasto anterior da sessão. Leia o resultado mais recente para o total da sessão; somar resultados conta duas vezes o gasto restaurado. Antes da v2.1.277, uma sessão que você retomou através do SDK ou `claude -p` iniciava seus totais em zero, portanto, cada resultado de chamada cobria apenas essa chamada.245* **Chamadas que retomam a mesma sessão**: Claude Code salva os totais da sessão em sua [transcrição](/docs/pt/sessions#where-transcripts-are-stored) quando o processo sai normalmente e os restaura quando uma chamada posterior retoma ou bifurca a sessão. Cada resultado já inclui o gasto anterior da sessão. Leia o resultado mais recente para o total da sessão; somar resultados conta duas vezes o gasto restaurado. Antes da v2.1.277, uma sessão que você retomou através do SDK ou `claude -p` iniciava seus totais em zero, portanto, cada resultado de chamada cobria apenas essa chamada.

244 246 

247De qualquer forma, o valor combinado ainda é uma [estimativa do lado do cliente](#estimates-not-billing).

248 

245No modo de entrada em streaming, leia o total de cada chamada conforme descrito em [Rastrear custos no modo de entrada em streaming](#track-costs-in-streaming-input-mode). Para uma chamada que terminou em uma falha, consulte [Recuperar totais após uma falha de sessão](#recover-totals-after-a-session-crash).249No modo de entrada em streaming, leia o total de cada chamada conforme descrito em [Rastrear custos no modo de entrada em streaming](#track-costs-in-streaming-input-mode). Para uma chamada que terminou em uma falha, consulte [Recuperar totais após uma falha de sessão](#recover-totals-after-a-session-crash).

246 250 

247Os exemplos a seguir executam duas chamadas `query()` sequencialmente, adicionam o `total_cost_usd` de cada chamada a um total acumulado e imprimem tanto o custo por chamada quanto o custo combinado:251Os exemplos a seguir executam duas chamadas `query()` sequencialmente, adicionam o `total_cost_usd` de cada chamada a um total acumulado e imprimem tanto o custo por chamada quanto o custo combinado:

Details

15| Se você quer... | Faça isto |15| Se você quer... | Faça isto |

16| :- | :- |16| :- | :- |

17| Definir uma ferramenta | Use [`@tool`](/docs/pt/agent-sdk/python#tool) (Python) ou [`tool()`](/docs/pt/agent-sdk/typescript#tool) (TypeScript) com um nome, descrição, esquema e manipulador. Veja [Criar uma ferramenta personalizada](#create-a-custom-tool). |17| Definir uma ferramenta | Use [`@tool`](/docs/pt/agent-sdk/python#tool) (Python) ou [`tool()`](/docs/pt/agent-sdk/typescript#tool) (TypeScript) com um nome, descrição, esquema e manipulador. Veja [Criar uma ferramenta personalizada](#create-a-custom-tool). |

18| Tornar um parâmetro opcional | Declare-o como opcional no esquema e aplique o valor padrão no manipulador. Veja [Tornar um parâmetro opcional](#make-a-parameter-optional). |

18| Registrar uma ferramenta com Claude | Envolva em `create_sdk_mcp_server` / `createSdkMcpServer` e passe para `mcpServers` em `query()`. Veja [Chamar uma ferramenta personalizada](#call-a-custom-tool). |19| Registrar uma ferramenta com Claude | Envolva em `create_sdk_mcp_server` / `createSdkMcpServer` e passe para `mcpServers` em `query()`. Veja [Chamar uma ferramenta personalizada](#call-a-custom-tool). |

19| Pré-aprovar uma ferramenta | Adicione às suas ferramentas permitidas. Veja [Configurar ferramentas permitidas](#configure-allowed-tools). |20| Pré-aprovar uma ferramenta | Adicione às suas ferramentas permitidas. Veja [Configurar ferramentas permitidas](#configure-allowed-tools). |

20| Remover uma ferramenta integrada do contexto de Claude | Passe um array `tools` listando apenas os integrados que você quer. Veja [Configurar ferramentas permitidas](#configure-allowed-tools). |21| Remover uma ferramenta integrada do contexto de Claude | Passe um array `tools` listando apenas os integrados que você quer. Veja [Configurar ferramentas permitidas](#configure-allowed-tools). |


32 33 

33* **Nome:** um identificador único que Claude usa para chamar a ferramenta.34* **Nome:** um identificador único que Claude usa para chamar a ferramenta.

34* **Descrição:** o que a ferramenta faz. Claude lê isso para decidir quando chamá-la.35* **Descrição:** o que a ferramenta faz. Claude lê isso para decidir quando chamá-la.

35* **Esquema de entrada:** os argumentos que Claude deve fornecer. Em TypeScript, isso é sempre um [esquema Zod](https://zod.dev/), e os `args` do manipulador são digitados automaticamente a partir dele. Em Python, isso é um dicionário mapeando nomes para tipos, como `{"latitude": float}`, que o SDK converte para JSON Schema para você. O decorador Python também aceita um dicionário completo de [JSON Schema](https://json-schema.org/understanding-json-schema/about) diretamente quando você precisa de enums, intervalos, campos opcionais ou objetos aninhados.36* **Esquema de entrada:** os argumentos que a ferramenta aceita, declarados conforme a linguagem:

37 * **TypeScript**: um [esquema Zod](https://zod.dev/). Os `args` do manipulador obtêm seus tipos a partir dele. Chame `.describe()` em um campo para dar a ele uma descrição que Claude vê.

38 * **Python**: um dicionário mapeando nomes para tipos, como `{"latitude": float}`, que o SDK converte para JSON Schema para você. Envolva um tipo em `Annotated`, como `{"latitude": Annotated[float, "Latitude coordinate"]}`, para dar ao campo uma descrição que Claude vê. O decorador também aceita um dicionário completo de [JSON Schema](https://json-schema.org/understanding-json-schema/about) diretamente quando você precisa de enums, intervalos, campos opcionais ou objetos aninhados.

36* **Manipulador:** a função assíncrona que é executada quando Claude chama a ferramenta. Ela recebe os argumentos validados e deve retornar um objeto com:39* **Manipulador:** a função assíncrona que é executada quando Claude chama a ferramenta. Ela recebe os argumentos validados e deve retornar um objeto com:

37 * `content` (obrigatório): um array de blocos de resultado, cada um com um `type` de `"text"`, `"image"`, `"audio"`, `"resource"` ou `"resource_link"`. Veja [Retornar imagens e recursos](#return-images-and-resources) para blocos não-texto.40 * `content` (obrigatório): um array de blocos de resultado, cada um com um `type` de `"text"`, `"image"`, `"audio"`, `"resource"` ou `"resource_link"`. Veja [Retornar imagens e recursos](#return-images-and-resources) para blocos não-texto.

38 * `structuredContent` (opcional): um objeto JSON contendo o resultado como dados legíveis por máquina, retornado junto com `content`. Veja [Retornar dados estruturados](#return-structured-data).41 * `structuredContent` (opcional): um objeto JSON contendo o resultado como dados legíveis por máquina, retornado junto com `content`. Veja [Retornar dados estruturados](#return-structured-data).


40 43 

41Após definir uma ferramenta, envolva-a em um servidor com [`createSdkMcpServer`](/docs/pt/agent-sdk/typescript#createsdkmcpserver) (TypeScript) ou [`create_sdk_mcp_server`](/docs/pt/agent-sdk/python#create_sdk_mcp_server) (Python). O servidor é executado no processo dentro de sua aplicação, não como um processo separado.44Após definir uma ferramenta, envolva-a em um servidor com [`createSdkMcpServer`](/docs/pt/agent-sdk/typescript#createsdkmcpserver) (TypeScript) ou [`create_sdk_mcp_server`](/docs/pt/agent-sdk/python#create_sdk_mcp_server) (Python). O servidor é executado no processo dentro de sua aplicação, não como um processo separado.

42 45 

46Os exemplos em Python nesta página que fazem requisições HTTP usam [httpx](https://www.python-httpx.org/). Adicione-o com o gerenciador de pacotes que seu projeto usa:

47 

48<Tabs>

49 <Tab title="Python (uv)">

50 ```bash theme={null}

51 uv add httpx

52 ```

53 </Tab>

54 

55 <Tab title="Python (pip)">

56 ```bash theme={null}

57 pip install httpx

58 ```

59 </Tab>

60</Tabs>

61 

43<h3 id="weather-tool-example">62<h3 id="weather-tool-example">

44 Exemplo de ferramenta de clima63 Exemplo de ferramenta de clima

45</h3>64</h3>

46 65 

47Este exemplo define uma ferramenta `get_temperature` e a envolve em um servidor MCP. Ele apenas configura a ferramenta; para passá-la para `query` e executá-la, veja [Chamar uma ferramenta personalizada](#call-a-custom-tool) abaixo.66Este 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.

48 67 

49<CodeGroup>68<CodeGroup>

50 ```python Python theme={null}69 ```python Python theme={null}

51 from typing import Any70 from typing import Annotated, Any

52 import httpx71 import httpx

53 from claude_agent_sdk import tool, create_sdk_mcp_server72 from claude_agent_sdk import tool, create_sdk_mcp_server

54 73 


57 @tool(76 @tool(

58 "get_temperature",77 "get_temperature",

59 "Get the current temperature at a location",78 "Get the current temperature at a location",

60 {"latitude": float, "longitude": float},79 {

80 "latitude": Annotated[float, "Latitude coordinate"],

81 "longitude": Annotated[float, "Longitude coordinate"],

82 },

61 )83 )

62 async def get_temperature(args: dict[str, Any]) -> dict[str, Any]:84 async def get_temperature(args: dict[str, Any]) -> dict[str, Any]:

63 async with httpx.AsyncClient() as client:85 async with httpx.AsyncClient() as client:


128 150 

129Veja a referência TypeScript [`tool()`](/docs/pt/agent-sdk/typescript#tool) ou a referência Python [`@tool`](/docs/pt/agent-sdk/python#tool) para detalhes completos dos parâmetros, incluindo formatos de entrada JSON Schema e estrutura de valor de retorno.151Veja a referência TypeScript [`tool()`](/docs/pt/agent-sdk/typescript#tool) ou a referência Python [`@tool`](/docs/pt/agent-sdk/python#tool) para detalhes completos dos parâmetros, incluindo formatos de entrada JSON Schema e estrutura de valor de retorno.

130 152 

131<Tip>153<h3 id="make-a-parameter-optional">

132 Para tornar um parâmetro opcional: em TypeScript, adicione `.optional()` ao campo Zod e aplique o padrão no manipulador. Em Python, o esquema de dicionário trata cada chave como obrigatória, então deixe o parâmetro fora do esquema, mencione-o na string de descrição e leia-o com `args.get()` no manipulador. A ferramenta [`get_precipitation_chance` abaixo](#add-more-tools) mostra ambos os padrões.154 Tornar um parâmetro opcional

133</Tip>155</h3>

156 

157Para tornar um parâmetro opcional, declare-o como opcional no esquema e aplique o padrão no manipulador:

158 

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

160* **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](/docs/pt/agent-sdk/python#input-schema-options).

161 

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

134 163 

135<h3 id="call-a-custom-tool">164<h3 id="call-a-custom-tool">

136 Chamar uma ferramenta personalizada165 Chamar uma ferramenta personalizada


182 ```211 ```

183</CodeGroup>212</CodeGroup>

184 213 

185Combine este trecho com as definições de ferramenta e servidor do [exemplo de ferramenta de clima](#weather-tool-example) em um arquivo, depois execute-o com `python weather.py` para Python ou `npx tsx weather.ts` para TypeScript. Claude chama `get_temperature` e o script imprime uma resposta de uma linha com a temperatura atual em San Francisco.214Combine este trecho com as definições de ferramenta e servidor do [exemplo de ferramenta de clima](#weather-tool-example) em um arquivo, `weather.py` ou `weather.ts`, depois execute-o a partir do seu terminal:

215 

216<Tabs>

217 <Tab title="TypeScript">

218 ```bash theme={null}

219 npx tsx weather.ts

220 ```

221 </Tab>

222 

223 <Tab title="Python (uv)">

224 ```bash theme={null}

225 uv run weather.py

226 ```

227 </Tab>

228 

229 <Tab title="Python (pip)">

230 Ative o ambiente virtual onde você instalou o SDK e, em seguida, execute:

231 

232 ```bash theme={null}

233 python weather.py

234 ```

235 </Tab>

236</Tabs>

237 

238Claude chama `get_temperature` e o script imprime uma resposta de uma linha com a temperatura atual em San Francisco.

186 239 

187<h3 id="add-more-tools">240<h3 id="add-more-tools">

188 Adicionar mais ferramentas241 Adicionar mais ferramentas


197 # Define a second tool for the same server250 # Define a second tool for the same server

198 @tool(251 @tool(

199 "get_precipitation_chance",252 "get_precipitation_chance",

200 "Get the hourly precipitation probability for a location. "253 "Get the hourly precipitation probability for a location",

201 "Optionally pass 'hours' (1-24) to control how many hours to return.",254 {

202 {"latitude": float, "longitude": float},255 "type": "object",

256 "properties": {

257 "latitude": {"type": "number"},

258 "longitude": {"type": "number"},

259 "hours": {

260 "type": "integer",

261 "minimum": 1,

262 "maximum": 24,

263 "description": "How many hours of forecast to return",

264 },

265 },

266 # 'hours' is left out of required, so Claude can omit it

267 "required": ["latitude", "longitude"],

268 },

203 )269 )

204 async def get_precipitation_chance(args: dict[str, Any]) -> dict[str, Any]:270 async def get_precipitation_chance(args: dict[str, Any]) -> dict[str, Any]:

205 # 'hours' isn't in the schema - read it with .get() to make it optional271 # 'hours' isn't in required - read it with .get() to fall back to a default

206 hours = args.get("hours", 12)272 hours = args.get("hours", 12)

207 async with httpx.AsyncClient() as client:273 async with httpx.AsyncClient() as client:

208 response = await client.get(274 response = await client.get(

Details

147 }147 }

148 ```148 ```

149 149 

1503. **Classe TypedDict**: um esquema tipado cujas chaves `NotRequired` são deixadas fora de `required`.

151 

152 * **Python 3.11 e posterior**: importe `TypedDict` e `NotRequired` de `typing`.

153 * **Python 3.10**: `typing` não tem `NotRequired`. Importe `TypedDict` e `NotRequired` de `typing_extensions`, que o SDK instala no Python 3.10.

154 

155 ```python theme={null}

156 from typing import Annotated, Any, NotRequired, TypedDict

157 from claude_agent_sdk import tool

158 

159 

160 class ForecastArgs(TypedDict):

161 latitude: Annotated[float, "Latitude coordinate"]

162 hours: NotRequired[Annotated[int, "How many hours of forecast to return"]]

163 

164 

165 @tool("get_forecast", "Get the hourly forecast for a location", ForecastArgs)

166 async def get_forecast(args: dict[str, Any]) -> dict[str, Any]:

167 hours = args.get("hours", 12)

168 return {"content": [{"type": "text", "text": f"{hours}-hour forecast for {args['latitude']}"}]}

169 ```

170 

171Nas formas de mapeamento simples e TypedDict, envolva um tipo em `Annotated[type, "description"]` para definir a descrição do campo.

172 

150<h4 id="returns-2">173<h4 id="returns-2">

151 Retorna174 Retorna

152</h4>175</h4>


1781 data: dict[str, Any]1804 data: dict[str, Any]

1782```1805```

1783 1806 

1807Subtipos que não têm uma dataclass própria chegam como `SystemMessage`. Para acompanhar a sessão entre turnos, defina [`CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS=1`](/docs/pt/env-vars#variables) e leia `message.data["state"]` em cada mensagem cujo `subtype` seja `session_state_changed`. [`SDKSessionStateChangedMessage`](/docs/pt/agent-sdk/typescript#sdksessionstatechangedmessage) lista os estados que ela pode carregar. Itere com `receive_messages()` para lê-los: `receive_response()` para no `ResultMessage`, e uma mensagem `session_state_changed` pode vir depois desse resultado.

1808 

1784<h3 id="resultmessage">1809<h3 id="resultmessage">

1785 `ResultMessage`1810 `ResultMessage`

1786</h3>1811</h3>

Details

130 Consulte os guias de configuração para [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), ou [Microsoft Foundry](/docs/pt/microsoft-foundry) para detalhes.130 Consulte os guias de configuração para [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), ou [Microsoft Foundry](/docs/pt/microsoft-foundry) para detalhes.

131 131 

132 <Note>132 <Note>

133 A menos que previamente aprovado, a Anthropic não permite que desenvolvedores terceirizados ofereçam login claude.ai ou limites de taxa para seus produtos, incluindo agentes construídos no Agent SDK Claude. Use os métodos de autenticação de chave de API descritos neste documento.133 A menos que previamente aprovado, a Anthropic não permite que desenvolvedores terceirizados ofereçam login claude.ai ou rate limits para seus produtos, incluindo agentes construídos no Claude Agent SDK. Em vez disso, use os métodos de autenticação de chave de API descritos neste documento.

134 </Note>134 </Note>

135 </Step>135 </Step>

136</Steps>136</Steps>

Details

317 317 

318Esta abordagem lida com qualquer serviço baseado em HTTP sem escrever ferramentas personalizadas, mas adiciona complexidade em torno do gerenciamento de certificados.318Esta abordagem lida com qualquer serviço baseado em HTTP sem escrever ferramentas personalizadas, mas adiciona complexidade em torno do gerenciamento de certificados.

319 319 

320Note que nem todos os programas respeitam `HTTP_PROXY`/`HTTPS_PROXY`. A maioria das ferramentas (curl, pip, npm, git) respeita, mas algumas podem contornar essas variáveis e conectar diretamente. Por exemplo, `fetch()` do Node.js ignora essas variáveis por padrão; no Node 24+ você pode definir `NODE_USE_ENV_PROXY=1` para habilitar suporte. Para cobertura abrangente, você pode usar [proxychains](https://github.com/haad/proxychains) para interceptar chamadas de rede, ou configurar iptables para redirecionar tráfego de saída para um proxy transparente.320Note que nem todos os programas respeitam `HTTP_PROXY`/`HTTPS_PROXY`. A maioria das ferramentas (curl, pip, npm, git) respeita, mas algumas podem contornar essas variáveis e conectar diretamente. Por exemplo, `fetch()` do Node.js ignora essas variáveis por padrão; no Node 24+ você pode definir `NODE_USE_ENV_PROXY=1` para habilitar suporte. Para cobrir ferramentas que ignoram essas variáveis, você pode usar [proxychains](https://github.com/haad/proxychains) para interceptar chamadas de rede, ou configurar iptables para redirecionar tráfego de saída para um proxy transparente.

321 321 

322<Info>322<Info>

323 Um **proxy transparente** intercepta tráfego no nível de rede, então o cliente não precisa ser configurado para usá-lo. Proxies regulares requerem que clientes se conectem explicitamente e falem HTTP CONNECT ou SOCKS. Proxies transparentes (como Squid ou mitmproxy em modo transparente) podem lidar com conexões TCP brutas redirecionadas.323 Um **proxy transparente** intercepta tráfego no nível de rede, então o cliente não precisa ser configurado para usá-lo. Proxies regulares requerem que clientes se conectem explicitamente e falem HTTP CONNECT ou SOCKS. Proxies transparentes (como Squid ou mitmproxy em modo transparente) podem lidar com conexões TCP brutas redirecionadas.

Details

8 8 

9Agent Skills estendem Claude com capacidades especializadas que Claude invoca quando relevante. Skills são empacotadas como arquivos `SKILL.md` contendo instruções, descrições e recursos de suporte opcionais. Esta página também cobre [comandos em sessões do Agent SDK](#commands-in-agent-sdk-sessions).9Agent Skills estendem Claude com capacidades especializadas que Claude invoca quando relevante. Skills são empacotadas como arquivos `SKILL.md` contendo instruções, descrições e recursos de suporte opcionais. Esta página também cobre [comandos em sessões do Agent SDK](#commands-in-agent-sdk-sessions).

10 10 

11Para informações abrangentes sobre skills, incluindo benefícios, arquitetura e diretrizes de autoria, consulte a [visão geral de Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview).11Para mais informações sobre skills, incluindo benefícios, arquitetura e diretrizes de autoria, consulte a [visão geral de Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview).

12 12 

13<h2 id="how-skills-work-with-the-agent-sdk">13<h2 id="how-skills-work-with-the-agent-sdk">

14 Como skills funcionam com o Agent SDK14 Como skills funcionam com o Agent SDK

Details

8 8 

9Saídas estruturadas permitem que você defina a forma exata dos dados que deseja receber de um agente. O agente pode usar qualquer ferramenta necessária para completar a tarefa, e você ainda obtém JSON validado correspondente ao seu schema no final. Defina um [JSON Schema](https://json-schema.org/understanding-json-schema/about) para a estrutura que você precisa, e o SDK valida a saída contra ele, re-solicitando em caso de incompatibilidade. Se a validação não for bem-sucedida dentro do limite de tentativas, o resultado é um erro em vez de dados estruturados; veja [Tratamento de erros](#error-handling).9Saídas estruturadas permitem que você defina a forma exata dos dados que deseja receber de um agente. O agente pode usar qualquer ferramenta necessária para completar a tarefa, e você ainda obtém JSON validado correspondente ao seu schema no final. Defina um [JSON Schema](https://json-schema.org/understanding-json-schema/about) para a estrutura que você precisa, e o SDK valida a saída contra ele, re-solicitando em caso de incompatibilidade. Se a validação não for bem-sucedida dentro do limite de tentativas, o resultado é um erro em vez de dados estruturados; veja [Tratamento de erros](#error-handling).

10 10 

11Para segurança de tipo completa, use [Zod](#type-safe-schemas-with-zod-and-pydantic) (TypeScript) ou [Pydantic](#type-safe-schemas-with-zod-and-pydantic) (Python) para definir seu schema e obter objetos fortemente tipados.11Para segurança de tipo completa, use [Zod](#type-safe-schemas-with-zod-and-pydantic) (TypeScript) ou [Pydantic](#type-safe-schemas-with-zod-and-pydantic) (Python) para definir seu esquema e obter objetos fortemente tipados.

12 12 

13<h2 id="why-structured-outputs">13<h2 id="why-structured-outputs">

14 Por que saídas estruturadas?14 Por que saídas estruturadas?

Details

768 Documentação relacionada768 Documentação relacionada

769</h2>769</h2>

770 770 

771* [Subagentes Claude Code](/docs/pt/sub-agents): documentação abrangente de subagentes incluindo definições baseadas em sistema de arquivos771* [Subagentes Claude Code](/docs/pt/sub-agents): documentação de subagentes incluindo definições baseadas em sistema de arquivos

772* [Fluxos de trabalho dinâmicos](/docs/pt/workflows): orquestre muitos subagentes a partir de um script para trabalhos muito grandes para uma conversa772* [Fluxos de trabalho dinâmicos](/docs/pt/workflows): orquestre muitos subagentes a partir de um script para trabalhos muito grandes para uma conversa

773* [Visão geral do SDK](/docs/pt/agent-sdk/overview): começando com o Claude Agent SDK773* [Visão geral do SDK](/docs/pt/agent-sdk/overview): começando com o Claude Agent SDK

Details

2299 Tipos de Hook2299 Tipos de Hook

2300</h2>2300</h2>

2301 2301 

2302Para um guia abrangente sobre o uso de hooks com exemplos e padrões comuns, veja o [guia de Hooks](/docs/pt/agent-sdk/hooks).2302Para um guia sobre o uso de hooks com exemplos e padrões comuns, veja o [guia de Hooks](/docs/pt/agent-sdk/hooks).

2303 2303 

2304<h3 id="hookevent">2304<h3 id="hookevent">

2305 `HookEvent`2305 `HookEvent`


3365};3365};

3366```3366```

3367 3367 

3368Ferramenta de busca poderosa construída em ripgrep com suporte a regex.3368Ferramenta de busca construída em ripgrep com suporte a regex.

3369 3369 

3370<h3 id="taskstop">3370<h3 id="taskstop">

3371 TaskStop3371 TaskStop


5883};5883};

5884```5884```

5885 5885 

5886<h3 id="sdksessionstatechangedmessage">

5887 `SDKSessionStateChangedMessage`

5888</h3>

5889 

5890Emitido quando Claude Code relata o estado da sessão. Para receber essas mensagens, defina [`CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS=1`](/docs/pt/env-vars#variables). Claude Code pode relatar o mesmo estado mais de uma vez, então leia uma mensagem como o estado atual da sessão em vez de como uma transição.

5891 

5892O campo `state` carrega um destes valores:

5893 

5894* `running`: a sessão está trabalhando.

5895* `idle`: Claude Code está aguardando seu próximo prompt.

5896* `requires_action`: a sessão está bloqueada aguardando uma resposta a uma requisição que enviou ao seu host, como um prompt de permissão.

5897 

5898A mensagem `idle` de um turno e sua mensagem `result` podem chegar em qualquer ordem. Para alterar se `idle` aguarda trabalho em segundo plano, como um subagente em segundo plano ou uma execução de [workflow](/docs/pt/workflows), veja [`CLAUDE_CODE_BG_TASKS_REPORT_RUNNING`](/docs/pt/env-vars#variables).

5899 

5900```typescript theme={null}

5901type SDKSessionStateChangedMessage = {

5902 type: "system";

5903 subtype: "session_state_changed";

5904 state: "idle" | "running" | "requires_action";

5905 uuid: UUID;

5906 session_id: string;

5907};

5908```

5909 

5886<h3 id="sdkfilespersistedevent">5910<h3 id="sdkfilespersistedevent">

5887 `SDKFilesPersistedEvent`5911 `SDKFilesPersistedEvent`

5888</h3>5912</h3>

agent-view.md +92 −89

Details

110 110 

111Isso mostra apenas sessões iniciadas sob esse diretório. Uma sessão que [se moveu para um worktree](#how-file-edits-are-isolated) sob `~/projects/my-app/.claude/worktrees/` ainda é listada.111Isso mostra apenas sessões iniciadas sob esse diretório. Uma sessão que [se moveu para um worktree](#how-file-edits-are-isolated) sob `~/projects/my-app/.claude/worktrees/` ainda é listada.

112 112 

113Sessões interativas que você tem abertas em outros terminais não aparecem até que você as [coloque em background](#from-inside-a-session). [Subagents](/docs/pt/sub-agents) e [teammates](/docs/pt/agent-teams) que uma sessão gera não são listados como linhas separadas.113Sessões interativas que você tem abertas em outros terminais não aparecem até que você as [coloque em background](#from-inside-a-session). [Subagentes](/docs/pt/sub-agents) e [teammates](/docs/pt/agent-teams) que uma sessão gera não são listados como linhas separadas.

114 114 

115```text theme={null}115```text theme={null}

116Pinned116Pinned


124 124 

125Working125Working

126 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m126 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m

127 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m127 ✢ playtest level 3 all checkpoints cleared ×12 in 4m

128 128 

129Completed129Completed

130 ✻ title screen result: menu, options, and credits done 9m130 ✻ title screen menu, options, and credits done 9m

131 ∙ sound effects result: 14 SFX exported to assets/audio 4h131 ∙ sound effects 14 SFX exported to assets/audio 4h

132 … 6 more132 … 6 more

133```133```

134 134 


147| Failed | Vermelho | A tarefa terminou com um erro |147| Failed | Vermelho | A tarefa terminou com um erro |

148| Stopped | Cinza | Você interrompeu a sessão com `Ctrl+X` ou `claude stop`, [seu processo foi encerrado de fora do Claude Code](#the-supervisor-process), ou [terminou enquanto o serviço em background estava desligado](#sessions-show-as-failed-after-shutdown) |148| Stopped | Cinza | Você interrompeu a sessão com `Ctrl+X` ou `claude stop`, [seu processo foi encerrado de fora do Claude Code](#the-supervisor-process), ou [terminou enquanto o serviço em background estava desligado](#sessions-show-as-failed-after-shutdown) |

149 149 

150Separadamente, a forma do ícone mostra se o processo subjacente está em execução:150Separadamente, a forma do ícone tem seu próprio significado:

151 151 

152| Forma | O que significa |152| Forma | O que significa |

153| :- | :- |153| :- | :- |

154| `✻` ou `✽` animado | O processo da sessão está vivo e responde imediatamente |154| `✻` ou `✽` animado | O processo da sessão está em execução, ou a sessão precisa de sua entrada |

155| `∙` | O processo saiu. Você ainda pode espreitar a linha, e quando você responde ou anexa, Claude reinicia de onde parou |155| `∙` | O processo saiu. Você ainda pode espreitar a linha, e quando você responde ou anexa, Claude reinicia de onde parou |

156| `✢` | Uma sessão [`/loop`](/docs/pt/scheduled-tasks) dormindo entre iterações. A linha mostra sua contagem de execução e uma contagem regressiva |156| `✢` | Uma sessão [`/loop`](/docs/pt/scheduled-tasks) dormindo entre iterações. A linha mostra sua contagem de execução e uma contagem regressiva |

157 157 


173 Resumos de linha173 Resumos de linha

174</h3>174</h3>

175 175 

176O resumo de uma linha em cada linha é gerado por um [modelo Haiku-class](/docs/pt/model-config) para que a linha possa informar o que a sessão está fazendo, o que precisa ou o que produziu sem abrir o transcript. Enquanto uma sessão está ativamente funcionando, o texto da linha é atualizado no máximo uma vez a cada 15 segundos a partir da saída recente da própria sessão sem enviar uma solicitação de modelo, e o modelo escreve um resumo novo quando cada turno termina.176O resumo de uma linha em cada linha é gerado por um [modelo Haiku-class](/docs/pt/model-config) para que a linha possa informar o que a sessão está fazendo, o que precisa ou o que produziu sem abrir a transcrição. Enquanto uma sessão está ativamente funcionando, o texto da linha é atualizado no máximo uma vez a cada 15 segundos a partir da saída recente da própria sessão sem enviar uma requisição de modelo, e o modelo escreve um resumo novo quando cada turno termina.

177 177 

178Uma linha funcionando mostra o que a sessão diz que está fazendo, e uma linha bloqueada mostra a pergunta que está fazendo. Durante um turno longo, o modelo também reescreve o resumo a cada poucos minutos para que uma linha ocupada não continue mostrando um resumo desatualizado. O texto de resumo preenche a largura restante da linha; abra o [painel de espiada](#peek-and-reply) para ler uma sentença que a borda do terminal corta.178Uma linha funcionando mostra o que a sessão diz que está fazendo, e uma linha bloqueada mostra a pergunta que está fazendo. Durante um turno longo, o modelo também reescreve o resumo a cada poucos minutos para que uma linha ocupada não continue mostrando um resumo desatualizado. O texto de resumo preenche a largura restante da linha; abra o [painel de espiada](#peek-and-reply) para ler uma sentença que a borda do terminal corta.

179 179 

180Quando a lista é [agrupada por diretório](#organize-the-list), o resumo abre com o estado da sessão como uma palavra colorida, como `Needs input · double jump or wall climb?`. No agrupamento de estado padrão, o cabeçalho do grupo já nomeia o estado, então a linha mostra apenas o resumo.180Quando a lista é [agrupada por diretório](#organize-the-list), o resumo abre com o estado da sessão como uma palavra colorida, como `Needs input · double jump or wall climb?`. No agrupamento de estado padrão, o cabeçalho do grupo já nomeia o estado, então a linha mostra apenas o resumo.

181 181 

182O resumo de fim de turno e cada reescrita de meio de turno são uma solicitação curta de Haiku-class através de seu provedor normal, cobrada e tratada sob os mesmos [termos de uso de dados](/docs/pt/data-usage) que a sessão em si. As atualizações de 15 segundos entre reescritas de modelo reutilizam a saída da própria sessão e não enviam uma solicitação. Em um provedor de terceiros ou gateway sem um modelo Haiku-class configurado, a solicitação usa o modelo principal da sessão em vez disso; defina [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/pt/model-config#environment-variables) para escolher um.182O resumo de fim de turno e cada reescrita de meio de turno são uma requisição curta de Haiku-class através de seu provedor normal, cobrada e tratada sob os mesmos [termos de uso de dados](/docs/pt/data-usage) que a sessão em si. As atualizações de 15 segundos entre reescritas de modelo reutilizam a saída da própria sessão e não enviam uma requisição. Em um provedor de terceiros ou gateway sem um modelo Haiku-class configurado, a requisição usa o modelo principal da sessão em vez disso; defina [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/pt/model-config#environment-variables) para escolher um.

183 183 

184<h3 id="pull-request-status">184<h3 id="pull-request-status">

185 Status de pull request185 Status de pull request


195 195 

196* Quando Claude edita, comenta, fecha ou marca um pull request como pronto com `gh`, Claude Code vincula o pull request que a saída do próprio comando nomeia. Um comando `gh` cuja saída capturada não nomeia nenhum pull request não cria um link; `gh pr merge` é o caso comum, porque imprime seu resultado apenas para um terminal interativo.196* Quando Claude edita, comenta, fecha ou marca um pull request como pronto com `gh`, Claude Code vincula o pull request que a saída do próprio comando nomeia. Um comando `gh` cuja saída capturada não nomeia nenhum pull request não cria um link; `gh pr merge` é o caso comum, porque imprime seu resultado apenas para um terminal interativo.

197* Quando Claude verifica um pull request com `gh pr checkout` ou faz push para um branch, Claude Code procura o branch com `gh pr view` e vincula seu pull request aberto.197* Quando Claude verifica um pull request com `gh pr checkout` ou faz push para um branch, Claude Code procura o branch com `gh pr view` e vincula seu pull request aberto.

198* O pull request não precisa existir ainda quando Claude faz push: Claude Code tenta novamente a busca do branch após até cinco comandos `git`, `gh`, `glab` ou `curl` posteriores executados no mesmo diretório, então um pull request criado após o push, incluindo um que Claude cria através da API REST do GitHub, vincula quando uma tentativa o encontra.198* O pull request não precisa existir ainda quando Claude faz push: Claude Code tenta novamente a busca do branch após até cinco comandos `git`, `gh`, `glab` ou `curl` posteriores executados no mesmo diretório, então um pull request criado após o push, incluindo um que Claude cria através da API REST do GitHub, vincula quando uma nova tentativa o encontra.

199 199 

200Quando uma sessão está vinculada a mais de um pull request, o rótulo mostra uma contagem em vez disso, como `3 PRs`, colorido pelo pull request aberto que mais precisa de atenção. Abra o [painel de espiada](#peek-and-reply) para ver todos eles.200Quando uma sessão está vinculada a mais de um pull request, o rótulo mostra uma contagem em vez disso, como `3 PRs`, colorido pelo pull request aberto que mais precisa de atenção. Abra o [painel de espiada](#peek-and-reply) para ver todos eles.

201 201 


222 222 

223Quaisquer pull requests vinculados à sessão são listados em seguida. Para uma sessão que está aguardando você, uma linha como `waiting 3m` abaixo deles mostra há quanto tempo está aguardando, e é a única hora mostrada no painel. A idade na borda direita da linha é um número diferente: ela conta a partir de quando a sessão começou.223Quaisquer pull requests vinculados à sessão são listados em seguida. Para uma sessão que está aguardando você, uma linha como `waiting 3m` abaixo deles mostra há quanto tempo está aguardando, e é a única hora mostrada no painel. A idade na borda direita da linha é um número diferente: ela conta a partir de quando a sessão começou.

224 224 

225Na maioria das vezes, o painel de espiada é suficiente e você não precisa abrir o transcript completo.225Na maioria das vezes, o painel de espiada é suficiente e você não precisa abrir a transcrição completa.

226 226 

227Digite uma resposta no painel de espiada e pressione `Enter` para enviá-la para essa sessão. Prefixe uma resposta com `!` para enviar um comando Bash em vez disso. O que acontece com a resposta depende da sessão e do que você envia:227Digite uma resposta no painel de espiada e pressione `Enter` para enviá-la para essa sessão. Prefixe uma resposta com `!` para enviar um comando Bash em vez disso. O que acontece com a resposta depende da sessão e do que você envia:

228 228 


240 240 

241Uma resposta que não pode ser entregue, porque o serviço em background está inacessível ou o envio falha, é salva e enviada para a sessão como seu próximo prompt quando seu processo começar novamente, e a mensagem de erro diz que a resposta foi salva. Uma resposta prefixada com `!` não é salva, porque o texto salvo chegaria à sessão como um prompt simples em vez de executar como um comando Bash.241Uma resposta que não pode ser entregue, porque o serviço em background está inacessível ou o envio falha, é salva e enviada para a sessão como seu próximo prompt quando seu processo começar novamente, e a mensagem de erro diz que a resposta foi salva. Uma resposta prefixada com `!` não é salva, porque o texto salvo chegaria à sessão como um prompt simples em vez de executar como um comando Bash.

242 242 

243Com [voice dictation](/docs/pt/voice-dictation) ativada, segure ou toque sua tecla push-to-talk enquanto a entrada de resposta está focada para ditar uma resposta em vez de digitá-la. O mesmo funciona na entrada de despacho na parte inferior de agent view.243Com [voice dictation](/docs/pt/voice-dictation) ativada no [modo de segurar](/docs/pt/voice-dictation#hold-to-record), segure sua tecla push-to-talk enquanto a entrada de resposta está focada para ditar uma resposta em vez de digitá-la. O mesmo funciona na entrada de despacho na parte inferior de agent view.

244 244 

245Use `↑` e `↓` para espreitar sessões adjacentes sem fechar o painel, ou `→` para anexar.245Use `↑` e `↓` para espreitar sessões adjacentes sem fechar o painel, ou `→` para anexar.

246 246 


252 252 

253Enquanto anexado, a sessão se comporta como qualquer outra sessão Claude Code: [comandos](/docs/pt/commands), atalhos de teclado e recursos todos funcionam, com as exceções abaixo.253Enquanto anexado, a sessão se comporta como qualquer outra sessão Claude Code: [comandos](/docs/pt/commands), atalhos de teclado e recursos todos funcionam, com as exceções abaixo.

254 254 

255Enquanto você está anexado, `/install-github-app` e a lista de configurações [`/mcp`](/docs/pt/mcp) funcionam normalmente, já que um humano no terminal pode completar seus diálogos. Quando ninguém está anexado, esses comandos não conseguem abrir seus diálogos, então a sessão aparece sob `Needs input` em agent view com uma linha como `open this session to manage MCP servers`, e a resposta do transcript diz o mesmo. Anexe e execute o comando novamente para continuar; a linha de necessidade de entrada é limpa quando você anexa. `/mcp reconnect <server>`, `/mcp enable` e `/mcp disable` funcionam sem anexar de qualquer forma.255Enquanto você está anexado, `/install-github-app` e a lista de configurações [`/mcp`](/docs/pt/mcp) funcionam normalmente, já que um humano no terminal pode completar seus diálogos. Quando ninguém está anexado, esses comandos não conseguem abrir seus diálogos, então a sessão aparece sob `Needs input` em agent view com uma linha como `open this session to manage MCP servers`, e a resposta da transcrição diz o mesmo. Anexe e execute o comando novamente para continuar; a linha de necessidade de entrada é limpa quando você anexa. `/mcp reconnect <server>`, `/mcp enable` e `/mcp disable` funcionam sem anexar de qualquer forma.

256 256 

257Sessões anexadas sempre renderizam em [modo fullscreen](/docs/pt/fullscreen), independentemente de sua configuração `tui`, porque uma sessão em background não tem scrollback de terminal para anexar. Role com `PgUp`, `PgDn` ou a roda do mouse, e pressione `Ctrl+O` para modo de transcript. O scroll nativo do seu terminal e o modo de cópia tmux mostram apenas o viewport atual, o mesmo que quando você executa qualquer aplicativo fullscreen.257Sessões anexadas sempre renderizam em [modo fullscreen](/docs/pt/fullscreen), independentemente de sua configuração `tui`, porque uma sessão em background não tem scrollback de terminal para anexar. Role com `PgUp`, `PgDn` ou a roda do mouse, e pressione `Ctrl+O` para modo de transcrição. O scroll nativo do seu terminal e o modo de cópia tmux mostram apenas o viewport atual, o mesmo que quando você executa qualquer aplicativo fullscreen.

258 258 

259Pressione `←` em um prompt vazio, ou execute `/exit`, para desanexar e retornar a agent view, independentemente de você ter aberto a sessão a partir de agent view ou com `claude attach <id>` a partir do seu shell.259Pressione `←` em um prompt vazio, ou execute `/exit`, para desanexar e retornar a agent view, independentemente de você ter aberto a sessão a partir de agent view ou com `claude attach <id>` a partir do seu shell.

260 260 

261`←` também desanexa enquanto o [overlay `/btw`](/docs/pt/interactive-mode#side-questions-with-%2Fbtw) está aberto. Requer Claude Code v2.1.257 ou posterior. Uma pergunta lateral que ainda está respondendo continua em execução enquanto você está ausente. Na próxima vez que você anexar, o overlay reabre com ela, ou com sua resposta.261`←` também desanexa enquanto o [overlay `/btw`](/docs/pt/interactive-mode#side-questions-with-%2Fbtw) está aberto. Requer Claude Code v2.1.257 ou posterior. Uma pergunta lateral que ainda está respondendo continua em execução enquanto você está ausente. Na próxima vez que você anexar, o overlay reabre com ela, ou com sua resposta.

262 262 

263No Windows, se você pressionar `←` dentro de cerca de meio segundo de anexar, Claude Code mostra `Ambiguous ←, press again to detach`, porque naquela janela o terminal pode reentrega um pressionamento de antes de você anexar. Pressione `←` novamente para desanexar.263No Windows, se você pressionar `←` dentro de cerca de meio segundo de anexar, Claude Code mostra `Ambiguous ←, press again to detach`, porque naquela janela o terminal pode reentregar um pressionamento de antes de você anexar. Pressione `←` novamente para desanexar.

264 264 

265`Ctrl+Z` também desanexa mas volta para onde você começou em vez disso: agent view se você anexou de lá, ou seu shell se você executou `claude attach`. Use `Ctrl+Z` quando um diálogo tem foco e não está respondendo a `←`.265`Ctrl+Z` também desanexa mas volta para onde você começou em vez disso: agent view se você anexou de lá, ou seu shell se você executou `claude attach`. Use `Ctrl+Z` quando um diálogo tem foco e não está respondendo a `←`.

266 266 


290 290 

291Se uma ferramenta está em execução quando você pressiona `←`, Claude Code aguarda até cerca de dez segundos para que ela termine antes de colocar em background, e Claude continua a resposta na sessão em background. Pressione `←` novamente para colocar em background imediatamente em vez de aguardar. Quando o trabalho em andamento não pode ser transferido para a sessão em background, Claude Code mostra o diálogo `Background this session?` primeiro, o mesmo que com [`/background`](#from-inside-a-session).291Se uma ferramenta está em execução quando você pressiona `←`, Claude Code aguarda até cerca de dez segundos para que ela termine antes de colocar em background, e Claude continua a resposta na sessão em background. Pressione `←` novamente para colocar em background imediatamente em vez de aguardar. Quando o trabalho em andamento não pode ser transferido para a sessão em background, Claude Code mostra o diálogo `Background this session?` primeiro, o mesmo que com [`/background`](#from-inside-a-session).

292 292 

293O limite de dez segundos não se aplica enquanto os [subagents em primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) que Claude iniciou na conversa ainda estão em execução. Claude Code continua aguardando para que seu trabalho seja transferido, e mostra um aviso `Still backgrounding after the current tool` enquanto aguarda. Pressione `←` novamente para colocar em background sem aguardar, o que reinicia esses subagents do início. Claude Code não aguarda os subagents que um [workflow dinâmico](/docs/pt/workflows) está executando. Quando um workflow tem subagents em execução, Claude Code mostra o diálogo `Background this session?` em vez disso.293O limite de dez segundos não se aplica enquanto os [subagentes em primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) que Claude iniciou na conversa ainda estão em execução. Claude Code continua aguardando para que seu trabalho seja transferido, e mostra um aviso `Still backgrounding after the current tool` enquanto aguarda. Pressione `←` novamente para colocar em background sem aguardar, o que reinicia esses subagentes do início. Claude Code não aguarda os subagentes que um [workflow dinâmico](/docs/pt/workflows) está executando. Quando um workflow tem subagentes em execução, Claude Code mostra o diálogo `Background this session?` em vez disso.

294 294 

295Claude Code não coloca a sessão em background enquanto você tem texto não enviado na entrada do prompt, porque o texto fica na caixa de entrada do seu terminal e não se moveria para a sessão em background. Se você digitar na entrada enquanto Claude Code aguarda para colocar a sessão em background, ele cancela a alternância com `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`295Claude Code não coloca a sessão em background enquanto você tem texto não enviado na entrada do prompt, porque o texto fica na caixa de entrada do seu terminal e não se moveria para a sessão em background. Se você digitar na entrada enquanto Claude Code aguarda para colocar a sessão em background, ele cancela a alternância com `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`

296 296 

297Pressionar `←` cria a linha da sessão mesmo quando a conversa não tem mensagens ainda, então `→` ainda retorna a ela.297Pressionar `←` cria a linha da sessão mesmo quando a conversa não tem mensagens ainda, então `→` ainda retorna a ela.

298 298 

299Você pode desativar este atalho com a configuração [`leftArrowOpensAgents`](/docs/pt/settings-reference#leftarrowopensagents) em `/config`.299Você pode desativar este atalho para sessões em primeiro plano com a configuração [`leftArrowOpensAgents`](/docs/pt/settings-reference#leftarrowopensagents) em `/config`.

300 300 

301<h3 id="organize-the-list">301<h3 id="organize-the-list">

302 Organizar a lista302 Organizar a lista

303</h3>303</h3>

304 304 

305Agent view agrupa sessões para que as que precisam de entrada estejam no topo, com `Ready for review` e `Needs input` acima de `Working` e `Completed`. Esses nomes de grupo não mapeiam um-para-um para os [estados](#read-session-state) acima: uma sessão se move para `Ready for review` quando tem um pull request aberto, e `Completed` coleta sessões concluídas, falhadas e interrompidas juntas.305Agent view agrupa sessões para que as que precisam de entrada estejam no topo, com `Ready for review` e `Needs input` acima de `Working` e `Completed`. Esses nomes de grupo não mapeiam um-para-um para os [estados](#read-session-state) acima: uma sessão se move para `Ready for review` quando tem um pull request aberto que precisa de revisão ou tem verificações falhando, e `Completed` coleta sessões concluídas, falhadas e interrompidas juntas.

306 306 

307Pressione `Ctrl+S` para agrupar por diretório em vez disso. Sua escolha persiste entre execuções.307Pressione `Ctrl+S` para agrupar por diretório em vez disso. Sua escolha persiste entre execuções.

308 308 


317 317 

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

319 319 

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

321 321 

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

323 323 


326* `/resume` nomeia um id ou um termo de busca326* `/resume` nomeia um id ou um termo de busca

327* a visualização tem escopo com `--cwd`327* a visualização tem escopo com `--cwd`

328* a visualização foi iniciada com [`--safe-mode`](/docs/pt/cli-reference#cli-flags)328* a visualização foi iniciada com [`--safe-mode`](/docs/pt/cli-reference#cli-flags)

329* a visualização foi aberta com um sinalizador como `--permission-mode` ou `--settings`329* a visualização foi aberta com uma flag como `--permission-mode` ou `--settings`

330 330 

331Sessões concluídas que não cabem na tela se dobram em uma linha `… N more`. Falhas e sessões com um pull request aberto sempre permanecem visíveis. O grupo `Completed` preenche o espaço vertical deixado após os grupos ativos, e em um terminal curto o cabeçalho se compacta para uma única linha de resumo para que sessões que estão funcionando ou precisam de entrada permaneçam visíveis.331Sessões concluídas que não cabem na tela se dobram em uma linha `… N more`. O grupo `Completed` preenche o espaço vertical deixado após os grupos ativos, e em um terminal curto o cabeçalho se compacta para uma única linha de resumo para que sessões que estão funcionando ou precisam de entrada permaneçam visíveis.

332 332 

333<h3 id="filter-sessions">333<h3 id="filter-sessions">

334 Filtrar sessões334 Filtrar sessões


353 Atalhos de teclado353 Atalhos de teclado

354</h3>354</h3>

355 355 

356Pressione `?` em agent view para ver cada atalho em contexto. A tabela abaixo os resume.356Pressione `?` em agent view para ver os atalhos em contexto. A tabela abaixo os resume.

357 357 

358| Atalho | Ação |358| Atalho | Ação |

359| :- | :- |359| :- | :- |


366| `Ctrl+Enter` | Despachar e anexar imediatamente, em terminais onde o overlay `?` lista `ctrl+enter to start and open` |366| `Ctrl+Enter` | Despachar e anexar imediatamente, em terminais onde o overlay `?` lista `ctrl+enter to start and open` |

367| `→` | Anexar à sessão selecionada |367| `→` | Anexar à sessão selecionada |

368| `Alt+1`..`Alt+9` | Anexar à sessão 1–9 no diretório da sessão focada |368| `Alt+1`..`Alt+9` | Anexar à sessão 1–9 no diretório da sessão focada |

369| `Tab` | Em uma entrada vazia, procurar todos os subagents. Caso contrário, aplicar a sugestão destacada |369| `Tab` | Em uma entrada vazia, procurar todos os subagentes. Caso contrário, aplicar a sugestão destacada |

370| `Ctrl+S` | Alternar agrupamento entre estado e diretório |370| `Ctrl+S` | Alternar agrupamento entre estado e diretório |

371| `Ctrl+T` | Fixar ou desafixar a sessão selecionada |371| `Ctrl+T` | Fixar ou desafixar a sessão selecionada |

372| `Ctrl+F` | Encontrar sessões por nome, com o [filtro `n:`](#filter-sessions) |372| `Ctrl+F` | Encontrar sessões por nome, com o [filtro `n:`](#filter-sessions) |


378| `Shift+↑` / `Shift+↓` | Reordenar a sessão selecionada |378| `Shift+↑` / `Shift+↓` | Reordenar a sessão selecionada |

379| `Esc` | Fechar o painel de espiada, limpar a entrada ou sair. Quando você abriu agent view colocando sua sessão em background com `←`, o `Esc` final retorna àquela conversa em vez de sair. Com [vim editor mode](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `Esc` na entrada alterna de modo INSERT para modo NORMAL e mantém seu texto, como no prompt principal |379| `Esc` | Fechar o painel de espiada, limpar a entrada ou sair. Quando você abriu agent view colocando sua sessão em background com `←`, o `Esc` final retorna àquela conversa em vez de sair. Com [vim editor mode](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `Esc` na entrada alterna de modo INSERT para modo NORMAL e mantém seu texto, como no prompt principal |

380| `Ctrl+C` | Limpar a entrada; pressione duas vezes para sair |380| `Ctrl+C` | Limpar a entrada; pressione duas vezes para sair |

381| `?` | Mostrar todos os atalhos |381| `?` | Mostrar atalhos |

382 382 

383Os atalhos que têm uma ação no [contexto `Agents`](/docs/pt/keybindings#agents-actions) seguem seu [`keybindings.json`](/docs/pt/keybindings). O mesmo vale para `Ctrl+G`, através da vinculação `chat:externalEditor` do contexto `Chat`.383Os atalhos que têm uma ação no [contexto `Agents`](/docs/pt/keybindings#agents-actions) seguem seu [`keybindings.json`](/docs/pt/keybindings). O mesmo vale para `Ctrl+G`, através da vinculação `chat:externalEditor` do contexto `Chat`.

384 384 


482* Quando você iniciou a sessão dentro de um worktree vinculado de um repositório que tem uma árvore de trabalho principal, a cópia começa nessa árvore de trabalho principal, com a mesma regra de worktree próprio, mas sem instrução de branch. A confirmação termina com `runs in the origin tree` aqui também.482* Quando você iniciou a sessão dentro de um worktree vinculado de um repositório que tem uma árvore de trabalho principal, a cópia começa nessa árvore de trabalho principal, com a mesma regra de worktree próprio, mas sem instrução de branch. A confirmação termina com `runs in the origin tree` aqui também.

483* Uma sessão iniciada dentro de um worktree de um layout de repositório bare não tem árvore de trabalho principal para retornar, portanto a cópia permanece onde está, e a confirmação termina com `edits this checkout`. A mesma nota aparece quando o isolamento de worktree está [desativado](#how-file-edits-are-isolated) em uma sessão que não está dentro de um worktree vinculado, porque a cópia então edita os arquivos que você tem abertos.483* Uma sessão iniciada dentro de um worktree de um layout de repositório bare não tem árvore de trabalho principal para retornar, portanto a cópia permanece onde está, e a confirmação termina com `edits this checkout`. A mesma nota aparece quando o isolamento de worktree está [desativado](#how-file-edits-are-isolated) em uma sessão que não está dentro de um worktree vinculado, porque a cópia então edita os arquivos que você tem abertos.

484 484 

485Sessões iniciadas com sinalizadores de inicialização que a cópia não herdaria, como um prompt de sistema substituído ou uma lista de permissões `--tools`, não podem ser bifurcadas; Claude Code diz isso em vez de fazer uma cópia parcial. Uma sessão despachada a partir da visualização de agentes é bifurcada normalmente: a cópia é iniciada com a mesma [definição de agente](/docs/pt/sub-agents) e instruções anexadas que a sessão da qual veio.485Sessões iniciadas com flags de inicialização que a cópia não herdaria, como um system prompt substituído ou uma allowlist `--tools`, não podem ser bifurcadas; Claude Code diz isso em vez de fazer uma cópia parcial. Uma sessão despachada a partir da visualização de agentes é bifurcada normalmente: a cópia é iniciada com a mesma [definição de agente](/docs/pt/sub-agents) e instruções anexadas que a sessão da qual veio.

486 486 

487<h4 id="what-carries-over-when-you-background">487<h4 id="what-carries-over-when-you-background">

488 O que é transferido quando você coloca em segundo plano488 O que é transferido quando você coloca em segundo plano


496 496 

497Uma vez em segundo plano, a sessão pode iniciar novos subagentes, monitores e comandos em segundo plano, e esses continuam em execução em desanexações e reanexações posteriores.497Uma vez em segundo plano, a sessão pode iniciar novos subagentes, monitores e comandos em segundo plano, e esses continuam em execução em desanexações e reanexações posteriores.

498 498 

499Os sinalizadores de configuração do lançamento original são transferidos para a sessão em segundo plano, portanto seus servidores MCP, configurações e modelo de fallback permanecem em vigor:499As flags de configuração do lançamento original são transferidas para a sessão em segundo plano, portanto seus servidores MCP, configurações e modelo de fallback permanecem em vigor:

500 500 

501* `--mcp-config` e `--strict-mcp-config`501* `--mcp-config` e `--strict-mcp-config`

502* `--settings`502* `--settings`


506* `--fallback-model`506* `--fallback-model`

507* `--allow-dangerously-skip-permissions`507* `--allow-dangerously-skip-permissions`

508 508 

509Os diretórios que você adicionou durante a sessão com [`/add-dir`](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) também são transferidos. Transferir `--allow-dangerously-skip-permissions` mantém `bypassPermissions` acessível na sessão em segundo plano, mas não concede nada novo: o modo ainda requer a aceitação interativa única descrita em [Permission mode, model, and effort](#permission-mode-model-and-effort).509Os diretórios que você adicionou durante a sessão com [`/add-dir`](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) também são transferidos. Transferir `--allow-dangerously-skip-permissions` mantém `bypassPermissions` acessível na sessão em segundo plano, mas não concede nada novo: o modo ainda requer a aceitação interativa única descrita em [Modo de permissão, modelo e esforço](#permission-mode-model-and-effort).

510 510 

511<h3 id="from-your-shell">511<h3 id="from-your-shell">

512 Do seu shell512 Do seu shell


530 530 

531Se o nome não corresponder a nenhum de seus subagentes, o lançamento falha: Claude Code imprime um aviso `no agent named` e ainda relata a sessão como em segundo plano, mas a sessão sai imediatamente com um erro `--agent '<name>' not found`.531Se o nome não corresponder a nenhum de seus subagentes, o lançamento falha: Claude Code imprime um aviso `no agent named` e ainda relata a sessão como em segundo plano, mas a sessão sai imediatamente com um erro `--agent '<name>' not found`.

532 532 

533Quando a sessão em segundo plano mais tarde retoma ou reinicia, Claude Code restaura o agente e suas restrições de ferramentas; para seu prompt de sistema, veja [System prompt flags in resumed conversations](/docs/pt/cli-reference#system-prompt-flags-in-resumed-conversations). Ele procura o agente no diretório da própria sessão primeiro, desde que você tenha [confiado nesse workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust), portanto um agente com escopo de projeto ainda é carregado quando a sessão é retomada de outro diretório. Se o agente não existir mais, a sessão continua com as ferramentas padrão e sua transcrição abre com um [aviso nomeando o agente](/docs/pt/errors#session-agent-no-longer-available).533Quando a sessão em segundo plano mais tarde retoma ou reinicia, Claude Code restaura o agente e suas restrições de ferramentas; para seu system prompt, veja [Flags de system prompt em conversas retomadas](/docs/pt/cli-reference#system-prompt-flags-in-resumed-conversations). Ele procura o agente no diretório da própria sessão primeiro, desde que você tenha [confiado nesse workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust), portanto um agente com escopo de projeto ainda é carregado quando a sessão é retomada de outro diretório. Se o agente não existir mais, a sessão continua com as ferramentas padrão e sua transcrição abre com um [aviso nomeando o agente](/docs/pt/errors#session-agent-no-longer-available).

534 534 

535Para continuar uma conversa existente em segundo plano, passe seu ID de sessão completo com `--resume`:535Para continuar uma conversa existente em segundo plano, passe seu ID de sessão completo com `--resume`:

536 536 


602 602 

603Quando o hook falha em um diretório que não é um repositório git, Claude pula o isolamento para esse diretório e edita o diretório de trabalho no local. Dentro de um repositório git, uma sessão que Claude move para um worktree antes de editar não pode editar arquivos no checkout compartilhado até que essa mudança aconteça.603Quando o hook falha em um diretório que não é um repositório git, Claude pula o isolamento para esse diretório e edita o diretório de trabalho no local. Dentro de um repositório git, uma sessão que Claude move para um worktree antes de editar não pode editar arquivos no checkout compartilhado até que essa mudança aconteça.

604 604 

605Para encontrar o caminho do worktree de uma sessão, espreite a sessão ou anexe e verifique seu diretório de trabalho.605Para encontrar o caminho do worktree de uma sessão, anexe e verifique seu diretório de trabalho.

606 606 

607Um [subagente](/docs/pt/sub-agents) que a sessão em segundo plano gera herda o diretório de trabalho da sessão. Uma vez que a sessão está em um worktree, os edits de arquivo do subagente acabam nesse worktree em vez de em sua cópia de trabalho. Para dar a um subagente seu próprio worktree separado em vez disso, defina [`isolation: worktree`](/docs/pt/sub-agents#supported-frontmatter-fields) em seu frontmatter ou passe `isolation: "worktree"` ao gerá-lo.607Um [subagente](/docs/pt/sub-agents) que a sessão em segundo plano gera herda o diretório de trabalho da sessão. Uma vez que a sessão está em um worktree, os edits de arquivo do subagente acabam nesse worktree em vez de em sua cópia de trabalho. Para dar a um subagente seu próprio worktree separado em vez disso, defina [`isolation: worktree`](/docs/pt/sub-agents#supported-frontmatter-fields) em seu frontmatter ou passe `isolation: "worktree"` ao gerá-lo.

608 608 


611* **Commit e push**: Claude faz commit sem perguntar, e faz push do branch quando o repositório tem um remote.611* **Commit e push**: Claude faz commit sem perguntar, e faz push do branch quando o repositório tem um remote.

612* **Draft pull request**: Claude abre um quando a tarefa pede, e o rótulo [`#N`](#pull-request-status) aparece na linha.612* **Draft pull request**: Claude abre um quando a tarefa pede, e o rótulo [`#N`](#pull-request-status) aparece na linha.

613* **Nunca**: fazer push para `main` ou `master`, force-push e merge.613* **Nunca**: fazer push para `main` ou `master`, force-push e merge.

614* **Suas instruções git têm precedência**: se a tarefa, `CLAUDE.md` ou [memory](/docs/pt/memory) diz que você lida com commit ou push você mesmo, Claude deixa git para você.614* **Suas instruções git têm precedência**: se a tarefa, `CLAUDE.md` ou a [memória](/docs/pt/memory) diz que você lida com commit ou push você mesmo, Claude deixa git para você.

615 615 

616Uma sessão editando um checkout que não isolou a si mesma ainda pergunta antes de fazer commit ou mudar de branch. Isso se aplica quando o isolamento está definido como `"none"`, quando a mudança de worktree falhou, ou quando a sessão começou dentro de um worktree que já existia.616Uma sessão editando um checkout que não isolou a si mesma ainda pergunta antes de fazer commit ou mudar de branch. Isso se aplica quando o isolamento está definido como `"none"`, quando a mudança de worktree falhou, ou quando a sessão começou dentro de um worktree que já existia.

617 617 


670 670 

671O nome do modelo mostrado no cabeçalho da visualização de agentes é o padrão de despacho. Novas sessões que você inicia a partir da entrada usam este modelo, que vem da [configuração `model`](/docs/pt/settings-reference#model) em suas configurações de usuário. Defina-o selecionando um modelo no [seletor `/model`](/docs/pt/model-config), ou edite a configuração diretamente.671O nome do modelo mostrado no cabeçalho da visualização de agentes é o padrão de despacho. Novas sessões que você inicia a partir da entrada usam este modelo, que vem da [configuração `model`](/docs/pt/settings-reference#model) em suas configurações de usuário. Defina-o selecionando um modelo no [seletor `/model`](/docs/pt/model-config), ou edite a configuração diretamente.

672 672 

673Para substituir o padrão de despacho para toda a sessão de visualização de agentes, passe `--model` ao abrir a visualização de agentes. Veja [Permission mode, model, and effort](#permission-mode-model-and-effort).673Para sobrescrever o padrão de despacho para toda a sessão de visualização de agentes, passe `--model` ao abrir a visualização de agentes. Veja [Modo de permissão, modelo e esforço](#permission-mode-model-and-effort).

674 674 

675Para alterar o padrão de despacho de dentro da visualização de agentes, digite `/model` seguido de um nome de modelo na entrada de despacho e pressione `Enter`. O cabeçalho é atualizado para mostrar esse modelo com um marcador `(session)`, e as sessões que você despacha depois usam-no. Digite `/model default` para limpar a substituição e retornar ao padrão de despacho. Essa substituição dura o resto da execução atual de `claude agents` e não escreve em seu arquivo de configurações. O exemplo a seguir despacha uma sessão em Opus e a próxima em Sonnet:675Para alterar o padrão de despacho de dentro da visualização de agentes, digite `/model` seguido de um nome de modelo na entrada de despacho e pressione `Enter`. O cabeçalho é atualizado para mostrar esse modelo com um marcador `(session)`, e as sessões que você despacha depois usam-no. Digite `/model default` para limpar a substituição e retornar ao padrão de despacho. Essa substituição dura o resto da execução atual de `claude agents` e não escreve em seu arquivo de configurações. O exemplo a seguir despacha uma sessão em Opus e a próxima em Sonnet:

676 676 


681run the test suite681run the test suite

682```682```

683 683 

684Cada sessão em segundo plano pode ser executada em um modelo diferente. Para substituir para uma sessão:684Cada sessão em segundo plano pode ser executada em um modelo diferente. Para sobrescrevê-lo para uma sessão:

685 685 

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

687* Anexe a uma sessão em execução e execute `/model` para mudar: uma escolha do seletor, ou um `/model <name>` digitado, salva como seu padrão para novas sessões a menos que você pressione `s` no seletor para uma mudança apenas de sessão. Uma mudança apenas de sessão persiste se a sessão for respawnada.687* Anexe a uma sessão em execução e execute `/model` para mudar: uma escolha do seletor, ou um `/model <name>` digitado, salva como seu padrão para novas sessões a menos que você pressione `s` no seletor para uma mudança apenas de sessão. Uma mudança apenas de sessão persiste se a sessão for respawnada.

688* Despache um [subagente](/docs/pt/sub-agents) cujo frontmatter define um campo `model`.688* Despache um [subagente](/docs/pt/sub-agents) cujo frontmatter define um campo `model`.

689 689 

690<h3 id="permission-mode-model-and-effort">690<h3 id="permission-mode-model-and-effort">

691 Permission mode, model, and effort691 Modo de permissão, modelo e esforço

692</h3>692</h3>

693 693 

694Uma sessão em segundo plano toma suas configurações, provedor, modo de permissão, modelo e esforço de onde e como você a despachou. As subseções abaixo cobrem cada fonte, e o que persiste quando o supervisor reinicia a sessão.694Uma sessão em segundo plano toma suas configurações, provedor, modo de permissão, modelo e esforço de onde e como você a despachou. As subseções abaixo cobrem cada fonte, e o que persiste quando o supervisor reinicia a sessão.


697 Configurações e provedor697 Configurações e provedor

698</h4>698</h4>

699 699 

700Uma sessão em segundo plano lê suas [configurações](/docs/pt/settings) do diretório em que é executada, da mesma forma que se você tivesse iniciado `claude` lá com os [sinalizadores de configuração que ela carregou](#what-carries-over-when-you-background). Isso inclui [valores `env`](/docs/pt/settings-reference#env) em configurações de projeto, portanto um `ANTHROPIC_MODEL` ou variável de provedor definida lá se aplica a toda sessão em segundo plano nesse diretório.700Uma sessão em segundo plano lê suas [configurações](/docs/pt/settings) do diretório em que é executada, da mesma forma que se você tivesse iniciado `claude` lá com as [flags de configuração que ela carregou](#what-carries-over-when-you-background). Isso inclui [valores `env`](/docs/pt/settings-reference#env) em configurações de projeto, portanto um `ANTHROPIC_MODEL` ou variável de provedor definida lá se aplica a toda sessão em segundo plano nesse diretório.

701 701 

702Uma sessão em segundo plano também é executada com o `PATH` do shell do qual você a despachou, portanto os comandos que ela executa encontram as mesmas ferramentas que seu terminal faz. Ela mantém a seleção de provedor de nuvem desse shell também, como `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, junto com seus aliases `ANTHROPIC_DEFAULT_*_MODEL` e qualquer substituição [`CLAUDE_CODE_EXTRA_BODY`](/docs/pt/env-vars) que você exportou lá.702Uma sessão em segundo plano também é executada com o `PATH` do shell do qual você a despachou, portanto os comandos que ela executa encontram as mesmas ferramentas que seu terminal faz. Ela mantém a seleção de provedor de nuvem desse shell também, como `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, junto com seus aliases `ANTHROPIC_DEFAULT_*_MODEL` e qualquer substituição [`CLAUDE_CODE_EXTRA_BODY`](/docs/pt/env-vars) que você exportou lá.

703 703 

704<h4 id="llm-gateway">704<h4 id="llm-gateway">

705 Gateway LLM705 Gateway de LLM

706</h4>706</h4>

707 707 

708Se você rotear Claude Code através de um [gateway LLM](/docs/pt/llm-gateway), coloque as variáveis de gateway em um bloco `env` de um arquivo de configurações em vez de exportá-las em seu shell, e as sessões em segundo plano as leem com o resto de suas configurações. [Set in a settings file](/docs/pt/llm-gateway-connect#set-in-a-settings-file) mostra o bloco e qual arquivo de configurações usar para a credencial.708Se você rotear Claude Code através de um [gateway de LLM](/docs/pt/llm-gateway), coloque as variáveis de gateway em um bloco `env` de um arquivo de configurações em vez de exportá-las em seu shell, e as sessões em segundo plano as leem com o resto de suas configurações. [Definir em um arquivo de configurações](/docs/pt/llm-gateway-connect#set-in-a-settings-file) mostra o bloco e qual arquivo de configurações usar para a credencial.

709 709 

710Se você exportar um gateway `ANTHROPIC_BASE_URL` apenas em seu shell em vez disso, ele alcança uma sessão em segundo plano, junto com o `ANTHROPIC_CUSTOM_HEADERS` e credencial que você exportou com ele, apenas quando o [supervisor](#the-supervisor-process) foi ele próprio iniciado a partir de um shell que exportou o mesmo gateway, e apenas nestes casos:710Se você exportar um gateway `ANTHROPIC_BASE_URL` apenas em seu shell em vez disso, ele alcança uma sessão em segundo plano, junto com o `ANTHROPIC_CUSTOM_HEADERS` e credencial que você exportou com ele, apenas quando o [supervisor](#the-supervisor-process) foi ele próprio iniciado a partir de um shell que exportou o mesmo gateway, e apenas nestes casos:

711 711 


713* Você despacha uma sessão para o diretório em que está713* Você despacha uma sessão para o diretório em que está

714* Você acorda uma sessão parada no diretório em que está anexando ou respondendo a ela714* Você acorda uma sessão parada no diretório em que está anexando ou respondendo a ela

715 715 

716Claude Code encaminha um gateway na frente de um provedor de nuvem. Se o shell do qual você despacha seleciona o provedor e exporta seu endpoint de gateway com seu sinalizador de bypass de auth, Claude Code encaminha o par endpoint-e-sinalizador para a sessão sob as condições que se aplicam a `ANTHROPIC_BASE_URL`, junto com `ANTHROPIC_CUSTOM_HEADERS`. Por exemplo, exporte `CLAUDE_CODE_USE_VERTEX=1` com `ANTHROPIC_VERTEX_BASE_URL` e `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, e Claude Code encaminha esse endpoint e sinalizador.716Claude Code encaminha um gateway na frente de um provedor de nuvem. Se o shell do qual você despacha seleciona o provedor e exporta seu endpoint de gateway com sua flag de bypass de auth, Claude Code encaminha o par endpoint-e-flag para a sessão sob as condições que se aplicam a `ANTHROPIC_BASE_URL`, junto com `ANTHROPIC_CUSTOM_HEADERS`. Por exemplo, exporte `CLAUDE_CODE_USE_VERTEX=1` com `ANTHROPIC_VERTEX_BASE_URL` e `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, e Claude Code encaminha esse endpoint e flag.

717 717 

718Claude Code aplica um gateway encaminhado apenas ao processo em execução dessa sessão e nunca o escreve em disco.718Claude Code aplica um gateway encaminhado apenas ao processo em execução dessa sessão e nunca o escreve em disco.

719 719 


725 725 

726* **Colocada em segundo plano com `/bg` ou `←`**: Claude Code mantém o modo de permissão em que a sessão estava, portanto um que você mudou para `acceptEdits` ou `auto` permanece lá após desanexar726* **Colocada em segundo plano com `/bg` ou `←`**: Claude Code mantém o modo de permissão em que a sessão estava, portanto um que você mudou para `acceptEdits` ou `auto` permanece lá após desanexar

727* **Despachada a partir de uma visualização de agentes que você abriu com `←`**: a configuração própria do alvo vem primeiro, e o modo de permissão da sessão da qual você veio se aplica quando nada mais define um727* **Despachada a partir de uma visualização de agentes que você abriu com `←`**: a configuração própria do alvo vem primeiro, e o modo de permissão da sessão da qual você veio se aplica quando nada mais define um

728* **Despachada de `claude agents` iniciado em um shell, ou com `claude --bg`**: a nova sessão começa da forma que uma nova sessão `claude` nesse diretório começaria, a menos que você a tenha despachado a partir de uma visualização de agentes que você abriu com [padrões de despacho](#dispatch-defaults). [Which permission mode a session starts in](/docs/pt/permission-modes#which-mode-a-session-starts-in) lista a ordem728* **Despachada de `claude agents` iniciado em um shell, ou com `claude --bg`**: a nova sessão começa da forma que uma nova sessão `claude` nesse diretório começaria, a menos que você a tenha despachado a partir de uma visualização de agentes que você abriu com [padrões de despacho](#dispatch-defaults). [Em qual modo de permissão uma sessão começa](/docs/pt/permission-modes#which-mode-a-session-starts-in) lista a ordem

729 729 

730Para uma sessão que você despacha a partir de uma visualização de agentes aberta com `←`, Claude Code toma o modo de permissão do primeiro destes que se aplica:730Para uma sessão que você despacha a partir de uma visualização de agentes aberta com `←`, Claude Code toma o modo de permissão do primeiro destes que se aplica:

731 731 


734 * Claude Code recusa um `defaultMode` do `.claude/settings.json` ou `.claude/settings.local.json` do projeto que seleciona um modo mais permissivo do que a sessão da qual você veio estava.734 * Claude Code recusa um `defaultMode` do `.claude/settings.json` ou `.claude/settings.local.json` do projeto que seleciona um modo mais permissivo do que a sessão da qual você veio estava.

7352. O modo de permissão da sessão da qual você veio7352. O modo de permissão da sessão da qual você veio

736 736 

737Quando Claude Code recusa o modo de uma fonte como muito permissivo, a próxima fonte na lista decide. Por exemplo, se você despacha a partir de uma sessão em modo de plano para um diretório cujas configurações verificadas pedem `acceptEdits`, a nova sessão começa em modo de plano. Se você mover esse `defaultMode` para `~/.claude/settings.json`, ele se aplica independentemente do modo de permissão da sessão da qual você veio.737Quando Claude Code recusa o modo de uma fonte como muito permissivo, a próxima fonte na lista decide. Por exemplo, se você despacha a partir de uma sessão em modo de planejamento para um diretório cujas configurações verificadas pedem `acceptEdits`, a nova sessão começa em modo de planejamento. Se você mover esse `defaultMode` para `~/.claude/settings.json`, ele se aplica independentemente do modo de permissão da sessão da qual você veio.

738 738 

739A permissividade corre plano, depois Manual e `dontAsk`, depois `acceptEdits` e auto, que cada um conta como mais permissivo do que o outro, depois `bypassPermissions`.739A permissividade segue a ordem: planejamento, depois Manual e `dontAsk`, depois `acceptEdits` e auto, cada um dos quais conta como mais permissivo do que o outro, depois `bypassPermissions`.

740 740 

741<h4 id="dispatch-defaults">741<h4 id="dispatch-defaults">

742 Padrões de despacho742 Padrões de despacho


748claude agents --permission-mode plan --model opus --effort high748claude agents --permission-mode plan --model opus --effort high

749```749```

750 750 

751`--effort` aqui aceita os mesmos valores que o [sinalizador `--effort` de nível superior](/docs/pt/cli-reference#cli-flags), incluindo `ultracode`.751`--effort` aqui aceita os mesmos valores que a [flag `--effort` de nível superior](/docs/pt/cli-reference#cli-flags), incluindo `ultracode`.

752 752 

753`--agent` define o [subagente](/docs/pt/sub-agents) usado quando um prompt de despacho não nomeia um, seja com `@name` ou como a primeira palavra. Ele padrão para a [configuração `agent`](/docs/pt/settings-reference#agent) se uma estiver definida, caso contrário o agente `claude` catch-all built-in. Nomear um subagente na entrada de despacho substitui ambos.753`--agent` define o [subagente](/docs/pt/sub-agents) usado quando um prompt de despacho não nomeia um, seja com `@name` ou como a primeira palavra. Seu padrão é a [configuração `agent`](/docs/pt/settings-reference#agent) se uma estiver definida, caso contrário o agente `claude` catch-all built-in. Nomear um subagente na entrada de despacho sobrescreve ambos.

754 754 

755`claude agents` também aceita `--dangerously-skip-permissions` como abreviação para `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` para tornar `bypassPermissions` disponível no ciclo `Shift+Tab` de cada sessão despachada sem começar nesse modo. Ambos correspondem aos [sinalizadores CLI de nível superior](/docs/pt/cli-reference).755`claude agents` também aceita `--dangerously-skip-permissions` como abreviação para `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` para tornar `bypassPermissions` disponível no ciclo `Shift+Tab` de cada sessão despachada sem começar nesse modo. Ambas correspondem às [flags CLI de nível superior](/docs/pt/cli-reference).

756 756 

757Passe `--restricted` para iniciar toda sessão que você despacha a partir da visualização em [modo restrito](/docs/pt/cli-reference#cli-flags), como se cada uma fosse iniciada com o sinalizador de nível superior `--restricted`. Requer Claude Code v2.1.248 ou posterior.757Passe `--restricted` para iniciar toda sessão que você despacha a partir da visualização em [modo restrito](/docs/pt/cli-reference#cli-flags), como se cada uma fosse iniciada com a flag de nível superior `--restricted`. Requer Claude Code v2.1.248 ou posterior.

758 758 

759Os padrões ativos aparecem no rodapé abaixo da entrada de despacho.759Os padrões ativos aparecem no rodapé abaixo da entrada de despacho.

760 760 


764 O que persiste entre reinicializações764 O que persiste entre reinicializações

765</h4>765</h4>

766 766 

767O modo de permissão, modelo e esforço que você escolheu para uma sessão em segundo plano, junto com os [sinalizadores de configuração que ela carregou](#what-carries-over-when-you-background), tudo persiste quando o supervisor mais tarde [para e reinicia](#the-supervisor-process) seu processo. Uma sessão que você iniciou com `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` permanece em `bypassPermissions` após essa reinicialização. Um modelo ou esforço que você mudou no meio da sessão com `/model` ou `/effort` também é mantido.767O modo de permissão, modelo e esforço que você escolheu para uma sessão em segundo plano, junto com as [flags de configuração que ela carrega](#what-carries-over-when-you-background), tudo persiste quando o supervisor mais tarde [para e reinicia](#the-supervisor-process) seu processo. Uma sessão que você iniciou com `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` permanece em `bypassPermissions` após essa reinicialização. Um modelo ou esforço que você mudou no meio da sessão com `/model` ou `/effort` também é mantido.

768 768 

769Se a sessão tomou seu esforço de suas configurações em vez de `--effort` ou `/effort`, Claude Code lê suas configurações novamente cada vez que inicia um processo para a sessão. Depois que você edita o esforço salvo em `settings.json`, a mudança alcança sessões que você coloca em segundo plano com `←` ou `/bg`, e suas reinicializações posteriores. O esforço salvo é a chave [`effortLevel`](/docs/pt/settings-reference#effortlevel) ou uma entrada [`modelSettings`](/docs/pt/settings-reference#modelsettings).769Se a sessão tomou seu esforço de suas configurações em vez de `--effort` ou `/effort`, Claude Code lê suas configurações novamente cada vez que inicia um processo para a sessão. Depois que você edita o esforço salvo em `settings.json`, a mudança alcança sessões que você coloca em segundo plano com `←` ou `/bg`, e suas reinicializações posteriores. O esforço salvo é a chave [`effortLevel`](/docs/pt/settings-reference#effortlevel) ou uma entrada [`modelSettings`](/docs/pt/settings-reference#modelsettings).

770 770 

771Claude Code também mantém um nome que você definiu com [`/rename`](/docs/pt/commands) ou `Ctrl+R` entre essa reinicialização, portanto você ainda pode executar [`claude --resume <name>`](/docs/pt/sessions#name-your-sessions) para alcançar a sessão.771Claude Code também mantém um nome que você definiu com [`/rename`](/docs/pt/commands) ou `Ctrl+R` entre essa reinicialização, portanto você ainda pode executar [`claude --resume <name>`](/docs/pt/sessions#name-your-sessions) para alcançar a sessão.

772 772 

773Um prompt que você guardou com [`Ctrl+S`](/docs/pt/interactive-mode#general-controls) enquanto anexado é mantido com a sessão também. Reabra a sessão após seu processo ter sido parado ou reiniciado, e `Ctrl+S` restaura o texto guardado. O conteúdo colado no guarda-roupa não sobrevive à reinicialização.773Um prompt que você guardou com [`Ctrl+S`](/docs/pt/interactive-mode#general-controls) enquanto anexado é mantido com a sessão também. Reabra a sessão após seu processo ter sido parado ou reiniciado, e pressione `Ctrl+S` para restaurar o texto guardado. O conteúdo colado no stash não sobrevive à reinicialização.

774 774 

775<h3 id="settings-plugins-and-mcp-servers">775<h3 id="settings-plugins-and-mcp-servers">

776 Configurações, plugins e servidores MCP776 Configurações, plugins e servidores MCP

777</h3>777</h3>

778 778 

779A visualização de agentes aceita os mesmos sinalizadores de configuração que `claude` para carregar configurações, plugins, servidores MCP e diretórios adicionais. A visualização de agentes aplica `--settings`, `--setting-sources` e `--plugin-dir` a si mesma e passa cada sinalizador de configuração para as sessões que você despacha a partir dela, portanto um plugin ou servidor MCP que você carrega dessa forma está disponível nessas sessões.779A visualização de agentes aceita as mesmas flags de configuração que `claude` para carregar configurações, plugins, servidores MCP e diretórios adicionais. A visualização de agentes aplica `--settings`, `--setting-sources` e `--plugin-dir` a si mesma e passa cada flag de configuração para as sessões que você despacha a partir dela, portanto um plugin ou servidor MCP que você carrega dessa forma está disponível nessas sessões.

780 780 

781| Sinalizador | Efeito |781| Flag | Efeito |

782| :- | :- |782| :- | :- |

783| [`--settings <file-or-json>`](/docs/pt/settings) | Substituir configurações para visualização de agentes e sessões despachadas |783| [`--settings <file-or-json>`](/docs/pt/settings) | Sobrescrever configurações para visualização de agentes e sessões despachadas |

784| [`--setting-sources <sources>`](/docs/pt/cli-reference#cli-flags) | Carregar apenas as fontes de configurações nomeadas, na visualização de agentes e sessões despachadas |784| [`--setting-sources <sources>`](/docs/pt/cli-reference#cli-flags) | Carregar apenas as fontes de configurações nomeadas, na visualização de agentes e sessões despachadas |

785| [`--add-dir <path>`](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) | Conceder acesso a arquivo para um diretório adicional |785| [`--add-dir <path>`](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) | Conceder acesso a arquivo para um diretório adicional |

786| [`--plugin-dir <path>`](/docs/pt/plugins/create#load-a-directory-or-archive-for-one-session) | Carregar um plugin de um diretório local |786| [`--plugin-dir <path>`](/docs/pt/plugins/create#load-a-directory-or-archive-for-one-session) | Carregar um plugin de um diretório local |

787| [`--mcp-config <file-or-json>`](/docs/pt/mcp) | Carregar servidores MCP de um arquivo de configuração ou string JSON |787| [`--mcp-config <file-or-json>`](/docs/pt/mcp) | Carregar servidores MCP de um arquivo de configuração ou string JSON |

788| `--strict-mcp-config` | Use apenas os servidores MCP de `--mcp-config`, ignorando outra configuração MCP. Veja [Exclusive control with managed-mcp.json](/docs/pt/managed-mcp#exclusive-control-with-managed-mcp-json) para o que o sinalizador faz sob um arquivo MCP gerenciado |788| `--strict-mcp-config` | Use apenas os servidores MCP de `--mcp-config`, ignorando outra configuração MCP. Veja [Controle exclusivo com managed-mcp.json](/docs/pt/managed-mcp#exclusive-control-with-managed-mcp-json) para o que a flag faz sob um arquivo MCP gerenciado |

789 789 

790Repita `--add-dir`, `--plugin-dir` ou `--mcp-config` uma vez por valor. `claude agents` não suporta a forma separada por espaço, como `--add-dir a b c`.790Repita `--add-dir`, `--plugin-dir` ou `--mcp-config` uma vez por valor. `claude agents` não suporta a forma separada por espaço, como `--add-dir a b c`.

791 791 


810| `claude agents` | Abrir agent view |810| `claude agents` | Abrir agent view |

811| `claude agents --cwd <path>` | Abrir agent view com escopo para sessões iniciadas em `<path>` |811| `claude agents --cwd <path>` | Abrir agent view com escopo para sessões iniciadas em `<path>` |

812| `claude agents --json` | Imprimir sessões como um array JSON e sair. Veja [Listar sessões como JSON](#list-sessions-as-json) |812| `claude agents --json` | Imprimir sessões como um array JSON e sair. Veja [Listar sessões como JSON](#list-sessions-as-json) |

813| `claude attach <id>` | Anexar a uma sessão neste terminal |813| `claude attach <id\|name>` | Anexar a uma sessão neste terminal |

814| `claude logs <id>` | Imprimir a saída recente da sessão |814| `claude logs <id\|name>` | Imprimir a saída recente da sessão |

815| `claude stop <id>` | Interromper uma sessão. Também aceita `claude kill` |815| `claude stop <id>` | Interromper uma sessão. Também aceita `claude kill` |

816| `claude respawn <id>` | Reiniciar uma sessão, em execução ou interrompida, por exemplo, para usar um binário Claude Code atualizado. A sessão reiniciada retoma sua conversa salva; quando nenhuma está no disco, ela executa seu prompt original novamente como uma nova conversa |816| `claude respawn <id>` | Reiniciar uma sessão, em execução ou interrompida, por exemplo, para usar um binário Claude Code atualizado. A sessão reiniciada retoma sua conversa salva; quando nenhuma está no disco, ela executa seu prompt original novamente como uma nova conversa |

817| `claude respawn --all` | Reiniciar cada sessão em execução, por exemplo, para mover todas as sessões para um binário Claude Code atualizado de uma vez |817| `claude respawn --all` | Reiniciar cada sessão em execução, por exemplo, para mover todas as sessões para um binário Claude Code atualizado de uma vez |


821| `claude daemon status` | Imprimir o estado do [supervisor](#the-supervisor-process), versão, diretório de socket e contagem de workers |821| `claude daemon status` | Imprimir o estado do [supervisor](#the-supervisor-process), versão, diretório de socket e contagem de workers |

822| `claude daemon stop --any` | Parar o processo supervisor e as sessões em background que ele hospeda. Passe `--keep-workers` para deixar as sessões em background em execução para que o próximo supervisor se reconecte a elas. O próximo `claude agents` ou `claude --bg` inicia um novo supervisor |822| `claude daemon stop --any` | Parar o processo supervisor e as sessões em background que ele hospeda. Passe `--keep-workers` para deixar as sessões em background em execução para que o próximo supervisor se reconecte a elas. O próximo `claude agents` ou `claude --bg` inicia um novo supervisor |

823 823 

824`claude attach` e `claude logs` podem receber parte do nome de uma sessão em execução no lugar do ID, como em `claude logs "auth refactor"`. Passar um nome requer Claude Code v2.1.290 ou posterior.

825 

824<h3 id="list-sessions-as-json">826<h3 id="list-sessions-as-json">

825 Listar sessões como JSON827 Listar sessões como JSON

826</h3>828</h3>


863 865 

864Claude Code trata cada sessão listada na visualização de agente como uma sessão em background, independentemente de você estar atualmente anexado a ela. Em contraste, uma sessão iniciada executando `claude` diretamente está vinculada a esse terminal e termina quando ele fecha, a menos que você [a envie para o background](#from-inside-a-session).866Claude Code trata cada sessão listada na visualização de agente como uma sessão em background, independentemente de você estar atualmente anexado a ela. Em contraste, uma sessão iniciada executando `claude` diretamente está vinculada a esse terminal e termina quando ele fecha, a menos que você [a envie para o background](#from-inside-a-session).

865 867 

866Para verificar que tipo de sessão você está, execute [`/status`](/docs/pt/commands). A linha `Session kind` lê `background job · attached` ou `background job · unattended` em uma sessão em background, dependendo se um terminal está anexado, e `interactive` em qualquer outra sessão.868Para verificar em que tipo de sessão você está, execute [`/status`](/docs/pt/commands). A linha `Session kind` mostra `background job · attached` ou `background job · unattended` em uma sessão em background, dependendo de haver um terminal anexado, e `interactive` em qualquer outra sessão.

867 869 

868<h3 id="the-supervisor-process">870<h3 id="the-supervisor-process">

869 O processo supervisor871 O processo supervisor


873 875 

874Cada sessão é seu próprio processo Claude Code sob o supervisor, e o que acontece com esse processo depende do estado da sessão:876Cada sessão é seu próprio processo Claude Code sob o supervisor, e o que acontece com esse processo depende do estado da sessão:

875 877 

876* **Funcionando, pausado em um prompt de permissão ou outro diálogo, ou anexado**: o processo continua em execução. Um subagent, workflow ou monitor em execução conta como funcionando.878* **Funcionando, pausado em um prompt de permissão ou outro diálogo, ou anexado**: o processo continua em execução. Um subagente, fluxo de trabalho ou monitor em execução conta como funcionando.

877* **Terminado ou aguardando sua próxima mensagem, e desanexado por cerca de uma hora**: o supervisor interrompe o processo para liberar recursos. Uma sessão que terminou seu turno fazendo uma pergunta a você conta como aguardando sua próxima mensagem. A conversa fica no disco, e na próxima vez que você anexar ou responder, a sessão retoma de onde parou. Fixe uma sessão com `Ctrl+T` para manter seu processo em execução.879* **Terminado ou aguardando sua próxima mensagem, e desanexado por cerca de uma hora**: o supervisor interrompe o processo para liberar recursos. Uma sessão que terminou seu turno fazendo uma pergunta a você conta como aguardando sua próxima mensagem. A conversa fica no disco, e na próxima vez que você anexar ou responder, a sessão retoma de onde parou. Fixe uma sessão com `Ctrl+T` para manter seu processo em execução.

878* **Saiu inesperadamente enquanto o supervisor está em execução**: o supervisor reinicia o processo. Terminar uma sessão que você colocou em background com `←` ou `/background`, por exemplo com `kill`, marca-a como parada em vez de reiniciá-la. Para sessões que terminaram com um desligamento, consulte [Sessões aparecem como falhadas ou paradas após desligamento](#sessions-show-as-failed-after-shutdown).880* **Saiu inesperadamente enquanto o supervisor está em execução**: o supervisor reinicia o processo. Terminar uma sessão que você colocou em background com `←` ou `/background`, por exemplo com `kill`, marca-a como parada em vez de reiniciá-la. Para sessões que terminaram com um desligamento, consulte [Sessões aparecem como falhadas ou paradas após desligamento](#sessions-show-as-failed-after-shutdown).

879* **Após uma atualização automática**: o supervisor reinicia a si mesmo para a nova versão e move sessões inativas em background. Sessões que estão funcionando, aguardando você ou anexadas não são interrompidas.881* **Após uma atualização automática**: o supervisor reinicia a si mesmo para a nova versão e move sessões inativas em background. Sessões que estão funcionando, aguardando você ou anexadas não são interrompidas.

880 882 

881Quando o processo de uma sessão para ou reinicia, os comandos de shell em background, workflows dinâmicos e subagents em background que Claude iniciou nela são transferidos para seu próximo processo; monitors em execução e comandos de shell que um subagent iniciou param com o processo. Deletar a sessão para tudo que ela transferiu. Para parar tudo com o processo em vez disso, defina [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/pt/env-vars#variables) como `1`.883Quando o processo de uma sessão para ou reinicia, os comandos de shell em background, fluxos de trabalho dinâmicos e subagentes em background que Claude iniciou nela são transferidos para seu próximo processo; monitors em execução e comandos de shell que um subagente iniciou param com o processo. Deletar a sessão para tudo que ela transferiu. Para parar tudo com o processo em vez disso, defina [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/pt/env-vars#variables) como `1`.

882 884 

883O supervisor e suas sessões se autenticam com as mesmas credenciais armazenadas que suas sessões interativas. Para quais configurações e variáveis de shell chegam a uma sessão, incluindo `PATH`, consulte [Configurações e provedor](#settings-and-provider). Para endpoints de gateway, consulte [Gateway LLM](#llm-gateway).885O supervisor e suas sessões se autenticam com as mesmas credenciais armazenadas que suas sessões interativas. Para quais configurações e variáveis de shell chegam a uma sessão, incluindo `PATH`, consulte [Configurações e provedor](#settings-and-provider). Para endpoints de gateway, consulte [Gateway de LLM](#llm-gateway).

884 886 

885<h3 id="where-state-is-stored">887<h3 id="where-state-is-stored">

886 Onde o estado é armazenado888 Onde o estado é armazenado


910Para desativar agentes em background e a visualização de agente completamente, defina a [configuração](/docs/pt/settings) `disableAgentView` como `true` ou defina a variável de ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Os administradores podem impor isso através de [configurações gerenciadas](/docs/pt/managed-settings).912Para desativar agentes em background e a visualização de agente completamente, defina a [configuração](/docs/pt/settings) `disableAgentView` como `true` ou defina a variável de ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Os administradores podem impor isso através de [configurações gerenciadas](/docs/pt/managed-settings).

911 913 

912<h2 id="troubleshooting">914<h2 id="troubleshooting">

913 Troubleshooting915 Solução de problemas

914</h2>916</h2>

915 917 

916<h3 id="claude-agents-lists-subagents-instead-of-opening-agent-view">918<h3 id="claude-agents-lists-subagents-instead-of-opening-agent-view">


934Se você pressionar `←` para colocar a sessão atual em background e Claude Code mostrar um diálogo `Background this session?`, a sessão tem trabalho em andamento que o backgrounding interromperia, reiniciaria ou deixaria em execução sem supervisão, e Claude Code pergunta antes de fazer qualquer um desses:936Se você pressionar `←` para colocar a sessão atual em background e Claude Code mostrar um diálogo `Background this session?`, a sessão tem trabalho em andamento que o backgrounding interromperia, reiniciaria ou deixaria em execução sem supervisão, e Claude Code pergunta antes de fazer qualquer um desses:

935 937 

936* **Trabalho que não pode se mover**: a sessão tem trabalho que não pode se mover para a sessão em background, como um [monitor](/docs/pt/tools-reference#monitor-tool) em execução. O diálogo nomeia o trabalho que Claude Code interromperia e, separadamente, conta as tarefas que são transferidas.938* **Trabalho que não pode se mover**: a sessão tem trabalho que não pode se mover para a sessão em background, como um [monitor](/docs/pt/tools-reference#monitor-tool) em execução. O diálogo nomeia o trabalho que Claude Code interromperia e, separadamente, conta as tarefas que são transferidas.

937* **Um workflow com subagentes em execução**: um [dynamic workflow](/docs/pt/workflows) ainda tem subagentes em execução. O workflow em si é transferido, mas seus subagentes em execução reiniciam do início, e o diálogo diz quantos.939* **Um fluxo de trabalho com subagentes em execução**: um [fluxo de trabalho dinâmico](/docs/pt/workflows) ainda tem subagentes em execução. O fluxo de trabalho em si é transferido, mas seus subagentes em execução reiniciam do início, e o diálogo diz quantos.

938* **Respostas automáticas de artefatos**: Claude está [respondendo a comentários em um artefato por conta própria](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own). Essas respostas continuam na sessão em background, e o diálogo diz isso.940* **Respostas automáticas de artefatos**: Claude está [respondendo a comentários em um artefato por conta própria](/docs/pt/artifacts#let-claude-reply-to-comments-on-its-own). Essas respostas continuam na sessão em background, e o diálogo diz isso.

939 941 

940Execute `/tasks` para ver tudo que está em execução, depois confirme para colocar em background mesmo assim ou escolha `Stay` para deixar o trabalho terminar primeiro. Veja [What carries over when you background](#what-carries-over-when-you-background) para quais tipos de trabalho são transferidos e quais Claude Code interrompe.942Execute `/tasks` para ver tudo que está em execução, depois confirme para colocar em background mesmo assim ou escolha `Stay` para deixar o trabalho terminar primeiro. Veja [What carries over when you background](#what-carries-over-when-you-background) para quais tipos de trabalho são transferidos e quais Claude Code interrompe.


962 Opening a session says the conversation is already open964 Opening a session says the conversation is already open

963</h3>965</h3>

964 966 

965Dois processos não podem escrever no mesmo transcript. Quando a conversa salva de uma sessão parada já está aberta em outro processo Claude Code ao vivo, Claude Code recusa iniciar o processo da sessão. O que você vê depende do que mantém a conversa:967Dois processos não podem escrever na mesma transcrição. Quando a conversa salva de uma sessão parada já está aberta em outro processo Claude Code ao vivo, Claude Code recusa iniciar o processo da sessão. O que você vê depende do que mantém a conversa:

966 968 

967* Um terminal onde você retomou a conversa, por exemplo com `claude --resume` ou `/resume`: a linha mostra `Open in a terminal` com uma dica para continuar lá, e abrir a linha mostra `Can't open — this session is running in another terminal`. Continue naquele terminal, ou saia dele e abra a linha novamente.969* Um terminal onde você retomou a conversa, por exemplo com `claude --resume` ou `/resume`: a linha mostra `Open in a terminal` com uma dica para continuar lá, e abrir a linha mostra `Can't open — this session is running in another terminal`. Continue naquele terminal, ou saia dele e abra a linha novamente.

968* Outro processo Claude Code não interativo, por exemplo um processo de sessão em background para a mesma conversa que ainda não saiu: abrir a linha mostra `This conversation is already open in another running Claude session`. Use esse processo, ou aguarde sua saída e abra a linha novamente.970* Outro processo Claude Code não interativo, por exemplo um processo de sessão em background para a mesma conversa que ainda não saiu: abrir a linha mostra `This conversation is already open in another running Claude session`. Use esse processo, ou aguarde sua saída e abra a linha novamente.


1007claude daemon stop --any --keep-workers1009claude daemon stop --any --keep-workers

1008```1010```

1009 1011 

1010O novo supervisor se reconecta às sessões em execução. Sem `--keep-workers`, o comando também encerra as sessões em background. O sinalizador `--any` confirma que você deseja interromper um supervisor que foi iniciado sob demanda em vez de como um serviço instalado, que é o padrão.1012O novo supervisor se reconecta às sessões em execução. Sem `--keep-workers`, o comando também encerra as sessões em background. A flag `--any` confirma que você deseja interromper um supervisor que foi iniciado sob demanda em vez de como um serviço instalado, que é o padrão.

1011 1013 

1012Um supervisor que inicia mas não consegue aceitar conexões sai e libera seu bloqueio por conta própria, portanto o próximo `claude agents` inicia um novo sem essa parada manual. Os passos acima se aplicam quando um supervisor em execução trava.1014Um supervisor que inicia mas não consegue aceitar conexões sai e libera seu bloqueio por conta própria, portanto o próximo `claude agents` inicia um novo sem essa parada manual. Os passos acima se aplicam quando um supervisor em execução trava.

1013 1015 

1014Se o comando em vez disso sair dizendo que o processo registrado não pôde ser verificado como o supervisor, verifique o ID do processo relatado: se for um supervisor que você possui, interrompa-o você mesmo, depois delete `~/.claude/daemon.lock` para que o próximo `claude agents` inicie novo.1016Se o comando em vez disso sair dizendo que o processo registrado não pôde ser verificado como o supervisor, verifique o ID do processo relatado: se for um supervisor que você possui, interrompa-o você mesmo, depois delete `~/.claude/daemon.lock` para que o próximo `claude agents` inicie novo.

1015 1017 

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

1017 1019 

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

1019 Dispatch fails with `Could not resolve authentication method`1021 Dispatch fails with `Could not resolve authentication method`


1055 `.claude/worktrees/` is filling up1057 `.claude/worktrees/` is filling up

1056</h3>1058</h3>

1057 1059 

1058Deletar uma sessão em agent view remove a worktree que Claude criou para ela, mas [alguns deletes mantêm a worktree ou deixam seu diretório no disco](#what-deleting-a-session-removes), então diretórios restantes podem se acumular. Diretórios que git não reconhece mais não aparecem em `git worktree list`, então remova aqueles à mão.1060Deletar uma sessão em agent view remove o worktree que Claude criou para ela, mas [alguns deletes mantêm o worktree ou deixam seu diretório no disco](#what-deleting-a-session-removes), então diretórios restantes podem se acumular. Diretórios que git não reconhece mais não aparecem em `git worktree list`, então remova aqueles à mão.

1059 1061 

1060Liste entradas restantes com `git worktree list` no diretório do projeto e remova cada uma com `git worktree remove <path>`. Veja [Clean up worktrees](/docs/pt/worktrees#clean-up-worktrees).1062Liste entradas restantes com `git worktree list` no diretório do projeto e remova cada uma com `git worktree remove <path>`. Veja [Clean up worktrees](/docs/pt/worktrees#clean-up-worktrees).

1061 1063 


1085 Histórico de versões1087 Histórico de versões

1086</h2>1088</h2>

1087 1089 

1088Agent view evoluiu rapidamente durante a visualização de pesquisa. Se você estiver em uma versão mais antiga do Claude Code, alguns comportamentos nesta página podem diferir; em particular, `claude agents` rejeita flags que ainda não suporta com um erro de `unknown option`. A tabela abaixo lista quando cada flag e comportamento foi adicionado.1090Agent view evoluiu rapidamente durante a prévia de pesquisa. Se você estiver em uma versão mais antiga do Claude Code, alguns comportamentos nesta página podem diferir; em particular, `claude agents` rejeita flags que ainda não suporta com um erro de `unknown option`. A tabela abaixo lista quando cada flag e comportamento foi adicionado.

1089 1091 

1090| Versão | Mudança |1092| Versão | Mudança |

1091| - | - |1093| - | - |

1094| v2.1.290 | [`claude attach` e `claude logs`](#manage-sessions-from-the-shell) podem receber parte do nome de uma sessão em execução no lugar do ID. |

1092| v2.1.288 | `Ctrl+F` encontra sessões pelo nome, e `Alt+↑` / `Alt+↓` saltam entre os cabeçalhos de grupo. Ambos, e `Ctrl+R`, podem ser [reatribuídos](/docs/pt/keybindings#agents-actions). |1095| v2.1.288 | `Ctrl+F` encontra sessões pelo nome, e `Alt+↑` / `Alt+↓` saltam entre os cabeçalhos de grupo. Ambos, e `Ctrl+R`, podem ser [reatribuídos](/docs/pt/keybindings#agents-actions). |

1093| v2.1.287 | O [filtro `n:<text>`](#filter-sessions) encontra sessões pelo nome ou pelo primeiro prompt. Enquanto qualquer filtro estiver ativo, os grupos que você recolheu se expandem para mostrar suas correspondências e a primeira correspondência é selecionada, então `Enter` a abre. |1096| v2.1.287 | O [filtro `n:<text>`](#filter-sessions) encontra sessões pelo nome ou pelo primeiro prompt. Enquanto qualquer filtro estiver ativo, os grupos que você recolheu se expandem para mostrar suas correspondências e a primeira correspondência é selecionada, então `Enter` a abre. |

1094| v2.1.287 | Um comando enviado como uma [resposta pela espiada](#peek-and-reply) é executado quando o turno atual da sessão termina, incluindo os comandos que são executados assim que você os digita no próprio prompt de uma sessão. Uma resposta que seja exatamente `/stop` para a sessão imediatamente. |1097| v2.1.287 | Um comando enviado como uma [resposta pela espiada](#peek-and-reply) é executado quando o turno atual da sessão termina, incluindo os comandos que são executados assim que você os digita no próprio prompt de uma sessão. Uma resposta que seja exatamente `/stop` para a sessão imediatamente. |


1099| v2.1.268 | Quando uma [exclusão é recusada](#what-deleting-a-session-removes) porque git ou seu hook `WorktreeRemove` não conseguiu remover o worktree, a mensagem nomeia a causa, incluindo como um hook terminou e o início de seu stderr. Para um worktree vinculado sob o diretório `.claude/worktrees/` do repositório sem alterações não confirmadas em arquivos rastreados, nenhum repositório aninhado dentro dele e nenhum registro de outra sessão nomeando-o, deletar a sessão novamente remove o diretório mesmo assim, a partir de agent view ou com `claude rm <id> --force-remove-worktree <worktree-id>`. Antes desta versão, a linha mostrava apenas `worktree could not be removed (WorktreeRemove hook failed)` ou o erro do git, o stderr do hook ia apenas para o log de depuração, e deletar novamente era recusado da mesma forma. |1102| v2.1.268 | Quando uma [exclusão é recusada](#what-deleting-a-session-removes) porque git ou seu hook `WorktreeRemove` não conseguiu remover o worktree, a mensagem nomeia a causa, incluindo como um hook terminou e o início de seu stderr. Para um worktree vinculado sob o diretório `.claude/worktrees/` do repositório sem alterações não confirmadas em arquivos rastreados, nenhum repositório aninhado dentro dele e nenhum registro de outra sessão nomeando-o, deletar a sessão novamente remove o diretório mesmo assim, a partir de agent view ou com `claude rm <id> --force-remove-worktree <worktree-id>`. Antes desta versão, a linha mostrava apenas `worktree could not be removed (WorktreeRemove hook failed)` ou o erro do git, o stderr do hook ia apenas para o log de depuração, e deletar novamente era recusado da mesma forma. |

1100| v2.1.268 | Após o primeiro `←` mostrar `Press ← again to open agents`, ou `Press ← again to go back to agents` em uma sessão anexada, [o primeiro pressionamento que chega pelo menos um segundo depois muda](#switch-sessions-without-leaving-the-terminal), mesmo quando pressionamentos mais rápidos no meio foram ignorados. Antes desta versão, cada pressionamento ignorado reiniciava a espera, então pressionar `←` novamente em um ritmo constante não mudava até que você pausasse por mais de um segundo. |1103| v2.1.268 | Após o primeiro `←` mostrar `Press ← again to open agents`, ou `Press ← again to go back to agents` em uma sessão anexada, [o primeiro pressionamento que chega pelo menos um segundo depois muda](#switch-sessions-without-leaving-the-terminal), mesmo quando pressionamentos mais rápidos no meio foram ignorados. Antes desta versão, cada pressionamento ignorado reiniciava a espera, então pressionar `←` novamente em um ritmo constante não mudava até que você pausasse por mais de um segundo. |

1101| v2.1.260 | Quando você [coloca uma sessão em background](#from-inside-a-session), a [listagem de agentes](/docs/pt/cross-session-messaging#see-which-sessions-claude-can-reach) de suas outras sessões mostra a conversa uma vez, como sua sessão em background, e suas mensagens para ela não chegam mais ao terminal de onde você a moveu. Antes desta versão, esse terminal poderia ficar listado como uma segunda sessão interativa sob o nome da conversa, e uma sessão que tinha enviado mensagens para a conversa antes da mudança continuava entregando a esse terminal. |1104| v2.1.260 | Quando você [coloca uma sessão em background](#from-inside-a-session), a [listagem de agentes](/docs/pt/cross-session-messaging#see-which-sessions-claude-can-reach) de suas outras sessões mostra a conversa uma vez, como sua sessão em background, e suas mensagens para ela não chegam mais ao terminal de onde você a moveu. Antes desta versão, esse terminal poderia ficar listado como uma segunda sessão interativa sob o nome da conversa, e uma sessão que tinha enviado mensagens para a conversa antes da mudança continuava entregando a esse terminal. |

1102| v2.1.260 | Quando uma [exclusão é recusada sobre commits não enviados](#what-deleting-a-session-removes), a mensagem nomeia a branch do worktree e quantos commits não foram enviados, e deletar a sessão novamente descarta o worktree e seus commits. Antes desta versão, a recusa dizia apenas `worktree has commits that are not pushed anywhere`, deletar novamente era recusado da mesma forma, e deletar a sessão exigia enviar os commits ou remover o worktree manualmente. |1105| v2.1.260 | Quando uma [exclusão é recusada sobre commits não enviados](#what-deleting-a-session-removes), a mensagem nomeia o branch do worktree e quantos commits não foram enviados, e deletar a sessão novamente descarta o worktree e seus commits. Antes desta versão, a recusa dizia apenas `worktree has commits that are not pushed anywhere`, deletar novamente era recusado da mesma forma, e deletar a sessão exigia enviar os commits ou remover o worktree manualmente. |

1103| v2.1.257 | `←` [desanexa de uma sessão anexada enquanto a sobreposição `/btw` está aberta](#attach-to-a-session), até mesmo no meio de uma resposta, e a sobreposição reabre quando você se anexa novamente. Antes desta versão, `←` não desanexava enquanto a sobreposição estava aberta. |1106| v2.1.257 | `←` [desanexa de uma sessão anexada enquanto a sobreposição `/btw` está aberta](#attach-to-a-session), até mesmo no meio de uma resposta, e a sobreposição reabre quando você se anexa novamente. Antes desta versão, `←` não desanexava enquanto a sobreposição estava aberta. |

1104| v2.1.257 | Quando você executa [`claude --resume <session-id> --bg`](#from-your-shell), Claude Code continua essa sessão sob seu próprio ID, ou inicia uma cópia sob um novo ID e imprime uma linha `note:` explicando o motivo. `--continue`, um `--resume` simples, e `--resume` com um nome ou caminho iniciam uma cópia com a mesma nota. Antes desta versão, `--resume` com `--bg` sempre iniciava uma cópia sob um novo ID e não dizia nada. |1107| v2.1.257 | Quando você executa [`claude --resume <session-id> --bg`](#from-your-shell), Claude Code continua essa sessão sob seu próprio ID, ou inicia uma cópia sob um novo ID e imprime uma linha `note:` explicando o motivo. `--continue`, um `--resume` simples, e `--resume` com um nome ou caminho iniciam uma cópia com a mesma nota. Antes desta versão, `--resume` com `--bg` sempre iniciava uma cópia sob um novo ID e não dizia nada. |

1105| v2.1.257 | Quando você despacha uma sessão a partir de uma agent view que você abriu com `←`, Claude Code a inicia no [modo de permissão que o diretório de destino configura](#permission-mode) através de `permissions.defaultMode`. Quando o diretório não define um, o modo de permissão da sessão de onde você veio se aplica. Antes desta versão, a sessão despachada sempre iniciava no modo de permissão da sessão de onde você veio, substituindo-o. |1108| v2.1.257 | Quando você despacha uma sessão a partir de uma agent view que você abriu com `←`, Claude Code a inicia no [modo de permissão que o diretório de destino configura](#permission-mode) através de `permissions.defaultMode`. Quando o diretório não define um, o modo de permissão da sessão de onde você veio se aplica. Antes desta versão, a sessão despachada sempre iniciava no modo de permissão da sessão de onde você veio, sobrescrevendo-o. |

1106| v2.1.257 | `Ctrl+S`, `Ctrl+T` e `Ctrl+G` em agent view [seguem seus `keybindings.json`](#keyboard-shortcuts): `Ctrl+S` e `Ctrl+T` através das ações `agents:switchView` e `agents:togglePin` do contexto `Agents`, e `Ctrl+G` através da vinculação `chat:externalEditor` do contexto `Chat`. Antes desta versão, agent view ignorava `keybindings.json` e essas teclas eram fixas. |1109| v2.1.257 | `Ctrl+S`, `Ctrl+T` e `Ctrl+G` em agent view [seguem seus `keybindings.json`](#keyboard-shortcuts): `Ctrl+S` e `Ctrl+T` através das ações `agents:switchView` e `agents:togglePin` do contexto `Agents`, e `Ctrl+G` através da vinculação `chat:externalEditor` do contexto `Chat`. Antes desta versão, agent view ignorava `keybindings.json` e essas teclas eram fixas. |

1107| v2.1.257 | Iniciar o [serviço de background](#the-supervisor-process) se recupera de duas causas de falha. Em uma instalação npm no macOS, um início durante uma auto-atualização [aguarda a instalação](/docs/pt/errors#eacces-when-starting-a-background-session) em vez de executar o placeholder que npm coloca enquanto substitui o binário. No Windows, um `daemon.lock` obsoleto escrito antes da última inicialização da máquina, ou cujo ID de processo registrado agora pertence a um processo diferente, é substituído. Antes desta versão, o início no macOS falhava com `Error: claude native binary not installed.` durante a janela de instalação, e o lock do Windows fazia cada início falhar com [`exited before it became reachable`](/docs/pt/errors#background-service-exited-before-it-became-reachable) até que você deletasse `~/.claude/daemon.lock`. |1110| v2.1.257 | Iniciar o [serviço de background](#the-supervisor-process) se recupera de duas causas de falha. Em uma instalação npm no macOS, um início durante uma auto-atualização [aguarda a instalação](/docs/pt/errors#eacces-when-starting-a-background-session) em vez de executar o placeholder que npm coloca enquanto substitui o binário. No Windows, um `daemon.lock` obsoleto escrito antes da última inicialização da máquina, ou cujo ID de processo registrado agora pertence a um processo diferente, é substituído. Antes desta versão, o início no macOS falhava com `Error: claude native binary not installed.` durante a janela de instalação, e o lock do Windows fazia cada início falhar com [`exited before it became reachable`](/docs/pt/errors#background-service-exited-before-it-became-reachable) até que você deletasse `~/.claude/daemon.lock`. |

1108| v2.1.257 | Quando você abre ou despacha uma sessão em background enquanto outro processo Claude Code está baixando uma atualização npm, Claude Code [continua aguardando até dois minutos](/docs/pt/errors#eacces-when-starting-a-background-session) enquanto a instalação é executada, depois falha dizendo `Claude Code is being updated by npm on this machine`. Antes desta versão, a espera parava em dez segundos, então a abertura falhava com `Couldn't start the background service` enquanto o download ainda estava em execução. |1111| v2.1.257 | Quando você abre ou despacha uma sessão em background enquanto outro processo Claude Code está baixando uma atualização npm, Claude Code [continua aguardando até dois minutos](/docs/pt/errors#eacces-when-starting-a-background-session) enquanto a instalação é executada, depois falha dizendo `Claude Code is being updated by npm on this machine`. Antes desta versão, a espera parava em dez segundos, então a abertura falhava com `Couldn't start the background service` enquanto o download ainda estava em execução. |

1109| v2.1.257 | Uma sessão em background segurando uma [mensagem entre sessões](/docs/pt/cross-session-messaging#control-inbound-messages) para sua aprovação mostra `approve message from` em sua linha `Needs input`, com o endereço do remetente e o nome que o remetente afirma. Antes desta versão, a linha se movia para `Needs input` mas mantinha seu texto anterior, então nada em `claude agents` nomeava a mensagem aguardando ou seu remetente. |1112| v2.1.257 | Uma sessão em background segurando uma [mensagem entre sessões](/docs/pt/cross-session-messaging#control-inbound-messages) para sua aprovação mostra `approve message from` em sua linha `Needs input`, com o endereço do remetente e o nome que o remetente afirma. Antes desta versão, a linha se movia para `Needs input` mas mantinha seu texto anterior, então nada em `claude agents` nomeava a mensagem aguardando ou seu remetente. |

1110| v2.1.257 | Um prompt armazenado com `Ctrl+S` dentro de uma sessão em background aberta [é mantido com a sessão](#what-persists-across-restarts), então `Ctrl+S` o restaura após o processo da sessão ser parado e iniciado novamente. Antes desta versão, o armazenamento vivia apenas no processo em execução e era perdido quando a sessão ficava ociosa tempo suficiente para seu processo parar, ou quando era parada e depois reabierta. |1113| v2.1.257 | Um prompt armazenado com `Ctrl+S` dentro de uma sessão em background aberta [é mantido com a sessão](#what-persists-across-restarts), então `Ctrl+S` o restaura após o processo da sessão ser parado e iniciado novamente. Antes desta versão, o armazenamento vivia apenas no processo em execução e era perdido quando a sessão ficava ociosa tempo suficiente para seu processo parar, ou quando era parada e depois reaberta. |

1111| v2.1.251 | Em uma sessão em background que não [se moveu para um worktree](#how-file-edits-are-isolated), Claude e os subagentes que ele gera podem editar arquivos dentro de um worktree git vinculado. |1114| v2.1.251 | Em uma sessão em background que não [se moveu para um worktree](#how-file-edits-are-isolated), Claude e os subagentes que ele gera podem editar arquivos dentro de um worktree git vinculado. |

1112| v2.1.251 | Claude Code encaminha um gateway de provedor de nuvem exportado no shell de onde você despacha, como `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL` com sua flag de bypass de autenticação, para [o worker da sessão](#llm-gateway) sob as mesmas condições que `ANTHROPIC_BASE_URL`. Antes desta versão, se você colocasse em background ou despachasse a partir de um shell autenticado apenas através de tal gateway, cada solicitação que a sessão fazia falhava, porque o endpoint e a flag eram descartados de seu ambiente. |1115| v2.1.251 | Claude Code encaminha um gateway de provedor de nuvem exportado no shell de onde você despacha, como `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL` com sua flag de bypass de autenticação, para [o worker da sessão](#llm-gateway) sob as mesmas condições que `ANTHROPIC_BASE_URL`. Antes desta versão, se você colocasse em background ou despachasse a partir de um shell autenticado apenas através de tal gateway, cada requisição que a sessão fazia falhava, porque o endpoint e a flag eram descartados de seu ambiente. |

1113| v2.1.251 | Quando uma sessão em background inicia enquanto outro processo Claude Code está atualizando um [marketplace de plugins](/docs/pt/plugins/overview), como uma sessão irmã executando a [atualização automática do marketplace](/docs/pt/plugins/install#keep-plugins-updated), Claude Code mantém os plugins desse marketplace disponíveis. Antes desta versão, tal sessão poderia iniciar sem nenhuma das skills, agentes, hooks e servidores MCP desse marketplace e permanecer assim durante toda sua execução. |1116| v2.1.251 | Quando uma sessão em background inicia enquanto outro processo Claude Code está atualizando um [marketplace de plugins](/docs/pt/plugins/overview), como uma sessão irmã executando a [atualização automática do marketplace](/docs/pt/plugins/install#keep-plugins-updated), Claude Code mantém os plugins desse marketplace disponíveis. Antes desta versão, tal sessão poderia iniciar sem nenhuma das skills, agentes, hooks e servidores MCP desse marketplace e permanecer assim durante toda sua execução. |

1114| v2.1.248 | `Shift+Enter` na [entrada de despacho](#keyboard-shortcuts) insere uma nova linha, correspondendo ao prompt principal, e `Ctrl+Enter` despacha e se anexa imediatamente em terminais onde a sobreposição `?` lista `ctrl+enter to start and open`. Antes desta versão, `Shift+Enter` despachava e se anexava. |1117| v2.1.248 | `Shift+Enter` na [entrada de despacho](#keyboard-shortcuts) insere uma nova linha, correspondendo ao prompt principal, e `Ctrl+Enter` despacha e se anexa imediatamente em terminais onde a sobreposição `?` lista `ctrl+enter to start and open`. Antes desta versão, `Shift+Enter` despachava e se anexava. |

1115| v2.1.248 | [Deletar uma sessão](#what-deleting-a-session-removes) tem sucesso quando os commits do worktree já estão na cópia local da branch padrão do seu remote `origin` e seu checkout principal tem essa branch verificada; antes desta versão, a exclusão era recusada com `has commits that are not pushed anywhere`. |1118| v2.1.248 | [Deletar uma sessão](#what-deleting-a-session-removes) tem sucesso quando os commits do worktree já estão na cópia local do branch padrão do seu remote `origin` e seu checkout principal tem esse branch em checkout; antes desta versão, a exclusão era recusada com `has commits that are not pushed anywhere`. |

1116| v2.1.248 | Uma sessão colocada em background com `←` ou `/background` mantém o [`git worktree lock`](/docs/pt/worktrees#clean-up-subagent-and-background-session-worktrees) em seu worktree enquanto é executada; antes desta versão, colocar em background liberava o lock, e limpeza ou `git worktree remove` poderia remover o worktree sob a sessão em execução. |1119| v2.1.248 | Uma sessão colocada em background com `←` ou `/background` mantém o [`git worktree lock`](/docs/pt/worktrees#clean-up-subagent-and-background-session-worktrees) em seu worktree enquanto é executada; antes desta versão, colocar em background liberava o lock, e limpeza ou `git worktree remove` poderia remover o worktree sob a sessão em execução. |

1117| v2.1.248 | Uma sessão em background que não estava aguardando sua entrada e é encontrada morta mais de 48 horas após sua última atividade, como após a máquina estar desligada por dias, [mostra como parada](#sessions-show-as-failed-after-shutdown) com `ended while the background service was off`, e `Enter` nela pergunta antes de retomar sua conversa salva. Antes desta versão, tal sessão reaparecia como uma falha fresca classificada no topo da lista, e um único `Enter` puxava a conversa de semanas atrás para o primeiro plano. |1120| v2.1.248 | Uma sessão em background que não estava aguardando sua entrada e é encontrada morta mais de 48 horas após sua última atividade, como após a máquina estar desligada por dias, [mostra como parada](#sessions-show-as-failed-after-shutdown) com `ended while the background service was off`, e `Enter` nela pergunta antes de retomar sua conversa salva. Antes desta versão, tal sessão reaparecia como uma falha fresca classificada no topo da lista, e um único `Enter` puxava a conversa de semanas atrás para o primeiro plano. |

1118| v2.1.248 | Abrir uma linha parada cuja conversa [você retomou em outro terminal](#opening-a-session-says-the-conversation-is-already-open) é recusado com `Can't open — this session is running in another terminal`, e a linha mostra `Open in a terminal` em vez de mostrar sob `Working`. Antes desta versão, abrir a linha iniciava um segundo processo escrevendo para a mesma conversa. |1121| v2.1.248 | Abrir uma linha parada cuja conversa [você retomou em outro terminal](#opening-a-session-says-the-conversation-is-already-open) é recusado com `Can't open — this session is running in another terminal`, e a linha mostra `Open in a terminal` em vez de mostrar sob `Working`. Antes desta versão, abrir a linha iniciava um segundo processo escrevendo para a mesma conversa. |

1119| v2.1.248 | Uma sessão em background aguardando uma decisão de permissão enquanto um hook `PermissionRequest` ou `PreToolUse` imprimiu uma resposta inválida [nomeia o evento do hook e o erro de schema em sua linha](#peek-and-reply). Antes desta versão, a linha mostrava apenas a solicitação pendente. |1122| v2.1.248 | Uma sessão em background aguardando uma decisão de permissão enquanto um hook `PermissionRequest` ou `PreToolUse` imprimiu uma resposta inválida [nomeia o evento do hook e o erro de esquema em sua linha](#peek-and-reply). Antes desta versão, a linha mostrava apenas a solicitação pendente. |

1120| v2.1.248 | No Windows, `claude agents` responde ao teclado quando lançado em uma aba de terminal que um programa anterior deixou em win32-input-mode. Antes desta versão, Claude Code não decodificava os registros de chave que tal aba envia. |1123| v2.1.248 | No Windows, `claude agents` responde ao teclado quando lançado em uma aba de terminal que um programa anterior deixou em win32-input-mode. Antes desta versão, Claude Code não decodificava os registros de tecla que tal aba envia. |

1121| v2.1.247 | No Linux e WSL, uma sessão [cujo processo host do terminal morreu](#the-terminal-host-died-or-the-session-stopped-responding) falha em segundos com o motivo. Uma abertura que não produz saída termina após cerca de dez segundos com uma oferta de reinício, e `Enter` na linha reinicia a sessão com sua conversa; `claude attach <id>` relata a causa e sai. Antes desta versão, abrir tal sessão mostrava `opening… · esc to cancel` indefinidamente e `claude attach <id>` aguardava sem relatar um erro. |1124| v2.1.247 | No Linux e WSL, uma sessão [cujo processo host do terminal morreu](#the-terminal-host-died-or-the-session-stopped-responding) falha em segundos com o motivo. Uma abertura que não produz saída termina após cerca de dez segundos com uma oferta de reinício, e `Enter` na linha reinicia a sessão com sua conversa; `claude attach <id>` relata a causa e sai. Antes desta versão, abrir tal sessão mostrava `opening… · esc to cancel` indefinidamente e `claude attach <id>` aguardava sem relatar um erro. |

1122| v2.1.246 | Em uma instalação npm, quando o [serviço de background](#the-supervisor-process) falha ao iniciar enquanto `npm install -g @anthropic-ai/claude-code` está substituindo o binário, Claude Code aguarda até dez segundos para a instalação terminar e tenta novamente antes de relatar [`EACCES: permission denied`](/docs/pt/errors#eacces-when-starting-a-background-session). |1125| v2.1.246 | Em uma instalação npm, quando o [serviço de background](#the-supervisor-process) falha ao iniciar enquanto `npm install -g @anthropic-ai/claude-code` está substituindo o binário, Claude Code aguarda até dez segundos para a instalação terminar e tenta novamente antes de relatar [`EACCES: permission denied`](/docs/pt/errors#eacces-when-starting-a-background-session). |

1123| v2.1.246 | Quando o processo do [serviço de background](#the-supervisor-process) morre após imprimir um erro, Claude Code relata a falha e [cita a primeira linha de erro do serviço](/docs/pt/errors#background-service-exited-before-it-became-reachable). |1126| v2.1.246 | Quando o processo do [serviço de background](#the-supervisor-process) morre após imprimir um erro, Claude Code relata a falha e [cita a primeira linha de erro do serviço](/docs/pt/errors#background-service-exited-before-it-became-reachable). |

1124| v2.1.246 | Se sua máquina dormir enquanto o [serviço de background](#the-supervisor-process) está iniciando, Claude Code tenta novamente o início uma vez em vez de falhar. |1127| v2.1.246 | Se sua máquina dormir enquanto o [serviço de background](#the-supervisor-process) está iniciando, Claude Code tenta novamente o início uma vez em vez de falhar. |

1125| v2.1.246 | Claude Code aguarda cerca de dois minutos em vez de 45 segundos por um [serviço de background](#the-supervisor-process) recém-iniciado que está vivo mas lento para aceitar conexões. |1128| v2.1.246 | Claude Code aguarda cerca de dois minutos em vez de 45 segundos por um [serviço de background](#the-supervisor-process) recém-iniciado que está vivo mas lento para aceitar conexões. |

1126| v2.1.246 | O [serviço de background](#the-supervisor-process) inicia a partir de seu diretório inicial, então no macOS e Linux um diretório inicial que foi deletado ou movido não bloqueia mais o início. |1129| v2.1.246 | O [serviço de background](#the-supervisor-process) inicia a partir do seu diretório pessoal, então no macOS e Linux um diretório de partida que foi deletado ou movido não bloqueia mais o início. |

1127| v2.1.246 | `/fork` [copia a conversa completa](#copy-the-session-with-%2Ffork) de uma sessão que ela mesma iniciou como uma cópia e não registrou um novo prompt desde: uma cópia `/fork` que você se anexou, uma sessão reexaminada após `←` ou `/background` a moveu para o background, ou uma sessão iniciada com `claude --resume <id> --fork-session`. Antes desta versão, se você executasse `/fork` em tal sessão antes de enviar um novo prompt, Claude Code imprimia a confirmação normal mas iniciava a cópia com uma conversa vazia. Mover tal sessão para o background com `←` ou `/background` perdia a conversa da mesma forma. |1130| v2.1.246 | `/fork` [copia a conversa completa](#copy-the-session-with-%2Ffork) de uma sessão que ela mesma iniciou como uma cópia e não registrou um novo prompt desde então: uma cópia `/fork` à qual você se anexou, uma sessão reanexada após `←` ou `/background` a mover para o background, ou uma sessão iniciada com `claude --resume <id> --fork-session`. Antes desta versão, se você executasse `/fork` em tal sessão antes de enviar um novo prompt, Claude Code imprimia a confirmação normal mas iniciava a cópia com uma conversa vazia. Mover tal sessão para o background com `←` ou `/background` perdia a conversa da mesma forma. |

1128| v2.1.246 | Quando você abre uma sessão que acabou de despachar enquanto seu processo worker ainda está iniciando, como pressionando `Enter` em sua linha, Claude Code aguarda o processo e depois se anexa. Antes desta versão, se você pressionasse `Enter` enquanto o processo ainda estava iniciando, Claude Code poderia parar a sessão com [`Session <id> was stopped while the respawn was in flight`](/docs/pt/errors#session-was-stopped-while-the-respawn-was-in-flight). |1131| v2.1.246 | Quando você abre uma sessão que acabou de despachar enquanto seu processo worker ainda está iniciando, como pressionando `Enter` em sua linha, Claude Code aguarda o processo e depois se anexa. Antes desta versão, se você pressionasse `Enter` enquanto o processo ainda estava iniciando, Claude Code poderia parar a sessão com [`Session <id> was stopped while the respawn was in flight`](/docs/pt/errors#session-was-stopped-while-the-respawn-was-in-flight). |

1129| v2.1.246 | Quando você [coloca em background](#from-inside-a-session) uma sessão nomeada, Claude Code a lista uma vez, e quando você coloca em background a mesma conversa novamente, ele numera o nome da nova linha, como `my-session (2)`, com a linha existente mantendo seu nome. Antes desta versão, o terminal em que você pressionou `←` poderia aparecer em `claude agents --json` como uma segunda sessão sob o mesmo nome, e se você colocasse em background a mesma conversa novamente, Claude Code adicionava outra linha sob o nome idêntico. |1132| v2.1.246 | Quando você [coloca em background](#from-inside-a-session) uma sessão nomeada, Claude Code a lista uma vez, e quando você coloca em background a mesma conversa novamente, ele numera o nome da nova linha, como `my-session (2)`, com a linha existente mantendo seu nome. Antes desta versão, o terminal em que você pressionou `←` poderia aparecer em `claude agents --json` como uma segunda sessão sob o mesmo nome, e se você colocasse em background a mesma conversa novamente, Claude Code adicionava outra linha sob o nome idêntico. |

1130| v2.1.239 | Com [modo de editor vim](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `Esc` na entrada de agent view muda de modo INSERT para NORMAL e mantém seu texto, correspondendo ao prompt principal; em modo NORMAL com texto ainda na entrada, pressionar `Esc` o limpa, e pressionar `Esc` em uma entrada vazia sai, como o atalho [`Esc`](#keyboard-shortcuts) descreve. Antes desta versão, `Esc` limpava a entrada. |1133| v2.1.239 | Com [modo de editor vim](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `Esc` na entrada de agent view muda de modo INSERT para NORMAL e mantém seu texto, correspondendo ao prompt principal; em modo NORMAL com texto ainda na entrada, pressionar `Esc` o limpa, e pressionar `Esc` em uma entrada vazia sai, como o atalho [`Esc`](#keyboard-shortcuts) descreve. Antes desta versão, `Esc` limpava a entrada. |

1131| v2.1.233 | Para uma sessão vinculada a um merge request do GitLab, Claude Code escreve o rótulo da linha na sintaxe de referência `!1234` do GitLab. Você também pode colar a URL do merge request na [entrada de despacho](#filter-sessions) para selecionar essa sessão. Antes desta versão, o rótulo era renderizado como `#1234`, e uma URL de merge request colada correspondia a uma sessão apenas quando seu primeiro prompt continha a URL. |1134| v2.1.233 | Para uma sessão vinculada a um merge request do GitLab, Claude Code escreve o rótulo da linha na sintaxe de referência `!1234` do GitLab. Você também pode colar a URL do merge request na [entrada de despacho](#filter-sessions) para selecionar essa sessão. Antes desta versão, o rótulo era renderizado como `#1234`, e uma URL de merge request colada correspondia a uma sessão apenas quando seu primeiro prompt continha a URL. |

1132| v2.1.227 | [Deletar uma sessão](#what-deleting-a-session-removes) mantém a sessão e seu worktree enquanto outra sessão Claude Code ao vivo está em execução dentro desse diretório de worktree. Agent view mostra `not deleted` na linha e o motivo no rodapé, e `claude rm` imprime `kept <id>` com o motivo, que nomeia o ID do processo da outra sessão. Antes desta versão, deletar a sessão removia o worktree enquanto a outra sessão ainda estava trabalhando nele. |1135| v2.1.227 | [Deletar uma sessão](#what-deleting-a-session-removes) mantém a sessão e seu worktree enquanto outra sessão Claude Code ao vivo está em execução dentro desse diretório de worktree. Agent view mostra `not deleted` na linha e o motivo no rodapé, e `claude rm` imprime `kept <id>` com o motivo, que nomeia o ID do processo da outra sessão. Antes desta versão, deletar a sessão removia o worktree enquanto a outra sessão ainda estava trabalhando nele. |

1133| v2.1.225 | `claude agents` em um diretório que você não confiou mostra o mesmo [diálogo de confiança de workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust) que `claude` mostra na inicialização, antes de agent view abrir. Aceitar salva confiança para esse workspace; recusar sai sem abrir agent view. Antes desta versão, `claude agents` abria sem perguntar, então sessões que você despachava a partir dele eram executadas em um diretório que você nunca foi perguntado se confiava.<br /><br />Com a lista agrupada por diretório, passar o mouse sobre uma linha a destaca sem alterar o [alvo de despacho](#dispatch-to-a-specific-directory); selecionar uma linha com as teclas de seta ou um clique ainda altera o alvo. Antes desta versão, mover o mouse sobre uma sessão em outro projeto silenciosamente alterava o diretório em que a próxima sessão despachada iniciava. |1136| v2.1.225 | `claude agents` em um diretório que você não confiou mostra o mesmo [diálogo de confiança de workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust) que `claude` mostra na inicialização, antes de agent view abrir. Aceitar salva confiança para esse workspace; recusar sai sem abrir agent view. Antes desta versão, `claude agents` abria sem perguntar, então sessões que você despachava a partir dele eram executadas em um diretório que você nunca foi perguntado se confiava.<br /><br />Com a lista agrupada por diretório, passar o mouse sobre uma linha a destaca sem alterar o [alvo de despacho](#dispatch-to-a-specific-directory); selecionar uma linha com as teclas de seta ou um clique ainda altera o alvo. Antes desta versão, mover o mouse sobre uma sessão em outro projeto silenciosamente alterava o diretório em que a próxima sessão despachada iniciava. |

1134| v2.1.221 | `/status` mostra uma linha `Session kind`: `background job · attached` ou `background job · unattended` em uma sessão em background, dependendo se um terminal está anexado, e `interactive` em qualquer outra sessão. Antes desta versão, `/status` não relatava o tipo de sessão.<br /><br />`/fork`: Claude Code instrui [a cópia](#from-inside-a-session) a isolar seu trabalho da sessão original: a cópia cria seu próprio worktree antes de fazer alterações de código, fica fora do worktree da sessão original, e baseia uma nova branch na branch da original quando sua tarefa se baseia nesse trabalho. Veja a seção vinculada para as condições exatas. Antes desta versão, a cópia não recebia instrução de isolamento e poderia acabar editando o worktree ou fazendo checkout que a sessão original ainda estava trabalhando.<br /><br />Com [modo de editor vim](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `←` logo após desfazer o prompt de volta para vazio com `u` pede a mesma confirmação que deletar o texto ou mover através do histórico de prompts, e muda apenas na segunda pressão; antes desta versão a pressão mudava imediatamente. |1137| v2.1.221 | `/status` mostra uma linha `Session kind`: `background job · attached` ou `background job · unattended` em uma sessão em background, dependendo se um terminal está anexado, e `interactive` em qualquer outra sessão. Antes desta versão, `/status` não relatava o tipo de sessão.<br /><br />`/fork`: Claude Code instrui [a cópia](#from-inside-a-session) a isolar seu trabalho da sessão original: a cópia cria seu próprio worktree antes de fazer alterações de código, fica fora do worktree da sessão original, e baseia um novo branch no branch da original quando sua tarefa se baseia nesse trabalho. Veja a seção vinculada para as condições exatas. Antes desta versão, a cópia não recebia instrução de isolamento e poderia acabar editando o worktree ou o checkout em que a sessão original ainda estava trabalhando.<br /><br />Com [modo de editor vim](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `←` logo após desfazer o prompt de volta para vazio com `u` pede a mesma confirmação que deletar o texto ou mover através do histórico de prompts, e muda apenas na segunda pressão; antes desta versão a pressão mudava imediatamente. |

1135| v2.1.219 | Com [modo de editor vim](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `←` em um prompt vazio abre agent view do modo NORMAL assim como INSERT, e a dica `←` do rodapé mostra em modo NORMAL; antes desta versão o gesto e a dica eram apenas INSERT, e em modo NORMAL `←` em um prompt vazio não fazia nada. Digitar na entrada enquanto Claude Code aguarda colocar a sessão em background cancela a mudança com `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` então um rascunho digitado não é perdido. |1138| v2.1.219 | Com [modo de editor vim](/docs/pt/interactive-mode#vim-editor-mode) ativado, pressionar `←` em um prompt vazio abre agent view do modo NORMAL assim como INSERT, e a dica `←` do rodapé mostra em modo NORMAL; antes desta versão o gesto e a dica eram apenas INSERT, e em modo NORMAL `←` em um prompt vazio não fazia nada. Digitar na entrada enquanto Claude Code aguarda colocar a sessão em background cancela a mudança com `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` então um rascunho digitado não é perdido. |

1136| v2.1.218 | Pressionar `←` dentro de dois segundos de uma exclusão que esvaziou o prompt, ou de mover através do histórico de prompts, mostra `Press ← again to open agents`, ou `Press ← again to go back to agents` em uma sessão anexada, e muda apenas em uma segunda pressão pelo menos um segundo depois; antes desta versão a pressão mudava imediatamente. Um `←` que chega dentro de entrada colada ou com script não dispara mais a mudança. Colocar uma sessão em primeiro plano em background com `←` mostra `Your conversation moved to the background` acima da lista, e `Esc` na raiz de agent view retorna para essa conversa em vez de sair para o shell, com duplo `Ctrl+C` permanecendo a saída; se a conversa não puder ser reabierta, Claude Code sai e imprime um comando `claude --resume` para ela. No Windows, um `←` pressionado dentro de cerca de meio segundo de se anexar mostra `Ambiguous ←, press again to detach` e desanexa na segunda pressão. |1139| v2.1.218 | Pressionar `←` dentro de dois segundos de uma exclusão que esvaziou o prompt, ou de mover através do histórico de prompts, mostra `Press ← again to open agents`, ou `Press ← again to go back to agents` em uma sessão anexada, e muda apenas em uma segunda pressão pelo menos um segundo depois; antes desta versão a pressão mudava imediatamente. Um `←` que chega dentro de entrada colada ou com script não dispara mais a mudança. Colocar uma sessão em primeiro plano em background com `←` mostra `Your conversation moved to the background` acima da lista, e `Esc` na raiz de agent view retorna para essa conversa em vez de sair para o shell, com duplo `Ctrl+C` permanecendo a saída; se a conversa não puder ser reaberta, Claude Code sai e imprime um comando `claude --resume` para ela. No Windows, um `←` pressionado dentro de cerca de meio segundo de se anexar mostra `Ambiguous ←, press again to detach` e desanexa na segunda pressão. |

1137| v2.1.217 | O badge de pull request na linha de uma sessão é renderizado como um hiperlink mesmo quando Claude Code não consegue detectar suporte a hiperlink de terminal, por exemplo sobre SSH ou tmux; defina [`FORCE_HYPERLINK=0`](/docs/pt/env-vars) para renderizá-lo como texto simples. Antes desta versão, o badge era renderizado como texto simples quando o suporte não era detectado. |1140| v2.1.217 | O badge de pull request na linha de uma sessão é renderizado como um hiperlink mesmo quando Claude Code não consegue detectar suporte a hiperlink de terminal, por exemplo sobre SSH ou tmux; defina [`FORCE_HYPERLINK=0`](/docs/pt/env-vars) para renderizá-lo como texto simples. Antes desta versão, o badge era renderizado como texto simples quando o suporte não era detectado. |

1138| v2.1.216 | `/fork`: a [confirmação](#from-inside-a-session) é uma linha, mostrando o estado da cópia, o nome de sua linha de agent-view, e seu ID de sessão para `claude attach`, terminando com `runs in the origin tree` ou `edits this checkout` apenas quando a cópia é executada na árvore de trabalho principal ou edita o checkout que você tem aberto. Clicar no nome coloca essa sessão em background e abre agent view na sessão da cópia. A confirmação não reafirma mais o modo de permissão herdado da cópia; versões anteriores imprimiam uma confirmação de múltiplas linhas sem nome clicável.<br /><br />Needs input: `/install-github-app` e a lista de configurações `/mcp`, executadas enquanto ninguém está anexado, mostram a sessão sob `Needs input` com uma linha nomeando o comando, e anexar e re-executar o comando continua; de v2.1.208 até v2.1.215 eles foram recusados completamente nesse estado.<br /><br />`--agent` restore: retomar ou reiniciar uma [sessão `--agent` colocada em background](#from-your-shell) restaura o prompt do sistema do agente e restrições de ferramentas, procurando no diretório da própria sessão pelo agente primeiro, quando seu workspace é confiável; uma sessão cujo agente não existe mais continua com as ferramentas padrão e prompt do sistema e abre com um aviso visível, em vez de silenciosamente reverter para o agente padrão.<br /><br />`Ctrl+X`: pressioná-lo duas vezes deleta uma sessão mesmo quando a tentativa de parada falha, em vez de uma parada falhada cancelar a exclusão pendente, e uma sessão deletada cujo processo worker tinha morrido não reaparece no próximo refresh.<br /><br />Worktree deletion: uma sessão cujo diretório de worktree não pertence a nenhum repositório git pode ser deletada; antes desta versão cada tentativa de deletar tal sessão era recusada. Um diretório que já se foi se limpa imediatamente. O double-press de agent view remove um diretório que ainda tem arquivos, executando seu hook `WorktreeRemove` para um diretório criado por hook, a menos que outro registro de sessão também o nomeie. `claude rm` mantém tal diretório sempre que arquivos permanecem. |1141| v2.1.216 | `/fork`: a [confirmação](#from-inside-a-session) é uma linha, mostrando o estado da cópia, o nome de sua linha de agent-view, e seu ID de sessão para `claude attach`, terminando com `runs in the origin tree` ou `edits this checkout` apenas quando a cópia é executada na árvore de trabalho principal ou edita o checkout que você tem aberto. Clicar no nome coloca essa sessão em background e abre agent view na sessão da cópia. A confirmação não reafirma mais o modo de permissão herdado da cópia; versões anteriores imprimiam uma confirmação de múltiplas linhas sem nome clicável.<br /><br />Needs input: `/install-github-app` e a lista de configurações `/mcp`, executadas enquanto ninguém está anexado, mostram a sessão sob `Needs input` com uma linha nomeando o comando, e anexar e re-executar o comando continua; de v2.1.208 até v2.1.215 eles foram recusados completamente nesse estado.<br /><br />`--agent` restore: retomar ou reiniciar uma [sessão `--agent` colocada em background](#from-your-shell) restaura o system prompt do agente e restrições de ferramentas, procurando no diretório da própria sessão pelo agente primeiro, quando seu workspace é confiável; uma sessão cujo agente não existe mais continua com as ferramentas padrão e o system prompt padrão e abre com um aviso visível, em vez de silenciosamente reverter para o agente padrão.<br /><br />`Ctrl+X`: pressioná-lo duas vezes deleta uma sessão mesmo quando a tentativa de parada falha, em vez de uma parada falhada cancelar a exclusão pendente, e uma sessão deletada cujo processo worker tinha morrido não reaparece no próximo refresh.<br /><br />Worktree deletion: uma sessão cujo diretório de worktree não pertence a nenhum repositório git pode ser deletada; antes desta versão cada tentativa de deletar tal sessão era recusada. Um diretório que já se foi se limpa imediatamente. O double-press de agent view remove um diretório que ainda tem arquivos, executando seu hook `WorktreeRemove` para um diretório criado por hook, a menos que outro registro de sessão também o nomeie. `claude rm` mantém tal diretório sempre que arquivos permanecem. |

1139| v2.1.214 | Uma sessão colocada em background com `←` ou `/background` e deixada ociosa sem nada em execução tem seu processo parado como qualquer outra sessão ociosa, em vez de manter seu processo e o serviço de background em execução indefinidamente. Uma sessão concluída pode ser removida com `claude rm` ou a partir de agent view após o serviço de background ficar ocioso, e uma sessão que entrou em um worktree após ser despachada de um diretório que não é um repositório git, como uma pasta de workspace multi-repo, pode ser deletada a partir de agent view quando o próprio worktree pertence a um repositório git, porque a limpeza é resolvida a partir do worktree em vez do diretório de onde a sessão foi despachada; ambas as remoções foram recusadas em cada tentativa antes. Reabrir uma sessão parada restaura sua conversa salva mesmo quando uma pasta no armazenamento de transcrição não pode ser lida. |1142| v2.1.214 | Uma sessão colocada em background com `←` ou `/background` e deixada ociosa sem nada em execução tem seu processo parado como qualquer outra sessão ociosa, em vez de manter seu processo e o serviço de background em execução indefinidamente. Uma sessão concluída pode ser removida com `claude rm` ou a partir de agent view após o serviço de background ficar ocioso, e uma sessão que entrou em um worktree após ser despachada de um diretório que não é um repositório git, como uma pasta de workspace multi-repo, pode ser deletada a partir de agent view quando o próprio worktree pertence a um repositório git, porque a limpeza é resolvida a partir do worktree em vez do diretório de onde a sessão foi despachada; ambas as remoções foram recusadas em cada tentativa antes. Reabrir uma sessão parada restaura sua conversa salva mesmo quando uma pasta no armazenamento de transcrição não pode ser lida. |

1140| v2.1.213 | `/install-github-app`, a lista de configurações [`/mcp`](/docs/pt/mcp), e ações de autenticação MCP funcionam em uma sessão em background enquanto um terminal está anexado, e são recusadas apenas quando ninguém está anexado, com uma mensagem dizendo para você anexar e executar o comando novamente; de v2.1.208 até v2.1.212 eles foram recusados mesmo com um terminal anexado. |1143| v2.1.213 | `/install-github-app`, a lista de configurações [`/mcp`](/docs/pt/mcp), e ações de autenticação MCP funcionam em uma sessão em background enquanto um terminal está anexado, e são recusadas apenas quando ninguém está anexado, com uma mensagem dizendo para você anexar e executar o comando novamente; de v2.1.208 até v2.1.212 eles foram recusados mesmo com um terminal anexado. |

1141| v2.1.212 | [`/fork` em uma sessão interativa](#from-inside-a-session) copia a conversa em uma nova sessão em background que aparece como sua própria linha, nomeada após a sessão de onde veio ou, para um fork solicitado de uma sessão sem nome, após o prompt do fork, enquanto a original continua em execução; o comportamento anterior de subagente forked de `/fork` se moveu para `/subtask`. Com [agent view desativado](#turn-off-agent-view), `/fork` mantém o comportamento de subagente forked. Uma linha focada que está aguardando seu primeiro prompt mostra `space to send it a prompt`. `Ctrl+J` insere uma nova linha na entrada de despacho em terminais com relatório de chave estendido, onde o pressionamento de chave foi previamente ignorado, e a sobreposição `?` lista o atalho. A dica de rodapé `←` em uma sessão interativa brevemente mostra `N done` quando uma sessão em background termina enquanto nenhuma precisa de sua entrada. Digitar um `/resume` simples em agent view abre um seletor de sessões passadas do repositório de onde você abriu agent view, incluindo sessões deletadas da lista, e escolher uma a retoma como uma sessão em background; antes desta versão `/resume` não estava disponível em agent view e sessões deletadas eram alcançáveis apenas com `claude --resume` ou `/resume` de uma sessão interativa. Formulários direcionados, com escopo e restritos mantêm a dica `attach to a session to run it` que versões anteriores mostravam para cada formulário. Sessões aguardando um prompt de rede-host de sandbox, uma solicitação de entrada MCP, ou um prompt de configurações gerenciadas mostram como `Needs input` em vez de `Working`, em agent view e em `claude agents --json`, e uma pergunta de Claude relata `waitingFor: input needed` em vez de `permission prompt`. Anexar a uma sessão cujo processo parou mostra sua transcrição formatada da forma que a sessão ao vivo a renderiza, em vez de como texto bruto. Uma sessão parada cuja transcrição está em um lugar inesperado retoma a partir dela via uma varredura de último recurso de suas transcrições salvas, e abrir uma linha que não tem transcrição salva mostra `Press enter again to restart this session fresh`, reiniciando-a fresca na segunda pressão; v2.1.211 mostrou a recusa sem forma de reiniciar a partir de agent view. |1144| v2.1.212 | [`/fork` em uma sessão interativa](#from-inside-a-session) copia a conversa em uma nova sessão em background que aparece como sua própria linha, nomeada após a sessão de onde veio ou, para um fork solicitado de uma sessão sem nome, após o prompt do fork, enquanto a original continua em execução; o comportamento anterior de subagente forked de `/fork` se moveu para `/subtask`. Com [agent view desativado](#turn-off-agent-view), `/fork` mantém o comportamento de subagente forked. Uma linha focada que está aguardando seu primeiro prompt mostra `space to send it a prompt`. `Ctrl+J` insere uma nova linha na entrada de despacho em terminais com relatório de tecla estendido, onde o pressionamento de tecla foi previamente ignorado, e a sobreposição `?` lista o atalho. A dica de rodapé `←` em uma sessão interativa brevemente mostra `N done` quando uma sessão em background termina enquanto nenhuma precisa de sua entrada. Digitar um `/resume` simples em agent view abre um seletor de sessões passadas do repositório de onde você abriu agent view, incluindo sessões deletadas da lista, e escolher uma a retoma como uma sessão em background; antes desta versão `/resume` não estava disponível em agent view e sessões deletadas eram alcançáveis apenas com `claude --resume` ou `/resume` de uma sessão interativa. Formas direcionadas, com escopo e restritas mantêm a dica `attach to a session to run it` que versões anteriores mostravam para cada forma. Sessões aguardando um prompt de rede-host de sandbox, uma solicitação de entrada MCP, ou um prompt de configurações gerenciadas mostram como `Needs input` em vez de `Working`, em agent view e em `claude agents --json`, e uma pergunta de Claude relata `waitingFor: input needed` em vez de `permission prompt`. Anexar a uma sessão cujo processo parou mostra sua transcrição formatada da forma que a sessão ao vivo a renderiza, em vez de como texto bruto. Uma sessão parada cuja transcrição está em um lugar inesperado retoma a partir dela via uma varredura de último recurso de suas transcrições salvas, e abrir uma linha que não tem transcrição salva mostra `Press enter again to restart this session fresh`, reiniciando-a do zero na segunda pressão; v2.1.211 mostrou a recusa sem forma de reiniciar a partir de agent view. |

1142| v2.1.211 | Acordar uma sessão parada anexando ou respondendo do diretório em que ela é executada encaminha novamente o gateway `ANTHROPIC_BASE_URL` do seu shell, sob as mesmas condições que um despacho fresco, então uma sessão autenticada através de um gateway `ANTHROPIC_AUTH_TOKEN` retoma no gateway em vez de relatar `Not logged in`. Anexar a uma sessão parada que foi colocada em background de outra conversa antes de sua primeira resposta terminar é recusado com `This session has no saved transcript` em vez de silenciosamente iniciar uma conversa em branco sob o mesmo session id; abrir a mesma linha a partir de agent view mostrou a recusa no rodapé. Terminar o processo de uma sessão `←` ou `/background` de fora do Claude Code a marca como parada em vez do supervisor reiniciá-la, uma parada já registrada no disco é honrada a menos que uma resposta que você enviou ainda esteja aguardando ser entregue, uma sessão reiniciada após um crash é informada que foi reiniciada, e uma sessão `←` ou `/background` reiniciada não retoma uma resposta interrompida mais antiga que cerca de uma hora. Uma resposta de nomeação de sessão que responde ou recusa o prompt em vez de rotulá-lo, como para um prompt que é principalmente um link, é descartada e a linha mantém um nome tirado do texto do prompt. Deletar uma sessão cujo git de worktree não reconhece mais tem sucesso, deixando o diretório de worktree no disco e nomeando seu caminho, em vez de cada tentativa ser recusada. Uma exclusão recusada mostra o motivo na linha da sessão, incluindo o erro git subjacente quando o worktree não pôde ser removido, em vez de a linha silenciosamente reaparecer. |1145| v2.1.211 | Acordar uma sessão parada anexando ou respondendo do diretório em que ela é executada encaminha novamente o gateway `ANTHROPIC_BASE_URL` do seu shell, sob as mesmas condições que um despacho fresco, então uma sessão autenticada através de um gateway `ANTHROPIC_AUTH_TOKEN` retoma no gateway em vez de relatar `Not logged in`. Anexar a uma sessão parada que foi colocada em background de outra conversa antes de sua primeira resposta terminar é recusado com `This session has no saved transcript` em vez de silenciosamente iniciar uma conversa em branco sob o mesmo session id; abrir a mesma linha a partir de agent view mostrou a recusa no rodapé. Terminar o processo de uma sessão `←` ou `/background` de fora do Claude Code a marca como parada em vez do supervisor reiniciá-la, uma parada já registrada no disco é honrada a menos que uma resposta que você enviou ainda esteja aguardando ser entregue, uma sessão reiniciada após um crash é informada que foi reiniciada, e uma sessão `←` ou `/background` reiniciada não retoma uma resposta interrompida mais antiga que cerca de uma hora. Uma resposta de nomeação de sessão que responde ou recusa o prompt em vez de rotulá-lo, como para um prompt que é principalmente um link, é descartada e a linha mantém um nome tirado do texto do prompt. Deletar uma sessão cujo worktree o git não reconhece mais tem sucesso, deixando o diretório de worktree no disco e nomeando seu caminho, em vez de cada tentativa ser recusada. Uma exclusão recusada mostra o motivo na linha da sessão, incluindo o erro git subjacente quando o worktree não pôde ser removido, em vez de a linha silenciosamente reaparecer. |

1143| v2.1.210 | `claude attach` aguarda enquanto o serviço de background está iniciando ou reconectando em vez de falhar com um erro `job not found` ou `still starting`, relata uma sessão que terminou durante o anexo como saída, e aplica um redimensionamento de terminal feito durante um anexo lento quando o anexo é concluído. A contagem de necessidades de entrada `←` do rodapé do prompt aparece em cada provedor, incluindo provedores de terceiros que anteriormente mostravam o formulário simples `← for agents`. Colocar uma sessão em background com `←` carrega a lista de tarefas de Claude para a sessão em background em vez de descartá-la. A linha em que você pressionou `←` mantém um nome em negrito, não atenuado após a seleção se mover. `claude agents --effort` aceita `ultracode` em vez de silenciosamente descartá-lo. |1146| v2.1.210 | `claude attach` aguarda enquanto o serviço de background está iniciando ou reconectando em vez de falhar com um erro `job not found` ou `still starting`, relata uma sessão que terminou durante o anexo como saída, e aplica um redimensionamento de terminal feito durante um anexo lento quando o anexo é concluído. A contagem de necessidades de entrada `←` do rodapé do prompt aparece em cada provedor, incluindo provedores de terceiros que anteriormente mostravam a forma simples `← for agents`. Colocar uma sessão em background com `←` carrega a lista de tarefas de Claude para a sessão em background em vez de descartá-la. A linha em que você pressionou `←` mantém um nome em negrito, não atenuado após a seleção se mover. `claude agents --effort` aceita `ultracode` em vez de silenciosamente descartá-lo. |

1144| v2.1.208 | Anexar a uma sessão cujo processo parou mostra a última tela cheia de sua transcrição enquanto o processo inicia, em vez de apenas uma nota de `Session is starting`. Uma resposta que não pode ser entregue porque o serviço de fundo está inacessível ou o envio falha é salva e enviada como o próximo prompt da sessão quando seu processo inicia novamente; antes desta versão, uma resposta perdida enquanto o serviço de fundo estava inacessível era descartada. Um processo cujo próprio binário foi substituído por uma atualização ainda pode iniciar o supervisor, a partir do inicializador `claude` instalado ou da versão mais recente no disco, em vez de falhar até que Claude Code fosse reiniciado. Um supervisor executando uma versão mais antiga nunca reinicia uma sessão ociosa iniciada por uma versão mais nova em seu próprio binário mais antigo. Deletar uma sessão remove seu worktree mesmo depois que a sessão moveu o worktree para uma branch diferente, e mantém o worktree junto com a linha da sessão quando o worktree tem commits que não foram enviados para lugar nenhum ou outra sessão o reclama, em vez de destruir os commits ou deixar o worktree órfão. `/install-github-app` e a lista de configurações `/mcp` e suas ações de autenticação são recusadas em uma sessão de fundo com uma mensagem nomeando a alternativa; em v2.1.208 apenas, o seletor `/model` foi recusado da mesma forma e um `/model <name>` digitado mudou apenas essa sessão em vez de também salvar seu modelo padrão. |1147| v2.1.208 | Anexar a uma sessão cujo processo parou mostra a última tela cheia de sua transcrição enquanto o processo inicia, em vez de apenas uma nota de `Session is starting`. Uma resposta que não pode ser entregue porque o serviço de fundo está inacessível ou o envio falha é salva e enviada como o próximo prompt da sessão quando seu processo inicia novamente; antes desta versão, uma resposta perdida enquanto o serviço de fundo estava inacessível era descartada. Um processo cujo próprio binário foi substituído por uma atualização ainda pode iniciar o supervisor, a partir do inicializador `claude` instalado ou da versão mais recente no disco, em vez de falhar até que Claude Code fosse reiniciado. Um supervisor executando uma versão mais antiga nunca reinicia uma sessão ociosa iniciada por uma versão mais nova em seu próprio binário mais antigo. Deletar uma sessão remove seu worktree mesmo depois que a sessão moveu o worktree para um branch diferente, e mantém o worktree junto com a linha da sessão quando o worktree tem commits que não foram enviados para lugar nenhum ou outra sessão o reclama, em vez de destruir os commits ou deixar o worktree órfão. `/install-github-app` e a lista de configurações `/mcp` e suas ações de autenticação são recusadas em uma sessão de fundo com uma mensagem nomeando a alternativa; em v2.1.208 apenas, o seletor `/model` foi recusado da mesma forma e um `/model <name>` digitado mudou apenas essa sessão em vez de também salvar seu modelo padrão. |

1145| v2.1.207 | O painel de espiada abre com a sentença que a linha trunca, como a pergunta exata para uma sessão que está aguardando você, e mostra quanto tempo uma sessão bloqueada está aguardando como uma única linha `waiting 3m` em vez de prefixar o mesmo timestamp para a sentença de status e a pergunta. Colar o mesmo texto novamente na entrada de despacho expande o placeholder `[Pasted text #N]` colapsado em vez de adicionar um segundo. Uma sessão em background nomeada ao aceitar um plano mostra esse nome em sua linha. Uma sessão em background que se moveu para um worktree mantém sua conversa quando seu processo é reiniciado a partir de agent view. |1148| v2.1.207 | O painel de espiada abre com a sentença que a linha trunca, como a pergunta exata para uma sessão que está aguardando você, e mostra quanto tempo uma sessão bloqueada está aguardando como uma única linha `waiting 3m` em vez de prefixar o mesmo timestamp para a sentença de status e a pergunta. Colar o mesmo texto novamente na entrada de despacho expande o placeholder `[Pasted text #N]` colapsado em vez de adicionar um segundo. Uma sessão em background nomeada ao aceitar um plano mostra esse nome em sua linha. Uma sessão em background que se moveu para um worktree mantém sua conversa quando seu processo é reiniciado a partir de agent view. |

1146| v2.1.206 | Resumos de linha preenchem a largura restante da linha e truncam apenas na borda direita do terminal em vez de em 64 colunas. Depois que o supervisor reinicia em uma nova versão do Claude Code, ele reinicia as sessões em background ociosas restantes nessa versão em background em vez de algumas por minuto. Deletar uma sessão com `Ctrl+X` ou `claude rm` também a limpa da lista de sessão do supervisor, para que a linha não reapareça mais após um reinício do supervisor. Um override de corpo de solicitação `CLAUDE_CODE_EXTRA_BODY` exportado no shell de despacho alcança sessões em background em vez de ser ignorado. |1149| v2.1.206 | Resumos de linha preenchem a largura restante da linha e truncam apenas na borda direita do terminal em vez de em 64 colunas. Depois que o supervisor reinicia em uma nova versão do Claude Code, ele reinicia as sessões em background ociosas restantes nessa versão em background em vez de algumas por minuto. Deletar uma sessão com `Ctrl+X` ou `claude rm` também a limpa da lista de sessão do supervisor, para que a linha não reapareça mais após um reinício do supervisor. Uma substituição do corpo da requisição `CLAUDE_CODE_EXTRA_BODY` exportada no shell de despacho alcança sessões em background em vez de ser ignorada. |

1147| v2.1.205 | A dica `←` do rodapé do prompt em uma sessão regular `claude` conta os agentes em background aguardando você, como `← 2 agents`. Resumos de linha mostram o relatório de uma linha da própria sessão, truncado em 64 colunas, em vez de uma invocação de ferramenta bruta ou uma contagem `done/total`; linhas agrupadas por diretório abrem com uma palavra de estado colorida. O painel de espiada abre com a sentença de status completa e, para uma sessão aguardando você, sua pergunta exata acima da entrada de resposta. Sessões que editam, comentam, fecham ou marcam um pull request como pronto com `gh` estão vinculadas a ele, não apenas aquelas que criam ou fazem checkout de um pull request, um push vincula um pull request mesmo quando o nome da branch local não corresponde, e um pull request cuja saída do comando de criação excedeu o limite inline também está vinculado. Um turno sem texto legível mantém o estado anterior da sessão em vez de revertê-lo para `Working`. `claude attach` aguarda até cerca de 60 segundos por uma sessão que está reiniciando, com uma linha de status nomeando o motivo, em vez de falhar. |1150| v2.1.205 | A dica `←` do rodapé do prompt em uma sessão regular `claude` conta os agentes em background aguardando você, como `← 2 agents`. Resumos de linha mostram o relatório de uma linha da própria sessão, truncado em 64 colunas, em vez de uma invocação de ferramenta bruta ou uma contagem `done/total`; linhas agrupadas por diretório abrem com uma palavra de estado colorida. O painel de espiada abre com a sentença de status completa e, para uma sessão aguardando você, sua pergunta exata acima da entrada de resposta. Sessões que editam, comentam, fecham ou marcam um pull request como pronto com `gh` estão vinculadas a ele, não apenas aquelas que criam ou fazem checkout de um pull request, um push vincula um pull request mesmo quando o nome do branch local não corresponde, e um pull request cuja saída do comando de criação excedeu o limite inline também está vinculado. Um turno sem texto legível mantém o estado anterior da sessão em vez de revertê-lo para `Working`. `claude attach` aguarda até cerca de 60 segundos por uma sessão que está reiniciando, com uma linha de status nomeando o motivo, em vez de falhar. |

1148| v2.1.203 | Um gateway `ANTHROPIC_BASE_URL` exportado no shell de despacho alcança as sessões despachadas a partir dele no mesmo diretório quando o supervisor compartilha esse gateway environment, em vez de ser descartado enquanto a chave de API exportada junto com ele era mantida. O `PATH` do shell de despacho é aplicado a cada worker da sessão. Pressionar `←` enquanto subagentes estão em execução aguarda por eles em vez de reiniciá-los após dez segundos. A lista vazia sempre mostra os cabeçalhos da seção com uma descrição sob cada um. Digitar `@` na entrada de despacho também lista os git worktrees registrados do repositório de inicialização que vivem dentro de sua árvore de diretórios. Um esforço herdado da configuração `effortLevel` segue edições posteriores dessa configuração em vez de ser fixado no despacho. Abrir uma sessão parada cuja conversa já está aberta em outra sessão em execução é recusado com uma mensagem em vez de falhar na linha. Um comando que não está disponível em agent view deixa o texto digitado na entrada. Um hook `WorktreeCreate` que falha fora de um repositório git não bloqueia mais a sessão de editar arquivos. |1151| v2.1.203 | Um gateway `ANTHROPIC_BASE_URL` exportado no shell de despacho alcança as sessões despachadas a partir dele no mesmo diretório quando o supervisor compartilha esse ambiente de gateway, em vez de ser descartado enquanto a chave de API exportada junto com ele era mantida. O `PATH` do shell de despacho é aplicado a cada worker da sessão. Pressionar `←` enquanto subagentes estão em execução aguarda por eles em vez de reiniciá-los após dez segundos. A lista vazia sempre mostra os cabeçalhos da seção com uma descrição sob cada um. Digitar `@` na entrada de despacho também lista os git worktrees registrados do repositório de inicialização que vivem dentro de sua árvore de diretórios. Um esforço herdado da configuração `effortLevel` segue edições posteriores dessa configuração em vez de ser fixado no despacho. Abrir uma sessão parada cuja conversa já está aberta em outra sessão em execução é recusado com uma mensagem em vez de falhar na linha. Um comando que não está disponível em agent view deixa o texto digitado na entrada. Um hook `WorktreeCreate` que falha fora de um repositório git não bloqueia mais a sessão de editar arquivos. |

1149| v2.1.202 | Um nome definido com `/rename` ou `Ctrl+R` em uma sessão em background persiste quando o supervisor para e reinicia seu processo, em vez de reverter para o nome com o qual a sessão foi despachada. |1152| v2.1.202 | Um nome definido com `/rename` ou `Ctrl+R` em uma sessão em background persiste quando o supervisor para e reinicia seu processo, em vez de reverter para o nome com o qual a sessão foi despachada. |

1150| v2.1.200 | Uma versão mais antiga do Claude Code que reescreve a lista de sessão em `roster.json` preserva campos escritos por uma versão mais nova, correspondendo à garantia existente de `state.json`, para que sessões iniciadas pela versão mais nova continuem aceitando entrada após o supervisor reiniciar. Quando você abre uma sessão que parou de responder, o supervisor reinicia seu processo e a sessão continua a resposta interrompida de onde parou. Agent view aplica uma flag `--plugin-dir` colocada após `agents` a seu próprio subagente e autocomplete de skill na entrada de despacho assim como sessões despachadas. |1153| v2.1.200 | Uma versão mais antiga do Claude Code que reescreve a lista de sessão em `roster.json` preserva campos escritos por uma versão mais nova, correspondendo à garantia existente de `state.json`, para que sessões iniciadas pela versão mais nova continuem aceitando entrada após o supervisor reiniciar. Quando você abre uma sessão que parou de responder, o supervisor reinicia seu processo e a sessão continua a resposta interrompida de onde parou. Agent view aplica uma flag `--plugin-dir` colocada após `agents` a seu próprio autocomplete de subagentes e skills na entrada de despacho assim como a sessões despachadas. |

1151| v2.1.199 | Uma sessão em background cujo processo sai antes de terminar de iniciar em um host com pouca memória mostra `possibly low memory — free some up and retry` no status de sua linha em vez de apenas o motivo de saída simples. Colocar uma sessão em background com `←` ou `/background` carrega seu `/color` para a nova linha. |1154| v2.1.199 | Uma sessão em background cujo processo sai antes de terminar de iniciar em um host com pouca memória RAM mostra `possibly low memory — free some up and retry` no status de sua linha em vez de apenas o motivo de saída simples. Colocar uma sessão em background com `←` ou `/background` carrega seu `/color` para a nova linha. |

1152| v2.1.198 | Agent view envia uma notificação através de `preferredNotifChannel` quando uma sessão em background precisa de entrada, termina ou falha, e dispara o hook `Notification` com o tipo `agent_needs_input` ou `agent_completed`. `←` e `/exit` dentro de `claude attach <id>` retornam para agent view em vez de sair para o shell; `Ctrl+Z` retorna para o shell. Uma sessão em background que isolou seu trabalho em um worktree faz commit, envia seu próprio branch isolado, nunca `main` ou `master`, e abre um pull request em rascunho quando termina em vez de perguntar primeiro. `/login` é executado em agent view e abre o diálogo de entrada. O diálogo de saída `Background work is running` oferece `Move to background and exit`. A entrega de saída também cobre subagentes em background, que retomam de sua transcrição no próximo despertar em vez de serem relatados como falhados. `claude --bg` combinado com `-p` ou `--print` é rejeitado com um erro. O host da sessão em background solicita permissão de Rede Local do macOS no primeiro acesso LAN em vez de falhar com `connect: no route to host`. |1155| v2.1.198 | Agent view envia uma notificação através de `preferredNotifChannel` quando uma sessão em background precisa de entrada, termina ou falha, e dispara o hook `Notification` com o tipo `agent_needs_input` ou `agent_completed`. `←` e `/exit` dentro de `claude attach <id>` retornam para agent view em vez de sair para o shell; `Ctrl+Z` retorna para o shell. Uma sessão em background que isolou seu trabalho em um worktree faz commit, envia seu próprio branch isolado, nunca `main` ou `master`, e abre um pull request em rascunho quando termina em vez de perguntar primeiro. `/login` é executado em agent view e abre o diálogo de entrada. O diálogo de saída `Background work is running` oferece `Move to background and exit`. A entrega de saída também cobre subagentes em background, que retomam de sua transcrição no próximo despertar em vez de serem relatados como falhados. `claude --bg` combinado com `-p` ou `--print` é rejeitado com um erro. O host da sessão em background solicita permissão de Rede Local do macOS no primeiro acesso LAN em vez de falhar com `connect: no route to host`. |

1153| v2.1.196 | Um único pressionamento de `←` coloca em background uma sessão em primeiro plano; versões anteriores exigiam dois pressionamentos, com uma dica de rodapé e uma confirmação. `--dangerously-skip-permissions` passado para `claude agents` mostra o aviso de bypass em vez de ser silenciosamente descartado. Sessões interativas que você nunca nomeou carregam um nome padrão como `my-app-3f` em listagens de sessão e `claude agents --json`. Comandos shell em background e workflows dinâmicos sobrevivem ao processo da sessão sendo interrompido, reiniciado ou atualizado, incluindo no Windows; defina `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desativar a entrega. Um transcript lido mal como vazio no reinício é renomeado com um sufixo `.orphaned-` em vez de ser deletado. |1156| v2.1.196 | Um único pressionamento de `←` coloca em background uma sessão em primeiro plano; versões anteriores exigiam dois pressionamentos, com uma dica de rodapé e uma confirmação. `--dangerously-skip-permissions` passado para `claude agents` mostra o aviso de bypass em vez de ser silenciosamente descartado. Sessões interativas que você nunca nomeou carregam um nome padrão como `my-app-3f` em listagens de sessão e `claude agents --json`. Comandos shell em background e fluxos de trabalho dinâmicos sobrevivem ao processo da sessão sendo interrompido, reiniciado ou atualizado, incluindo no Windows; defina `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desativar a entrega. Uma transcrição lida incorretamente como vazia no reinício é renomeada com um sufixo `.orphaned-` em vez de ser deletada. |

1154| v2.1.195 | O trabalho em andamento é transferido quando você coloca em background uma sessão no Windows também; defina `CLAUDE_DISABLE_ADOPT=1` para interrompê-lo em vez disso. O grupo `Completed` preenche o espaço vertical restante e o cabeçalho se compacta em terminais curtos. Uma versão mais antiga do Claude Code não descarta mais campos `state.json` mais novos ou oculta essas sessões de `claude agents`. Anexar a uma sessão parada muda imediatamente em vez de mostrar uma tela em branco por até cinco segundos. Um supervisor que não consegue aceitar conexões sai e libera seu bloqueio por conta própria. |1157| v2.1.195 | O trabalho em andamento é transferido quando você coloca em background uma sessão no Windows também; defina `CLAUDE_DISABLE_ADOPT=1` para interrompê-lo em vez disso. O grupo `Completed` preenche o espaço vertical restante e o cabeçalho se compacta em terminais curtos. Uma versão mais antiga do Claude Code não descarta mais campos `state.json` de sessões mais novas nem oculta essas sessões de `claude agents`. Anexar a uma sessão parada muda imediatamente em vez de mostrar uma tela em branco por até cinco segundos. Um supervisor que não consegue aceitar conexões sai e libera seu bloqueio por conta própria. |

1155| v2.1.191 | `claude --bg` com um nome `--agent` que não corresponde a nenhum de seus subagentes falha no lançamento: a sessão sai imediatamente com um erro `--agent '<name>' not found` em vez de executar com o agente padrão. |1158| v2.1.191 | `claude --bg` com um nome `--agent` que não corresponde a nenhum de seus subagentes falha no lançamento: a sessão sai imediatamente com um erro `--agent '<name>' not found` em vez de executar com o agente padrão. |

1156| v2.1.174 | Sessões em background não herdam mais variáveis de endpoint de gateway como `ANTHROPIC_BASE_URL` do shell de inicialização do supervisor; o supervisor fornece um snapshot de credencial fresco para workers pré-aquecidos, corrigindo erros espúrios de `Could not resolve authentication method`. |1159| v2.1.174 | Sessões em background não herdam mais variáveis de endpoint de gateway como `ANTHROPIC_BASE_URL` do shell de inicialização do supervisor; o supervisor fornece um snapshot de credenciais fresco para workers pré-aquecidos, corrigindo erros espúrios de `Could not resolve authentication method`. |

1157| v2.1.172 | `/model` na entrada de despacho define uma substituição de modelo de despacho com escopo de sessão. |1160| v2.1.172 | `/model` na entrada de despacho define uma substituição de modelo de despacho com escopo de sessão. |

1158| v2.1.161 | Resumos de linha mostram uma contagem `done/total` para itens de trabalho paralelos; o painel de espiada nomeia o item de trabalho paralelo que está em execução há mais tempo. |1161| v2.1.161 | Resumos de linha mostram uma contagem `done/total` para itens de trabalho paralelos; o painel de espiada nomeia o item de trabalho paralelo que está em execução há mais tempo. |

1159| v2.1.157 | `claude agents` aceita `--agent`; sessões despachadas honram a configuração `agent`. |1162| v2.1.157 | `claude agents` aceita `--agent`; sessões despachadas honram a configuração `agent`. |

1160| v2.1.145 | Voice dictation suportada na entrada de resposta do painel de espiada e na entrada de despacho. |1163| v2.1.145 | Ditado por voz suportado na entrada de resposta do painel de espiada e na entrada de despacho. |

1161| v2.1.143 | Configuração `worktree.bgIsolation` adicionada; `claude agents` aceita `--allow-dangerously-skip-permissions`. |1164| v2.1.143 | Configuração `worktree.bgIsolation` adicionada; `claude agents` aceita `--allow-dangerously-skip-permissions`. |

1162| v2.1.142 | `claude agents` aceita `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` e `--strict-mcp-config`. |1165| v2.1.142 | `claude agents` aceita `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` e `--strict-mcp-config`. |

1163| v2.1.141 | `claude agents` aceita `--cwd` para escopar a lista a um projeto. |1166| v2.1.141 | `claude agents` aceita `--cwd` para restringir a lista a um projeto. |

1164| v2.1.139 | Agent view introduzido como uma visualização de pesquisa. |1167| v2.1.139 | Agent view introduzido como uma prévia de pesquisa. |

Details

147 147 

148* **Referencie arquivos com `@`** em vez de descrever onde o código vive. Claude lê o arquivo antes de responder.148* **Referencie arquivos com `@`** em vez de descrever onde o código vive. Claude lê o arquivo antes de responder.

149* **Cole imagens diretamente**. Copie/cole ou arraste e solte imagens no prompt.149* **Cole imagens diretamente**. Copie/cole ou arraste e solte imagens no prompt.

150* **Forneça URLs** para documentação e referências de API. Use `/permissions` para colocar na lista de permissões domínios frequentemente usados.150* **Forneça URLs** para documentação e referências de API. Use `/permissions` para adicionar à allowlist domínios frequentemente usados.

151* **Canalize dados** executando `cat error.log | claude -p "explain this error"` para enviar conteúdos de arquivo diretamente.151* **Canalize dados** executando `cat error.log | claude -p "explain this error"` para enviar conteúdos de arquivo diretamente.

152* **Deixe Claude buscar o que precisa**. Diga ao Claude para puxar contexto ele mesmo usando comandos Bash, ferramentas MCP ou lendo arquivos.152* **Deixe Claude buscar o que precisa**. Diga ao Claude para puxar contexto ele mesmo usando comandos Bash, ferramentas MCP ou lendo arquivos.

153 153 

channels.md +4 −4

Details

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

48 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.48 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.

49 49 

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

51 </Step>51 </Step>

52 52 

53 <Step title="Configurar seu token">53 <Step title="Configurar seu token">


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

126 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.126 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.

127 127 

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

129 </Step>129 </Step>

130 130 

131 <Step title="Configurar seu token">131 <Step title="Configurar seu token">


192 192 

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

194 194 

195 Se o resumo da instalação relatar `Run /reload-plugins to activate.`, você não precisa agir sobre isso aqui, porque reiniciar na próxima etapa pega o plugin.195 Se o resumo da instalação relatar `Run /reload-plugins to apply.`, você não precisa agir sobre isso aqui, porque reiniciar na próxima etapa pega o plugin.

196 </Step>196 </Step>

197 197 

198 <Step title="Reiniciar com canais habilitados">198 <Step title="Reiniciar com canais habilitados">


251 251 

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

253 253 

254 Se o resumo da instalação relatar `Run /reload-plugins to activate.`, você não precisa agir sobre isso aqui, porque reiniciar na próxima etapa seleciona o plugin.254 Se o resumo da instalação relatar `Run /reload-plugins to apply.`, você não precisa agir sobre isso aqui, porque reiniciar na próxima etapa carrega o plugin.

255 </Step>255 </Step>

256 256 

257 <Step title="Reiniciar com o canal habilitado">257 <Step title="Reiniciar com o canal habilitado">

Details

193claude --dangerously-load-development-channels server:webhook193claude --dangerously-load-development-channels server:webhook

194```194```

195 195 

196Execute a flag de desenvolvimento em uma sessão interativa, onde o Claude Code pode exibir o prompt de confirmação. Se você a passar no modo não interativo com `-p` ou por meio do Agent SDK, o Claude Code ignora a flag e o canal não é registrado.

197 

196O bypass é por entrada. Combinar esta flag com `--channels` não estende o bypass para as entradas `--channels`. Durante a visualização de pesquisa, seu channel não está na lista de aprovação, portanto permanece na flag de desenvolvimento enquanto você constrói e testa.198O bypass é por entrada. Combinar esta flag com `--channels` não estende o bypass para as entradas `--channels`. Durante a visualização de pesquisa, seu channel não está na lista de aprovação, portanto permanece na flag de desenvolvimento enquanto você constrói e testa.

197 199 

198<Note>200<Note>

Details

35 Se o campo de entrada de prompt contiver texto, duplo `Esc` o limpa em vez de abrir o menu. O texto limpo é salvo no seu histórico de entrada, então pressione `Up` para recuperá-lo após terminar no menu de rewind.35 Se o campo de entrada de prompt contiver texto, duplo `Esc` o limpa em vez de abrir o menu. O texto limpo é salvo no seu histórico de entrada, então pressione `Up` para recuperá-lo após terminar no menu de rewind.

36</Note>36</Note>

37 37 

38O menu de rewind lista cada prompt que você enviou durante a sessão, exceto [mensagens que se juntaram a um turno em andamento](#messages-sent-mid-turn-not-checkpointed). Selecione o ponto em que deseja agir e escolha uma ação:38O menu de rewind lista os prompts que você enviou durante a sessão. Selecione o ponto em que deseja agir e escolha uma ação:

39 39 

40* **Restaurar código e conversa**: reverte tanto o código quanto a conversa para esse ponto40* **Restaurar código e conversa**: reverte tanto o código quanto a conversa para esse ponto

41* **Restaurar conversa**: reverte para essa mensagem mantendo o código atual41* **Restaurar conversa**: reverte para essa mensagem mantendo o código atual


114 Mensagens enviadas no meio do turno não checkpointed114 Mensagens enviadas no meio do turno não checkpointed

115</h3>115</h3>

116 116 

117Quando uma mensagem que você [enfileira enquanto Claude trabalha](/docs/pt/interactive-mode#queue-messages-while-claude-works) chega ao Claude dentro do turno em execução, ela se junta a esse turno em vez de iniciar um novo. A mensagem aparece na conversa, mas Claude Code não cria um checkpoint para ela, e o menu de rewind não a lista. Uma mensagem enfileirada que Claude Code envia como parte de um novo turno recebe um checkpoint como de costume, incluindo quando várias mensagens enfileiradas [compartilham esse turno](/docs/pt/interactive-mode#when-claude-code-sends-what-you-queued).117Quando uma mensagem que você [enfileira enquanto Claude trabalha](/docs/pt/interactive-mode#queue-messages-while-claude-works) chega ao Claude dentro do turno em execução, ela se junta a esse turno em vez de iniciar um novo. A mensagem aparece na conversa, mas Claude Code não cria um checkpoint para ela. Uma mensagem enfileirada que Claude Code envia como parte de um novo turno recebe um checkpoint como de costume, incluindo quando várias mensagens enfileiradas [compartilham esse turno](/docs/pt/interactive-mode#when-claude-code-sends-what-you-queued).

118 118 

119Para remover tal mensagem, ou desfazer as edições que Claude fez depois dela, faça rewind para o prompt que iniciou o turno. Isso faz rewind de todo o turno, incluindo o trabalho que Claude fez antes de sua mensagem chegar.119Para desfazer as edições que Claude fez depois de tal mensagem, faça rewind para o prompt que iniciou o turno. Isso faz rewind de todo o turno, incluindo o trabalho que Claude fez antes de sua mensagem chegar.

120 120 

121<h3 id="symlinked-and-hard-linked-paths-not-restored">121<h3 id="symlinked-and-hard-linked-paths-not-restored">

122 Caminhos symlinked e hard-linked não restaurados122 Caminhos symlinked e hard-linked não restaurados

chrome.md +2 −0

Details

45* [Claude Code](/docs/pt/quickstart#step-1-install-claude-code)45* [Claude Code](/docs/pt/quickstart#step-1-install-claude-code)

46* Um plano Anthropic direto (Pro, Max, Team ou Enterprise)46* Um plano Anthropic direto (Pro, Max, Team ou Enterprise)

47 47 

48Em organizações Enterprise que têm HIPAA habilitado, o Claude in Chrome fica desativado por padrão, e um [Owner](/docs/pt/server-managed-settings#access-control) pode ativá-lo em [**Organization settings > Claude in Chrome**](https://claude.ai/admin-settings/browser-extension). Seu Business Associate Agreement (BAA) com a Anthropic não cobre dados enviados a sites de terceiros através do Claude in Chrome. Consulte o [Guia de Implementação](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para obter uma lista de Serviços Elegíveis.

49 

48A integração com Chrome também requer fazer login com `/login`. Se você se autenticar com uma chave de API ou um token de longa duração de [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token), Claude Code mantém a integração com Chrome desativada, mesmo quando você passa `--chrome`, porque a extensão do navegador não consegue se autenticar com essas credenciais. Antes da v2.1.216, essas sessões poderiam ativar a integração com Chrome, mas cada tentativa de conexão com a extensão do navegador falhava com um erro 403.50A integração com Chrome também requer fazer login com `/login`. Se você se autenticar com uma chave de API ou um token de longa duração de [`claude setup-token`](/docs/pt/authentication#generate-a-long-lived-token), Claude Code mantém a integração com Chrome desativada, mesmo quando você passa `--chrome`, porque a extensão do navegador não consegue se autenticar com essas credenciais. Antes da v2.1.216, essas sessões poderiam ativar a integração com Chrome, mas cada tentativa de conexão com a extensão do navegador falhava com um erro 403.

49 51 

50<Note>52<Note>

Details

64Consulte [Conectar a partir do seu terminal](/docs/pt/web-quickstart#connect-from-your-terminal) para o passo a passo de `/web-setup`, incluindo o que `/web-setup` armazena e como removê-lo.64Consulte [Conectar a partir do seu terminal](/docs/pt/web-quickstart#connect-from-your-terminal) para o passo a passo de `/web-setup`, incluindo o que `/web-setup` armazena e como removê-lo.

65 65 

66<Note>66<Note>

67 Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado não podem usar `/web-setup` ou outros recursos de sessão em nuvem.67 Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado, ou com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada, não podem usar `/web-setup` ou outros recursos de sessão na nuvem.

68</Note>68</Note>

69 69 

70<h3 id="quick-setup-for-team-and-enterprise">70<h3 id="quick-setup-for-team-and-enterprise">

Details

1582 Em vez disso, Claude Code deleta essas transcrições após `cleanupPeriodDays` em qualquer um destes casos:1582 Em vez disso, Claude Code deleta essas transcrições após `cleanupPeriodDays` em qualquer um destes casos:

1583 1583 

1584 * [Configurações gerenciadas](/docs/pt/managed-settings) definem `cleanupPeriodDays`1584 * [Configurações gerenciadas](/docs/pt/managed-settings) definem `cleanupPeriodDays`

1585 * Sua organização tem a configuração HIPAA aplicada e Claude Code se conecta diretamente à Claude API1585 * A [configuração HIPAA se aplica às suas sessões](/docs/pt/hipaa-setup#check-how-developers-sign-in-and-connect)

1586 1586 

1587Claude Code pula a varredura baseada em idade nestes casos:1587Claude Code pula a varredura baseada em idade nestes casos:

1588 1588 


1619 1619 

1620| Caminho sob `~/.claude/` | Conteúdo |1620| Caminho sob `~/.claude/` | Conteúdo |

1621| - | - |1621| - | - |

1622| `history.jsonl` | Cada prompt que você digitou, com timestamp e caminho do projeto. Usado para recall de seta para cima, busca de histórico `Ctrl+R` e conclusão de comando shell `!`. Em uma organização com a configuração HIPAA aplicada, cada varredura remove as entradas mais antigas que `cleanupPeriodDays` quando Claude Code se conecta diretamente à Claude API. |1622| `history.jsonl` | Cada prompt que você digitou, com timestamp e caminho do projeto. Usado para recall de seta para cima, busca de histórico `Ctrl+R` e conclusão de comando shell `!`. Cada varredura remove as entradas mais antigas que `cleanupPeriodDays` quando a [configuração HIPAA se aplica às suas sessões](/docs/pt/hipaa-setup#check-how-developers-sign-in-and-connect). |

1623| `stats-cache.json` | Contagens agregadas de token e custo mostradas por `/usage` |1623| `stats-cache.json` | Contagens agregadas de token e custo mostradas por `/usage` |

1624| `remote-settings.json` | Cópia em cache de [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) para sua organização, ou `{}` quando sua organização não configurou nenhuma. Presente apenas quando a sessão as [busca](/docs/pt/server-managed-settings#platform-availability). Claude Code verifica atualizações na inicialização e a cada hora durante uma sessão. Claude Code a deleta quando você faz logout. |1624| `remote-settings.json` | Cópia em cache de [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) para sua organização, ou `{}` quando sua organização não configurou nenhuma. Presente apenas quando a sessão as [busca](/docs/pt/server-managed-settings#platform-availability). Claude Code verifica atualizações na inicialização e a cada hora durante uma sessão. Claude Code a deleta quando você faz logout. |

1625| `cache/changelog.md` | Cópia em cache do changelog de Claude Code, mostrada por `/release-notes`. Atualizada em segundo plano. |1625| `cache/changelog.md` | Cópia em cache do changelog de Claude Code, mostrada por `/release-notes`. Atualizada em segundo plano. |

Details

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

54* Se relatar que não consegue [encontrar o plugin no marketplace](/docs/pt/plugins/install#install-a-plugin), verifique o nome do plugin para um erro de digitação.54* Se relatar que não consegue [encontrar o plugin no marketplace](/docs/pt/plugins/install#install-a-plugin), verifique o nome do plugin para um erro de digitação.

55 55 

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

57 57 

58Assim que o plugin estiver ativo, você está pronto para [digitalizar e corrigir seu repositório de código](#scan-and-fix-your-codebase).58Assim que o plugin estiver ativo, você está pronto para [digitalizar e corrigir seu repositório de código](#scan-and-fix-your-codebase).

59 59 

Details

28| `claude auth logout` | Fazer logout de sua conta Anthropic | `claude auth logout` |28| `claude auth logout` | Fazer logout de sua conta Anthropic | `claude auth logout` |

29| `claude auth status` | Mostrar status de autenticação como JSON. Use `--text` para saída legível por humanos. Sai com código 0 se conectado, 1 se não. O JSON inclui um campo `configDirectory` nomeando o [diretório de configuração](/docs/pt/claude-directory) que a CLI usa. O campo requer Claude Code v2.1.268 ou posterior. O campo `authMethod` do JSON é um de `none`, `claude.ai`, `oauth_token`, `api_key`, `api_key_helper` ou `third_party` | `claude auth status` |29| `claude auth status` | Mostrar status de autenticação como JSON. Use `--text` para saída legível por humanos. Sai com código 0 se conectado, 1 se não. O JSON inclui um campo `configDirectory` nomeando o [diretório de configuração](/docs/pt/claude-directory) que a CLI usa. O campo requer Claude Code v2.1.268 ou posterior. O campo `authMethod` do JSON é um de `none`, `claude.ai`, `oauth_token`, `api_key`, `api_key_helper` ou `third_party` | `claude auth status` |

30| `claude agents` | Abrir [visualização de agente](/docs/pt/agent-view) para monitorar e despachar sessões de fundo paralelas. Use `--cwd <path>` para mostrar apenas sessões iniciadas nesse diretório, ou `--json` para imprimir sessões ativas como um array JSON para scripts (`--json --all` também inclui sessões de fundo concluídas). Passe `--permission-mode`, `--model`, `--effort` ou `--agent` para definir [padrões para sessões despachadas](/docs/pt/agent-view#permission-mode-model-and-effort). Aceita `--settings`, `--add-dir`, `--plugin-dir` e `--mcp-config` como o comando `claude` de nível superior. Abrir visualização de agente requer um terminal interativo | `claude agents --json` |30| `claude agents` | Abrir [visualização de agente](/docs/pt/agent-view) para monitorar e despachar sessões de fundo paralelas. Use `--cwd <path>` para mostrar apenas sessões iniciadas nesse diretório, ou `--json` para imprimir sessões ativas como um array JSON para scripts (`--json --all` também inclui sessões de fundo concluídas). Passe `--permission-mode`, `--model`, `--effort` ou `--agent` para definir [padrões para sessões despachadas](/docs/pt/agent-view#permission-mode-model-and-effort). Aceita `--settings`, `--add-dir`, `--plugin-dir` e `--mcp-config` como o comando `claude` de nível superior. Abrir visualização de agente requer um terminal interativo | `claude agents --json` |

31| `claude attach <id>` | Anexar a uma [sessão de fundo](/docs/pt/agent-view#manage-sessions-from-the-shell) neste terminal | `claude attach 7c5dcf5d` |31| `claude attach <id\|name>` | Anexar a uma [sessão de fundo](/docs/pt/agent-view#manage-sessions-from-the-shell) neste terminal. Passar parte do nome de uma sessão em execução no lugar do ID requer Claude Code v2.1.290 ou posterior | `claude attach 7c5dcf5d` |

32| `claude auto-mode defaults` | Imprimir as regras do classificador do [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) integradas como JSON. Use `claude auto-mode config` para ver sua configuração efetiva com as configurações aplicadas. `--label <prefix>` imprime apenas as regras cujo rótulo começa com esse prefixo, correspondência sem distinção de maiúsculas e minúsculas. Requer Claude Code v2.1.208 ou posterior | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | Imprimir as regras do classificador do [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) integradas como JSON. Use `claude auto-mode config` para ver sua configuração efetiva com as configurações aplicadas. `--label <prefix>` imprime apenas as regras cujo rótulo começa com esse prefixo, correspondência sem distinção de maiúsculas e minúsculas. Requer Claude Code v2.1.208 ou posterior | `claude auto-mode defaults --label 'Git Destructive'` |

33| `claude auto-mode reset` | Restaurar a configuração padrão do [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) removendo a seção `autoMode` do seu arquivo de configurações do usuário. Solicita confirmação antes de escrever; passe `-y`/`--yes` para pular o prompt. As regras de [configurações gerenciadas](/docs/pt/server-managed-settings) ou a flag `--settings` ainda se aplicam. Requer Claude Code v2.1.212 ou posterior. Veja [Inspecionar os padrões e sua configuração efetiva](/docs/pt/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |33| `claude auto-mode reset` | Restaurar a configuração padrão do [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) removendo a seção `autoMode` do seu arquivo de configurações do usuário. Solicita confirmação antes de escrever; passe `-y`/`--yes` para pular o prompt. As regras de [configurações gerenciadas](/docs/pt/server-managed-settings) ou a flag `--settings` ainda se aplicam. Requer Claude Code v2.1.212 ou posterior. Veja [Inspecionar os padrões e sua configuração efetiva](/docs/pt/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |

34| `claude daemon status` | Imprimir o estado do [supervisor](/docs/pt/agent-view#the-supervisor-process) de sessão de fundo, versão, diretório de socket e contagem de workers para diagnósticos. Sai com 1 se o supervisor não estiver em execução | `claude daemon status` |34| `claude daemon status` | Imprimir o estado do [supervisor](/docs/pt/agent-view#the-supervisor-process) de sessão de fundo, versão, diretório de socket e contagem de workers para diagnósticos. Sai com 1 se o supervisor não estiver em execução | `claude daemon status` |

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

36| `claude doctor` | Imprimir diagnósticos de instalação e configurações somente leitura do terminal sem iniciar uma sessão, incluindo saúde da instalação, erros de validação de arquivo de configurações e elegibilidade de Remote Control. Para a verificação de configuração em sessão que também pode aplicar correções, execute [`/doctor`](/docs/pt/commands#all-commands) | `claude doctor` |36| `claude doctor` | Imprimir diagnósticos de instalação e configurações somente leitura do terminal sem iniciar uma sessão, incluindo saúde da instalação, erros de validação de arquivo de configurações e elegibilidade de Remote Control. Para a verificação de configuração em sessão que também pode aplicar correções, execute [`/doctor`](/docs/pt/commands#all-commands) | `claude doctor` |

37| `claude import [source]` | Iniciar uma sessão interativa que executa [`/import`](/docs/pt/commands#all-commands) para trazer configuração de outros agentes de codificação para Claude Code. Aceita as mesmas opções `--dry-run` e `--yes` do comando. Não disponível no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform na AWS. Também indisponível quando você desativa [busca de feature-flag](/docs/pt/env-vars#features-that-need-feature-flag-fetching). Requer Claude Code v2.1.213 ou posterior | `claude import codex --dry-run` |37| `claude import [source]` | Iniciar uma sessão interativa que executa [`/import`](/docs/pt/commands#all-commands) para trazer configuração de outros agentes de codificação para Claude Code. Aceita as mesmas opções `--dry-run` e `--yes` do comando. Não disponível no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform na AWS. Também indisponível quando você desativa [busca de feature-flag](/docs/pt/env-vars#features-that-need-feature-flag-fetching). Requer Claude Code v2.1.213 ou posterior | `claude import codex --dry-run` |

38| `claude logs <id>` | Imprimir saída recente de uma [sessão de fundo](/docs/pt/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |38| `claude logs <id\|name>` | Imprimir saída recente de uma [sessão de fundo](/docs/pt/agent-view#manage-sessions-from-the-shell). Passar parte do nome de uma sessão em execução no lugar do ID requer Claude Code v2.1.290 ou posterior | `claude logs 7c5dcf5d` |

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

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

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` |


80| `--chrome` | Ativar [integração do navegador Chrome](/docs/pt/chrome) para automação web e testes | `claude --chrome` |80| `--chrome` | Ativar [integração do navegador Chrome](/docs/pt/chrome) para automação web e testes | `claude --chrome` |

81| `--cloud` | Com uma descrição de tarefa, criar uma nova [sessão web](/docs/pt/claude-code-on-the-web). Com um ID de sessão (`session_...` ou `cse_...`) ou uma URL claude.ai/code, enfileirar uma mensagem nessa sessão existente em vez disso, com `-p`. Veja [enviar uma mensagem de acompanhamento](/docs/pt/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |81| `--cloud` | Com uma descrição de tarefa, criar uma nova [sessão web](/docs/pt/claude-code-on-the-web). Com um ID de sessão (`session_...` ou `cse_...`) ou uma URL claude.ai/code, enfileirar uma mensagem nessa sessão existente em vez disso, com `-p`. Veja [enviar uma mensagem de acompanhamento](/docs/pt/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |

82| `--continue`, `-c` | Carregar a conversa mais recente no diretório atual, incluindo uma [sessão de fundo que terminou](/docs/pt/sessions#resume-a-session); abrir sessões de fundo terminadas requer Claude Code v2.1.257 ou posterior. Pula sessões criadas com `claude -p` ou o Agent SDK, e sessões cujo primeiro prompt foi `/loop`. `claude -p --continue` inclui sessões `-p`, SDK e `/loop`. Inclui sessões que adicionaram este diretório com `/add-dir` | `claude --continue` |82| `--continue`, `-c` | Carregar a conversa mais recente no diretório atual, incluindo uma [sessão de fundo que terminou](/docs/pt/sessions#resume-a-session); abrir sessões de fundo terminadas requer Claude Code v2.1.257 ou posterior. Pula sessões criadas com `claude -p` ou o Agent SDK, e sessões cujo primeiro prompt foi `/loop`. `claude -p --continue` inclui sessões `-p`, SDK e `/loop`. Inclui sessões que adicionaram este diretório com `/add-dir` | `claude --continue` |

83| `--dangerously-load-development-channels` | Ativar [channels](/docs/pt/channels-reference#test-during-the-research-preview) que não estão na lista de permissões aprovada, para desenvolvimento local. Aceita entradas `plugin:<name>@<marketplace>` e `server:<name>`. Solicita confirmação | `claude --dangerously-load-development-channels server:webhook` |83| `--dangerously-load-development-channels` | Ativar [canais](/docs/pt/channels-reference#test-during-the-research-preview) que não estão na allowlist aprovada, para desenvolvimento local. Aceita entradas `plugin:<name>@<marketplace>` e `server:<name>`. Solicita confirmação, portanto entra em vigor em sessões interativas. Com `-p`, Claude Code ignora a flag | `claude --dangerously-load-development-channels server:webhook` |

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

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

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


104| `--input-format` | Especificar formato de entrada para modo print (opções: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |104| `--input-format` | Especificar formato de entrada para modo print (opções: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |

105| `--json-schema` | Obter saída JSON validada correspondendo a um JSON Schema após o agente completar seu fluxo de trabalho (apenas modo print). Veja [saídas estruturadas](/docs/pt/agent-sdk/structured-outputs). Claude Code sai com um erro em um schema inválido e aceita a palavra-chave `format` como uma anotação sem validação do lado do cliente | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |105| `--json-schema` | Obter saída JSON validada correspondendo a um JSON Schema após o agente completar seu fluxo de trabalho (apenas modo print). Veja [saídas estruturadas](/docs/pt/agent-sdk/structured-outputs). Claude Code sai com um erro em um schema inválido e aceita a palavra-chave `format` como uma anotação sem validação do lado do cliente | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

106| `--maintenance` | Executar hooks de [Setup](/docs/pt/hooks#setup) com o matcher `maintenance` antes da sessão (apenas modo print) | `claude -p --maintenance "query"` |106| `--maintenance` | Executar hooks de [Setup](/docs/pt/hooks#setup) com o matcher `maintenance` antes da sessão (apenas modo print) | `claude -p --maintenance "query"` |

107| `--max-budget-usd` | Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print). Gastos de [subagents](/docs/pt/sub-agents) contam para o limite. Quando você retorna a uma conversa com `--continue` ou `--resume`, totais [restaurados de execuções anteriores](/docs/pt/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) não contam para isso. Uma vez que o gasto atinge o limite, gerar outro subagent falha com `Budget limit reached`, e Claude Code para subagents de fundo que ainda estão em execução; os comportamentos de aplicação de limite requerem Claude Code v2.1.217 ou posterior | `claude -p --max-budget-usd 5.00 "query"` |107| `--max-budget-usd` | Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print). Claude Code compara o limite com sua [estimativa de custo do lado do cliente](/docs/pt/agent-sdk/cost-tracking#estimates-not-billing), que pode diferir da sua fatura. Gastos de [subagentes](/docs/pt/sub-agents) contam para o limite. Quando você retorna a uma conversa com `--continue` ou `--resume`, totais [restaurados de execuções anteriores](/docs/pt/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) não contam para ele. Uma vez que o gasto atinge o limite, gerar outro subagente falha com `Budget limit reached`, e Claude Code para subagentes de fundo que ainda estão em execução; os comportamentos de aplicação do limite requerem Claude Code v2.1.217 ou posterior | `claude -p --max-budget-usd 5.00 "query"` |

108| `--max-turns` | Limitar o número de turnos de agente (apenas modo print). Sai com um erro quando o limite é atingido. Sem limite por padrão. Com `--input-format stream-json`, uma mensagem ainda enfileirada quando o limite termina um turno permanece enfileirada e inicia um novo turno com seu próprio limite | `claude -p --max-turns 3 "query"` |108| `--max-turns` | Limitar o número de turnos de agente (apenas modo print). Sai com um erro quando o limite é atingido. Sem limite por padrão. Com `--input-format stream-json`, uma mensagem ainda enfileirada quando o limite termina um turno permanece enfileirada e inicia um novo turno com seu próprio limite | `claude -p --max-turns 3 "query"` |

109| `--mcp-config` | Carregar servidores MCP de arquivos JSON ou strings (separados por espaço). Quando você passa este sinalizador com `-p`, Claude Code aguarda servidores ainda pendentes se conectarem antes de executar o primeiro turno, até o tempo limite de inicialização [`MCP_TIMEOUT`](/docs/pt/env-vars), 30 segundos por padrão; um servidor com uma [lista de ferramentas em cache](/docs/pt/mcp#managing-your-servers) pula a espera e se conecta no primeiro uso. A espera requer Claude Code v2.1.221 ou posterior | `claude --mcp-config ./mcp.json` |109| `--mcp-config` | Carregar servidores MCP de arquivos JSON ou strings (separados por espaço). Quando você passa este sinalizador com `-p`, Claude Code aguarda servidores ainda pendentes se conectarem antes de executar o primeiro turno, até o tempo limite de inicialização [`MCP_TIMEOUT`](/docs/pt/env-vars), 30 segundos por padrão; um servidor com uma [lista de ferramentas em cache](/docs/pt/mcp#managing-your-servers) pula a espera e se conecta no primeiro uso. A espera requer Claude Code v2.1.221 ou posterior | `claude --mcp-config ./mcp.json` |

110| `--model` | Define o modelo para a sessão atual com um [alias de modelo](/docs/pt/model-config#model-aliases) como `sonnet`, `opus`, `haiku` ou `fable`, ou o nome completo de um modelo. Substitui a configuração [`model`](/docs/pt/settings-reference#model) e [`ANTHROPIC_MODEL`](/docs/pt/model-config#environment-variables) | `claude --model claude-sonnet-5` |110| `--model` | Define o modelo para a sessão atual com um [alias de modelo](/docs/pt/model-config#model-aliases) como `sonnet`, `opus`, `haiku` ou `fable`, ou o nome completo de um modelo. Substitui a configuração [`model`](/docs/pt/settings-reference#model) e [`ANTHROPIC_MODEL`](/docs/pt/model-config#environment-variables) | `claude --model claude-sonnet-5` |

code-review.md +3 −3

Details

7> Configure análises automatizadas de PR que detectam erros de lógica, vulnerabilidades de segurança e regressões usando análise multi-agente de sua base de código completa7> Configure análises automatizadas de PR que detectam erros de lógica, vulnerabilidades de segurança e regressões usando análise multi-agente de sua base de código completa

8 8 

9<Note>9<Note>

10 Code Review está em visualização de pesquisa, disponível para assinaturas [Team e Enterprise](https://claude.ai/admin-settings/claude-code). Não está disponível para organizações com [Zero Data Retention](/docs/pt/zero-data-retention) ativado. Em outros planos, você ainda pode [revisar um diff localmente](#review-a-diff-locally) com o comando `/code-review`.10 Code Review está em prévia de pesquisa, disponível para assinaturas [Team e Enterprise](https://claude.ai/admin-settings/claude-code). Não está disponível para organizações com [Zero Data Retention](/docs/pt/zero-data-retention) ativado ou com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada, e não é coberto pelo BAA da Anthropic. Em outros planos, você ainda pode [revisar um diff localmente](#review-a-diff-locally) com o comando `/code-review`.

11</Note>11</Note>

12 12 

13Code Review analisa seus pull requests do GitHub e publica descobertas como comentários inline nas linhas de código onde encontrou problemas. Uma frota de agentes especializados examina as alterações de código no contexto de sua base de código completa, procurando por erros de lógica, vulnerabilidades de segurança, casos extremos quebrados e regressões sutis.13Code Review analisa seus pull requests do GitHub e publica descobertas como comentários inline nas linhas de código onde encontrou problemas. Uma frota de agentes especializados examina as alterações de código no contexto de sua base de código completa, procurando por erros de lógica, vulnerabilidades de segurança, casos extremos quebrados e regressões sutis.


368* Em uma sessão de terminal, onde `/code-review` executa a revisão como um [subagente bifurcado](/docs/pt/skills#run-skills-in-a-subagent)368* Em uma sessão de terminal, onde `/code-review` executa a revisão como um [subagente bifurcado](/docs/pt/skills#run-skills-in-a-subagent)

369* Em uma execução `-p` com saída de texto ou JSON369* Em uma execução `-p` com saída de texto ou JSON

370 370 

371Em um aplicativo host que solicita a lista de descobertas, como o [aplicativo desktop](/docs/pt/desktop), Claude relata as descobertas da revisão através da ferramenta [`ReportFindings`](/docs/pt/tools-reference). Claude Code renderiza o relatório como uma lista de descobertas, e cada entrada mostra a localização do arquivo, um resumo de uma frase e uma tag de categoria como `correctness` quando a descoberta carrega uma. Uma requisição do host se aplica em cada nível de esforço e requer Claude Code v2.1.218 ou posterior.371Em um aplicativo host que solicita a lista de descobertas, como o [aplicativo desktop](/docs/pt/desktop#review-your-code), Claude relata as descobertas da revisão através da ferramenta [`ReportFindings`](/docs/pt/tools-reference). Claude Code renderiza o relatório como uma lista de descobertas, e cada entrada mostra a localização do arquivo, um resumo de uma frase e uma tag de categoria como `correctness` quando a descoberta carrega uma. Uma requisição do host se aplica em cada nível de esforço e requer Claude Code v2.1.218 ou posterior.

372 372 

373Quando Claude corrige descobertas relatadas posteriormente na sessão, ele as relata novamente, e Claude Code marca cada descoberta na lista de descobertas atualizada como corrigida, ignorada ou sem alteração necessária.373Quando Claude corrige descobertas relatadas posteriormente na sessão, ele as relata novamente, e Claude Code marca cada descoberta na lista de descobertas atualizada como corrigida, ignorada ou sem alteração necessária.

374 374 


432Quando o alvo é um pull request `github.com`, você pode fazer com que Claude [publique as descobertas concluídas no PR](/docs/pt/ultrareview#post-findings-to-the-pull-request) como um comentário de sua conta GitHub. Requer Claude Code v2.1.227 ou posterior.432Quando o alvo é um pull request `github.com`, você pode fazer com que Claude [publique as descobertas concluídas no PR](/docs/pt/ultrareview#post-findings-to-the-pull-request) como um comentário de sua conta GitHub. Requer Claude Code v2.1.227 ou posterior.

433 433 

434<Note>434<Note>

435 Ultrareview requer autenticação com uma conta claude.ai e não está disponível no Amazon Bedrock, na Agent Platform do Google Cloud, no Microsoft Foundry, ou para organizações com Zero Data Retention habilitado. Quando ultrareview não está disponível, `/code-review ultra` executa uma revisão local em sua sessão.435 Ultrareview requer autenticação com uma conta claude.ai e não está disponível no Amazon Bedrock, na Agent Platform do Google Cloud, no Microsoft Foundry, ou para organizações com Zero Data Retention habilitado ou com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada. Quando ultrareview não está disponível, `/code-review ultra` executa uma revisão local em sua sessão.

436</Note>436</Note>

437 437 

438Para executar uma revisão na nuvem a partir de um script ou job de CI, use o [subcomando `claude ultrareview`](/docs/pt/ultrareview#run-ultrareview-non-interactively), que aguarda as descobertas e as imprime no stdout.438Para executar uma revisão na nuvem a partir de um script ou job de CI, use o [subcomando `claude ultrareview`](/docs/pt/ultrareview#run-ultrareview-non-interactively), que aguarda as descobertas e as imprime no stdout.

commands.md +2 −2

Details

10 10 

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

12 12 

13Um comando é reconhecido apenas no início da sua mensagem. O texto que segue o nome do comando se torna seus argumentos. A partir da v2.1.199, [skills](/docs/pt/skills#pass-arguments-to-skills) são a exceção: uma invocação de skill seguida por mais skills, como `/skill-a /skill-b do XYZ`, carrega cada skill nomeada no início e passa o texto final para cada uma como argumentos. Até seis skills podem ser encadeadas.13Um comando é reconhecido apenas no início da sua mensagem. O texto que segue o nome do comando se torna seus argumentos. [Skills](/docs/pt/skills#pass-arguments-to-skills) são a exceção: uma invocação de skill seguida por mais skills, como `/skill-a /skill-b do XYZ`, carrega as skills nomeadas no início e passa o texto final para cada uma como argumentos. Até seis skills podem ser encadeadas.

14 14 

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

16 16 


140| `/run-skill-generator` | **[Skill](/docs/pt/skills#bundled-skills).** Ensine `/run` e `/verify` como fazer o build, iniciar e dirigir o aplicativo do seu projeto a partir de um ambiente limpo escrevendo uma [skill](/docs/pt/skills#run-and-verify-your-app) por projeto |140| `/run-skill-generator` | **[Skill](/docs/pt/skills#bundled-skills).** Ensine `/run` e `/verify` como fazer o build, iniciar e dirigir o aplicativo do seu projeto a partir de um ambiente limpo escrevendo uma [skill](/docs/pt/skills#run-and-verify-your-app) por projeto |

141| `/sandbox` | Alterne o [modo sandbox](/docs/pt/sandboxing). Disponível apenas em plataformas suportadas |141| `/sandbox` | Alterne o [modo sandbox](/docs/pt/sandboxing). Disponível apenas em plataformas suportadas |

142| `/schedule [description]` | Crie, atualize, liste ou execute [rotinas](/docs/pt/routines), que são executadas na nuvem. Claude o orienta através da configuração conversacionalmente. Você também pode perguntar sobre [execuções recentes de uma rotina](/docs/pt/routines#manage-routines-from-the-cli). Alias: `/routines` |142| `/schedule [description]` | Crie, atualize, liste ou execute [rotinas](/docs/pt/routines), que são executadas na nuvem. Claude o orienta através da configuração conversacionalmente. Você também pode perguntar sobre [execuções recentes de uma rotina](/docs/pt/routines#manage-routines-from-the-cli). Alias: `/routines` |

143| `/scroll-speed` | Ajuste a [velocidade de rolagem](/docs/pt/fullscreen#mouse-wheel-scrolling) da roda do mouse interativamente, com uma régua que você pode rolar enquanto o diálogo está aberto para visualizar a mudança. Disponível em [renderização tela cheia](/docs/pt/fullscreen) apenas e não no terminal IDE JetBrains |143| `/scroll-speed` | Ajuste a [velocidade de rolagem](/docs/pt/fullscreen#mouse-wheel-scrolling) da roda do mouse interativamente. Disponível em [renderização tela cheia](/docs/pt/fullscreen) apenas e não no terminal IDE JetBrains |

144| `/security-review` | Analise as mudanças em seu branch atual para vulnerabilidades de segurança. Revisa o diff entre seu branch e o branch padrão da origem, identificando riscos como injeção, problemas de autenticação e exposição de dados. Precisa de um remoto `origin`; se a revisão falhar com um erro `ambiguous argument`, consulte a [referência de erro](/docs/pt/errors#security-review-fails-without-origin-head) |144| `/security-review` | Analise as mudanças em seu branch atual para vulnerabilidades de segurança. Revisa o diff entre seu branch e o branch padrão da origem, identificando riscos como injeção, problemas de autenticação e exposição de dados. Precisa de um remoto `origin`; se a revisão falhar com um erro `ambiguous argument`, consulte a [referência de erro](/docs/pt/errors#security-review-fails-without-origin-head) |

145| `/setup-bedrock` | Configure autenticação, região e pinos de modelo [Amazon Bedrock](/docs/pt/amazon-bedrock) através de um assistente interativo. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type) até que `CLAUDE_CODE_USE_BEDROCK=1` seja definido; digite-o por completo. Usuários do Amazon Bedrock pela primeira vez também podem acessar este assistente da tela de login |145| `/setup-bedrock` | Configure autenticação, região e pinos de modelo [Amazon Bedrock](/docs/pt/amazon-bedrock) através de um assistente interativo. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type) até que `CLAUDE_CODE_USE_BEDROCK=1` seja definido; digite-o por completo. Usuários do Amazon Bedrock pela primeira vez também podem acessar este assistente da tela de login |

146| `/setup-vertex` | Configure autenticação, projeto, região e pinos de modelo [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) através de um assistente interativo. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type) até que `CLAUDE_CODE_USE_VERTEX=1` seja definido; digite-o por completo. Usuários do Google Cloud's Agent Platform pela primeira vez também podem acessar este assistente da tela de login |146| `/setup-vertex` | Configure autenticação, projeto, região e pinos de modelo [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) através de um assistente interativo. [Oculto do menu de comando](#how-the-command-menu-matches-what-you-type) até que `CLAUDE_CODE_USE_VERTEX=1` seja definido; digite-o por completo. Usuários do Google Cloud's Agent Platform pela primeira vez também podem acessar este assistente da tela de login |

Details

229 229 

230Claude pode gerar testes que seguem os padrões e convenções existentes do seu projeto. Ao solicitar testes, seja específico sobre qual comportamento você quer verificar. Claude examina seus arquivos de teste existentes para corresponder ao estilo, frameworks e padrões de asserção já em uso.230Claude pode gerar testes que seguem os padrões e convenções existentes do seu projeto. Ao solicitar testes, seja específico sobre qual comportamento você quer verificar. Claude examina seus arquivos de teste existentes para corresponder ao estilo, frameworks e padrões de asserção já em uso.

231 231 

232Para cobertura abrangente, peça ao Claude para identificar casos extremos que você pode ter perdido. Claude pode analisar seus caminhos de código e sugerir testes para condições de erro, valores de limite e entradas inesperadas que são fáceis de negligenciar.232Para melhorar a cobertura, peça ao Claude para identificar casos extremos que você pode ter perdido. Claude pode analisar seus caminhos de código e sugerir testes para condições de erro, valores de limite e entradas inesperadas que frequentemente são negligenciados.

233 233 

234***234***

235 235 

Details

1604| Memória automática | Re-injetado do disco |1604| Memória automática | Re-injetado do disco |

1605| [Snapshot de status do Git](/docs/pt/settings-reference#includegitinstructions) | Claude Code lê um novo do seu repositório |1605| [Snapshot de status do Git](/docs/pt/settings-reference#includegitinstructions) | Claude Code lê um novo do seu repositório |

1606| O plano que Claude escreveu em [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) | Re-injetado do disco |1606| O plano que Claude escreveu em [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) | Re-injetado do disco |

1607| Regras com frontmatter `paths:` | Claude Code as recarrega conforme Claude lê arquivos que elas correspondem |1607| Regras com frontmatter `paths:` | Claude Code as recarrega [sob demanda](/docs/pt/memory#path-specific-rules) |

1608| CLAUDE.md aninhado em subdiretórios | Claude Code as recarrega conforme Claude lê arquivos nesse subdiretório |1608| CLAUDE.md aninhado em subdiretórios | Claude Code os recarrega [sob demanda](/docs/pt/memory#how-claude-md-files-load) |

1609| Arquivos que Claude leu ou editou | Claude Code relê até cinco, os mais recentemente modificados primeiro |1609| Arquivos que Claude leu ou editou | Claude Code relê até cinco, os mais recentemente modificados primeiro |

1610| Corpos de skills invocados | Re-injetado, limitado a 5.000 tokens por skill e 25.000 tokens no total; os mais antigos são descartados primeiro |1610| Corpos de skills invocados | Re-injetado, limitado a 5.000 tokens por skill e 25.000 tokens no total; os mais antigos são descartados primeiro |

1611| [Background commands](/docs/pt/interactive-mode#background-bash-commands) e background [subagents](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) | Continuam em execução. Claude Code lembra Claude quais ainda estão em execução para que ele não inicie uma duplicata |1611| [Background commands](/docs/pt/interactive-mode#background-bash-commands) e background [subagents](/docs/pt/sub-agents#run-subagents-in-foreground-or-background) | Continuam em execução. Claude Code lembra Claude quais ainda estão em execução para que ele não inicie uma duplicata |

costs.md +2 −2

Details

37 37 

38Esses totais são redefinidos quando `/clear` inicia uma nova sessão, portanto, o custo total da próxima sessão começa em \$0. Antes da v2.1.211, eles continuavam acumulando em `/clear` durante a vida útil do processo Claude Code.38Esses totais são redefinidos quando `/clear` inicia uma nova sessão, portanto, o custo total da próxima sessão começa em \$0. Antes da v2.1.211, eles continuavam acumulando em `/clear` durante a vida útil do processo Claude Code.

39 39 

40Para uma resposta da API Claude faturada na [taxa de residência de dados](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing) de 1,1×, Claude Code multiplica o preço de tabela dos tokens dessa resposta por 1,1 na figura de custo da sessão. O mesmo total aparece na [linha de status do campo de custo](/docs/pt/statusline#cost-and-duration-tracking), e a figura multiplicada também conta para [`--max-budget-usd`](/docs/pt/cli-reference#cli-flags). Antes da v2.1.239, Claude Code não aplicava o 1,1× a essas respostas, portanto, a figura de custo da sessão era menor que a fatura.40Para uma resposta da API Claude faturada na [taxa de residência de dados](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing) de 1,1×, Claude Code multiplica o preço de tabela dos tokens dessa resposta por 1,1 na figura de custo da sessão. O mesmo total aparece no [campo de custo da linha de status](/docs/pt/statusline#cost-and-duration-tracking), e a figura multiplicada também conta para [`--max-budget-usd`](/docs/pt/cli-reference#cli-flags).

41 41 

42<h4 id="prompt-cache-statistics">42<h4 id="prompt-cache-statistics">

43 Estatísticas de cache de prompt43 Estatísticas de cache de prompt


262 262 

263Use `/usage` para verificar seu uso atual de tokens, ou [configure sua linha de status](/docs/pt/statusline#context-window-usage) para exibi-la continuamente.263Use `/usage` para verificar seu uso atual de tokens, ou [configure sua linha de status](/docs/pt/statusline#context-window-usage) para exibi-la continuamente.

264 264 

265* **Limpe entre tarefas**: Use `/clear` para começar do zero ao mudar para trabalho não relacionado. Contexto obsoleto desperdiça tokens em cada mensagem subsequente. Use `/rename` antes de limpar para que você possa encontrar facilmente a sessão depois, então `/resume` para retornar a ela.265* **Limpe entre tarefas**: Use `/clear` para começar do zero ao mudar para trabalho não relacionado. Contexto obsoleto desperdiça tokens em cada mensagem subsequente. Use `/rename` antes de limpar para que você possa encontrar a sessão depois, então `/resume` para retornar a ela.

266* **Adicione instruções de compactação personalizadas**: `/compact Focus on code samples and API usage` diz a Claude o que preservar durante a sumarização.266* **Adicione instruções de compactação personalizadas**: `/compact Focus on code samples and API usage` diz a Claude o que preservar durante a sumarização.

267 267 

268Você também pode personalizar o comportamento de compactação em seu arquivo CLAUDE.md na raiz do seu projeto:268Você também pode personalizar o comportamento de compactação em seu arquivo CLAUDE.md na raiz do seu projeto:

Details

29| `/debug [issue]` | Ativa o log de depuração para a sessão e solicita que Claude diagnostique usando a saída do log e caminhos de configurações |29| `/debug [issue]` | Ativa o log de depuração para a sessão e solicita que Claude diagnostique usando a saída do log e caminhos de configurações |

30| `/status` | Fontes de configurações ativas, incluindo se as configurações gerenciadas estão em vigor |30| `/status` | Fontes de configurações ativas, incluindo se as configurações gerenciadas estão em vigor |

31 31 

32Se um arquivo de memória estiver faltando na divisão `/context`, verifique sua localização em relação a [como os arquivos CLAUDE.md são carregados](/docs/pt/memory#how-claude-md-files-load). Os arquivos `CLAUDE.md` do subdiretório são carregados sob demanda depois que Claude usa a ferramenta Read, Write ou Edit em um arquivo nesse diretório, não no início da sessão.32Se um arquivo de memória estiver faltando na divisão `/context`, verifique sua localização em relação a [como os arquivos CLAUDE.md são carregados](/docs/pt/memory#how-claude-md-files-load). Os arquivos `CLAUDE.md` de subdiretórios são carregados sob demanda, e não no início da sessão, portanto não aparecem nessa divisão.

33 33 

34Se `/context` confirmar que o arquivo foi carregado mas Claude ainda não está seguindo uma instrução particular, o problema provavelmente é como a instrução é escrita e não se foi carregada. CLAUDE.md funciona bem para o tipo de orientação que você daria a um novo colega de equipe, como convenções de projeto, comandos de compilação e onde os arquivos pertencem.34Se `/context` confirmar que o arquivo foi carregado mas Claude ainda não está seguindo uma instrução particular, o problema provavelmente é como a instrução é escrita e não se foi carregada. CLAUDE.md funciona bem para o tipo de orientação que você daria a um novo colega de equipe, como convenções de projeto, comandos de compilação e onde os arquivos pertencem.

35 35 


116| Um valor de `settings.json` parece ser ignorado | A mesma chave está definida em `settings.local.json` | `settings.local.json` substitui `settings.json`, e ambos substituem `~/.claude/settings.json`. Consulte [precedência de configurações](/docs/pt/settings#settings-precedence). |116| Um valor de `settings.json` parece ser ignorado | A mesma chave está definida em `settings.local.json` | `settings.local.json` substitui `settings.json`, e ambos substituem `~/.claude/settings.json`. Consulte [precedência de configurações](/docs/pt/settings#settings-precedence). |

117| Skill não aparece em `/skills` | O arquivo de skill está em `.claude/skills/name.md` em vez de em uma pasta | Use uma pasta com `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |117| Skill não aparece em `/skills` | O arquivo de skill está em `.claude/skills/name.md` em vez de em uma pasta | Use uma pasta com `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |

118| Skill aparece em `/skills` mas Claude nunca o invoca | Skill tem `disable-model-invocation: true` em seu frontmatter, ou sua descrição não corresponde a como você frasa a solicitação | Verifique o badge em `/skills`: um rótulo "user-only" significa que Claude não o acionará por conta própria. Consulte [invocação de skill](/docs/pt/skills). |118| Skill aparece em `/skills` mas Claude nunca o invoca | Skill tem `disable-model-invocation: true` em seu frontmatter, ou sua descrição não corresponde a como você frasa a solicitação | Verifique o badge em `/skills`: um rótulo "user-only" significa que Claude não o acionará por conta própria. Consulte [invocação de skill](/docs/pt/skills). |

119| As instruções de `CLAUDE.md` do subdiretório parecem ser ignoradas | Os arquivos do subdiretório são carregados sob demanda, não no início da sessão | Eles são carregados depois que Claude usa a ferramenta Read, Write ou Edit em um arquivo nesse diretório, não no lançamento. Antes da v2.1.288, apenas a ferramenta Read os carregava. Consulte [como os arquivos CLAUDE.md são carregados](/docs/pt/memory#how-claude-md-files-load). |119| As instruções de `CLAUDE.md` do subdiretório parecem ser ignoradas | Os arquivos do subdiretório são carregados sob demanda, não no início da sessão | Consulte [quando os arquivos de subdiretório são carregados](/docs/pt/memory#how-claude-md-files-load). Antes da v2.1.288, apenas a ferramenta Read os carregava. |

120| Subagente ignora as instruções de `CLAUDE.md` | Os agentes Explore e Plan integrados pulam `CLAUDE.md`. Um subagente personalizado o carrega da mesma forma que a conversa principal, a menos que sua definição defina [`omitClaudeMd`](/docs/pt/sub-agents#supported-frontmatter-fields) | Para Explore ou Plan, reafirme a instrução em seu prompt de delegação. Para um subagente que define `omitClaudeMd`, remova o campo. Para qualquer outro subagente personalizado, coloque instruções críticas no corpo do arquivo do agente, que se torna o prompt do sistema do agente. Consulte [o que é carregado na inicialização](/docs/pt/sub-agents#what-loads-at-startup). |120| Subagente ignora as instruções de `CLAUDE.md` | Os agentes Explore e Plan integrados pulam `CLAUDE.md`. Um subagente personalizado o carrega da mesma forma que a conversa principal, a menos que sua definição defina [`omitClaudeMd`](/docs/pt/sub-agents#supported-frontmatter-fields) | Para Explore ou Plan, reafirme a instrução em seu prompt de delegação. Para um subagente que define `omitClaudeMd`, remova o campo. Para qualquer outro subagente personalizado, coloque instruções críticas no corpo do arquivo do agente, que se torna o prompt do sistema do agente. Consulte [o que é carregado na inicialização](/docs/pt/sub-agents#what-loads-at-startup). |

121| A lógica de limpeza nunca é executada no final da sessão | Nenhum hook `SessionEnd` configurado | Adicione um hook `SessionEnd` em `settings.json`. Consulte a [lista de eventos de hook](/docs/pt/hooks#hook-events). |121| A lógica de limpeza nunca é executada no final da sessão | Nenhum hook `SessionEnd` configurado | Adicione um hook `SessionEnd` em `settings.json`. Consulte a [lista de eventos de hook](/docs/pt/hooks#hook-events). |

122| Servidores MCP em `.mcp.json` nunca são carregados | O arquivo está sob `.claude/`, ou seus servidores estão sob uma chave `servers` de nível superior, como no `mcp.json` do VS Code, em vez de `mcpServers` | A configuração MCP do projeto vai na raiz do repositório como `.mcp.json`, não dentro de `.claude/`, com servidores sob a chave `mcpServers`. Consulte [configuração MCP](/docs/pt/mcp). |122| Servidores MCP em `.mcp.json` nunca são carregados | O arquivo está sob `.claude/`, ou seus servidores estão sob uma chave `servers` de nível superior, como no `mcp.json` do VS Code, em vez de `mcpServers` | A configuração MCP do projeto vai na raiz do repositório como `.mcp.json`, não dentro de `.claude/`, com servidores sob a chave `mcpServers`. Consulte [configuração MCP](/docs/pt/mcp). |

desktop.md +44 −37

Details

124 124 

125* Interagir com seu aplicativo em execução diretamente no painel de navegador125* Interagir com seu aplicativo em execução diretamente no painel de navegador

126* Assistir Claude verificar suas próprias alterações automaticamente: ele tira capturas de tela, inspeciona o DOM, clica em elementos, preenche formulários e corrige problemas que encontra126* Assistir Claude verificar suas próprias alterações automaticamente: ele tira capturas de tela, inspeciona o DOM, clica em elementos, preenche formulários e corrige problemas que encontra

127* Iniciar ou parar servidores no menu suspenso de servidor na barra de ferramentas da sessão127* Iniciar ou parar servidores, ou parar todos de uma vez, no menu **Dev servers** no cabeçalho do painel de navegador

128* Persistir cookies e armazenamento local entre reinicializações do servidor selecionando **Persist sessions** no menu suspenso, para que você não tenha que fazer login novamente durante o desenvolvimento128* Escolher se o navegador mantém cookies depois que você fecha o aplicativo com **Keep cookies** no menu **⋮** do painel de navegador, para que você não tenha que fazer login novamente durante o desenvolvimento

129* Editar a configuração do servidor ou parar todos os servidores de uma vez

130 129 

131Claude cria a configuração inicial do servidor com base em seu projeto. Se seu aplicativo usa um comando dev personalizado, edite `.claude/launch.json` para corresponder à sua configuração. Veja [Configurar servidores de visualização](#configure-preview-servers) para a referência completa.130Claude cria a configuração inicial do servidor com base em seu projeto. Se seu aplicativo usa um comando dev personalizado, edite `.claude/launch.json` para corresponder à sua configuração. Veja [Configurar servidores de visualização](#configure-preview-servers) para a referência completa.

132 131 

133Para limpar dados de sessão salvos, ou para desativar o navegador completamente, use os toggles em Configurações → Claude Code.132Para limpar os dados salvos do navegador, selecione **Clear browsing data** no menu **⋮** do painel de navegador. Para desativar o navegador completamente, desative **Browser tools** em **Settings > Claude Code**.

134 133 

135<h3 id="browse-external-sites">134<h3 id="browse-external-sites">

136 Navegar em sites externos135 Navegar em sites externos

137</h3>136</h3>

138 137 

139O painel de navegador é um navegador com abas, então você pode abrir documentação, rastreadores de problemas ou qualquer outro site ao lado do seu aplicativo em execução. Para abrir o navegador, pressione **Cmd+Shift+B** no macOS ou **Ctrl+Shift+B** no Windows, ou selecione-o no menu **Views**. Quando você clica em um link externo no chat, um seletor oferece **Open in app** para usar o painel de navegador ou **Default browser** para usar o seu próprio; **Cmd**-clique no macOS ou **Ctrl**-clique no Windows abre um link no seu navegador do sistema diretamente. Você pode fazer login em sites no painel, incluindo fluxos de login em popup como Google OAuth.138O painel de navegador é um navegador com abas, então você pode abrir documentação, rastreadores de problemas ou qualquer outro site ao lado do seu aplicativo em execução. Para abrir o navegador, pressione **Cmd+Shift+B** no macOS ou **Ctrl+Shift+B** no Windows, ou clique em **Browser** na barra de título da sessão. Você pode fazer login em sites no painel, incluindo fluxos de login em popup como Google OAuth.

139 

140Na primeira vez que você clica em um link externo no chat, uma caixa de diálogo pergunta se os links devem abrir no painel de navegador ou no seu navegador padrão. Para alterar sua escolha depois, use **Open links in built-in browser** no menu **⋮** do painel de navegador. **Cmd**-clique no macOS ou **Ctrl**-clique no Windows abre um link diretamente no seu navegador padrão.

140 141 

141Claude pode ler e interagir com páginas externas usando as mesmas ferramentas que usa para [verificar seu aplicativo](#preview-your-app), com duas verificações de segurança adicionais:142Claude pode ler e interagir com páginas externas usando as mesmas ferramentas que usa para [verificar seu aplicativo](#preview-your-app), com duas verificações de segurança adicionais:

142 143 


184 Revisar seu código185 Revisar seu código

185</h3>186</h3>

186 187 

187Na visualização de diff, clique em **Review code** na barra de ferramentas superior direita para pedir a Claude para avaliar as alterações antes de você fazer commit. Claude examina os diffs atuais e deixa comentários diretamente na visualização de diff. Você pode responder a qualquer comentário ou pedir a Claude para revisar.188Para que Claude revise suas alterações antes de você fazer commit, digite `/code-review` na [caixa de prompt](#use-the-prompt-box). As descobertas chegam na conversa quando a revisão é concluída.

189 

190Em sessões locais, [SSH](#ssh-sessions) e [WSL](/docs/pt/desktop-wsl), as descobertas aparecem como um cartão **Code review**, agrupadas por arquivo. Use o cartão para agir sobre elas:

188 191 

189A revisão se concentra em problemas de alto sinal: erros de compilação, erros de lógica definidos, vulnerabilidades de segurança e bugs óbvios. Não sinaliza estilo, formatação, problemas pré-existentes ou qualquer coisa que um linter capturaria.192* Clique em **Walk through in diff** para abrir a visualização de diff e percorrer as descobertas uma de cada vez. Uma descoberta no diff atual aparece em sua linha, onde você pode clicar em **Fix this one** ou descartá-la.

193* Clique em **Apply fixes** para pedir a Claude que corrija as descobertas que ainda estão em aberto.

194 

195Em qualquer sessão, você também pode pedir a Claude na caixa de prompt que corrija o que a revisão encontrou. Para saber o que `/code-review` procura e os argumentos que aceita, veja [Revisar um diff localmente](/docs/pt/code-review#review-a-diff-locally).

190 196 

191<h3 id="monitor-pull-request-status">197<h3 id="monitor-pull-request-status">

192 Monitorar status de pull request198 Monitorar status de pull request


194 200 

195Depois de abrir um pull request, uma barra de status de CI aparece na sessão. Claude Code usa o GitHub CLI para pesquisar resultados de verificação e exibir falhas.201Depois de abrir um pull request, uma barra de status de CI aparece na sessão. Claude Code usa o GitHub CLI para pesquisar resultados de verificação e exibir falhas.

196 202 

197* **Auto-fix**: quando ativado, Claude tenta automaticamente corrigir verificações de CI falhando lendo a saída de falha e iterando.203* **Auto-fix CI & address comments**: quando ativado, Claude tenta automaticamente corrigir verificações de CI falhando lendo a saída de falha e iterando. Em uma sessão local, Claude também responde a novos comentários de revisão deixados por alguém além de você, quando o autor é o proprietário do repositório, um membro da organização, um colaborador ou um GitHub App.

198* **Auto-merge**: quando ativado, Claude mescla o PR assim que todas as verificações passam. O método de mesclagem é squash. Ative auto-merge em suas [configurações do repositório GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository) primeiro; sem isso, Claude não pode mesclar o PR.204* **Auto-merge when ready**: quando ativado, Claude mescla o PR assim que todas as verificações passam. O método de merge é squash. Ative auto-merge em suas [configurações do repositório GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository) primeiro; sem isso, Claude não pode mesclar o PR.

199 205 

200Use os toggles **Auto-fix** e **Auto-merge** na barra de status de CI para ativar qualquer opção. Claude Code também envia uma notificação de desktop quando CI termina. Para arquivar a sessão automaticamente assim que o PR mescla ou fecha, ative [auto-archive](#work-in-parallel-with-sessions) em Configurações → Claude Code.206Para ativá-los, clique em **CI** na barra de status. Para arquivar a sessão automaticamente assim que o PR for mesclado ou fechado, ative [auto-archive](#work-in-parallel-with-sessions) em **Settings > Claude Code**.

201 207 

202<Note>208<Note>

203 O monitoramento de PR requer que o [GitHub CLI (`gh`)](https://cli.github.com/) esteja instalado e autenticado em sua máquina. Se `gh` não estiver instalado, Desktop o solicita a instalar na primeira vez que você tentar criar um PR.209 O monitoramento de PR requer que o [GitHub CLI (`gh`)](https://cli.github.com/) esteja instalado e autenticado em sua máquina. Se `gh` não estiver instalado, Desktop o solicita a instalar na primeira vez que você tentar criar um PR.


207 Organizar seu workspace213 Organizar seu workspace

208</h2>214</h2>

209 215 

210A aba Code é construída em torno de painéis que você pode organizar em qualquer layout: chat, diff, browser, terminal, file, plan, tasks e subagent, junto com o [iOS Simulator](/docs/pt/desktop-ios-simulator) no macOS. Arraste um painel por seu cabeçalho para reposicioná-lo, ou arraste uma borda de painel para redimensioná-lo. Pressione **Cmd+\\** no macOS ou **Ctrl+\\** no Windows para fechar o painel focado. Abra painéis adicionais no menu **Views** na barra de ferramentas da sessão.216A aba Code é construída em torno de painéis que você pode organizar em qualquer layout: chat, diff, browser, terminal, file, plan, tasks e subagent, junto com o [iOS Simulator](/docs/pt/desktop-ios-simulator) no macOS. Arraste um painel por seu cabeçalho para reposicioná-lo, ou arraste uma borda de painel para redimensioná-lo. Pressione **Cmd+\\** no macOS ou **Ctrl+\\** no Windows para fechar o painel focado. Clique em **Terminal**, **Changes** ou **Browser** na barra de título da sessão para abrir o painel de terminal, diff ou Browser. O menu **⋮** ao lado deles abre mais painéis, como **Files**, e contém esses botões quando a janela é estreita demais para exibi-los.

211 217 

212Para trabalhar em várias telas, extraia um painel como o diff ou terminal para sua própria janela e encaixe-o novamente quando terminar. Claude continua trabalhando na janela principal.218Para trabalhar em várias telas, extraia um painel como o diff ou terminal para sua própria janela e encaixe-o novamente quando terminar. Claude continua trabalhando na janela principal.

213 219 


219 Executar comandos no terminal225 Executar comandos no terminal

220</h3>226</h3>

221 227 

222O terminal integrado permite que você execute comandos ao lado de sua sessão sem alternar para outro aplicativo. Abra-o no menu **Views** ou pressione **Ctrl+\`** no macOS ou Windows. O terminal abre no diretório de trabalho de sua sessão e compartilha o mesmo ambiente que Claude, então comandos como `npm test` ou `git status` veem os mesmos arquivos que Claude está editando. Para abrir uma segunda aba de terminal, clique em **+** no cabeçalho do painel de terminal ou clique com o botão direito em uma pasta no chat para escolher **Open in terminal**. O terminal está disponível apenas em sessões locais.228O terminal integrado permite que você execute comandos ao lado de sua sessão sem alternar para outro aplicativo. Clique em **Terminal** na barra de título da sessão ou pressione **Ctrl+\`** no macOS ou Windows. O terminal abre no diretório de trabalho de sua sessão e compartilha o mesmo ambiente que Claude, então comandos como `npm test` ou `git status` veem os mesmos arquivos que Claude está editando. Para abrir uma segunda aba de terminal, clique em **+** no cabeçalho do painel de terminal ou clique com o botão direito em uma pasta no chat para escolher **Open in terminal**. O terminal está disponível apenas em sessões locais.

223 229 

224<h3 id="open-and-edit-files">230<h3 id="open-and-edit-files">

225 Abrir e editar arquivos231 Abrir e editar arquivos


410 Assistir tarefas em segundo plano416 Assistir tarefas em segundo plano

411</h3>417</h3>

412 418 

413O painel de tarefas mostra o trabalho em segundo plano em execução dentro da sessão atual: subagentes, comandos shell em segundo plano e [workflows dinâmicos](/docs/pt/workflows). Abra-o no menu **Views** ou arraste-o para seu layout.419O painel de tarefas mostra o trabalho em segundo plano em execução dentro da sessão atual: subagentes, comandos shell em segundo plano e [workflows dinâmicos](/docs/pt/workflows). Quando a sessão tiver trabalho em segundo plano, abra o painel com **Background tasks** no menu **⋮** da barra de título.

414 420 

415Clique em qualquer entrada para ver sua saída no painel de subagente ou pará-la. Para ver o que outras sessões estão fazendo, use a [barra lateral](#work-in-parallel-with-sessions), ou peça a Claude para [verificar nelas para você](#work-across-sessions).421Clique em qualquer entrada para ver sua saída no painel de subagente ou pará-la. Para ver o que outras sessões estão fazendo, use a [barra lateral](#work-in-parallel-with-sessions), ou peça a Claude para [verificar nelas para você](#work-across-sessions).

416 422 


518 524 

519Claude detecta automaticamente sua configuração de servidor de desenvolvimento e armazena a configuração em `.claude/launch.json` na raiz da pasta que você selecionou ao iniciar a sessão. Preview usa essa pasta como seu diretório de trabalho, então se você selecionou uma pasta pai, subpastas com seus próprios servidores de desenvolvimento não serão detectadas automaticamente. Para trabalhar com o servidor de uma subpasta, inicie uma sessão nessa pasta diretamente ou adicione uma configuração manualmente.525Claude detecta automaticamente sua configuração de servidor de desenvolvimento e armazena a configuração em `.claude/launch.json` na raiz da pasta que você selecionou ao iniciar a sessão. Preview usa essa pasta como seu diretório de trabalho, então se você selecionou uma pasta pai, subpastas com seus próprios servidores de desenvolvimento não serão detectadas automaticamente. Para trabalhar com o servidor de uma subpasta, inicie uma sessão nessa pasta diretamente ou adicione uma configuração manualmente.

520 526 

521Para personalizar como seu servidor inicia, por exemplo para usar `yarn dev` em vez de `npm run dev` ou para alterar a porta, edite o arquivo manualmente ou clique em **Edit configuration** no menu dropdown do servidor para abri-lo em seu editor de código. O arquivo suporta JSON com comentários.527Para personalizar como seu servidor inicia, por exemplo para usar `yarn dev` em vez de `npm run dev` ou para alterar a porta, edite `.claude/launch.json`. O arquivo suporta JSON com comentários.

522 528 

523```json theme={null}529```json theme={null}

524{530{


542 548 

543Quando `autoVerify` está ativado, Claude verifica automaticamente alterações de código após editar arquivos. Ele tira capturas de tela, verifica erros e confirma que as alterações funcionam antes de completar sua resposta.549Quando `autoVerify` está ativado, Claude verifica automaticamente alterações de código após editar arquivos. Ele tira capturas de tela, verifica erros e confirma que as alterações funcionam antes de completar sua resposta.

544 550 

545Auto-verify está ativado por padrão. Desative-o por projeto adicionando `"autoVerify": false` a `.claude/launch.json`, ou alterne-o no menu dropdown do servidor.551Auto-verify está ativado por padrão. Desative-o por projeto adicionando `"autoVerify": false` a `.claude/launch.json`, ou desative **Auto-verify changes** no menu **⋮** do painel Browser.

546 552 

547```json theme={null}553```json theme={null}

548{554{


766 772 

767Sessões SSH permitem que você execute Claude Code em uma máquina remota enquanto usa o aplicativo desktop como sua interface. Isso é útil para trabalhar com bases de código que vivem em VMs em nuvem, dev containers ou servidores com hardware ou dependências específicas.773Sessões SSH permitem que você execute Claude Code em uma máquina remota enquanto usa o aplicativo desktop como sua interface. Isso é útil para trabalhar com bases de código que vivem em VMs em nuvem, dev containers ou servidores com hardware ou dependências específicas.

768 774 

769Para adicionar uma conexão SSH, clique no menu suspenso de ambiente antes de iniciar uma sessão e selecione **+ Add SSH connection**. O diálogo solicita:775Para adicionar uma conexão SSH, abra o menu suspenso de ambiente na caixa de prompt antes de iniciar uma sessão, depois selecione **SSH > Add SSH connection…** e preencha os detalhes da conexão:

770 776 

771* **Name**: um rótulo amigável para esta conexão777* **Name**: um rótulo amigável para esta conexão

772* **SSH Host**: `user@hostname` ou um host definido em `~/.ssh/config`778* **SSH host**: `user@hostname` ou um host definido em `~/.ssh/config`

773* **SSH Port**: padrão é 22 se deixado vazio, ou usa a porta de seu SSH config779* **SSH port**: padrão é 22 se deixado vazio, ou usa a porta do seu SSH config

774* **Identity File**: caminho para sua chave privada, como `~/.ssh/id_rsa`. Deixe vazio para usar a chave padrão ou seu SSH config.780* **SSH key (optional)**: caminho para sua chave privada, como `~/.ssh/id_ed25519`. Deixe vazio para usar seu SSH config ou agente SSH.

775 781 

776Uma vez adicionada, a conexão aparece no menu suspenso de ambiente. Selecione-a para iniciar uma sessão naquela máquina. Claude é executado na máquina remota com acesso aos seus arquivos e ferramentas.782Uma vez adicionada, a conexão aparece em **SSH** no menu suspenso de ambiente. Selecione-a para iniciar uma sessão naquela máquina. Claude é executado na máquina remota com acesso aos seus arquivos e ferramentas.

777 783 

778A máquina remota deve executar Linux ou macOS. O aplicativo desktop instala Claude Code na máquina remota automaticamente na primeira vez que você se conecta. Uma vez conectado, sessões SSH suportam modos de permissão, conectores, plugins e MCP servers.784A máquina remota deve executar Linux ou macOS. O aplicativo desktop instala Claude Code na máquina remota automaticamente na primeira vez que você se conecta. Uma vez conectado, sessões SSH suportam modos de permissão, conectores, plugins e MCP servers.

779 785 


831 837 

832Essas configurações são configuradas através do [console de configurações de administração](https://claude.ai/admin-settings/claude-code):838Essas configurações são configuradas através do [console de configurações de administração](https://claude.ai/admin-settings/claude-code):

833 839 

834* **Code in the desktop**: controle se usuários em sua organização podem acessar Claude Code no aplicativo desktop840* **Desktop**: controle se usuários em sua organização podem acessar Claude Code no aplicativo desktop

835* **Code in the web**: ative ou desative [sessões web](/docs/pt/claude-code-on-the-web) para sua organização841* **Cloud sessions**: ative ou desative [sessões na nuvem](/docs/pt/claude-code-on-the-web) para sua organização

836* **Remote Control**: ative ou desative [Remote Control](/docs/pt/remote-control) para sua organização842* **Remote Control**: ative ou desative [Remote Control](/docs/pt/remote-control) para sua organização

837* **Disable Bypass permissions mode**: impeça usuários em sua organização de ativar o modo bypass permissions843 

844Em organizações Enterprise que têm HIPAA ativado, a opção **Desktop** fica desativada por padrão e um [Owner](/docs/pt/server-managed-settings#access-control) pode ativá-la. Aplicar a [configuração HIPAA](/docs/pt/hipaa-setup) a desativa, mesmo que estivesse ativada, então um Owner precisa ativá-la depois. **Cloud sessions** e **Remote Control** também ficam desativados por padrão, e um Owner não pode ativá-los depois que a organização tiver a configuração HIPAA aplicada.

838 845 

839<Note>846<Note>

840 O formulário OpenTelemetry para Cowork em **Monitoring** nas [configurações de Dados e privacidade](https://claude.ai/admin-settings/data-privacy-controls) do console de administração se aplica apenas a sessões Cowork. Em uma sessão Cowork nesta máquina, o aplicativo desktop passa esse coletor para Claude Code como variáveis de ambiente `OTEL_*`, portanto o formulário entra em vigor mesmo que Claude Code nessa sessão [nunca busque configurações do console de administração](#managed-settings).847 O formulário OpenTelemetry para Cowork em **Monitoring** nas [configurações de Dados e privacidade](https://claude.ai/admin-settings/data-privacy-controls) do console de administração se aplica apenas a sessões Cowork. Em uma sessão Cowork nesta máquina, o aplicativo desktop passa esse coletor para Claude Code como variáveis de ambiente `OTEL_*`, portanto o formulário entra em vigor mesmo que Claude Code nessa sessão [nunca busque configurações do console de administração](#managed-settings).

841 848 

842 Para exportar telemetria de sessões da aba Code, defina `CLAUDE_CODE_ENABLE_TELEMETRY` e as variáveis `OTEL_*` no bloco `env` de suas configurações gerenciadas de Claude Code, conforme mostrado em [configuração de administrador para monitoramento](/docs/pt/monitoring-usage#administrator-configuration). Sessões locais, em nuvem e SSH leem [configurações gerenciadas de diferentes fontes](#managed-settings). Para os hosts que uma sessão em nuvem pode alcançar, veja [acesso à rede](/docs/pt/cloud-environments#network-access). Para o `service.name` que sessões da aba Code relatam, veja [informações de serviço](/docs/pt/monitoring-usage#service-information).849 Para exportar telemetria de sessões da aba Code, defina `CLAUDE_CODE_ENABLE_TELEMETRY` e as variáveis `OTEL_*` no bloco `env` de suas configurações gerenciadas de Claude Code, conforme mostrado em [configuração de administrador para monitoramento](/docs/pt/monitoring-usage#administrator-configuration). Sessões locais, na nuvem e SSH leem [configurações gerenciadas de diferentes fontes](#managed-settings). Para os hosts que uma sessão na nuvem pode alcançar, veja [acesso à rede](/docs/pt/cloud-environments#network-access). Para o `service.name` que sessões da aba Code relatam, veja [informações de serviço](/docs/pt/monitoring-usage#service-information).

843</Note>850</Note>

844 851 

845<h3 id="managed-settings">852<h3 id="managed-settings">


858| `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |865| `disableBrowserExternalNavigation` | defina como `true` para desativar a navegação externa no [painel Browser](#browse-external-sites) inteiramente. Nem usuários nem Claude podem navegar para sites externos, e as visualizações do servidor localhost dev não são afetadas. O valor deve ser o booleano JSON `true`; a string `"true"` é ignorada. |

859| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no dropdown de ambiente. Usuários não podem editar ou excluir conexões gerenciadas. |866| `sshConfigs` | pré-configure [conexões SSH](#pre-configure-ssh-connections-for-your-team) que aparecem no dropdown de ambiente. Usuários não podem editar ou excluir conexões gerenciadas. |

860| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Uma matriz vazia desativa sessões SSH. Lido apenas de configurações gerenciadas. |867| `sshHostAllowlist` | restrinja [sessões SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cujo nome de host resolvido corresponde a um desses padrões. Uma matriz vazia desativa sessões SSH. Lido apenas de configurações gerenciadas. |

861| `disableDesktopLocalSessions` | defina como `true` para desativar [sessões Code que são executadas no dispositivo](#local-sessions-on-managed-devices), deixando sessões SSH para outros hosts e sessões em nuvem disponíveis. O valor deve ser o booleano JSON `true`. Lido apenas de configurações gerenciadas. Requer Claude Desktop v1.37937.0 ou posterior. |868| `disableDesktopLocalSessions` | defina como `true` para desativar [sessões Code que são executadas no dispositivo](#local-sessions-on-managed-devices), deixando sessões SSH para outros hosts e sessões na nuvem disponíveis. O valor deve ser o booleano JSON `true`. Lido apenas de configurações gerenciadas. Requer Claude Desktop v1.37937.0 ou posterior. |

862| `managedMcpServers` | envie configurações de servidor MCP para todos os usuários. Disponível apenas em implantações Desktop de terceiros (3P). Em cada entrada, defina um transporte de `"http"`, `"sse"` ou `"stdio"`, detalhes de conexão e opcionalmente um mapa `toolPolicy` para restringir quais ferramentas desse servidor os usuários podem invocar. Entregue através do arquivo de configurações gerenciadas, MDM ou da política de bloco [`desktop`](/docs/pt/claude-apps-gateway-config#claude-desktop-overlay) de um gateway de aplicativos Claude, já que implantações de terceiros não recebem configurações do console de administração. Para entregá-lo através do gateway, você precisa de Claude Code v2.1.232 ou posterior no servidor do gateway. Esta é a chave do próprio aplicativo desktop; Claude Code lê uma [configuração gerenciada de mesmo nome](/docs/pt/managed-mcp#provide-servers-through-managed-settings) de sua própria, com uma forma de entrada diferente. |869| `managedMcpServers` | envie configurações de servidor MCP para todos os usuários. Disponível apenas em implantações Desktop de terceiros (3P). Em cada entrada, defina um transporte de `"http"`, `"sse"` ou `"stdio"`, detalhes de conexão e opcionalmente um mapa `toolPolicy` para restringir quais ferramentas desse servidor os usuários podem invocar. Entregue através do arquivo de configurações gerenciadas, MDM ou do [bloco `desktop`](/docs/pt/claude-apps-gateway-config#claude-desktop-overlay) da política de um gateway de aplicativos Claude, já que implantações de terceiros não recebem configurações do console de administração. Para entregá-lo através do gateway, você precisa de Claude Code v2.1.232 ou posterior no servidor do gateway. Esta é a chave do próprio aplicativo desktop; Claude Code lê uma [configuração gerenciada de mesmo nome](/docs/pt/managed-mcp#provide-servers-through-managed-settings) própria, com uma forma de entrada diferente. |

863 870 

864Quais configurações gerenciadas alcançam uma sessão Desktop depende de onde essa sessão é executada. Restrições de modelo como [`availableModels`](/docs/pt/model-config#restrict-model-selection) são aplicadas em sessões Claude Code do Desktop da mesma forma que na CLI do terminal; veja [cobertura de superfície](/docs/pt/model-config#surface-coverage).871Quais configurações gerenciadas alcançam uma sessão Desktop depende de onde essa sessão é executada. Restrições de modelo como [`availableModels`](/docs/pt/model-config#restrict-model-selection) são aplicadas em sessões Claude Code do Desktop da mesma forma que na CLI do terminal; veja [cobertura de superfície](/docs/pt/model-config#surface-coverage).

865 872 

866* **Sessões locais nesta máquina**: um arquivo de configurações gerenciadas implantado em disco se aplica. Configurações gerenciadas enviadas remotamente através do console de administração também alcançam essas sessões na API da Anthropic quando a sessão se autentica com um [login ou chave elegível](/docs/pt/server-managed-settings#platform-availability), seguindo a mesma [precedência de configurações](/docs/pt/settings#settings-precedence) que a CLI do terminal.873* **Sessões locais nesta máquina**: um arquivo de configurações gerenciadas implantado em disco se aplica. Configurações gerenciadas enviadas remotamente através do console de administração também alcançam essas sessões na API da Anthropic quando a sessão se autentica com um [login ou chave elegível](/docs/pt/server-managed-settings#platform-availability), seguindo a mesma [precedência de configurações](/docs/pt/settings#settings-precedence) que a CLI do terminal.

867* **[Sessões em nuvem](#cloud-sessions)**: recebem [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings); arquivos implantados em dispositivos não as alcançam, porque são executadas em VMs gerenciadas pela Anthropic. Sessões roteadas para um [ambiente auto-hospedado](/docs/pt/self-hosted-environments) também leem o arquivo de configurações gerenciadas na imagem do executor. [Como Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) diz quando esse arquivo se aplica.874* **[Sessões na nuvem](#cloud-sessions)**: recebem [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings); arquivos implantados em dispositivos não as alcançam, porque são executadas em VMs gerenciadas pela Anthropic. Sessões roteadas para um [ambiente auto-hospedado](/docs/pt/self-hosted-environments) também leem o arquivo de configurações gerenciadas na imagem do executor. [Como Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) diz quando esse arquivo se aplica.

868* **[Sessões SSH](#ssh-sessions)**: a sessão lê o arquivo de configurações gerenciadas do host remoto. O Desktop em si lê `sshConfigs`, `sshHostAllowlist` e `disableDesktopLocalSessions` das configurações gerenciadas da máquina local.875* **[Sessões SSH](#ssh-sessions)**: a sessão lê o arquivo de configurações gerenciadas do host remoto. O Desktop em si lê `sshConfigs`, `sshHostAllowlist` e `disableDesktopLocalSessions` das configurações gerenciadas da máquina local.

869* **[Sessões Cowork](https://claude.com/docs/cowork/overview)**: em uma sessão Cowork nesta máquina, Claude Code nunca busca configurações do console de administração, mesmo quando o usuário se conecta com uma conta Team ou Enterprise, e lê a política implantada na máquina a menos que sua configuração Claude Desktop defina `requireCoworkFullVmSandbox`. Sessões Cowork remotas não recebem nenhuma. Veja [onde e quando uma política se aplica](/docs/pt/managed-settings#where-and-when-a-policy-applies) para quais arquivos de dispositivo alcançam Cowork, e [regras de permissão MCP](/docs/pt/permissions#mcp) para como as regras `Bash` e `WebFetch` se aplicam às ferramentas de Cowork.876* **[Sessões Cowork](https://claude.com/docs/cowork/overview)**: em uma sessão Cowork nesta máquina, Claude Code nunca busca configurações do console de administração, mesmo quando o usuário se conecta com uma conta Team ou Enterprise, e lê a política implantada na máquina a menos que sua configuração Claude Desktop defina `requireCoworkFullVmSandbox`. Sessões Cowork remotas não recebem nenhuma. Veja [onde e quando uma política se aplica](/docs/pt/managed-settings#where-and-when-a-policy-applies) para quais arquivos de dispositivo alcançam Cowork, e [regras de permissão MCP](/docs/pt/permissions#mcp) para como as regras `Bash` e `WebFetch` se aplicam às ferramentas de Cowork.

870 877 


872 879 

873`permissions.disableBypassPermissionsMode` e `disableAutoMode` também funcionam em configurações de usuário e projeto, mas colocá-los em configurações gerenciadas impede que usuários os sobrescrevam.880`permissions.disableBypassPermissionsMode` e `disableAutoMode` também funcionam em configurações de usuário e projeto, mas colocá-los em configurações gerenciadas impede que usuários os sobrescrevam.

874 881 

875Para a permissão, plugin e chaves de entrega que apenas uma fonte gerenciada pode definir, veja [Chaves que apenas configurações gerenciadas podem definir](/docs/pt/managed-settings#managed-only-settings).882Para as chaves de permissão, plugin e entrega que apenas uma fonte gerenciada pode definir, veja [Chaves que apenas configurações gerenciadas podem definir](/docs/pt/managed-settings#managed-only-settings).

876 883 

877<h3 id="device-management-policies">884<h3 id="device-management-policies">

878 Políticas de gerenciamento de dispositivos885 Políticas de gerenciamento de dispositivos


902*.claudemcpcontent.com909*.claudemcpcontent.com

903```910```

904 911 

905O tráfego é HTTPS na porta 443 a menos que você configure uma porta personalizada para [OTLP](/docs/pt/monitoring-usage), um gateway LLM ou um servidor MCP.912O tráfego é HTTPS na porta 443 a menos que você configure uma porta personalizada para [OTLP](/docs/pt/monitoring-usage), um gateway de LLM ou um servidor MCP.

906 913 

907Para servidores proxy, autoridades de certificado personalizadas, mTLS e os domínios que a CLI autônoma precisa, veja [configuração de rede](/docs/pt/network-config).914Para servidores proxy, autoridades de certificado personalizadas, mTLS e os domínios que a CLI autônoma precisa, veja [configuração de rede](/docs/pt/network-config).

908 915 


928*.claudemcpcontent.com935*.claudemcpcontent.com

929```936```

930 937 

931Se sua organização tiver [IP allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) ativado para Claude, rotear `bridge.claudeusercontent.com` através do mesmo proxy egress que `claude.ai` e `api.anthropic.com`. Se você não conseguir rotear dessa forma, adicione o endereço egress que seu proxy usa para esse host à lista de permissões de IP de sua organização, mas apenas quando esse endereço for dedicado à sua organização: um intervalo de proxy egress compartilhado também admite outros clientes do fornecedor de proxy.938Se sua organização tiver [IP allowlisting](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) ativado para Claude, roteie `bridge.claudeusercontent.com` através do mesmo proxy egress que `claude.ai` e `api.anthropic.com`. Se você não conseguir rotear dessa forma, adicione o endereço egress que seu proxy usa para esse host à allowlist de IP de sua organização, mas apenas quando esse endereço for dedicado à sua organização: um intervalo de proxy egress compartilhado também admite outros clientes do fornecedor de proxy.

932 939 

933A Anthropic verifica conexões para esse host contra a lista de permissões de IP de sua organização usando o endereço de onde chegam. Se seu proxy enviar tráfego para ele através de um endereço que não está nessa lista de permissões, Claude no Chrome e outros recursos que se conectam através da ponte deixam de funcionar enquanto o resto do aplicativo continua funcionando.940A Anthropic verifica conexões para esse host contra a allowlist de IP de sua organização usando o endereço de onde chegam. Se seu proxy enviar tráfego para ele através de um endereço que não está nessa allowlist, Claude no Chrome e outros recursos que se conectam através da ponte deixam de funcionar enquanto o resto do aplicativo continua funcionando.

934 941 

935Um [artefato](/docs/pt/artifacts) que carrega uma fonte tipográfica do [Google Fonts](/docs/pt/artifacts#improve-the-visual-design) também solicita `fonts.googleapis.com` e `fonts.gstatic.com`. Ambos os hosts são opcionais. Se você bloqueá-los, artefatos são renderizados em fontes tipográficas de fallback. Bloqueie com uma rejeição rápida em vez de uma queda silenciosa para que a solicitação de fonte falhe imediatamente em vez de atrasar a primeira renderização da página.942Um [artefato](/docs/pt/artifacts) que carrega uma fonte tipográfica do [Google Fonts](/docs/pt/artifacts#improve-the-visual-design) também faz requisições a `fonts.googleapis.com` e `fonts.gstatic.com`. Ambos os hosts são opcionais. Se você bloqueá-los, artefatos são renderizados em fontes tipográficas de fallback. Bloqueie com uma rejeição rápida em vez de uma queda silenciosa para que a requisição de fonte falhe imediatamente em vez de atrasar a primeira renderização da página.

936 943 

937Artefatos também podem carregar bibliotecas JavaScript, como React ou um pacote de gráficos, de `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com`, `code.jquery.com` e `unpkg.com`, e de nenhum outro host externo. Se você bloquear esses hosts, as partes de um artefato que dependem de uma biblioteca não funcionam, e diferentemente de uma fonte bloqueada, uma biblioteca bloqueada não tem fallback. Bloqueie com uma rejeição rápida aqui também, para que uma solicitação de biblioteca bloqueada falhe imediatamente em vez de ficar pendurada até expirar.944Artefatos também podem carregar bibliotecas JavaScript, como React ou um pacote de gráficos, de `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com`, `code.jquery.com` e `unpkg.com`, e de nenhum outro host externo. Se você bloquear esses hosts, as partes de um artefato que dependem de uma biblioteca não funcionam, e diferentemente de uma fonte bloqueada, uma biblioteca bloqueada não tem fallback. Bloqueie com uma rejeição rápida aqui também, para que uma requisição de biblioteca bloqueada falhe imediatamente em vez de ficar pendurada até expirar.

938 945 

939<h3 id="authentication-and-sso">946<h3 id="authentication-and-sso">

940 Autenticação e SSO947 Autenticação e SSO

941</h3>948</h3>

942 949 

943Organizações corporativas podem exigir SSO para todos os usuários. Veja [autenticação](/docs/pt/authentication) para detalhes de nível de plano e [Configurando SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) para configuração SAML; a configuração OIDC é coberta no [Guia do Administrador Corporativo Claude](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).950Organizações Team e Enterprise podem exigir SSO para todos os usuários. Veja [autenticação](/docs/pt/authentication) para detalhes de nível de plano e [Configurando SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) para configuração SAML; a configuração OIDC é coberta no [Guia do Administrador Corporativo Claude](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).

944 951 

945<h3 id="data-handling">952<h3 id="data-handling">

946 Manipulação de dados953 Manipulação de dados

947</h3>954</h3>

948 955 

949Claude Code processa seu código localmente em sessões locais ou em sessões em nuvem na infraestrutura gerenciada pela Anthropic, a menos que sua organização as rotear para um [ambiente auto-hospedado](/docs/pt/self-hosted-environments). Sessões em nuvem, incluindo em um ambiente auto-hospedado, enviam conversas e contexto de código para a API da Anthropic para processamento; sessões locais e SSH as enviam para qualquer [provedor de modelo](#feature-comparison) que sua implantação configure, a API da Anthropic por padrão. Veja [manipulação de dados](/docs/pt/data-usage) para detalhes sobre retenção de dados, privacidade e conformidade.956Claude Code processa seu código localmente em sessões locais ou em sessões na nuvem na infraestrutura gerenciada pela Anthropic, a menos que sua organização as roteie para um [ambiente auto-hospedado](/docs/pt/self-hosted-environments). Sessões na nuvem, incluindo em um ambiente auto-hospedado, enviam conversas e contexto de código para a API da Anthropic para processamento; sessões locais e SSH os enviam para qualquer [provedor de modelo](#feature-comparison) que sua implantação configure, a API da Anthropic por padrão. Veja [manipulação de dados](/docs/pt/data-usage) para detalhes sobre retenção de dados, privacidade e conformidade.

950 957 

951<h3 id="deployment">958<h3 id="deployment">

952 Implantação959 Implantação


957* **macOS**: distribua via MDM como Jamf ou Kandji usando o instalador `.dmg`964* **macOS**: distribua via MDM como Jamf ou Kandji usando o instalador `.dmg`

958* **Windows**: implante via pacote MSIX. Veja [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) para opções de implantação corporativa incluindo instalação silenciosa965* **Windows**: implante via pacote MSIX. Veja [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) para opções de implantação corporativa incluindo instalação silenciosa

959 966 

960Para os domínios a permitir na sua firewall, veja [requisitos de acesso à rede](#network-access-requirements) acima. Para configurações de proxy, autoridades de certificado personalizadas e gateways LLM, veja [configuração de rede](/docs/pt/network-config).967Para os domínios a adicionar à allowlist no seu firewall, veja [requisitos de acesso à rede](#network-access-requirements) acima. Para configurações de proxy, autoridades de certificado personalizadas e gateways de LLM, veja [configuração de rede](/docs/pt/network-config).

961 968 

962Para a referência completa de configuração corporativa, veja o [guia de configuração corporativa](https://support.claude.com/en/articles/12622667-enterprise-configuration).969Para a referência completa de configuração corporativa, veja o [guia de configuração corporativa](https://support.claude.com/en/articles/12622667-enterprise-configuration).

963 970 


1155 "Branch doesn't exist yet" ao abrir em CLI1162 "Branch doesn't exist yet" ao abrir em CLI

1156</h3>1163</h3>

1157 1164 

1158Sessões na nuvem podem criar branches que não existem em sua máquina local. Clique no nome do branch na barra de ferramentas da sessão para copiá-lo, depois busque-o localmente:1165Sessões na nuvem podem criar branches que não existem em sua máquina local. Clique no nome do branch na sessão e selecione **Copy branch name**, depois busque-o localmente:

1159 1166 

1160```bash theme={null}1167```bash theme={null}

1161git fetch origin <branch-name>1168git fetch origin <branch-name>

Details

77 77 

78Um dispositivo que Claude inicia também aparece no aplicativo Simulator da Apple, ou no Device Hub no Xcode 27. Claude pode instalar o aplicativo em um dispositivo que você já tem iniciado.78Um dispositivo que Claude inicia também aparece no aplicativo Simulator da Apple, ou no Device Hub no Xcode 27. Claude pode instalar o aplicativo em um dispositivo que você já tem iniciado.

79 79 

80Você também pode abrir o painel do simulador você mesmo. Depois que a sessão tem um simulador anexado ou editou arquivos Swift, o menu **Views** na barra de ferramentas da sessão mostra uma entrada **iOS Simulator**. Se o painel ainda não está mostrando um dispositivo, clique em **Attach simulator**, ou escolha um dispositivo específico no menu de dispositivos ao lado; escolher um dispositivo desligado o inicia. Se Xcode ou seus simuladores estão faltando, o painel mostra as etapas de configuração em vez disso e as marca conforme você as completa.80Você também pode abrir o painel do simulador você mesmo. Depois que a sessão tem um simulador anexado ou o Claude Code detecta trabalho em um aplicativo iOS, um botão **iOS Simulator** aparece na barra de título da sessão. Se o painel ainda não está mostrando um dispositivo, clique em **Attach simulator**, ou escolha um dispositivo específico no menu de dispositivos ao lado; escolher um dispositivo desligado o inicia. Se Xcode ou seus simuladores estão faltando, o painel mostra as etapas de configuração em vez disso e as marca conforme você as completa.

81 81 

82<h2 id="control-the-simulator-yourself">82<h2 id="control-the-simulator-yourself">

83 Controle o simulador você mesmo83 Controle o simulador você mesmo

Details

116 116 

117**Use skills para tarefas repetíveis.** Digite `/` ou clique em **+** → **Slash commands** para procurar [built-in commands](/docs/pt/commands), [custom skills](/docs/pt/skills) e skills de plugin. Skills são prompts reutilizáveis que você pode invocar sempre que precisar, como listas de verificação de revisão de código ou etapas de implantação.117**Use skills para tarefas repetíveis.** Digite `/` ou clique em **+** → **Slash commands** para procurar [built-in commands](/docs/pt/commands), [custom skills](/docs/pt/skills) e skills de plugin. Skills são prompts reutilizáveis que você pode invocar sempre que precisar, como listas de verificação de revisão de código ou etapas de implantação.

118 118 

119**Revise as alterações antes de fazer commit.** Depois que Claude edita arquivos, um indicador `+12 -1` aparece. Clique nele para abrir a [diff view](/docs/pt/desktop#review-changes-with-diff-view), revise as modificações arquivo por arquivo e comente em linhas específicas. Claude lê seus comentários e revisa. Clique em **Review code** para que Claude avalie os diffs em si e deixe sugestões inline.119**Revise as alterações antes de fazer commit.** Depois que Claude edita arquivos, um indicador `+12 -1` aparece. Clique nele para abrir a [diff view](/docs/pt/desktop#review-changes-with-diff-view), revise as modificações arquivo por arquivo e comente em linhas específicas. Claude lê seus comentários e revisa. Para que o próprio Claude revise as alterações, digite [`/code-review`](/docs/pt/desktop#review-your-code) na caixa de prompt.

120 120 

121**Ajuste quanto controle você tem.** Seu [permission mode](/docs/pt/desktop#choose-a-permission-mode) define quanto Claude pode fazer sem pedir aprovação:121**Ajuste quanto controle você tem.** Seu [permission mode](/docs/pt/desktop#choose-a-permission-mode) define quanto Claude pode fazer sem pedir aprovação:

122 122 

Details

83 83 

84Quando o aplicativo inicia ou seu computador acorda, o Desktop verifica se cada tarefa perdeu alguma execução nos últimos sete dias. Se perdeu, o Desktop inicia exatamente uma execução de recuperação para o horário mais recentemente perdido e descarta qualquer coisa mais antiga. Uma tarefa diária que perdeu seis dias é executada uma vez ao acordar. O Desktop mostra uma notificação quando uma execução de recuperação inicia.84Quando o aplicativo inicia ou seu computador acorda, o Desktop verifica se cada tarefa perdeu alguma execução nos últimos sete dias. Se perdeu, o Desktop inicia exatamente uma execução de recuperação para o horário mais recentemente perdido e descarta qualquer coisa mais antiga. Uma tarefa diária que perdeu seis dias é executada uma vez ao acordar. O Desktop mostra uma notificação quando uma execução de recuperação inicia.

85 85 

86Tenha isso em mente ao escrever prompts. Uma tarefa agendada para 9h pode ser executada às 23h se seu computador esteve dormindo o dia todo. Se o tempo importa, adicione proteções ao próprio prompt, por exemplo: "Revise apenas os commits de hoje. Se for depois das 17h, pule a revisão e apenas poste um resumo do que foi perdido."86Tenha isso em mente ao escrever prompts. Uma tarefa agendada para 9h pode ser executada às 23h se seu computador esteve dormindo o dia todo. Se o tempo importa, adicione proteções ao próprio prompt, por exemplo: "Revise apenas os commits de hoje. Se for depois das 17h, pule a revisão e poste um resumo do que foi perdido."

87 87 

88<h2 id="permissions-for-scheduled-tasks">88<h2 id="permissions-for-scheduled-tasks">

89 Permissões para tarefas agendadas89 Permissões para tarefas agendadas

env-vars.md +8 −4

Details

195| `BASH_DEFAULT_TIMEOUT_MS` | Timeout padrão para um comando em primeiro plano das ferramentas Bash ou PowerShell, em milissegundos (padrão: 120000, ou 2 minutos). Um padrão maior que 30 minutos também se torna o [limite de tempo padrão para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands) em sessões não supervisionadas. O limite de tempo em segundo plano requer o Claude Code v2.1.285 ou posterior |195| `BASH_DEFAULT_TIMEOUT_MS` | Timeout padrão para um comando em primeiro plano das ferramentas Bash ou PowerShell, em milissegundos (padrão: 120000, ou 2 minutos). Um padrão maior que 30 minutos também se torna o [limite de tempo padrão para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands) em sessões não supervisionadas. O limite de tempo em segundo plano requer o Claude Code v2.1.285 ou posterior |

196| `BASH_MAX_OUTPUT_LENGTH` | Número máximo de caracteres da saída do bash que o Claude Code lê de volta no resultado de um comando (padrão: 30000; máximo: 150000). Se você definir a configuração [`bashOutputMaxChars`](/docs/pt/settings-reference#bashoutputmaxchars), o Claude Code ignora esta variável. Consulte [Limites de saída](/docs/pt/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Número máximo de caracteres da saída do bash que o Claude Code lê de volta no resultado de um comando (padrão: 30000; máximo: 150000). Se você definir a configuração [`bashOutputMaxChars`](/docs/pt/settings-reference#bashoutputmaxchars), o Claude Code ignora esta variável. Consulte [Limites de saída](/docs/pt/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Timeout máximo que o modelo pode definir para um comando em primeiro plano das ferramentas Bash ou PowerShell, em milissegundos (padrão: 600000, ou 10 minutos). O teto efetivo é o maior entre este valor e `BASH_DEFAULT_TIMEOUT_MS`. Um teto efetivo maior que 2 horas também se torna o [limite de tempo máximo para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands) em sessões não supervisionadas. O limite de tempo em segundo plano requer o Claude Code v2.1.285 ou posterior |197| `BASH_MAX_TIMEOUT_MS` | Timeout máximo que o modelo pode definir para um comando em primeiro plano das ferramentas Bash ou PowerShell, em milissegundos (padrão: 600000, ou 10 minutos). O teto efetivo é o maior entre este valor e `BASH_DEFAULT_TIMEOUT_MS`. Um teto efetivo maior que 2 horas também se torna o [limite de tempo máximo para comandos em segundo plano](/docs/pt/tools-reference#time-limit-for-background-commands) em sessões não supervisionadas. O limite de tempo em segundo plano requer o Claude Code v2.1.285 ou posterior |

198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP para o [tracing beta detalhado](/docs/pt/monitoring-usage#traces-beta): com `ENABLE_BETA_TRACING_DETAILED=1`, logs e traces vão para ele em vez dos exportadores configurados. Defina-o no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorado nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP/HTTP para o [rastreamento beta detalhado](/docs/pt/monitoring-usage#traces-beta): com `ENABLE_BETA_TRACING_DETAILED=1`, logs e traces vão para ele em vez de para os exportadores configurados. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada em [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Defina como `1` para forçar o [`claude --cloud`](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github) a empacotar e enviar seu repositório local em vez de cloná-lo a partir do remoto |199| `CCR_FORCE_BUNDLE` | Defina como `1` para forçar o [`claude --cloud`](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github) a empacotar e enviar seu repositório local em vez de cloná-lo a partir do remoto |

200| `CLAUDECODE` | Definida como `1` em subprocessos que o Claude Code inicia (ferramentas Bash e PowerShell, sessões do tmux, comandos de [hook](/docs/pt/hooks), comandos da [linha de status](/docs/pt/statusline), subprocessos de [servidor MCP](/docs/pt/mcp) stdio). As extensões de IDE também a definem em seus terminais integrados. Use para detectar quando um script está sendo executado dentro de um subprocesso iniciado pelo Claude Code. Para verificar se o processo atual foi iniciado diretamente por uma chamada de ferramenta ou hook, e não dentro de um servidor MCP stdio que o Claude Code iniciou, use `CLAUDE_CODE_CHILD_SESSION` em vez disso |200| `CLAUDECODE` | Definida como `1` em subprocessos que o Claude Code inicia (ferramentas Bash e PowerShell, sessões do tmux, comandos de [hook](/docs/pt/hooks), comandos da [linha de status](/docs/pt/statusline), subprocessos de [servidor MCP](/docs/pt/mcp) stdio). As extensões de IDE também a definem em seus terminais integrados. Use para detectar quando um script está sendo executado dentro de um subprocesso iniciado pelo Claude Code. Para verificar se o processo atual foi iniciado diretamente por uma chamada de ferramenta ou hook, e não dentro de um servidor MCP stdio que o Claude Code iniciou, use `CLAUDE_CODE_CHILD_SESSION` em vez disso |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Quantos milissegundos antes da continuação automática a contagem regressiva na tela aparece em um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondido. Padrão `20000` (20 segundos), limitado ao timeout de continuação automática. Não tem efeito a menos que a continuação automática esteja ativada; consulte a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Requer o Claude Code v2.1.198 ou posterior |201| `CLAUDE_AFK_COUNTDOWN_MS` | Quantos milissegundos antes da continuação automática a contagem regressiva na tela aparece em um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) não respondido. Padrão `20000` (20 segundos), limitado ao timeout de continuação automática. Não tem efeito a menos que a continuação automática esteja ativada; consulte a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Requer o Claude Code v2.1.198 ou posterior |


287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Defina como `1` para iniciar os comandos da [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) no Windows diretamente, em vez de por meio do launcher `cmd.exe`. Por padrão, o launcher permite que um comando PowerShell [em execução em segundo plano](/docs/pt/tools-reference#background-commands) [seja transferido para o próximo processo da sessão](/docs/pt/agent-view#the-supervisor-process), como quando você [envia a sessão para segundo plano](/docs/pt/agent-view#from-inside-a-session). Se você definir a variável, um comando PowerShell em segundo plano é interrompido quando o processo da sessão é encerrado. Comandos Bash não são afetados. Requer o Claude Code v2.1.269 ou posterior |287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Defina como `1` para iniciar os comandos da [ferramenta PowerShell](/docs/pt/tools-reference#powershell-tool) no Windows diretamente, em vez de por meio do launcher `cmd.exe`. Por padrão, o launcher permite que um comando PowerShell [em execução em segundo plano](/docs/pt/tools-reference#background-commands) [seja transferido para o próximo processo da sessão](/docs/pt/agent-view#the-supervisor-process), como quando você [envia a sessão para segundo plano](/docs/pt/agent-view#from-inside-a-session). Se você definir a variável, um comando PowerShell em segundo plano é interrompido quando o processo da sessão é encerrado. Comandos Bash não são afetados. Requer o Claude Code v2.1.269 ou posterior |

288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Defina como `1` para desativar os [workflows](/docs/pt/workflows#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](/docs/pt/settings-reference#disableworkflows) |288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Defina como `1` para desativar os [workflows](/docs/pt/workflows#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](/docs/pt/settings-reference#disableworkflows) |

289| `CLAUDE_CODE_EFFORT_LEVEL` | Define o nível de esforço para os modelos compatíveis. Valores: `low`, `medium`, `high`, `xhigh`, `max` ou `auto` para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre `--effort`, `/effort` e as configurações `modelSettings` e `effortLevel`. Um limite de [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel) ainda se aplica. Consulte [Ajustar o nível de esforço](/docs/pt/model-config#adjust-effort-level) |289| `CLAUDE_CODE_EFFORT_LEVEL` | Define o nível de esforço para os modelos compatíveis. Valores: `low`, `medium`, `high`, `xhigh`, `max` ou `auto` para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre `--effort`, `/effort` e as configurações `modelSettings` e `effortLevel`. Um limite de [`maxEffortLevel`](/docs/pt/settings-reference#maxeffortlevel) ainda se aplica. Consulte [Ajustar o nível de esforço](/docs/pt/model-config#adjust-effort-level) |

290| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Defina como `1` para adicionar ao fluxo de mensagens as mensagens [`session_state_changed`](/docs/pt/agent-sdk/typescript#sdksessionstatechangedmessage), que contêm o estado da sessão. Requer o [Agent SDK](/docs/pt/agent-sdk/overview) ou `--print`, `--output-format stream-json` e `--verbose` |

290| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Aceita para compatibilidade com versões mais antigas e não tem efeito. O modo auto está disponível por padrão em todos os provedores, incluindo Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e sessões do [Claude apps gateway](/docs/pt/claude-apps-gateway) com login feito. Da v2.1.158 até a v2.1.206, definir esta variável como `1` era necessário para disponibilizar o [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) nesses provedores |291| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Aceita para compatibilidade com versões mais antigas e não tem efeito. O modo auto está disponível por padrão em todos os provedores, incluindo Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e sessões do [Claude apps gateway](/docs/pt/claude-apps-gateway) com login feito. Da v2.1.158 até a v2.1.206, definir esta variável como `1` era necessário para disponibilizar o [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) nesses provedores |

291| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sobrescreve a disponibilidade do [resumo da sessão](/docs/pt/interactive-mode#session-recap). Defina como `0` para forçar a desativação dos resumos independentemente da opção em `/config`. Defina como `1` para forçar a ativação dos resumos quando [`awaySummaryEnabled`](/docs/pt/settings-reference#awaysummaryenabled) for `false`. Tem precedência sobre a configuração e sobre a opção em `/config` |292| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sobrescreve a disponibilidade do [resumo da sessão](/docs/pt/interactive-mode#session-recap). Defina como `0` para forçar a desativação dos resumos independentemente da opção em `/config`. Defina como `1` para forçar a ativação dos resumos quando [`awaySummaryEnabled`](/docs/pt/settings-reference#awaysummaryenabled) for `false`. Tem precedência sobre a configuração e sobre a opção em `/config` |

292| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Defina como `1` para atualizar o estado dos plugins nos limites de turno no [modo não interativo](/docs/pt/headless) após a conclusão de uma instalação em segundo plano. Desativado por padrão porque a atualização altera o system prompt no meio da sessão, o que invalida o [cache de prompt](/docs/pt/prompt-caching) daquele turno |293| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Defina como `1` para atualizar o estado dos plugins nos limites de turno no [modo não interativo](/docs/pt/headless) após a conclusão de uma instalação em segundo plano. Desativado por padrão porque a atualização altera o system prompt no meio da sessão, o que invalida o [cache de prompt](/docs/pt/prompt-caching) daquele turno |


314| `CLAUDE_CODE_GLOB_NO_IGNORE` | Defina como `false` para fazer a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior) respeitar os padrões do `.gitignore`. Por padrão, o Glob retorna todos os arquivos correspondentes, incluindo os ignorados pelo Git. Não afeta o preenchimento automático de arquivos com `@`, que tem sua própria [configuração `respectGitignore`](/docs/pt/settings-reference#respectgitignore) |315| `CLAUDE_CODE_GLOB_NO_IGNORE` | Defina como `false` para fazer a [ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior) respeitar os padrões do `.gitignore`. Por padrão, o Glob retorna todos os arquivos correspondentes, incluindo os ignorados pelo Git. Não afeta o preenchimento automático de arquivos com `@`, que tem sua própria [configuração `respectGitignore`](/docs/pt/settings-reference#respectgitignore) |

315| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout em segundos para a descoberta de arquivos da ferramenta Glob. O padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |316| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout em segundos para a descoberta de arquivos da ferramenta Glob. O padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |

316| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Quantos minutos o trabalho em segundo plano pode manter um objetivo ativo aguardando antes que o Claude Code [peça ao Claude para verificá-lo](/docs/pt/goal#background-work-defers-evaluation). Padrão `30`. Defina `0` para desativar as verificações. Informe minutos inteiros em dígitos simples, no máximo `10080`, que equivale a uma semana. O Claude Code trata qualquer outro valor como não definido e usa o padrão. Requer o Claude Code v2.1.234 ou posterior |317| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Quantos minutos o trabalho em segundo plano pode manter um objetivo ativo aguardando antes que o Claude Code [peça ao Claude para verificá-lo](/docs/pt/goal#background-work-defers-evaluation). Padrão `30`. Defina `0` para desativar as verificações. Informe minutos inteiros em dígitos simples, no máximo `10080`, que equivale a uma semana. O Claude Code trata qualquer outro valor como não definido e usa o padrão. Requer o Claude Code v2.1.234 ou posterior |

318| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Defina como `0` para desativar a compressão gzip dos corpos de requisição da API do Claude, de telemetria e de publicação de [artefatos](/docs/pt/artifacts) enviados para `api.anthropic.com`. Por padrão, o Claude Code comprime corpos de requisição grandes em conexões diretas e ignora a compressão quando você envia requisições por um proxy, configura um certificado de cliente ou define `NODE_EXTRA_CA_CERTS`. Use `0` se um [proxy com inspeção de TLS](/docs/pt/network-config#ca-certificate-store) que o Claude Code não consegue detectar tratar incorretamente requisições comprimidas |

317| `CLAUDE_CODE_HIDE_CWD` | Defina como `1` para ocultar o diretório de trabalho no logotipo de inicialização. Útil para compartilhamentos de tela ou gravações em que o caminho expõe seu nome de usuário do sistema operacional |319| `CLAUDE_CODE_HIDE_CWD` | Defina como `1` para ocultar o diretório de trabalho no logotipo de inicialização. Útil para compartilhamentos de tela ou gravações em que o caminho expõe seu nome de usuário do sistema operacional |

318| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sobrescreve o endereço de host usado para conectar à extensão da IDE. Por padrão, o Claude Code detecta automaticamente o endereço correto, incluindo o roteamento do WSL para o Windows |320| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sobrescreve o endereço de host usado para conectar à extensão da IDE. Por padrão, o Claude Code detecta automaticamente o endereço correto, incluindo o roteamento do WSL para o Windows |

319| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para pular a instalação automática de extensões de IDE. Equivalente a definir [`autoInstallIdeExtension`](/docs/pt/settings-reference#autoinstallideextension) como `false` |321| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para pular a instalação automática de extensões de IDE. Equivalente a definir [`autoInstallIdeExtension`](/docs/pt/settings-reference#autoinstallideextension) como `false` |


460| `DISABLE_UPDATES` | Defina como `1` para bloquear todas as atualizações, incluindo `claude update` e `claude install` manuais. Mais restritiva que `DISABLE_AUTOUPDATER`. Use ao distribuir o Claude Code pelos seus próprios canais quando os usuários não devem se atualizar por conta própria |462| `DISABLE_UPDATES` | Defina como `1` para bloquear todas as atualizações, incluindo `claude update` e `claude install` manuais. Mais restritiva que `DISABLE_AUTOUPDATER`. Use ao distribuir o Claude Code pelos seus próprios canais quando os usuários não devem se atualizar por conta própria |

461| `DISABLE_UPGRADE_COMMAND` | Defina como `1` para ocultar o comando `/upgrade` |463| `DISABLE_UPGRADE_COMMAND` | Defina como `1` para ocultar o comando `/upgrade` |

462| `DO_NOT_TRACK` | Defina como `1` para desativar a telemetria, com o mesmo efeito de `DISABLE_TELEMETRY`, inclusive sobre a [busca de feature flags](#features-that-need-feature-flag-fetching). O Claude Code lê esta variável como um booleano padrão, então `0` mantém a telemetria ativada, e a respeita como a convenção entre ferramentas reconhecida por muitas CLIs de desenvolvimento |464| `DO_NOT_TRACK` | Defina como `1` para desativar a telemetria, com o mesmo efeito de `DISABLE_TELEMETRY`, inclusive sobre a [busca de feature flags](#features-that-need-feature-flag-fetching). O Claude Code lê esta variável como um booleano padrão, então `0` mantém a telemetria ativada, e a respeita como a convenção entre ferramentas reconhecida por muitas CLIs de desenvolvimento |

463| `ENABLE_BETA_TRACING_DETAILED` | Defina como `1`, junto com `BETA_TRACING_ENDPOINT`, para ativar o [tracing beta detalhado](/docs/pt/monitoring-usage#traces-beta), que adiciona atributos de span com conteúdo e o span `claude_code.hook`. Sessões interativas da CLI também exigem que sua organização esteja na lista de permissões do beta. Ambas as variáveis são ignoradas nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |465| `ENABLE_BETA_TRACING_DETAILED` | Defina como `1`, e defina `BETA_TRACING_ENDPOINT` como o endpoint do seu coletor OTLP/HTTP, para ativar o [tracing beta detalhado](/docs/pt/monitoring-usage#traces-beta), que adiciona atributos de span com conteúdo e o span `claude_code.hook`. Sessões interativas da CLI também exigem que sua organização esteja na lista de permissões do beta. Ambas as variáveis são ignoradas nas [configurações de projeto e locais](/docs/pt/settings-reference#variables-claude-code-ignores-in-env) |

464| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para impedir que o Claude Code busque os [servidores MCP do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai). Ativada por padrão para usuários conectados. Para desativar por projeto ou por organização, defina [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors) nas configurações |466| `ENABLE_CLAUDEAI_MCP_SERVERS` | Defina como `false` para impedir que o Claude Code busque os [servidores MCP do claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai). Ativada por padrão para usuários conectados. Para desativar por projeto ou por organização, defina [`disableClaudeAiConnectors`](/docs/pt/settings-reference#disableclaudeaiconnectors) nas configurações |

465| `ENABLE_PROMPT_CACHING_1H` | Defina como `1` para solicitar um [TTL de cache de prompt](/docs/pt/prompt-caching#cache-lifetime) de 1 hora em vez dos 5 minutos padrão. Destinada a usuários de chave de API, [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Usuários de assinatura dentro do uso incluído recebem o TTL de 1 hora automaticamente na [conversa principal](/docs/pt/prompt-caching#which-ttl-each-request-gets). Usuários de assinatura que utilizam [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) podem defini-la para manter o TTL de 1 hora. Gravações de cache de 1 hora são cobradas a uma taxa mais alta. Para escolher o TTL por grupo de requisições, use `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que têm precedência sobre esta variável |467| `ENABLE_PROMPT_CACHING_1H` | Defina como `1` para solicitar um [TTL de cache de prompt](/docs/pt/prompt-caching#cache-lifetime) de 1 hora em vez dos 5 minutos padrão. Destinada a usuários de chave de API, [Amazon Bedrock](/docs/pt/amazon-bedrock), [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai), [Microsoft Foundry](/docs/pt/microsoft-foundry) e [Claude Platform on AWS](/docs/pt/claude-platform-on-aws). Usuários de assinatura dentro do uso incluído recebem o TTL de 1 hora automaticamente na [conversa principal](/docs/pt/prompt-caching#which-ttl-each-request-gets). Usuários de assinatura que utilizam [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) podem defini-la para manter o TTL de 1 hora. Gravações de cache de 1 hora são cobradas a uma taxa mais alta. Para escolher o TTL por grupo de requisições, use `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que têm precedência sobre esta variável |

466| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuada. Use `ENABLE_PROMPT_CACHING_1H` em vez dela |468| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Descontinuada. Use `ENABLE_PROMPT_CACHING_1H` em vez dela |


534 O que a limpeza do ambiente de subprocessos remove536 O que a limpeza do ambiente de subprocessos remove

535</h2>537</h2>

536 538 

537Quando você define [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](#variables) como `1`, o Claude Code remove credenciais dos ambientes dos subprocessos que ele inicia, como comandos Bash, hooks e servidores MCP stdio. Isso reduz o que um ataque de injeção de prompt pode ler por meio de expansão do shell. O processo do Claude Code mantém as credenciais para suas próprias chamadas de API.539Quando você define [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](#variables) como `1`, o Claude Code remove credenciais dos ambientes dos subprocessos que ele inicia, como comandos Bash, hooks e servidores MCP stdio. Isso reduz o que um ataque de injeção de prompt pode ler. O processo do Claude Code mantém as credenciais para suas próprias chamadas de API.

538 540 

539A limpeza reconhece uma credencial pelo nome da variável ou pelo formato do seu valor, portanto use-a como uma camada junto com [regras de permissão](/docs/pt/permissions) restritas, e não como o único controle.541A limpeza reconhece uma credencial pelo nome da variável ou pelo formato do seu valor, portanto use-a como uma camada junto com [regras de permissão](/docs/pt/permissions) restritas, e não como o único controle.

540 542 


546| `NPM_TOKEN`, `DB_PASSWORD` | Remove a variável, porque o nome parece uma credencial |548| `NPM_TOKEN`, `DB_PASSWORD` | Remove a variável, porque o nome parece uma credencial |

547| `DATABASE_URL` que contém uma senha | Remove a variável, porque o valor parece uma credencial |549| `DATABASE_URL` que contém uma senha | Remove a variável, porque o valor parece uma credencial |

548| `PIP_INDEX_URL` ou `NPM_CONFIG_REGISTRY` que contém uma senha | Mantém a URL e remove dela o nome de usuário e a senha |550| `PIP_INDEX_URL` ou `NPM_CONFIG_REGISTRY` que contém uma senha | Mantém a URL e remove dela o nome de usuário e a senha |

549| `CLAUDE_CONFIG_DIR` | Remove a variável. Requer Claude Code v2.1.251 ou posterior |551| `CLAUDE_CONFIG_DIR` | Remove a variável |

550| `GITHUB_TOKEN`, `GH_TOKEN`, `GH_ENTERPRISE_TOKEN`, `GITHUB_ENTERPRISE_TOKEN` | Mantém a variável, para que o `gh` e os scripts que chamam a API do GitHub continuem funcionando |552| `GITHUB_TOKEN`, `GH_TOKEN`, `GH_ENTERPRISE_TOKEN`, `GITHUB_ENTERPRISE_TOKEN` | Mantém a variável, para que o `gh` e os scripts que chamam a API do GitHub continuem funcionando |

551| `HTTP_PROXY`, `HTTPS_PROXY` | Mantém a variável, incluindo um [nome de usuário e senha na URL](/docs/pt/network-config#basic-authentication). O [sandbox](/docs/pt/sandboxing#network-isolation) pode definir essas variáveis por conta própria para comandos executados em sandbox |553| `HTTP_PROXY`, `HTTPS_PROXY` | Mantém a variável, incluindo um [nome de usuário e senha na URL](/docs/pt/network-config#basic-authentication). O [sandbox](/docs/pt/sandboxing#network-isolation) pode definir essas variáveis por conta própria para comandos executados em sandbox |

552| `GIT_CONFIG_COUNT`, `GIT_CONFIG_KEY_<n>`, `GIT_CONFIG_VALUE_<n>` | Mantém a variável, seja qual for o seu conteúdo |554| `GIT_CONFIG_COUNT`, `GIT_CONFIG_KEY_<n>`, `GIT_CONFIG_VALUE_<n>` | Mantém a variável, seja qual for o seu conteúdo |


558 560 

559No Linux, a limpeza também executa subprocessos Bash em um namespace de PID isolado, para que eles não possam ler os ambientes dos processos do host por meio de `/proc`. Como efeito colateral, `ps`, `pgrep` e `kill` não conseguem ver nem enviar sinais para processos do host.561No Linux, a limpeza também executa subprocessos Bash em um namespace de PID isolado, para que eles não possam ler os ambientes dos processos do host por meio de `/proc`. Como efeito colateral, `ps`, `pgrep` e `kill` não conseguem ver nem enviar sinais para processos do host.

560 562 

563Antes da v2.1.251, a limpeza removia `ANTHROPIC_API_KEY` e `AWS_SECRET_ACCESS_KEY` e deixava inalteradas as demais variáveis de exemplo da tabela.

564 

561<h2 id="features-that-need-feature-flag-fetching">565<h2 id="features-that-need-feature-flag-fetching">

562 Recursos que precisam da busca de feature flags566 Recursos que precisam da busca de feature flags

563</h2>567</h2>

Details

51 51 

52Estes requerem login com uma conta claude.ai e não são acessíveis com uma chave de API Anthropic Console ou de um provedor terceirizado:52Estes requerem login com uma conta claude.ai e não são acessíveis com uma chave de API Anthropic Console ou de um provedor terceirizado:

53 53 

54* [Claude Code na web](/docs/pt/claude-code-on-the-web), Claude Code no celular e [Claude Code no Slack](/docs/pt/slack)54* [Sessões na nuvem](/docs/pt/claude-code-on-the-web) e Claude Code no celular

55* [Claude Code no Slack](/docs/pt/slack): planos Pro e Max

55* [Claude Code Desktop](/docs/pt/desktop)56* [Claude Code Desktop](/docs/pt/desktop)

56* [Routines](/docs/pt/routines) (`/schedule`)57* [Routines](/docs/pt/routines) (`/schedule`)

57* [Ultrareview](/docs/pt/ultrareview)58* [Ultrareview](/docs/pt/ultrareview)


303 304 

304Se você se autenticar através de Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou uma chave de API Anthropic Console, esta seção não se aplica a você. Quando você faz login com uma conta claude.ai, seu plano determina quais dos recursos abaixo estão disponíveis.305Se você se autenticar através de Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou uma chave de API Anthropic Console, esta seção não se aplica a você. Quando você faz login com uma conta claude.ai, seu plano determina quais dos recursos abaixo estão disponíveis.

305 306 

307Em organizações Enterprise com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada, alguns recursos desta tabela são desativados.

308 

306| Recurso | Pro | Max | Team | Enterprise |309| Recurso | Pro | Max | Team | Enterprise |

307| :- | :- | :- | :- | :- |310| :- | :- | :- | :- | :- |

308| [Cloud sessions](/docs/pt/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |311| [Cloud sessions](/docs/pt/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |

fullscreen.md +8 −7

Details

100 100 

101* **Click in the prompt input** to position your cursor anywhere in the text you're typing.101* **Click in the prompt input** to position your cursor anywhere in the text you're typing.

102* **Click a suggestion in the `/` command or `@` file list** to accept it. Hovering highlights the row under your cursor.102* **Click a suggestion in the `/` command or `@` file list** to accept it. Hovering highlights the row under your cursor.

103* **Click an option in a select menu** to choose it. This covers permission prompts, `/model`, `/config`, and other dialogs that show a list of options. Hovering shows a pointer on the row under your cursor.103* **Clique em uma opção em um menu de seleção** para escolhê-la. Isso abrange prompts de permissão, `/model`, `/config` e outros diálogos que mostram uma lista de opções.

104* **Click an option in a multi-select menu** to toggle it, and click the submit button to confirm your choices. Clicking a free-text row, such as the `Other` row in a multiple-choice question, focuses its input field so you can type an answer. Requires Claude Code v2.1.208 or later.104* **Click an option in a multi-select menu** to toggle it, and click the submit button to confirm your choices. Clicking a free-text row, such as the `Other` row in a multiple-choice question, focuses its input field so you can type an answer. Requires Claude Code v2.1.208 or later.

105* **Click a setting's value in the `/config` panel** to change it, and scroll the settings list with the mouse wheel. Requires Claude Code v2.1.271 or later.105* **Click a setting's value in the `/config` panel** to change it, and scroll the settings list with the mouse wheel. Requires Claude Code v2.1.271 or later.

106* **Scroll a select or multi-select menu with the mouse wheel** when it has more options than it shows at once, such as the `/model` list in a short terminal window. The wheel scrolls the list while the pointer is over its options. Requires Claude Code v2.1.280 or later.106* **Scroll a select or multi-select menu with the mouse wheel** when it has more options than it shows at once, such as the `/model` list in a short terminal window. The wheel scrolls the list while the pointer is over its options. Requires Claude Code v2.1.280 or later.


110* **Clique em um resultado de ferramenta recolhido** para expandi-lo e ver a saída completa. Clique novamente para recolhê-lo. A chamada de ferramenta e seu resultado são expandidos juntos. Apenas mensagens que têm mais conteúdo a mostrar são clicáveis.110* **Clique em um resultado de ferramenta recolhido** para expandi-lo e ver a saída completa. Clique novamente para recolhê-lo. A chamada de ferramenta e seu resultado são expandidos juntos. Apenas mensagens que têm mais conteúdo a mostrar são clicáveis.

111 * Clicar também expande a saída de um comando de shell `!`, seja um resultado truncado mais antigo ou a linha de progresso ao vivo enquanto o comando é executado. Requer Claude Code v2.1.257 ou posterior.111 * Clicar também expande a saída de um comando de shell `!`, seja um resultado truncado mais antigo ou a linha de progresso ao vivo enquanto o comando é executado. Requer Claude Code v2.1.257 ou posterior.

112 * Clicar também expande uma linha esmaecida `Message from @<sender>` quando o remetente é um [colega de equipe](/docs/pt/agent-teams) ou outro agente em execução na sua sessão.112 * Clicar também expande uma linha esmaecida `Message from @<sender>` quando o remetente é um [colega de equipe](/docs/pt/agent-teams) ou outro agente em execução na sua sessão.

113* **Hold `Cmd` on macOS, or `Ctrl` on Linux and Windows, and click a URL or file path** to open it. Plain `http://` and `https://` URLs open in your browser, and file paths in tool output, like the ones printed after an Edit or Write, open in your default application. A plain click without the modifier doesn't open links, matching native terminal behavior.113* **Mantenha `Cmd` pressionado no macOS, ou `Ctrl` no Linux e no Windows, e clique em uma URL ou caminho de arquivo** para abri-lo. URLs simples `http://` e `https://` são abertas no seu navegador. Quando o Claude Code trata o clique, caminhos de arquivo na saída de ferramentas, como os exibidos após um Edit ou Write, são abertos no seu gerenciador de arquivos com o arquivo selecionado. Um clique simples sem o modificador não abre links, seguindo o comportamento nativo do terminal.

114 * Claude Code renders a network (UNC) path, such as `\\server\share\file.ts`, as plain text with no link, because opening a network path can send your Windows credentials to the host it names.114 * No Linux e no WSL, clicar em um caminho de arquivo requer um gerenciador de arquivos que forneça a interface D-Bus `org.freedesktop.FileManager1`. Sem um, nada é aberto.

115 * Some macOS terminals forward `Cmd`+click to the running app instead of opening the link themselves, and the terminal mouse protocol has no way to encode the `Cmd` key, so Claude Code receives a plain click. In Ghostty, and in Warp on macOS, Claude Code detects this and lets a plain click on a link open it, and holding `Cmd` still works.115 * O Claude Code renderiza um caminho de rede (UNC), como `\\server\share\file.ts`, como texto simples sem link, porque abrir um caminho de rede pode enviar suas credenciais do Windows para o host que ele indica.

116 * In the VS Code integrated terminal and similar xterm.js-based terminals, Claude Code defers to the terminal's own link handler, which uses the same gesture.116 * Alguns terminais do macOS encaminham `Cmd`+clique para o aplicativo em execução em vez de abrirem o link eles mesmos, e o protocolo de mouse do terminal não tem como codificar a tecla `Cmd`, então o Claude Code recebe um clique simples. No Ghostty, e no Warp no macOS, o Claude Code detecta isso e permite que um clique simples em um link o abra, e manter `Cmd` pressionado continua funcionando.

117 * No terminal integrado do VS Code e em terminais semelhantes baseados em xterm.js, o Claude Code delega ao manipulador de links do próprio terminal, que usa o mesmo gesto.

117* **Click and drag** to select text anywhere in the conversation. Double-click selects a word, matching iTerm2's word boundaries so a file path selects as one unit. Double-clicking a URL selects the whole URL, including the scheme. Triple-click selects the line.118* **Click and drag** to select text anywhere in the conversation. Double-click selects a word, matching iTerm2's word boundaries so a file path selects as one unit. Double-clicking a URL selects the whole URL, including the scheme. Triple-click selects the line.

118* **Scroll with the mouse wheel** to move through the conversation.119* **Scroll with the mouse wheel** to move through the conversation.

119 120 


130* **Any other key, including plain arrow keys, `Enter`, and typed characters**: Claude Code clears the selection.131* **Any other key, including plain arrow keys, `Enter`, and typed characters**: Claude Code clears the selection.

131* **A key bound to [`selection:clear`](/docs/pt/keybindings#scroll-actions)**: Claude Code clears the selection, even when the key is `Esc` or another key that otherwise keeps it. The action has no default binding.132* **A key bound to [`selection:clear`](/docs/pt/keybindings#scroll-actions)**: Claude Code clears the selection, even when the key is `Esc` or another key that otherwise keeps it. The action has no default binding.

132 133 

133In [transcript mode](#search-and-review-the-conversation), the navigation and search keys listed there also keep the selection.134No [modo de transcrição](#search-and-review-the-conversation), as teclas de navegação listadas lá também mantêm a seleção.

134 135 

135<h2 id="scroll-the-conversation">136<h2 id="scroll-the-conversation">

136 Rolar a conversa137 Rolar a conversa


187 188 

188Um valor de `3` corresponde ao padrão em `vim` e aplicativos similares. A configuração aceita qualquer valor positivo até 20, incluindo valores fracionários abaixo de 1, como `0.25` para desacelerar a rolagem de trackpad e roda do mouse acelerada em terminais que já amplificam eventos de roda.189Um valor de `3` corresponde ao padrão em `vim` e aplicativos similares. A configuração aceita qualquer valor positivo até 20, incluindo valores fracionários abaixo de 1, como `0.25` para desacelerar a rolagem de trackpad e roda do mouse acelerada em terminais que já amplificam eventos de roda.

189 190 

190Para ajustar a velocidade de rolagem interativamente, execute `/scroll-speed`. O diálogo mostra uma régua que você pode rolar enquanto está aberto para que você possa sentir a mudança imediatamente. Pressione `←` e `→` para ajustar a velocidade, `r` para redefinir para o padrão detectado automaticamente e `Enter` para salvar. O diálogo avança em números inteiros até 10, e em terminais que suportam controle mais fino, também oferece passos de um quarto até 0,25.191Para ajustar a velocidade de rolagem interativamente, execute `/scroll-speed`. Role enquanto o diálogo está aberto para sentir a mudança imediatamente. Pressione `←` e `→` para ajustar a velocidade, `r` para redefinir para o padrão detectado automaticamente e `Enter` para salvar. O diálogo avança em números inteiros até 10, e em terminais que suportam controle mais fino, também oferece passos de um quarto até 0,25.

191 192 

192O comando escreve o mesmo valor que a variável de ambiente `CLAUDE_CODE_SCROLL_SPEED` define, persistido em `~/.claude/settings.json`. O máximo do diálogo é 10: se você definir um valor mais alto através da variável de ambiente, o diálogo mostra 10, e salvar a partir do diálogo persiste 10. O comando não está disponível no terminal IDE JetBrains.193O comando escreve o mesmo valor que a variável de ambiente `CLAUDE_CODE_SCROLL_SPEED` define, persistido em `~/.claude/settings.json`. O máximo do diálogo é 10: se você definir um valor mais alto através da variável de ambiente, o diálogo mostra 10, e salvar a partir do diálogo persiste 10. O comando não está disponível no terminal IDE JetBrains.

193 194 

Details

326 326 

327Conceda ao fluxo de trabalho apenas as permissões que ele precisa e revise as alterações de Claude antes de fazer merge.327Conceda ao fluxo de trabalho apenas as permissões que ele precisa e revise as alterações de Claude antes de fazer merge.

328 328 

329Para orientação abrangente de segurança incluindo permissões e autenticação, consulte a [documentação de segurança da Claude Code Action](https://github.com/anthropics/claude-code-action/blob/main/docs/security.md).329Para orientação de segurança incluindo permissões e autenticação, consulte a [documentação de segurança da Claude Code Action](https://github.com/anthropics/claude-code-action/blob/main/docs/security.md).

330 330 

331<h3 id="manage-costs">331<h3 id="manage-costs">

332 Gerencie custos332 Gerencie custos

glossary.md +1 −1

Details

499 Verification loop499 Verification loop

500</h3>500</h3>

501 501 

502Como uma sessão sabe que o trabalho está realmente feito em vez de apenas plausível. Você dá a Claude uma verificação que ele pode executar, como um conjunto de testes, uma compilação ou uma comparação de screenshot, e Claude itera até que a verificação passe em vez de parar após uma tentativa. Um verification loop é o pré-requisito para [`/goal`](/docs/pt/goal), execuções desassistidas e [dynamic workflows](/docs/pt/workflows): sem um, a única coisa decidindo que o agente terminou é o próprio agente.502Como uma sessão sabe que o trabalho está realmente concluído em vez de aceitar um resultado que apenas parece plausível. Você dá a Claude uma verificação que ele pode executar, como um conjunto de testes, uma compilação ou uma comparação de screenshot, e Claude itera até que a verificação passe em vez de parar após uma tentativa. Um loop de verificação é o pré-requisito para [`/goal`](/docs/pt/goal), execuções desassistidas e [dynamic workflows](/docs/pt/workflows): sem um, a única coisa decidindo que o agente terminou é o próprio agente.

503 503 

504Saiba mais: [Give Claude a way to verify its work](/docs/pt/best-practices#give-claude-a-way-to-verify-its-work)504Saiba mais: [Give Claude a way to verify its work](/docs/pt/best-practices#give-claude-a-way-to-verify-its-work)

505 505 

headless.md +1 −1

Details

206 206 

207Se seu consumidor ler o stream lentamente, Claude Code aguarda a fila de saída drenar antes de sair, dimensionando a espera com o quanto ainda está na fila, limitado a 30 segundos. Antes da v2.1.214, a espera de saída era limitada a cerca de dois segundos, o que poderia cortar o final de uma resposta grande.207Se seu consumidor ler o stream lentamente, Claude Code aguarda a fila de saída drenar antes de sair, dimensionando a espera com o quanto ainda está na fila, limitado a 30 segundos. Antes da v2.1.214, a espera de saída era limitada a cerca de dois segundos, o que poderia cortar o final de uma resposta grande.

208 208 

209O exemplo a seguir usa [jq](https://jqlang.org/) para filtrar deltas de texto e exibir apenas o texto de streaming. O sinalizador `-r` produz strings brutas (sem aspas) e `-j` une sem quebras de linha para que os tokens façam streaming continuamente:209O exemplo a seguir usa [jq](https://jqlang.org/) para filtrar deltas de texto e exibir apenas o texto de streaming. A flag `-r` produz strings brutas (sem aspas) e `-j` une sem quebras de linha para que os tokens façam streaming continuamente:

210 210 

211```bash theme={null}211```bash theme={null}

212claude -p "Write a poem" --output-format stream-json --verbose --include-partial-messages | \212claude -p "Write a poem" --output-format stream-json --verbose --include-partial-messages | \

hipaa-setup.md +13 −6

Details

15 * Claude Code na aba Code do Claude Desktop15 * Claude Code na aba Code do Claude Desktop

16 * Cowork no Claude Desktop16 * Cowork no Claude Desktop

17 17 

18 As extensões do Claude Code para VS Code e JetBrains não fazem parte do (modo local). Elas continuam funcionando com a configuração HIPAA aplicada, mas o seu BAA não as cobre. Consulte o [Implementation Guide](https://trust.anthropic.com/resources?s=rgirr4qe8u7ek8c2igx3\&name=claude-for-enterprise-hipaa-ready-offering-implementation-guide) para a lista completa de Eligible Services.18 As extensões do Claude Code para VS Code e JetBrains não fazem parte do (modo local). Elas continuam funcionando com a configuração HIPAA aplicada, mas o seu BAA não as cobre. Consulte o [Implementation Guide](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para a lista completa de Eligible Services.

19</Note>19</Note>

20 20 

21Esta página é destinada ao administrador de TI ou de segurança que prepara os computadores dos desenvolvedores. O Primary Owner da sua organização Claude aplica a configuração em si. [Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan](https://support.claude.com/en/articles/17318731) explica o que o seu BAA inclui, como a configuração é aplicada e como agendar a data em que ela é aplicada.21Esta página é destinada ao administrador de TI ou de segurança que prepara os computadores dos desenvolvedores. O Primary Owner da sua organização Claude aplica a configuração em si. [Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan](https://support.claude.com/en/articles/17318731) explica o que o seu BAA inclui, como a configuração é aplicada e como agendar a data em que ela é aplicada.


174 174 

175* **Logins do Claude Console e credenciais de federação**: `forceLoginOrgUUID` verifica apenas logins do claude.ai. [Restringir o login à sua organização](/docs/pt/authentication#restrict-login-to-your-organization) lista o que o Claude Code verifica para cada caminho de login e credencial.175* **Logins do Claude Console e credenciais de federação**: `forceLoginOrgUUID` verifica apenas logins do claude.ai. [Restringir o login à sua organização](/docs/pt/authentication#restrict-login-to-your-organization) lista o que o Claude Code verifica para cada caminho de login e credencial.

176* **Configurações gerenciadas pelo servidor**: se a sua organização também usa [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings), peça a um Owner que adicione as mesmas chaves lá. [Como o Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) explica qual fonte se aplica.176* **Configurações gerenciadas pelo servidor**: se a sua organização também usa [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings), peça a um Owner que adicione as mesmas chaves lá. [Como o Claude Code combina fontes gerenciadas](/docs/pt/managed-settings#how-claude-code-combines-managed-sources) explica qual fonte se aplica.

177* **Versões anteriores à v2.1.285**: essas versões ignoram `allowedProviders`, portanto ainda podem iniciar em um provedor de nuvem ou em um gateway. Para fazer com que as versões v2.1.163 a v2.1.284 se recusem a iniciar, você pode adicionar [`requiredMinimumVersion`](/docs/pt/settings-reference#requiredminimumversion) definido como `"2.1.285"` às mesmas configurações gerenciadas que as [chaves de exemplo](#deploy-managed-settings). Versões anteriores à v2.1.163 ignoram `requiredMinimumVersion`, além de `allowedProviders`, então [atualize esses computadores](#update-claude-code-and-claude-desktop).

177 178 

178Para descobrir se o seu BAA cobre uma sessão executada sem a configuração HIPAA, consulte [Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan](https://support.claude.com/en/articles/17318731).179Para descobrir se o seu BAA cobre uma sessão executada sem a configuração HIPAA, consulte [Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan](https://support.claude.com/en/articles/17318731).

179 180 


209 210 

210Se `HIPAA` estiver ausente de `/status`, verifique estas causas na ordem:211Se `HIPAA` estiver ausente de `/status`, verifique estas causas na ordem:

211 212 

2121. **A conta ou a conexão errada**: confirme que `/status` mostra a sua organização na linha `Organization` e não mostra nenhuma linha `API provider` ou `Anthropic base URL`. [Verificar como os desenvolvedores fazem login e se conectam](#check-how-developers-sign-in-and-connect) lista as conexões que não são elegíveis para a configuração.2131. **A conta ou a conexão errada**: confirme que `/status` mostra a sua organização na linha `Organization` e não mostra nenhuma linha `API provider` ou `Anthropic base URL`. [Verificar como os desenvolvedores fazem login e se conectam](#check-how-developers-sign-in-and-connect) lista quais métodos de login e de conexão não são elegíveis para a configuração.

2132. **Uma busca de política bloqueada**: procure uma linha `Organization policy` em `/status`, que informa a causa. Fora de uma sessão, execute `claude doctor` e leia a mesma linha, que informa de onde o Claude Code carregou a política ou por que a política não foi carregada. Permita `api.anthropic.com` através do seu proxy e, em seguida, reinicie o Claude Code.2142. **Uma busca de política bloqueada**: procure uma linha `Organization policy` em `/status`, que informa a causa. Fora de uma sessão, execute `claude doctor` e leia a mesma linha, que informa de onde o Claude Code carregou a política ou por que a política não foi carregada. Permita `api.anthropic.com` através do seu proxy e, em seguida, reinicie o Claude Code.

2143. **A configuração ainda não foi aplicada**: pergunte ao Primary Owner se ele já aplicou a configuração.2153. **A configuração ainda não foi aplicada**: pergunte ao Primary Owner se ele já aplicou a configuração.

215 216 


234 235 

235Com a configuração HIPAA aplicada, o Claude Code remove as credenciais que usa para acessar a Anthropic, como `ANTHROPIC_API_KEY` e `ANTHROPIC_AUTH_TOKEN`, do ambiente dos comandos de shell, hooks e servidores MCP que ele inicia.236Com a configuração HIPAA aplicada, o Claude Code remove as credenciais que usa para acessar a Anthropic, como `ANTHROPIC_API_KEY` e `ANTHROPIC_AUTH_TOKEN`, do ambiente dos comandos de shell, hooks e servidores MCP que ele inicia.

236 237 

237A configuração HIPAA não remove credenciais de provedores de nuvem nem do GitHub, então um comando que faz push para o GitHub ou chama outro serviço continua funcionando com o acesso daquele desenvolvedor. O seu BAA com a Anthropic não cobre os dados que ele envia para lá. Consulte o [Implementation Guide](https://trust.anthropic.com/resources?s=rgirr4qe8u7ek8c2igx3\&name=claude-for-enterprise-hipaa-ready-offering-implementation-guide) para a lista completa de Eligible Services.238A configuração HIPAA não remove credenciais de provedores de nuvem nem do GitHub, então um comando que faz push para o GitHub ou chama outro serviço continua funcionando com o acesso daquele desenvolvedor. O seu BAA com a Anthropic não cobre os dados que ele envia para lá. Consulte o [Implementation Guide](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para a lista completa de Eligible Services.

238 239 

239Para limitar quais comandos e hosts o Claude pode usar, consulte [regras de permissão](/docs/pt/permissions) e o [sandbox](/docs/pt/sandboxing).240Para limitar quais comandos e hosts o Claude pode usar, consulte [regras de permissão](/docs/pt/permissions) e o [sandbox](/docs/pt/sandboxing).

240 241 


275 Excluir dados de sessão imediatamente276 Excluir dados de sessão imediatamente

276</h3>277</h3>

277 278 

278Se a sua organização precisar que os dados de sessão de um desenvolvedor sejam removidos antes que a limpeza de retenção os exclua, você pode remover a maior parte deles com um comando. Faça login no computador como esse desenvolvedor e execute este comando em qualquer shell:279Se a sua organização precisar que os dados de sessão de um desenvolvedor sejam removidos antes que a limpeza de retenção os exclua, você pode remover a maior parte deles com um comando. Faça login no computador como esse desenvolvedor, abra qualquer shell e execute o comando correspondente à versão do Claude Code instalada.

280 

281No Claude Code v2.1.288 ou posterior, execute `claude purge`:

279 282 

280```bash theme={null}283```bash theme={null}

281claude purge --all --yes284claude purge --all --yes

282```285```

283 286 

284Antes da v2.1.288, o comando era `claude project purge`.287Da v2.1.126 até a v2.1.287, execute `claude project purge`, que aceita as mesmas flags:

288 

289```bash theme={null}

290claude project purge --all --yes

291```

285 292 

286O comando exclui as transcrições e a memória automática de todos os projetos, as entradas em `tasks/`, `debug/` e `file-history/`, `history.jsonl` e as entradas de projeto em `~/.claude.json`. Sem `--yes`, ele imprime o plano e pede confirmação primeiro.293Qualquer um dos comandos exclui as transcrições e a memória automática de todos os projetos, as entradas em `tasks/`, `debug/` e `file-history/`, `history.jsonl` e as entradas de projeto em `~/.claude.json`. Sem `--yes`, ele imprime o plano e pede confirmação primeiro.

287 294 

288A limpeza deixa outros caminhos que podem conter conteúdo de sessão, como texto colado em `paste-cache/`. [Limpar dados locais](/docs/pt/claude-directory#clear-local-data) lista os caminhos que você pode excluir manualmente. Para limpar um computador completamente, por exemplo antes de reatribuí-lo, [apague-o](#offboard-a-developer).295A limpeza deixa outros caminhos que podem conter conteúdo de sessão, como texto colado em `paste-cache/`. [Limpar dados locais](/docs/pt/claude-directory#clear-local-data) lista os caminhos que você pode excluir manualmente. Para limpar um computador completamente, por exemplo antes de reatribuí-lo, [apague-o](#offboard-a-developer).

289 296 

hooks.md +6 −42

Details

14 14 

15Um plugin também pode registrar hooks como funções JavaScript que o Claude Code chama em seu próprio processo, que podem desenhar na interface, bem como agir sobre eventos. Um plugin que faz isso é um [mod](/docs/pt/plugins/mods/overview), e esses hooks de função são cobertos em [Reagir a eventos](/docs/pt/plugins/mods/events) em vez de aqui. Os hooks nesta página continuam funcionando junto com mods.15Um plugin também pode registrar hooks como funções JavaScript que o Claude Code chama em seu próprio processo, que podem desenhar na interface, bem como agir sobre eventos. Um plugin que faz isso é um [mod](/docs/pt/plugins/mods/overview), e esses hooks de função são cobertos em [Reagir a eventos](/docs/pt/plugins/mods/events) em vez de aqui. Os hooks nesta página continuam funcionando junto com mods.

16 16 

17| Evento | Quando dispara |

18| :- | :- |

19| `SessionStart` | Quando uma sessão começa ou é retomada |

20| `Setup` | Quando você inicia Claude Code com `--init-only`, ou com `--init` ou `--maintenance` no modo `-p`. Para preparação única em CI ou scripts |

21| `UserPromptSubmit` | Quando um prompt é enviado, antes de Claude processá-lo. Também dispara em [turnos que Claude Code inicia por conta própria](/docs/pt/hooks#userpromptsubmit) |

22| `UserPromptExpansion` | Quando um comando digitado pelo usuário se expande em um prompt, antes de chegar a Claude. Pode bloquear a expansão |

23| `PreToolUse` | Antes de uma chamada de ferramenta ser executada. Pode bloqueá-la |

24| `PermissionRequest` | Quando uma chamada de ferramenta precisa de uma decisão de permissão |

25| `PermissionDenied` | Quando o modo automático nega uma chamada de ferramenta, incluindo negações sem um veredicto do classificador. Use JSON `hookSpecificOutput.retry: true` para informar ao modelo que ele pode tentar novamente a chamada de ferramenta negada. Claude Code ignora `retry` quando o classificador não produziu veredicto |

26| `PostToolUse` | Depois que uma chamada de ferramenta é bem-sucedida |

27| `PostToolUseFailure` | Depois que uma chamada de ferramenta falha |

28| `PostToolBatch` | Depois que um lote completo de chamadas de ferramenta paralelas é resolvido, antes da próxima chamada do modelo |

29| `Notification` | Quando Claude Code envia uma notificação |

30| `MessageDisplay` | Enquanto o texto da mensagem do assistente está sendo exibido |

31| `SubagentStart` | Quando um subagente é criado |

32| `SubagentStop` | Quando um subagente termina |

33| `TaskCreated` | Quando uma tarefa está sendo criada via `TaskCreate` |

34| `TaskCompleted` | Quando uma tarefa está sendo marcada como concluída |

35| `Stop` | Quando Claude termina de responder |

36| `StopFailure` | Quando a rodada termina devido a um erro de API |

37| `TeammateIdle` | Quando um colega de [equipe de agentes](/docs/pt/agent-teams) está prestes a ficar ocioso |

38| `InstructionsLoaded` | Quando um arquivo CLAUDE.md ou `.claude/rules/*.md` é carregado no contexto. Dispara no início da sessão e quando os arquivos são carregados lentamente durante uma sessão |

39| `ConfigChange` | Quando um arquivo de configuração muda durante uma sessão |

40| `CwdChanged` | Quando o diretório de trabalho muda, por exemplo quando Claude executa um comando `cd`. Útil para gerenciamento reativo do ambiente com ferramentas como direnv |

41| `DirectoryAdded` | Quando um diretório de trabalho é adicionado no meio da sessão via `/add-dir` ou a solicitação de controle SDK `register_repo_root` |

42| `FileChanged` | Quando um arquivo observado muda no disco. O campo `matcher` especifica quais nomes de arquivo observar |

43| `WorktreeCreate` | Quando um worktree está sendo criado via `--worktree`, `isolation: "worktree"`, ou para uma sessão em segundo plano. Substitui o comportamento padrão do git |

44| `WorktreeRemove` | Quando um worktree está sendo removido na saída da sessão, quando um subagente termina, ou quando você exclui uma sessão em segundo plano |

45| `PreCompact` | Antes da compactação de contexto |

46| `PostCompact` | Depois que a compactação de contexto é concluída |

47| `PreModelSwitch` | Antes de Claude Code aplicar uma mudança de modelo que você ou um cliente solicitou. Pode bloquear a mudança |

48| `PostModelSwitch` | Depois que o modelo da sessão muda, incluindo mudanças que Claude Code faz por conta própria, como restaurar o modelo quando você retoma uma sessão |

49| `Elicitation` | Quando um servidor MCP solicita entrada do usuário durante uma chamada de ferramenta |

50| `ElicitationResult` | Depois que um usuário responde a uma elicitação MCP, antes da resposta ser enviada de volta ao servidor |

51| `SessionEnd` | Quando uma sessão é encerrada |

52 

53<h2 id="hook-lifecycle">17<h2 id="hook-lifecycle">

54 Ciclo de vida do hook18 Ciclo de vida do hook

55</h2>19</h2>


310 274 

311Para detalhes sobre resolução de arquivo de configurações, consulte [settings](/docs/pt/settings).275Para detalhes sobre resolução de arquivo de configurações, consulte [settings](/docs/pt/settings).

312 276 

313Hooks de arquivos de configurações, configurações de política gerenciada e plugins também executam dentro de [subagentes](/docs/pt/sub-agents). Quando um subagente chama uma ferramenta, eventos de ferramenta como `PreToolUse` e `PostToolUse` disparam os mesmos hooks configurados que na conversa principal, e a entrada carrega os campos de entrada comuns `agent_id` e `agent_type` [](#common-input-fields) que identificam o subagente.277Hooks de arquivos de configurações, configurações de política gerenciada e plugins também executam dentro de [subagentes](/docs/pt/sub-agents). Quando um subagente chama uma ferramenta, eventos de ferramenta como `PreToolUse` e `PostToolUse` disparam os mesmos hooks configurados que na conversa principal, e a entrada carrega os [campos de entrada comuns](#common-input-fields) `agent_id` e `agent_type` que identificam o subagente.

314 278 

315Administradores podem usar [`allowManagedHooksOnly`](/docs/pt/settings-reference#allowmanagedhooksonly) em [configurações gerenciadas](/docs/pt/managed-settings) para restringir quais hooks executam:279Administradores podem usar [`allowManagedHooksOnly`](/docs/pt/settings-reference#allowmanagedhooksonly) em [configurações gerenciadas](/docs/pt/managed-settings) para restringir quais hooks executam:

316 280 


808| Campo | Descrição |772| Campo | Descrição |

809| :- | :- |773| :- | :- |

810| `session_id` | Identificador de sessão atual |774| `session_id` | Identificador de sessão atual |

811| `prompt_id` | UUID identificando o prompt do usuário sendo processado atualmente. Corresponde ao [atributo `prompt.id` em eventos OpenTelemetry](/docs/pt/monitoring-usage#event-correlation-attributes), para que você possa correlacionar saída de hook com telemetria para um único prompt. Ausente até a primeira entrada do usuário. Requer Claude Code v2.1.196 ou posterior |775| `prompt_id` | UUID identificando o prompt do usuário sendo processado atualmente. Corresponde ao [atributo `prompt.id` em eventos OpenTelemetry](/docs/pt/monitoring-usage#event-correlation-attributes), para que você possa correlacionar saída de hook com telemetria para um único prompt. Ausente até a primeira entrada do usuário |

812| `transcript_path` | Caminho para JSON de conversa. O arquivo de transcrição é escrito de forma assíncrona e pode ficar atrás da conversa na memória, portanto pode não incluir ainda as mensagens mais recentes da rodada atual quando um hook dispara. Hooks que precisam do texto final do assistente da rodada atual devem usar `last_assistant_message` em [Stop](#stop) e [SubagentStop](#subagentstop) em vez de ler a transcrição |776| `transcript_path` | Caminho para JSON de conversa. O arquivo de transcrição é escrito de forma assíncrona e pode ficar atrás da conversa na memória, portanto pode não incluir ainda as mensagens mais recentes da rodada atual quando um hook dispara. Hooks que precisam do texto final do assistente da rodada atual devem usar `last_assistant_message` em [Stop](#stop) e [SubagentStop](#subagentstop) em vez de ler a transcrição |

813| `cwd` | Diretório de trabalho atual quando o hook é invocado |777| `cwd` | Diretório de trabalho atual quando o hook é invocado |

814| `scratchpad_dir` | Caminho para o [diretório scratchpad da sessão](/docs/pt/claude-directory#session-scratchpad-directory), onde Claude mantém arquivos de trabalho temporários. Ausente quando a sessão não tem scratchpad ou o diretório temporário não está disponível. Requer Claude Code v2.1.257 ou posterior |778| `scratchpad_dir` | Caminho para o [diretório scratchpad da sessão](/docs/pt/claude-directory#session-scratchpad-directory), onde Claude mantém arquivos de trabalho temporários. Ausente quando a sessão não tem scratchpad ou o diretório temporário não está disponível. Requer Claude Code v2.1.257 ou posterior |


1395 1359 

1396Os hooks Setup não podem bloquear; a execução continua com qualquer código de saída. Em todo código de saída, o Claude Code descarta os [campos de saída JSON](#json-output) de um hook Setup, como `systemMessage`, `continue` e `hookSpecificOutput.additionalContext`. Com `-p`, o stdout, o stderr e o código de saída de um hook Setup aparecem na saída da execução somente como [eventos `hook_response`](/docs/pt/headless#read-session-metadata) quando você inicia com `--output-format stream-json --verbose`.1360Os hooks Setup não podem bloquear; a execução continua com qualquer código de saída. Em todo código de saída, o Claude Code descarta os [campos de saída JSON](#json-output) de um hook Setup, como `systemMessage`, `continue` e `hookSpecificOutput.additionalContext`. Com `-p`, o stdout, o stderr e o código de saída de um hook Setup aparecem na saída da execução somente como [eventos `hook_response`](/docs/pt/headless#read-session-metadata) quando você inicia com `--output-format stream-json --verbose`.

1397 1361 

1398Os hooks Setup têm acesso a `CLAUDE_ENV_FILE`. As variáveis gravadas nesse arquivo persistem nos comandos Bash subsequentes da sessão, assim como nos [hooks SessionStart](#persist-environment-variables). Somente hooks `type: "command"` são executados em `Setup`. Um hook `type: "mcp_tool"` em `Setup` é sempre ignorado, conforme descrito em [Campos de hook de ferramenta MCP](#mcp-tool-hook-fields).1362Os hooks Setup têm acesso a `CLAUDE_ENV_FILE`. As variáveis gravadas nesse arquivo persistem nos comandos Bash subsequentes da sessão, como nos [hooks SessionStart](#persist-environment-variables). Somente hooks `type: "command"` são executados no `Setup`. Um hook `type: "mcp_tool"` no `Setup` é sempre ignorado, conforme descrito em [campos de hook de ferramenta MCP](#mcp-tool-hook-fields).

1399 1363 

1400<h3 id="instructionsloaded">1364<h3 id="instructionsloaded">

1401 InstructionsLoaded1365 InstructionsLoaded

1402</h3>1366</h3>

1403 1367 

1404É disparado quando um arquivo `CLAUDE.md` ou `.claude/rules/*.md` é carregado no contexto. Este evento é disparado no início da sessão para arquivos carregados de forma antecipada e novamente mais tarde quando arquivos são carregados de forma tardia, por exemplo quando o Claude acessa um subdiretório que contém um `CLAUDE.md` aninhado ou quando regras condicionais com frontmatter `paths:` correspondem. O hook não suporta bloqueio nem controle de decisão. Ele é executado de forma assíncrona para fins de observabilidade.1368É disparado quando um arquivo `CLAUDE.md` ou `.claude/rules/*.md` é carregado no contexto. Este evento é disparado no início da sessão para arquivos carregados antecipadamente e novamente mais tarde quando arquivos são carregados sob demanda, por exemplo quando o Claude acessa um subdiretório que contém um `CLAUDE.md` aninhado ou quando regras condicionais com frontmatter `paths:` correspondem. O hook não suporta bloqueio nem controle de decisão. Ele é executado de forma assíncrona para fins de observabilidade.

1405 1369 

1406Este evento não é disparado quando o Claude [lê `AGENTS.md` diretamente](/docs/pt/memory#agents-md) por meio da configuração **Project instructions**. Ele é disparado quando um `CLAUDE.md` importa seu `AGENTS.md`, com `load_reason` definido como `include`, como para qualquer outro arquivo importado, e quando `CLAUDE.md` é um link simbólico para ele, como um carregamento normal de `CLAUDE.md`.1370Este evento não é disparado quando o Claude [lê `AGENTS.md` diretamente](/docs/pt/memory#agents-md) por meio da configuração **Project instructions**. Ele é disparado quando um `CLAUDE.md` importa seu `AGENTS.md`, com `load_reason` definido como `include`, como para qualquer outro arquivo importado, e quando `CLAUDE.md` é um link simbólico para ele, como um carregamento normal de `CLAUDE.md`.

1407 1371 


1521 O que um prompt bloqueado deixa para trás1485 O que um prompt bloqueado deixa para trás

1522</h4>1486</h4>

1523 1487 

1524Um prompt bloqueado nunca chega ao Claude, mas seu texto não é removido de todos os lugares. Por padrão, a mensagem de bloqueio mostrada ao usuário termina com `Original prompt:` seguido do texto enviado, e o Claude Code grava essa mensagem no arquivo de transcrição da sessão no disco. Para deixar o texto fora da mensagem, imprima JSON com `"suppressOriginalPrompt": true` dentro de `hookSpecificOutput`. Isso funciona tanto se o hook bloquear com `decision: "block"` quanto saindo com 2. Um hook com saída 2 que não imprime JSON sempre recebe o texto do prompt em sua mensagem de bloqueio.1488Um prompt bloqueado nunca chega ao Claude, mas seu texto não é removido de todos os lugares. Por padrão, a mensagem de bloqueio mostrada ao usuário termina com `Original prompt:` seguido do texto enviado, e o Claude Code grava essa mensagem no arquivo de transcrição da sessão em disco. Para omitir o texto da mensagem, imprima JSON com `"suppressOriginalPrompt": true` dentro de `hookSpecificOutput`. Isso funciona tanto se o hook bloquear com `decision: "block"` quanto saindo com 2.

1525 1489 

1526`suppressOriginalPrompt` altera apenas a mensagem de bloqueio. O texto enviado ainda pode aparecer em arquivos locais, como a transcrição da sessão e seu histórico de prompts, então um hook de bloqueio não é uma forma de manter um segredo fora do disco. Para limitar ou remover esses arquivos, consulte [Armazenamento em texto simples](/docs/pt/claude-directory#plaintext-storage) e [Limpar dados locais](/docs/pt/claude-directory#clear-local-data).1490`suppressOriginalPrompt` altera apenas a mensagem de bloqueio. O texto enviado ainda pode aparecer em arquivos locais, como a transcrição da sessão e seu histórico de prompts, então um hook de bloqueio não é uma forma de manter um segredo fora do disco. Para limitar ou remover esses arquivos, consulte [Armazenamento em texto simples](/docs/pt/claude-directory#plaintext-storage) e [Limpar dados locais](/docs/pt/claude-directory#clear-local-data).

1527 1491 


2176| `addRules` | `rules`, `behavior`, `destination` | Adiciona regras de permissão. `rules` é um array de objetos `{toolName, ruleContent?}`. Omita `ruleContent` para corresponder à ferramenta inteira. `behavior` é `"allow"`, `"deny"` ou `"ask"` |2140| `addRules` | `rules`, `behavior`, `destination` | Adiciona regras de permissão. `rules` é um array de objetos `{toolName, ruleContent?}`. Omita `ruleContent` para corresponder à ferramenta inteira. `behavior` é `"allow"`, `"deny"` ou `"ask"` |

2177| `replaceRules` | `rules`, `behavior`, `destination` | Substitui todas as regras do `behavior` informado no `destination` pelas `rules` fornecidas |2141| `replaceRules` | `rules`, `behavior`, `destination` | Substitui todas as regras do `behavior` informado no `destination` pelas `rules` fornecidas |

2178| `removeRules` | `rules`, `behavior`, `destination` | Remove as regras correspondentes do `behavior` informado |2142| `removeRules` | `rules`, `behavior`, `destination` | Remove as regras correspondentes do `behavior` informado |

2179| `setMode` | `mode`, `destination` | Altera o modo de permissão. Os modos válidos são `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` e `manual` como alias de `default`. O alias `manual` exige o Claude Code v2.1.200 ou posterior |2143| `setMode` | `mode`, `destination` | Altera o modo de permissão. Os modos válidos são `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` e `manual` como alias para `default` |

2180| `addDirectories` | `directories`, `destination` | Adiciona diretórios de trabalho. `directories` é um array de strings de caminho |2144| `addDirectories` | `directories`, `destination` | Adiciona diretórios de trabalho. `directories` é um array de strings de caminho |

2181| `removeDirectories` | `directories`, `destination` | Remove diretórios de trabalho |2145| `removeDirectories` | `directories`, `destination` | Remove diretórios de trabalho |

2182 2146 

Details

215| `$` | Fim da linha |215| `$` | Fim da linha |

216| `^` | Primeiro caractere não em branco |216| `^` | Primeiro caractere não em branco |

217| `gg` | Início da entrada |217| `gg` | Início da entrada |

218| `G` | Fim da entrada |218| `G` | Início da última linha |

219| `f{char}` | Pular para a próxima ocorrência do caractere |219| `f{char}` | Pular para a próxima ocorrência do caractere |

220| `F{char}` | Pular para a ocorrência anterior do caractere |220| `F{char}` | Pular para a ocorrência anterior do caractere |

221| `t{char}` | Pular para logo antes da próxima ocorrência do caractere |221| `t{char}` | Pular para logo antes da próxima ocorrência do caractere |


355* As tarefas em segundo plano são limpas automaticamente quando Claude Code sai. No macOS e Linux, quando você interrompe uma tarefa em segundo plano de [`/tasks`](/docs/pt/commands) ou Claude Code a interrompe ao sair, os processos que se desvincularam do shell da tarefa, como aqueles iniciados sob `setsid` ou `timeout`, também param355* As tarefas em segundo plano são limpas automaticamente quando Claude Code sai. No macOS e Linux, quando você interrompe uma tarefa em segundo plano de [`/tasks`](/docs/pt/commands) ou Claude Code a interrompe ao sair, os processos que se desvincularam do shell da tarefa, como aqueles iniciados sob `setsid` ou `timeout`, também param

356* Se você colocar a sessão em segundo plano em vez de sair dela, suas tarefas em segundo plano continuarão sendo executadas na sessão em segundo plano. Veja [colocar uma sessão em execução em segundo plano](/docs/pt/agent-view#from-inside-a-session)356* Se você colocar a sessão em segundo plano em vez de sair dela, suas tarefas em segundo plano continuarão sendo executadas na sessão em segundo plano. Veja [colocar uma sessão em execução em segundo plano](/docs/pt/agent-view#from-inside-a-session)

357* As tarefas em segundo plano são automaticamente encerradas se a saída exceder 5GB, com uma nota em stderr explicando o motivo357* As tarefas em segundo plano são automaticamente encerradas se a saída exceder 5GB, com uma nota em stderr explicando o motivo

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

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

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

361* Comandos em segundo plano em uma sessão local na qual você trabalha a partir de um terminal, do aplicativo desktop ou da extensão do VS Code não têm limite de tempo. Em uma sessão executada sem supervisão, como uma execução com `-p` ou uma sessão na nuvem, Claude Code interrompe um comando em segundo plano ao atingir seu [limite de tempo](/docs/pt/tools-reference#time-limit-for-background-commands)361* Comandos em segundo plano em uma sessão local na qual você trabalha a partir de um terminal, do aplicativo desktop ou da extensão do VS Code não têm limite de tempo. Em uma sessão executada sem supervisão, como uma execução com `-p` ou uma sessão na nuvem, Claude Code interrompe um comando em segundo plano ao atingir seu [limite de tempo](/docs/pt/tools-reference#time-limit-for-background-commands)

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

363 363 


390* Suporta o mesmo backgrounding `Ctrl+B` para comandos de longa duração390* Suporta o mesmo backgrounding `Ctrl+B` para comandos de longa duração

391* Não requer que Claude interprete ou aprove o comando391* Não requer que Claude interprete ou aprove o comando

392* Suporta preenchimento automático baseado em histórico: digite um comando parcial e pressione `Tab` para completar a partir de comandos `!` anteriores no projeto atual392* Suporta preenchimento automático baseado em histórico: digite um comando parcial e pressione `Tab` para completar a partir de comandos `!` anteriores no projeto atual

393* Suporta preenchimento automático de caminho de arquivo ao vivo a partir da v2.1.193 em todas as plataformas: digite um token contendo uma barra, como `./src/` ou `~/`, para ver uma lista suspensa de arquivos e diretórios correspondentes, depois pressione `Tab` para aceitar. Use barras para frente no Windows também; a lista suspensa é acionada por `/`, não `\`393* Suporta preenchimento automático de caminho de arquivo ao vivo: digite um token contendo uma barra, como `./src/` ou `~/`, para ver uma lista suspensa de arquivos e diretórios correspondentes, depois pressione `Tab` para aceitar. Use barras para frente no Windows também; a lista suspensa é acionada por `/`, não `\`

394* Saia com `Escape`, `Backspace` ou `Ctrl+U` em um prompt vazio394* Saia com `Escape`, `Backspace` ou `Ctrl+U` em um prompt vazio

395* Colar texto que começa com `!` em um prompt vazio entra no modo shell automaticamente, correspondendo ao comportamento de `!` digitado395* Colar texto que começa com `!` em um prompt vazio entra no modo shell automaticamente, correspondendo ao comportamento de `!` digitado

396 396 

397A menos que sua sessão seja uma daquelas listadas em [modo de sandbox estrito](/docs/pt/sandboxing#turn-off-the-retry-with-strict-sandbox-mode), os comandos que você digita no modo shell são executados fora do [sandbox](/docs/pt/sandboxing) mesmo quando você ativou o sandboxing, porque o sandbox se aplica aos comandos que Claude executa.397A menos que sua sessão seja uma daquelas listadas em [modo de sandbox estrito](/docs/pt/sandboxing#turn-off-the-retry-with-strict-sandbox-mode), os comandos que você digita no modo shell são executados fora do [sandbox](/docs/pt/sandboxing) mesmo quando você ativou o sandboxing, porque o sandbox se aplica aos comandos que Claude executa.

398 398 

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

400 400 

401<h2 id="queue-messages-while-claude-works">401<h2 id="queue-messages-while-claude-works">

402 Enfileirar mensagens enquanto Claude trabalha402 Enfileirar mensagens enquanto Claude trabalha

keybindings.md +5 −5

Details

159| `confirm:no` | Escape | Recusar ação |159| `confirm:no` | Escape | Recusar ação |

160| `confirm:previous` | Up | Opção anterior |160| `confirm:previous` | Up | Opção anterior |

161| `confirm:next` | Down | Próxima opção |161| `confirm:next` | Down | Próxima opção |

162| `confirm:nextField` | Tab | Próximo campo |162| `confirm:nextField` | Tab | No diálogo `/fast`, ativar ou desativar o modo rápido |

163| `confirm:previousField` | (desvinculado) | Campo anterior |163| `confirm:previousField` | (desvinculado) | Claude Code não responde a esta ação, e um `keybindings.json` que a nomeia permanece válido |

164| `confirm:toggle` | Space | Alternar seleção |164| `confirm:toggle` | Space | Alternar seleção |

165| `confirm:cycleMode` | Shift+Tab\* | Ciclar modos de permissão. Em um prompt de permissão de arquivo, fecha um [campo de comentário](/docs/pt/permissions#add-a-comment-when-you-answer-a-permission-prompt) aberto; sem nenhum campo aberto, seleciona a opção que permite a ação para o resto da sessão, quando o prompt oferece essa opção |165| `confirm:cycleMode` | Shift+Tab\* | Em um prompt de permissão de arquivo, fecha um [campo de comentário](/docs/pt/permissions#add-a-comment-when-you-answer-a-permission-prompt) aberto; sem nenhum campo aberto, seleciona a opção que permite a ação para o resto da sessão, quando o prompt oferece essa opção |

166 166 

167\*No Windows sem modo VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), o padrão é Meta+M.167\*No Windows sem modo VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), o padrão é Meta+M.

168 168 


200 200 

201| Ação | Padrão | Descrição |201| Ação | Padrão | Descrição |

202| :- | :- | :- |202| :- | :- | :- |

203| `permission:toggleDebug` | (desvinculado) | Alternar informações de depuração de permissão. O padrão anterior de Ctrl+D foi removido na v2.1.146 porque sombreava `app:exit` |203| `permission:toggleDebug` | (desvinculado) | Claude Code não responde a esta ação, e um `keybindings.json` que a nomeia permanece válido |

204 204 

205<h3 id="transcript-actions">205<h3 id="transcript-actions">

206 Ações de transcrição206 Ações de transcrição


239 239 

240| Ação | Padrão | Descrição |240| Ação | Padrão | Descrição |

241| :- | :- | :- |241| :- | :- | :- |

242| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Colocar tarefa atual em segundo plano. O acorde Ctrl+X Ctrl+B evita o conflito de prefixo do tmux |242| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Colocar tarefa atual em segundo plano |

243 243 

244<h3 id="theme-actions">244<h3 id="theme-actions">

245 Ações de tema245 Ações de tema

Details

68 68 

69| Iniciar de | Acesso a arquivos | CLAUDE.md carregado na inicialização | Use quando |69| Iniciar de | Acesso a arquivos | CLAUDE.md carregado na inicialização | Use quando |

70| :- | :- | :- | :- |70| :- | :- | :- | :- |

71| Raiz do repositório | Cada arquivo | Apenas raiz; arquivos de subdiretório carregam sob demanda quando Claude lê lá | Tarefas abrangem múltiplos pacotes ou subsistemas |71| Raiz do repositório | Cada arquivo | Apenas raiz; arquivos de subdiretório carregam sob demanda | Tarefas abrangem múltiplos pacotes ou subsistemas |

72| Um subdiretório | Apenas essa subárvore, até você conceder mais | Desse diretório mais cada ancestral | O trabalho é escopo de um pacote ou subsistema |72| Um subdiretório | Apenas essa subárvore, até você conceder mais | Desse diretório mais cada ancestral | O trabalho é escopo de um pacote ou subsistema |

73 73 

74As configurações de projeto em `.claude/settings.json` não são herdadas de diretórios pai da maneira que os arquivos CLAUDE.md são. Para saber qual diretório `.claude/settings.json` uma sessão lê, consulte [onde Claude Code procura por cada arquivo](/docs/pt/settings#where-claude-code-looks-for-each-file).74As configurações de projeto em `.claude/settings.json` não são herdadas de diretórios pai da maneira que os arquivos CLAUDE.md são. Para saber qual diretório `.claude/settings.json` uma sessão lê, consulte [onde Claude Code procura por cada arquivo](/docs/pt/settings#where-claude-code-looks-for-each-file).


81 81 

82Em uma grande base de código, um único CLAUDE.md na raiz do repositório tende a crescer para cobrir as convenções de cada subsistema, custando contexto em instruções não relacionadas à tarefa atual, ou permanecer muito genérico para ser útil. Dividir instruções entre arquivos por diretório significa que Claude carrega regras em toda a repositório mais apenas as convenções para o código em que você está trabalhando.82Em uma grande base de código, um único CLAUDE.md na raiz do repositório tende a crescer para cobrir as convenções de cada subsistema, custando contexto em instruções não relacionadas à tarefa atual, ou permanecer muito genérico para ser útil. Dividir instruções entre arquivos por diretório significa que Claude carrega regras em toda a repositório mais apenas as convenções para o código em que você está trabalhando.

83 83 

84Claude Code carrega cada arquivo [CLAUDE.md](/docs/pt/memory) do seu diretório de trabalho e cada diretório pai na inicialização, depois carrega o arquivo de cada subdiretório sob demanda quando lê arquivos lá. Um arquivo raiz define regras em toda a repositório e cada subdiretório adiciona a sua própria.84Claude Code carrega cada arquivo [CLAUDE.md](/docs/pt/memory) do seu diretório de trabalho e cada diretório pai na inicialização, depois carrega o arquivo de cada subdiretório [sob demanda](/docs/pt/memory#how-claude-md-files-load). Um arquivo raiz define regras para todo o repositório e cada subdiretório adiciona as suas próprias.

85 85 

86Uma divisão comum é dois níveis:86Uma divisão comum é dois níveis:

87 87 


124 124 

125| Abordagem | Localização do arquivo | Carrega quando | Use quando |125| Abordagem | Localização do arquivo | Carrega quando | Use quando |

126| :- | :- | :- | :- |126| :- | :- | :- | :- |

127| CLAUDE.md por diretório | Dentro do diretório, ao lado de seu código | Na inicialização quando iniciado desse diretório, ou sob demanda quando Claude lê um arquivo lá | Proprietários de diretório mantêm suas próprias convenções; instruções são versionadas com o código |127| `CLAUDE.md` por diretório | Dentro do diretório, ao lado de seu código | Na inicialização quando iniciado desse diretório, ou sob demanda | Proprietários de diretório mantêm suas próprias convenções; instruções são versionadas com o código |

128| Regra com escopo de caminho em `.claude/rules/` | `.claude/` central na raiz do repo | Quando Claude trabalha com um arquivo correspondendo ao glob `paths:` da regra | Você quer todas as convenções em um lugar, ou a mesma regra se aplica a muitos caminhos espalhados |128| Regra com escopo de caminho em `.claude/rules/` | `.claude/` central na raiz do repo | Quando Claude trabalha com um arquivo correspondendo ao glob `paths:` da regra | Você quer todas as convenções em um lugar, ou a mesma regra se aplica a muitos caminhos espalhados |

129 129 

130Para uma comparação que também cobre skills, veja [Comparar recursos similares](/docs/pt/features-overview#compare-similar-features).130Para uma comparação que também cobre skills, veja [Comparar recursos similares](/docs/pt/features-overview#compare-similar-features).


133 Excluir arquivos CLAUDE.md irrelevantes133 Excluir arquivos CLAUDE.md irrelevantes

134</h3>134</h3>

135 135 

136Quando você inicia Claude da raiz do repositório, cada CLAUDE.md de subdiretório carrega assim que Claude lê um arquivo nesse diretório. A configuração `claudeMdExcludes` pula arquivos específicos por caminho ou padrão glob para que nunca carreguem.136Quando você inicia Claude da raiz do repositório, o CLAUDE.md de cada subdiretório pode [carregar sob demanda](/docs/pt/memory#how-claude-md-files-load) durante a sessão. A configuração `claudeMdExcludes` pula arquivos específicos por caminho ou padrão glob para que nunca carreguem.

137 137 

138Use isso para diretórios em que você nunca trabalha, como pacotes de outras equipes, código legado ou subárvores fornecidas. A lista de exclusão é estática, não um switch por tarefa. Para focar em um pacote hoje e outro amanhã, [inicie Claude do diretório desse pacote](#choose-where-to-start-claude) em vez de editar exclusões.138Use isso para diretórios em que você nunca trabalha, como pacotes de outras equipes, código legado ou subárvores fornecidas. A lista de exclusão é estática, não um switch por tarefa. Para focar em um pacote hoje e outro amanhã, [inicie Claude do diretório desse pacote](#choose-where-to-start-claude) em vez de editar exclusões.

139 139 

mcp.md +2 −2

Details

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

53 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.53 * O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.

54 54 

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

56 </Step>56 </Step>

57 57 

58 <Step title="Execute a skill de construção">58 <Step title="Execute a skill de build">

59 ```59 ```

60 /mcp-server-dev:build-mcp-server60 /mcp-server-dev:build-mcp-server

61 ```61 ```

memory.md +12 −9

Details

69| **Instruções do projeto** | `./CLAUDE.md` ou `./.claude/CLAUDE.md`. Consulte [AGENTS.md](#agents-md) para quando `./AGENTS.md` carrega em vez de ou junto com eles | Instruções compartilhadas pela equipe para o projeto | Arquitetura do projeto, padrões de codificação, fluxos de trabalho comuns | Membros da equipe via controle de versão |69| **Instruções do projeto** | `./CLAUDE.md` ou `./.claude/CLAUDE.md`. Consulte [AGENTS.md](#agents-md) para quando `./AGENTS.md` carrega em vez de ou junto com eles | Instruções compartilhadas pela equipe para o projeto | Arquitetura do projeto, padrões de codificação, fluxos de trabalho comuns | Membros da equipe via controle de versão |

70| **Instruções locais** | `./CLAUDE.local.md` | Preferências pessoais específicas do projeto; adicione a `.gitignore` | Suas URLs de sandbox, dados de teste preferidos | Apenas você (projeto atual) |70| **Instruções locais** | `./CLAUDE.local.md` | Preferências pessoais específicas do projeto; adicione a `.gitignore` | Suas URLs de sandbox, dados de teste preferidos | Apenas você (projeto atual) |

71 71 

72Os arquivos CLAUDE.md e CLAUDE.local.md no diretório acima do diretório de trabalho são carregados na inicialização. Os arquivos em subdiretórios carregam sob demanda quando Claude lê arquivos nesses diretórios. Consulte [Como os arquivos CLAUDE.md carregam](#how-claude-md-files-load) para a ordem de resolução completa.72Os arquivos CLAUDE.md e CLAUDE.local.md na hierarquia de diretórios acima do diretório de trabalho são carregados na inicialização. Os arquivos em subdiretórios carregam sob demanda. Consulte [Como os arquivos CLAUDE.md carregam](#how-claude-md-files-load) para saber quando eles carregam e a ordem de resolução completa.

73 73 

74Para projetos grandes, você pode dividir instruções em arquivos específicos de tópicos usando [regras de projeto](#organize-rules-with-claude/rules/). As regras permitem que você restrinja instruções a tipos de arquivo específicos ou subdiretórios.74Para projetos grandes, você pode dividir instruções em arquivos específicos de tópicos usando [regras de projeto](#organize-rules-with-claude/rules/). As regras permitem que você restrinja instruções a tipos de arquivo específicos ou subdiretórios.

75 75 


161 161 

162Todos os arquivos descobertos são concatenados em contexto em vez de se sobrescreverem. Na árvore de diretórios, o conteúdo é ordenado da raiz do sistema de arquivos até seu diretório de trabalho. Para o exemplo `foo/bar/`, `foo/CLAUDE.md` aparece em contexto antes de `foo/bar/CLAUDE.md`, portanto as instruções mais próximas de onde você iniciou Claude são lidas por último. Dentro de cada diretório, `CLAUDE.local.md` é anexado após `CLAUDE.md`, portanto suas notas pessoais são a última coisa que Claude lê nesse nível.162Todos os arquivos descobertos são concatenados em contexto em vez de se sobrescreverem. Na árvore de diretórios, o conteúdo é ordenado da raiz do sistema de arquivos até seu diretório de trabalho. Para o exemplo `foo/bar/`, `foo/CLAUDE.md` aparece em contexto antes de `foo/bar/CLAUDE.md`, portanto as instruções mais próximas de onde você iniciou Claude são lidas por último. Dentro de cada diretório, `CLAUDE.local.md` é anexado após `CLAUDE.md`, portanto suas notas pessoais são a última coisa que Claude lê nesse nível.

163 163 

164Claude também descobre arquivos `CLAUDE.md` e `CLAUDE.local.md` em subdiretórios sob seu diretório de trabalho atual. Em vez de carregá-los na inicialização, eles são incluídos quando Claude lê arquivos nesses subdiretórios. Para arquivos dentro de um worktree sob `.claude/worktrees/`, consulte [Isole subagentes com worktrees](/docs/pt/worktrees#isolate-subagents-with-worktrees).164Claude também descobre arquivos `CLAUDE.md` e `CLAUDE.local.md` em subdiretórios sob seu diretório de trabalho atual. Em vez de carregá-los na inicialização, Claude Code os inclui quando Claude usa a ferramenta [Read](/docs/pt/tools-reference#read-tool-behavior), [Write](/docs/pt/tools-reference#write-tool-behavior) ou [Edit](/docs/pt/tools-reference#edit-tool-behavior) em um arquivo nesses subdiretórios. Se Claude já usou uma dessas ferramentas no próprio `CLAUDE.md` de um subdiretório, esse arquivo não é carregado dessa forma, porque Claude Code o trata como já presente na conversa. Para arquivos dentro de um worktree sob `.claude/worktrees/`, consulte [Isole subagentes com worktrees](/docs/pt/worktrees#isolate-subagents-with-worktrees).

165 165 

166Se você trabalha em um grande monorepo onde os arquivos CLAUDE.md de outras equipes são detectados, use [`claudeMdExcludes`](#exclude-specific-claude-md-files) para ignorá-los. Para o layout completo de arquivos CLAUDE.md raiz e por diretório e regras, consulte [Monorepos e repositórios grandes](/docs/pt/large-codebases).166Se você trabalha em um grande monorepo onde os arquivos CLAUDE.md de outras equipes são detectados, use [`claudeMdExcludes`](#exclude-specific-claude-md-files) para ignorá-los. Para o layout completo de arquivos CLAUDE.md raiz e por diretório e regras, consulte [Monorepos e repositórios grandes](/docs/pt/large-codebases).

167 167 


429| `claude-md-or-agents-md` | Seus arquivos `CLAUDE.md` ou seus arquivos `AGENTS.md` quando você não tem `CLAUDE.md` ou `CLAUDE.local.md` em seu diretório de trabalho ou acima dele. Este é o padrão |429| `claude-md-or-agents-md` | Seus arquivos `CLAUDE.md` ou seus arquivos `AGENTS.md` quando você não tem `CLAUDE.md` ou `CLAUDE.local.md` em seu diretório de trabalho ou acima dele. Este é o padrão |

430| `claude-md-and-agents-md` | Seus arquivos `CLAUDE.md` e `AGENTS.md` juntos, os arquivos `CLAUDE.md` de cada diretório primeiro e seu `AGENTS.md` depois. Claude Code pula um `AGENTS.md` que já carregou, então um que seu `CLAUDE.md` importa ou cria um symlink para não é lido duas vezes |430| `claude-md-and-agents-md` | Seus arquivos `CLAUDE.md` e `AGENTS.md` juntos, os arquivos `CLAUDE.md` de cada diretório primeiro e seu `AGENTS.md` depois. Claude Code pula um `AGENTS.md` que já carregou, então um que seu `CLAUDE.md` importa ou cria um symlink para não é lido duas vezes |

431| `claude-md` | Apenas seus arquivos `CLAUDE.md` |431| `claude-md` | Apenas seus arquivos `CLAUDE.md` |

432| `managed-only` | Apenas o `CLAUDE.md` gerenciado de sua organização e [auto memory](#auto-memory) no lançamento. Seus arquivos `CLAUDE.md` de projeto, local e usuário, seus arquivos `.claude/rules/` e cada `AGENTS.md` são deixados de fora. O `CLAUDE.md` de um subdiretório e os arquivos `.claude/rules/` ainda carregam quando Claude lê um arquivo lá, e [regras com escopo de caminho](#path-specific-rules) ainda se aplicam |432| `managed-only` | Apenas o `CLAUDE.md` gerenciado de sua organização e a [memória automática](#auto-memory) no lançamento. Seus arquivos `CLAUDE.md` de projeto, local e usuário, seus arquivos `.claude/rules/` e cada `AGENTS.md` são deixados de fora. O `CLAUDE.md` e os arquivos `.claude/rules/` de um subdiretório, e as [regras com escopo de caminho](#path-specific-rules), ainda carregam sob demanda |

433 433 

434Você também pode definir o valor em um arquivo de configurações em vez de `/config`. Adicione-o sob o ID do plugin `agents-md` integrado em [`pluginConfigs`](/docs/pt/settings-reference#pluginconfigs), em `~/.claude/settings.json`, um arquivo `--settings` ou [configurações gerenciadas](/docs/pt/managed-settings). Claude Code o ignora em arquivos de configurações de projeto e local. Este exemplo faz Claude ler ambos os arquivos:434Você também pode definir o valor em um arquivo de configurações em vez de `/config`. Adicione-o em [`pluginConfigs`](/docs/pt/settings-reference#pluginconfigs) sob `cc-plugin-agents-md@builtin`, o ID do plugin integrado que lê `AGENTS.md`. Claude Code lê a entrada de `~/.claude/settings.json`, de um arquivo `--settings` ou de [configurações gerenciadas](/docs/pt/managed-settings), e a ignora em arquivos de configurações de projeto e local. Este exemplo faz Claude ler ambos os arquivos:

435 435 

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

437{437{

438 "pluginConfigs": {438 "pluginConfigs": {

439 "agents-md@builtin": {439 "cc-plugin-agents-md@builtin": {

440 "options": { "instructionFiles": "claude-md-and-agents-md" }440 "options": { "instructionFiles": "claude-md-and-agents-md" }

441 }441 }

442 }442 }

443}443}

444```444```

445 445 

446Antes da v2.1.285, o ID do plugin era `agents-md@builtin`, e Claude Code ignorava uma entrada sob `cc-plugin-agents-md@builtin`. Se versões anteriores também leem seu arquivo de configurações, use `agents-md@builtin` nele. Claude Code v2.1.285 e posterior lê uma entrada sob qualquer um dos IDs.

447 

446Sua alteração se aplica a partir da próxima mensagem que você enviar e em cada nova sessão.448Sua alteração se aplica a partir da próxima mensagem que você enviar e em cada nova sessão.

447 449 

448<h3 id="when-agents-md-support-is-unavailable">450<h3 id="when-agents-md-support-is-unavailable">


452Nessas sessões Claude lê apenas arquivos `CLAUDE.md` e **Project instructions** não aparece no painel de configurações `/config`:454Nessas sessões Claude lê apenas arquivos `CLAUDE.md` e **Project instructions** não aparece no painel de configurações `/config`:

453 455 

454* Você está em uma versão Claude Code anterior à v2.1.277456* Você está em uma versão Claude Code anterior à v2.1.277

455* Você desabilitou o plugin `agents-md` integrado em `/plugin`457* Você usou `/plugin` para desabilitar o plugin integrado que lê `AGENTS.md`

456* Em alguns casos, é sua [primeira sessão depois que você atualiza](/docs/pt/env-vars#first-session-after-an-install-or-upgrade) de v2.1.276 ou anterior. Claude lê `AGENTS.md` a partir de sua próxima sessão458* Em alguns casos, é sua [primeira sessão depois que você atualiza](/docs/pt/env-vars#first-session-after-an-install-or-upgrade) de v2.1.276 ou anterior. Claude lê `AGENTS.md` a partir de sua próxima sessão

457 459 

458Antes de v2.1.281, algumas sessões, como aquelas no Amazon Bedrock ou com telemetria desabilitada, liam apenas arquivos `CLAUDE.md`. Nessas versões, atualize Claude Code. Para dar ao Claude seu `AGENTS.md` em qualquer uma dessas sessões, [importe-o de um `CLAUDE.md`](#share-one-file-with-other-coding-tools).460Antes de v2.1.281, algumas sessões, como aquelas no Amazon Bedrock ou com telemetria desabilitada, liam apenas arquivos `CLAUDE.md`. Nessas versões, atualize Claude Code. Para dar ao Claude seu `AGENTS.md` em qualquer uma dessas sessões, [importe-o de um `CLAUDE.md`](#share-one-file-with-other-coding-tools).


623 Visualize e edite com `/memory`625 Visualize e edite com `/memory`

624</h2>626</h2>

625 627 

626O comando `/memory` lista seus arquivos CLAUDE.md, CLAUDE.local.md e outros locais de arquivo de memória em escopos de usuário e projeto, incluindo entradas CLAUDE.md de usuário e projeto para arquivos que ainda não existem. Também permite que você alterne a memória automática ativada ou desativada e fornece uma opção para abrir a pasta de memória automática. Selecione qualquer arquivo para abri-lo no seu editor; selecionar um que ainda não existe o cria primeiro. Para verificar quais arquivos `CLAUDE.md` e arquivos de regras foram carregados na sessão atual, execute `/context`.628O comando `/memory` lista seus arquivos CLAUDE.md, CLAUDE.local.md e outros locais de arquivo de memória em escopos de usuário e projeto, incluindo entradas CLAUDE.md de usuário e projeto para arquivos que ainda não existem. Também permite que você alterne a memória automática ativada ou desativada e fornece uma opção para abrir a pasta de memória automática. Selecione qualquer arquivo para abri-lo no seu editor; selecionar um que ainda não existe o cria primeiro. Para verificar quais arquivos `CLAUDE.md` e arquivos de regras foram carregados na inicialização, execute `/context`.

627 629 

628Editores GUI como VS Code abrem o arquivo em uma janela separada, e você pode continuar usando a sessão enquanto está aberta. Antes da v2.1.216, `/memory` esperava você fechar o arquivo antes de responder. Editores de terminal como Vim assumem o controle do terminal até você sair.630Editores GUI como VS Code abrem o arquivo em uma janela separada, e você pode continuar usando a sessão enquanto está aberta. Antes da v2.1.216, `/memory` esperava você fechar o arquivo antes de responder. Editores de terminal como Vim assumem o controle do terminal até você sair.

629 631 


643 645 

644Para depurar:646Para depurar:

645 647 

646* Execute `/context` e verifique a lista sob **Memory files** para verificar se seus arquivos CLAUDE.md e CLAUDE.local.md foram carregados. Se um arquivo `CLAUDE.md` estiver faltando lá, Claude não pode vê-lo. Use `/memory` para abrir e editar os arquivos.648* Execute `/context` e verifique a lista sob **Memory files** para conferir os arquivos CLAUDE.md e CLAUDE.local.md que devem ser carregados na inicialização. Se um deles estiver faltando lá, Claude não pode vê-lo. Use `/memory` para abrir e editar os arquivos.

649* Um `CLAUDE.md` em um subdiretório do seu diretório de trabalho não aparece sob **Memory files**, porque ele é carregado sob demanda em vez de na inicialização. Quando ele é carregado, uma linha `Loaded` com seu caminho aparece no terminal. Para testar um novo, crie-o a partir do seu shell em vez de pedir a Claude que o escreva, e depois peça a Claude que leia um arquivo nesse subdiretório.

647* Verifique se o CLAUDE.md relevante está em um local que é carregado para sua sessão (veja [Escolha onde colocar arquivos CLAUDE.md](#choose-where-to-put-claude-md-files)).650* Verifique se o CLAUDE.md relevante está em um local que é carregado para sua sessão (veja [Escolha onde colocar arquivos CLAUDE.md](#choose-where-to-put-claude-md-files)).

648* Torne as instruções mais específicas. "Use indentação de 2 espaços" funciona melhor do que "formate o código adequadamente."651* Torne as instruções mais específicas. "Use indentação de 2 espaços" funciona melhor do que "formate o código adequadamente."

649* Procure por instruções conflitantes entre arquivos CLAUDE.md. Se dois arquivos dão orientação diferente para o mesmo comportamento, Claude pode escolher um arbitrariamente.652* Procure por instruções conflitantes entre arquivos CLAUDE.md. Se dois arquivos dão orientação diferente para o mesmo comportamento, Claude pode escolher um arbitrariamente.


693 Instruções parecem perdidas após `/compact`696 Instruções parecem perdidas após `/compact`

694</h3>697</h3>

695 698 

696CLAUDE.md de raiz de projeto sobrevive à compactação: após `/compact`, Claude relê do disco e reinjecta no contexto. Arquivos CLAUDE.md aninhados em subdiretórios e regras com [frontmatter `paths:`](#path-specific-rules) recarregam conforme Claude lê arquivos aos quais se aplicam.699CLAUDE.md de raiz de projeto sobrevive à compactação: após `/compact`, Claude o relê do disco e o reinjeta na sessão. Arquivos CLAUDE.md aninhados em subdiretórios e regras com [frontmatter `paths:`](#path-specific-rules) são carregados novamente sob demanda.

697 700 

698Se uma instrução desapareceu após compactação, ela foi dada apenas em conversa, vive em um CLAUDE.md aninhado que ainda não recarregou, ou é uma regra com escopo de caminho que não correspondeu a um arquivo desde então. Adicione instruções apenas de conversa a CLAUDE.md para torná-las persistir. Veja [O que sobrevive à compactação](/docs/pt/context-window#what-survives-compaction) para o detalhamento completo.701Se uma instrução desapareceu após compactação, ela foi dada apenas em conversa, vive em um CLAUDE.md aninhado que ainda não recarregou, ou é uma regra com escopo de caminho que não correspondeu a um arquivo desde então. Adicione instruções apenas de conversa a CLAUDE.md para torná-las persistir. Veja [O que sobrevive à compactação](/docs/pt/context-window#what-survives-compaction) para o detalhamento completo.

699 702 

Details

128| `OTEL_METRIC_EXPORT_INTERVAL` | Intervalo de exportação em milissegundos (padrão: 60000) | `5000`, `60000` |128| `OTEL_METRIC_EXPORT_INTERVAL` | Intervalo de exportação em milissegundos (padrão: 60000) | `5000`, `60000` |

129| `OTEL_LOGS_EXPORT_INTERVAL` | Intervalo de exportação de logs em milissegundos (padrão: 5000) | `1000`, `10000` |129| `OTEL_LOGS_EXPORT_INTERVAL` | Intervalo de exportação de logs em milissegundos (padrão: 5000) | `1000`, `10000` |

130| `OTEL_LOG_USER_PROMPTS` | Ativa o registro em log do conteúdo dos prompts do usuário (padrão: desativado) | `1` para ativar |130| `OTEL_LOG_USER_PROMPTS` | Ativa o registro em log do conteúdo dos prompts do usuário (padrão: desativado) | `1` para ativar |

131| `OTEL_LOG_ASSISTANT_RESPONSES` | Ativa o registro em log do texto das respostas do assistente nos eventos `assistant_response` (padrão: desativado). Quando não definida, usa o valor de `OTEL_LOG_USER_PROMPTS`. Requer o Claude Code v2.1.193 ou posterior | `1` para ativar, `0` para manter ocultado |131| `OTEL_LOG_ASSISTANT_RESPONSES` | Ativa o registro em log do texto das respostas do assistente nos eventos `assistant_response` (padrão: desativado). Quando não definida, usa o valor de `OTEL_LOG_USER_PROMPTS` | `1` para ativar, `0` para manter ocultado |

132| `OTEL_LOG_TOOL_DETAILS` | Ativa o registro em log dos parâmetros de ferramentas e argumentos de entrada em eventos de ferramentas e atributos de spans de trace: comandos Bash, nomes de servidores MCP e de ferramentas, nomes de skills, nomes de fluxos de trabalho criados pelo usuário e a entrada da ferramenta. Também ativa nomes de comandos personalizados, de plugins e MCP nos eventos `user_prompt`, e nomes reais de agentes, skills, plugins, servidores MCP e ferramentas nos [contadores de custo e de tokens](#cost-counter) (padrão: desativado). Para os servidores integrados do Claude Desktop, em sessões que pertencem ao Claude Desktop, `mcp_server_name`/`mcp_tool_name` são emitidos em `tool_decision`/`tool_result` mesmo com a flag desativada. A exceção requer o Claude Code v2.1.214 ou posterior | `1` para ativar |132| `OTEL_LOG_TOOL_DETAILS` | Ativa o registro em log dos parâmetros de ferramentas e argumentos de entrada em eventos de ferramentas e atributos de spans de trace: comandos Bash, nomes de servidores MCP e de ferramentas, nomes de skills, nomes de fluxos de trabalho criados pelo usuário e a entrada da ferramenta. Também ativa nomes de comandos personalizados, de plugins e MCP nos eventos `user_prompt`, e nomes reais de agentes, skills, plugins, servidores MCP e ferramentas nos [contadores de custo e de tokens](#cost-counter) (padrão: desativado). Para os servidores integrados do Claude Desktop, em sessões que pertencem ao Claude Desktop, `mcp_server_name`/`mcp_tool_name` são emitidos em `tool_decision`/`tool_result` mesmo com a flag desativada. A exceção requer o Claude Code v2.1.214 ou posterior | `1` para ativar |

133| `OTEL_LOG_TOOL_CONTENT` | Ativa o registro em log do conteúdo de ferramentas no [evento de span `tool.output`](#tool-output-span-event) (padrão: desativado). Os atributos de span carregam conteúdo de ferramentas sob [suas próprias condições](#new-context-gates). Requer [tracing](#traces-beta). O conteúdo é truncado no limite de conteúdo (60 KB por padrão) | `1` para ativar |133| `OTEL_LOG_TOOL_CONTENT` | Ativa o registro em log do conteúdo de ferramentas no [evento de span `tool.output`](#tool-output-span-event) (padrão: desativado). Os atributos de span carregam conteúdo de ferramentas sob [suas próprias condições](#new-context-gates). Requer [tracing](#traces-beta). O conteúdo é truncado no limite de conteúdo (60 KB por padrão) | `1` para ativar |

134| `OTEL_LOG_MANAGED_SETTINGS` | Adiciona as configurações gerenciadas ocultadas, e um digest SHA-256 das configurações antes da ocultação, aos eventos de [configurações gerenciadas resolvidas](#managed-settings-resolved-event) (padrão: desativado). Um valor nas configurações de projeto ou locais não a ativa. Requer o Claude Code v2.1.274 ou posterior | `1` para ativar |134| `OTEL_LOG_MANAGED_SETTINGS` | Adiciona as configurações gerenciadas ocultadas, e um digest SHA-256 das configurações antes da ocultação, aos eventos de [configurações gerenciadas resolvidas](#managed-settings-resolved-event) (padrão: desativado). Um valor nas configurações de projeto ou locais não a ativa. Requer o Claude Code v2.1.274 ou posterior | `1` para ativar |


819 Evento de resposta do assistente819 Evento de resposta do assistente

820</h4>820</h4>

821 821 

822Registrado após cada requisição de API que retorna conteúdo de texto do modelo. Apenas os blocos de texto da resposta são incluídos; blocos de pensamento e blocos de uso de ferramenta são excluídos. Requer Claude Code v2.1.193 ou posterior.822Registrado após cada requisição de API que retorna conteúdo de texto do modelo. Apenas os blocos de texto da resposta são incluídos; blocos de pensamento e blocos de uso de ferramenta são excluídos.

823 823 

824**Nome do Evento**: `claude_code.assistant_response`824**Nome do Evento**: `claude_code.assistant_response`

825 825 


1157* `plugin_id_hash`: hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite que você conte os plugins de terceiros distintos carregados em sua frota sem registrar seus nomes. Para [plugins sincronizados de claude.ai](/docs/pt/plugins/loading#synced-plugins), Claude Code faz hash do nome do plugin com o nome do marketplace que claude.ai relata para o plugin, ou com `synced` caso contrário. Antes da v2.1.246, Claude Code não usava o nome do marketplace que claude.ai relata no hash1157* `plugin_id_hash`: hash determinístico do nome do plugin e marketplace, enviado apenas para seu exportador configurado. Permite que você conte os plugins de terceiros distintos carregados em sua frota sem registrar seus nomes. Para [plugins sincronizados de claude.ai](/docs/pt/plugins/loading#synced-plugins), Claude Code faz hash do nome do plugin com o nome do marketplace que claude.ai relata para o plugin, ou com `synced` caso contrário. Antes da v2.1.246, Claude Code não usava o nome do marketplace que claude.ai relata no hash

1158* `has_hooks`: se o plugin contribui hooks1158* `has_hooks`: se o plugin contribui hooks

1159* `has_mcp`: se o plugin contribui servidores MCP1159* `has_mcp`: se o plugin contribui servidores MCP

1160* `host_owned_mcp`: `true` quando o host SDK gerencia as conexões MCP deste plugin e Claude Code pulou a leitura da configuração do servidor MCP do plugin, `false` caso contrário. Requer Claude Code v2.1.172 ou posterior1160* `host_owned_mcp`: `true` quando o host do SDK gerencia as conexões MCP deste plugin e o Claude Code deixou de ler a configuração de servidor MCP do plugin, `false` caso contrário

1161* `skill_path_count`: número de diretórios de skill que o plugin declara1161* `skill_path_count`: número de diretórios de skill que o plugin declara

1162* `command_path_count`: número de diretórios de comando que o plugin declara1162* `command_path_count`: número de diretórios de comando que o plugin declara

1163* `agent_path_count`: número de diretórios de agente que o plugin declara1163* `agent_path_count`: número de diretórios de agente que o plugin declara


1336* `pre_tokens`: Contagem aproximada de tokens antes da compactação1336* `pre_tokens`: Contagem aproximada de tokens antes da compactação

1337* `post_tokens`: Contagem aproximada de tokens após a compactação1337* `post_tokens`: Contagem aproximada de tokens após a compactação

1338* `error`: Mensagem de erro quando a compactação falhou1338* `error`: Mensagem de erro quando a compactação falhou

1339* `precompute_reuse`: Definido apenas quando `trigger` é `"manual"`. A compactação automática pode preparar um resumo em background antes da janela de contexto se encher, e este atributo registra se `/compact` reutilizou esse resumo preparado. `"hit"` significa que foi reutilizado; `"miss_custom_instructions"`, `"miss_hook"`, e `"miss_not_ready"` dão a razão pela qual um resumo fresco foi computado em vez disso. Requer Claude Code v2.1.153 ou posterior1339* `precompute_reuse`: Definido apenas quando `trigger` é `"manual"`. A compactação automática pode preparar um resumo em segundo plano antes que a janela de contexto se encha, e este atributo registra se `/compact` reutilizou esse resumo preparado. `"hit"` significa que ele foi reutilizado; `"miss_custom_instructions"`, `"miss_hook"` e `"miss_not_ready"` indicam o motivo pelo qual um novo resumo foi calculado

1340 1340 

1341<h4 id="subagent-completed-event">1341<h4 id="subagent-completed-event">

1342 Evento de subagente concluído1342 Evento de subagente concluído


1518* Consumo incomum de tokens1518* Consumo incomum de tokens

1519* Alto volume de sessão de usuários específicos1519* Alto volume de sessão de usuários específicos

1520 1520 

1521Todas as métricas podem ser segmentadas pelos [atributos padrão](#standard-attributes). O atributo `model` está disponível em `claude_code.token.usage`, `claude_code.cost.usage` e a partir da v2.1.172, `claude_code.lines_of_code.count`.1521Todas as métricas podem ser segmentadas pelos [atributos padrão](#standard-attributes). O atributo `model` está disponível em `claude_code.token.usage`, `claude_code.cost.usage` e `claude_code.lines_of_code.count`.

1522 1522 

1523Divisões por modelo de commits podem ser apenas aproximadas unindo contra as métricas de token ou custo em `session.id`, já que uma sessão pode abranger vários modelos. Filtre o lado do token ou custo para linhas onde `query_source` é `"main"` para que solicitações auxiliares e de subagente não atribuam os commits da sessão a um modelo que não os fez.1523Divisões por modelo de commits podem ser apenas aproximadas unindo contra as métricas de token ou custo em `session.id`, já que uma sessão pode abranger vários modelos. Filtre o lado do token ou custo para linhas onde `query_source` é `"main"` para que solicitações auxiliares e de subagente não atribuam os commits da sessão a um modelo que não os fez.

1524 1524 

Details

69 Armazenamento de certificados CA69 Armazenamento de certificados CA

70</h2>70</h2>

71 71 

72Por padrão, Claude Code confia tanto em seus certificados CA Mozilla agrupados quanto no armazenamento de certificados do seu sistema operacional. Ler o armazenamento do SO requer um runtime com `tls.getCACertificates`: o instalador nativo sempre possui, e instalações npm precisam do Node 22.15 ou posterior. Em versões mais antigas do Node, apenas o conjunto agrupado e `NODE_EXTRA_CA_CERTS` se aplicam. Proxies de inspeção TLS empresariais funcionam sem configuração adicional quando seu certificado raiz é instalado no armazenamento de confiança do SO e o runtime pode lê-lo.72Por padrão, Claude Code confia tanto em seus certificados CA Mozilla agrupados quanto no armazenamento de certificados do seu sistema operacional. Ler o armazenamento do SO requer um runtime com `tls.getCACertificates`: o instalador nativo sempre possui, e instalações npm precisam do Node 22.15 ou posterior. Em versões mais antigas do Node, apenas o conjunto agrupado e `NODE_EXTRA_CA_CERTS` se aplicam. Proxies de inspeção TLS empresariais funcionam sem configuração adicional quando seu certificado raiz é instalado no armazenamento de confiança do SO e o runtime pode lê-lo. Se um proxy desse tipo lidar incorretamente com corpos de requisição compactados com gzip, defina [`CLAUDE_CODE_GZIP_REQUEST_BODIES=0`](/docs/pt/env-vars) para desativar a compactação nas requisições da Claude API, de telemetria e de publicação de artefatos.

73 73 

74`CLAUDE_CODE_CERT_STORE` aceita uma lista separada por vírgulas de fontes. Os valores reconhecidos são `bundled` para o conjunto de CA Mozilla enviado com Claude Code e `system` para o armazenamento de confiança do sistema operacional. O padrão é `bundled,system`.74`CLAUDE_CODE_CERT_STORE` aceita uma lista separada por vírgulas de fontes. Os valores reconhecidos são `bundled` para o conjunto de CA Mozilla enviado com Claude Code e `system` para o armazenamento de confiança do sistema operacional. O padrão é `bundled,system`.

75 75 

Details

25| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Leituras e ferramentas pré-aprovadas; qualquer coisa que geraria um prompt é negada | CI bloqueado e scripts |25| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Leituras e ferramentas pré-aprovadas; qualquer coisa que geraria um prompt é negada | CI bloqueado e scripts |

26| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Tudo | Apenas contêineres isolados e VMs |26| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Tudo | Apenas contêineres isolados e VMs |

27 27 

28O modo que revisa cada ação é nomeado **Manual** na CLI, em `claude --help`, nas extensões VS Code e JetBrains, e no aplicativo de desktop. Seu valor de configuração é `default`, que é o que hooks e integrações SDK usam. A CLI aceita `manual` como um alias em qualquer lugar onde você digita o valor, por exemplo `claude --permission-mode manual` ou `"defaultMode": "manual"`. O rótulo Manual e o alias `manual` requerem Claude Code v2.1.200 ou posterior. O rótulo do aplicativo de desktop não depende da sua versão da CLI.28O modo que revisa cada ação é nomeado **Manual** na CLI, em `claude --help`, nas extensões VS Code e JetBrains, e no aplicativo de desktop. Seu valor de configuração é `default`, que é o que hooks e integrações SDK usam. A CLI aceita `manual` como um alias em qualquer lugar onde você digita o valor, por exemplo `claude --permission-mode manual` ou `"defaultMode": "manual"`.

29 29 

30As gravações em [caminhos protegidos](#protected-paths) nunca são auto-aprovadas, exceto no modo `bypassPermissions` e em sessões de modo plan onde permissões de bypass estão disponíveis, significando sessões iniciadas de uma forma que [coloca `bypassPermissions` no ciclo de modo](#switch-permission-modes).30As gravações em [caminhos protegidos](#protected-paths) nunca são auto-aprovadas, exceto no modo `bypassPermissions` e em sessões de modo plan onde permissões de bypass estão disponíveis, significando sessões iniciadas de uma forma que [coloca `bypassPermissions` no ciclo de modo](#switch-permission-modes).

31 31 


359 O que o classificador bloqueia por padrão359 O que o classificador bloqueia por padrão

360</h3>360</h3>

361 361 

362O classificador confia em seu diretório de trabalho e nos remotos que foram configurados para ele quando a sessão iniciou. Um remoto adicionado ou reapontado durante a sessão com `git remote add` ou `git remote set-url` não é confiável, e todo o resto é tratado como externo até você [configurar infraestrutura confiável](/docs/pt/auto-mode-config). Antes da v2.1.200, remotos adicionados no meio da sessão também eram confiáveis.362O classificador confia em seu diretório de trabalho e nos remotos que foram configurados para ele quando a sessão iniciou. Um remoto adicionado ou reapontado durante a sessão com `git remote add` ou `git remote set-url` não é confiável, e todo o resto é tratado como externo até você [configurar infraestrutura confiável](/docs/pt/auto-mode-config).

363 363 

364**Bloqueado por padrão**:364**Bloqueado por padrão**:

365 365 


392* Lançamento de um loop de agente autônomo que executa sem aprovação humana ou sandbox, como um iniciado com `--dangerously-skip-permissions` ou `--no-sandbox`. Isso inclui a execução de um agente de terceiros ou harness de avaliação com isolamento e aprovação por ação desabilitados, como um runner iniciado com `--yes-always`392* Lançamento de um loop de agente autônomo que executa sem aprovação humana ou sandbox, como um iniciado com `--dangerously-skip-permissions` ou `--no-sandbox`. Isso inclui a execução de um agente de terceiros ou harness de avaliação com isolamento e aprovação por ação desabilitados, como um runner iniciado com `--yes-always`

393* Ações de navegador do [Claude in Chrome](/docs/pt/chrome) que poderiam enviar conteúdo de página, cookies ou credenciais para fora da origem393* Ações de navegador do [Claude in Chrome](/docs/pt/chrome) que poderiam enviar conteúdo de página, cookies ou credenciais para fora da origem

394* Exclusão de arquivos em `/tmp`, `$TMPDIR` ou outro diretório compartilhado de rascunho ou cache por wildcard, glob ou filtro de idade em vez de por um caminho nomeado específico394* Exclusão de arquivos em `/tmp`, `$TMPDIR` ou outro diretório compartilhado de rascunho ou cache por wildcard, glob ou filtro de idade em vez de por um caminho nomeado específico

395* Inclusão de detalhes sensíveis em conteúdo enviado, carregado, publicado ou escrito para outras pessoas ou sistemas compartilhados, quando sua própria mensagem não autorizou esses detalhes para esse destinatário. Corpos de PR e issue, mensagens de commit e comentários contam como esse tipo de conteúdo de saída quando o repositório está fora do limite de confiança ou é público, incluindo os próprios repositórios públicos da sua organização; caminhos de arquivo internos, codinomes, dados ativos de respostas de API como emails ou identificadores de conta, e identificadores de infraestrutura contam como detalhes sensíveis. O escopo de PR, issue e mensagem de commit requer Claude Code v2.1.200 ou posterior. Dados pessoais ativos de uma resposta de API em um corpo de PR ou issue, como um endereço de email, um identificador de conta ou organização ou uma métrica de uso, exigem que você nomeie esses detalhes e o destinatário independentemente da visibilidade ou do limite de confiança do repositório. Essa verificação requer Claude Code v2.1.203 ou posterior395* Inclusão de detalhes sensíveis em conteúdo enviado, carregado, publicado ou escrito para outras pessoas ou sistemas compartilhados, quando sua própria mensagem não autorizou esses detalhes para esse destinatário. Corpos de PR e issue, mensagens de commit e comentários contam como esse tipo de conteúdo de saída quando o repositório está fora do limite de confiança ou é público, incluindo os próprios repositórios públicos da sua organização; caminhos de arquivo internos, codinomes, dados ativos de respostas de API como emails ou identificadores de conta, e identificadores de infraestrutura contam como detalhes sensíveis. Dados pessoais ativos de uma resposta de API em um corpo de PR ou issue, como um endereço de email, um identificador de conta ou organização ou uma métrica de uso, exigem que você nomeie esses detalhes e o destinatário independentemente da visibilidade ou do limite de confiança do repositório. Essa verificação requer Claude Code v2.1.203 ou posterior

396* Envio de pressionamentos de tecla para o próprio painel tmux de Claude Code para conduzir sua própria interface, o que o classificador trata como Claude alterando suas próprias permissões ou supervisão396* Envio de pressionamentos de tecla para o próprio painel tmux de Claude Code para conduzir sua própria interface, o que o classificador trata como Claude alterando suas próprias permissões ou supervisão

397 

398Várias dessas categorias dependem de entradas de [ambiente](/docs/pt/auto-mode-config#define-trusted-infrastructure), como alvos remotos sensíveis e escopos IaC protegidos, que você pode restringir a nomes concretos.

399 

400Claude Code v2.1.200 e posterior também bloqueiam estes por padrão:

401 

402* Comentar, excluir ou forçar a aprovação de um teste ou asserção que protege comportamento de segurança, como autenticação, controle de acesso, validação de entrada ou sandboxing397* Comentar, excluir ou forçar a aprovação de um teste ou asserção que protege comportamento de segurança, como autenticação, controle de acesso, validação de entrada ou sandboxing

403* Exclusão ou desmontagem de um recurso com estado que Claude não criou na sessão, quando nenhuma regra de exclusão mais específica se aplica e você não nomeou esse recurso398* Exclusão ou desmontagem de um recurso com estado que Claude não criou na sessão, quando nenhuma regra de exclusão mais específica se aplica e você não nomeou esse recurso

404* Reapontamento de uma URL base de API, endpoint de proxy, receptor de webhook ou espelho de registro para um host de terceiros que não se encaixa na tarefa, incluindo em arquivos de exemplo como `.env.example`399* Reapontamento de uma URL base de API, endpoint de proxy, receptor de webhook ou espelho de registro para um host de terceiros que não se encaixa na tarefa, incluindo em arquivos de exemplo como `.env.example`


406* Push de segredos ou dados pessoais ou confiados para um repositório sabidamente público, ou push para ele de material confidencial que não faz parte do próprio trabalho desse repositório. O próprio assunto de um repositório de dotfiles é a única exceção para dados pessoais ou confiados, e conteúdo de um repositório privado chegando a qualquer superfície pública é bloqueado da mesma forma; ambos os refinamentos requerem Claude Code v2.1.203 ou posterior. Antes da v2.1.203, dados pessoais eram agrupados com material confidencial e bloqueados apenas quando não faziam parte do próprio trabalho desse repositório. Quando a visibilidade de um repositório não está estabelecida, o classificador não bloqueia apenas com base nisso; em vez disso, ele julga o conteúdo segundo as outras regras401* Push de segredos ou dados pessoais ou confiados para um repositório sabidamente público, ou push para ele de material confidencial que não faz parte do próprio trabalho desse repositório. O próprio assunto de um repositório de dotfiles é a única exceção para dados pessoais ou confiados, e conteúdo de um repositório privado chegando a qualquer superfície pública é bloqueado da mesma forma; ambos os refinamentos requerem Claude Code v2.1.203 ou posterior. Antes da v2.1.203, dados pessoais eram agrupados com material confidencial e bloqueados apenas quando não faziam parte do próprio trabalho desse repositório. Quando a visibilidade de um repositório não está estabelecida, o classificador não bloqueia apenas com base nisso; em vez disso, ele julga o conteúdo segundo as outras regras

407* Abertura de um pull request contra um repositório ou organização diferente, criação de fork com `gh repo fork` ou push para um repositório de terceiros, a menos que você tenha nomeado esse alvo externo402* Abertura de um pull request contra um repositório ou organização diferente, criação de fork com `gh repo fork` ou push para um repositório de terceiros, a menos que você tenha nomeado esse alvo externo

408 403 

404Várias dessas categorias dependem de entradas de [ambiente](/docs/pt/auto-mode-config#define-trusted-infrastructure), como alvos remotos sensíveis e escopos IaC protegidos, que você pode restringir a nomes concretos.

405 

409Claude Code v2.1.203 e posterior também bloqueiam estes por padrão:406Claude Code v2.1.203 e posterior também bloqueiam estes por padrão:

410 407 

411* Conteúdo de um armazenamento local sensível, ou de um arquivo cujo nome, caminho ou tipo o marca como sensível, entrando em um commit, um push, texto de PR ou issue, um gist ou paste ou uma publicação de pacote, a menos que você tenha nomeado tanto a origem quanto o destino. Transcrições de sessão e logs de conversa, pastas ocultas de credenciais e configuração como chaves SSH, credenciais de nuvem, perfis de navegador e histórico de shell, e exportações de dados de usuário contam, e o fato de o repositório ser privado não libera o bloqueio408* Conteúdo de um armazenamento local sensível, ou de um arquivo cujo nome, caminho ou tipo o marca como sensível, entrando em um commit, um push, texto de PR ou issue, um gist ou paste ou uma publicação de pacote, a menos que você tenha nomeado tanto a origem quanto o destino. Transcrições de sessão e logs de conversa, pastas ocultas de credenciais e configuração como chaves SSH, credenciais de nuvem, perfis de navegador e histórico de shell, e exportações de dados de usuário contam, e o fato de o repositório ser privado não libera o bloqueio


676* `.devcontainer`673* `.devcontainer`

677* `.yarn`674* `.yarn`

678* `.mvn`675* `.mvn`

679* `.claude`, exceto por `.claude/worktrees` onde Claude armazena seus próprios git worktrees, e exceto pelos arquivos markdown no diretório de [memória automática](/docs/pt/memory#storage-location) do próprio Claude em uma sessão iniciada sem `--restricted`676* `.claude`, com algumas exceções, como:

677 * Os próprios git worktrees do Claude em `.claude/worktrees/`

678 * Os próprios arquivos de plano da sessão atual em `~/.claude/plans/`, ou no [`plansDirectory`](/docs/pt/settings-reference#plansdirectory) que você definir

679 * O próprio diretório de rascunho de uma [sessão em segundo plano](/docs/pt/agent-view#where-state-is-stored) em `~/.claude/jobs/<id>/tmp/`

680 * Arquivos markdown no diretório de [memória automática](/docs/pt/memory#storage-location) do projeto, como `~/.claude/projects/<project>/memory/`, em uma sessão iniciada sem `--restricted`

681 * Arquivos markdown em um diretório de [memória de subagente](/docs/pt/sub-agents#enable-persistent-memory), como `.claude/agent-memory/`, em uma sessão iniciada sem `--restricted`

680* Um diretório que você carregou com [`--plugin-dir`](/docs/pt/plugins/mods/create#change-a-mod-with-claude), porque Claude Code recarrega e executa o código de um mod a partir dele quando um arquivo muda682* Um diretório que você carregou com [`--plugin-dir`](/docs/pt/plugins/mods/create#change-a-mod-with-claude), porque Claude Code recarrega e executa o código de um mod a partir dele quando um arquivo muda

681 683 

682Arquivos protegidos:684Arquivos protegidos:

permissions.md +2 −2

Details

87 87 

88| Modo | Descrição |88| Modo | Descrição |

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

90| `default` | Solicita permissão no primeiro uso de cada ferramenta. Rotulado como Manual na CLI, nas extensões VS Code e JetBrains, e no aplicativo desktop, e Claude Code aceita `manual` como um alias. O rótulo e o alias requerem Claude Code v2.1.200 ou posterior. O rótulo do aplicativo desktop não depende da sua versão da CLI |90| `default` | Solicita permissão no primeiro uso de cada ferramenta. Rotulado como Manual na CLI, nas extensões VS Code e JetBrains, e no aplicativo desktop, e Claude Code aceita `manual` como um alias |

91| `acceptEdits` | Aceita automaticamente edições de arquivo e comandos comuns do sistema de arquivos como `mkdir`, `touch`, `mv` e `cp` para caminhos no diretório de trabalho ou `additionalDirectories` |91| `acceptEdits` | Aceita automaticamente edições de arquivo e comandos comuns do sistema de arquivos como `mkdir`, `touch`, `mv` e `cp` para caminhos no diretório de trabalho ou `additionalDirectories` |

92| `plan` | Claude lê arquivos e executa comandos shell somente leitura para explorar, mas não edita seus arquivos de origem; com [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) disponível, comandos aprovados pelo classificador também são executados. Rotulado como Plan na CLI e na extensão VS Code |92| `plan` | Claude lê arquivos e executa comandos shell somente leitura para explorar, mas não edita seus arquivos de origem; com [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) disponível, comandos aprovados pelo classificador também são executados. Rotulado como Plan na CLI e na extensão VS Code |

93| `auto` | Executa sem prompts rotineiros; antes de ações como comandos shell e solicitações de rede serem executadas, um [classificador](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) em segundo plano verifica se elas se alinham com sua solicitação |93| `auto` | Executa sem prompts rotineiros; antes de ações como comandos shell e solicitações de rede serem executadas, um [classificador](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) em segundo plano verifica se elas se alinham com sua solicitação |


774 A exceção do diretório de configuração ignora apenas a etapa de confiança. `~/.claude/settings.local.json` ainda é [escopo local](/docs/pt/settings#compare-the-scope-of-each-settings-file), portanto Claude Code o lê apenas em sessões que você inicia no seu próprio diretório inicial, não em todos os projetos. Para aplicar regras de permissão em todos os seus projetos, adicione-as às suas configurações de usuário: `~/.claude/settings.json`, ou `$CLAUDE_CONFIG_DIR/settings.json` quando `CLAUDE_CONFIG_DIR` está definido.774 A exceção do diretório de configuração ignora apenas a etapa de confiança. `~/.claude/settings.local.json` ainda é [escopo local](/docs/pt/settings#compare-the-scope-of-each-settings-file), portanto Claude Code o lê apenas em sessões que você inicia no seu próprio diretório inicial, não em todos os projetos. Para aplicar regras de permissão em todos os seus projetos, adicione-as às suas configurações de usuário: `~/.claude/settings.json`, ou `$CLAUDE_CONFIG_DIR/settings.json` quando `CLAUDE_CONFIG_DIR` está definido.

775</Note>775</Note>

776 776 

777Nas versões 2.1.196 a 2.1.199, Claude Code retinha as regras do arquivo no seu diretório de configuração inicial e fora de repositórios git também, e imprimia o aviso [`this workspace has not been trusted`](/docs/pt/errors#workspace-has-not-been-trusted) lá. Antes da v2.1.207, Claude Code aplicava as regras de um arquivo não rastreado antes de você aceitar o diálogo.777Antes da v2.1.207, Claude Code aplicava as regras de um arquivo não rastreado antes de você aceitar o diálogo.

778 778 

779<h3 id="what-runs-before-you-trust-a-folder">779<h3 id="what-runs-before-you-trust-a-folder">

780 O que é executado antes de você confiar em uma pasta780 O que é executado antes de você confiar em uma pasta

platforms.md +3 −3

Details

39| [GitHub Actions](/docs/pt/github-actions) | Executa Claude em seu pipeline CI | Revisões automatizadas de PR, triagem de problemas, manutenção agendada |39| [GitHub Actions](/docs/pt/github-actions) | Executa Claude em seu pipeline CI | Revisões automatizadas de PR, triagem de problemas, manutenção agendada |

40| [GitLab CI/CD](/docs/pt/gitlab-ci-cd) | O mesmo que GitHub Actions para GitLab | Automação orientada por CI no GitLab |40| [GitLab CI/CD](/docs/pt/gitlab-ci-cd) | O mesmo que GitHub Actions para GitLab | Automação orientada por CI no GitLab |

41| [Code Review](/docs/pt/code-review) | Revisa cada PR automaticamente | Capturando bugs antes da revisão humana |41| [Code Review](/docs/pt/code-review) | Revisa cada PR automaticamente | Capturando bugs antes da revisão humana |

42| [Slack](/docs/pt/slack) | Responde a menções `@Claude` em seus canais | Transformando relatórios de bugs em pull requests do chat da equipe |42| [Slack](/docs/pt/slack) | Responde a menções `@Claude` em seus canais, com sua própria conta | Transformando relatórios de bugs em pull requests do chat da equipe nos planos Pro e Max |

43| [Claude Tag](https://claude.com/docs/claude-tag) | Executa `@Claude` como a identidade compartilhada de sua organização com acesso configurado pelo administrador | Acesso compartilhado da equipe em planos Team e Enterprise, em vez de sessões Slack por usuário |43| [Claude Tag](https://claude.com/docs/claude-tag) | Executa `@Claude` como a identidade compartilhada de sua organização com acesso configurado pelo administrador | Acesso compartilhado da equipe em planos Team e Enterprise, em vez de sessões Slack por usuário |

44 44 

45Para integrações não listadas aqui, [servidores MCP](/docs/pt/mcp) e [conectores](/docs/pt/desktop#connect-external-tools) permitem que você conecte quase qualquer coisa: Linear, Notion, Google Drive ou suas próprias APIs internas.45Para integrações não listadas aqui, [servidores MCP](/docs/pt/mcp) e [conectores](/docs/pt/desktop#connect-external-tools) permitem que você conecte quase qualquer coisa: Linear, Notion, Google Drive ou suas próprias APIs internas.


55| [Dispatch](/docs/pt/desktop#sessions-from-dispatch) | Envie uma tarefa a partir do aplicativo móvel Claude | Sua máquina (Desktop) | [Emparelhe o aplicativo móvel com Desktop](https://support.claude.com/en/articles/13947068) | Delegar trabalho enquanto você está ausente, configuração mínima |55| [Dispatch](/docs/pt/desktop#sessions-from-dispatch) | Envie uma tarefa a partir do aplicativo móvel Claude | Sua máquina (Desktop) | [Emparelhe o aplicativo móvel com Desktop](https://support.claude.com/en/articles/13947068) | Delegar trabalho enquanto você está ausente, configuração mínima |

56| [Remote Control](/docs/pt/remote-control) | Dirija uma sessão em execução a partir de [claude.ai/code](https://claude.ai/code) ou do aplicativo móvel Claude | Sua máquina (CLI, Desktop ou VS Code) | Execute [`claude remote-control` ou `/remote-control`](/docs/pt/remote-control#start-a-remote-control-session) | Orientar trabalho em andamento de outro dispositivo |56| [Remote Control](/docs/pt/remote-control) | Dirija uma sessão em execução a partir de [claude.ai/code](https://claude.ai/code) ou do aplicativo móvel Claude | Sua máquina (CLI, Desktop ou VS Code) | Execute [`claude remote-control` ou `/remote-control`](/docs/pt/remote-control#start-a-remote-control-session) | Orientar trabalho em andamento de outro dispositivo |

57| [Channels](/docs/pt/channels) | Envie eventos de um aplicativo de chat como Telegram ou Discord, ou seu próprio servidor | Sua máquina (CLI) | [Instale um plugin de canal](/docs/pt/channels#quickstart) ou [crie o seu próprio](/docs/pt/channels-reference) | Reagir a eventos externos como falhas de CI ou mensagens de chat |57| [Channels](/docs/pt/channels) | Envie eventos de um aplicativo de chat como Telegram ou Discord, ou seu próprio servidor | Sua máquina (CLI) | [Instale um plugin de canal](/docs/pt/channels#quickstart) ou [crie o seu próprio](/docs/pt/channels-reference) | Reagir a eventos externos como falhas de CI ou mensagens de chat |

58| [Slack](/docs/pt/slack) | Mencione `@Claude` em um canal de equipe | Nuvem Anthropic | [Instale o aplicativo Slack](/docs/pt/slack#setting-up-claude-code-in-slack) com [Claude Code na web](/docs/pt/claude-code-on-the-web) ativado | PRs e revisões do chat da equipe |58| [Slack](/docs/pt/slack) | Mencione `@Claude` em um canal de equipe | Nuvem Anthropic | [Instale o aplicativo Slack](/docs/pt/slack#setting-up-claude-code-in-slack) com [Claude Code na web](/docs/pt/claude-code-on-the-web) ativado, em planos Pro e Max | PRs e revisões do chat da equipe |

59| [Self-hosted environments](/docs/pt/self-hosted-environments) | Inicie uma [sessão na nuvem](/docs/pt/claude-code-on-the-web) e escolha o ambiente da sua organização | Infraestrutura da sua organização | [Implante runners](/docs/pt/self-hosted-environments-quickstart), em planos Team e Enterprise | Sessões na nuvem que devem ser executadas dentro da sua rede |59| [Self-hosted environments](/docs/pt/self-hosted-environments) | Inicie uma [sessão na nuvem](/docs/pt/claude-code-on-the-web) e escolha o ambiente da sua organização | Infraestrutura da sua organização | [Implante runners](/docs/pt/self-hosted-environments-quickstart), em planos Team e Enterprise | Sessões na nuvem que devem ser executadas dentro da sua rede |

60| [Scheduled tasks](/docs/pt/scheduled-tasks) | Defina um cronograma | [CLI](/docs/pt/scheduled-tasks), [Desktop](/docs/pt/desktop-scheduled-tasks), ou [nuvem](/docs/pt/routines) | Escolha uma frequência | Automação recorrente como revisões diárias |60| [Scheduled tasks](/docs/pt/scheduled-tasks) | Defina um cronograma | [CLI](/docs/pt/scheduled-tasks), [Desktop](/docs/pt/desktop-scheduled-tasks), ou [nuvem](/docs/pt/routines) | Escolha uma frequência | Automação recorrente como revisões diárias |

61 61 


86* [GitHub Actions](/docs/pt/github-actions): execute Claude em seu pipeline CI86* [GitHub Actions](/docs/pt/github-actions): execute Claude em seu pipeline CI

87* [GitLab CI/CD](/docs/pt/gitlab-ci-cd): o mesmo para GitLab87* [GitLab CI/CD](/docs/pt/gitlab-ci-cd): o mesmo para GitLab

88* [Code Review](/docs/pt/code-review): revisão automática em cada pull request88* [Code Review](/docs/pt/code-review): revisão automática em cada pull request

89* [Slack](/docs/pt/slack): envie tarefas do chat da equipe, obtenha PRs de volta89* [Slack](/docs/pt/slack): envie tarefas do chat da equipe e obtenha PRs de volta, nos planos Pro e Max

90* [Claude Tag](https://claude.com/docs/claude-tag): execute `@Claude` como a identidade compartilhada de sua organização em planos Team e Enterprise90* [Claude Tag](https://claude.com/docs/claude-tag): execute `@Claude` como a identidade compartilhada de sua organização em planos Team e Enterprise

91 91 

92<h3 id="remote-access">92<h3 id="remote-access">

Details

73 73 

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

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

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

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

78 </Step>78 </Step>

79 79 

Details

8 8 

9Um [mod](/docs/pt/plugins/mods/overview) é um plugin que executa código dentro do Claude Code com as permissões do usuário que o instalou. Mods não são sandboxed. Através de [configurações gerenciadas](/docs/pt/managed-settings), você decide se mods são executados nas máquinas dos seus usuários, quais são e em que ordem. Você também pode instalar um mod seu que monitora ou recusa o que outros mods fazem.9Um [mod](/docs/pt/plugins/mods/overview) é um plugin que executa código dentro do Claude Code com as permissões do usuário que o instalou. Mods não são sandboxed. Através de [configurações gerenciadas](/docs/pt/managed-settings), você decide se mods são executados nas máquinas dos seus usuários, quais são e em que ordem. Você também pode instalar um mod seu que monitora ou recusa o que outros mods fazem.

10 10 

11Esta página é para a pessoa que implanta configurações gerenciadas para Claude Code, seja como um arquivo, através de MDM ou do console de administração do claude.ai. Mods estão ativados por padrão no Claude Code v2.1.287 e posterior. Comece com a seção que corresponde ao que você veio fazer:11Esta página é para a pessoa que implanta configurações gerenciadas para Claude Code, seja como um arquivo, através de MDM ou do console de administração do claude.ai. Mods estão ativados por padrão no Claude Code v2.1.286 e posterior. Comece com a seção que corresponde ao que você veio fazer:

12 12 

13* **Mantenha os mods próprios dos usuários fora, com ou sem mods seus**: [Interrompa mods instalados pelo usuário de serem carregados](#stop-user-installed-mods-from-loading)13* **Mantenha os mods próprios dos usuários fora, com ou sem mods seus**: [Interrompa mods instalados pelo usuário de serem carregados](#stop-user-installed-mods-from-loading)

14* **Veja o que seus usuários obtêm quando você não muda nada**: [Saiba o que acontece por padrão](#know-what-happens-by-default)14* **Veja o que seus usuários obtêm quando você não muda nada**: [Saiba o que acontece por padrão](#know-what-happens-by-default)

Details

14Se você ainda não decidiu se um mod é a ferramenta certa, leia primeiro a [comparação na visão geral](/docs/pt/plugins/mods/overview#compare-mods-settings-hooks-skills-and-mcp-servers).14Se você ainda não decidiu se um mod é a ferramenta certa, leia primeiro a [comparação na visão geral](/docs/pt/plugins/mods/overview#compare-mods-settings-hooks-skills-and-mcp-servers).

15 15 

16<Note>16<Note>

17 Mods requerem Claude Code v2.1.287 ou posterior. Em seu shell, execute `claude --version` para verificar. Para ver se mods podem ser carregados para você, consulte [Verificar se mods podem ser carregados](/docs/pt/plugins/mods/troubleshoot#check-whether-mods-can-load).17 Use o Claude Code v2.1.287 ou posterior. Em seu shell, execute `claude --version` para verificar. Para ver se mods podem ser carregados para você, consulte [Verificar se mods podem ser carregados](/docs/pt/plugins/mods/troubleshoot#check-whether-mods-can-load).

18</Note>18</Note>

19 19 

20<h2 id="ask-claude-for-a-mod">20<h2 id="ask-claude-for-a-mod">

Details

110 Ativar ou desativar mods110 Ativar ou desativar mods

111</h2>111</h2>

112 112 

113Os mods requerem Claude Code v2.1.287 ou posterior, e estão ativados por padrão. No seu shell, execute `claude --version` para verificar e atualize o Claude Code se o seu for mais antigo.113Os mods estão ativados por padrão. No terminal, use o Claude Code v2.1.287 ou posterior. O aplicativo Desktop inclui sua própria cópia do Claude Code, e os mods funcionam nele a partir da v2.1.286. Verifique a versão no local onde você usa mods:

114 

115* **Terminal**: no seu shell, execute `claude --version`. Se a sua for mais antiga, [atualize o Claude Code](/docs/pt/setup#update-claude-code).

116* **Aplicativo Desktop**: em uma sessão local na aba Code, digite `/status` e leia a linha **Claude Code**, que mostra uma versão como `2.1.286`. Se a sua for mais antiga, atualize o aplicativo Desktop.

114 117 

115Para desativar mods, escolha quantos parar e por quanto tempo. Para ativá-los novamente, desfaça a mesma alteração:118Para desativar mods, escolha quantos parar e por quanto tempo. Para ativá-los novamente, desfaça a mesma alteração:

116 119 

Details

40 40 

41Nada que o mod adiciona aparece: nenhum comando, nenhum desenho e nenhuma mudança de comportamento.41Nada que o mod adiciona aparece: nenhum comando, nenhum desenho e nenhuma mudança de comportamento.

42 42 

43<h3 id="your-version-is-older-than-2-1-287">43<h3 id="your-version-is-too-old">

44 Sua versão é mais antiga que 2.1.28744 Sua versão é antiga demais

45</h3>45</h3>

46 46 

47`claude --version` imprime uma versão mais antiga que 2.1.287. Sua versão é anterior aos mods estarem ativados por padrão.47Consulte [qual versão usar e como verificar a sua](/docs/pt/plugins/mods/overview#turn-mods-on-or-off).

48 

49[Atualize Claude Code](/docs/pt/setup#update-claude-code).

50 48 

51<h3 id="the-mods-active-line-doesn’t-name-the-mod">49<h3 id="the-mods-active-line-doesn’t-name-the-mod">

52 A linha `mods active` não nomeia o mod50 A linha `mods active` não nomeia o mod

Details

695* **Um plugin que alguém publicou**: abra **Installed** em `/plugin` e abra o painel de detalhes do plugin, que lista o que o plugin contém. Um plugin que não lista skills lá não tem nenhuma para oferecer quando você digita `/`695* **Um plugin que alguém publicou**: abra **Installed** em `/plugin` e abra o painel de detalhes do plugin, que lista o que o plugin contém. Um plugin que não lista skills lá não tem nenhuma para oferecer quando você digita `/`

696 696 

697<h3 id="run-reload-plugins-to-activate">697<h3 id="run-reload-plugins-to-activate">

698 `Run /reload-plugins to activate.`698 `Run /reload-plugins to apply.`

699</h3>699</h3>

700 700 

701O resumo de instalação em `/plugin` terminou com `Run /reload-plugins to activate.` em vez de `Plugin is now active.`701O resumo de instalação em `/plugin` terminou com `Run /reload-plugins to apply.` em vez de `Plugin is now active.` Um aviso `Plugins changed. Run /reload-plugins to activate.` pode aparecer acima do prompt ao mesmo tempo.

702 702 

703Claude Code não ativou o plugin durante a instalação, seja porque ativá-lo [invalidaria o cache de prompt](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin) ou porque a tentativa de ativação falhou.703Claude Code não ativou o plugin durante a instalação, seja porque ativá-lo [invalidaria o cache de prompt](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin) ou porque a tentativa de ativação falhou.

704 704 

Details

235 Ações que mantêm o cache235 Ações que mantêm o cache

236</h2>236</h2>

237 237 

238Essas ações ou anexam ao final da conversa ou não tocam na solicitação. Algumas delas, como editar CLAUDE.md, mantêm o cache pela mesma razão que a mudança não chega à sessão em execução até `/clear`, `/compact` ou uma reinicialização.238Essas ações ou anexam ao final da conversa ou não tocam na requisição. Algumas delas, como editar CLAUDE.md, mantêm o cache pela mesma razão que a mudança não chega à sessão em execução até `/clear`, `/compact` ou uma reinicialização.

239 239 

240* [Editando arquivos em seu repositório](#editing-files-in-your-repository)240* [Editando arquivos em seu repositório](#editing-files-in-your-repository)

241* [Editando CLAUDE.md durante a sessão](#editing-claude-md-mid-session)241* [Editando CLAUDE.md durante a sessão](#editing-claude-md-mid-session)


258 258 

259Seus arquivos CLAUDE.md no nível do projeto-raiz e do usuário são lidos uma vez no início da sessão e mantidos na memória. Editá-los durante a sessão não invalida o cache, mas a edição também não se aplica. Claude continua trabalhando com a versão que foi carregada no início da sessão. O novo conteúdo é carregado na próxima `/clear`, `/compact` ou reinicialização.259Seus arquivos CLAUDE.md no nível do projeto-raiz e do usuário são lidos uma vez no início da sessão e mantidos na memória. Editá-los durante a sessão não invalida o cache, mas a edição também não se aplica. Claude continua trabalhando com a versão que foi carregada no início da sessão. O novo conteúdo é carregado na próxima `/clear`, `/compact` ou reinicialização.

260 260 

261[Arquivos CLAUDE.md aninhados em subdiretórios](/docs/pt/memory) e [regras com frontmatter `paths:`](/docs/pt/memory#path-specific-rules) são carregados depois, quando Claude lê um arquivo correspondente pela primeira vez. Editar um antes de ser carregado tem efeito. Depois de carregado, o conteúdo faz parte do histórico da conversa, então uma edição durante a sessão não muda retroativamente.261[Arquivos CLAUDE.md aninhados em subdiretórios](/docs/pt/memory) e [regras com frontmatter `paths:`](/docs/pt/memory#path-specific-rules) são carregados depois, sob demanda. Editar um você mesmo antes de ser carregado tem efeito. Depois de carregado, o conteúdo faz parte do histórico da conversa, então uma edição durante a sessão não o muda retroativamente.

262 262 

263<h3 id="changing-permission-mode">263<h3 id="changing-permission-mode">

264 Alterando modo de permissão264 Alterando modo de permissão

265</h3>265</h3>

266 266 

267Alternar entre [modos de permissão](/docs/pt/permission-modes), como de Manual para aceitar edições, não muda o prompt do sistema ou as definições de ferramentas, então as mudanças de modo são seguras para o cache. A exceção é o modo de plano com a configuração de modelo [`opusplan`](/docs/pt/model-config#opusplan-model-setting), que alterna o modelo entre Opus e Sonnet conforme você entra ou sai do modo de plano. Isso torna a alternância de modo uma [mudança de modelo](#switching-models).267Alternar entre [modos de permissão](/docs/pt/permission-modes), como de Manual para aceitar edições, não muda o system prompt ou as definições de ferramentas, então as mudanças de modo são seguras para o cache. A exceção é o modo de planejamento com a configuração de modelo [`opusplan`](/docs/pt/model-config#opusplan-model-setting), que alterna o modelo entre Opus e Sonnet conforme você entra ou sai do modo de planejamento. Isso torna a alternância de modo uma [mudança de modelo](#switching-models).

268 268 

269<h3 id="changing-output-style">269<h3 id="changing-output-style">

270 Alterando estilo de saída270 Alterando estilo de saída

271</h3>271</h3>

272 272 

273Quando você alterna [estilos de saída](/docs/pt/output-styles) durante a sessão com [`/output-style`](/docs/pt/output-styles#change-your-output-style), `/config` ou a configuração `outputStyle`, Claude usa o novo estilo a partir da sua próxima mensagem. Claude Code entrega as instruções do novo estilo como uma mensagem na conversa, então essa solicitação ainda lê o prompt do sistema e a conversa anterior do cache.273Quando você alterna [estilos de saída](/docs/pt/output-styles) durante a sessão com [`/output-style`](/docs/pt/output-styles#change-your-output-style), `/config` ou a configuração `outputStyle`, Claude usa o novo estilo a partir da sua próxima mensagem. Claude Code entrega as instruções do novo estilo como uma mensagem na conversa, então essa requisição ainda lê o system prompt e a conversa anterior do cache.

274 274 

275Antes da v2.1.251, uma mudança de estilo durante a sessão mantinha o cache mas não se aplicava até você executar `/clear` ou iniciar uma nova sessão.275Antes da v2.1.251, uma mudança de estilo durante a sessão mantinha o cache mas não se aplicava até você executar `/clear` ou iniciar uma nova sessão.

276 276 


290 Revertendo a conversa290 Revertendo a conversa

291</h3>291</h3>

292 292 

293[`/rewind`](/docs/pt/checkpointing) trunca sua conversa de volta a um turno anterior. O histórico restante é o mesmo conteúdo do qual o cache foi construído naquele ponto, e o prompt do sistema e as camadas de contexto do projeto não mudam, então a próxima solicitação atinge a entrada de cache anterior. Cada turno desde então leu através desse prefixo, o que manteve a entrada ativa mesmo se o turno original foi há mais tempo do que o TTL.293[`/rewind`](/docs/pt/checkpointing) trunca sua conversa de volta a um turno anterior. O histórico restante é o mesmo conteúdo do qual o cache foi construído naquele ponto, e o system prompt e as camadas de contexto do projeto não mudam, então a próxima requisição atinge a entrada de cache anterior. Cada turno desde então leu através desse prefixo, o que manteve a entrada ativa mesmo se o turno original foi há mais tempo do que o TTL.

294 294 

295Restaurar checkpoints de arquivo junto com a conversa não tem efeito separado no cache. O conteúdo dos arquivos entra no contexto apenas quando Claude os lê, o mesmo que [editar arquivos em seu repositório](#editing-files-in-your-repository).295Restaurar checkpoints de arquivo junto com a conversa não tem efeito separado no cache. O conteúdo dos arquivos entra no contexto apenas quando Claude os lê, o mesmo que [editar arquivos em seu repositório](#editing-files-in-your-repository).

296 296 

prompt-library.md +11 −11

Details

1184 prompt: "leia {input} e redija os itens de ação, depois crie um ticket no {tracker} para cada um com critérios de aceitação",1184 prompt: "leia {input} e redija os itens de ação, depois crie um ticket no {tracker} para cada um com critérios de aceitação",

1185 slots: {1185 slots: {

1186 input: "@meeting-notes.md",1186 input: "@meeting-notes.md",

1187 tracker: "Linear"1187 tracker: "nosso rastreador de problemas"

1188 }1188 }

1189 },1189 },

1190 "map-edge-cases-before": {1190 "map-edge-cases-before": {


1212 next: "Peça a Claude para escrever o padrão que seguiu em `CLAUDE.md` para que futuras sessões o correspondam sem a referência",1212 next: "Peça a Claude para escrever o padrão que seguiu em `CLAUDE.md` para que futuras sessões o correspondam sem a referência",

1213 prompt: "veja como {example} é implementado para entender o padrão, depois crie {new} da mesma forma",1213 prompt: "veja como {example} é implementado para entender o padrão, depois crie {new} da mesma forma",

1214 slots: {1214 slots: {

1215 example: "o handler de webhook do GitHub",1215 example: "o handler de webhook existente",

1216 new: "um handler de webhook do Stripe"1216 new: "um handler de webhook de pagamentos"

1217 }1217 }

1218 },1218 },

1219 "add-a-small-well": {1219 "add-a-small-well": {


1419 "open-a-pull-request": {1419 "open-a-pull-request": {

1420 title: "Abrir um pull request a partir de um ticket",1420 title: "Abrir um pull request a partir de um ticket",

1421 teaches: "Pule a troca de contexto entre rastreador, editor e GitHub. Um prompt lê a especificação, faz a mudança e abre o PR.",1421 teaches: "Pule a troca de contexto entre rastreador, editor e GitHub. Um prompt lê a especificação, faz a mudança e abre o PR.",

1422 prompt: "encontre o ticket do {tracker} sobre {topic} e abra um PR que o implemente",1422 prompt: "encontre o ticket sobre {topic} no {tracker} e abra um PR que o implemente",

1423 slots: {1423 slots: {

1424 tracker: "Linear",1424 tracker: "nosso rastreador de problemas",

1425 topic: "o timeout de login"1425 topic: "o timeout de login"

1426 }1426 }

1427 },1427 },


1470 "investigate-a-production-incident": {1470 "investigate-a-production-incident": {

1471 title: "Investigar um incidente de produção",1471 title: "Investigar um incidente de produção",

1472 teaches: "Liste as fontes de evidência para correlacionar, não os passos a tomar. Claude lê logs, histórico git e configuração juntos para estreitar a causa.",1472 teaches: "Liste as fontes de evidência para correlacionar, não os passos a tomar. Claude lê logs, histórico git e configuração juntos para estreitar a causa.",

1473 next: "Conecte Sentry ou seu armazenamento de logs via MCP",1473 next: "Conecte seu rastreador de erros ou armazenamento de logs via MCP",

1474 prompt: "{symptom}. verifique os logs, os deploys recentes e as mudanças de configuração, depois me diga a causa mais provável",1474 prompt: "{symptom}. verifique os logs, os deploys recentes e as mudanças de configuração, depois me diga a causa mais provável",

1475 slots: {1475 slots: {

1476 symptom: "o endpoint de checkout começou a retornar 500s há uma hora"1476 symptom: "o endpoint de checkout começou a retornar 500s há uma hora"


1489 "diagnose-from-a-console": {1489 "diagnose-from-a-console": {

1490 title: "Diagnosticar a partir de uma captura de tela do console",1490 title: "Diagnosticar a partir de uma captura de tela do console",

1491 teaches: "Consoles em nuvem mostram o problema mas não os comandos para corrigi-lo. Claude lê a captura de tela e traduz o dashboard nos comandos kubectl, gcloud ou aws para executar.",1491 teaches: "Consoles em nuvem mostram o problema mas não os comandos para corrigi-lo. Claude lê a captura de tela e traduz o dashboard nos comandos kubectl, gcloud ou aws para executar.",

1492 prompt: "aqui está uma captura de tela {console}. explique passo a passo por que {resource} está falhando e me dê os comandos exatos para corrigir",1492 prompt: "aqui está uma captura de tela de {console}. explique passo a passo por que {resource} está falhando e me dê os comandos exatos para corrigir",

1493 slots: {1493 slots: {

1494 console: "do dashboard do Kubernetes no GCP",1494 console: "nosso dashboard do Kubernetes",

1495 resource: "este pod"1495 resource: "este pod"

1496 }1496 }

1497 },1497 },


1538 "connect-a-tool-with": {1538 "connect-a-tool-with": {

1539 title: "Conectar uma ferramenta com MCP",1539 title: "Conectar uma ferramenta com MCP",

1540 teaches: "Conecte a fonte uma vez em vez de colar dados a cada sessão. Após a configuração do [MCP](/docs/pt/mcp), Claude lê da ferramenta diretamente quando você pergunta sobre ela.",1540 teaches: "Conecte a fonte uma vez em vez de colar dados a cada sessão. Após a configuração do [MCP](/docs/pt/mcp), Claude lê da ferramenta diretamente quando você pergunta sobre ela.",

1541 prompt: "configure o servidor MCP do {server} para que você possa ler meus {data} diretamente",1541 prompt: "conecte {server} via MCP para que você possa ler os {data} dele diretamente",

1542 slots: {1542 slots: {

1543 server: "Sentry",1543 server: "nosso rastreador de erros",

1544 data: "relatórios de erros"1544 data: "stack traces"

1545 }1545 }

1546 },1546 },

1547 "capture-what-to-remember": {1547 "capture-what-to-remember": {

quickstart.md +6 −6

Details

33 <Tab title="Instalação Nativa (Recomendado)">33 <Tab title="Instalação Nativa (Recomendado)">

34 **macOS, Linux, WSL:**34 **macOS, Linux, WSL:**

35 35 

36 ```bash theme={null}36 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

37 curl -fsSL https://claude.ai/install.sh | bash37 curl -fsSL https://claude.ai/install.sh | bash

38 ```38 ```

39 39 

40 **Windows PowerShell:**40 **Windows PowerShell:**

41 41 

42 ```powershell theme={null}42 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

43 irm https://claude.ai/install.ps1 | iex43 irm https://claude.ai/install.ps1 | iex

44 ```44 ```

45 45 

46 **Windows CMD:**46 **Windows CMD:**

47 47 

48 ```batch theme={null}48 ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50 ```50 ```

51 51 


63 </Tab>63 </Tab>

64 64 

65 <Tab title="Homebrew">65 <Tab title="Homebrew">

66 ```bash theme={null}66 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

67 brew install --cask claude-code67 brew install --cask claude-code

68 ```68 ```

69 69 


75 </Tab>75 </Tab>

76 76 

77 <Tab title="WinGet">77 <Tab title="WinGet">

78 ```powershell theme={null}78 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

79 winget install Anthropic.ClaudeCode79 winget install Anthropic.ClaudeCode

80 ```80 ```

81 81 


382* **Em Claude Code**: Digite `/help` ou pergunte "how do I..."382* **Em Claude Code**: Digite `/help` ou pergunte "how do I..."

383* **Documentação**: Você está aqui! Navegue por outros guias383* **Documentação**: Você está aqui! Navegue por outros guias

384* **Cursos**: Faça [Claude Code 101](https://academy.claude.com/courses/claude-code-101) e outros cursos gratuitos no seu próprio ritmo em [Claude Academy](https://academy.claude.com/)384* **Cursos**: Faça [Claude Code 101](https://academy.claude.com/courses/claude-code-101) e outros cursos gratuitos no seu próprio ritmo em [Claude Academy](https://academy.claude.com/)

385* **Comunidade**: Junte-se ao nosso [Discord](https://www.anthropic.com/discord) para dicas e suporte385* **Comunidade**: Junte-se ao [servidor do Discord](https://www.anthropic.com/discord) para dicas e suporte

Details

236 236 

237Enquanto Remote Control está conectado, a transcrição da sessão, incluindo suas mensagens, respostas do Claude e atividade de ferramentas, é armazenada nos servidores Anthropic. A transcrição armazenada mantém a conversa sincronizada em seus dispositivos e permite que a sessão se reconecte após uma queda de rede. A execução e o acesso ao sistema de arquivos permanecem na sua máquina, e as transcrições armazenadas são retidas sob a política de [Uso de dados](/docs/pt/data-usage).237Enquanto Remote Control está conectado, a transcrição da sessão, incluindo suas mensagens, respostas do Claude e atividade de ferramentas, é armazenada nos servidores Anthropic. A transcrição armazenada mantém a conversa sincronizada em seus dispositivos e permite que a sessão se reconecte após uma queda de rede. A execução e o acesso ao sistema de arquivos permanecem na sua máquina, e as transcrições armazenadas são retidas sob a política de [Uso de dados](/docs/pt/data-usage).

238 238 

239Para desativar Remote Control completamente, use a configuração [`disableRemoteControl`](/docs/pt/settings-reference#disableremotecontrol). Organizações com requisitos de conformidade, como Zero Data Retention, não podem ativar Remote Control.239Para desativar Remote Control completamente, use a configuração [`disableRemoteControl`](/docs/pt/settings-reference#disableremotecontrol). Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) ativado, ou com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada, não podem ativar Remote Control.

240 240 

241<h2 id="trusted-devices">241<h2 id="trusted-devices">

242 Dispositivos Confiáveis242 Dispositivos Confiáveis


316| [Dispatch](/docs/pt/desktop#sessions-from-dispatch) | Envie uma tarefa a partir do aplicativo móvel Claude | Sua máquina (Desktop) | [Emparelhe o aplicativo móvel com Desktop](https://support.claude.com/en/articles/13947068) | Delegar trabalho enquanto você está ausente, configuração mínima |316| [Dispatch](/docs/pt/desktop#sessions-from-dispatch) | Envie uma tarefa a partir do aplicativo móvel Claude | Sua máquina (Desktop) | [Emparelhe o aplicativo móvel com Desktop](https://support.claude.com/en/articles/13947068) | Delegar trabalho enquanto você está ausente, configuração mínima |

317| [Remote Control](/docs/pt/remote-control) | Dirija uma sessão em execução a partir de [claude.ai/code](https://claude.ai/code) ou do aplicativo móvel Claude | Sua máquina (CLI, Desktop ou VS Code) | Execute [`claude remote-control` ou `/remote-control`](/docs/pt/remote-control#start-a-remote-control-session) | Orientar trabalho em andamento de outro dispositivo |317| [Remote Control](/docs/pt/remote-control) | Dirija uma sessão em execução a partir de [claude.ai/code](https://claude.ai/code) ou do aplicativo móvel Claude | Sua máquina (CLI, Desktop ou VS Code) | Execute [`claude remote-control` ou `/remote-control`](/docs/pt/remote-control#start-a-remote-control-session) | Orientar trabalho em andamento de outro dispositivo |

318| [Channels](/docs/pt/channels) | Envie eventos de um aplicativo de chat como Telegram ou Discord, ou seu próprio servidor | Sua máquina (CLI) | [Instale um plugin de canal](/docs/pt/channels#quickstart) ou [crie o seu próprio](/docs/pt/channels-reference) | Reagir a eventos externos como falhas de CI ou mensagens de chat |318| [Channels](/docs/pt/channels) | Envie eventos de um aplicativo de chat como Telegram ou Discord, ou seu próprio servidor | Sua máquina (CLI) | [Instale um plugin de canal](/docs/pt/channels#quickstart) ou [crie o seu próprio](/docs/pt/channels-reference) | Reagir a eventos externos como falhas de CI ou mensagens de chat |

319| [Slack](/docs/pt/slack) | Mencione `@Claude` em um canal de equipe | Nuvem Anthropic | [Instale o aplicativo Slack](/docs/pt/slack#setting-up-claude-code-in-slack) com [Claude Code na web](/docs/pt/claude-code-on-the-web) ativado | PRs e revisões do chat da equipe |319| [Slack](/docs/pt/slack) | Mencione `@Claude` em um canal de equipe | Nuvem Anthropic | [Instale o aplicativo Slack](/docs/pt/slack#setting-up-claude-code-in-slack) com [Claude Code na web](/docs/pt/claude-code-on-the-web) ativado, em planos Pro e Max | PRs e revisões do chat da equipe |

320| [Self-hosted environments](/docs/pt/self-hosted-environments) | Inicie uma [sessão na nuvem](/docs/pt/claude-code-on-the-web) e escolha o ambiente da sua organização | Infraestrutura da sua organização | [Implante runners](/docs/pt/self-hosted-environments-quickstart), em planos Team e Enterprise | Sessões na nuvem que devem ser executadas dentro da sua rede |320| [Self-hosted environments](/docs/pt/self-hosted-environments) | Inicie uma [sessão na nuvem](/docs/pt/claude-code-on-the-web) e escolha o ambiente da sua organização | Infraestrutura da sua organização | [Implante runners](/docs/pt/self-hosted-environments-quickstart), em planos Team e Enterprise | Sessões na nuvem que devem ser executadas dentro da sua rede |

321| [Scheduled tasks](/docs/pt/scheduled-tasks) | Defina um cronograma | [CLI](/docs/pt/scheduled-tasks), [Desktop](/docs/pt/desktop-scheduled-tasks), ou [nuvem](/docs/pt/routines) | Escolha uma frequência | Automação recorrente como revisões diárias |321| [Scheduled tasks](/docs/pt/scheduled-tasks) | Defina um cronograma | [CLI](/docs/pt/scheduled-tasks), [Desktop](/docs/pt/desktop-scheduled-tasks), ou [nuvem](/docs/pt/routines) | Escolha uma frequência | Automação recorrente como revisões diárias |

322 322 


451 451 

452* **O erro menciona `disableRemoteControl`**: seu administrador de TI desabilitou Remote Control neste dispositivo através de [configurações gerenciadas](/docs/pt/managed-settings), independentemente do alternador em toda a organização e de como você está conectado.452* **O erro menciona `disableRemoteControl`**: seu administrador de TI desabilitou Remote Control neste dispositivo através de [configurações gerenciadas](/docs/pt/managed-settings), independentemente do alternador em toda a organização e de como você está conectado.

453* **Seu plano claude.ai é Pro ou Max**: 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 se conectar novamente sob seu plano atual.453* **Seu plano claude.ai é Pro ou Max**: 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 se conectar novamente sob seu plano atual.

454* **A mensagem não diz para entrar em contato com seu administrador de organização**: sua organização tem uma configuração HIPAA que é incompatível com Remote Control, e `/status` lista `HIPAA` em sua linha `Organization configuration`. Neste estado, o alternador de Remote Control do painel de administração está esmaecido, então um Owner não consegue alterá-lo lá. Entre em contato com o suporte Anthropic para discutir opções. Antes da v2.1.267, este caso mostrava "Remote Control isn't available for your organization due to its compliance policy" em vez disso.454* **A mensagem não diz para entrar em contato com seu administrador de organização**: sua organização tem a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada, o que desativa Remote Control. Para confirmar, execute `/status` e procure `HIPAA` na linha `Organization configuration`. Um Owner vê o alternador **Remote Control** esmaecido nas [configurações de administração](https://claude.ai/admin-settings/claude-code) e não consegue ativá-lo. 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.

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

456 456 

457Antes da v2.1.281, essa mensagem também aparecia quando Claude Code não tinha 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.457Antes da v2.1.281, essa mensagem também aparecia quando Claude Code não tinha 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.

sandboxing.md +1 −1

Details

1109</h2>1109</h2>

1110 1110 

1111* [Sandbox environments](/docs/pt/sandbox-environments): compare o sandbox integrado com dev containers, containers e VMs1111* [Sandbox environments](/docs/pt/sandbox-environments): compare o sandbox integrado com dev containers, containers e VMs

1112* [Security](/docs/pt/security): recursos de segurança abrangentes e melhores práticas1112* [Security](/docs/pt/security): recursos de segurança e boas práticas

1113* [Permissions](/docs/pt/permissions): configuração de permissão e controle de acesso1113* [Permissions](/docs/pt/permissions): configuração de permissão e controle de acesso

1114* [All settings](/docs/pt/settings-reference): todas as chaves de configuração1114* [All settings](/docs/pt/settings-reference): todas as chaves de configuração

1115* [CLI reference](/docs/pt/cli-reference): opções de linha de comando1115* [CLI reference](/docs/pt/cli-reference): opções de linha de comando

Details

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

45* O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.45* O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.

46 46 

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

48 48 

49<h3 id="enable-for-your-team-in-local-sessions">49<h3 id="enable-for-your-team-in-local-sessions">

50 Ativar para sua equipe em sessões locais50 Ativar para sua equipe em sessões locais

Details

45Verifique estas antes de planejar um lançamento:45Verifique estas antes de planejar um lançamento:

46 46 

47* **Planos**: beta pública para organizações Team e Enterprise. Ambientes auto-hospedados estão desativados por padrão; um [Proprietário](/docs/pt/cloud-environments#organization-shared-environments) ativa **Permitir ambientes auto-hospedados** na [página de administrador **Ambientes na nuvem**](https://claude.ai/admin-settings/cloud-environments), que requer que [sessões na nuvem](/docs/pt/claude-code-on-the-web) estejam habilitadas para a organização.47* **Planos**: beta pública para organizações Team e Enterprise. Ambientes auto-hospedados estão desativados por padrão; um [Proprietário](/docs/pt/cloud-environments#organization-shared-environments) ativa **Permitir ambientes auto-hospedados** na [página de administrador **Ambientes na nuvem**](https://claude.ai/admin-settings/cloud-environments), que requer que [sessões na nuvem](/docs/pt/claude-code-on-the-web) estejam habilitadas para a organização.

48* **Zero Data Retention**: indisponível para organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado.48* **Zero Data Retention e HIPAA**: indisponível para organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado ou com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada.

49* **Inferência de modelo**: as sessões usam a API Anthropic, a menos que você configure um runner para [enviar requisições de modelo para Amazon Bedrock ou Google Cloud's Agent Platform](/docs/pt/self-hosted-environments-configuration#send-model-requests-to-bedrock-or-agent-platform). O conteúdo da sessão vai para a Anthropic em ambos os casos. Em um runner configurado dessa forma, as [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) e as políticas da organização do claude.ai não chegam às sessões.49* **Inferência de modelo**: as sessões usam a API Anthropic, a menos que você configure um runner para [enviar requisições de modelo para Amazon Bedrock ou Google Cloud's Agent Platform](/docs/pt/self-hosted-environments-configuration#send-model-requests-to-bedrock-or-agent-platform). O conteúdo da sessão vai para a Anthropic em ambos os casos. Em um runner configurado dessa forma, as [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) e as políticas da organização do claude.ai não chegam às sessões.

50* **Superfícies**: sessões iniciadas a partir de [claude.ai/code](https://claude.ai/code), dos aplicativos móvel e desktop, [rotinas agendadas](/docs/pt/routines) e do terminal, com [`claude --cloud`](/docs/pt/claude-code-on-the-web#from-terminal-to-cloud) ou um [despacho `--environment`](/docs/pt/self-hosted-environments-testing#run-the-test-loop), podem ser executadas em ambientes auto-hospedados. Sessões de [Claude Tag](https://claude.com/docs/claude-tag/overview) também podem ser executadas neles, mas Claude ainda não pode usar [Pacotes de acesso](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle) nessas sessões. Sessões de [Claude Security](/docs/pt/claude-security) e [Code Review](/docs/pt/code-review) ainda não são roteadas para eles. O suporte para essas duas superfícies segue separadamente.50* **Superfícies**: sessões iniciadas a partir de [claude.ai/code](https://claude.ai/code), dos aplicativos móvel e desktop, [rotinas agendadas](/docs/pt/routines) e do terminal, com [`claude --cloud`](/docs/pt/claude-code-on-the-web#from-terminal-to-cloud) ou um [despacho `--environment`](/docs/pt/self-hosted-environments-testing#run-the-test-loop), podem ser executadas em ambientes auto-hospedados. Sessões de [Claude Tag](https://claude.com/docs/claude-tag/overview) também podem ser executadas neles, mas Claude ainda não pode usar [Pacotes de acesso](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle) nessas sessões. Sessões de [Claude Security](/docs/pt/claude-security) e [Code Review](/docs/pt/code-review) ainda não são roteadas para eles. O suporte para essas duas superfícies segue separadamente.

51* **Repositórios**: as sessões verificam repositórios do GitHub; consulte [Opções de autenticação do GitHub](/docs/pt/claude-code-on-the-web#github-authentication-options). Para um host GitHub Enterprise Server, consulte seus [requisitos de rede](/docs/pt/github-enterprise-server#network-requirements).51* **Repositórios**: as sessões verificam repositórios do GitHub; consulte [Opções de autenticação do GitHub](/docs/pt/claude-code-on-the-web#github-authentication-options). Para um host GitHub Enterprise Server, consulte seus [requisitos de rede](/docs/pt/github-enterprise-server#network-requirements).

Details

156 156 

157Sem uma identidade, `git commit` falha com `Please tell me who you are` e as sessões não podem fazer progresso. Você pode usar sua própria identidade de bot em vez disso; o runner não substitui esses valores.157Sem uma identidade, `git commit` falha com `Please tell me who you are` e as sessões não podem fazer progresso. Você pode usar sua própria identidade de bot em vez disso; o runner não substitui esses valores.

158 158 

159Não cozinhe credenciais de push de longa duração ou amplamente escopo em uma imagem de runner compartilhada: uma credencial na imagem está disponível para cada sessão que a imagem executa, quem quer que a tenha iniciado. Em vez disso, crie um token de curta duração e escopo mínimo por sessão a partir de seu [script wrapper](/docs/pt/self-hosted-environments-configuration#wrapper-scripts), usando a identidade do criador da sessão decodificada do JWT da sessão. Emparelhe-o com um contêiner por sessão efêmero, que requer `--capacity 1`, para que nenhuma credencial sobreviva à sessão que a criou; consulte a [seção de endurecimento](#harden-your-deployment).159Não incorpore credenciais de push de longa duração ou de escopo amplo em uma imagem de runner compartilhada: uma credencial na imagem está disponível para cada sessão que a imagem executa, quem quer que a tenha iniciado. Em vez disso, crie um token de curta duração e escopo mínimo por sessão a partir de seu [script wrapper](/docs/pt/self-hosted-environments-configuration#wrapper-scripts), usando a identidade do criador da sessão decodificada do JWT da sessão. Emparelhe-o com um contêiner por sessão efêmero, que requer `--capacity 1`, para que nenhuma credencial sobreviva à sessão que a criou; consulte a [seção de endurecimento](#harden-your-deployment).

160 160 

161Se você deve configurar credenciais de push no nível de imagem, por exemplo para uma chave de implantação somente leitura, escopo-as tão bem quanto seu host git permite:161Se você deve configurar credenciais de push no nível de imagem, por exemplo para uma chave de implantação somente leitura, escopo-as tão bem quanto seu host git permite:

162 162 

163* Uma chave de implantação SSH limitada a um repositório com uma reescrita `url.<base>.insteadOf`163* Uma chave de implantação SSH limitada a um repositório com uma reescrita `url.<base>.insteadOf`

164* Um `credential.helper` que retorna um token minimamente escopo164* Um `credential.helper` que retorna um token com escopo mínimo

165* `GIT_SSH_COMMAND` apontando para uma chave estreitamente escopo165* `GIT_SSH_COMMAND` apontando para uma chave com escopo restrito

166 166 

167Qualquer mecanismo que você configure deve funcionar sem um prompt, porque o clone integrado do runner e fetch desabilitam os prompts que git, SSH, e Git Credential Manager mostrariam de outra forma:167Qualquer mecanismo que você configure deve funcionar sem um prompt, porque o clone integrado do runner e fetch desabilitam os prompts que git, SSH, e Git Credential Manager mostrariam de outra forma:

168 168 

Details

1765 * `"auto"`: Claude Code executa sem prompts rotineiros; antes de ações como comandos de shell e requisições de rede serem executadas, um classificador em segundo plano verifica se elas se alinham com sua solicitação1765 * `"auto"`: Claude Code executa sem prompts rotineiros; antes de ações como comandos de shell e requisições de rede serem executadas, um classificador em segundo plano verifica se elas se alinham com sua solicitação

1766 * `"dontAsk"`: Claude Code nega automaticamente cada chamada que de outra forma solicitaria; leituras, outras ações que não precisam de aprovação e ferramentas pré-aprovadas ainda são executadas1766 * `"dontAsk"`: Claude Code nega automaticamente cada chamada que de outra forma solicitaria; leituras, outras ações que não precisam de aprovação e ferramentas pré-aprovadas ainda são executadas

1767 * `"bypassPermissions"`: Claude Code executa tudo sem perguntar1767 * `"bypassPermissions"`: Claude Code executa tudo sem perguntar

1768 * `"manual"`: um alias para `"default"`, em Claude Code v2.1.200 ou posterior1768 * `"manual"`: um alias para `"default"`

1769* **Padrão**: não definido1769* **Padrão**: não definido

1770* **Substituições por sessão**: `--permission-mode` e seu equivalente `--dangerously-skip-permissions` para `bypassPermissions` têm precedência sobre esta chave para uma sessão1770* **Substituições por sessão**: `--permission-mode` e seu equivalente `--dangerously-skip-permissions` para `bypassPermissions` têm precedência sobre esta chave para uma sessão

1771 1771 


1777}1777}

1778```1778```

1779 1779 

1780As regras de permissão se sobrepõem a cada modo: as regras `deny` bloqueiam em cada modo, incluindo `bypassPermissions`. Consulte [Modos de permissão](/docs/pt/permission-modes). `manual` nomeia o modo de permissão rotulado Manual na CLI e na extensão VS Code; o alias requer Claude Code v2.1.200 ou posterior. Em sessões na nuvem, Claude Code honra apenas `acceptEdits`, `plan`, `default` e `auto` desta chave. Para conversas que a extensão VS Code inicia, consulte [qual configuração a extensão lê para o modo de permissão inicial](/docs/pt/permission-modes#switch-permission-modes).1780As regras de permissão se sobrepõem a cada modo: as regras `deny` bloqueiam em cada modo, incluindo `bypassPermissions`. Consulte [Modos de permissão](/docs/pt/permission-modes). Em sessões na nuvem, Claude Code honra apenas `acceptEdits`, `plan`, `default` e `auto` desta chave. Para conversas que a extensão VS Code inicia, consulte [qual configuração a extensão lê para o modo de permissão inicial](/docs/pt/permission-modes#switch-permission-modes).

1781 1781 

1782<h3 id="permissions-disablebypasspermissionsmode">1782<h3 id="permissions-disablebypasspermissionsmode">

1783 `permissions.disableBypassPermissionsMode`1783 `permissions.disableBypassPermissionsMode`


3232 `askUserQuestionTimeout`3232 `askUserQuestionTimeout`

3233</h3>3233</h3>

3234 3234 

3235Deixe um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) sem resposta continuar automaticamente após um período de tempo ocioso, enviando quaisquer opções que você já tivesse selecionado. Defina isso quando você se afastar e quiser que Claude continue sem você. Com o padrão, as perguntas aguardam até que você as responda. Para saber quando o temporizador pausa ou nunca inicia, veja [Timeout de continuação automática de perguntas](/docs/pt/tools-reference#question-auto-continue-timeout). Requer Claude Code v2.1.200 ou posterior.3235Deixe um diálogo [`AskUserQuestion`](/docs/pt/tools-reference) sem resposta continuar automaticamente após um período de tempo ocioso, enviando quaisquer opções que você já tivesse selecionado. Defina isso quando você se afastar e quiser que Claude continue sem você. Com o padrão, as perguntas aguardam até que você as responda. Para saber quando o temporizador pausa ou nunca inicia, veja [Timeout de continuação automática de perguntas](/docs/pt/tools-reference#question-auto-continue-timeout).

3236 3236 

3237* **Scope**: [`User or managed`](#scopes)3237* **Scope**: [`User or managed`](#scopes)

3238* **Type**: string, um de `"60s"`, `"5m"`, `"10m"`, ou `"never"`3238* **Type**: string, um de `"60s"`, `"5m"`, `"10m"`, ou `"never"`


3245}3245}

3246```3246```

3247 3247 

3248Aparece em `/config` como **Question auto-continue timeout**, que escreve esta chave nas configurações do usuário; Claude Code oculta a linha enquanto configurações gerenciadas ou a flag `--settings` definem a chave. Requer Claude Code v2.1.200 ou posterior.3248Aparece em `/config` como **Question auto-continue timeout**, que escreve esta chave nas configurações do usuário; Claude Code oculta a linha enquanto configurações gerenciadas ou a flag `--settings` definem a chave.

3249 3249 

3250<h3 id="autocontinueatusagelimit">3250<h3 id="autocontinueatusagelimit">

3251 `autoContinueAtUsageLimit`3251 `autoContinueAtUsageLimit`


5165}5165}

5166```5166```

5167 5167 

5168Plugins integrados armazenam suas opções sob a mesma chave com um sufixo `@builtin`. Por exemplo, a configuração [**Project instructions**](/docs/pt/memory#choose-which-instruction-files-load) que controla se Claude Code lê arquivos `AGENTS.md` é `pluginConfigs["agents-md@builtin"].options.instructionFiles`.5168Plugins integrados armazenam suas opções sob a mesma chave com um sufixo `@builtin`. Por exemplo, a configuração [**Project instructions**](/docs/pt/memory#choose-which-instruction-files-load) que controla se Claude Code lê arquivos `AGENTS.md` é `pluginConfigs["cc-plugin-agents-md@builtin"].options.instructionFiles`. Antes de v2.1.285, o ID do plugin era `agents-md@builtin`. Versões posteriores leem uma entrada sob qualquer um dos dois IDs.

5169 5169 

5170Claude Code ignora entradas de projeto e local porque substitui esses valores em configurações de plugin hook, MCP e LSP, e um repositório clonado não deve ser capaz de fornecê-los. Antes de v2.1.207, configurações de projeto e local também eram lidas.5170Claude Code ignora entradas de projeto e local porque substitui esses valores em configurações de plugin hook, MCP e LSP, e um repositório clonado não deve ser capaz de fornecê-los. Antes de v2.1.207, configurações de projeto e local também eram lidas.

5171 5171 

skills.md +3 −3

Details

40 Execute e verifique seu aplicativo40 Execute e verifique seu aplicativo

41</h3>41</h3>

42 42 

43Três skills agrupadas trabalham juntas para iniciar seu aplicativo e confirmar alterações em relação ao aplicativo em execução em vez de apenas testes:43Três skills incluídas trabalham juntas para iniciar seu aplicativo e confirmar alterações em relação ao aplicativo em execução em vez de apenas testes:

44 44 

45| Skill | Propósito |45| Skill | Propósito |

46| :- | :- |46| :- | :- |


52 52 

53`/run-skill-generator` registra a receita em vez disso. Ele coloca seu aplicativo em execução a partir de um ambiente limpo, captura o que funcionou (os comandos de instalação, as variáveis de ambiente, o script de lançamento) e o confirma como uma skill por projeto em `.claude/skills/run-<name>/`. Depois disso, `/run`, `/verify` e qualquer outro agente no repositório seguem a receita registrada em vez de redescobri-la. Execute `/run-skill-generator` uma vez por projeto e novamente se o processo de compilação ou lançamento mudar.53`/run-skill-generator` registra a receita em vez disso. Ele coloca seu aplicativo em execução a partir de um ambiente limpo, captura o que funcionou (os comandos de instalação, as variáveis de ambiente, o script de lançamento) e o confirma como uma skill por projeto em `.claude/skills/run-<name>/`. Depois disso, `/run`, `/verify` e qualquer outro agente no repositório seguem a receita registrada em vez de redescobri-la. Execute `/run-skill-generator` uma vez por projeto e novamente se o processo de compilação ou lançamento mudar.

54 54 

55`/verify` também pode registrar sua própria receita. Quando ele precisa compilar e conduzir seu aplicativo sem uma receita registrada, ele escreve o que funcionou em `.claude/skills/verify/SKILL.md` na raiz do repositório, ou no diretório de pacote tocado em um monorepo, para que execuções posteriores e outros agentes sigam as mesmas etapas. Na raiz do repositório, a skill registrada substitui o `/verify` agrupado. Isso requer Claude Code v2.1.200 ou posterior.55`/verify` também pode registrar sua própria receita. Quando ele precisa compilar e conduzir seu aplicativo sem uma receita registrada, ele escreve o que funcionou em `.claude/skills/verify/SKILL.md` na raiz do repositório, ou no diretório de pacote tocado em um monorepo, para que execuções posteriores e outros agentes sigam as mesmas etapas. Na raiz do repositório, a skill registrada substitui o `/verify` incluído.

56 56 

57Claude edita o arquivo registrado apenas quando direcionou uma execução incorretamente, como um comando que falhou ou uma etapa ausente, para que você possa confirmar o arquivo sem diffs por sessão. Antes da v2.1.205, a skill agrupada dizia ao Claude para incorporar qualquer coisa que uma execução aprendesse, o que causava conflitos de mesclagem frequentes.57Claude edita o arquivo registrado apenas quando direcionou uma execução incorretamente, como um comando que falhou ou uma etapa ausente, para que você possa confirmar o arquivo sem diffs por sessão. Antes da v2.1.205, a skill agrupada dizia ao Claude para incorporar qualquer coisa que uma execução aprendesse, o que causava conflitos de mesclagem frequentes.

58 58 


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

997* O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.997* O plugin [não foi encontrado no marketplace](/docs/pt/plugins/install#install-a-plugin): verifique o nome do plugin.

998 998 

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

1000 1000 

1001* **Casos de teste**: armazena prompts, arquivos de entrada e comportamento esperado em `evals/evals.json` dentro do diretório da skill1001* **Casos de teste**: armazena prompts, arquivos de entrada e comportamento esperado em `evals/evals.json` dentro do diretório da skill

1002* **Execuções isoladas**: gera um [subagent](/docs/pt/sub-agents) por caso de teste para que cada execução comece com um contexto limpo, e registra contagem de tokens e duração1002* **Execuções isoladas**: gera um [subagent](/docs/pt/sub-agents) por caso de teste para que cada execução comece com um contexto limpo, e registra contagem de tokens e duração

slack.md +35 −15

Details

4 4 

5# Claude Code no Slack5# Claude Code no Slack

6 6 

7> Delegue tarefas de codificação diretamente do seu espaço de trabalho Slack. A Anthropic está descontinuando esta versão anterior para espaços de trabalho Team e Enterprise em favor do Claude Tag; ela permanece como o caminho de configuração nos planos Pro e Max.7> Delegue tarefas de codificação a partir do Slack. Esta versão anterior responde a menções em canais apenas de contas Pro e Max em workspaces não conectados ao Claude Tag.

8 8 

9<Warning>9<Warning>

10 Esta página documenta a versão anterior do Claude Code no Slack, que executa cada sessão sob a conta de um usuário individual.10 Esta página documenta a versão anterior do Claude Code no Slack, que executa cada sessão sob a conta de um usuário individual. Ela responde a @menções em canais apenas de contas Pro e Max, e somente em um workspace do Slack que nenhuma organização conectou ao [Claude Tag](https://claude.com/product/tag). O Claude Tag executa @Claude como a identidade compartilhada da sua organização com acesso configurado pelo administrador.

11 11 

12 * **Planos Team e Enterprise:** A Anthropic está descontinuando esta versão em favor do [Claude Tag](https://claude.com/product/tag), que executa @Claude como a identidade compartilhada da sua organização com acesso configurado pelo administrador. Seu aplicativo Slack existente e o identificador @Claude permanecem, e sua equipe de conta Anthropic pode informar a data de transição. [Configure o Claude Tag](https://claude.com/docs/claude-tag/overview) para um novo espaço de trabalho; para mover um que já usa esta versão, consulte [Migrar do Claude anterior no Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).12 * **Planos Pro e Max:** o Claude Tag não está disponível em planos individuais, portanto esta página permanece como o caminho de configuração em um workspace que não está conectado ao Claude Tag.

13 * **Planos Pro e Max:** Claude Tag não está disponível em planos individuais, portanto esta página permanece como o caminho de configuração.13 * **Planos Team e Enterprise:** seu aplicativo Slack existente e o identificador @Claude permanecem. [Configure o Claude Tag](https://claude.com/docs/claude-tag/overview) para um novo workspace; para mover um que já usa esta versão, consulte [Migrar do Claude anterior no Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).

14 * **Aviso em vez de uma resposta:** consulte o [aviso de configuração](#this-workspace-isnt-set-up-for-claude-tag-yet) ou o [aviso de descontinuação](#the-legacy-claude-in-slack-bot-is-retired) com que o @Claude respondeu.

14</Warning>15</Warning>

15 16 

16Claude Code no Slack traz o poder do Claude Code diretamente para seu espaço de trabalho Slack. Quando você menciona `@Claude` com uma tarefa de codificação, Claude detecta automaticamente a intenção e cria uma sessão Claude Code na web, permitindo que você delegue trabalho de desenvolvimento sem sair de suas conversas em equipe.17Claude Code no Slack traz o poder do Claude Code diretamente para seu workspace do Slack. Quando você menciona `@Claude` com uma tarefa de codificação, Claude detecta automaticamente a intenção e cria uma sessão na nuvem do Claude Code, permitindo que você delegue trabalho de desenvolvimento sem sair de suas conversas em equipe.

17 18 

18Esta integração é construída no aplicativo Claude for Slack existente, mas adiciona roteamento inteligente para Claude Code na web para solicitações relacionadas a codificação. Cada sessão é executada sob sua própria conta Claude, usando seus repositórios conectados e seus limites de plano.19Esta integração é construída no aplicativo Claude for Slack existente, mas adiciona roteamento inteligente para sessões na nuvem do Claude Code para solicitações relacionadas a codificação. Cada sessão é executada sob sua própria conta Claude, usando seus repositórios conectados e seus limites de plano.

19 20 

20<h2 id="use-cases">21<h2 id="use-cases">

21 Casos de uso22 Casos de uso


34 35 

35| Requisito | Detalhes |36| Requisito | Detalhes |

36| :- | :- |37| :- | :- |

37| Plano Claude | Pro, Max, Team ou Enterprise com acesso a Claude Code (assentos premium ou assentos Chat + Claude Code) |38| Plano Claude | Pro ou Max |

39| Workspace do Slack | Não conectado ao [Claude Tag](https://claude.com/docs/claude-tag/overview) por nenhuma organização. Se @Claude responder com o [aviso de descontinuação](#the-legacy-claude-in-slack-bot-is-retired), o workspace está conectado |

38| Sessões na nuvem | [Sessões na nuvem](/docs/pt/claude-code-on-the-web) estão habilitadas para sua conta |40| Sessões na nuvem | [Sessões na nuvem](/docs/pt/claude-code-on-the-web) estão habilitadas para sua conta |

39| Conta GitHub | Conectada em [claude.ai/code](https://claude.ai/code) com pelo menos um repositório autenticado |41| Conta GitHub | Conectada em [claude.ai/code](https://claude.ai/code) com pelo menos um repositório autenticado |

40| Autenticação Slack | Sua conta Slack vinculada à sua conta Claude por meio do aplicativo Claude |42| Autenticação Slack | Sua conta Slack vinculada à sua conta Claude por meio do aplicativo Claude |


211 Solução de problemas213 Solução de problemas

212</h2>214</h2>

213 215 

216<h3 id="this-workspace-isnt-set-up-for-claude-tag-yet">

217 "This workspace isn't set up for Claude Tag yet"

218</h3>

219 

220@Claude responde no thread com este aviso em vez de uma resposta quando ambas as condições a seguir são verdadeiras:

221 

222* Nenhuma organização conectou seu workspace do Slack ao [Claude Tag](https://claude.com/docs/claude-tag/overview).

223* A conta Claude que você vinculou no Slack não está em um plano Pro ou Max.

224 

225Claude Tag está disponível nos planos Team e Enterprise. Para conectar o workspace, comece com o comando `@Claude connect` indicado no aviso e, em seguida, siga [Configurar o Claude Tag](https://claude.com/docs/claude-tag/overview).

226 

227<h3 id="the-legacy-claude-in-slack-bot-is-retired">

228 "The legacy Claude in Slack bot is retired"

229</h3>

230 

231O aviso começa com `The legacy Claude in Slack bot is retired effective October 5, 2026 and no longer responds in channels.` Seu workspace do Slack está conectado a uma organização Claude, e a versão anterior ainda está selecionada para o canal, o workspace ou o padrão da organização nas configurações do Claude Tag dessa organização. O aviso não depende do seu próprio plano, portanto contas Pro e Max também o recebem.

232 

233Se você for um Owner dessa organização, abra as [configurações de administrador do Claude](https://claude.ai/admin-settings/claude-tag) e ative o Claude Tag para o canal. Para corrigir todos os canais que herdam a configuração, altere-a no workspace ou no padrão da organização. Para a migração completa, consulte [Migrar do Claude in Slack anterior](https://claude.com/docs/claude-tag/admins/migrate-from-earlier). Se você não for um Owner, envie esta entrada para um.

234 

214<h3 id="claude-code-is-not-enabled-for-your-account">235<h3 id="claude-code-is-not-enabled-for-your-account">

215 "Claude Code não está habilitado para sua conta"236 "Claude Code is not enabled for your account"

216</h3>237</h3>

217 238 

218Este erro significa que sua conta Claude ainda não tem um ambiente em nuvem. Faça login em [claude.ai/code](https://claude.ai/code) uma vez com a mesma conta que você conectou ao Slack e conclua a [integração na web](/docs/pt/web-quickstart#connect-github), que cria seu ambiente em nuvem padrão ou solicita que você o crie. O erro desaparece na sua próxima menção. Cada usuário deve fazer isso individualmente.239Este erro significa que sua conta Claude ainda não tem um ambiente na nuvem. Faça login em [claude.ai/code](https://claude.ai/code) uma vez com a mesma conta que você conectou ao Slack e conclua a [integração na web](/docs/pt/web-quickstart#connect-github), que cria seu ambiente na nuvem padrão ou solicita que você o crie. O erro desaparece na sua próxima menção. Cada usuário deve fazer isso individualmente.

219 240 

220<h3 id="sessions-not-starting">241<h3 id="sessions-not-starting">

221 Sessões não iniciando242 Sessões não iniciando

222</h3>243</h3>

223 244 

2241. Verifique se sua conta Claude está conectada no App Home do Claude2451. Verifique se sua conta Claude está conectada no App Home do Claude

2252. Verifique se as sessões em nuvem estão habilitadas para sua conta2462. Verifique se as sessões na nuvem estão habilitadas para sua conta

2263. Certifique-se de ter pelo menos um repositório GitHub conectado ao Claude Code2473. Certifique-se de ter pelo menos um repositório GitHub conectado ao Claude Code

227 248 

228<h3 id="sessions-from-a-claude-tag-channel-fail-to-start">249<h3 id="sessions-from-a-claude-tag-channel-fail-to-start">

229 Sessões de um canal Claude Tag falham ao iniciar250 Sessões de um canal Claude Tag falham ao iniciar

230</h3>251</h3>

231 252 

232Esta entrada se aplica a espaços de trabalho que usam [Claude Tag](https://claude.com/docs/claude-tag/overview), onde Claude funciona em canais como a identidade compartilhada de sua organização, não como a conta de nenhum membro. Se você criou o ambiente em nuvem do canal em [claude.ai/code](https://claude.ai/code), ele pertence à sua conta pessoal, e Claude não pode iniciar sessões de canal em um ambiente pessoal. Claude Code falha na sessão imediatamente, e tentar novamente não ajuda.253Esta entrada se aplica a workspaces que usam [Claude Tag](https://claude.com/docs/claude-tag/overview), onde Claude funciona em canais como a identidade compartilhada de sua organização, não como a conta de nenhum membro. Se você criou o ambiente na nuvem do canal em [claude.ai/code](https://claude.ai/code), ele pertence à sua conta pessoal, e Claude não pode iniciar sessões de canal em um ambiente pessoal. Claude Code falha na sessão imediatamente, e tentar novamente não ajuda.

233 254 

234Se você for um Proprietário e o ambiente for seu, [compartilhe-o com a organização](/docs/pt/cloud-environments#organization-shared-environments) a partir do seletor de ambiente. Caso contrário, um Proprietário o recria como um ambiente compartilhado da organização a partir da página **Cloud environments** em [configurações de administrador](https://claude.ai/admin-settings).255Se você for um Owner e o ambiente for seu, [compartilhe-o com a organização](/docs/pt/cloud-environments#organization-shared-environments) a partir do seletor de ambiente. Caso contrário, um Owner o recria como um ambiente compartilhado da organização a partir da página **Cloud environments** em [configurações de administrador](https://claude.ai/admin-settings).

235 256 

236Você pode aplicá-lo de duas maneiras:257Você pode aplicá-lo de duas maneiras:

237 258 

238* Defina-o como padrão da organização em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).259* Defina-o como padrão da organização em [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).

239* [Defina-o no canal](https://claude.com/docs/claude-tag/admins/troubleshooting#channel-sessions-use-the-wrong-environment-or-can%E2%80%99t-find-one) nas configurações de administrador do Claude Tag.260* [Defina-o no canal](https://claude.com/docs/claude-tag/admins/troubleshooting#channel-sessions-use-the-wrong-environment-or-can%E2%80%99t-find-one) nas configurações de administrador do Claude Tag.

240 261 

241Se você não for um Proprietário, envie esta entrada para um.262Se você não for um Owner, envie esta entrada para um.

242 263 

243<h3 id="repository-not-showing">264<h3 id="repository-not-showing">

244 Repositório não aparecendo265 Repositório não aparecendo


261 282 

2621. Desconecte e reconecte sua conta Claude no App Home2831. Desconecte e reconecte sua conta Claude no App Home

2632. Certifique-se de estar conectado à conta Claude correta em seu navegador2842. Certifique-se de estar conectado à conta Claude correta em seu navegador

2643. Verifique se seu plano Claude inclui acesso a Claude Code

265 285 

266<h2 id="current-limitations">286<h2 id="current-limitations">

267 Limitações atuais287 Limitações atuais


269 289 

270* **Apenas GitHub**: repositórios devem estar no GitHub.290* **Apenas GitHub**: repositórios devem estar no GitHub.

271* **Um PR por vez**: cada sessão pode criar um pull request.291* **Um PR por vez**: cada sessão pode criar um pull request.

272* **Acesso à sessão na nuvem necessário**: os usuários precisam ter acesso a [sessões na nuvem](/docs/pt/claude-code-on-the-web); sem ele, Claude responde com respostas de chat padrão.292* **Acesso à sessão na nuvem necessário**: os usuários precisam ter acesso a [sessões na nuvem](/docs/pt/claude-code-on-the-web).

273 293 

274<h2 id="related-resources">294<h2 id="related-resources">

275 Recursos relacionados295 Recursos relacionados

statusline.md +1 −1

Details

211| `prompt_cache` | As estatísticas de [cache de prompt](/docs/pt/prompt-caching) da sessão para a conversa principal: taxa de acerto, falhas e se o cache está aquecido. Consulte [campos de cache de prompt](#prompt-cache-fields) para cada campo. Ausente até a primeira resposta de API da conversa principal. Requer Claude Code v2.1.251 ou posterior |211| `prompt_cache` | As estatísticas de [cache de prompt](/docs/pt/prompt-caching) da sessão para a conversa principal: taxa de acerto, falhas e se o cache está aquecido. Consulte [campos de cache de prompt](#prompt-cache-fields) para cada campo. Ausente até a primeira resposta de API da conversa principal. Requer Claude Code v2.1.251 ou posterior |

212| `session_id` | Identificador único de sessão |212| `session_id` | Identificador único de sessão |

213| `session_name` | Nome de sessão. Usa o nome personalizado definido com a flag `--name` ou `/rename` quando um existe, caso contrário, o título de sessão gerado por IA. O [nome de exibição padrão](/docs/pt/sessions#name-your-sessions), como `my-app-3f`, não popula este campo. Ausente quando a sessão não tem um nome personalizado nem um título gerado por IA |213| `session_name` | Nome de sessão. Usa o nome personalizado definido com a flag `--name` ou `/rename` quando um existe, caso contrário, o título de sessão gerado por IA. O [nome de exibição padrão](/docs/pt/sessions#name-your-sessions), como `my-app-3f`, não popula este campo. Ausente quando a sessão não tem um nome personalizado nem um título gerado por IA |

214| `prompt_id` | UUID identificando o prompt do usuário sendo processado no momento. Corresponde ao atributo [`prompt.id` em eventos OpenTelemetry](/docs/pt/monitoring-usage#event-correlation-attributes). Ausente até a primeira entrada do usuário. Requer Claude Code v2.1.196 ou posterior |214| `prompt_id` | UUID identificando o prompt do usuário sendo processado no momento. Corresponde ao atributo [`prompt.id` em eventos OpenTelemetry](/docs/pt/monitoring-usage#event-correlation-attributes). Ausente até a primeira entrada do usuário |

215| `transcript_path` | Caminho para o arquivo de transcrição de conversa |215| `transcript_path` | Caminho para o arquivo de transcrição de conversa |

216| `version` | Versão do Claude Code |216| `version` | Versão do Claude Code |

217| `output_style.name` | Nome do estilo de saída atual |217| `output_style.name` | Nome do estilo de saída atual |

sub-agents.md +205 −205

Details

159 Configurar subagentes159 Configurar subagentes

160</h2>160</h2>

161 161 

162A localização do arquivo de um subagente determina quem tem acesso a ele, e seu frontmatter determina o que ele pode fazer. Esta seção aborda onde os arquivos de subagente residem e cada campo que eles suportam.162O local do arquivo de um subagente determina para quem ele está disponível, e o seu frontmatter determina o que ele pode fazer. Esta seção aborda onde os arquivos de subagentes ficam e todos os campos que eles suportam.

163 163 

164<h3 id="choose-the-subagent-scope">164<h3 id="choose-the-subagent-scope">

165 Escolher o escopo do subagente165 Escolher o escopo do subagente

166</h3>166</h3>

167 167 

168Armazene arquivos de subagente em locais diferentes dependendo do escopo. Quando múltiplos subagentes compartilham o mesmo nome, Claude Code usa o que está no local de prioridade mais alta.168Armazene os arquivos de subagentes em locais diferentes dependendo do escopo. Quando vários subagentes compartilham o mesmo nome, o Claude Code usa aquele do local de maior prioridade.

169 169 

170| Location | Scope | Priority | How to create |170| Local | Escopo | Prioridade | Como criar |

171| :- | :- | :- | :- |171| :- | :- | :- | :- |

172| Managed settings | Organization-wide | 1 (highest) | Deployed via [managed settings](/docs/pt/settings) |172| Configurações gerenciadas | Toda a organização | 1 (mais alta) | Implantado via [configurações gerenciadas](/docs/pt/settings) |

173| `--agents` CLI flag | Current session | 2 | Pass JSON when launching Claude Code |173| Flag de CLI `--agents` | Sessão atual | 2 | Passe JSON ao iniciar o Claude Code |

174| `.claude/agents/` | Current project | 3 | Ask Claude, or create the file manually |174| `.claude/agents/` | Projeto atual | 3 | Peça ao Claude ou crie o arquivo manualmente |

175| `~/.claude/agents/` | All your projects | 4 | Ask Claude, or create the file manually |175| `~/.claude/agents/` | Todos os seus projetos | 4 | Peça ao Claude ou crie o arquivo manualmente |

176| Plugin's `agents/` directory | Where plugin is enabled | 5 (lowest) | Installed with [plugins](/docs/pt/plugins/overview) |176| Diretório `agents/` do plugin | Onde o plugin está habilitado | 5 (mais baixa) | Instalado com [plugins](/docs/pt/plugins/overview) |

177 177 

178**Subagentes de projeto** (`.claude/agents/`) são ideais para subagentes específicos de uma base de código. Verifique-os no controle de versão para que sua equipe possa usá-los e melhorá-los colaborativamente.178**Subagentes de projeto** (`.claude/agents/`) são ideais para subagentes específicos de uma base de código. Faça commit deles no controle de versão para que sua equipe possa usá-los e aprimorá-los de forma colaborativa.

179 179 

180Subagentes de projeto são descobertos caminhando para cima a partir do diretório de trabalho atual, portanto cada `.claude/agents/` entre lá e a raiz do repositório é verificado. Quando mais de um desses diretórios aninhados define o mesmo `name`, Claude Code usa a definição mais próxima do diretório de trabalho.180Os subagentes de projeto são descobertos subindo a partir do diretório de trabalho atual, de modo que cada `.claude/agents/` entre ele e a raiz do repositório é verificado. Quando mais de um desses diretórios aninhados define o mesmo `name`, o Claude Code usa a definição mais próxima do diretório de trabalho.

181 181 

182Quando você adiciona um diretório com `--add-dir` ou `/add-dir`, Claude Code também carrega sua pasta `.claude/agents/`, junto com seus subagentes de projeto. Veja [Diretórios adicionais](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) para quais outros tipos de configuração carregam de `--add-dir`. Para compartilhar subagentes entre projetos sem `--add-dir`, use `~/.claude/agents/` ou um [plugin](/docs/pt/plugins/overview).182Quando você adiciona um diretório com `--add-dir` ou `/add-dir`, o Claude Code também carrega a pasta `.claude/agents/` dele, junto com os seus subagentes de projeto. Consulte [Diretórios adicionais](/docs/pt/permissions#additional-directories-grant-file-access-not-configuration) para saber quais outros tipos de configuração são carregados a partir de `--add-dir`. Para compartilhar subagentes entre projetos sem `--add-dir`, use `~/.claude/agents/` ou um [plugin](/docs/pt/plugins/overview).

183 183 

184**Subagentes de usuário** (`~/.claude/agents/`) são subagentes pessoais disponíveis em todos os seus projetos.184**Subagentes de usuário** (`~/.claude/agents/`) são subagentes pessoais disponíveis em todos os seus projetos.

185 185 

186Claude Code verifica `.claude/agents/` e `~/.claude/agents/` recursivamente, para que você possa organizar definições em subpastas como `agents/review/` ou `agents/research/`. O caminho do subdiretório não afeta como um subagente é identificado ou invocado, porque a identidade vem apenas do campo `name` do frontmatter.186O Claude Code verifica `.claude/agents/` e `~/.claude/agents/` recursivamente, então você pode organizar as definições em subpastas como `agents/review/` ou `agents/research/`. O caminho do subdiretório não afeta como um subagente é identificado ou invocado, porque a identidade vem apenas do campo `name` do frontmatter.

187 187 

188Mantenha valores de `name` únicos em toda a árvore: se dois arquivos sob o mesmo diretório `.claude/agents/`, incluindo suas subpastas, declaram o mesmo nome, Claude Code carrega apenas um deles, escolhido pela ordem de leitura do sistema de arquivos em vez de uma precedência documentada. Entre diretórios de projeto aninhados, a definição mais próxima do diretório de trabalho vence, conforme descrito acima. O verificador de configuração [`/doctor`](/docs/pt/commands#all-commands) relata arquivos no mesmo diretório que compartilham um nome e propõe renomear ou remover todos exceto um. Antes da v2.1.205, `/doctor` abria uma tela de diagnósticos que listava duplicatas e mostrava qual definição estava ativa.188Mantenha os valores de `name` únicos em toda a árvore: se dois arquivos sob o mesmo diretório `.claude/agents/`, incluindo suas subpastas, declararem o mesmo nome, o Claude Code carrega apenas um deles, escolhido pela ordem de leitura do sistema de arquivos, e não por uma precedência documentada. Entre diretórios de projeto aninhados, a definição mais próxima do diretório de trabalho prevalece, conforme descrito acima. A verificação de configuração [`/doctor`](/docs/pt/commands#all-commands) informa arquivos no mesmo diretório que compartilham um nome e propõe renomear ou remover todos, exceto um. Antes da v2.1.205, o `/doctor` abria uma tela de diagnóstico que listava duplicatas e mostrava qual definição estava ativa.

189 189 

190Diretórios `agents/` de plugin também são verificados recursivamente. Diferentemente dos escopos de projeto e usuário, uma subpasta dentro do diretório `agents/` de um plugin se torna parte do [identificador com escopo](#invoke-subagents-explicitly): um arquivo em `agents/review/security.md` no plugin `my-plugin` se registra como `my-plugin:review:security`.190Os diretórios `agents/` de plugins também são verificados recursivamente. Diferentemente dos escopos de projeto e de usuário, uma subpasta dentro do diretório `agents/` de um plugin passa a fazer parte do [identificador com escopo](#invoke-subagents-explicitly): um arquivo em `agents/review/security.md` no plugin `my-plugin` é registrado como `my-plugin:review:security`.

191 191 

192**Subagentes definidos por CLI** são passados como JSON ao iniciar Claude Code. Eles existem apenas para essa sessão e não são salvos em disco, tornando-os úteis para testes rápidos ou scripts de automação. Você pode definir múltiplos subagentes em uma única chamada `--agents`:192**Subagentes definidos via CLI** são passados como JSON ao iniciar o Claude Code. Eles existem apenas naquela sessão e não são salvos em disco, o que os torna úteis para testes rápidos ou scripts de automação. Você pode definir vários subagentes em uma única chamada `--agents`:

193 193 

194<Tabs>194<Tabs>

195 <Tab title="macOS, Linux, WSL">195 <Tab title="macOS, Linux, WSL">


229 </Tab>229 </Tab>

230</Tabs>230</Tabs>

231 231 

232Em [modo não interativo](/docs/pt/headless), `--agents` também aceita o caminho para um arquivo JSON contendo o mesmo objeto, para definições muito grandes para passar na linha de comando. Por exemplo, `claude -p --agents ./agents.json "Review my changes"` lê as definições daquele arquivo. Em uma sessão interativa, Claude Code recusa um caminho de arquivo. O formulário de arquivo requer Claude Code v2.1.281 ou posterior.232No [modo não interativo](/docs/pt/headless), `--agents` também aceita o caminho para um arquivo JSON contendo o mesmo objeto, para definições grandes demais para passar na linha de comando. Por exemplo, `claude -p --agents ./agents.json "Review my changes"` lê as definições desse arquivo. Em uma sessão interativa, o Claude Code recusa um caminho de arquivo. O formato de arquivo requer o Claude Code v2.1.281 ou posterior.

233 233 

234Cada chave de nível superior no JSON é o nome de um agente, e seu valor é a definição daquele agente. Não comece um nome com `-`. Uma definição leva estes campos:234Cada chave de nível superior no JSON é o nome de um agente, e seu valor é a definição desse agente. Não comece um nome com `-`. Uma definição aceita estes campos:

235 235 

236* **`prompt`**: o prompt de sistema do agente, equivalente ao corpo markdown em subagentes baseados em arquivo. `prompt` pode estar vazio. Se você selecionar um agente com um `prompt` vazio e nenhum campo `memory` como o agente da sessão com `--agent`, o prompt de sistema da sessão é deixado inalterado. Um `prompt` vazio requer Claude Code v2.1.281 ou posterior.236* **`prompt`**: o system prompt do agente, equivalente ao corpo em markdown nos subagentes baseados em arquivo. `prompt` pode estar vazio. Se você selecionar um agente com `prompt` vazio e sem campo `memory` como o agente da sessão com `--agent`, o system prompt da sessão permanece inalterado. Um `prompt` vazio requer o Claude Code v2.1.281 ou posterior.

237* **[Campos de frontmatter](#supported-frontmatter-fields)**: `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` e `isolation`.237* **[Campos do frontmatter](#supported-frontmatter-fields)**: `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `mcpServers`, `hooks`, `maxTurns`, `skills`, `initialPrompt`, `memory`, `effort`, `background`, `omitClaudeMd` e `isolation`.

238* **Campos ignorados**: `color` e `experimental` não são aceitos aqui e são ignorados em vez de rejeitados.238* **Campos ignorados**: `color` e `experimental` não são aceitos aqui e são ignorados em vez de rejeitados.

239 239 

240Para o que Claude Code faz com um valor que não consegue carregar, e os flags e variável de ambiente que pulam essa verificação, veja [`Invalid --agents configuration`](/docs/pt/errors#invalid-agents-configuration).240Para saber o que o Claude Code faz com um valor que não consegue carregar, e as flags e a variável de ambiente que ignoram essa verificação, consulte [`Invalid --agents configuration`](/docs/pt/errors#invalid-agents-configuration).

241 241 

242**Subagentes gerenciados** são implantados por administradores da organização. Coloque arquivos markdown em `.claude/agents/` dentro do [diretório de configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms), usando o mesmo formato de frontmatter que subagentes de projeto e usuário. Definições gerenciadas têm precedência sobre subagentes de projeto e usuário com o mesmo nome.242**Subagentes gerenciados** são implantados por administradores da organização. Coloque arquivos markdown em `.claude/agents/` dentro do [diretório de configurações gerenciadas](/docs/pt/managed-settings#delivery-mechanisms), usando o mesmo formato de frontmatter dos subagentes de projeto e de usuário. As definições gerenciadas têm precedência sobre subagentes de projeto e de usuário com o mesmo nome.

243 243 

244**Subagentes de plugin** vêm de [plugins](/docs/pt/plugins/overview) que você instalou. Eles carregam automaticamente junto com seus subagentes personalizados e aparecem na digitação de @-menção sob seu nome com escopo. Veja a [referência de componentes de plugin](/docs/pt/plugins/components#agents) para detalhes sobre como criar subagentes de plugin.244**Subagentes de plugin** vêm de [plugins](/docs/pt/plugins/overview) que você instalou. Eles são carregados automaticamente junto com seus subagentes personalizados e aparecem no preenchimento automático de @-menção sob seu nome com escopo. Consulte a [referência de componentes de plugin](/docs/pt/plugins/components#agents) para detalhes sobre como criar subagentes de plugin.

245 245 

246<Note>246<Note>

247 Por razões de segurança, subagentes de plugin não suportam os campos de frontmatter `hooks`, `mcpServers` ou `permissionMode`. Estes campos são ignorados ao carregar agentes de um plugin. Se você precisar deles, copie o arquivo do agente para `.claude/agents/` ou `~/.claude/agents/`. Você também pode adicionar regras a [`permissions.allow`](/docs/pt/settings-reference#permissions-allow) em `settings.json` ou `settings.local.json`, mas estas regras se aplicam a toda a sessão, não apenas ao subagente do plugin.247 Por motivos de segurança, subagentes de plugin não suportam os campos de frontmatter `hooks`, `mcpServers` ou `permissionMode`. Esses campos são ignorados ao carregar agentes de um plugin. Se você precisar deles, copie o arquivo do agente para `.claude/agents/` ou `~/.claude/agents/`. Você também pode adicionar regras a [`permissions.allow`](/docs/pt/settings-reference#permissions-allow) em `settings.json` ou `settings.local.json`, mas essas regras se aplicam à sessão inteira, não apenas ao subagente do plugin.

248 248 

249 Se você é o autor do plugin, inclua os hooks no [`hooks/hooks.json`](/docs/pt/plugins/components#hooks) do plugin e os servidores MCP no seu [`.mcp.json`](/docs/pt/plugins/components#mcp-servers) em vez disso. Eles se aplicam sempre que o plugin está habilitado, e não apenas dentro do subagente.249 Se você é o autor do plugin, distribua os hooks no [`hooks/hooks.json`](/docs/pt/plugins/components#hooks) do plugin e os servidores MCP no seu [`.mcp.json`](/docs/pt/plugins/components#mcp-servers). Eles se aplicam sempre que o plugin está habilitado, e não apenas dentro do subagente.

250</Note>250</Note>

251 251 

252Você também pode reutilizar uma definição de subagente como um colega de trabalho de uma [equipe de agentes](/docs/pt/agent-teams): nomeie o tipo de subagente quando pedir a Claude para gerar o colega de trabalho, e Claude Code aplica partes dessa definição a ele. [Usar definições de subagente para colegas de trabalho](/docs/pt/agent-teams#use-subagent-definitions-for-teammates) indica quais escopos e quais partes se aplicam em cada modo de exibição.252Você também pode reutilizar uma definição de subagente como colega de uma [equipe de agentes](/docs/pt/agent-teams): nomeie o tipo de subagente quando pedir ao Claude para criar o colega, e o Claude Code aplica partes dessa definição a ele. [Usar definições de subagentes para colegas](/docs/pt/agent-teams#use-subagent-definitions-for-teammates) informa quais escopos e quais partes se aplicam em cada modo de exibição.

253 253 

254<h3 id="write-subagent-files">254<h3 id="write-subagent-files">

255 Escrever arquivos de subagente255 Escrever arquivos de subagentes

256</h3>256</h3>

257 257 

258Arquivos de subagente usam frontmatter YAML para configuração, seguido pelo prompt de sistema em Markdown:258Os arquivos de subagentes usam frontmatter YAML para configuração, seguido pelo system prompt em Markdown:

259 259 

260<Note>260<Note>

261 Claude Code observa `~/.claude/agents/` e `.claude/agents/`. Quando você adiciona ou edita um arquivo de subagente no disco, ou pede a Claude para escrever um para você, Claude Code detecta a alteração em alguns segundos e a próxima delegação usa a definição atualizada, sem necessidade de reinicialização.261 O Claude Code monitora `~/.claude/agents/` e `.claude/agents/`. Quando você adiciona ou edita um arquivo de subagente em disco, ou pede ao Claude para escrever um para você, o Claude Code detecta a alteração em poucos segundos e a próxima delegação usa a definição atualizada, sem necessidade de reiniciar.

262 262 

263 Três casos ainda precisam de uma reinicialização:263 Três casos ainda exigem reinicialização:

264 264 

265 * O observador cobre apenas diretórios que existiam quando a sessão começou, portanto após criar o primeiro arquivo de agente de um escopo em um novo diretório `agents`, reinicie para carregá-lo.265 * O monitoramento cobre apenas diretórios que existiam quando a sessão começou, portanto, após criar o primeiro arquivo de agente de um escopo em um novo diretório `agents`, reinicie para carregá-lo.

266 * Claude Code não observa `.claude/agents/` dentro de diretórios adicionados com `--add-dir` ou `/add-dir`, portanto após adicionar ou editar um subagente lá, reinicie para carregar a alteração.266 * O Claude Code não monitora `.claude/agents/` dentro de diretórios adicionados com `--add-dir` ou `/add-dir`, portanto, após adicionar ou editar um subagente ali, reinicie para carregar a alteração.

267 * Sessões iniciadas com `--disable-slash-commands` não observam esses diretórios.267 * Sessões iniciadas com `--disable-slash-commands` não monitoram esses diretórios de forma alguma.

268</Note>268</Note>

269 269 

270```markdown .claude/agents/code-reviewer.md theme={null}270```markdown .claude/agents/code-reviewer.md theme={null}


279specific, actionable feedback on quality, security, and best practices.279specific, actionable feedback on quality, security, and best practices.

280```280```

281 281 

282O frontmatter define os metadados e configuração do subagente. O corpo se torna o prompt de sistema que guia o comportamento do subagente. Subagentes recebem apenas este prompt de sistema mais detalhes básicos de ambiente como diretório de trabalho, não o prompt de sistema do Claude Code.282O frontmatter define os metadados e a configuração do subagente. O corpo se torna o system prompt que orienta o comportamento do subagente. Os subagentes recebem apenas esse system prompt mais detalhes básicos do ambiente, como o diretório de trabalho, e não o system prompt do Claude Code.

283 283 

284Em [modo não interativo](/docs/pt/headless), passe [`--append-subagent-system-prompt`](/docs/pt/cli-reference#cli-flags) para anexar seu texto ao final do prompt de sistema de cada subagente, incluindo subagentes aninhados, exceto um [subagente bifurcado](#fork-the-current-conversation), que reutiliza o prompt da conversa. Requer Claude Code v2.1.205 ou posterior. Se seu texto for muito longo para passar na linha de comando, salve-o em um arquivo e passe o caminho com `--append-subagent-system-prompt-file` em vez disso. O flag de arquivo requer Claude Code v2.1.261 ou posterior.284No [modo não interativo](/docs/pt/headless), passe [`--append-subagent-system-prompt`](/docs/pt/cli-reference#cli-flags) para acrescentar seu texto ao final do system prompt de cada subagente, incluindo subagentes aninhados, exceto um [subagente bifurcado](#fork-the-current-conversation), que reutiliza o próprio prompt da conversa. Requer o Claude Code v2.1.205 ou posterior. Se o seu texto for longo demais para passar na linha de comando, salve-o em um arquivo e passe o caminho com `--append-subagent-system-prompt-file`. A flag de arquivo requer o Claude Code v2.1.261 ou posterior.

285 285 

286Um subagente começa no diretório de trabalho atual da conversa principal. Dentro de um subagente, comandos `cd` não persistem entre chamadas de ferramentas Bash ou PowerShell e não afetam o diretório de trabalho da conversa principal. Para dar ao subagente uma cópia isolada do repositório em vez disso, defina [`isolation: worktree`](#supported-frontmatter-fields).286Um subagente começa no diretório de trabalho atual da conversa principal. Dentro de um subagente, comandos `cd` não persistem entre chamadas das ferramentas Bash ou PowerShell e não afetam o diretório de trabalho da conversa principal. Para dar ao subagente uma cópia isolada do repositório, defina [`isolation: worktree`](#supported-frontmatter-fields).

287 287 

288Um subagente com `isolation: worktree` executa seus comandos Bash e PowerShell dentro de seu worktree. Um comando cujo diretório de trabalho se resolve para seu checkout principal, por exemplo porque o diretório worktree foi removido enquanto o subagente estava em execução, falha com um erro. Antes da v2.1.203, tal comando poderia ser executado no checkout principal.288Um subagente com `isolation: worktree` executa seus comandos Bash e PowerShell dentro do seu worktree. Um comando cujo diretório de trabalho resolve para o seu checkout principal, por exemplo porque o diretório do worktree foi removido enquanto o subagente estava em execução, falha com um erro. Antes da v2.1.203, tal comando podia ser executado no checkout principal.

289 289 

290Esta verificação de diretório de trabalho cobre todo o repositório contendo o diretório a partir do qual você iniciou Claude Code. Quando sua sessão é executada em um [worktree](/docs/pt/worktrees) vinculado de sua própria, a verificação também cobre o checkout principal do qual esse worktree está vinculado. Antes da v2.1.210, a verificação cobria apenas o diretório de inicialização em si. Um comando cujo diretório de trabalho se resolveu em outro lugar no mesmo repositório, como a raiz do repositório quando você iniciou Claude Code a partir de um subdiretório de monorepo, era executado lá em vez de falhar.290Essa verificação de diretório de trabalho abrange todo o repositório que contém o diretório a partir do qual você iniciou o Claude Code. Quando sua sessão é executada em um [worktree](/docs/pt/worktrees) vinculado próprio, a verificação também abrange o checkout principal ao qual esse worktree está vinculado. Antes da v2.1.210, a verificação abrangia apenas o próprio diretório de inicialização. Um comando cujo diretório de trabalho resolvia para outro lugar no mesmo repositório, como a raiz do repositório quando você iniciava o Claude Code a partir de um subdiretório de um monorepo, era executado ali em vez de falhar.

291 291 

292Para comandos Bash, Claude Code também verifica o comando em si de duas maneiras:292Para comandos Bash, o Claude Code também verifica o próprio comando de duas maneiras:

293 293 

294* Ele bloqueia um comando que redireciona git para o checkout principal.294* Ele bloqueia um comando que redireciona o git para o checkout principal.

295* Ele recusa um comando quando não consegue verificar a partir do texto do comando que qualquer git que o comando executa permanece dentro do worktree, por exemplo quando o nome do comando é calculado em tempo de execução.295* Ele recusa um comando quando não consegue verificar, a partir do texto do comando, que qualquer git executado pelo comando permanece dentro do worktree, por exemplo quando o nome do comando é calculado em tempo de execução.

296 296 

297Os vetores de redirecionamento e as regras de forma estão listados em [Como Claude Code impõe isolamento](/docs/pt/worktrees#how-claude-code-enforces-isolation). Comandos PowerShell recebem apenas a verificação de diretório de trabalho.297Os vetores de redirecionamento e as regras de formato estão listados em [Como o Claude Code aplica o isolamento](/docs/pt/worktrees#how-claude-code-enforces-isolation). Comandos PowerShell recebem apenas a verificação de diretório de trabalho.

298 298 

299Comandos [Monitor](/docs/pt/tools-reference#monitor-tool) passam pelas mesmas verificações de diretório de trabalho e conteúdo de comando que comandos Bash.299Comandos do [Monitor](/docs/pt/tools-reference#monitor-tool) passam pelas mesmas verificações de diretório de trabalho e de conteúdo do comando que os comandos Bash.

300 300 

301Quando a conversa principal em si é executada isolada em um worktree, Claude Code aplica as mesmas verificações à sessão e a cada subagente que ela gera, incluindo subagentes sem `isolation: worktree`; veja [Como Claude Code impõe isolamento](/docs/pt/worktrees#how-claude-code-enforces-isolation).301Quando a própria conversa principal é executada isolada em um worktree, o Claude Code aplica as mesmas verificações à sessão e a cada subagente que ela cria, incluindo subagentes sem `isolation: worktree`; consulte [Como o Claude Code aplica o isolamento](/docs/pt/worktrees#how-claude-code-enforces-isolation).

302 302 

303<h3 id="supported-frontmatter-fields">303<h3 id="supported-frontmatter-fields">

304 Referência de frontmatter304 Referência do frontmatter

305</h3>305</h3>

306 306 

307Configure um subagente com [frontmatter](/docs/pt/glossary#frontmatter) YAML entre marcadores `---` no topo de seu arquivo, e escreva seu prompt de sistema como Markdown após o `---` de fechamento. Apenas `name` e `description` são obrigatórios.307Configure um subagente com [frontmatter](/docs/pt/glossary#frontmatter) YAML entre marcadores `---` no topo do arquivo e escreva seu system prompt em Markdown após o `---` de fechamento. Apenas `name` e `description` são obrigatórios.

308 308 

309Nomes de campo com múltiplas palavras usam camelCase, como `maxTurns` e `disallowedTools`, e devem corresponder à tabela exatamente: Claude Code ignora um campo que não reconhece sem relatar um erro. Para descobrir por que um arquivo de subagente não carregou, veja [Arquivos de subagente que Claude Code pula](#subagent-files-claude-code-skips).309Nomes de campos com várias palavras usam camelCase, como `maxTurns` e `disallowedTools`, e devem corresponder exatamente à tabela: o Claude Code ignora um campo que não reconhece sem relatar um erro. Para descobrir por que um arquivo de subagente não foi carregado, consulte [Arquivos de subagentes que o Claude Code ignora](#subagent-files-claude-code-skips).

310 310 

311| Field | Required | Description |311| Campo | Obrigatório | Descrição |

312| :- | :- | :- |312| :- | :- | :- |

313| `name` | Yes | Identificador único, como `code-reviewer` ou `reviewer-v2`. [Hooks](/docs/pt/hooks#subagentstart) recebem este valor como `agent_type`. O nome do arquivo não precisa corresponder. Nomes não podem conter `:`, que é reservado para [identificadores com escopo de plugin](/docs/pt/plugins/overview) como `my-plugin:reviewer`. Claude Code não carrega um arquivo cujo nome contém um e registra um erro no log de debug. Antes da v2.1.218, tais nomes eram aceitos |313| `name` | Sim | Identificador único, como `code-reviewer` ou `reviewer-v2`. Os [hooks](/docs/pt/hooks#subagentstart) recebem esse valor como `agent_type`. O nome do arquivo não precisa corresponder. Os nomes não podem conter `:`, que é reservado para [identificadores com escopo de plugin](/docs/pt/plugins/overview) como `my-plugin:reviewer`. O Claude Code não carrega um arquivo cujo nome contenha esse caractere e registra um erro no log de depuração. Antes da v2.1.218, esses nomes eram aceitos |

314| `description` | Yes | Quando Claude deve delegar para este subagente |314| `description` | Sim | Quando o Claude deve delegar a este subagente |

315| `tools` | No | [Ferramentas](#available-tools) que o subagente pode usar, como uma string separada por vírgulas como `Read, Grep, Bash` ou uma lista YAML. Herda todas as ferramentas disponíveis para subagentes se omitido. Se nenhuma entrada na lista se resolver para uma ferramenta, o subagente geralmente [falha ao iniciar](/docs/pt/errors#agent-would-be-spawned-with-zero-tools) com um erro nomeando as entradas. Para pré-carregar Skills no contexto, use o campo `skills` em vez de listar `Skill` aqui |315| `tools` | Não | [Ferramentas](#available-tools) que o subagente pode usar, como uma string separada por vírgulas, como `Read, Grep, Bash`, ou uma lista YAML. Herda todas as ferramentas disponíveis para subagentes se omitido. Se nenhuma entrada da lista resolver para uma ferramenta, o subagente geralmente [falha ao iniciar](/docs/pt/errors#agent-would-be-spawned-with-zero-tools) com um erro que nomeia as entradas. Para pré-carregar Skills no contexto, use o campo `skills` em vez de listar `Skill` aqui |

316| `disallowedTools` | No | Ferramentas a negar, removidas da lista herdada ou especificada. Mesmo formato que `tools`. Uma entrada com um especificador, como `Bash(git push *)`, ainda [remove a ferramenta inteira](#available-tools) |316| `disallowedTools` | Não | Ferramentas a negar, removidas da lista herdada ou especificada. Mesmo formato de `tools`. Uma entrada com especificador, como `Bash(git push *)`, ainda [remove a ferramenta inteira](#available-tools) |

317| `model` | No | [Modelo](#choose-a-model) a usar: `sonnet`, `opus`, `haiku`, `fable`, um ID de modelo completo como `claude-opus-5-5`, ou `inherit`. Quando você omite, Claude Code escolhe o modelo na [ordem de modelo de subagente](#choose-a-model) |317| `model` | Não | [Modelo](#choose-a-model) a usar: `sonnet`, `opus`, `haiku`, `fable`, um ID de modelo completo como `claude-opus-5-5`, ou `inherit`. Quando você o omite, o Claude Code escolhe o modelo na [ordem de modelos de subagentes](#choose-a-model) |

318| `permissionMode` | No | [Modo de permissão](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, ou `manual` como um alias para `default`. O alias `manual` requer Claude Code v2.1.200 ou posterior. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |318| `permissionMode` | Não | [Modo de permissão](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, ou `manual` como alias para `default`. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |

319| `maxTurns` | No | Número máximo de turnos de agente antes do subagente parar. Quando o subagente atinge o limite, Claude Code retorna sua saída marcada como parcial, e Claude pode [retomá-lo](#resume-subagents) para continuar. A marcação parcial requer Claude Code v2.1.246 ou posterior |319| `maxTurns` | Não | Número máximo de turnos agênticos antes de o subagente parar. Quando o subagente atinge o limite, o Claude Code retorna sua saída marcada como parcial, e o Claude pode [retomá-lo](#resume-subagents) para continuar. A marcação parcial requer o Claude Code v2.1.246 ou posterior |

320| `skills` | No | [Skills](/docs/pt/skills) a pré-carregar no contexto do subagente na inicialização. O conteúdo completo da skill é injetado, não apenas a descrição. Subagentes ainda podem invocar skills de projeto, usuário e plugin não listadas através da ferramenta Skill |320| `skills` | Não | [Skills](/docs/pt/skills) a pré-carregar no contexto do subagente na inicialização. O conteúdo completo da skill é injetado, não apenas a descrição. Os subagentes ainda podem invocar skills de projeto, de usuário e de plugin não listadas por meio da ferramenta Skill |

321| `mcpServers` | No | [MCP servers](/docs/pt/mcp) disponíveis para este subagente. Cada entrada é um nome de servidor referenciando um servidor já configurado (por exemplo, `"slack"`) ou uma definição inline com o nome do servidor como chave e uma [configuração completa de MCP server](/docs/pt/mcp#installing-mcp-servers) como valor. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |321| `mcpServers` | Não | [Servidores MCP](/docs/pt/mcp) disponíveis para este subagente. Cada entrada é um nome de servidor que referencia um servidor já configurado (por exemplo, `"slack"`) ou uma definição inline com o nome do servidor como chave e uma [configuração completa de servidor MCP](/docs/pt/mcp#installing-mcp-servers) como valor. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |

322| `hooks` | No | [Lifecycle hooks](#define-hooks-for-subagents) com escopo para este subagente. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |322| `hooks` | Não | [Hooks de ciclo de vida](#define-hooks-for-subagents) restritos a este subagente. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |

323| `memory` | No | [Escopo de memória persistente](#enable-persistent-memory): `user`, `project`, ou `local`. Habilita aprendizado entre sessões |323| `memory` | Não | [Escopo de memória persistente](#enable-persistent-memory): `user`, `project` ou `local`. Permite aprendizado entre sessões |

324| `background` | No | Defina como `true` para manter este subagente em background mesmo quando Claude pede para executá-lo em foreground. Onde [fork mode](#turn-fork-mode-on-or-off) está ativado, Claude Code já executa os subagentes que Claude gera [em background](#run-subagents-in-foreground-or-background) |324| `background` | Não | Defina como `true` para manter este subagente em segundo plano mesmo quando o Claude pedir para executá-lo em primeiro plano. Onde o [modo fork](#turn-fork-mode-on-or-off) está ativado, o Claude Code já executa os subagentes que o Claude cria [em segundo plano](#run-subagents-in-foreground-or-background) |

325| `omitClaudeMd` | No | Defina como `true` para iniciar este subagente sem os arquivos CLAUDE.md de usuário, projeto e local; [arquivos de política gerenciada](/docs/pt/memory#how-claude-md-files-load) ainda carregam, exceto para [subagentes gerenciados](#choose-the-subagent-scope). Use-o para subagentes que pegam tudo que precisam do [prompt de delegação](#what-loads-at-startup). Ignorado quando o agente é executado como o agente da sessão principal via `--agent` ou a configuração `agent`. Requer Claude Code v2.1.271 ou posterior |325| `omitClaudeMd` | Não | Defina como `true` para iniciar este subagente sem os arquivos CLAUDE.md de usuário, de projeto e locais; os [arquivos de política gerenciada](/docs/pt/memory#how-claude-md-files-load) ainda são carregados, exceto para [subagentes gerenciados](#choose-the-subagent-scope). Use-o para subagentes que obtêm tudo de que precisam do [prompt de delegação](#what-loads-at-startup). Ignorado quando o agente é executado como agente da sessão principal via `--agent` ou a configuração `agent`. Requer o Claude Code v2.1.271 ou posterior |

326| `effort` | No | Nível de esforço quando este subagente está ativo. Sobrescreve o nível de esforço da sessão. Padrão: herda da sessão. Opções: `low`, `medium`, `high`, `xhigh`, `max`; os níveis disponíveis dependem do modelo |326| `effort` | Não | Nível de esforço quando este subagente está ativo. Sobrescreve o nível de esforço da sessão. Padrão: herda da sessão. Opções: `low`, `medium`, `high`, `xhigh`, `max`; os níveis disponíveis dependem do modelo |

327| `isolation` | No | Defina como `worktree` para executar o subagente em um [git worktree](/docs/pt/worktrees) temporário, dando-lhe uma cópia isolada do repositório ramificada por padrão a partir de sua [branch padrão](/docs/pt/worktrees#choose-the-base-branch) em vez do `HEAD` da sessão pai. O worktree é automaticamente limpo se o subagente não fizer alterações |327| `isolation` | Não | Defina como `worktree` para executar o subagente em um [git worktree](/docs/pt/worktrees) temporário, dando a ele uma cópia isolada do repositório criada por padrão a partir do seu [branch padrão](/docs/pt/worktrees#choose-the-base-branch), e não do `HEAD` da sessão pai. O worktree é limpo automaticamente se o subagente não fizer alterações |

328| `color` | No | Cor de exibição para o subagente na lista de tarefas e transcrição. Aceita `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, ou `cyan` |328| `color` | Não | Cor de exibição do subagente na lista de tarefas e na transcrição. Aceita `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink` ou `cyan` |

329| `initialPrompt` | No | Auto-enviado como o primeiro turno do usuário quando este agente é executado como o agente da sessão principal (via `--agent` ou a configuração `agent`). [Comandos](/docs/pt/commands) e [skills](/docs/pt/skills) são processados. Preposto a qualquer prompt fornecido pelo usuário. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |329| `initialPrompt` | Não | Enviado automaticamente como o primeiro turno do usuário quando este agente é executado como agente da sessão principal (via `--agent` ou a configuração `agent`). [Comandos](/docs/pt/commands) e [skills](/docs/pt/skills) são processados. Adicionado antes de qualquer prompt fornecido pelo usuário. Ignorado para [subagentes de plugin](#choose-the-subagent-scope) |

330| `experimental` | No | Mapa de opções experimentais. Defina sua chave `cacheTtl` como `5m` ou `1h` para escolher o [tempo de vida do cache de prompt](/docs/pt/prompt-caching#choose-the-ttl-yourself) para as solicitações deste subagente, no lugar da [precedência de tempo de vida do cache](/docs/pt/prompt-caching#choose-the-ttl-yourself). Claude Code ignora qualquer outro valor, ignora `1h` enquanto sua assinatura Claude está usando créditos de uso, e lê o campo apenas de arquivos de subagente. Requer Claude Code v2.1.248 ou posterior |330| `experimental` | Não | Mapa de opções experimentais. Defina sua chave `cacheTtl` como `5m` ou `1h` para escolher o [tempo de vida do cache de prompt](/docs/pt/prompt-caching#choose-the-ttl-yourself) para as requisições deste subagente, na posição do frontmatter na [precedência do tempo de vida do cache](/docs/pt/prompt-caching#choose-the-ttl-yourself). O Claude Code ignora qualquer outro valor, ignora `1h` enquanto sua assinatura do Claude estiver usando créditos de uso e lê o campo apenas de arquivos de subagentes. Requer o Claude Code v2.1.248 ou posterior |

331 331 

332Escreva `cacheTtl` dentro do mapa `experimental`, não no nível superior do frontmatter.332Escreva `cacheTtl` dentro do mapa `experimental`, não no nível superior do frontmatter.

333 333 


341```341```

342 342 

343<h4 id="subagent-files-claude-code-skips">343<h4 id="subagent-files-claude-code-skips">

344 Arquivos de subagente que Claude Code pula344 Arquivos de subagentes que o Claude Code ignora

345</h4>345</h4>

346 346 

347Claude Code pula um arquivo em um diretório `agents` de projeto, usuário ou gerenciado, ou em um sob um diretório que você adiciona com `--add-dir`, sem relatá-lo na sessão, quando o frontmatter tem qualquer um desses problemas:347O Claude Code ignora um arquivo em um diretório `agents` de projeto, de usuário ou gerenciado, ou em um sob um diretório que você adiciona com `--add-dir`, sem relatá-lo na sessão, quando o frontmatter tem algum destes problemas:

348 348 

349* **Sem `name`**: Claude Code trata o arquivo como documentação mantida ao lado de seus agentes.349* **Sem `name`**: o Claude Code trata o arquivo como documentação mantida ao lado dos seus agentes.

350* **Um `---` de abertura que não é a primeira linha do arquivo**: Claude Code lê o arquivo como não tendo frontmatter e o trata como documentação.350* **Um `---` de abertura que não está na primeira linha do arquivo**: o Claude Code lê o arquivo como se não tivesse frontmatter e o trata como documentação.

351* **Um `name` que começa com `-` ou contém `:`**: Claude Code pula o arquivo e escreve um erro no log de debug. Veja a linha `name` na tabela acima.351* **Um `name` que começa com `-` ou contém `:`**: o Claude Code ignora o arquivo e grava um erro no log de depuração. Consulte a linha `name` na tabela acima.

352* **Um `name` mas sem `description`**: Claude Code pula o arquivo e escreve o motivo no log de debug.352* **Um `name` mas sem `description`**: o Claude Code ignora o arquivo e grava o motivo no log de depuração.

353* **YAML que não analisa**: Claude Code não lê campos do arquivo, o pula e escreve o erro de análise no log de debug.353* **YAML que não pode ser analisado**: o Claude Code não lê nenhum campo do arquivo, ignora-o e grava o erro de análise no log de depuração.

354 354 

355Para ver o log de debug, execute Claude Code com `--debug`.355Para ver o log de depuração, execute o Claude Code com `--debug`.

356 356 

357Um [subagente de plugin](/docs/pt/plugins/components#agents) cujo frontmatter não tem `name` ou não analisa ainda carrega, sob seu nome de arquivo.357Um [subagente de plugin](/docs/pt/plugins/components#agents) cujo frontmatter não tem `name` ou não pode ser analisado ainda é carregado, sob o nome do seu arquivo.

358 358 

359<h5 id="check-an-agents-directory-before-a-session">359<h5 id="check-an-agents-directory-before-a-session">

360 Verificar um diretório `agents` antes de uma sessão360 Verificar um diretório `agents` antes de uma sessão

361</h5>361</h5>

362 362 

363Para encontrar arquivos em um diretório `agents` cujo frontmatter não analisa, execute `claude plugin validate` contra o diretório, por exemplo `.claude/agents` ou `~/.claude/agents`. Claude Code verifica apenas [o diretório que você nomeia](/docs/pt/plugins/cli-reference#validate-a-directory), e não sinaliza um arquivo cujo frontmatter analisa mas não tem `name`. Requer Claude Code v2.1.233 ou posterior.363Para encontrar arquivos em um diretório `agents` cujo frontmatter não pode ser analisado, execute `claude plugin validate` no diretório, por exemplo `.claude/agents` ou `~/.claude/agents`. O Claude Code verifica apenas [o diretório que você nomeia](/docs/pt/plugins/cli-reference#validate-a-directory) e não sinaliza um arquivo cujo frontmatter é analisado, mas não tem `name`. Requer o Claude Code v2.1.233 ou posterior.

364 364 

365<h3 id="choose-a-model">365<h3 id="choose-a-model">

366 Escolher um modelo366 Escolher um modelo


368 368 

369O campo `model` controla qual modelo o subagente usa:369O campo `model` controla qual modelo o subagente usa:

370 370 

371* **Alias de modelo**: use um dos aliases disponíveis: `sonnet`, `opus`, `haiku`, ou `fable`371* **Alias de modelo**: use um dos aliases disponíveis: `sonnet`, `opus`, `haiku` ou `fable`

372* **ID de modelo completo**: use um ID de modelo completo como `claude-opus-5-5` ou `claude-sonnet-5`. Aceita os mesmos valores que o flag `--model`372* **ID de modelo completo**: use um ID de modelo completo como `claude-opus-5-5` ou `claude-sonnet-5`. Aceita os mesmos valores que a flag `--model`

373* **inherit**: use o mesmo modelo que a conversa principal373* **inherit**: use o mesmo modelo da conversa principal

374 374 

375Quando Claude invoca um subagente, ele também pode passar um parâmetro `model` para essa invocação específica. Claude Code resolve o modelo do subagente nesta ordem:375Quando o Claude invoca um subagente, ele também pode passar um parâmetro `model` para aquela invocação específica. O Claude Code resolve o modelo do subagente nesta ordem:

376 376 

3771. O parâmetro `model` por invocação3771. O parâmetro `model` por invocação

3782. O frontmatter `model` da definição do subagente, onde `inherit` seleciona o modelo da conversa principal3782. O frontmatter `model` da definição do subagente, em que `inherit` seleciona o modelo da conversa principal

3793. A variável de ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/pt/model-config#environment-variables), quando você a define para um alias de modelo ou ID de modelo3793. A variável de ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/pt/model-config#environment-variables), quando você a define como um alias de modelo ou ID de modelo

3804. O modelo da conversa principal3804. O modelo da conversa principal

381 381 

382Em dois casos, um alias de família como `opus` no parâmetro por invocação ou no frontmatter se resolve para o modelo da conversa principal em vez da [versão para a qual o alias aponta](/docs/pt/model-config#model-aliases):382Em dois casos, um alias de família como `opus` no parâmetro por invocação ou no frontmatter resolve para o modelo da conversa principal em vez da [versão para a qual o alias aponta](/docs/pt/model-config#model-aliases):

383 383 

384* **O modelo da conversa principal pertence a essa família**: o subagente é executado no modelo exato da conversa principal, incluindo qualquer sufixo `[1m]`, portanto obtém a mesma janela de [contexto estendido](/docs/pt/model-config#extended-context) que a conversa principal.384* **O modelo da conversa principal pertence a essa família**: o subagente é executado no modelo exato da conversa principal, incluindo qualquer sufixo `[1m]`, de modo que recebe a mesma janela de [contexto estendido](/docs/pt/model-config#extended-context) da conversa principal.

385* **Claude Code não consegue dizer a família do modelo da conversa principal, em [um provedor diferente da API Anthropic](/docs/pt/third-party-integrations)**: isso pode acontecer com um [ARN de perfil de inferência de aplicação](/docs/pt/amazon-bedrock#iam-configuration) no Amazon Bedrock que Claude Code não resolveu para um modelo de suporte. Este caso cobre apenas o alias `opus`, e não se aplica quando você define [`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/pt/model-config#environment-variables), já que `opus` então se resolve para o modelo que você definiu.385* **O Claude Code não consegue identificar a família do modelo da conversa principal, em [um provedor diferente da API da Anthropic](/docs/pt/third-party-integrations)**: isso pode acontecer com um [ARN de perfil de inferência de aplicação](/docs/pt/amazon-bedrock#iam-configuration) no Amazon Bedrock que o Claude Code não resolveu para um modelo subjacente. Este caso abrange apenas o alias `opus` e não se aplica quando você define [`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/pt/model-config#environment-variables), pois `opus` então resolve para o modelo que você definiu.

386 386 

387Um alias em `CLAUDE_CODE_SUBAGENT_MODEL` sempre se resolve para a versão para a qual o alias aponta, mesmo quando nomeia a família da conversa principal.387Um alias em `CLAUDE_CODE_SUBAGENT_MODEL` sempre resolve para a versão para a qual o alias aponta, mesmo quando nomeia a família da conversa principal.

388 388 

389Definir `CLAUDE_CODE_SUBAGENT_MODEL` por si só não muda o modelo em que os subagentes Explore e Plan integrados são executados. Para mudá-lo, veja [Executar cada subagente em um modelo](#run-every-subagent-on-one-model).389Definir `CLAUDE_CODE_SUBAGENT_MODEL` sozinha não altera o modelo em que os subagentes integrados Explore e Plan são executados. Para alterá-lo, consulte [Executar todos os subagentes em um único modelo](#run-every-subagent-on-one-model).

390 390 

391Antes da v2.1.251, `CLAUDE_CODE_SUBAGENT_MODEL` vinha primeiro nesta ordem e sobrescrevia tanto o parâmetro por invocação quanto o frontmatter, incluindo `model: inherit`.391Antes da v2.1.251, `CLAUDE_CODE_SUBAGENT_MODEL` vinha primeiro nesta ordem e sobrescrevia tanto o parâmetro por invocação quanto o frontmatter, incluindo `model: inherit`.

392 392 

393Definir a variável para `inherit` é o mesmo que deixá-la indefinida. Antes da v2.1.196, esse valor forçava subagentes para o modelo da conversa principal e ignorava as outras fontes.393Definir a variável como `inherit` é o mesmo que deixá-la sem definição. Antes da v2.1.196, esse valor forçava os subagentes a usar o modelo da conversa principal e ignorava as outras fontes.

394 394 

395Claude Code verifica o parâmetro por invocação, frontmatter e valores de variável de ambiente contra a lista de permissões [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização. Para um valor bloqueado, ele substitui outro modelo:395O Claude Code verifica os valores do parâmetro por invocação, do frontmatter e da variável de ambiente em relação à allowlist [`availableModels`](/docs/pt/model-config#restrict-model-selection) da sua organização. Para um valor bloqueado, ele substitui por outro modelo:

396 396 

397* Quando o valor bloqueado é um alias de família como `opus`, Claude Code executa o subagente na versão mais recente dessa família que a lista de permissões permite, seguindo as mesmas [regras de substituição e escopo de provedor](/docs/pt/model-config#restrict-model-selection) que `/model`. Antes da v2.1.222, Claude Code executava o subagente no modelo herdado para um alias de família bloqueado também.397* Quando o valor bloqueado é um alias de família como `opus`, o Claude Code executa o subagente na versão mais recente dessa família que a allowlist permite, seguindo as mesmas [regras de substituição e escopo de provedor](/docs/pt/model-config#restrict-model-selection) que o `/model`. Antes da v2.1.222, o Claude Code também executava o subagente no modelo herdado para um alias de família bloqueado.

398* Para qualquer outro valor bloqueado, em provedores onde essa substituição não opera, ou quando a lista de permissões não permite nenhuma versão da família, Claude Code executa o subagente no modelo herdado em vez disso. Se você definir `CLAUDE_CODE_SUBAGENT_MODEL`, Claude Code tenta esse modelo primeiro, sob essas mesmas regras.398* Para qualquer outro valor bloqueado, em provedores onde essa substituição não opera, ou quando a allowlist não permite nenhuma versão da família, o Claude Code executa o subagente no modelo herdado. Se você definir `CLAUDE_CODE_SUBAGENT_MODEL`, o Claude Code tenta esse modelo primeiro, sob essas mesmas regras.

399 399 

400Em sessões interativas, Claude Code mostra um aviso nomeando o modelo solicitado e o modelo em que o subagente é executado, para qualquer substituição.400Em sessões interativas, o Claude Code mostra um aviso nomeando o modelo solicitado e o modelo em que o subagente é executado, para qualquer uma das substituições.

401 401 

402Para verificar qual modelo um subagente está executando, execute [`/tasks`](/docs/pt/commands). Claude Code nomeia o modelo na linha do subagente, e adiciona o [nível de esforço](/docs/pt/model-config#adjust-effort-level) quando a definição do subagente, ou a skill da qual ele se bifurcou, define [`effort`](#supported-frontmatter-fields). Requer Claude Code v2.1.242 ou posterior.402Para verificar em qual modelo um subagente está sendo executado, execute [`/tasks`](/docs/pt/commands). O Claude Code nomeia o modelo na linha do subagente e adiciona o [nível de esforço](/docs/pt/model-config#adjust-effort-level) quando a definição do subagente, ou a skill da qual ele foi bifurcado, define [`effort`](#supported-frontmatter-fields). Requer o Claude Code v2.1.242 ou posterior.

403 403 

404Um parâmetro `model` por invocação também se aplica quando o subagente é [retomado ou enviado uma mensagem de acompanhamento](#resume-subagents), portanto o subagente permanece nesse modelo. Antes da v2.1.211, retomar descartava o valor por invocação e o subagente revertia para o campo `model` de sua definição ou, sem um, o modelo da conversa principal.404Um parâmetro `model` por invocação também se aplica quando o subagente é [retomado ou recebe uma mensagem de acompanhamento](#resume-subagents), de modo que o subagente permanece nesse modelo. Antes da v2.1.211, a retomada descartava o valor por invocação e o subagente voltava ao campo `model` da sua definição ou, na ausência dele, ao modelo da conversa principal.

405 405 

406A partir da v2.1.198, subagentes também herdam a configuração de [pensamento estendido](/docs/pt/model-config#extended-thinking) da conversa principal: se o pensamento está ativado em sua sessão, está ativado para o subagente, e se está desativado, permanece desativado. Não há configuração de pensamento por subagente. Antes da v2.1.198, subagentes eram executados com pensamento estendido desabilitado independentemente da configuração da conversa principal.406A partir da v2.1.198, os subagentes também herdam a configuração de [pensamento estendido](/docs/pt/model-config#extended-thinking) da conversa principal: se o pensamento estiver ativado na sua sessão, ele estará ativado para o subagente e, se estiver desativado, permanecerá desativado. Não há configuração de pensamento por subagente. Antes da v2.1.198, os subagentes eram executados com o pensamento estendido desativado, independentemente da configuração da conversa principal.

407 407 

408<h4 id="run-every-subagent-on-one-model">408<h4 id="run-every-subagent-on-one-model">

409 Executar cada subagente em um modelo409 Executar todos os subagentes em um único modelo

410</h4>410</h4>

411 411 

412`CLAUDE_CODE_SUBAGENT_MODEL` é um padrão, portanto a definição de um subagente ou um modelo que Claude passa ainda tem precedência sobre ele. Para aplicar um modelo a cada subagente, [colega de trabalho](/docs/pt/agent-teams#specify-teammates-and-models) e [agente de workflow](/docs/pt/workflows), também defina `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` para `1`. Requer Claude Code v2.1.257 ou posterior.412`CLAUDE_CODE_SUBAGENT_MODEL` é um padrão, então a definição de um subagente ou um modelo que o Claude passa ainda tem precedência sobre ela. Para aplicar um único modelo a todos os subagentes, [colegas](/docs/pt/agent-teams#specify-teammates-and-models) e [agentes de workflow](/docs/pt/workflows), defina também `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` como `1`. Requer o Claude Code v2.1.257 ou posterior.

413 413 

414* Se você definir ambas as variáveis, subagentes são executados no modelo em `CLAUDE_CODE_SUBAGENT_MODEL`.414* Se você definir ambas as variáveis, os subagentes são executados no modelo em `CLAUDE_CODE_SUBAGENT_MODEL`.

415* Se você definir apenas `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`, subagentes são executados no modelo da conversa principal, exceto que o subagente Explore integrado é executado no [modelo listado para ele em Subagentes integrados](#built-in-subagents).415* Se você definir apenas `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`, os subagentes são executados no modelo da conversa principal, exceto que o subagente integrado Explore é executado no [modelo listado para ele em Subagentes integrados](#built-in-subagents).

416 416 

417Por exemplo, para executar cada subagente em Haiku, defina ambas as variáveis no bloco `env` de um [arquivo de configurações](/docs/pt/settings):417Por exemplo, para executar todos os subagentes no Haiku, defina ambas as variáveis no bloco `env` de um [arquivo de configurações](/docs/pt/settings):

418 418 

419```json theme={null}419```json theme={null}

420{420{


425}425}

426```426```

427 427 

428Para verificar que a configuração entrou em vigor, execute [`/tasks`](/docs/pt/commands) enquanto um subagente está em execução. A linha do subagente mostra o modelo em que ele é executado.428Para verificar se a configuração entrou em vigor, execute [`/tasks`](/docs/pt/commands) enquanto um subagente estiver em execução. A linha do subagente mostra o modelo em que ele é executado.

429 429 

430Enquanto `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` está [ativado](/docs/pt/env-vars), Claude Code ignora o campo `model` nas definições de subagente, e Claude não pode passar um modelo quando inicia um subagente. Estes subagentes ainda são executados no modelo da conversa principal:430Enquanto `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` estiver [ativada](/docs/pt/env-vars), o Claude Code ignora o campo `model` nas definições de subagentes, e o Claude não pode passar um modelo ao iniciar um subagente. Estes subagentes ainda são executados no modelo da conversa principal:

431 431 

432* Uma [bifurcação](#fork-the-current-conversation)432* Um [fork](#fork-the-current-conversation)

433* Uma [skill que é executada em um subagente](/docs/pt/skills#run-skills-in-a-subagent) com `model: inherit`433* Uma [skill executada em um subagente](/docs/pt/skills#run-skills-in-a-subagent) com `model: inherit`

434 434 

435<h3 id="control-subagent-capabilities">435<h3 id="control-subagent-capabilities">

436 Controlar capacidades do subagente436 Controlar as capacidades dos subagentes

437</h3>437</h3>

438 438 

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

440 440 

441<h4 id="available-tools">441<h4 id="available-tools">

442 Ferramentas disponíveis442 Ferramentas disponíveis

443</h4>443</h4>

444 444 

445Subagentes herdam as [ferramentas integradas](/docs/pt/tools-reference) e ferramentas MCP disponíveis na conversa principal, reduzidas por dois filtros: o primeiro remove uma lista curta de ferramentas de cada subagente, e o segundo reduz o conjunto de ferramentas integradas para subagentes que são executados em [background](#run-subagents-in-foreground-or-background), que é o padrão. Em macOS, Linux e WSL, um subagente também pode receber as ferramentas Glob e Grep quando a conversa principal não as tem, conforme descrito em [Comportamento da ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior). [Bifurcações](#fork-the-current-conversation) pulam ambos os filtros e recebem o pool de ferramentas exato da conversa principal. O primeiro filtro remove essas ferramentas, mesmo quando listadas no campo `tools`:445Os subagentes herdam as [ferramentas integradas](/docs/pt/tools-reference) e as ferramentas MCP disponíveis na conversa principal, reduzidas por dois filtros: o primeiro remove uma pequena lista de ferramentas de todos os subagentes, e o segundo reduz o conjunto de ferramentas integradas para subagentes executados em [segundo plano](#run-subagents-in-foreground-or-background), que é o padrão. No macOS, Linux e WSL, um subagente também pode receber as ferramentas Glob e Grep quando a conversa principal não as tem, conforme descrito em [Comportamento da ferramenta Glob](/docs/pt/tools-reference#glob-tool-behavior). Os [forks](#fork-the-current-conversation) ignoram ambos os filtros e recebem exatamente o conjunto de ferramentas da conversa principal. O primeiro filtro remove estas ferramentas, mesmo quando listadas no campo `tools`:

446 446 

447* `Agent`, quando o subagente está no [limite de profundidade](#let-subagents-spawn-their-own-subagents); em uma [bifurcação](#fork-the-current-conversation) a ferramenta permanece listada mas retorna um erro em vez de gerar447* `Agent`, quando o subagente está no [limite de profundidade](#let-subagents-spawn-their-own-subagents); em um [fork](#fork-the-current-conversation), a ferramenta permanece listada, mas retorna um erro em vez de criar um subagente

448* `AskUserQuestion`448* `AskUserQuestion`

449* `EndConversation`, que pode encerrar apenas a conversa principal; veja [comportamento da ferramenta EndConversation](/docs/pt/tools-reference#endconversation-tool-behavior)449* `EndConversation`, que só pode encerrar a conversa principal; consulte [Comportamento da ferramenta EndConversation](/docs/pt/tools-reference#endconversation-tool-behavior)

450* `EnterPlanMode`450* `EnterPlanMode`

451* `ExitPlanMode`, a menos que o [`permissionMode`](#permission-modes) do subagente seja `plan`451* `ExitPlanMode`, a menos que o [`permissionMode`](#permission-modes) do subagente seja `plan`

452* `ScheduleWakeup`452* `ScheduleWakeup`

453* `WaitForMcpServers`453* `WaitForMcpServers`

454* `Workflow`454* `Workflow`

455 455 

456O segundo filtro se aplica a subagentes em execução em background. Além de `Agent` e `ExitPlanMode`, que seguem as condições do primeiro filtro onde quer que o subagente seja executado, um subagente em background mantém cada ferramenta MCP mas apenas essas ferramentas integradas: `Read`, `Grep`, `Glob`, `LSP`, `Bash`, `PowerShell`, `Edit`, `Write`, `NotebookEdit`, `WebFetch`, `WebSearch`, `TodoWrite`, `Skill`, `ToolSearch`, `EnterWorktree`, `ExitWorktree`, `Monitor`, `TaskStop`, `SendMessage` e `Artifact`, além de [`SubagentHandback`](/docs/pt/tools-reference) para um subagente que relata através dele. Claude Code remove todas as outras ferramentas integradas de um subagente em background, seja herdadas ou listadas no campo `tools`, portanto a mesma definição pode se resolver para ferramentas diferentes em foreground e background. A remoção não relata erro a menos que deixe a lista `tools` [se resolvendo para nada](/docs/pt/errors#agent-would-be-spawned-with-zero-tools).456O segundo filtro se aplica a subagentes executados em segundo plano. Exceto `Agent` e `ExitPlanMode`, que seguem as condições do primeiro filtro onde quer que o subagente seja executado, um subagente em segundo plano mantém todas as ferramentas MCP, mas apenas estas ferramentas integradas: `Read`, `Grep`, `Glob`, `LSP`, `Bash`, `PowerShell`, `Edit`, `Write`, `NotebookEdit`, `WebFetch`, `WebSearch`, `TodoWrite`, `Skill`, `ToolSearch`, `EnterWorktree`, `ExitWorktree`, `Monitor`, `TaskStop`, `SendMessage` e `Artifact`, além de [`SubagentHandback`](/docs/pt/tools-reference) para um subagente que faz seus relatos por meio dela. O Claude Code remove todas as outras ferramentas integradas de um subagente em segundo plano, sejam herdadas ou listadas no campo `tools`, de modo que a mesma definição pode resolver para ferramentas diferentes em primeiro plano e em segundo plano. A remoção não relata nenhum erro, a menos que deixe a lista `tools` [resolvendo para nada](/docs/pt/errors#agent-would-be-spawned-with-zero-tools).

457 457 

458Antes da v2.1.280, subagentes em background não podiam usar `LSP`.458Antes da v2.1.280, os subagentes em segundo plano não podiam usar `LSP`.

459 459 

460[`ListAgents`](/docs/pt/cross-session-messaging) segue esses filtros como qualquer ferramenta integrada: um subagente em foreground a herda em sessões onde mensagens entre sessões estão habilitadas, e um subagente em background não a mantém.460[`ListAgents`](/docs/pt/cross-session-messaging) segue esses filtros como qualquer ferramenta integrada: um subagente em primeiro plano a herda em sessões onde a troca de mensagens entre sessões está habilitada, e um subagente em segundo plano não a mantém.

461 461 

462Colegas de trabalho em [equipes de agentes](/docs/pt/agent-teams) adicionalmente mantêm as ferramentas de tarefa e ferramentas cron: `TaskCreate`, `TaskGet`, `TaskList`, `TaskUpdate`, `CronCreate`, `CronDelete` e `CronList`.462Os colegas em [equipes de agentes](/docs/pt/agent-teams) mantêm adicionalmente as ferramentas de tarefas e de cron: `TaskCreate`, `TaskGet`, `TaskList`, `TaskUpdate`, `CronCreate`, `CronDelete` e `CronList`.

463 463 

464Em uma [sessão sem as ferramentas Task](/docs/pt/tools-reference#task-tool-availability), Claude Code não fornece as ferramentas de tarefa a subagentes também, mesmo quando o subagente executa um modelo diferente. Um colega de trabalho em processo segue sua sessão da mesma forma, enquanto um colega de trabalho em seu próprio [painel dividido](/docs/pt/agent-teams#choose-a-display-mode) é executado como um processo Claude Code separado, portanto seu próprio modelo decide.464Em uma [sessão sem as ferramentas Task](/docs/pt/tools-reference#task-tool-availability), o Claude Code também não fornece as ferramentas de tarefas aos subagentes, mesmo quando o subagente executa um modelo diferente. Um colega em processo segue a sua sessão da mesma forma, enquanto um colega em seu próprio [painel dividido](/docs/pt/agent-teams#choose-a-display-mode) é executado como um processo separado do Claude Code, então é o seu próprio modelo que decide.

465 465 

466Para restringir ferramentas, use o campo `tools` como uma lista de permissões ou o campo `disallowedTools` como uma lista de negação. Este exemplo usa `tools` para permitir apenas Read, Grep, Glob e Bash. O subagente não pode editar arquivos, escrever arquivos ou usar qualquer ferramenta MCP:466Para restringir ferramentas, use o campo `tools` como allowlist ou o campo `disallowedTools` como denylist. Este exemplo usa `tools` para permitir apenas Read, Grep, Glob e Bash. O subagente não pode editar arquivos, escrever arquivos nem usar ferramentas MCP:

467 467 

468```yaml theme={null}468```yaml theme={null}

469---469---


473---473---

474```474```

475 475 

476Este exemplo usa `disallowedTools` para herdar o pool de ferramentas do subagente exceto Write e Edit. O subagente mantém Bash, ferramentas MCP e o resto de seu pool:476Este exemplo usa `disallowedTools` para herdar o conjunto de ferramentas do subagente, exceto Write e Edit. O subagente mantém Bash, as ferramentas MCP e o restante do seu conjunto:

477 477 

478```yaml theme={null}478```yaml theme={null}

479---479---


483---483---

484```484```

485 485 

486Se ambos forem definidos, `disallowedTools` é aplicado primeiro, depois `tools` é resolvido contra o pool restante. Uma ferramenta listada em ambos é removida.486Se ambos estiverem definidos, `disallowedTools` é aplicado primeiro e, em seguida, `tools` é resolvido em relação ao conjunto restante. Uma ferramenta listada em ambos é removida.

487 487 

488Quando nada na lista `tools` se resolve para uma ferramenta, por exemplo porque cada entrada está com erro de digitação ou nomeia uma ferramenta que não está disponível para subagentes, Claude Code geralmente recusa iniciar o subagente e a ferramenta Agent retorna um erro nomeando as entradas não resolvidas; veja [Agent would be spawned with zero tools](/docs/pt/errors#agent-would-be-spawned-with-zero-tools) para a mensagem e como corrigir cada entrada. Antes da v2.1.208, esse subagente era iniciado sem ferramentas e poderia retornar um resultado vazio ou confuso.488Quando nada na lista `tools` resolve para uma ferramenta, por exemplo porque todas as entradas estão com erro de digitação ou nomeiam uma ferramenta que não está disponível para subagentes, o Claude Code geralmente se recusa a iniciar o subagente e a ferramenta Agent retorna um erro nomeando as entradas não resolvidas; consulte [Agent would be spawned with zero tools](/docs/pt/errors#agent-would-be-spawned-with-zero-tools) para ver a mensagem e como corrigir cada entrada. Antes da v2.1.208, esse subagente era iniciado sem ferramentas e podia retornar um resultado vazio ou confuso.

489 489 

490Ambos os campos aceitam padrões de nível de servidor MCP além de nomes de ferramentas exatos: `mcp__<server>` ou `mcp__<server>__*` concede ou remove todas as ferramentas do servidor nomeado. Em `disallowedTools`, `mcp__*` também remove todas as ferramentas MCP de qualquer servidor. Este exemplo remove todas as ferramentas do servidor MCP `github` enquanto mantém ferramentas de outros servidores e as ferramentas integradas em seu pool:490Ambos os campos aceitam padrões no nível do servidor MCP, além de nomes exatos de ferramentas: `mcp__<server>` ou `mcp__<server>__*` concede ou remove todas as ferramentas do servidor nomeado. Em `disallowedTools`, `mcp__*` também remove todas as ferramentas MCP de qualquer servidor. Este exemplo remove todas as ferramentas do servidor MCP `github`, mantendo as ferramentas de outros servidores e as ferramentas integradas no seu conjunto:

491 491 

492```yaml theme={null}492```yaml theme={null}

493---493---


497---497---

498```498```

499 499 

500Uma entrada `disallowedTools` com um especificador, como `Bash(git push *)`, ainda remove a ferramenta inteira do subagente, não apenas os comandos correspondentes. Para manter Bash e bloquear comandos específicos, adicione uma [regra de negação Bash](/docs/pt/permissions#bash) como `Bash(git push *)` a `permissions.deny` em suas configurações. A regra se aplica à conversa principal e aos subagentes.500Uma entrada de `disallowedTools` com especificador, como `Bash(git push *)`, ainda remove a ferramenta inteira do subagente, e não apenas os comandos correspondentes. Para manter o Bash e bloquear comandos específicos, adicione uma [regra de negação do Bash](/docs/pt/permissions#bash), como `Bash(git push *)`, a `permissions.deny` nas suas configurações. A regra se aplica à conversa principal e aos subagentes.

501 501 

502<h4 id="restrict-which-subagents-can-be-spawned">502<h4 id="restrict-which-subagents-can-be-spawned">

503 Restringir quais subagentes podem ser gerados503 Restringir quais subagentes podem ser criados

504</h4>504</h4>

505 505 

506Quando um agente é executado como thread principal com `claude --agent`, ele pode gerar subagentes usando a ferramenta Agent. Para restringir quais tipos de subagente ele pode gerar, use a sintaxe `Agent(agent_type)` no campo `tools`.506Quando um agente é executado como thread principal com `claude --agent`, ele pode criar subagentes usando a ferramenta Agent. Para restringir quais tipos de subagentes ele pode criar, use a sintaxe `Agent(agent_type)` no campo `tools`.

507 507 

508<Note>Na versão 2.1.63, a ferramenta Task foi renomeada para Agent. Referências existentes de `Task(...)` em configurações e definições de agente ainda funcionam como aliases.</Note>508<Note>Na versão 2.1.63, a ferramenta Task foi renomeada para Agent. As referências `Task(...)` existentes em configurações e definições de agentes ainda funcionam como aliases.</Note>

509 509 

510```yaml theme={null}510```yaml theme={null}

511---511---


515---515---

516```516```

517 517 

518Esta é uma lista de permissões: apenas os subagentes `worker` e `researcher` podem ser gerados. Se o agente tentar gerar qualquer outro tipo, a solicitação falha e o agente vê apenas os tipos permitidos em seu prompt. Para bloquear agentes específicos enquanto permite todos os outros, use [`permissions.deny`](#disable-specific-subagents) em vez disso.518Isto é uma allowlist: apenas os subagentes `worker` e `researcher` podem ser criados. Se o agente tentar criar qualquer outro tipo, a requisição falha e o agente vê apenas os tipos permitidos no seu prompt. Para bloquear agentes específicos enquanto permite todos os outros, use [`permissions.deny`](#disable-specific-subagents).

519 519 

520Para permitir gerar qualquer subagente sem restrições, use `Agent` sem parênteses:520Para permitir a criação de qualquer subagente sem restrições, use `Agent` sem parênteses:

521 521 

522```yaml theme={null}522```yaml theme={null}

523tools: Agent, Read, Bash523tools: Agent, Read, Bash

524```524```

525 525 

526Se `Agent` for omitido da lista `tools` inteiramente, o agente não pode gerar nenhum subagente com a ferramenta Agent.526Se você omitir `Agent` totalmente da lista `tools`, o agente não poderá criar nenhum subagente com a ferramenta Agent.

527 527 

528A sintaxe de lista de permissões `Agent(agent_type)` se aplica apenas a um agente executado como thread principal com `claude --agent`. Em uma definição de subagente, listar `Agent` em `tools` permite que esse subagente gere subagentes de sua própria conta enquanto o [limite de profundidade](#let-subagents-spawn-their-own-subagents) permite, mas qualquer lista de tipo dentro dos parênteses é ignorada.528A sintaxe de allowlist `Agent(agent_type)` se aplica apenas a um agente executado como thread principal com `claude --agent`. Em uma definição de subagente, listar `Agent` em `tools` permite que esse subagente crie seus próprios subagentes enquanto o [limite de profundidade](#let-subagents-spawn-their-own-subagents) permitir, mas qualquer lista de tipos dentro dos parênteses é ignorada.

529 529 

530<h4 id="scope-mcp-servers-to-a-subagent">530<h4 id="scope-mcp-servers-to-a-subagent">

531 Escopo de MCP servers para um subagente531 Restringir servidores MCP a um subagente

532</h4>532</h4>

533 533 

534Use o campo `mcpServers` para dar a um subagente acesso a [MCP](/docs/pt/mcp) servers que não estão disponíveis na conversa principal. Servidores inline definidos aqui são conectados quando o subagente inicia, sujeitos à [regra de confiança para a pasta do arquivo do agente](#inline-server-trust), e desconectados quando termina. Referências de string compartilham a conexão da sessão pai.534Use o campo `mcpServers` para dar a um subagente acesso a servidores [MCP](/docs/pt/mcp) que não estão disponíveis na conversa principal. Os servidores inline definidos aqui são conectados quando o subagente é iniciado, sujeitos à [regra de confiança para a pasta do arquivo do agente](#inline-server-trust), e desconectados quando ele termina. As referências por string compartilham a conexão da sessão pai.

535 535 

536<Note>536<Note>

537 O campo `mcpServers` se aplica em ambos os contextos onde um arquivo de agente pode ser executado:537 O campo `mcpServers` se aplica em ambos os contextos em que um arquivo de agente pode ser executado:

538 538 

539 * Como um subagente, gerado através da ferramenta Agent ou uma @-menção539 * Como subagente, criado por meio da ferramenta Agent ou de uma @-menção

540 * Como a sessão principal, iniciada com [`--agent`](#invoke-subagents-explicitly) ou a configuração `agent`540 * Como sessão principal, iniciada com [`--agent`](#invoke-subagents-explicitly) ou a configuração `agent`

541 541 

542 Quando o agente é a sessão principal, definições de servidor inline se conectam na inicialização junto com servidores de [`.mcp.json`](/docs/pt/mcp) e arquivos de configurações, sob a mesma [regra de confiança para a pasta do arquivo do agente](#inline-server-trust). Em `/mcp`, um servidor remoto (HTTP ou SSE) que você usou antes pode mostrar o status [`cached`](/docs/pt/mcp#managing-your-servers) em vez disso; Claude Code o conecta quando Claude primeiro chama uma de suas ferramentas.542 Quando o agente é a sessão principal, as definições de servidores inline se conectam na inicialização junto com os servidores de [`.mcp.json`](/docs/pt/mcp) e dos arquivos de configurações, sob a mesma [regra de confiança para a pasta do arquivo do agente](#inline-server-trust). No `/mcp`, um servidor remoto (HTTP ou SSE) que você já usou pode mostrar o [status `cached`](/docs/pt/mcp#managing-your-servers); o Claude Code o conecta quando o Claude chama uma de suas ferramentas pela primeira vez.

543</Note>543</Note>

544 544 

545Cada entrada na lista é uma definição de servidor inline ou uma string referenciando um MCP server já configurado em sua sessão:545Cada entrada na lista é uma definição de servidor inline ou uma string que referencia um servidor MCP já configurado na sua sessão:

546 546 

547```yaml theme={null}547```yaml theme={null}

548---548---


561Use the Playwright tools to navigate, screenshot, and interact with pages.561Use the Playwright tools to navigate, screenshot, and interact with pages.

562```562```

563 563 

564Definições inline usam o mesmo schema que entradas de servidor `.mcp.json`, com chave pelo nome do servidor, e suportam os tipos `stdio`, `http`, `sse` e `ws`.564As definições inline usam o mesmo esquema das entradas de servidor do `.mcp.json`, indexadas pelo nome do servidor, e suportam os tipos `stdio`, `http`, `sse` e `ws`.

565 565 

566Para manter um MCP server fora da conversa principal inteiramente e evitar que suas descrições de ferramentas consumam contexto lá, defina-o inline aqui em vez de em `.mcp.json`. O subagente obtém as ferramentas; a conversa pai não.566Para manter um servidor MCP totalmente fora da conversa principal e evitar que as descrições de suas ferramentas consumam contexto ali, defina-o inline aqui em vez de no `.mcp.json`. O subagente recebe as ferramentas; a conversa pai não.

567 567 

568As restrições de MCP que se aplicam à sessão principal também cobrem servidores declarados no frontmatter do subagente:568As restrições de MCP que se aplicam à sessão principal também abrangem os servidores declarados no frontmatter do subagente:

569 569 

570* [`--strict-mcp-config`](/docs/pt/cli-reference) e [`--bare`](/docs/pt/cli-reference)570* [`--strict-mcp-config`](/docs/pt/cli-reference) e [`--bare`](/docs/pt/cli-reference)

571* [Configuração de MCP gerenciada pela empresa](/docs/pt/managed-mcp)571* [Configuração de MCP gerenciada corporativa](/docs/pt/managed-mcp)

572* [Políticas `allowedMcpServers` e `deniedMcpServers`](/docs/pt/managed-mcp#policy-based-control-with-allowlists-and-denylists)572* [Políticas `allowedMcpServers` e `deniedMcpServers`](/docs/pt/managed-mcp#policy-based-control-with-allowlists-and-denylists)

573 573 

574Quando uma destas bloqueia um servidor, Claude Code o ignora e mostra um aviso nomeando os servidores bloqueados.574Quando uma delas bloqueia um servidor, o Claude Code o ignora e mostra um aviso nomeando os servidores bloqueados.

575 575 

576Restrições de configurações gerenciadas se aplicam a cada subagente independentemente de como ele é definido. `--strict-mcp-config` não filtra servidores que você passa inline via `--agents` ou a opção `agents` do SDK, já que esses são entrada explícita do chamador.576As restrições das configurações gerenciadas se aplicam a todos os subagentes, independentemente de como são definidos. `--strict-mcp-config` não filtra servidores que você passa inline via `--agents` ou a opção `agents` do SDK, pois essas são entradas explícitas de quem faz a chamada.

577 577 

578<h4 id="inline-server-trust">578<h4 id="inline-server-trust">

579 Confiança necessária para servidores MCP inline579 Confiança exigida para servidores MCP inline

580</h4>580</h4>

581 581 

582Claude Code carrega um [servidor MCP inline](#scope-mcp-servers-to-a-subagent) de um arquivo de agente no diretório `.claude/agents/` do seu projeto, ou no `.claude/agents/` de um diretório adicionado com `--add-dir`, apenas depois que você [confia na pasta de onde o arquivo do agente veio](/docs/pt/permissions#what-runs-before-you-trust-a-folder). Antes da v2.1.238, Claude Code carregava esses servidores sem verificar confiança.582O Claude Code carrega um [servidor MCP inline](#scope-mcp-servers-to-a-subagent) de um arquivo de agente no diretório `.claude/agents/` do seu projeto, ou no `.claude/agents/` de um diretório `--add-dir`, somente depois que você [confia na pasta de onde o arquivo do agente veio](/docs/pt/permissions#what-runs-before-you-trust-a-folder). Antes da v2.1.238, o Claude Code carregava esses servidores sem verificar a confiança.

583 583 

584* **Confiança que não conta**: confiança de uma pasta pai, e a confiança automática que uma sessão `-p` ou SDK obtém para [hooks em arquivos de configurações](/docs/pt/permissions#what-runs-before-you-trust-a-folder)584* **Confiança que não conta**: a confiança de uma pasta pai e a confiança automática que uma sessão `-p` ou do SDK recebe para [hooks em arquivos de configurações](/docs/pt/permissions#what-runs-before-you-trust-a-folder)

585* **Até então**: Claude Code pula cada servidor inline naquele arquivo de agente e escreve a chave exata `projects["<path>"].hasTrustDialogAccepted` para `~/.claude.json` no log de debug585* **Até então**: o Claude Code ignora todos os servidores inline nesse arquivo de agente e grava a chave exata `projects["<path>"].hasTrustDialogAccepted` para `~/.claude.json` no log de depuração

586* **Diretórios `--add-dir`**: um diretório fora do repositório do espaço de trabalho confiável de sua organização precisa de sua própria entrada de confiança, já que seus arquivos `.claude/agents/` não herdam a confiança do seu espaço de trabalho586* **Diretórios `--add-dir`**: um diretório fora do repositório do seu workspace confiável precisa de sua própria entrada de confiança, pois seus arquivos `.claude/agents/` não herdam a confiança do seu workspace

587 587 

588Claude Code carrega dois tipos de servidor sem verificar confiança para a pasta de onde o arquivo do agente veio:588O Claude Code carrega dois tipos de servidor sem verificar a confiança da pasta de onde o arquivo do agente veio:

589 589 

590* Um nome que referencia um servidor que você já configurou590* Um nome que referencia um servidor que você já configurou

591* Um servidor inline em um arquivo de agente de `~/.claude/agents/`, em um que você passa com `--agents` ou a opção `agents` do SDK, ou em um que as configurações gerenciadas fornecem591* Um servidor inline em um arquivo de agente de `~/.claude/agents/`, em um que você passa com `--agents` ou a opção `agents` do SDK, ou em um que as configurações gerenciadas fornecem


594 Modos de permissão594 Modos de permissão

595</h4>595</h4>

596 596 

597Defina `permissionMode` para escolher o modo de permissão em que um subagente é executado. Use os valores de configuração dos modos, portanto o modo Manual é `default`. Se você deixar indefinido, o subagente herda o [modo de permissão](/docs/pt/permission-modes) da conversa principal.597Defina `permissionMode` para escolher o modo de permissão em que um subagente é executado. Use os valores de configuração dos modos; assim, o modo Manual é `default`. Se você deixá-lo sem definição, o subagente herda o [modo de permissão](/docs/pt/permission-modes) da conversa principal.

598 598 

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

600 600 

601* Quando a conversa principal está em `bypassPermissions`, `acceptEdits`, ou [modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), o subagente é executado nesse mesmo modo e Claude Code ignora o `permissionMode` que você definiu. Sob modo auto, o classificador avalia as chamadas de ferramentas do subagente com as regras de bloqueio e permissão da conversa principal. Quando o subagente termina, o classificador também revisa seu trabalho e seu relatório final antes do relatório ser entregue, conforme [Como o modo auto lida com subagentes](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode) descreve.601* Quando a conversa principal está em `bypassPermissions`, `acceptEdits` ou no [modo auto](/docs/pt/permission-modes#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](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode).

602* Quando a conversa principal está em `default`, `dontAsk`, ou modo `plan`, o subagente é executado no modo de permissão que você definiu, exceto `bypassPermissions`. Um subagente que declara `bypassPermissions` mantém o modo da conversa principal em vez disso. A exceção `bypassPermissions` requer Claude Code v2.1.267 ou posterior.602* Quando a conversa principal está no modo `default`, `dontAsk` ou `plan`, o subagente é executado no modo de permissão que você definiu, exceto `bypassPermissions`. Um subagente que declara `bypassPermissions` mantém, em vez disso, o modo da conversa principal. A exceção de `bypassPermissions` requer o Claude Code v2.1.267 ou posterior.

603 603 

604`permissionMode` aceita estes valores, e `manual` como um alias para `default`:604`permissionMode` aceita estes valores, e `manual` como alias para `default`:

605 605 

606| Mode | Behavior |606| Modo | Comportamento |

607| :- | :- |607| :- | :- |

608| `default` | Modo Manual: solicita permissão |608| `default` | Modo Manual: solicita permissão |

609| `acceptEdits` | Auto-aceitar edições de arquivo e comandos comuns do sistema de arquivos para caminhos no diretório de trabalho ou `additionalDirectories` |609| `acceptEdits` | Aceita automaticamente edições de arquivos e comandos comuns do sistema de arquivos para caminhos no diretório de trabalho ou em `additionalDirectories` |

610| `auto` | [Modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode): um classificador de IA revisa comandos e escritas em diretório protegido |610| `auto` | [Modo auto](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode): um classificador em segundo plano revisa comandos e gravações em diretórios protegidos |

611| `dontAsk` | Auto-negar prompts de permissão. Ferramentas explicitamente permitidas ainda funcionam; `AskUserQuestion`, ferramentas MCP marcadas [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool), e ferramentas de conector [sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) em sessões onde essa configuração chega a Claude Code são negadas mesmo se você as permitiu |611| `dontAsk` | Nega automaticamente os prompts de permissão. Ferramentas explicitamente permitidas ainda funcionam; `AskUserQuestion`, ferramentas MCP marcadas com [`requiresUserInteraction`](/docs/pt/mcp#require-approval-for-a-specific-tool) e ferramentas de conectores que [sua organização definiu como `ask`](/docs/pt/mcp#organization-controls-on-connector-tools) em sessões onde essa configuração chega ao Claude Code são negadas mesmo que você as tenha permitido |

612| `bypassPermissions` | [Pular prompts de permissão](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode). Um subagente é executado neste modo apenas quando a conversa principal o faz |612| `bypassPermissions` | [Ignora os prompts de permissão](/docs/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode). Um subagente é executado neste modo somente quando a conversa principal também está |

613| `plan` | Plan mode (exploração somente leitura) |613| `plan` | Modo de planejamento (exploração somente leitura) |

614 614 

615<h4 id="preload-skills-into-subagents">615<h4 id="preload-skills-into-subagents">

616 Pré-carregar skills em subagentes616 Pré-carregar skills em subagentes

617</h4>617</h4>

618 618 

619Use o campo `skills` para injetar conteúdo de skill no contexto de um subagente na inicialização. Isso dá ao subagente conhecimento de domínio sem exigir que ele descubra e carregue skills durante a execução.619Use o campo `skills` para injetar o conteúdo de skills no contexto de um subagente na inicialização. Isso dá ao subagente conhecimento de domínio sem exigir que ele descubra e carregue skills durante a execução.

620 620 

621```yaml theme={null}621```yaml theme={null}

622---622---


630Implement API endpoints. Follow the conventions and patterns from the preloaded skills.630Implement API endpoints. Follow the conventions and patterns from the preloaded skills.

631```631```

632 632 

633O conteúdo completo de cada skill listada é injetado no contexto do subagente na inicialização. Este campo controla quais skills são pré-carregadas, não quais skills o subagente pode acessar: sem ele, o subagente ainda pode descobrir e invocar skills de projeto, usuário e plugin através da ferramenta Skill durante a execução. Para impedir que um subagente invoque skills inteiramente, omita `Skill` da lista [`tools`](#available-tools) ou adicione-o a `disallowedTools`.633O conteúdo completo de cada skill listada é injetado no contexto do subagente na inicialização. Este campo controla quais skills são pré-carregadas, e não quais skills o subagente pode acessar: sem ele, o subagente ainda pode descobrir e invocar skills de projeto, de usuário e de plugin por meio da ferramenta Skill durante a execução. Para impedir totalmente que um subagente invoque skills, omita `Skill` da lista [`tools`](#available-tools) ou adicione-a a `disallowedTools`.

634 634 

635Você não pode pré-carregar skills que definem [`disable-model-invocation: true`](/docs/pt/skills#control-who-invokes-a-skill), já que o pré-carregamento extrai do mesmo conjunto de skills que Claude pode invocar. Isso inclui a skill `/verify` integrada, que Claude não pode executar por conta própria.635Você não pode pré-carregar skills que definem [`disable-model-invocation: true`](/docs/pt/skills#control-who-invokes-a-skill), pois o pré-carregamento usa o mesmo conjunto de skills que o Claude pode invocar. Isso inclui a skill integrada `/verify`, que o Claude não pode executar por conta própria.

636 636 

637Se uma skill listada estiver faltando ou desabilitada, por exemplo pela política de sua organização, Claude Code a ignora e registra um aviso no log de debug.637Se uma skill listada estiver ausente ou desabilitada, por exemplo pela política da sua organização, o Claude Code a ignora e registra um aviso no log de depuração.

638 638 

639<Note>639<Note>

640 Isto é o inverso de [executar uma skill em um subagente](/docs/pt/skills#run-skills-in-a-subagent). Com `skills` em um subagente, o subagente controla o prompt de sistema e carrega conteúdo de skill. Com `context: fork` em uma skill, o conteúdo de skill é injetado no agente que você especificar. Em ambos os casos o subagente começa sem seu histórico de conversa.640 Isto é o inverso de [executar uma skill em um subagente](/docs/pt/skills#run-skills-in-a-subagent). Com `skills` em um subagente, o subagente controla o system prompt e carrega o conteúdo da skill. Com `context: fork` em uma skill, o conteúdo da skill é injetado no agente que você especificar. Em ambos os casos, o subagente começa sem o histórico da sua conversa.

641</Note>641</Note>

642 642 

643<h4 id="enable-persistent-memory">643<h4 id="enable-persistent-memory">

644 Habilitar memória persistente644 Habilitar memória persistente

645</h4>645</h4>

646 646 

647O campo `memory` dá ao subagente um diretório persistente que sobrevive entre conversas. O subagente usa este diretório para construir conhecimento ao longo do tempo, como padrões de base de código, insights de debugging e decisões arquiteturais.647O campo `memory` dá ao subagente um diretório persistente que sobrevive entre conversas. O subagente usa esse diretório para acumular conhecimento ao longo do tempo, como padrões da base de código, insights de depuração e decisões arquiteturais.

648 648 

649```yaml theme={null}649```yaml theme={null}

650---650---


657patterns, conventions, and recurring issues you discover.657patterns, conventions, and recurring issues you discover.

658```658```

659 659 

660Escolha um escopo baseado em quão amplamente a memória deve se aplicar:660Escolha um escopo com base em quão amplamente a memória deve se aplicar:

661 661 

662| Scope | Location | Use when |662| Escopo | Local | Use quando |

663| :- | :- | :- |663| :- | :- | :- |

664| `user` | `~/.claude/agent-memory/<name-of-agent>/` | o subagente deve lembrar aprendizados entre todos os projetos |664| `user` | `~/.claude/agent-memory/<name-of-agent>/` | o subagente deve lembrar aprendizados em todos os projetos |

665| `project` | `.claude/agent-memory/<name-of-agent>/` | o conhecimento do subagente é específico do projeto e compartilhável via controle de versão |665| `project` | `.claude/agent-memory/<name-of-agent>/` | o conhecimento do subagente é específico do projeto e pode ser compartilhado via controle de versão |

666| `local` | `.claude/agent-memory-local/<name-of-agent>/` | o conhecimento do subagente é específico do projeto mas não deve ser verificado no controle de versão |666| `local` | `.claude/agent-memory-local/<name-of-agent>/` | o conhecimento do subagente é específico do projeto, mas não deve ser incluído no controle de versão |

667 667 

668A memória do subagente faz parte da [memória automática](/docs/pt/memory#auto-memory): se você desativar a memória automática, com a configuração `autoMemoryEnabled` ou `CLAUDE_CODE_DISABLE_AUTO_MEMORY`, o campo `memory` não tem efeito e o subagente é iniciado sem as instruções de memória ou o acesso à ferramenta de memória descrito abaixo.668A memória do subagente faz parte da [memória automática](/docs/pt/memory#auto-memory): se você desativar a memória automática, com a configuração `autoMemoryEnabled` ou `CLAUDE_CODE_DISABLE_AUTO_MEMORY`, o campo `memory` não tem efeito e o subagente é iniciado sem as instruções de memória ou o acesso às ferramentas de memória descritos abaixo.

669 669 

670Quando a memória está habilitada:670Quando a memória está habilitada:

671 671 

672* O prompt de sistema do subagente inclui instruções para ler e escrever no diretório de memória.672* O system prompt do subagente inclui instruções para ler e gravar no diretório de memória.

673* O prompt de sistema do subagente também inclui as primeiras 200 linhas ou 25KB de `MEMORY.md` no diretório de memória, o que for menor, com instruções para curar `MEMORY.md` se exceder esse limite.673* O system prompt do subagente também inclui as primeiras 200 linhas ou 25KB de `MEMORY.md` no diretório de memória, o que ocorrer primeiro, com instruções para organizar o `MEMORY.md` se ele exceder esse limite.

674* Ferramentas Read, Write e Edit são automaticamente habilitadas para que o subagente possa gerenciar seus arquivos de memória.674* As ferramentas Read, Write e Edit são habilitadas automaticamente para que o subagente possa gerenciar seus arquivos de memória.

675 675 

676<h5 id="persistent-memory-tips">676<h5 id="persistent-memory-tips">

677 Dicas de memória persistente677 Dicas de memória persistente

678</h5>678</h5>

679 679 

680* `project` é o escopo padrão recomendado. Ele torna o conhecimento do subagente compartilhável via controle de versão.680* `project` é o escopo padrão recomendado. Ele torna o conhecimento do subagente compartilhável via controle de versão.

681* Peça ao subagente para consultar sua memória antes de começar o trabalho: "Review this PR, and check your memory for patterns you've seen before."681* Peça ao subagente para consultar sua memória antes de começar o trabalho: "Revise este PR e verifique sua memória em busca de padrões que você já viu antes."

682* Peça ao subagente para atualizar sua memória após completar uma tarefa: "Now that you're done, save what you learned to your memory." Ao longo do tempo, isso constrói uma base de conhecimento que torna o subagente mais eficaz.682* Peça ao subagente para atualizar sua memória após concluir uma tarefa: "Agora que você terminou, salve o que aprendeu na sua memória." Com o tempo, isso cria uma base de conhecimento que torna o subagente mais eficaz.

683* Inclua instruções de memória diretamente no arquivo markdown do subagente para que ele mantenha proativamente sua própria base de conhecimento:683* Inclua instruções de memória diretamente no arquivo markdown do subagente para que ele mantenha proativamente sua própria base de conhecimento:

684 684 

685 ```markdown theme={null}685 ```markdown theme={null}


693 Regras condicionais com hooks693 Regras condicionais com hooks

694</h4>694</h4>

695 695 

696Para controle mais dinâmico sobre uso de ferramentas, use hooks `PreToolUse` para validar operações antes de serem executadas. Isso é útil quando você precisa permitir algumas operações de uma ferramenta enquanto bloqueia outras.696Para um controle mais dinâmico sobre o uso de ferramentas, use hooks `PreToolUse` para validar operações antes que sejam executadas. Isso é útil quando você precisa permitir algumas operações de uma ferramenta enquanto bloqueia outras.

697 697 

698Este exemplo cria um subagente que apenas permite consultas de banco de dados somente leitura. O hook `PreToolUse` executa o script especificado em `command` antes de cada comando Bash ser executado:698Este exemplo cria um subagente que permite apenas consultas de banco de dados somente leitura. O hook `PreToolUse` executa o script especificado em `command` antes de cada comando Bash ser executado:

699 699 

700```yaml theme={null}700```yaml theme={null}

701---701---


711---711---

712```712```

713 713 

714Claude Code [passa entrada de hook como JSON](/docs/pt/hooks#pretooluse-input) via stdin para comandos de hook. O script de validação lê este JSON, extrai o comando Bash e [sai com código 2](/docs/pt/hooks#exit-code-2-behavior-per-event) para bloquear operações de escrita:714O Claude Code [passa a entrada do hook como JSON](/docs/pt/hooks#pretooluse-input) via stdin para os comandos de hook. O script de validação lê esse JSON, extrai o comando Bash e [sai com código 2](/docs/pt/hooks#exit-code-2-behavior-per-event) para bloquear operações de escrita:

715 715 

716```bash theme={null}716```bash theme={null}

717#!/bin/bash717#!/bin/bash


729exit 0729exit 0

730```730```

731 731 

732Em macOS e Linux, torne o script executável, ou o hook falha em vez de bloquear qualquer coisa:732No macOS e no Linux, torne o script executável, caso contrário o hook falha em vez de bloquear algo:

733 733 

734```bash theme={null}734```bash theme={null}

735chmod +x ./scripts/validate-readonly-query.sh735chmod +x ./scripts/validate-readonly-query.sh

736```736```

737 737 

738Para testar a regra, peça ao subagente para executar uma instrução `UPDATE`: o script sai com código 2, Claude Code bloqueia o comando, e o subagente vê a mensagem `Blocked: Only SELECT queries are allowed`.738Para testar a regra, peça ao subagente para executar uma instrução `UPDATE`: o script sai com código 2, o Claude Code bloqueia o comando e o subagente vê a mensagem `Blocked: Only SELECT queries are allowed`.

739 739 

740Veja [Hook input](/docs/pt/hooks#pretooluse-input) para o schema de entrada completo e [exit codes](/docs/pt/hooks#exit-code-output) para como códigos de saída afetam o comportamento. No Windows, escreva scripts de hook em PowerShell e adicione `shell: powershell` à entrada de hook conforme mostrado em [executando hooks em PowerShell](/docs/pt/hooks#windows-powershell-tool).740Consulte [Entrada do hook](/docs/pt/hooks#pretooluse-input) para o esquema de entrada completo e [códigos de saída](/docs/pt/hooks#exit-code-output) para saber como os códigos de saída afetam o comportamento. No Windows, escreva scripts de hook em PowerShell e adicione `shell: powershell` à entrada do hook, conforme mostrado em [executar hooks no PowerShell](/docs/pt/hooks#windows-powershell-tool).

741 741 

742<h4 id="disable-specific-subagents">742<h4 id="disable-specific-subagents">

743 Desabilitar subagentes específicos743 Desabilitar subagentes específicos

744</h4>744</h4>

745 745 

746Você pode impedir que Claude use subagentes específicos adicionando-os ao array `deny` em suas [configurações](/docs/pt/settings-reference#permission-settings). Use o formato `Agent(subagent-name)` onde `subagent-name` corresponde ao campo name do subagente.746Você pode impedir que o Claude use subagentes específicos adicionando-os ao array `deny` nas suas [configurações](/docs/pt/settings-reference#permission-settings). Use o formato `Agent(subagent-name)`, em que `subagent-name` corresponde ao campo name do subagente.

747 747 

748```json theme={null}748```json theme={null}

749{749{


753}753}

754```754```

755 755 

756Isso funciona para subagentes integrados e personalizados. Você também pode usar o flag CLI `--disallowedTools`:756Isso funciona tanto para subagentes integrados quanto personalizados. Você também pode usar a flag de CLI `--disallowedTools`:

757 757 

758```bash theme={null}758```bash theme={null}

759claude --disallowedTools "Agent(Explore)"759claude --disallowedTools "Agent(Explore)"

760```760```

761 761 

762Veja [documentação de Permissões](/docs/pt/permissions#tool-specific-permission-rules) para mais detalhes sobre regras de permissão.762Consulte a [documentação de permissões](/docs/pt/permissions#tool-specific-permission-rules) para mais detalhes sobre regras de permissão.

763 763 

764<h3 id="define-hooks-for-subagents">764<h3 id="define-hooks-for-subagents">

765 Definir hooks para subagentes765 Definir hooks para subagentes

766</h3>766</h3>

767 767 

768Subagentes podem definir [hooks](/docs/pt/hooks) que são executados durante o ciclo de vida do subagente. Existem duas formas de configurar hooks:768Os subagentes podem definir [hooks](/docs/pt/hooks) que são executados durante o ciclo de vida do subagente. Há duas maneiras de configurar hooks:

769 769 

770* **No frontmatter do subagente**: defina hooks que são executados apenas enquanto esse subagente específico está ativo770* **No frontmatter do subagente**: defina hooks que são executados apenas enquanto esse subagente está ativo

771* **Em `settings.json`**: defina hooks em toda a sessão que também disparam dentro de subagentes. Eventos de ferramentas como `PreToolUse` e `PostToolUse` disparam para as chamadas de ferramentas do subagente da mesma forma que na conversa principal, e `SubagentStart` e `SubagentStop` disparam quando um subagente inicia ou termina771* **Em `settings.json`**: defina hooks de toda a sessão que também disparam dentro dos subagentes. Eventos de ferramentas como `PreToolUse` e `PostToolUse` disparam para as chamadas de ferramenta do subagente da mesma forma que na conversa principal, e `SubagentStart` e `SubagentStop` disparam quando um subagente começa ou termina

772 772 

773Hooks de [arquivos de configurações, configurações de política gerenciada e plugins](/docs/pt/hooks#hook-locations) todos se aplicam dentro de subagentes, portanto um hook `PreToolUse` em `settings.json` também é executado antes de cada ferramenta que um subagente usa.773Os hooks de [arquivos de configurações, configurações de política gerenciada e plugins](/docs/pt/hooks#hook-locations) se aplicam todos dentro dos subagentes, de modo que um hook `PreToolUse` em `settings.json` também é executado antes de cada ferramenta que um subagente usa.

774 774 

775<h4 id="hooks-in-subagent-frontmatter">775<h4 id="hooks-in-subagent-frontmatter">

776 Hooks no frontmatter do subagente776 Hooks no frontmatter do subagente

777</h4>777</h4>

778 778 

779Defina hooks diretamente no arquivo markdown do subagente. Estes hooks são executados apenas enquanto esse subagente específico está ativo e são limpos quando termina.779Defina hooks diretamente no arquivo markdown do subagente. Esses hooks são executados apenas enquanto aquele subagente específico está ativo e são removidos quando ele termina.

780 780 

781<Note>781<Note>

782 Hooks de frontmatter disparam quando o agente é gerado como um subagente através da ferramenta Agent ou uma @-menção, e quando o agente é executado como a sessão principal via [`--agent`](#invoke-subagents-explicitly) ou a configuração `agent`. No caso de sessão principal, eles são executados junto com qualquer hook definido em [`settings.json`](/docs/pt/hooks).782 Os hooks do frontmatter disparam quando o agente é criado como subagente por meio da ferramenta Agent ou de uma @-menção, e quando o agente é executado como sessão principal via [`--agent`](#invoke-subagents-explicitly) ou a configuração `agent`. No caso da sessão principal, eles são executados junto com quaisquer hooks definidos em [`settings.json`](/docs/pt/hooks).

783</Note>783</Note>

784 784 

785Para permitir que os hooks de frontmatter de um subagente no nível do projeto sejam executados, aceite o [diálogo de confiança do espaço de trabalho](/docs/pt/permissions#project-allow-rules-and-workspace-trust) para a pasta que contém o arquivo do agente. Hooks de subagentes no nível do usuário em `~/.claude/agents/` e de definições que você passa com `--agents` são executados sem esta etapa. Se você adicionou uma pasta com `--add-dir` de fora do repositório do espaço de trabalho confiável de sua organização, confie nessa pasta separadamente: seus hooks `.claude/agents/` não herdam a confiança do espaço de trabalho.785Para permitir que os hooks do frontmatter de um subagente de nível de projeto sejam executados, aceite a [caixa de diálogo de confiança do workspace](/docs/pt/permissions#project-allow-rules-and-workspace-trust) para a pasta que contém o arquivo do agente. Os hooks de subagentes de nível de usuário em `~/.claude/agents/` e de definições que você passa com `--agents` são executados sem essa etapa. Se você adicionou uma pasta com `--add-dir` de fora do repositório do seu workspace confiável, confie nessa pasta separadamente: os hooks do seu `.claude/agents/` não herdam a concessão do workspace.

786 786 

787Até que você confie na pasta, o subagente ainda é executado, mas Claude Code pula seus hooks de frontmatter e registra um erro no log de debug explicando como confiar na pasta. Esta é uma regra mais rigorosa do que a para hooks em arquivos de configurações: confiar em uma pasta pai não é suficiente, e uma sessão `-p` não conta como confiável. [O que é executado antes de você confiar em uma pasta](/docs/pt/permissions#what-runs-before-you-trust-a-folder) compara os dois. Antes da v2.1.218, hooks de frontmatter podiam ser executados de pastas que você não tinha confiado, incluindo em sessões não interativas.787Até que você confie na pasta, o subagente ainda é executado, mas o Claude Code ignora seus hooks de frontmatter e registra no log de depuração um erro explicando como confiar na pasta. Esta é uma regra mais rigorosa do que a dos hooks em arquivos de configurações: confiar em uma pasta pai não é suficiente, e uma sessão `-p` não conta como confiável. [O que é executado antes de você confiar em uma pasta](/docs/pt/permissions#what-runs-before-you-trust-a-folder) compara as duas. Antes da v2.1.218, os hooks do frontmatter podiam ser executados a partir de pastas em que você não havia confiado, inclusive em sessões não interativas.

788 788 

789Todos os [eventos de hook](/docs/pt/hooks#hook-events) são suportados. Os eventos mais comuns para subagentes são:789Todos os [eventos de hook](/docs/pt/hooks#hook-events) são suportados. Os eventos mais comuns para subagentes são:

790 790 

791| Event | Matcher input | When it fires |791| Evento | Entrada do matcher | Quando dispara |

792| :- | :- | :- |792| :- | :- | :- |

793| `PreToolUse` | Nome da ferramenta | Antes do subagente usar uma ferramenta |793| `PreToolUse` | Nome da ferramenta | Antes de o subagente usar uma ferramenta |

794| `PostToolUse` | Nome da ferramenta | Depois do subagente usar uma ferramenta |794| `PostToolUse` | Nome da ferramenta | Depois de o subagente usar uma ferramenta |

795| `Stop` | (nenhum) | Quando o subagente termina (convertido para `SubagentStop` em tempo de execução) |795| `Stop` | (nenhuma) | Quando o subagente termina (convertido em `SubagentStop` em tempo de execução) |

796 796 

797Este exemplo valida comandos Bash com o hook `PreToolUse` e executa um linter após edições de arquivo com `PostToolUse`:797Este exemplo valida comandos Bash com o hook `PreToolUse` e executa um linter após edições de arquivos com `PostToolUse`:

798 798 

799```yaml theme={null}799```yaml theme={null}

800---800---


814---814---

815```815```

816 816 

817Quando o agente é invocado como um subagente, hooks `Stop` no frontmatter são automaticamente convertidos para eventos `SubagentStop`.817Quando o agente é invocado como subagente, os hooks `Stop` no frontmatter são convertidos automaticamente em eventos `SubagentStop`.

818 818 

819<h4 id="project-level-hooks-for-subagent-events">819<h4 id="project-level-hooks-for-subagent-events">

820 Hooks no nível do projeto para eventos de subagente820 Hooks de nível de projeto para eventos de subagentes

821</h4>821</h4>

822 822 

823Configure hooks em `settings.json` que respondem a eventos de ciclo de vida de subagente na sessão principal.823Configure hooks em `settings.json` que respondem a eventos do ciclo de vida de subagentes na sessão principal.

824 824 

825| Event | Matcher input | When it fires |825| Evento | Entrada do matcher | Quando dispara |

826| :- | :- | :- |826| :- | :- | :- |

827| `SubagentStart` | Nome do tipo de agente | Quando um subagente começa a execução |827| `SubagentStart` | Nome do tipo de agente | Quando um subagente inicia a execução |

828| `SubagentStop` | Nome do tipo de agente | Quando um subagente completa |828| `SubagentStop` | Nome do tipo de agente | Quando um subagente é concluído |

829 829 

830Ambos os eventos suportam matchers para direcionar tipos de agente específicos por nome. O valor do matcher é o `name` do frontmatter do agente para subagentes no nível de projeto e usuário, ou o identificador com escopo de plugin como `my-plugin:db-agent` para [subagentes de plugin](/docs/pt/plugins/components#agents). Um nome com escopo contém dois-pontos, portanto é avaliado como uma [expressão regular sem âncora](/docs/pt/hooks#matcher-patterns); ancorá-lo com `^` e `$`, como em `^my-plugin:db-agent$`, para corresponder apenas a esse agente.830Ambos os eventos suportam matchers para direcionar tipos de agentes específicos pelo nome. O valor do matcher é o `name` do frontmatter do agente para subagentes de nível de projeto e de nível de usuário, ou o identificador com escopo de plugin, como `my-plugin:db-agent`, para [subagentes de plugin](/docs/pt/plugins/components#agents). Um nome com escopo contém dois-pontos, então é avaliado como uma [expressão regular não ancorada](/docs/pt/hooks#matcher-patterns); ancore-o com `^` e `$`, como em `^my-plugin:db-agent$`, para corresponder apenas a esse agente.

831 831 

832Este exemplo executa um script de configuração apenas quando o subagente `db-agent` inicia, e um script de limpeza quando qualquer subagente para:832Este exemplo executa um script de configuração apenas quando o subagente `db-agent` é iniciado, e um script de limpeza quando qualquer subagente para:

833 833 

834```json theme={null}834```json theme={null}

835{835{


853}853}

854```854```

855 855 

856Veja [Hooks](/docs/pt/hooks) para o formato de configuração de hook completo.856Consulte [Hooks](/docs/pt/hooks) para o formato completo de configuração de hooks.

857 857 

858<h2 id="work-with-subagents">858<h2 id="work-with-subagents">

859 Trabalhar com subagentes859 Trabalhar com subagentes


988 988 

989Um subagente cuja execução termina em um erro de API, como um limite de uso ou um erro de servidor repetido, relata essa falha de volta a Claude. O que Claude recebe depende de onde o subagente foi executado:989Um subagente cuja execução termina em um erro de API, como um limite de uso ou um erro de servidor repetido, relata essa falha de volta a Claude. O que Claude recebe depende de onde o subagente foi executado:

990 990 

991* **Primeiro plano**: se um rate limit, sobrecarga ou erro de servidor interromper um subagente que já produziu saída de texto, a ferramenta Agent retorna essa saída parcial com uma nota de que o subagente foi interrompido e não completou sua tarefa. Um subagente que não produziu nada, ou cuja única saída foram chamadas de ferramenta, falha com [`Agent terminated early due to an API error`](/docs/pt/errors#agent-terminated-early-due-to-an-api-error), seguido pelo detalhe do erro. Na v2.1.199, um rate limit, sobrecarga ou erro de servidor que interrompeu a forma de chamadas de ferramenta apenas retornou um resultado parcial vazio contendo apenas a nota de interrupção.991* **Primeiro plano**: se um rate limit, sobrecarga ou erro de servidor interromper um subagente que já produziu saída de texto, a ferramenta Agent retorna essa saída parcial com uma nota de que o subagente foi interrompido e não completou sua tarefa. Um subagente que não produziu nada, ou cuja única saída foram chamadas de ferramenta, falha com [`Agent terminated early due to an API error`](/docs/pt/errors#agent-terminated-early-due-to-an-api-error), seguido pelo detalhe do erro.

992* **Segundo plano**: o subagente é marcado como com falha, e a mensagem que Claude recebe quando termina nomeia o erro de API e inclui a última saída do subagente, para que o trabalho parcial não seja perdido.992* **Segundo plano**: o subagente é marcado como com falha, e a mensagem que Claude recebe quando termina nomeia o erro de API e inclui a última saída do subagente, para que o trabalho parcial não seja perdido.

993 993 

994Quando você configura uma [cadeia de modelo de fallback](/docs/pt/model-config#fallback-model-chains) e um subagente encontra uma falha que a cadeia cobre, como seu modelo estar indisponível, Claude Code muda o subagente para o primeiro modelo na cadeia que aceita a requisição. O subagente continua trabalhando em vez de terminar no erro.994Quando você configura uma [cadeia de modelo de fallback](/docs/pt/model-config#fallback-model-chains) e um subagente encontra uma falha que a cadeia cobre, como seu modelo estar indisponível, Claude Code muda o subagente para o primeiro modelo na cadeia que aceita a requisição. O subagente continua trabalhando em vez de terminar no erro.

Details

227 Investir em documentação e memória227 Investir em documentação e memória

228</h3>228</h3>

229 229 

230Recomendamos fortemente investir em documentação para que Claude Code compreenda sua base de código. As organizações podem implantar arquivos CLAUDE.md em múltiplos níveis. Veja [onde os arquivos CLAUDE.md podem estar](/docs/pt/memory#choose-where-to-put-claude-md-files) e [como implantar um CLAUDE.md em toda a organização](/docs/pt/memory#deploy-organization-wide-claude-md).230Invista em documentação para que Claude Code compreenda sua base de código. As organizações podem implantar arquivos CLAUDE.md em múltiplos níveis. Veja [onde os arquivos CLAUDE.md podem estar](/docs/pt/memory#choose-where-to-put-claude-md-files) e [como implantar um CLAUDE.md em toda a organização](/docs/pt/memory#deploy-organization-wide-claude-md).

231 231 

232<h3 id="simplify-deployment">232<h3 id="simplify-deployment">

233 Simplificar a implantação233 Simplificar a implantação

234</h3>234</h3>

235 235 

236Se você tiver um ambiente de desenvolvimento personalizado, descobrimos que criar uma maneira "com um clique" de instalar Claude Code é fundamental para aumentar a adoção em toda uma organização.236Se você tiver um ambiente de desenvolvimento personalizado, criar uma maneira "com um clique" de instalar Claude Code é fundamental para aumentar a adoção em toda uma organização.

237 237 

238<h3 id="start-with-guided-usage">238<h3 id="start-with-guided-usage">

239 Começar com uso orientado239 Começar com uso orientado


259 Usar MCP para integrações259 Usar MCP para integrações

260</h3>260</h3>

261 261 

262MCP é uma ótima maneira de dar a Claude Code mais informações, como conectar a sistemas de gerenciamento de tickets ou logs de erro. Recomendamos que uma equipe central configure servidores MCP e verifique uma configuração `.mcp.json` na base de código para que todos os usuários se beneficiem. [Saiba mais](/docs/pt/mcp).262MCP é uma ótima maneira de dar a Claude Code mais informações, como conectar a sistemas de gerenciamento de tickets ou logs de erro. Faça com que uma equipe central configure servidores MCP e adicione uma configuração `.mcp.json` à base de código para que todos os usuários se beneficiem. [Saiba mais](/docs/pt/mcp).

263 263 

264<h2 id="next-steps">264<h2 id="next-steps">

265 Próximas etapas265 Próximas etapas

tools-reference.md +39 −39

Details

33| `ExitWorktree` | Sai de uma sessão de worktree e retorna ao diretório original. Não disponível para subagentes que já executam em seu próprio diretório de trabalho, como com [`isolation: worktree`](/docs/pt/sub-agents#supported-frontmatter-fields) | Não |33| `ExitWorktree` | Sai de uma sessão de worktree e retorna ao diretório original. Não disponível para subagentes que já executam em seu próprio diretório de trabalho, como com [`isolation: worktree`](/docs/pt/sub-agents#supported-frontmatter-fields) | Não |

34| `Glob` | Encontra arquivos com base em correspondência de padrões. Ausente por padrão no macOS, Linux e WSL. Veja [Comportamento da ferramenta Glob](#glob-tool-behavior) | Não |34| `Glob` | Encontra arquivos com base em correspondência de padrões. Ausente por padrão no macOS, Linux e WSL. Veja [Comportamento da ferramenta Glob](#glob-tool-behavior) | Não |

35| `Grep` | Pesquisa padrões no conteúdo de arquivos. Ausente por padrão no macOS, Linux e WSL. Veja [Comportamento da ferramenta Grep](#grep-tool-behavior) | Não |35| `Grep` | Pesquisa padrões no conteúdo de arquivos. Ausente por padrão no macOS, Linux e WSL. Veja [Comportamento da ferramenta Grep](#grep-tool-behavior) | Não |

36| `ListAgents` | Lista os agentes que Claude pode enviar mensagens com `SendMessage`: subagentes na sessão, [colegas de equipe](/docs/pt/agent-teams) de equipe de agentes, suas outras sessões locais de Claude Code e, enquanto esta sessão está conectada a [Controle Remoto](/docs/pt/remote-control), suas sessões de [Claude Code na web](/docs/pt/claude-code-on-the-web) e suas sessões de Controle Remoto em outras máquinas. Respalda o comando `/list-agents`. Veja [mensagens entre sessões](/docs/pt/cross-session-messaging). Requer Claude Code v2.1.224 ou posterior e aparece apenas em sessões onde [mensagens entre sessões estão ativadas](/docs/pt/cross-session-messaging#availability). Linhas de colegas de equipe e a primeira linha mostrando o próprio nome desta sessão requerem v2.1.239 ou posterior | Não |36| `ListAgents` | Lista os agentes que Claude pode enviar mensagens com `SendMessage`: subagentes na sessão, [colegas de equipe](/docs/pt/agent-teams) de equipe de agentes, suas outras sessões locais de Claude Code e, enquanto esta sessão está conectada a [Controle Remoto](/docs/pt/remote-control), suas [sessões na nuvem](/docs/pt/claude-code-on-the-web) e suas sessões de Controle Remoto em outras máquinas. Respalda o comando `/list-agents`. Veja [mensagens entre sessões](/docs/pt/cross-session-messaging). Requer Claude Code v2.1.224 ou posterior e aparece apenas em sessões onde [mensagens entre sessões estão ativadas](/docs/pt/cross-session-messaging#availability). Linhas de colegas de equipe e a primeira linha mostrando o próprio nome desta sessão requerem v2.1.239 ou posterior | Não |

37| `ListMcpResourcesTool` | Lista recursos expostos por [servidores MCP](/docs/pt/mcp) conectados, deixando de fora [recursos da UI de MCP Apps](/docs/pt/mcp#reference-mcp-resources), que são páginas para um aplicativo host renderizar | Não |37| `ListMcpResourcesTool` | Lista recursos expostos por [servidores MCP](/docs/pt/mcp) conectados, deixando de fora [recursos da UI de MCP Apps](/docs/pt/mcp#reference-mcp-resources), que são páginas para um aplicativo host renderizar | Não |

38| `LSP` | Inteligência de código via servidores de linguagem: ir para definições, encontrar referências, relatar erros de tipo e avisos. Veja [Comportamento da ferramenta LSP](#lsp-tool-behavior) | Não |38| `LSP` | Inteligência de código via servidores de linguagem: ir para definições, encontrar referências, relatar erros de tipo e avisos. Veja [Comportamento da ferramenta LSP](#lsp-tool-behavior) | Não |

39| `Monitor` | Executa um comando em segundo plano e alimenta cada linha de saída de volta para Claude, para que ele possa reagir a entradas de log, mudanças de arquivo ou status consultado no meio da conversa. Também pode abrir um WebSocket e tratar cada mensagem recebida como um evento. Veja [Ferramenta Monitor](#monitor-tool) | Sim |39| `Monitor` | Executa um comando em segundo plano e alimenta cada linha de saída de volta para Claude, para que ele possa reagir a entradas de log, mudanças de arquivo ou status consultado no meio da conversa. Também pode abrir um WebSocket e tratar cada mensagem recebida como um evento. Veja [Ferramenta Monitor](#monitor-tool) | Sim |


43| `Read` | Lê o conteúdo de arquivos. Veja [Comportamento da ferramenta Read](#read-tool-behavior) | Não |43| `Read` | Lê o conteúdo de arquivos. Veja [Comportamento da ferramenta Read](#read-tool-behavior) | Não |

44| `ReadMcpResourceTool` | Lê um recurso MCP específico por URI | Não |44| `ReadMcpResourceTool` | Lê um recurso MCP específico por URI | Não |

45| `RemoteTrigger` | Cria, atualiza, executa e lista [Rotinas](/docs/pt/routines) no claude.ai. Respalda o comando `/schedule`. A [referência de entrada `RemoteTrigger`](/docs/pt/agent-sdk/typescript#remotetrigger) documenta cada ação e as políticas organizacionais que removem a ferramenta. Rotinas vivem no claude.ai e requerem um plano Pro, Max, Team ou Enterprise, então esta ferramenta não é acessível do Amazon Bedrock, Claude Platform na AWS, Agent Platform do Google Cloud ou Microsoft Foundry | Não |45| `RemoteTrigger` | Cria, atualiza, executa e lista [Rotinas](/docs/pt/routines) no claude.ai. Respalda o comando `/schedule`. A [referência de entrada `RemoteTrigger`](/docs/pt/agent-sdk/typescript#remotetrigger) documenta cada ação e as políticas organizacionais que removem a ferramenta. Rotinas vivem no claude.ai e requerem um plano Pro, Max, Team ou Enterprise, então esta ferramenta não é acessível do Amazon Bedrock, Claude Platform na AWS, Agent Platform do Google Cloud ou Microsoft Foundry | Não |

46| `ReportFindings` | Relata descobertas de revisão de código como uma lista estruturada, com um arquivo, resumo e cenário de falha por descoberta, para que Claude Code possa renderizá-las em vez de imprimi-las como texto. Claude a chama quando instruções ativas de revisão de código dizem para fazê-lo. Requer Claude Code v2.1.196 ou posterior. A partir da v2.1.199, uma descoberta também pode carregar um slug `category` opcional, como `correctness` ou `test-coverage`, mostrado ao lado da localização do arquivo na lista renderizada | Não |46| `ReportFindings` | Relata descobertas de revisão de código como uma lista estruturada, com um arquivo, resumo e cenário de falha por descoberta, para que Claude Code possa renderizá-las em vez de imprimi-las como texto. Claude a chama quando instruções ativas de revisão de código dizem para fazê-lo. Uma descoberta também pode carregar um slug `category` opcional, como `correctness` ou `test-coverage`, mostrado ao lado da localização do arquivo na lista renderizada | Não |

47| `ScheduleWakeup` | Reagenda a próxima iteração de um [`/loop` auto-paced](/docs/pt/scheduled-tasks#let-claude-choose-the-interval). Claude chama isso no final de cada iteração para escolher quando a próxima é executada, entre um minuto e uma hora; você não a chama diretamente. Para encerrar o loop em vez disso, Claude a chama com `stop: true`, que cancela o wakeup pendente. O campo `stop` requer Claude Code v2.1.202 ou posterior. O wakeup pendente aparece em `session_crons` em [Entrada do hook Stop](/docs/pt/hooks#stop-input) | Não |47| `ScheduleWakeup` | Reagenda a próxima iteração de um [`/loop` auto-paced](/docs/pt/scheduled-tasks#let-claude-choose-the-interval). Claude chama isso no final de cada iteração para escolher quando a próxima é executada, entre um minuto e uma hora; você não a chama diretamente. Para encerrar o loop em vez disso, Claude a chama com `stop: true`, que cancela o wakeup pendente. O campo `stop` requer Claude Code v2.1.202 ou posterior. O wakeup pendente aparece em `session_crons` em [Entrada do hook Stop](/docs/pt/hooks#stop-input) | Não |

48| `SendFeedback` | Redige um relatório de feedback sobre Claude Code, cobrindo um problema de produto ou o próprio comportamento de Claude na sessão, e o coloca na fila em sua máquina para você revisar. Claude Code não envia nada até que você escolha enviar o rascunho. Veja [Comportamento da ferramenta SendFeedback](#sendfeedback-tool-behavior). Requer Claude Code v2.1.238 ou posterior | Não |48| `SendFeedback` | Redige um relatório de feedback sobre Claude Code, cobrindo um problema de produto ou o próprio comportamento de Claude na sessão, e o coloca na fila em sua máquina para você revisar. Claude Code não envia nada até que você escolha enviar o rascunho. Veja [Comportamento da ferramenta SendFeedback](#sendfeedback-tool-behavior). Requer Claude Code v2.1.238 ou posterior | Não |

49| `SendMessage` | Envia uma mensagem para outro agente: um colega de equipe de [equipe de agentes](/docs/pt/agent-teams), um [subagente que ele retoma](/docs/pt/sub-agents#resume-subagents) por ID ou nome de agente, ou uma de suas outras sessões de Claude Code, nesta máquina ou além dela. Mensagens para outras sessões requerem Claude Code v2.1.224 ou posterior. [Mensagens entre sessões](/docs/pt/cross-session-messaging) cobrem quais sessões Claude pode alcançar, [como uma mensagem se parece quando chega](/docs/pt/cross-session-messaging#what-a-message-looks-like) e [como Claude recebe um aviso quando outra sessão fica inativa](/docs/pt/cross-session-messaging#get-a-notice-when-another-session-goes-idle). Claude pode incluir uma entrada `summary` opcional, normalmente 5-10 palavras, que Claude Code mostra como uma visualização de uma linha. Quando Claude a omite em uma [mensagem de texto simples](/docs/pt/cross-session-messaging#limitations), Claude Code usa a primeira linha da mensagem como resumo. Claude Code trunca um resumo mais longo que 200 caracteres com reticências | Não |49| `SendMessage` | Envia uma mensagem para outro agente: um colega de equipe de [equipe de agentes](/docs/pt/agent-teams), um [subagente que ele retoma](/docs/pt/sub-agents#resume-subagents) por ID ou nome de agente, ou uma de suas outras sessões de Claude Code, nesta máquina ou além dela. Mensagens para outras sessões requerem Claude Code v2.1.224 ou posterior. [Mensagens entre sessões](/docs/pt/cross-session-messaging) cobrem quais sessões Claude pode alcançar, [como uma mensagem se parece quando chega](/docs/pt/cross-session-messaging#what-a-message-looks-like) e [como Claude recebe um aviso quando outra sessão fica inativa](/docs/pt/cross-session-messaging#get-a-notice-when-another-session-goes-idle). Claude pode incluir uma entrada `summary` opcional, normalmente 5-10 palavras, que Claude Code mostra como uma visualização de uma linha. Quando Claude a omite em uma [mensagem de texto simples](/docs/pt/cross-session-messaging#limitations), Claude Code usa a primeira linha da mensagem como resumo. Claude Code trunca um resumo mais longo que 200 caracteres com reticências | Não |

50| `SendUserFile` | Envia arquivos da sessão para você com uma legenda opcional, para que um relatório gerado, diagrama, captura de tela ou artefato construído chegue ao seu dispositivo em vez de apenas ser mencionado na transcrição. A partir da v2.1.196, a entrada `display` opcional controla a apresentação: `render` abre o arquivo inline no cliente, `attach` mostra apenas um cartão de download e quando não definido o cliente decide por tipo de arquivo. Disponível quando um cliente [Controle Remoto](/docs/pt/remote-control) está conectado ou em uma [sessão na nuvem](/docs/pt/claude-code-on-the-web). A entrega é executada através de infraestrutura hospedada pela Anthropic, então a ferramenta não está disponível no Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry | Não |50| `SendUserFile` | Envia arquivos da sessão para você com uma legenda opcional, para que um relatório gerado, diagrama, captura de tela ou artefato construído chegue ao seu dispositivo em vez de apenas ser mencionado na transcrição. A entrada `display` opcional controla a apresentação: `render` abre o arquivo inline no cliente, `attach` mostra apenas um cartão de download e quando não definido o cliente decide por tipo de arquivo. Disponível quando um cliente de [Remote Control](/docs/pt/remote-control) está conectado ou em uma [sessão na nuvem](/docs/pt/claude-code-on-the-web). A entrega é executada através de infraestrutura hospedada pela Anthropic, então a ferramenta não está disponível no Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry | Não |

51| `ShareOnboardingGuide` | Carrega `ONBOARDING.md` e retorna um link de compartilhamento que colegas de equipe podem abrir no Claude Code. Chamado de `/team-onboarding` após o guia ser escrito. Disponível para assinantes do claude.ai nos planos Pro, Max, Team e Enterprise | Sim |51| `ShareOnboardingGuide` | Carrega `ONBOARDING.md` e retorna um link de compartilhamento que colegas de equipe podem abrir no Claude Code. Chamado de `/team-onboarding` após o guia ser escrito. Disponível para assinantes do claude.ai nos planos Pro, Max, Team e Enterprise | Sim |

52| `Skill` | Executa uma [skill](/docs/pt/skills#control-who-invokes-a-skill) dentro da conversa principal | Sim |52| `Skill` | Executa uma [skill](/docs/pt/skills#control-who-invokes-a-skill) dentro da conversa principal | Sim |

53| `SubagentHandback` | Entrega o relatório final de um subagente para qualquer conversa que receba o resultado desse subagente. Fornecido apenas em [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), para subagentes que a ferramenta Agent executa localmente, exceto [forks](/docs/pt/sub-agents#fork-the-current-conversation), e disponível no CLI do terminal, extensões IDE, sessões na nuvem e Agent SDK; o classificador revisa o relatório antes de ser entregue. Requer Claude Code v2.1.271 ou posterior | Não |53| `SubagentHandback` | Entrega o relatório final de um subagente para qualquer conversa que receba o resultado desse subagente. Fornecido apenas em [modo automático](/docs/pt/permission-modes#eliminate-prompts-with-auto-mode), para subagentes que a ferramenta Agent executa localmente, exceto [forks](/docs/pt/sub-agents#fork-the-current-conversation), e disponível no CLI do terminal, extensões IDE, sessões na nuvem e Agent SDK; o classificador revisa o relatório antes de ser entregue. Requer Claude Code v2.1.271 ou posterior | Não |


55| `TaskGet` | Recupera detalhes completos para uma tarefa específica. Fornecido por padrão apenas nos modelos listados em [Disponibilidade da ferramenta Task](#task-tool-availability) e em outros modelos quando você optar por participar | Não |55| `TaskGet` | Recupera detalhes completos para uma tarefa específica. Fornecido por padrão apenas nos modelos listados em [Disponibilidade da ferramenta Task](#task-tool-availability) e em outros modelos quando você optar por participar | Não |

56| `TaskList` | Lista todas as tarefas com seu status atual. Fornecido por padrão apenas nos modelos listados em [Disponibilidade da ferramenta Task](#task-tool-availability) e em outros modelos quando você optar por participar | Não |56| `TaskList` | Lista todas as tarefas com seu status atual. Fornecido por padrão apenas nos modelos listados em [Disponibilidade da ferramenta Task](#task-tool-availability) e em outros modelos quando você optar por participar | Não |

57| `TaskOutput` | Recupera saída de uma tarefa em segundo plano. Descontinuado em favor de `Read` no caminho do arquivo de saída da tarefa. Quando nenhuma tarefa corresponde ao ID, o erro lista os agentes de fundo em execução por ID e descrição. Antes da v2.1.203, o erro nomeava apenas o ID ausente | Não |57| `TaskOutput` | Recupera saída de uma tarefa em segundo plano. Descontinuado em favor de `Read` no caminho do arquivo de saída da tarefa. Quando nenhuma tarefa corresponde ao ID, o erro lista os agentes de fundo em execução por ID e descrição. Antes da v2.1.203, o erro nomeava apenas o ID ausente | Não |

58| `TaskStop` | Para uma tarefa em segundo plano em execução por ID. Também aceita um colega de equipe de [equipe de agentes](/docs/pt/agent-teams) ou um agente de fundo nomeado por ID ou nome de agente. Antes da v2.1.198, aceitava apenas um ID de tarefa em segundo plano. Quando nenhuma tarefa corresponde ao ID, o erro lista os agentes de fundo em execução por ID e descrição, incluindo agentes que outro agente gerou. Antes da v2.1.203, o erro listava colegas de equipe em execução e agentes nomeados, mas não agentes de fundo que outro agente gerou, então eles não podiam ser identificados ou parados da conversa principal | Não |58| `TaskStop` | Para uma tarefa em segundo plano em execução por ID. Também aceita um colega de equipe de [equipe de agentes](/docs/pt/agent-teams) ou um agente em segundo plano nomeado por ID ou nome de agente. Quando nenhuma tarefa corresponde ao ID, o erro lista os agentes em segundo plano em execução por ID e descrição, incluindo agentes que outro agente gerou. Antes da v2.1.203, o erro listava colegas de equipe em execução e agentes nomeados, mas não agentes em segundo plano que outro agente gerou, então eles não podiam ser identificados ou parados da conversa principal | Não |

59| `TaskUpdate` | Atualiza status da tarefa, dependências, detalhes ou deleta tarefas. Fornecido por padrão apenas nos modelos listados em [Disponibilidade da ferramenta Task](#task-tool-availability) e em outros modelos quando você optar por participar | Não |59| `TaskUpdate` | Atualiza status da tarefa, dependências, detalhes ou deleta tarefas. Fornecido por padrão apenas nos modelos listados em [Disponibilidade da ferramenta Task](#task-tool-availability) e em outros modelos quando você optar por participar | Não |

60| `TodoWrite` | Gerencia a lista de verificação de tarefas da sessão. Desativado por padrão em favor de `TaskCreate`, `TaskGet`, `TaskList` e `TaskUpdate`. Defina `CLAUDE_CODE_ENABLE_TASKS=0` para reativá-lo em [sessões que têm as ferramentas de rastreamento de tarefas](#task-tool-availability) | Não |60| `TodoWrite` | Gerencia a lista de verificação de tarefas da sessão. Desativado por padrão em favor de `TaskCreate`, `TaskGet`, `TaskList` e `TaskUpdate`. Defina `CLAUDE_CODE_ENABLE_TASKS=0` para reativá-lo em [sessões que têm as ferramentas de rastreamento de tarefas](#task-tool-availability) | Não |

61| `ToolSearch` | Pesquisa e carrega ferramentas adiadas quando [pesquisa de ferramentas](/docs/pt/mcp#scale-with-mcp-tool-search) está ativada | Não |61| `ToolSearch` | Pesquisa e carrega ferramentas adiadas quando [pesquisa de ferramentas](/docs/pt/mcp#scale-with-mcp-tool-search) está ativada | Não |


122Onde você vê os prompts de permissão de um subagente depende se ele executa em primeiro plano ou em segundo plano. Claude Code executa subagentes em segundo plano por padrão, além dos [casos que executam em primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background).122Onde você vê os prompts de permissão de um subagente depende se ele executa em primeiro plano ou em segundo plano. Claude Code executa subagentes em segundo plano por padrão, além dos [casos que executam em primeiro plano](/docs/pt/sub-agents#run-subagents-in-foreground-or-background).

123 123 

124* **Subagentes em primeiro plano** mostram os mesmos prompts de permissão que você veria na conversa principal, no momento em que cada chamada de ferramenta acontece.124* **Subagentes em primeiro plano** mostram os mesmos prompts de permissão que você veria na conversa principal, no momento em que cada chamada de ferramenta acontece.

125* **Subagentes em segundo plano** exibem prompts de permissão em sua sessão principal a partir da v2.1.186. O prompt nomeia qual subagente está solicitando, e pressionar Esc nega essa chamada de ferramenta sem parar o subagente. Antes da v2.1.186, subagentes em segundo plano negavam automaticamente qualquer chamada de ferramenta que de outra forma solicitaria e continuavam sem essa ferramenta.125* **Subagentes em segundo plano** exibem prompts de permissão em sua sessão principal. O prompt nomeia qual subagente está solicitando, e pressionar Esc nega essa chamada de ferramenta sem parar o subagente.

126 126 

127Para [limitar o que um subagente pode alcançar](/docs/pt/sub-agents#control-subagent-capabilities) em primeiro lugar, restrinja seu campo `tools`, por exemplo deixando Bash fora da lista, ou defina regras de negação em suas configurações.127Para [limitar o que um subagente pode alcançar](/docs/pt/sub-agents#control-subagent-capabilities) em primeiro lugar, restrinja seu campo `tools`, por exemplo deixando Bash fora da lista, ou defina regras de negação em suas configurações.

128 128 


132 132 

133Claude usa `AskUserQuestion` para fazer perguntas de múltipla escolha quando precisa de uma decisão ou esclarecimento. Responda escolhendo uma opção ou digite seu próprio texto através da linha `Other` ou do campo de notas.133Claude usa `AskUserQuestion` para fazer perguntas de múltipla escolha quando precisa de uma decisão ou esclarecimento. Responda escolhendo uma opção ou digite seu próprio texto através da linha `Other` ou do campo de notas.

134 134 

135Quando você responde digitando seu próprio texto, Claude Code retransmite a resposta com redação neutra para que Claude siga o que você escreveu, incluindo um pedido para aguardar ou explicar primeiro.135Quando você responde digitando seu próprio texto, Claude Code retransmite a resposta com redação neutra para que Claude siga o que você escreveu, incluindo uma solicitação para aguardar ou explicar primeiro.

136 136 

137<h3 id="question-auto-continue-timeout">137<h3 id="question-auto-continue-timeout">

138 Tempo limite de continuação automática de perguntas138 Timeout de continuação automática de perguntas

139</h3>139</h3>

140 140 

141As perguntas permanecem abertas até que você as responda. Se você quiser que uma pergunta que deixar sem resposta eventualmente feche e permita que Claude continue sem você, defina a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout) como `60s`, `5m` ou `10m`, seja no seu `settings.json` do usuário ou na linha **Question auto-continue timeout** em `/config`.141As perguntas permanecem abertas até que você as responda. Se você quiser que uma pergunta que deixar sem resposta eventualmente feche e permita que Claude continue sem você, defina a configuração [`askUserQuestionTimeout`](/docs/pt/settings-reference#askuserquestiontimeout) como `60s`, `5m` ou `10m`, seja no seu `settings.json` do usuário ou na linha **Question auto-continue timeout** em `/config`.

142 142 

143Depois que uma pergunta fica tanto tempo sem entrada, o diálogo fecha automaticamente: ele envia todas as opções que você já havia selecionado e diz a Claude que você pode estar longe do teclado, então Claude procede com seu próprio julgamento e pode fazer perguntas novamente mais tarde. Você vê uma contagem regressiva nos últimos 20 segundos. Pressione qualquer tecla para reiniciar o temporizador. Enquanto seu terminal relatar que a janela dele está em foco, o temporizador não faz a contagem regressiva.143Depois que uma pergunta fica tanto tempo sem entrada, o diálogo fecha automaticamente: ele envia todas as opções que você já havia selecionado e diz a Claude que você pode estar longe do teclado, então Claude procede com seu próprio julgamento e pode fazer perguntas novamente mais tarde. Você vê uma contagem regressiva nos últimos 20 segundos. Pressione qualquer tecla para reiniciar o temporizador. Enquanto seu terminal relatar que a janela dele está em foco, o temporizador não faz a contagem regressiva.

144 144 

145O temporizador nunca é iniciado para uma pergunta que Claude faz em uma [sessão em segundo plano](/docs/pt/agent-view), no [modo de leitor de tela](/docs/pt/accessibility) ou enquanto a sessão está conectada ao [Remote Control](/docs/pt/remote-control). Essas perguntas aguardam até que você as responda. O tempo limite se aplica apenas às perguntas de múltipla escolha do `AskUserQuestion`; prompts de permissão, incluindo aprovação de plano, nunca se resolvem automaticamente quando inativo.145O temporizador nunca é iniciado para uma pergunta que Claude faz em uma [sessão em segundo plano](/docs/pt/agent-view), no [modo de leitor de tela](/docs/pt/accessibility) ou enquanto a sessão está conectada ao [Remote Control](/docs/pt/remote-control). Essas perguntas aguardam até que você as responda. O timeout se aplica apenas às perguntas de múltipla escolha do `AskUserQuestion`; prompts de permissão, incluindo aprovação de plano, nunca se resolvem automaticamente quando inativo.

146 146 

147<h2 id="bash-tool-behavior">147<h2 id="bash-tool-behavior">

148 Comportamento da ferramenta Bash148 Comportamento da ferramenta Bash


315 * sessões através dos pacotes TypeScript e Python do [Agent SDK](/docs/pt/agent-sdk/overview)315 * sessões através dos pacotes TypeScript e Python do [Agent SDK](/docs/pt/agent-sdk/overview)

316 * o painel da [extensão VS Code](/docs/pt/vs-code), que agrupa sua própria CLI316 * o painel da [extensão VS Code](/docs/pt/vs-code), que agrupa sua própria CLI

317 * [GitHub Actions](/docs/pt/github-actions)317 * [GitHub Actions](/docs/pt/github-actions)

318 * [Claude Code na web](/docs/pt/claude-code-on-the-web)318 * [sessões na nuvem](/docs/pt/claude-code-on-the-web)

319* **Modo de inicialização**: não uma sessão [`--bare`](/docs/pt/headless#start-faster-with-bare-mode). O modo bare carrega apenas ferramentas de shell e arquivo, portanto a ferramenta nunca é registrada lá.319* **Modo de inicialização**: não uma sessão [`--bare`](/docs/pt/headless#start-faster-with-bare-mode). O modo bare carrega apenas ferramentas de shell e arquivo, portanto a ferramenta nunca é registrada lá.

320* **Provedor**: não disponível em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) ou [Microsoft Foundry](/docs/pt/microsoft-foundry), ou em sessões conectadas através de um [cloud gateway](/docs/pt/claude-apps-gateway).320* **Provedor**: não disponível em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) ou [Microsoft Foundry](/docs/pt/microsoft-foundry), ou em sessões conectadas através de um [cloud gateway](/docs/pt/claude-apps-gateway).

321 321 


512 512 

513O mesmo comportamento de redefinição de diretório de trabalho da sessão principal descrito na seção da ferramenta Bash se aplica aos comandos PowerShell, incluindo a variável de ambiente `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.513O mesmo comportamento de redefinição de diretório de trabalho da sessão principal descrito na seção da ferramenta Bash se aplica aos comandos PowerShell, incluindo a variável de ambiente `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.

514 514 

515A partir da v2.1.196, o código de saída 1 de `grep`, `rg`, `egrep`, `fgrep`, `findstr` e `git grep` significa nenhuma correspondência. O código de saída 1 de `git diff` significa que existem diferenças. Nenhum resultado é relatado ao Claude como uma falha de comando. Para `robocopy`, códigos de saída de 0 a 7 são resultados informativos, como arquivos copiados ou arquivos extras detectados. Códigos de saída de 8 ou superior contam como falhas.515O código de saída 1 de `grep`, `rg`, `egrep`, `fgrep`, `findstr` e `git grep` significa nenhuma correspondência. O código de saída 1 de `git diff` significa que existem diferenças. Nenhum resultado é relatado ao Claude como uma falha de comando. Para `robocopy`, códigos de saída de 0 a 7 são resultados informativos, como arquivos copiados ou arquivos extras detectados. Códigos de saída de 8 ou superior contam como falhas.

516 516 

517<h3 id="windows-encoding-and-exit-codes">517<h3 id="windows-encoding-and-exit-codes">

518 Codificação do Windows e códigos de saída518 Codificação do Windows e códigos de saída


551 551 

552Read lida com vários tipos de arquivo além de texto simples:552Read lida com vários tipos de arquivo além de texto simples:

553 553 

554* **Imagens**: PNG, JPG e outros formatos de imagem são retornados como conteúdo visual que Claude pode ver, não como bytes brutos. Claude Code redimensiona e recompacta imagens grandes para se adequarem aos limites de tamanho de imagem do modelo antes de enviá-las, então Claude pode ver uma versão reduzida de uma captura de tela grande. A partir da v2.1.196, uma imagem que ainda é maior que 500KB após esse redimensionamento é re-codificada como JPEG com qualidade reduzida com suas dimensões de pixel inalteradas. Se Claude perder detalhes de nível de pixel fino em uma imagem grande, peça-lhe para cortar a região de interesse primeiro, por exemplo com ImageMagick via Bash.554* **Imagens**: PNG, JPG e outros formatos de imagem são retornados como conteúdo visual que Claude pode ver, não como bytes brutos. Claude Code redimensiona e recompacta imagens grandes para se adequarem aos limites de tamanho de imagem do modelo antes de enviá-las, então Claude pode ver uma versão reduzida de uma captura de tela grande. Uma imagem que ainda é maior que 500KB após esse redimensionamento é re-codificada como JPEG com qualidade reduzida com suas dimensões de pixel inalteradas. Se Claude perder detalhes de nível de pixel fino em uma imagem grande, peça-lhe para cortar a região de interesse primeiro, por exemplo com ImageMagick via Bash.

555* **PDFs**: Claude lê arquivos `.pdf` curtos por inteiro. Para PDFs com mais de 10 páginas, ele lê em intervalos com um parâmetro `pages`, como `"1-5"`, até 20 páginas por vez. Leituras de intervalo de páginas renderizam páginas com `pdftoppm` do poppler-utils, então instale-o com `brew install poppler` no macOS ou `apt-get install poppler-utils` no Debian e Ubuntu. No Windows e outras plataformas, instale uma compilação do poppler que coloque `pdftoppm` no seu `PATH`. Sem ele, uma leitura de intervalo de páginas falha com `pdftoppm is not installed`.555* **PDFs**: Claude lê arquivos `.pdf` curtos por inteiro. Para PDFs com mais de 10 páginas, ele lê em intervalos com um parâmetro `pages`, como `"1-5"`, até 20 páginas por vez. Leituras de intervalo de páginas renderizam páginas com `pdftoppm` do poppler-utils, então instale-o com `brew install poppler` no macOS ou `apt-get install poppler-utils` no Debian e Ubuntu. No Windows e outras plataformas, instale uma compilação do poppler que coloque `pdftoppm` no seu `PATH`. Sem ele, uma leitura de intervalo de páginas falha com `pdftoppm is not installed`.

556* **Notebooks Jupyter**: arquivos `.ipynb` retornam todas as células com suas saídas, incluindo código, markdown e visualizações. Claude Code recusa-se a ler um arquivo de notebook com mais de 100 MB; o erro informa a Claude como ler uma porção do notebook em vez disso, como uma fatia de células, com um comando shell.556* **Notebooks Jupyter**: arquivos `.ipynb` retornam todas as células com suas saídas, incluindo código, markdown e visualizações. Claude Code recusa-se a ler um arquivo de notebook com mais de 100 MB; o erro informa a Claude como ler uma porção do notebook em vez disso, como uma fatia de células, com um comando shell.

557 557 


561 Comportamento da ferramenta SendFeedback561 Comportamento da ferramenta SendFeedback

562</h2>562</h2>

563 563 

564O feedback redigido por Claude é um relatório de feedback sobre Claude Code que Claude escreve para você. Requer Claude Code v2.1.238 ou posterior. Claude Code salva cada rascunho em sua máquina em `~/.claude/feedback/drafts/`, e nada chega à Anthropic até que você o envie. Claude redige um com a ferramenta SendFeedback quando:564O feedback redigido pelo Claude é um relatório de feedback sobre o Claude Code que o Claude escreve para você. Ele requer o Claude Code v2.1.238 ou posterior. O Claude Code salva cada rascunho na sua máquina em `~/.claude/feedback/drafts/`, e nada chega à Anthropic até que você o envie. O Claude redige um com a ferramenta SendFeedback quando:

565 565 

566* Uma ferramenta ou comando continua falhando566* Uma ferramenta ou comando continua falhando

567* Não consegue ajudá-lo com algo que você pediu567* Ele não consegue ajudar com algo que você pediu

568* Você aponta um erro que cometeu, ou ele detecta um568* Você aponta um erro que ele cometeu, ou ele percebe um

569* Você pede para registrar feedback569* Você pede que ele registre um feedback

570 570 

571<h3 id="what-you-see-when-claude-drafts">571<h3 id="what-you-see-when-claude-drafts">

572 O que você vê quando Claude redige572 O que você vê quando o Claude redige

573</h3>573</h3>

574 574 

575Depois que Claude coloca um rascunho na fila, você vê um cartão acima do seu prompt com o título do rascunho. Pressione `1` para revisar o rascunho, pressione `2` duas vezes para enviá-lo como está escrito, ou pressione `0` para descartá-lo. Um rascunho descartado permanece em sua fila. Depois de descartar um cartão, Claude Code pergunta se deseja desativar o feedback redigido por Claude. Ele para de perguntar depois que você recusa duas vezes.575Depois que o Claude coloca um rascunho na fila, você vê um cartão acima do seu prompt com o título do rascunho. Pressione `1` para revisar o rascunho, pressione `2` duas vezes para enviá-lo como está escrito ou pressione `0` para dispensar o cartão. Um rascunho dispensado permanece na sua fila. Depois que você dispensa um cartão, o Claude Code pergunta se deseja desativar o feedback redigido pelo Claude. Ele para de perguntar depois que você recusar duas vezes.

576 576 

577Por padrão, você vê no máximo três cartões em uma sessão; a Anthropic pode ajustar esse limite do servidor sem uma versão. Após o limite, e sempre que você definir [`feedbackDrafts`](/docs/pt/settings-reference#feedbackdrafts) como `quiet`, você vê apenas uma contagem de rascunhos na fila no rodapé do prompt.577Por padrão, você vê no máximo três cartões em uma sessão; a Anthropic pode ajustar esse limite pelo servidor sem uma nova versão. Após o limite, e sempre que você definir [`feedbackDrafts`](/docs/pt/settings-reference#feedbackdrafts) como `quiet`, você vê apenas uma contagem de rascunhos na fila no rodapé do prompt.

578 578 

579<h3 id="review-and-edit-a-draft">579<h3 id="review-and-edit-a-draft">

580 Revisar e editar um rascunho580 Revisar e editar um rascunho

581</h3>581</h3>

582 582 

583Execute `/feedback` sem argumentos para abrir sua fila. Ele lista todos os rascunhos na fila de todas as suas sessões, incluindo rascunhos cujos cartões você descartou ou nunca viu. Selecione um rascunho para abri-lo para revisão, onde você pode:583Execute `/feedback` sem argumento para abrir sua fila. Ela lista todos os rascunhos na fila de todas as suas sessões, incluindo rascunhos cujos cartões você dispensou ou nunca viu. Selecione um rascunho para abri-lo para revisão, onde você pode:

584 584 

585* Editar o título, área e detalhes585* Editar o título, a área e os detalhes

586* Definir **Enviar transcrição** como `sim` ou `não`. Quando a transcrição da sessão em que Claude colocou o rascunho na fila ainda está disponível, ela começa em `sim`, o que envia essa conversa para a Anthropic; `não` envia apenas o relatório586* Definir **Send transcript** como `yes` ou `no`. Quando a transcrição da sessão em que o Claude colocou o rascunho na fila ainda está disponível, o valor começa como `yes`, o que envia essa conversa à Anthropic; `no` envia apenas o relatório

587* Enviar o rascunho, descartá-lo ou deixá-lo na fila para depois587* Enviar o rascunho, descartá-lo ou deixá-lo na fila para depois

588 588 

589Para escrever um relatório você mesmo, pressione `w` para o diálogo de feedback padrão. `/feedback` com texto após ele, e `/bug`, abrem esse diálogo diretamente.589Para escrever um relatório você mesmo, pressione `w` para abrir a caixa de diálogo de feedback padrão. `/feedback` seguido de texto, e `/bug`, abrem essa caixa de diálogo diretamente.

590 590 

591<h3 id="send-a-draft">591<h3 id="send-a-draft">

592 Enviar um rascunho592 Enviar um rascunho

593</h3>593</h3>

594 594 

595Quando você envia um rascunho, Claude Code o envia da mesma forma que um relatório `/feedback`, com a mesma [retenção](/docs/pt/data-usage#feedback-using-the-%2Ffeedback-command), e exclui o rascunho de sua máquina. Quando você envia do cartão, ele mostra `✓ Enviado`; quando você envia da fila, ele fecha com uma ID de recebimento.595Quando você envia um rascunho, o Claude Code o envia da mesma forma que um relatório de `/feedback`, com a mesma [retenção](/docs/pt/data-usage#feedback-using-the-%2Ffeedback-command), e exclui o rascunho da sua máquina. Quando você envia pelo cartão, ele mostra `✓ Sent`; quando você envia pela fila, ela se fecha com um ID de recibo.

596 596 

597O relatório contém:597O relatório contém:

598 598 

599* Seu título, área e detalhes599* Seu título, área e detalhes

600* Informações de ambiente, como sua versão do Claude Code, sistema operacional e modelo600* Informações do ambiente, como sua versão do Claude Code, sistema operacional e modelo

601* Os IDs de solicitações de API recentes601* Os IDs das requisições recentes de API

602* A transcrição da conversa, quando você deixou **Enviar transcrição** em `sim` na tela de revisão. Enviar do cartão nunca inclui a transcrição602* A transcrição da conversa, quando você deixou **Send transcript** como `yes` na tela de revisão. O envio pelo cartão nunca inclui a transcrição

603 603 

604Claude Code mantém seu diretório de trabalho no rascunho local para que possa encontrar a transcrição, e não envia o diretório.604O Claude Code mantém seu diretório de trabalho no rascunho local para poder encontrar a transcrição, e não envia o diretório.

605 605 

606Em [organizações com retenção zero de dados](/docs/pt/zero-data-retention#features-disabled-under-zdr), Claude Code deixa a ferramenta de fora, assim como faz para `/feedback`. Se uma sessão em tal organização ainda oferecer a ferramenta, os rascunhos permanecem em sua máquina, e o envio falha com `Feedback collection is not available for organizations with custom data retention policies.`606Em [organizações com Zero Data Retention](/docs/pt/zero-data-retention#features-disabled-under-zdr), e em organizações com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada, o Claude Code deixa a ferramenta de fora, assim como faz com `/feedback`. Se uma sessão em uma organização com Zero Data Retention ainda oferecer a ferramenta, os rascunhos permanecem na sua máquina e o envio falha com `Feedback collection is not available for organizations with custom data retention policies.`

607 607 

608<h3 id="discard-or-keep-a-draft">608<h3 id="discard-or-keep-a-draft">

609 Descartar ou manter um rascunho609 Descartar ou manter um rascunho

610</h3>610</h3>

611 611 

612Quando você descarta um rascunho, Claude Code o exclui de sua máquina. Um rascunho que você deixa na fila expira após 30 dias, ou após [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) quando esse for mais curto. A fila contém 10 rascunhos em todas as suas sessões, e quando Claude coloca um décimo primeiro na fila, Claude Code exclui o mais antigo. Quando você executa `/exit` com rascunhos da sessão ainda na fila, Claude Code pergunta se deseja revisá-los ou descartá-los antes de sair.612Quando você descarta um rascunho, o Claude Code o exclui da sua máquina. Um rascunho que você deixa na fila expira após 30 dias, ou após [`cleanupPeriodDays`](/docs/pt/settings-reference#cleanupperioddays) quando esse período for menor. A fila comporta 10 rascunhos entre todas as suas sessões e, quando o Claude coloca um décimo primeiro na fila, o Claude Code exclui o mais antigo. Quando você executa `/exit` com rascunhos da sessão ainda na fila, o Claude Code pergunta se deseja revisá-los ou descartá-los antes de sair.

613 613 

614<h3 id="turn-claude-drafted-feedback-off">614<h3 id="turn-claude-drafted-feedback-off">

615 Desativar feedback redigido por Claude615 Desativar o feedback redigido pelo Claude

616</h3>616</h3>

617 617 

618Defina **Claude-drafted feedback** como `off` em `/config`, que escreve a configuração [`feedbackDrafts`](/docs/pt/settings-reference#feedbackdrafts), ou defina [`CLAUDE_CODE_SEND_FEEDBACK=0`](/docs/pt/env-vars) para uma sessão. Com qualquer um deles, Claude não pode colocar rascunhos na fila. Para manter a redação ativada sem cartões, defina `feedbackDrafts` como `quiet`. Administradores podem definir `feedbackDrafts` em [configurações gerenciadas](/docs/pt/managed-settings), que tem precedência sobre sua própria configuração.618Defina **Claude-drafted feedback** como `off` em `/config`, o que grava a configuração [`feedbackDrafts`](/docs/pt/settings-reference#feedbackdrafts), ou defina [`CLAUDE_CODE_SEND_FEEDBACK=0`](/docs/pt/env-vars) para uma sessão. Com qualquer uma das opções, o Claude não pode colocar rascunhos na fila. Para manter a redação ativada sem cartões, defina `feedbackDrafts` como `quiet`. Administradores podem definir `feedbackDrafts` nas [configurações gerenciadas](/docs/pt/managed-settings), que têm precedência sobre sua própria configuração.

619 619 

620<h3 id="sessions-without-claude-drafted-feedback">620<h3 id="sessions-without-claude-drafted-feedback">

621 Sessões sem feedback redigido por Claude621 Sessões sem feedback redigido pelo Claude

622</h3>622</h3>

623 623 

624Claude Code inclui a ferramenta em sessões de terminal interativas em sua própria máquina que usam a API Claude em vez de um provedor de nuvem. Ele deixa a ferramenta de fora de:624O Claude Code inclui a ferramenta em sessões interativas de terminal na sua própria máquina que usam a Claude API em vez de um provedor de nuvem. Ele deixa a ferramenta de fora de:

625 625 

626* Execuções não interativas `-p` e sessões do [Agent SDK](/docs/pt/agent-sdk/overview), que não têm tela para revisar a fila626* Execuções não interativas com `-p` e sessões do [Agent SDK](/docs/pt/agent-sdk/overview), que não têm uma tela para revisar a fila

627* [Sessões em nuvem](/docs/pt/claude-code-on-the-web), que não conseguem escrever na fila em sua máquina627* [Sessões na nuvem](/docs/pt/claude-code-on-the-web), que não podem gravar na fila da sua máquina

628* Sessões em [Amazon Bedrock](/docs/pt/amazon-bedrock), [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai), ou [Microsoft Foundry](/docs/pt/microsoft-foundry)628* Sessões no [Amazon Bedrock](/docs/pt/amazon-bedrock), na [Claude Platform on AWS](/docs/pt/claude-platform-on-aws), na [Agent Platform do Google Cloud](/docs/pt/google-vertex-ai) ou no [Microsoft Foundry](/docs/pt/microsoft-foundry)

629* Sessões em que você definiu [`CLAUDE_CODE_SEND_FEEDBACK=0`](/docs/pt/env-vars) ou [`DISABLE_FEEDBACK_COMMAND=1`](/docs/pt/env-vars), definiu `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` para qualquer valor não vazio, ou desativou [busca de sinalizador de recurso](/docs/pt/env-vars#features-that-need-feature-flag-fetching)629* Sessões em que você definiu [`CLAUDE_CODE_SEND_FEEDBACK=0`](/docs/pt/env-vars) ou [`DISABLE_FEEDBACK_COMMAND=1`](/docs/pt/env-vars), definiu `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` com qualquer valor não vazio ou desativou a [busca de feature flags](/docs/pt/env-vars#features-that-need-feature-flag-fetching)

630* Organizações que desativaram feedback de produto, e [organizações com retenção zero de dados](/docs/pt/zero-data-retention#features-disabled-under-zdr)630* Organizações que desativaram o feedback do produto, [organizações com Zero Data Retention](/docs/pt/zero-data-retention#features-disabled-under-zdr) e organizações com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada

631 631 

632<h2 id="task-tool-availability">632<h2 id="task-tool-availability">

633 Disponibilidade da ferramenta Task633 Disponibilidade da ferramenta Task


644* Liste as ferramentas em [`--tools`](/docs/pt/cli-reference#cli-flags), que restringe as ferramentas integradas da sessão àquelas que ela nomeia. Inclua as ferramentas que você deseja junto com as outras ferramentas integradas que você usa644* Liste as ferramentas em [`--tools`](/docs/pt/cli-reference#cli-flags), que restringe as ferramentas integradas da sessão àquelas que ela nomeia. Inclua as ferramentas que você deseja junto com as outras ferramentas integradas que você usa

645* No Agent SDK, as opções [`allowedTools` e `tools`](/docs/pt/agent-sdk/todo-tracking#model-availability) funcionam da mesma forma que os dois sinalizadores645* No Agent SDK, as opções [`allowedTools` e `tools`](/docs/pt/agent-sdk/todo-tracking#model-availability) funcionam da mesma forma que os dois sinalizadores

646 646 

647Em [sessões em segundo plano](/docs/pt/agent-view) e em [Claude Code na web](/docs/pt/claude-code-on-the-web), Claude Code fornece as mesmas ferramentas em todos os modelos, listados ou não.647Em [sessões em segundo plano](/docs/pt/agent-view) e em [sessões na nuvem](/docs/pt/claude-code-on-the-web), Claude Code fornece as mesmas ferramentas em todos os modelos, listados ou não.

648 648 

649Claude Code fornece a um suagente as ferramentas apenas quando sua sessão as possui, mesmo quando o suagente executa um modelo diferente. Um colega de [equipe de agentes](/docs/pt/agent-teams) em processo segue sua sessão da mesma forma, enquanto um colega em seu próprio [painel dividido](/docs/pt/agent-teams#choose-a-display-mode) é executado como um processo Claude Code separado, portanto seu próprio modelo decide. Sem as ferramentas Task, um agente coordena com sua equipe através de mensagens em vez da [lista de tarefas compartilhada](/docs/pt/agent-teams#assign-and-claim-tasks).649Claude Code fornece a um suagente as ferramentas apenas quando sua sessão as possui, mesmo quando o suagente executa um modelo diferente. Um colega de [equipe de agentes](/docs/pt/agent-teams) em processo segue sua sessão da mesma forma, enquanto um colega em seu próprio [painel dividido](/docs/pt/agent-teams#choose-a-display-mode) é executado como um processo Claude Code separado, portanto seu próprio modelo decide. Sem as ferramentas Task, um agente coordena com sua equipe através de mensagens em vez da [lista de tarefas compartilhada](/docs/pt/agent-teams#assign-and-claim-tasks).

650 650 

ultrareview.md +1 −1

Details

18* **Cobertura mais ampla**: uma frota maior de agentes revisores explora a mudança em paralelo, o que expõe problemas que uma revisão local pode perder18* **Cobertura mais ampla**: uma frota maior de agentes revisores explora a mudança em paralelo, o que expõe problemas que uma revisão local pode perder

19* **Sem uso de recursos locais**: a revisão é executada inteiramente em um sandbox na nuvem, portanto seu terminal permanece livre para outro trabalho enquanto é executada19* **Sem uso de recursos locais**: a revisão é executada inteiramente em um sandbox na nuvem, portanto seu terminal permanece livre para outro trabalho enquanto é executada

20 20 

21Ultrareview requer autenticação com uma conta claude.ai porque é executado como uma sessão na nuvem na infraestrutura da Anthropic. Se você está conectado apenas com uma chave de API, execute `/login` e autentique-se com claude.ai primeiro. Ultrareview não está disponível ao usar Claude Code com Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, e não está disponível para organizações que habilitaram Zero Data Retention. Quando ultrareview não está disponível, `/code-review ultra` executa uma revisão local em sua sessão.21Ultrareview requer autenticação com uma conta claude.ai porque é executado como uma sessão na nuvem na infraestrutura da Anthropic. Se você está conectado apenas com uma chave de API, execute `/login` e autentique-se com claude.ai primeiro. Ultrareview não está disponível ao usar Claude Code com Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, e não está disponível para organizações que habilitaram Zero Data Retention ou que têm a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada. Quando ultrareview não está disponível, `/code-review ultra` executa uma revisão local em sua sessão em vez disso.

22 22 

23<h2 id="run-ultrareview-from-the-cli">23<h2 id="run-ultrareview-from-the-cli">

24 Execute ultrareview a partir da CLI24 Execute ultrareview a partir da CLI

Details

8 8 

9Fale seus prompts em vez de digitá-los no Claude Code CLI. Sua fala é transcrita em tempo real na entrada do prompt, para que você possa misturar voz e digitação na mesma mensagem. Ative o ditado com `/voice`, depois mantenha uma tecla pressionada enquanto fala ou toque uma vez para começar e novamente para enviar.9Fale seus prompts em vez de digitá-los no Claude Code CLI. Sua fala é transcrita em tempo real na entrada do prompt, para que você possa misturar voz e digitação na mesma mensagem. Ative o ditado com `/voice`, depois mantenha uma tecla pressionada enquanto fala ou toque uma vez para começar e novamente para enviar.

10 10 

11O ditado também funciona na [visualização do agente](/docs/pt/agent-view#peek-and-reply). Mantenha ou toque sua tecla push-to-talk enquanto a entrada de despacho ou uma resposta do painel de visualização estiver em foco para ditar para uma sessão em segundo plano.11No [modo de manter pressionado](#hold-to-record), o ditado também funciona na [visualização do agente](/docs/pt/agent-view#peek-and-reply). Mantenha sua tecla push-to-talk pressionada enquanto a entrada de despacho ou uma resposta do painel de visualização estiver em foco para ditar para uma sessão em segundo plano.

12 12 

13<h2 id="requirements">13<h2 id="requirements">

14 Requisitos14 Requisitos

Details

103Se você já conectou o GitHub no navegador, `/web-setup` avisa que continuar substitui essa conexão para suas sessões em nuvem.103Se você já conectou o GitHub no navegador, `/web-setup` avisa que continuar substitui essa conexão para suas sessões em nuvem.

104 104 

105<Note>105<Note>

106 Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado não podem usar `/web-setup` ou outros recursos de sessão em nuvem. Se a CLI do GitHub não estiver instalada ou autenticada, Claude Code abre o fluxo de integração do navegador em vez disso.106 Organizações com [Zero Data Retention](/docs/pt/zero-data-retention) habilitado, ou com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada, não podem usar `/web-setup` ou outros recursos de sessão na nuvem. Se a CLI do GitHub não estiver instalada ou autenticada, Claude Code abre o fluxo de integração do navegador em vez disso.

107</Note>107</Note>

108 108 

109<Steps>109<Steps>


264O comando também está oculto em dois outros casos:264O comando também está oculto em dois outros casos:

265 265 

266* Um administrador desativou sessões em nuvem para sua organização. Neste caso, enviar `/web-setup` retorna [`Cloud sessions are disabled by your organization's policy`](/docs/pt/errors#cloud-sessions-are-disabled-by-your-organizations-policy). Antes da v2.1.268, este caso também retornava `Unknown command: /web-setup`.266* Um administrador desativou sessões em nuvem para sua organização. Neste caso, enviar `/web-setup` retorna [`Cloud sessions are disabled by your organization's policy`](/docs/pt/errors#cloud-sessions-are-disabled-by-your-organizations-policy). Antes da v2.1.268, este caso também retornava `Unknown command: /web-setup`.

267* Sua organização Enterprise tem [Zero Data Retention](/docs/pt/zero-data-retention) ativado, o que torna sessões em nuvem indisponíveis.267* Sua organização Enterprise tem [Zero Data Retention](/docs/pt/zero-data-retention) ativado, ou tem a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada. Qualquer uma delas torna as sessões na nuvem indisponíveis.

268 268 

269<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud">269<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud">

270 "Could not create a cloud environment" ou "No cloud environment available" ao usar `--cloud`270 "Could not create a cloud environment" ou "No cloud environment available" ao usar `--cloud`

workflows.md +5 −5

Details

53 </Step>53 </Step>

54 54 

55 <Step title="Acompanhar o progresso">55 <Step title="Acompanhar o progresso">

56 A execução começa em segundo plano. Execute `/workflows`, use as setas para selecionar a execução e pressione Enter para abrir sua visualização de progresso:56 A execução começa em segundo plano. Execute `/workflows` para abrir sua visualização de progresso:

57 57 

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

59 /workflows59 /workflows

60 ```60 ```

61 61 

62 A visualização mostra cada fase com sua contagem de agentes, total de tokens e tempo decorrido. Aprofunde-se em qualquer fase para ver seus agentes e o que cada um encontrou. Consulte [Acompanhar a execução](#watch-the-run) para o conjunto completo de controles.62 Se `/workflows` mostrar uma lista de execuções, selecione a execução que você acabou de iniciar e pressione Enter. A visualização mostra cada fase com sua contagem de agentes. Aprofunde-se em qualquer fase para ver seus agentes e o que cada um encontrou. Consulte [Acompanhar a execução](#watch-the-run) para o conjunto completo de controles.

63 63 

64 Você também pode acompanhar a partir do painel de tarefas abaixo da caixa de entrada: um resumo de progresso de uma linha aparece lá enquanto a execução está em andamento. Pressione a seta para baixo para focá-lo e depois Enter para expandir.64 Você também pode acompanhar a partir do painel de tarefas abaixo da caixa de entrada: um resumo de progresso de uma linha aparece lá enquanto a execução está em andamento. Pressione a seta para baixo para focá-lo e depois Enter para expandir.

65 </Step>65 </Step>


91 Acompanhar a execução91 Acompanhar a execução

92</h3>92</h3>

93 93 

94Workflows são executados em segundo plano, portanto a sessão permanece responsiva enquanto os agentes trabalham. Execute `/workflows` a qualquer momento para listar workflows em execução e concluídos, depois selecione um para abrir sua visualização de progresso. Para parar um workflow em execução sem abri-lo, selecione-o na lista e pressione `x`.94Workflows são executados em segundo plano, portanto a sessão permanece responsiva enquanto os agentes trabalham. Execute `/workflows` a qualquer momento para listar workflows em execução e concluídos, depois selecione um para abrir sua visualização de progresso. Quando a sessão tem apenas uma execução, `/workflows` pula a lista e abre essa execução. Para parar um workflow em execução a partir da lista sem abri-lo, selecione-o e pressione `x`.

95 95 

96A visualização de progresso mostra cada fase com suas contagens de agentes, totais de tokens e tempo decorrido. O rodapé lista a chave para cada ação:96A visualização de progresso mostra cada fase com suas contagens de agentes. O rodapé lista a chave para cada ação:

97 97 

98| Chave | Ação |98| Chave | Ação |

99| :- | :- |99| :- | :- |


192* **Ver script bruto**: leia o script antes de decidir192* **Ver script bruto**: leia o script antes de decidir

193* **Não**: cancelar193* **Não**: cancelar

194 194 

195`Ctrl+G` abre o script em seu editor. `Tab` permite que você ajuste o prompt antes da execução começar.195`Ctrl+G` abre o script em seu editor. Com **Sim, execute** ou **Não** selecionado, pressione `Tab` para [adicionar um comentário](/docs/pt/permissions#add-a-comment-when-you-answer-a-permission-prompt) à sua resposta.

196 196 

197Se você vê este prompt depende do seu [modo de permissão](/docs/pt/permission-modes):197Se você vê este prompt depende do seu [modo de permissão](/docs/pt/permission-modes):

198 198 

Details

12 ZDR não está incluído no plano padrão do Claude for Enterprise e não pode ser ativado nas suas configurações de administrador. Está disponível para contas qualificadas e requer ativação separada pela Anthropic. Se sua organização requer ZDR, [entre em contato com vendas](https://www.anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=zero_data_retention_request) ou com sua equipe de conta da Anthropic para confirmar elegibilidade.12 ZDR não está incluído no plano padrão do Claude for Enterprise e não pode ser ativado nas suas configurações de administrador. Está disponível para contas qualificadas e requer ativação separada pela Anthropic. Se sua organização requer ZDR, [entre em contato com vendas](https://www.anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=zero_data_retention_request) ou com sua equipe de conta da Anthropic para confirmar elegibilidade.

13</Note>13</Note>

14 14 

15Organizações do Claude for Enterprise que habilitaram HIPAA podem incluir o Claude Code CLI e a aba Code no Claude Desktop em seu Business Associate Agreement (BAA) sem ZDR, depois que a configuração HIPAA for aplicada ao Claude Code (modo local) e ao Cowork (modo local). Consulte [Configurar o Claude Code (modo local) para uma organização preparada para HIPAA](/docs/pt/hipaa-setup). Organizações sem a configuração HIPAA ainda precisam de ZDR para a cobertura do BAA no Claude Code. Consulte o [Guia de Implementação](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para ver uma lista de Serviços Elegíveis.

16 

15ZDR no Claude for Enterprise oferece aos clientes empresariais a capacidade de usar Claude Code com retenção zero de dados e acesso a recursos administrativos:17ZDR no Claude for Enterprise oferece aos clientes empresariais a capacidade de usar Claude Code com retenção zero de dados e acesso a recursos administrativos:

16 18 

17* Controles de custo por usuário19* Controles de custo por usuário