SpyBara
Go Premium

web-quickstart.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 58 additions and 33 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Sat 19 23:57 Wed 23 23:57

Comece com Claude Code na web

Execute Claude Code na nuvem a partir do seu navegador ou telefone. Conecte um repositório GitHub, envie uma tarefa e revise o PR sem configuração local.

Claude Code na web é executado em infraestrutura de nuvem gerenciada pela Anthropic em vez de sua máquina. Envie tarefas de claude.ai/code no seu navegador ou no aplicativo móvel Claude.

Você precisará de um repositório GitHub para começar. Claude o clona em uma máquina virtual isolada, faz alterações e envia uma branch para você revisar. As sessões persistem entre dispositivos, portanto uma tarefa que você inicia no seu laptop está pronta para revisar no seu telefone mais tarde.

Claude Code na web funciona bem para:

  • 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

Para trabalho que precisa de sua configuração local, ferramentas ou ambiente, executar Claude Code localmente ou usar Remote Control é mais adequado.

Como as sessões são executadas

As etapas abaixo descrevem sessões hospedadas pela Anthropic. Em um ambiente auto-hospedado, o clone e tudo depois dele são executados nos seus próprios runners da organização, onde os limites de rede, configuração e comportamento de push são configurados pelo operador. Quando você envia uma tarefa:

  1. Clone e prepare: seu repositório é clonado para uma VM gerenciada pela Anthropic, e seu script de configuração é executado se configurado.
  2. Configure a rede: o acesso à internet é definido com base no nível de acesso do seu ambiente.
  3. 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.
  4. 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.

A sessão não fecha quando a branch é enviada. A criação de PR e edições adicionais acontecem dentro da mesma conversa.

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:

Na web Remote Control Terminal CLI Aplicativo Desktop
O código é executado em VM de nuvem, gerenciada pela Anthropic por padrão Sua máquina Sua máquina Sua máquina ou VM de nuvem
Você conversa de claude.ai ou aplicativo móvel claude.ai ou aplicativo móvel Seu terminal A interface do Desktop
Usa sua configuração local Não, apenas repositório Sim Sim Sim para local, não para nuvem
Requer GitHub Sim, ou agrupe um repositório local via --cloud Não Não Apenas para sessões em nuvem
Continua funcionando se você desconectar Sim Enquanto o terminal permanecer aberto Não Depende do tipo de sessão
Modos de permissão Aceitar edições, Plan, Auto Manual, Aceitar edições, Plan Todos os modos Depende do tipo de sessão
Acesso à rede Configurável por ambiente Rede da sua máquina Rede da sua máquina Depende do tipo de sessão

Consulte a documentação do quickstart do terminal, aplicativo Desktop ou Remote Control para configurá-los.

Conecte GitHub

Conectar GitHub é 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 claude.ai. No macOS ou Windows, a primeira tela oferece o aplicativo Claude Code desktop e outras formas de instalar Claude Code. Para permanecer no navegador, clique em Continue on web na parte inferior da página.

2

Sign in with GitHub

Após fazer login, claude.ai/code solicita que você conecte o GitHub. Siga o prompt, e claude.ai/code o envia para a página de autorização do GitHub. Aprove a solicitação de autorização, e o GitHub o retorna para claude.ai/code. As sessões em nuvem funcionam com repositórios GitHub existentes e podem acessar qualquer repositório que sua conta GitHub possa ver. Para iniciar um novo projeto, crie um repositório vazio no GitHub primeiro.

Quando Quick web setup está desativado, que é o padrão em planos Team e Enterprise, claude.ai/code então solicita que você instale o Claude GitHub App em seus repositórios, a menos que já esteja instalado. Instale-o se quiser Auto-fix, que permite que Claude responda a falhas de CI e comentários de revisão em pull requests nesses repositórios; caso contrário, clique em Skip. De qualquer forma, as sessões podem acessar os mesmos repositórios.

3

Configure seu ambiente padrão

Um ambiente em nuvem é a configuração salva que controla qual acesso à rede Claude tem durante as sessões e o que é executado quando uma sessão é iniciada. O que acontece após você conectar o GitHub depende do seu plano:

  • Pro e Max: a integração cria um ambiente chamado Default para você.
  • Team e Enterprise: a integração mostra um formulário Create your first cloud environment. Deixe o nome pré-preenchido e o acesso à rede inalterados e clique em Create & finish para criar o ambiente Default. Se um Owner ativou Quick web setup, a integração cria Default para você em vez disso.

