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
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 Anthropic | 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 --remote |
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 automaticamente, Plan | Perguntar, Aceitar edições automaticamente, 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 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.
Visite claude.ai/code
Vá para claude.ai/code e faça login com sua conta Anthropic.
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.
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.
Para um primeiro projeto, deixe os padrões e clique em Criar ambiente. Você pode editá-lo depois ou criar ambientes adicionais para diferentes projetos.
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.
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.
Execute /web-setup
Na CLI do Claude Code, execute:
/web-setup
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 --remote ou configurar tarefas recorrentes com /schedule.
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 padrão é Aceitar edições automaticamente, onde Claude faz alterações e envia uma branch sem parar para aprovação. Mude para Plan mode 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 Ask, modo Auto ou permissões Bypass. Consulte Modos de permissão para a lista completa.
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.
Solucione problemas de configuração
Nenhum repositório aparece após conectar GitHub
O aplicativo Claude GitHub precisa de acesso explícito a cada repositório que você deseja usar. Em github.com, abra Configurações → Aplicativos → Claude → Configurar e verifique se seu 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 retorna "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 ainda vê o erro, sua CLI é mais antiga que v2.1.80 ou você está autenticado com uma chave de API ou provedor de terceiros em vez de uma assinatura claude.ai. Execute claude update, depois /login 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 --remote 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. {/* max-version: 2.1.100 */}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.
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.
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.