Como partilhar o Claude Code ou o Codex sem partilhar o portátil

O agente de programação na sua máquina é provavelmente o colega mais competente que tem, e a única pessoa que lhe pode pedir alguma coisa é você. O runtime, a subscrição, os repositórios e as credenciais residem todos num único computador. A permissão para os usar também.

Este guia aborda as soluções alternativas que as pessoas utilizam, o que cada uma compromete e como configurar uma sala onde outros utilizadores podem enviar trabalho ao seu agente sem nunca tocarem no seu portátil.

As soluções alternativas e o que custam

Cada uma destas opções troca segurança por alcance. A abordagem por salas não abdica de nenhum: a outra pessoa obtém a capacidade de pedir, você mantém a capacidade de decidir e a máquina continua a ser sua.

A relação disto com o Remote Control

Se a pessoa que precisa de acesso remoto for você, o Remote Control do Claude Code da Anthropic é a resposta integrada: o seu telefone torna-se uma janela para a sua própria sessão. Uma sala resolve o outro problema: outra pessoa diferente precisa de usar o agente, e você quer decidir o que ela pode executar. As duas soluções complementam-se; consulte Remote Control vs. uma sala de agente.

Configurar uma sala em cinco passos

Ligue, aprove a máquina, crie um agente, convide, aprove o primeiro pedido. As quatro ações perigosas continuam a pausar a seguir.

1. Ligue a máquina. No computador onde os seus agentes residem, execute o comando de ligação a partir da consola. O daemon deteta os runtimes instalados localmente, atualmente Claude Code e Codex, e reporta os endereços local e público da máquina para que possa distinguir os seus computadores.

2. Aprove a máquina. Nada é executado até confirmar na aplicação web que este computador é seu. Depois disso, o daemon desanexa-se e continua a correr em segundo plano. Registá-lo como serviço com muti service install faz com que seja iniciado no início de sessão e reiniciado em caso de falha.

3. Crie um agente. Um agente é um runtime associado a um diretório de trabalho, com o seu próprio nome e modo de permissão. Crie um por função: api para o repositório de backend, site para o site de marketing, ops para a pasta de exportações. Diretórios restritos tornam as aprovações raras e os erros pequenos.

4. Convide uma pessoa. Crie uma sala, adicione o agente e envie uma ligação de convite. A outra pessoa inicia sessão, entra na sala e vê o agente online. Não precisa de instalar nada.

5. Aprove o primeiro pedido. Quando mencionarem o agente, verá o pedido. Aprove-o uma vez ou marque a pessoa como “always allow” para esse agente. De qualquer forma, os quatro tipos de ações perigosas continuarão a pausar para si.

O que a outra pessoa vê

Tudo o que acontece na sala, e nada mais.

• A resposta do agente, transmitida à medida que é escrita.
• Cada chamada de ferramenta em tempo real: que comando foi executado, quais os ficheiros alterados e quantas linhas mudaram.
• O final do output do comando, para que um teste com falha seja visível sem ter de abrir o terminal.
• Qualquer ficheiro ou imagem produzido pelo agente, publicado nos outputs da sala.

Eles nunca veem os seus ficheiros, as suas variáveis de ambiente, as suas chaves ou as suas outras salas. O daemon carrega eventos da timeline; não carrega a working tree.

O que acontece numa chamada perigosa

Suponha que o seu cofundador pede ao agente para “corrigir o teste instável e fazer push”. O agente edita o teste, executa-o e, em seguida, tenta fazer git push para a main. Essa chamada é interrompida.

Recebe um cartão com as seguintes informações: quem pediu, que agente, o que pretende fazer e que regra acionou. Pode aprovar, rejeitar ou indicar ao agente para continuar apenas de leitura. Pode adicionar uma nota, e a nota tem o mesmo peso do que o pedido original. Aprove a partir da consola, do seu telemóvel ou, mais tarde, a partir de uma plataforma de chat; decidir num local aplica-se a todo o lado. Aprovações sem resposta expiram.

Reverter permissões

A partilha pode ser anulada instantaneamente, de quatro formas:

• Remover o membro da sala.
• Revogar a permissão de “always allow” para o agente.
• Revogar a máquina.
• Executar muti stop na máquina.

Qualquer tarefa em fila para essa pessoa é cancelada. Qualquer processo já em execução termina e permanece no histórico, mantendo a pista de auditoria completa.

Conselhos práticos

• Comece em modo só de leitura. Deixe que a outra pessoa explore a base de código e faça perguntas antes de permitir alterações.
• Um agente por diretório de trabalho. Uma pessoa que apenas precisa do repositório da documentação não deve mencionar o agente que tem acesso às configurações de produção.
• Dê nomes aos agentes pela sua função, não pelo modelo. deploy-checks indica a um colega de equipa o que pedir. claude-2 não.
• Mantenha a máquina ativa. Os pedidos aguardam na inbox enquanto esta suspende, mas a tampa de um portátil fechada durante todo o fim de semana resulta num colega pouco produtivo.

Perguntas frequentes

A outra pessoa precisa de ter o Claude Code ou o Codex instalado? Não. Só precisa de um navegador web e da ligação de convite. O agente corre na sua máquina com a sua subscrição.

Podem ver as minhas outras salas ou projetos? Não. As salas não partilham nada entre si. A pessoa apenas vê a sala para a qual foi convidada.

O agente lembra-se da conversa? Por predefinição, cada sala mantém a sua própria sessão persistente, pelo que o agente retém o contexto dessa sala. Pode configurar uma sala para iniciar uma nova sessão a cada pedido.

E se a minha máquina estiver offline? As mensagens ficam em fila na inbox do agente e são executadas por ordem assim que o daemon voltar a estar ativo. Pode remover ou reordenar itens na inbox antes de serem executados.

Em resumo: crie uma sala para o seu agente, convide uma pessoa, mantenha o controlo das aprovações e deixe de emprestar portáteis.