Default usa acesso à rede Trusted: as sessões alcançam registros de pacotes comuns e outros domínios na lista de permissões, e nada mais através da rede da sessão. Veja Ferramentas instaladas para o que está disponível sem nenhuma configuração.

Para um primeiro projeto, o ambiente Default funciona como está. Para alterar seu acesso à rede, adicionar variáveis de ambiente ou executar um script de configuração antes das sessões iniciarem, edite-o ou crie ambientes adicionais.

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. Quando você executa /web-setup, Claude Code lê seu token gh local, vincula-o à sua conta claude.ai e cria o ambiente em nuvem Default se você não tiver um. Em planos Team e Enterprise, /web-setup está disponível apenas após um Owner ativar Quick web setup.

1

Autentique com a CLI do GitHub

No seu shell, autentique a CLI do GitHub se você ainda não o fez:

gh auth login
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 com uma conta claude.ai. Autenticar com uma chave de API não conta. Para verificar, execute /status e confirme que a linha Login method mostra uma conta claude.ai.

3

Execute /web-setup

Na CLI do Claude Code, execute:

/web-setup

Isso sincroniza seu token gh com sua conta Claude. Em caso de sucesso, Claude Code imprime Connected as <your-github-username> e abre claude.ai/code no seu navegador. Se você ainda não tiver um ambiente em 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 mostra o modo em que a sessão será executada:

  • Auto: um classificador revisa as ações de Claude em vez de pedir a você. Aparece quando sua organização permite modo auto e o modelo selecionado o suporta
  • Aceitar edições: Claude faz alterações e envia uma branch sem parar para aprovação
  • Plan: Claude propõe uma abordagem e aguarda sua aprovação 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

Claude clona os repositórios, executa seu script de configuração se configurado e começa a trabalhar. Cada tarefa recebe sua própria sessão e sua própria branch, portanto você não precisa esperar uma terminar antes de iniciar outra.

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.

Parâmetro Descrição
prompt Texto do prompt para pré-preencher na caixa de entrada. O alias q também é aceito.
prompt_url URL para buscar o texto do prompt, para prompts muito longos para incorporar em uma string de consulta. A URL deve permitir solicitações de origem cruzada. Ignorado quando prompt também está definido.
repositories Lista separada por vírgula de slugs owner/repo para pré-selecionar. O alias repo também é aceito.
environment Nome ou ID do ambiente para pré-selecionar.

Codifique cada valor em URL. O exemplo abaixo abre o formulário com um prompt e um repositório já selecionados:

https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp

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` diz "Não conectado ao Claude"

Se /web-setup responder com "Não conectado ao Claude. Execute /login primeiro.", a CLI não tem um login válido em claude.ai. Isso também pode acontecer quando um login anterior expirou. Execute /login, faça login com sua conta claude.ai e execute /web-setup novamente.

`/web-setup` avisa que seu token não tem o escopo `workflow`

Se /web-setup disser que seu token da CLI do GitHub não tem o escopo workflow, você pode continuar, mas o GitHub pode rejeitar alguns pushes feitos com esse token, como pushes que alteram arquivos de fluxo de trabalho do GitHub Actions. Para adicionar o escopo, execute gh auth refresh -s workflow no seu shell e execute /web-setup novamente.

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

No plano Team e Enterprise, o comando está oculto por padrão: a alternância de configuração rápida da web está desativada até que um administrador a ative. Enquanto estiver desativada, conecte o GitHub do navegador. O comando também está oculto quando um administrador desabilitou Claude Code na web para sua organização, ou quando sua organização Enterprise tem Zero Data Retention habilitado, o que torna Claude Code na web indisponível.

"Não foi possível criar um ambiente de nuvem" ou "Nenhum ambiente de nuvem disponível" ao usar `--cloud`

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, ou adicione um ambiente a partir do seletor de ambiente em claude.ai/code.

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. Trusted cobre a maioria dos gerenciadores de pacotes; None bloqueia 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.

Para depurar, adicione 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 um wait final 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, compartilhamento de sessão e correção automática de pull requests
  • Configure ambientes em nuvem: níveis de acesso à rede, variáveis de ambiente e scripts de configuração para sessões em nuvem
  • 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, /mobile mostra um código QR.