Documentation 2026-06-30 23:02 UTC to 2026-07-01 21:01 UTC

85O advisor deve ser pelo menos tão capaz quanto o modelo principal. Os advisors aceitos para cada modelo principal são:85O advisor deve ser pelo menos tão capaz quanto o modelo principal. Os advisors aceitos para cada modelo principal são:

86 86 

87| Modelo principal | Advisors aceitos | Notas |87| Modelo principal | Advisors aceitos | Notas |

88| ----------------------------------------------- | -------------------------------------------------- | --------------------------------------------------------- |88| ----------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |

89| Haiku 4.5 | Fable, Opus, Sonnet | Haiku pode chamar o advisor, mas não pode atuar como um |89| Haiku 4.5 | Fable, Opus, Sonnet | Haiku pode chamar o advisor, mas não pode atuar como um |

90| Sonnet 4.6 | Fable, Opus, Sonnet | |90| Sonnet 4.6 | Fable, Opus, Sonnet | |

91| Sonnet 5 | Fable, Opus, Sonnet 5 | Um advisor Sonnet 4.6 é rejeitado |91| Sonnet 5 | Fable, Opus, Sonnet 5 | Um advisor Sonnet 4.6 é rejeitado |

92| Opus 4.6 ou posterior | Fable, Opus na versão do modelo principal ou acima | Um Opus 4.7 principal com um advisor Opus 4.6 é rejeitado |92| Opus 4.6 ou posterior | Fable, Opus na versão do modelo principal ou acima | Um Opus 4.7 principal com um advisor Opus 4.6 é rejeitado. Um Opus 4.6 principal também aceita um advisor Sonnet 5 |

93| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Um advisor Opus ou Sonnet é rejeitado |93| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Um advisor Opus ou Sonnet é rejeitado |

94 94 

95Fable 5 requer Claude Code v2.1.170 ou posterior e acesso a Fable 5, seja atuando como modelo principal ou advisor.95Fable 5 requer Claude Code v2.1.170 ou posterior e acesso a Fable 5, seja atuando como modelo principal ou advisor.

