Documentation 2026-11-04 23:59 UTC to 2026-11-05 23:03 UTC

474 474 

475Uma mensagem do líder ou de outro companheiro de equipe acorda um companheiro de equipe in-process que está aguardando para tentar novamente uma solicitação de API com falha, para que ele tente novamente imediatamente em vez de aguardar o atraso de repetição completo.475Uma mensagem do líder ou de outro companheiro de equipe acorda um companheiro de equipe in-process que está aguardando para tentar novamente uma solicitação de API com falha, para que ele tente novamente imediatamente em vez de aguardar o atraso de repetição completo.

476 476 

477O líder também pode parar cedo, decidindo que a equipe terminou antes de todas as tarefas estarem realmente completas. Se isso acontecer, diga a ele para continuar.

478 

477### Sessões tmux órfãs479### Sessões tmux órfãs

478 480 

479Se uma sessão tmux persistir após a sessão do Claude Code terminar, pode não ter sido totalmente limpa. Liste as sessões e encerre a criada pela equipe:481Se uma sessão tmux persistir após a sessão do Claude Code terminar, pode não ter sido totalmente limpa. Liste as sessões e encerre a criada pela equipe:

298 298 

299Os administradores controlam a disponibilidade através de duas [configurações gerenciadas](https://code.claude.com/docs/pt/settings.md) que os usuários não podem substituir. O padrão depende de como você se autentica:299Os administradores controlam a disponibilidade através de duas [configurações gerenciadas](https://code.claude.com/docs/pt/settings.md) que os usuários não podem substituir. O padrão depende de como você se autentica:

300 300 

301* **claude.ai Team e Enterprise**: os canais são bloqueados até que um administrador os [habilite](#enable-channels-for-your-organization).301* **claude.ai Team e Enterprise**: os canais são bloqueados até que um Owner os [habilite](#enable-channels-for-your-organization).

302* **Anthropic Console com autenticação de chave de API**: os canais são permitidos por padrão. Você só precisa dessa configuração se sua organização implanta configurações gerenciadas.302* **Anthropic Console com autenticação de chave de API**: os canais são permitidos por padrão. Você só precisa dessa configuração se sua organização implanta configurações gerenciadas.

303 303 

304Em todos os casos, nenhum canal é executado até que um usuário o opte para a sessão com `--channels`.304Em todos os casos, nenhum canal é executado até que um usuário o opte para a sessão com `--channels`.

227 227 

228Para ocultar ou mostrar o painel, clique em **Hide session rail** ou **Show session rail** na barra de título da sessão, ou no menu **⋮** da barra. Se você ainda não vir o painel, [verifique qual layout da aba Code você tem](#check-which-layout-you-have).228Para ocultar ou mostrar o painel, clique em **Hide session rail** ou **Show session rail** na barra de título da sessão, ou no menu **⋮** da barra. Se você ainda não vir o painel, [verifique qual layout da aba Code você tem](#check-which-layout-you-have).

229 229 

230### Minimizar um painel

231 

232Para manter o Terminal, o Browser ou o [iOS Simulator](https://code.claude.com/docs/pt/desktop-ios-simulator.md) visível em tamanho reduzido, clique em **Minimize** no cabeçalho do painel. O botão requer Claude Desktop v4.0.0 ou posterior e uma conta Claude em vez de um [provedor terceirizado](https://code.claude.com/docs/pt/third-party-integrations.md). O painel Browser o tem apenas em sessões locais.

233 

234O painel minimizado fica no [painel de detalhes da sessão](#see-session-details) enquanto esse painel estiver na tela, e flutua em um canto do chat caso contrário:

235 

236* **No painel de detalhes**: o painel minimizado fica abaixo dos cartões do painel, onde você não pode movê-lo nem redimensioná-lo. Para fazê-lo flutuar sobre o chat, [oculte o painel de detalhes](#hide-or-show-the-session-details-panel).

237* **Em um canto do chat**: passe o cursor sobre o painel minimizado para mostrar seu cabeçalho. Arraste o cabeçalho para movê-lo para outro canto. Para redimensioná-lo, arraste o canto do painel minimizado mais próximo do centro do chat.

238 

239Para restaurar o painel completo, clique em **Expand** no cabeçalho do painel minimizado. Para fechar o painel minimizado, clique no botão de fechar ao lado de **Expand**.

240 

230### Executar comandos no terminal241### Executar comandos no terminal

231 242 

232O 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**.243O 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**.

94 94 

95## Conceder acesso de Claude a um dispositivo95## Conceder acesso de Claude a um dispositivo

96 96 

97Claude pede seu consentimento antes de controlar um dispositivo, enquanto construir o aplicativo ou abrir uma URL nele segue o modo de permissão de sua sessão. Você ou sua organização também podem desativar completamente o acesso de Claude.97Claude pede seu consentimento antes de controlar um dispositivo, enquanto compilar ou iniciar o aplicativo ou abrir uma URL nele segue o modo de permissão de sua sessão. Você ou sua organização também podem desativar completamente o acesso de Claude.

98 98 

99### Permitir um dispositivo pela primeira vez99### Permitir um dispositivo pela primeira vez

100 100 

101A primeira vez que Claude usa um simulador, o aplicativo desktop pede permissão. O consentimento cobre controlar esse dispositivo e tirar capturas de tela dele, e você o concede uma vez por dispositivo em vez de uma vez por sessão. As capturas de tela de Claude do dispositivo são enviadas para Anthropic e mantidas sob suas configurações normais de retenção de conversa, portanto não faça login em contas reais em um dispositivo que Claude usa.101A primeira vez que Claude usa um simulador, o aplicativo desktop pede permissão. O consentimento cobre controlar esse dispositivo e tirar capturas de tela dele, e você o concede uma vez por dispositivo em vez de uma vez por sessão. As capturas de tela de Claude do dispositivo são enviadas para Anthropic e mantidas sob suas configurações normais de retenção de conversa, portanto não faça login em contas reais em um dispositivo que Claude usa.

102 102 

103Depois de permitir um dispositivo, as ações de Claude nele, como tocar, digitar, iniciar o aplicativo e tirar capturas de tela, são executadas sem mais prompts. Elas têm a mesma confiança que você clicando no painel, e elas apenas tocam o dispositivo simulado, portanto o painel não precisa das permissões de Acessibilidade e Gravação de Tela do macOS que o computer use requer.103Depois de permitir um dispositivo, as ações de Claude nele, como tocar, digitar e tirar capturas de tela, são executadas sem prompts, mas você aprova a inicialização do aplicativo conforme seu [modo de permissão](#actions-that-follow-your-permission-mode) exigir. Elas têm a mesma confiança que você clicando no painel, e elas apenas tocam o dispositivo simulado, portanto o painel não precisa das permissões de Acessibilidade e Gravação de Tela do macOS que o computer use requer.

104 104 

105Se você recusar, o dispositivo ainda inicia e o painel ainda funciona para seus próprios toques; apenas o acesso de Claude permanece desativado. Para mudar de ideia depois, clique em **Let Claude use it** no painel.105Se você recusar, o dispositivo ainda inicia e o painel ainda funciona para seus próprios toques; apenas o acesso de Claude permanece desativado. Para mudar de ideia depois, clique em **Let Claude use it** no painel.

106 106 

107### Ações que seguem seu modo de permissão107### Ações que seguem seu modo de permissão

108 108 

109Duas ações seguem o [modo de permissão](https://code.claude.com/docs/pt/permissions.md#permission-modes) de sua sessão em vez do consentimento único:109Três ações seguem o [modo de permissão](https://code.claude.com/docs/pt/permissions.md#permission-modes) de sua sessão mesmo depois que você permite um dispositivo:

110 110 

111* Abrir uma URL no dispositivo, por exemplo para testar um deep link ou carregar uma página no Safari do dispositivo, porque uma URL pode levar dados para fora do dispositivo.111* Abrir uma URL no dispositivo, por exemplo para testar um deep link ou carregar uma página no Safari do dispositivo, porque uma URL pode levar dados para fora do dispositivo.

112* Construir o aplicativo, porque `xcodebuild` executa os scripts de construção do seu projeto em seu Mac. Verificar uma construção já em andamento não solicita.112* Construir o aplicativo, porque `xcodebuild` executa os scripts de construção do seu projeto em seu Mac. Verificar uma construção já em andamento não solicita.

113* Instalar e iniciar o aplicativo, porque Claude pode executar qualquer aplicativo que nomear, não apenas aquele que você está desenvolvendo.

113 114 

114### Desativar acesso ao simulador115### Desativar acesso ao simulador

115 116 

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

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

4 4 

5# Use the mods API5# Usar a API de mods

6 6 

7> Chame a mods API de um mod Claude Code para adicionar comandos e ferramentas, chamar um modelo, executar trabalho em um temporizador, enviar mensagens para outras sessões e acessar arquivos e a rede.7> Chame a mods API de um mod Claude Code para adicionar comandos e ferramentas, chamar um modelo, executar trabalho em um temporizador, enviar mensagens para outras sessões e acessar arquivos e a rede.

8 8 

48| `--post-session-hook-timeout-sec <n>` | `SELF_HOSTED_RUNNER_POST_SESSION_HOOK_TIMEOUT_MS` | `60` | Orçamento para o hook [`post-session`](https://code.claude.com/docs/pt/self-hosted-environments-configuration#post-session) no final de cada sessão, incluindo desligamento do executor |48| `--post-session-hook-timeout-sec <n>` | `SELF_HOSTED_RUNNER_POST_SESSION_HOOK_TIMEOUT_MS` | `60` | Orçamento para o hook [`post-session`](https://code.claude.com/docs/pt/self-hosted-environments-configuration#post-session) no final de cada sessão, incluindo desligamento do executor |

49| `--proxy-authorization-command <command>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_COMMAND` | não definido | Comando shell que o executor executa para cada conexão com seu proxy de saída, usando seu stdout aparado como o valor do cabeçalho `Proxy-Authorization`. Requer `HTTPS_PROXY` ou `HTTP_PROXY`, e não pode ser combinado com `--proxy-authorization-file`. Consulte [Authenticate to an egress proxy](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy). Requer Claude Code v2.1.238 ou posterior. |49| `--proxy-authorization-command <command>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_COMMAND` | não definido | Comando shell que o executor executa para cada conexão com seu proxy de saída, usando seu stdout aparado como o valor do cabeçalho `Proxy-Authorization`. Requer `HTTPS_PROXY` ou `HTTP_PROXY`, e não pode ser combinado com `--proxy-authorization-file`. Consulte [Authenticate to an egress proxy](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy). Requer Claude Code v2.1.238 ou posterior. |

50| `--proxy-authorization-file <path>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_FILE` | não definido | Arquivo que o executor lê para cada conexão com seu proxy de saída, usando seu conteúdo aparado como o valor do cabeçalho `Proxy-Authorization`. Use este sinalizador para um token que outro processo rotaciona no lugar. Carrega os mesmos requisitos que `--proxy-authorization-command`, e não pode ser combinado com ele. Consulte [Authenticate to an egress proxy](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy). Requer Claude Code v2.1.238 ou posterior. |50| `--proxy-authorization-file <path>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_FILE` | não definido | Arquivo que o executor lê para cada conexão com seu proxy de saída, usando seu conteúdo aparado como o valor do cabeçalho `Proxy-Authorization`. Use este sinalizador para um token que outro processo rotaciona no lugar. Carrega os mesmos requisitos que `--proxy-authorization-command`, e não pode ser combinado com ele. Consulte [Authenticate to an egress proxy](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy). Requer Claude Code v2.1.238 ou posterior. |

51| `--push-outcome-on-release` | `SELF_HOSTED_RUNNER_PUSH_OUTCOME_ON_RELEASE` | desligado | Quando o próprio executor encerra uma sessão, como em uma drenagem ou em uma liberação por inatividade, o executor envia os branches principais da sessão que têm novos commits para `origin` antes de excluir o workspace. Melhor esforço; adiciona 30 segundos ao orçamento de desligamento. Requer git 2.29 ou mais recente para retomar a partir deles. Restrinja o acesso de envio a refs `claude/*`; consulte [Resumed sessions lose unpushed work](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#resumed-sessions-lose-unpushed-work). Os repositórios de um hook `checkout` não são enviados; faça snapshot deles a partir do [hook `post-session`](https://code.claude.com/docs/pt/self-hosted-environments-configuration#post-session). |51| `--push-outcome-on-release` | `SELF_HOSTED_RUNNER_PUSH_OUTCOME_ON_RELEASE` | desligado | Quando o próprio executor encerra uma sessão, como em uma drenagem ou em uma liberação por inatividade, o executor envia os branches principais da sessão que têm novos commits para `origin` antes de excluir o workspace. Melhor esforço; adiciona 30 segundos ao orçamento de desligamento. Requer git 2.29 ou mais recente para retomar a partir deles. Restrinja o acesso de envio a refs `claude/*`; consulte [Sessões retomadas perdem trabalho não enviado](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#resumed-sessions-lose-unpushed-work). Os repositórios de um hook `checkout` não são enviados; faça snapshot deles a partir do [hook `post-session`](https://code.claude.com/docs/pt/self-hosted-environments-configuration#post-session). |

52| `--release-idle-session-min <n>` | `SELF_HOSTED_RUNNER_SESSION_IDLE_MS` | `0` | Libere um slot de sessão após N minutos de inatividade uma vez que um turno termine ou a sessão aguarde a ação do usuário. [Some sessions don't count as idle](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#some-sessions-don’t-count-as-idle), então emparelhe com `--kill-session-after-min`. Uma tarefa em segundo plano concluída mantém a sessão ocupada por no máximo a janela [`SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS`](#environment-variable-only-settings). Para atrasar uma liberação, defina [`--hold-idle-file`](https://code.claude.com/docs/pt/self-hosted-environments-deploy#keep-an-idle-session-while-its-processes-run). `0` desabilita. |52| `--release-idle-session-min <n>` | `SELF_HOSTED_RUNNER_SESSION_IDLE_MS` | `0` | Libere um slot de sessão após N minutos de inatividade uma vez que um turno termine ou a sessão aguarde a ação do usuário. [Some sessions don't count as idle](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#some-sessions-don’t-count-as-idle), então emparelhe com `--kill-session-after-min`. Uma tarefa em segundo plano concluída mantém a sessão ocupada por no máximo a janela [`SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS`](#environment-variable-only-settings). Para atrasar uma liberação, defina [`--hold-idle-file`](https://code.claude.com/docs/pt/self-hosted-environments-deploy#keep-an-idle-session-while-its-processes-run). `0` desabilita. |

53| `--remove-session-state [bool]` | `SELF_HOSTED_RUNNER_REMOVE_SESSION_STATE` | desligado | Remova os diretórios por sessão de uma sessão sob `<base-dir>/_sessions/` quando a sessão terminar neste executor, seja qual for o resultado. [Reuse a pre-warmed checkout](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout) descreve o que eles contêm e quem pode lê-los quando permanecem. A remoção é melhor esforço: os diretórios por sessão permanecem no lugar quando o executor é morto ou atinge seu prazo de drenagem antes da limpeza ser executada. Com o sinalizador ativado, o log de depuração de uma sessão falhada ou interrompida não é mantido em disco. Requer Claude Code v2.1.268 ou posterior. |53| `--remove-session-state [bool]` | `SELF_HOSTED_RUNNER_REMOVE_SESSION_STATE` | desligado | Remova os diretórios por sessão de uma sessão sob `<base-dir>/_sessions/` quando a sessão terminar neste executor, seja qual for o resultado. [Reuse a pre-warmed checkout](https://code.claude.com/docs/pt/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout) descreve o que eles contêm e quem pode lê-los quando permanecem. A remoção é melhor esforço: os diretórios por sessão permanecem no lugar quando o executor é morto ou atinge seu prazo de drenagem antes da limpeza ser executada. Com o sinalizador ativado, o log de depuração de uma sessão falhada ou interrompida não é mantido em disco. Requer Claude Code v2.1.268 ou posterior. |

54| `--retire-at <epoch-seconds>` | `SELF_HOSTED_RUNNER_RETIRE_AT` | não definido | Aposentar o executor em um timestamp Unix absoluto em segundos, para infraestrutura que mata o executor em um tempo conhecido; [Runner lifecycle](https://code.claude.com/docs/pt/self-hosted-environments#runner-lifecycle) descreve a sequência de liberação e como dimensionar a margem. Valores antes de 2001 ou após o ano 5138 são rejeitados pelo sinalizador e ignorados pela variável de ambiente. |54| `--retire-at <epoch-seconds>` | `SELF_HOSTED_RUNNER_RETIRE_AT` | não definido | Aposentar o executor em um timestamp Unix absoluto em segundos, para infraestrutura que mata o executor em um tempo conhecido; [Runner lifecycle](https://code.claude.com/docs/pt/self-hosted-environments#runner-lifecycle) descreve a sequência de liberação e como dimensionar a margem. Valores antes de 2001 ou após o ano 5138 são rejeitados pelo sinalizador e ignorados pela variável de ambiente. |