Claude Code na web está em visualização de pesquisa para usuários Pro, Max e Team, e para usuários Enterprise com assentos premium ou assentos Chat + Claude Code.
- Tarefas paralelas: execute várias tarefas independentes ao mesmo tempo, cada uma em sua própria sessão e branch, sem gerenciar múltiplas worktrees
- Repositórios que você não tem localmente: Claude clona o repositório novo a cada sessão, então você não precisa tê-lo verificado
- Tarefas que não precisam de direcionamento frequente: envie uma tarefa bem definida, faça outra coisa e revise o resultado quando Claude terminar
- Perguntas sobre código e exploração: entenda uma base de código ou rastreie como um recurso é implementado sem um checkout local
Como as sessões são executadas
Quando você envia uma tarefa:- Clone e prepare: seu repositório é clonado para uma VM gerenciada pela Anthropic, e seu script de configuração é executado se configurado.
- Configure a rede: o acesso à internet é definido com base no nível de acesso do seu ambiente.
- Trabalhe: Claude analisa código, faz alterações, executa testes e verifica seu trabalho. Você pode assistir e direcionar durante todo o processo, ou se afastar e voltar quando terminar.
- Envie a branch: quando Claude atinge um ponto de parada, ele envia sua branch para o GitHub. Você revisa o diff, deixa comentários inline, cria um PR ou envia outra mensagem para continuar.
Compare as maneiras de executar Claude Code
Claude Code se comporta da mesma forma em todos os lugares. O que muda é onde o código é executado e se sua configuração local está disponível. O aplicativo Desktop oferece sessões locais e em nuvem, portanto suas respostas abaixo dependem de qual você escolher:
Consulte a documentação do quickstart do terminal, aplicativo Desktop ou Remote Control para configurá-los.
Conecte GitHub e crie um ambiente
A configuração é um processo único. Se você já usa a CLI do GitHub, você pode fazer isso do seu terminal em vez do navegador.1
Visite claude.ai/code
Vá para claude.ai/code e faça login com sua conta Anthropic.
2
Instale o aplicativo Claude GitHub
Após fazer login, claude.ai/code solicita que você conecte o GitHub. Siga o prompt para instalar o aplicativo Claude GitHub e conceder acesso aos seus repositórios. As sessões em nuvem funcionam com repositórios GitHub existentes, portanto para iniciar um novo projeto, crie um repositório vazio no GitHub primeiro.
3
Crie seu ambiente
Após conectar o GitHub, você será solicitado a criar um ambiente de nuvem. O ambiente controla qual acesso à rede Claude tem durante as sessões e o que é executado quando uma nova sessão é criada. Consulte Ferramentas instaladas para ver o que está disponível sem nenhuma configuração.O formulário tem estes campos:
- Nome: um rótulo de exibição. Útil quando você tem múltiplos ambientes para diferentes projetos ou níveis de acesso.
- Acesso à rede: controla o que a sessão pode alcançar na internet. O padrão,
Trusted, permite conexões com registros de pacotes comuns como npm, PyPI e RubyGems enquanto bloqueia o acesso geral à internet. - Variáveis de ambiente: variáveis opcionais disponíveis em cada sessão, em formato
.env. Não coloque valores entre aspas, pois as aspas são armazenadas como parte do valor. Estas são visíveis para qualquer pessoa que possa editar este ambiente. - Script de configuração: um script Bash opcional que é executado antes do Claude Code ser iniciado. Use-o para instalar ferramentas do sistema que a VM de nuvem não inclui, como
apt install -y gh. O resultado é armazenado em cache, portanto o script não é executado novamente a cada sessão. Consulte Scripts de configuração para exemplos e dicas de depuração.
Conecte do seu terminal
Se você já usa a CLI do GitHub (gh), você pode configurar Claude Code na web sem abrir um navegador. Isso requer a CLI do Claude Code. /web-setup lê seu token gh local, vincula-o à sua conta Claude e cria um ambiente de nuvem padrão se você não tiver um.
Organizações com 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, /web-setup abre o fluxo de integração do navegador.1
Autentique com a CLI do GitHub
No seu shell, autentique a CLI do GitHub se você ainda não o fez:
2
Faça login no Claude
Na CLI do Claude Code, execute
/login para fazer login com sua conta claude.ai. Pule esta etapa se você já estiver conectado.3
Execute /web-setup
Na CLI do Claude Code, execute:Isso sincroniza seu token
gh com sua conta Claude. Se você ainda não tiver um ambiente de nuvem, /web-setup cria um com acesso à rede Trusted e sem script de configuração. Você pode editar o ambiente ou adicionar variáveis depois. Após /web-setup ser concluído, você pode iniciar sessões em nuvem do seu terminal com --cloud ou configurar tarefas recorrentes com /schedule.Inicie uma tarefa
Com GitHub conectado e um ambiente criado, você está pronto para enviar tarefas.1
Selecione um repositório e branch
De claude.ai/code ou da aba Code no aplicativo móvel Claude, clique no seletor de repositório abaixo da caixa de entrada e escolha um repositório para Claude trabalhar. Cada repositório mostra um seletor de branch. Altere-o para iniciar Claude a partir de uma branch de recurso em vez da padrão. Você pode adicionar múltiplos repositórios para trabalhar entre eles em uma sessão.
2
Escolha um modo de permissão
O dropdown de modo ao lado da entrada padrão é Aceitar edições, onde Claude faz alterações e envia uma branch sem parar para aprovação. Mude para Plan se você quiser que Claude proponha uma abordagem e aguarde seu aval antes de editar arquivos. As sessões em nuvem não oferecem permissões Manual ou Bypass. Consulte a lista completa de modos de permissão para saber o que cada um permite.
3
Descreva a tarefa e envie
Digite uma descrição do que você quer e pressione Enter. Seja específico:
- Nomeie o arquivo ou função: “Adicione um README com instruções de configuração” ou “Corrija o teste de autenticação falhando em
tests/test_auth.py” é melhor que “corrigir testes” - Cole a saída de erro se você tiver
- Descreva o comportamento esperado, não apenas o sintoma
Pré-preenchimento de sessões
Você pode pré-preencher o prompt, repositórios e ambiente para uma nova sessão adicionando parâmetros de consulta à URL claude.ai/code. Use isso para construir integrações como um botão no seu rastreador de problemas que abre Claude Code com a descrição do problema como prompt.
Codifique cada valor em URL. O exemplo abaixo abre o formulário com um prompt e um repositório já selecionados:
Revise e itere
Quando Claude terminar, revise as alterações, deixe feedback em linhas específicas e continue até que o diff pareça correto.1
Abra a visualização de diff
Um indicador de diff mostra linhas adicionadas e removidas em toda a sessão, por exemplo
+42 -18. Selecione-o para abrir a visualização de diff, com uma lista de arquivos à esquerda e alterações à direita.2
Deixe comentários inline
Selecione qualquer linha no diff, digite seu feedback e pressione Enter. Os comentários se acumulam até você enviar sua próxima mensagem, então são agrupados com ela. Claude vê “em
src/auth.ts:47, não capture o erro aqui” ao lado de sua instrução principal, portanto você não precisa descrever onde está o problema.3
Crie um pull request
Quando o diff parecer correto, selecione Criar PR no topo da visualização de diff. Você pode abri-lo como um PR completo, um rascunho ou ir para a página de composição do GitHub com um título e descrição gerados.
4
Continue iterando após o PR
A sessão permanece ativa após o PR ser criado. Cole a saída de falha de CI ou comentários do revisor no chat e peça a Claude para resolvê-los. Para ter Claude monitorar o PR automaticamente, consulte Auto-fix pull requests.
Solucione problemas de configuração
Nenhum repositório aparece após conectar GitHub
Uma sessão em nuvem pode usar qualquer repositório que a conta GitHub conectada possa ver, independentemente de quais repositórios o aplicativo Claude GitHub está instalado. Se um repositório está faltando, verifique se a conta GitHub conectada tem acesso a ele no GitHub. Se você também quiser Auto-fix para um repositório, instale o App nele: em github.com, abra Configurações → Aplicativos → Claude → Configurar e verifique se o repositório está listado em Acesso ao repositório. Repositórios privados precisam da mesma autorização que os públicos.A página mostra apenas um botão de login do GitHub
As sessões em nuvem requerem uma conta GitHub conectada. Conecte através do fluxo do navegador acima, ou execute/web-setup do seu terminal se você usar a CLI do GitHub. Se você preferir não conectar o GitHub, consulte Remote Control para executar Claude Code em sua própria máquina e monitorá-lo na web.
“Não disponível para a organização selecionada”
Organizações Enterprise podem precisar que um administrador habilite Claude Code na web. Entre em contato com sua equipe de conta Anthropic./web-setup mostra “Nenhum comando corresponde” ou “Comando desconhecido”
/web-setup é executado dentro da CLI do Claude Code, não no seu shell. Inicie claude primeiro, depois digite /web-setup no prompt.
Se você digitou dentro do Claude Code e o menu de comandos mostra Nenhum comando corresponde "/web-setup", ou enviá-lo retorna Comando desconhecido: /web-setup, o comando está oculto porque um requisito não foi atendido. A causa geralmente é que você está autenticado com uma chave de API ou provedor de terceiros em vez de uma assinatura claude.ai. Execute claude update para fazer login com sua conta claude.ai.
“Não foi possível criar um ambiente de nuvem” ou “Nenhum ambiente de nuvem disponível” ao usar --cloud ou ultraplan
Os recursos de sessão remota criam um ambiente de nuvem padrão automaticamente se você não tiver um. Se você vir “Não foi possível criar um ambiente de nuvem”, a criação automática falhou. Se você vir “Nenhum ambiente de nuvem disponível”, sua CLI é anterior à criação automática. Em qualquer caso, execute /web-setup na CLI do Claude Code para criar um manualmente, ou visite claude.ai/code e siga a etapa Crie seu ambiente acima.
Script de configuração falhou
O script de configuração saiu com um status diferente de zero, o que bloqueia o início da sessão. Causas comuns:- Uma instalação de pacote falhou porque o registro não está no seu nível de acesso à rede.
Trustedcobre a maioria dos gerenciadores de pacotes;Nonebloqueia todos. - O script faz referência a um arquivo ou caminho que não existe em um clone novo.
- Um comando que funciona localmente precisa de uma invocação diferente no Ubuntu.
set -x no topo do script para ver qual comando falhou. Para comandos não críticos, acrescente || true para que não bloqueiem o início da sessão.
Novas sessões travam ou expiram durante a configuração
Se novas sessões ficarem presas na etapa do script de configuração ou falharem com um erro genérico de contêiner antes do script terminar, o script provavelmente está excedendo o orçamento de tempo de aproximadamente cinco minutos para construir o cache de ambiente. Etapas pesadas como puxar imagens Docker grandes, sincronizar árvores de dependência completas ou baixar pesos de modelo frequentemente empurram o total além do limite, especialmente quando são executadas uma após a outra. Para corrigir isso, reduza o script para que ele termine de forma confiável em menos de cinco minutos:- Execute instalações independentes em paralelo com
&e umwaitfinal em vez de executá-las serialmente. - Mova os maiores downloads para fora do script de configuração e para um hook SessionStart que os inicia em segundo plano, para que a sessão se torne utilizável enquanto eles terminam.
- Remova longas tentativas de sono do script de configuração, pois um loop de tentativa travado conta contra o orçamento.
A sessão continua funcionando após fechar a aba
Isso é por design. Fechar a aba ou navegar para longe não interrompe a sessão. Ela continua funcionando em segundo plano até Claude terminar a tarefa atual, depois fica ociosa. Na barra lateral, você pode arquivar uma sessão para ocultá-la de sua lista, ou deletá-la para removê-la permanentemente.Próximos passos
Agora que você pode enviar e revisar tarefas, estas páginas cobrem o que vem a seguir: iniciar sessões em nuvem do seu terminal, agendar trabalho recorrente e dar instruções permanentes a Claude.- Use Claude Code na web: a referência completa, incluindo teletransporte de sessões para seu terminal, scripts de configuração, variáveis de ambiente e configuração de rede
- Routines: automatize trabalho em um cronograma, via chamada de API ou em resposta a eventos do GitHub
- CLAUDE.md: dê a Claude instruções persistentes e contexto que carregam no início de cada sessão
- Instale o aplicativo móvel Claude para iOS ou Android para monitorar sessões do seu telefone. Da CLI do Claude Code,
/mobilemostra um código QR.