190A opção `effort` controla quanto raciocínio Claude aplica. Níveis de esforço mais baixos usam menos tokens por volta e reduzem custo. Nem todos os modelos suportam o parâmetro de esforço. Veja [Esforço](https://platform.claude.com/docs/en/build-with-claude/effort) para quais modelos o suportam.190A opção `effort` controla quanto raciocínio Claude aplica. Níveis de esforço mais baixos usam menos tokens por volta e reduzem custo. Nem todos os modelos suportam o parâmetro de esforço. Veja [Esforço](https://platform.claude.com/docs/en/build-with-claude/effort) para quais modelos o suportam.

191 191 

192| Nível | Comportamento | Bom para |192| Nível | Comportamento | Bom para |

193| :--------- | :----------------------------------- | :------------------------------------------------------------------- |193| :--------- | :----------------------------------- | :----------------------------------------------------------------------------- |

194| `"low"` | Raciocínio mínimo, respostas rápidas | Buscas de arquivo, listagem de diretórios |194| `"low"` | Raciocínio mínimo, respostas rápidas | Buscas de arquivo, listagem de diretórios |

195| `"medium"` | Raciocínio equilibrado | Edições rotineiras, tarefas padrão |195| `"medium"` | Raciocínio equilibrado | Edições rotineiras, tarefas padrão |

196| `"high"` | Análise completa | Refatorações, depuração |196| `"high"` | Análise completa | Refatorações, depuração |

197| `"xhigh"` | Profundidade de raciocínio estendida | Tarefas de codificação e agentes; recomendado em Fable 5 e Opus 4.7+ |197| `"xhigh"` | Profundidade de raciocínio estendida | Tarefas de codificação e agentes; recomendado em Fable 5, Opus 4.7+ e Sonnet 5 |

198| `"max"` | Profundidade máxima de raciocínio | Problemas multi-etapas que exigem análise profunda |198| `"max"` | Profundidade máxima de raciocínio | Problemas multi-etapas que exigem análise profunda |

199 199 

200Se você não definir `effort`, ambos os SDKs deixam o parâmetro indefinido e deferem para o comportamento padrão do modelo.200Se você não definir `effort`, ambos os SDKs deixam o parâmetro indefinido e deferem para o comportamento padrão do modelo.

3138```typescript theme={null}3138```typescript theme={null}

3139type ModelInfo = {3139type ModelInfo = {

3140 value: string;3140 value: string;

3141 resolvedModel?: string;

3141 displayName: string;3142 displayName: string;

3142 description: string;3143 description: string;

3143 supportsEffort?: boolean;3144 supportsEffort?: boolean;

3144 supportedEffortLevels?: ("low" | "medium" | "high" | "xhigh" | "max")[];3145 supportedEffortLevels?: ("low" | "medium" | "high" | "xhigh" | "max")[];

3145 supportsAdaptiveThinking?: boolean;3146 supportsAdaptiveThinking?: boolean;

3146 supportsFastMode?: boolean;3147 supportsFastMode?: boolean;

3148 supportsAutoMode?: boolean;

3147};3149};

3148```3150```

3149 3151 

3152| Campo | Tipo | Descrição |

3153| :------------------------- | :----------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3154| `value` | `string` | Identificador de modelo para passar em chamadas de API |

3155| `resolvedModel` | `string \| undefined` | ID de modelo canônico que o `value` desta entrada resolve. Uma entrada de alias como `sonnet` resolve para um ID de modelo explícito como `claude-sonnet-5`, para que um host possa corresponder um ID de modelo explícito armazenado contra a entrada de alias que o cobre. {/* min-version: 2.1.197 */}Requer Claude Code v2.1.197 ou posterior. |

3156| `displayName` | `string` | Nome de exibição legível para humanos |

3157| `description` | `string` | Descrição das capacidades do modelo |

3158| `supportsEffort` | `boolean \| undefined` | Se este modelo suporta níveis de esforço |

3159| `supportedEffortLevels` | `("low" \| "medium" \| "high" \| "xhigh" \| "max")[] \| undefined` | Níveis de esforço que este modelo aceita |

3160| `supportsAdaptiveThinking` | `boolean \| undefined` | Se este modelo suporta pensamento adaptativo, onde Claude decide quando e quanto pensar |

3161| `supportsFastMode` | `boolean \| undefined` | Se este modelo suporta modo rápido |

3162| `supportsAutoMode` | `boolean \| undefined` | Se este modelo suporta modo automático |

3163 

3150<h3 id="agentinfo">3164<h3 id="agentinfo">

3151 `AgentInfo`3165 `AgentInfo`

3152</h3>3166</h3>

284 284 

285Os companheiros de equipe começam com as configurações de permissão do líder. Se o líder for executado com `--dangerously-skip-permissions`, todos os companheiros de equipe também. Após gerar, você pode alterar modos de companheiros de equipe individuais, mas não pode definir modos por companheiro de equipe no tempo de geração.285Os companheiros de equipe começam com as configurações de permissão do líder. Se o líder for executado com `--dangerously-skip-permissions`, todos os companheiros de equipe também. Após gerar, você pode alterar modos de companheiros de equipe individuais, mas não pode definir modos por companheiro de equipe no tempo de geração.

286 286 

287Quando um agente envia uma mensagem para outro sobre `SendMessage`, o agente receptor é informado de que veio de outra sessão Claude, não de você. Um companheiro de equipe não pode aprovar um prompt de permissão ou fornecer consentimento em seu nome, e um companheiro de equipe que foi negado uma ação não pode retransmiti-la para outro companheiro de equipe para contornar a verificação. Em [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode), o classificador trata uma reivindicação de aprovação retransmitida de outro agente como entrada não confiável em vez de confirmação de você. Os prompts de permissão de companheiros de equipe aparecem na sessão líder, portanto aprove-os lá você mesmo.

288 

287<h3 id="context-and-communication">289<h3 id="context-and-communication">

288 Context e comunicação290 Context e comunicação

289</h3>291</h3>

283| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |283| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

284| `<agent-name> <prompt>` | Se a primeira palavra corresponder a um nome de [subagent](/pt/sub-agents) personalizado, esse subagent é executado como o agente principal da sessão com a configuração de seu frontmatter |284| `<agent-name> <prompt>` | Se a primeira palavra corresponder a um nome de [subagent](/pt/sub-agents) personalizado, esse subagent é executado como o agente principal da sessão com a configuração de seu frontmatter |

285| `@<agent-name>` | Mencione um subagent personalizado em qualquer lugar do prompt para executá-lo como o agente principal |285| `@<agent-name>` | Mencione um subagent personalizado em qualquer lugar do prompt para executá-lo como o agente principal |

286| `@<repo>` | Mencione um repositório sob o diretório em que você abriu agent view para executar a sessão lá |286| `@<repo>` | Mencione um repositório para executar a sessão lá. Veja [Dispatch to a specific directory](#dispatch-to-a-specific-directory) para saber quais repositórios são listados |

287| `/<command>` | Sugerir [skills](/pt/skills) e [commands](/pt/commands) para despachar como o prompt |287| `/<command>` | Sugerir [skills](/pt/skills) e [commands](/pt/commands) para despachar como o prompt |

288| `! <command>` | Execute um comando shell como um trabalho em background em vez de iniciar uma sessão Claude. O trabalho aparece como uma linha que você pode anexar, observar e desanexar |288| `! <command>` | Execute um comando shell como um trabalho em background em vez de iniciar uma sessão Claude. O trabalho aparece como uma linha que você pode anexar, observar e desanexar |

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

299 Dispatch to a specific directory299 Dispatch to a specific directory

300</h4>300</h4>

301 301 

302Uma nova sessão é executada no diretório em que você abriu agent view. Para direcionar um diretório diferente:302Uma nova sessão é executada no diretório em que você abriu agent view. Para direcionar um diretório diferente, use qualquer um destes:

303 303 

304* Abra `claude agents` naquele diretório.304* Abra `claude agents` naquele diretório.

305* Abra `claude agents` em um diretório pai que contém vários repositórios e mencione um com `@<repo>` no prompt para executar a sessão lá.305* Abra `claude agents` em um diretório pai e mencione um repositório filho com `@<repo>` no prompt. Digitando `@` lista repositórios git um nível abaixo do diretório de lançamento, mais qualquer diretório que já tenha uma sessão na lista. Um diretório cujo nome contém um espaço não é listado.

306* Do shell, `cd` para o diretório e execute `claude --bg "<prompt>"`.306* Do shell, `cd` para o diretório e execute `claude --bg "<prompt>"`.

307 307 

308Quando agent view é agrupado por diretório, o diretório da linha destacada se torna o alvo de despacho, para que você possa rolar para um grupo e despachar nele sem redigitar o caminho.308Quando agent view é agrupado por diretório, o diretório da linha destacada se torna o alvo de despacho, para que você possa rolar para um grupo e despachar nele sem redigitar o caminho.

226| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Tempo limite em segundos para descoberta de arquivo da ferramenta Glob. Padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |226| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Tempo limite em segundos para descoberta de arquivo da ferramenta Glob. Padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |

227| `CLAUDE_CODE_HIDE_CWD` | Defina como `1` para ocultar o diretório de trabalho no logo de inicialização. Útil para compartilhamentos de tela ou gravações onde o caminho expõe seu nome de usuário do SO |227| `CLAUDE_CODE_HIDE_CWD` | Defina como `1` para ocultar o diretório de trabalho no logo de inicialização. Útil para compartilhamentos de tela ou gravações onde o caminho expõe seu nome de usuário do SO |

228| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Substitua o endereço de host usado para conectar à extensão IDE. Por padrão, Claude Code detecta automaticamente o endereço correto, incluindo roteamento WSL-para-Windows |228| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Substitua o endereço de host usado para conectar à extensão IDE. Por padrão, Claude Code detecta automaticamente o endereço correto, incluindo roteamento WSL-para-Windows |

229| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Pule a auto-instalação de extensões IDE. Equivalente a definir [`autoInstallIdeExtension`](/pt/settings#global-config-settings) como `false` |229| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Defina como `1` para pular a auto-instalação de extensões IDE. Equivalente a definir [`autoInstallIdeExtension`](/pt/settings#global-config-settings) como `false` |

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

231| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. {/* min-version: 2.1.193 */}A partir de v2.1.193, aplicado diretamente para nomes de modelo que Claude Code não reconhece como um modelo Claude; para modelos Claude reconhecidos, só tem efeito quando `DISABLE_COMPACT` também está definido. Use isso ao rotear para um modelo através de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para seu nome |231| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. {/* min-version: 2.1.193 */}A partir de v2.1.193, aplicado diretamente para nomes de modelo que Claude Code não reconhece como um modelo Claude; para modelos Claude reconhecidos, só tem efeito quando `DISABLE_COMPACT` também está definido. Use isso ao rotear para um modelo através de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para seu nome |

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

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

269| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Substitua o orçamento de tempo em milissegundos para hooks [SessionEnd](/pt/hooks#sessionend). Aplica-se à saída de sessão, `/clear` e alternância de sessões via `/resume` interativo. Por padrão, o orçamento é 1,5 segundos, automaticamente aumentado para o `timeout` por hook mais alto configurado em arquivos de configuração, até 60 segundos. Timeouts em hooks fornecidos por plugin não aumentam o orçamento |269| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Substitua o orçamento de tempo em milissegundos para hooks [SessionEnd](/pt/hooks#sessionend). Aplica-se à saída de sessão, `/clear` e alternância de sessões via `/resume` interativo. Por padrão, o orçamento é 1,5 segundos, automaticamente aumentado para o `timeout` por hook mais alto configurado em arquivos de configuração, até 60 segundos. Timeouts em hooks fornecidos por plugin não aumentam o orçamento |

270| `CLAUDE_CODE_SESSION_ID` | Definido automaticamente em subprocessos de ferramenta Bash e PowerShell, subprocessos de [comando hook](/pt/hooks) e subprocessos [servidor MCP](/pt/mcp) stdio para o ID da sessão atual. Para Bash, PowerShell e hooks, isso corresponde ao campo `session_id` na entrada JSON do hook e é atualizado em `/clear`. Um subprocesso de servidor MCP retém o ID com o qual foi gerado. Em `--resume <session-id>` ele recebe o ID retomado, correspondendo a hooks e Bash. Em `--continue` ou `--resume` sem um ID explícito, ele pode receber o ID de inicialização inicial em vez disso. Use para correlacionar scripts e ferramentas externas com a sessão Claude Code que as iniciou |270| `CLAUDE_CODE_SESSION_ID` | Definido automaticamente em subprocessos de ferramenta Bash e PowerShell, subprocessos de [comando hook](/pt/hooks) e subprocessos [servidor MCP](/pt/mcp) stdio para o ID da sessão atual. Para Bash, PowerShell e hooks, isso corresponde ao campo `session_id` na entrada JSON do hook e é atualizado em `/clear`. Um subprocesso de servidor MCP retém o ID com o qual foi gerado. Em `--resume <session-id>` ele recebe o ID retomado, correspondendo a hooks e Bash. Em `--continue` ou `--resume` sem um ID explícito, ele pode receber o ID de inicialização inicial em vez disso. Use para correlacionar scripts e ferramentas externas com a sessão Claude Code que as iniciou |

271| `CLAUDE_CODE_SHELL` | Substitua a detecção automática de shell. Útil quando seu shell de login difere do seu shell de trabalho preferido (por exemplo, `bash` vs `zsh`) |271| `CLAUDE_CODE_SHELL` | Defina o shell que Claude Code usa para executar comandos da ferramenta Bash. Aceita um caminho para um binário `bash` ou `zsh`, por exemplo `/opt/homebrew/bin/bash`. Outros shells como `fish` não são suportados. Se o valor não for um caminho `bash` ou `zsh` funcionando, Claude Code o ignora e volta para auto-detecção. A auto-detecção usa seu `$SHELL` quando aponta para `bash` ou `zsh`, caso contrário, escolhe o primeiro `zsh` funcionando e depois `bash` encontrado no seu `PATH` e locais de instalação padrão |

272| `CLAUDE_CODE_SHELL_PREFIX` | Prefixo de comando que envolve comandos shell que Claude Code gera: chamadas de ferramenta Bash, comandos [hook](/pt/hooks), [linha de status](/pt/statusline) comandos e comandos de inicialização de [servidor MCP](/pt/mcp) stdio. Hooks de forma exec e hooks PowerShell são executados sem o prefixo. Útil para logging ou auditoria. Definir um caminho de executável simples como `/path/to/logger.sh` executa cada comando como `/path/to/logger.sh '<command>'`. O wrapper recebe a linha de comando como um único argumento shell-quoted em `$1`, então o wrapper deve re-avaliar `$1` com um shell, por exemplo `exec bash -c "$1"`. Tratar `$1` como um caminho de executável simples quebra servidores MCP stdio que passam argumentos como `npx -y <package>`. Para chamadas de ferramenta Bash, `$1` contém a invocação de shell completa que Claude Code monta, incluindo configuração de ambiente, não apenas o comando que Claude executou |272| `CLAUDE_CODE_SHELL_PREFIX` | Prefixo de comando que envolve comandos shell que Claude Code gera: chamadas de ferramenta Bash, comandos [hook](/pt/hooks), [linha de status](/pt/statusline) comandos e comandos de inicialização de [servidor MCP](/pt/mcp) stdio. Hooks de forma exec e hooks PowerShell são executados sem o prefixo. Útil para logging ou auditoria. Definir um caminho de executável simples como `/path/to/logger.sh` executa cada comando como `/path/to/logger.sh '<command>'`. O wrapper recebe a linha de comando como um único argumento shell-quoted em `$1`, então o wrapper deve re-avaliar `$1` com um shell, por exemplo `exec bash -c "$1"`. Tratar `$1` como um caminho de executável simples quebra servidores MCP stdio que passam argumentos como `npx -y <package>`. Para chamadas de ferramenta Bash, `$1` contém a invocação de shell completa que Claude Code monta, incluindo configuração de ambiente, não apenas o comando que Claude executou |

273| `CLAUDE_CODE_SIMPLE` | Defina como `1` para executar com um prompt do sistema mínimo e apenas as ferramentas Bash, leitura de arquivo e edição de arquivo. Ferramentas MCP de `--mcp-config` ainda estão disponíveis. Desabilita auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md. Tokens OAuth e credenciais de keychain não são lidos, então a autenticação Anthropic deve vir de `ANTHROPIC_API_KEY` ou um `apiKeyHelper` em `--settings`. Equivalente a passar [`--bare`](/pt/headless#start-faster-with-bare-mode) |273| `CLAUDE_CODE_SIMPLE` | Defina como `1` para executar com um prompt do sistema mínimo e apenas as ferramentas Bash, leitura de arquivo e edição de arquivo. Ferramentas MCP de `--mcp-config` ainda estão disponíveis. Desabilita auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md. Tokens OAuth e credenciais de keychain não são lidos, então a autenticação Anthropic deve vir de `ANTHROPIC_API_KEY` ou um `apiKeyHelper` em `--settings`. Equivalente a passar [`--bare`](/pt/headless#start-faster-with-bare-mode) |

274| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Defina como `1` para usar um prompt do sistema mais curto e descrições de ferramenta abreviadas em qualquer modelo. Defina como `0`, `false`, `no` ou `off` para optar por não participar mesmo em modelos onde o experimento ou configuração do servidor habilitaria de outra forma. O conjunto de ferramentas completo, hooks, servidores MCP e descoberta de CLAUDE.md permanecem habilitados |274| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Defina como `1` para usar um prompt do sistema mais curto e descrições de ferramenta abreviadas em qualquer modelo. Defina como `0`, `false`, `no` ou `off` para optar por não participar mesmo em modelos onde o experimento ou configuração do servidor habilitaria de outra forma. O conjunto de ferramentas completo, hooks, servidores MCP e descoberta de CLAUDE.md permanecem habilitados |

378| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Substitua região para Claude Sonnet 4.6 ao usar Vertex AI |378| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Substitua região para Claude Sonnet 4.6 ao usar Vertex AI |

379| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Substitua região para Claude Opus 4.7 ao usar Vertex AI. Adicionado em v2.1.111 |379| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Substitua região para Claude Opus 4.7 ao usar Vertex AI. Adicionado em v2.1.111 |

380| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Substitua região para Claude Opus 4.8 ao usar Vertex AI. Adicionado em v2.1.154 |380| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Substitua região para Claude Opus 4.8 ao usar Vertex AI. Adicionado em v2.1.154 |

381| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Substitua região para Claude Sonnet 5 ao usar Vertex AI. Adicionado em v2.1.197 |

381| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Substitua região para Claude Fable 5 ao usar Vertex AI. Adicionado em v2.1.170 |382| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Substitua região para Claude Fable 5 ao usar Vertex AI. Adicionado em v2.1.170 |

382| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Substitua região para Claude Haiku 4.5 ao usar Vertex AI |383| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Substitua região para Claude Haiku 4.5 ao usar Vertex AI |

383 384 

195 195 

196O seletor é a lista de modelos interativa que abre quando um desenvolvedor executa `/model` em Claude Code. Cada entrada descoberta é rotulada "Do gateway" e usa `display_name` quando fornecido. A [configuração gerenciada `availableModels`](/pt/settings#available-settings) limita o que a descoberta pode adicionar.196O seletor é a lista de modelos interativa que abre quando um desenvolvedor executa `/model` em Claude Code. Cada entrada descoberta é rotulada "Do gateway" e usa `display_name` quando fornecido. A [configuração gerenciada `availableModels`](/pt/settings#available-settings) limita o que a descoberta pode adicionar.

197 197 

198Um ID descoberto é ignorado apenas quando corresponde exatamente a uma linha já no seletor, ou quando tanto o ID descoberto quanto o existente se resolvem para [Fable](/pt/model-config#work-with-fable-5). Linhas integradas são chaveadas em aliases como `sonnet`, então um ID descoberto como `claude-sonnet-4-6` adiciona sua própria linha "Do gateway" ao lado da entrada integrada em vez de substituí-la.198Um ID descoberto é ignorado quando corresponde exatamente a uma linha já no seletor, ou quando tanto o ID descoberto quanto o existente se resolvem para [Fable](/pt/model-config#work-with-fable-5). {/* min-version: 2.1.197 */}A partir de Claude Code v2.1.197, um ID explícito descoberto também é incorporado em uma entrada integrada quando ambos se resolvem para o mesmo modelo. Linhas integradas são chaveadas em aliases como `sonnet`, então um ID descoberto explícito do modelo para o qual o alias atualmente se resolve, como `claude-sonnet-5`, colapsa na linha `sonnet`, enquanto um ID para o qual o alias não se resolve, como `claude-sonnet-4-6`, ainda adiciona sua própria linha "Do gateway" ao lado da entrada integrada.

199 199 

200Os resultados são armazenados em cache em `~/.claude/cache/gateway-models.json`, ou `%USERPROFILE%\.claude\cache\gateway-models.json` no Windows, e atualizados em cada inicialização. Se a solicitação falhar ou o gateway não implementar `/v1/models`, o seletor volta para a lista em cache da inicialização anterior ou para a lista de modelos integrada. Se seu gateway serve modelos Claude sob aliases que não correspondem ao filtro de descoberta, desenvolvedores podem adicionar esses aliases manualmente com as [variáveis de configuração de modelo](/pt/model-config).200Os resultados são armazenados em cache em `~/.claude/cache/gateway-models.json`, ou `%USERPROFILE%\.claude\cache\gateway-models.json` no Windows, e atualizados em cada inicialização. Se a solicitação falhar ou o gateway não implementar `/v1/models`, o seletor volta para a lista em cache da inicialização anterior ou para a lista de modelos integrada. Se seu gateway serve modelos Claude sob aliases que não correspondem ao filtro de descoberta, desenvolvedores podem adicionar esses aliases manualmente com as [variáveis de configuração de modelo](/pt/model-config).

201 201 

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

629* `response_length`: Comprimento do texto de resposta em caracteres629* `response_length`: Comprimento do texto de resposta em caracteres

630* `response`: Texto de resposta, truncado em 60 KB. Reduzido para `<REDACTED>` por padrão. Defina `OTEL_LOG_ASSISTANT_RESPONSES=1` para incluí-lo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` não está definido, `OTEL_LOG_USER_PROMPTS` controla isso em vez disso, então defina `OTEL_LOG_ASSISTANT_RESPONSES=0` para manter respostas reduzidas enquanto o registro de prompt está ativado630* `response`: Texto de resposta, truncado em 60 KB. Reduzido para `<REDACTED>` por padrão. Defina `OTEL_LOG_ASSISTANT_RESPONSES=1` para incluí-lo. Quando `OTEL_LOG_ASSISTANT_RESPONSES` não está definido, `OTEL_LOG_USER_PROMPTS` controla isso em vez disso, então defina `OTEL_LOG_ASSISTANT_RESPONSES=0` para manter respostas reduzidas enquanto o registro de prompt está ativado

631* `model`: Identificador do modelo (por exemplo, "claude-sonnet-4-6")631* `model`: Identificador do modelo (por exemplo, "claude-sonnet-5")

632* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta. Presente apenas quando a API retorna um632* `request_id`: ID de solicitação da API Anthropic do cabeçalho `request-id` da resposta. Presente apenas quando a API retorna um

633* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente633* `query_source`: Subsistema que emitiu a solicitação, como `"repl_main_thread"`, `"compact"` ou um nome de subagente

634 634 

129 129 

130Digitar `/deploy` executa a skill da raiz do projeto. Digite o nome qualificado `/apps/web:deploy` para executar a variante aninhada explicitamente.130Digitar `/deploy` executa a skill da raiz do projeto. Digite o nome qualificado `/apps/web:deploy` para executar a variante aninhada explicitamente.

131 131 

132Uma entrada `<skill-name>` nas localizações enterprise, pessoal ou projeto pode ser um symlink para um diretório em outro lugar no disco. Claude Code segue o symlink e lê `SKILL.md` do diretório de destino, e se o mesmo destino for acessível de mais de um local, Claude Code carrega a skill uma vez. Skills de plugin lidam com symlinks de forma diferente; consulte [Compartilhe arquivos dentro de um marketplace com symlinks](/pt/plugins-reference#share-files-within-a-marketplace-with-symlinks).

133 

132<Note>134<Note>

133 Adicione um `.claude-plugin/plugin.json` a uma pasta de skill e ela carrega como um [plugin](/pt/plugins-reference#skills-directory-plugins) nomeado `<name>@skills-dir`, para que possa agrupar agents, hooks e servidores MCP. Em um `.claude/skills/` de projeto, isso requer aceitar o diálogo de confiança do workspace primeiro.135 Adicione um `.claude-plugin/plugin.json` a uma pasta de skill e ela carrega como um [plugin](/pt/plugins-reference#skills-directory-plugins) nomeado `<name>@skills-dir`, para que possa agrupar agents, hooks e servidores MCP. Em um `.claude/skills/` de projeto, isso requer aceitar o diálogo de confiança do workspace primeiro.

134</Note>136</Note>

361Regras de permissão WebSearch não levam especificador. Uma entrada `WebSearch` simples em `allow` ou `deny` é a única forma.361Regras de permissão WebSearch não levam especificador. Uma entrada `WebSearch` simples em `allow` ou `deny` é a única forma.

362 362 

363<Note>363<Note>

364 WebSearch está disponível na Claude API e Microsoft Foundry. No Google Cloud Vertex AI funciona com modelos Claude 4, incluindo Opus, Sonnet e Haiku. Amazon Bedrock não expõe a ferramenta de pesquisa na web do lado do servidor.364 WebSearch está disponível na Claude API e Microsoft Foundry. No Google Cloud Vertex AI funciona com modelos Claude 4 e posteriores, incluindo Opus, Sonnet e Haiku. Amazon Bedrock não expõe a ferramenta de pesquisa na web do lado do servidor.

365</Note>365</Note>

366 366 

367<h2 id="write-tool-behavior">367<h2 id="write-tool-behavior">

26| `irm is not recognized` ou `&& is not valid` | [Use o comando correto para seu shell](#wrong-install-command-on-windows) |26| `irm is not recognized` ou `&& is not valid` | [Use o comando correto para seu shell](#wrong-install-command-on-windows) |

27| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Atualize o Homebrew](#homebrew-cask-unavailable-or-outdated) |27| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Atualize o Homebrew](#homebrew-cask-unavailable-or-outdated) |

28| `'bash' is not recognized as the name of a cmdlet` | [Use o comando do instalador do Windows](#wrong-install-command-on-windows) |28| `'bash' is not recognized as the name of a cmdlet` | [Use o comando do instalador do Windows](#wrong-install-command-on-windows) |

29| `A parameter cannot be found that matches parameter name 'fsSL'` | [Use o comando do instalador do Windows](#wrong-install-command-on-windows) |

29| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [Instale um shell](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |30| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [Instale um shell](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |

30| `Claude Code does not support 32-bit Windows` | [Abra o Windows PowerShell, não a entrada x86](#claude-code-does-not-support-32-bit-windows) |31| `Claude Code does not support 32-bit Windows` | [Abra o Windows PowerShell, não a entrada x86](#claude-code-does-not-support-32-bit-windows) |

31| `The process cannot access the file ... because it is being used by another process` | [Limpe a pasta de downloads e tente novamente](#the-process-cannot-access-the-file-during-windows-install) |32| `The process cannot access the file ... because it is being used by another process` | [Limpe a pasta de downloads e tente novamente](#the-process-cannot-access-the-file-during-windows-install) |

489 Wrong install command on Windows490 Wrong install command on Windows

490</h3>491</h3>

491 492 

492Se você vir `'irm' is not recognized`, `The token '&&' is not valid`, ou `'bash' is not recognized as the name of a cmdlet`, você copiou o comando de instalação para um shell ou sistema operacional diferente.493Se você vir `'irm' is not recognized`, `The token '&&' is not valid`, `A parameter cannot be found that matches parameter name 'fsSL'`, ou `'bash' is not recognized as the name of a cmdlet`, você copiou o comando de instalação para um shell ou sistema operacional diferente.

493 494 

494* **`irm` não reconhecido**: você está em CMD, não PowerShell. Você tem duas opções:495* **`irm` não reconhecido**: você está em CMD, não PowerShell. Você tem duas opções:

495 496 

510 irm https://claude.ai/install.ps1 | iex511 irm https://claude.ai/install.ps1 | iex

511 ```512 ```

512 513 

514* **`A parameter cannot be found that matches parameter name 'fsSL'`**: você executou o instalador macOS/Linux `curl -fsSL ... | bash` no Windows PowerShell, onde `curl` é um alias para `Invoke-WebRequest` e rejeita os sinalizadores `-fsSL`. Use o instalador PowerShell em vez disso:

515 ```powershell theme={null}

516 irm https://claude.ai/install.ps1 | iex

517 ```

518 

513* **`bash` não reconhecido**: você executou o instalador macOS/Linux no Windows. Use o instalador PowerShell em vez disso:519* **`bash` não reconhecido**: você executou o instalador macOS/Linux no Windows. Use o instalador PowerShell em vez disso:

514 ```powershell theme={null}520 ```powershell theme={null}

515 irm https://claude.ai/install.ps1 | iex521 irm https://claude.ai/install.ps1 | iex

5982. Pesquise por "Claude Code"5982. Pesquise por "Claude Code"

5993. Clique em **Uninstall**5993. Clique em **Uninstall**

600 600 

601Executar `claude` em um terminal integrado do VS Code reinstala a extensão automaticamente. Para mantê-la desinstalada, desative **Auto-install IDE extension** em `/config`, ou defina [`autoInstallIdeExtension`](/pt/settings#global-config-settings) como `false`. Você também pode definir a variável de ambiente [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/pt/env-vars) como `1`.

602 

601Para também remover dados de extensão e redefinir todas as configurações, delete o diretório de armazenamento da extensão para sua plataforma.603Para também remover dados de extensão e redefinir todas as configurações, delete o diretório de armazenamento da extensão para sua plataforma.

602 604 

603No macOS:605No macOS: