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:
- 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.
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.
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.
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. Para iniciar um novo projeto, crie um repositório vazio no GitHub primeiro.
Com essa conexão, uma sessão pode clonar qualquer repositório público, mas pode trabalhar em um repositório privado apenas quando o Claude GitHub App está instalado nele. Instale o App em cada conta GitHub ou organização cujos repositórios privados você deseja usar. Em uma organização GitHub, um proprietário da organização pode precisar aprovar a instalação. Instalar o App também ativa Auto-fix, que permite que Claude responda a falhas de CI e comentários de revisão em pull requests nesses repositórios.
Se a integração solicitar que você instale o App neste ponto e você preferir fazer isso mais tarde, clique em Skip.
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. Em planos Team e Enterprise, /web-setup está disponível apenas após um Owner ativar Quick web setup.
Quando você executa /web-setup, Claude Code lê o token que gh auth token imprime, pede que você confirme e envia o token para Anthropic. Anthropic o armazena criptografado com sua conta claude.ai, e suas sessões em nuvem o usam para acesso ao GitHub até você removê-lo. Uma sessão em nuvem pode então acessar qualquer repositório que esse token possa acessar, sem nenhuma instalação do Claude GitHub App.
Se você já conectou o GitHub no navegador, /web-setup avisa que continuar substitui essa conexão para suas sessões em nuvem.
Autentique com a CLI do GitHub
No seu shell, autentique a CLI do GitHub se você ainda não o fez:
gh auth login
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.
Execute /web-setup
Na CLI do Claude Code, execute:
/web-setup
Confirme o prompt para enviar seu token gh para 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.
Remova o token `/web-setup`
Para remover o token da sua conta Claude, desconecte o GitHub em claude.ai/customize/connectors. Desconectar deleta as credenciais do GitHub que suas sessões em nuvem usam, quer tenham vindo do navegador ou de /web-setup, então as sessões em nuvem perdem acesso ao GitHub até você conectar novamente. Seu gh local permanece conectado, e o token permanece válido no GitHub.
Para invalidar o token em si, revogue-o no GitHub. Se você fez login em gh através do navegador, o token pertence à entrada GitHub CLI em Settings > Applications > Authorized OAuth Apps no GitHub, e revogar essa entrada também desconecta a CLI do GitHub em suas máquinas. As sessões em nuvem então perdem acesso ao GitHub até você executar gh auth login e /web-setup novamente.
Inicie uma tarefa
Com GitHub conectado e um ambiente criado, você está pronto para enviar tarefas.
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.
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.
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.
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.
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.
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.
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.
Solucionar problemas de configuração
Nenhum repositório aparece após conectar GitHub
Se você conectou GitHub no navegador, as sessões podem clonar qualquer repositório público, mas um repositório privado aparece apenas quando o Claude GitHub App está instalado na conta ou organização que o possui e o acesso ao repositório da instalação o inclui. Instale o Claude GitHub App lá, ou peça a um proprietário da organização para instalá-lo ou aprová-lo.
Se você conectou com /web-setup, as sessões acessam todos os repositórios que seu token gh pode acessar. Execute gh repo view OWNER/REPO no seu shell para verificar se seu login do GitHub CLI pode ver o repositório, e execute /web-setup novamente se você trocou de contas gh desde a conexão.
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 o GitHub CLI. Se você preferir não conectar GitHub, consulte Remote Control para executar Claude Code em sua própria máquina e monitorá-lo pela web.
"Não disponível para a organização selecionada"
Organizações Enterprise podem precisar que um Proprietário ative 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 "Not signed in to Claude. Run /login first.", o CLI não tem um login válido em claude.ai. Isso também pode acontecer quando um login anterior expirou. Execute /login, conecte-se com sua conta claude.ai, depois execute /web-setup novamente.
`/web-setup` avisa que seu token não tem o escopo `workflow`
Se /web-setup disser que seu token do GitHub CLI não tem o escopo workflow, você pode continuar, mas 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, depois execute /web-setup novamente.
`/web-setup` mostra "No commands match" ou "Unknown command"
/web-setup é executado dentro do Claude Code CLI, 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 No commands match "/web-setup", ou enviá-lo retorna Unknown command: /web-setup, o comando está oculto porque um requisito não é 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 /login para conectar-se com sua conta claude.ai.
Nos planos Team e Enterprise, o comando está oculto por padrão: a alternância Quick web setup está desativada até que um Proprietário a ative. Enquanto estiver desativada, conecte GitHub do navegador. O comando também está oculto quando um administrador desativou Claude Code na web para sua organização, ou quando sua organização Enterprise tem Zero Data Retention ativado, o que torna Claude Code na web indisponível.
"Could not create a cloud environment" ou "No cloud environment available" ao usar `--cloud`
Os recursos de sessão remota criam um ambiente em nuvem padrão automaticamente se você não tiver um. Se você vir "Could not create a cloud environment", a criação automática falhou. Se você vir "No cloud environment available", seu CLI é anterior à criação automática. Em qualquer caso, execute /web-setup no Claude Code CLI, ou adicione um ambiente 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.
Trustedcobre a maioria dos gerenciadores de pacotes;Nonebloqueia todos eles. - O script faz referência a um arquivo ou caminho que não existe em um clone recente.
- 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, anexe || 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, geralmente ultrapassam o 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 em série. - 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 suspensões de repetição do script de configuração, pois um loop de repetição travado conta contra o orçamento.
A sessão continua em execução após fechar a aba
Isso é por design. Fechar a aba ou navegar para longe não interrompe a sessão. Ela continua em execução em segundo plano até que Claude termine a tarefa atual, depois fica ociosa. Na barra lateral, você pode arquivar uma sessão para ocultá-la da 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,
/mobilemostra um código QR.