O que mudou em 27 de agosto de 2026. O onboarding do MAGNUS não usa mais VS Code. Não é questão de gosto: medimos os dois no mesmo servidor, no mesmo dia, com o mesmo cliente. O VS Code consumia 6.408 MB de memória do servidor, o aplicativo Claude consome 1.478 MB. Quatro vezes menos, e sem precisar instalar extensão nenhuma. Se você já usava o VS Code, avise a Equipe Técnica antes de migrar: tem um processo antigo que precisa ser encerrado no servidor primeiro.
O que o seu computador precisa ter
| Item | Onde baixar | Observação |
|---|---|---|
| Git for Windows (só no Windows) | git-scm.com/downloads/win | Instale antes do aplicativo Claude, com as opções padrão, e reinicie o computador. No Mac, pule este item. |
| Aplicativo Claude | baixar para Windows · baixar para Mac | Página geral: claude.com/download |
| Assinatura Claude | Pro, Max ou Team | É a sua assinatura, no seu nome. Chave de API não funciona. |
Configuração, uma vez só
São cinco minutos, e a Equipe Técnica conduz junto com você.
1. Instalar a chave do seu computador
A Equipe Técnica cola um comando pronto no PowerShell (Windows) ou no Terminal (Mac). Você não precisa gerar nada: o comando já vem montado com a chave do seu acesso. Ao terminar, tem que aparecer CONECTADO SEM SENHA na tela.
É esse passo que faz o seu computador virar um computador confiável, aquele que entra direto no servidor sem senha nenhuma.
2. Abrir o aplicativo Claude e fazer login
Entre com a sua conta Claude, a mesma da sua assinatura.
3. Ir na aba Code
Fica no topo da janela, ao lado de Chat e Cowork. É na aba Code que o seu MAGNUS vive. Nas outras duas, o seu time não existe.
4. Criar a conexão com o servidor
Clique no seletor de ambiente (o primeiro botão acima da caixa de texto, escrito Local) e escolha “+ Add SSH connection”. Preencha exatamente assim:
| Campo | O que preencher |
|---|---|
| Name | MAGNUS de SEU-NOME |
| SSH Host | magnus |
| SSH Port | 22 |
| Identity File | deixe vazio |
Esse campo Identity File em branco é o que faz a conexão funcionar. Se preencher, a conexão trava e você vai precisar apagar e criar de novo.
5. Escolher a pasta
Clique em Selecionar pasta... e digite:
/opt/magnus/SEU-NOMEEste é o erro mais comum, preste atenção nele. A pasta certa começa com /opt/magnus/. A pasta que começa com /home/ tem nome parecido e abre um Claude comum, sem o seu MAGNUS, sem a sua memória e sem a sua equipe. Se errar, a faixa do topo avisa em vermelho: ⚠ fora da pasta do MAGNUS. É só voltar e trocar a pasta.
6. Conferir se deu certo
Pergunte “quem é você?”. Ele deve se apresentar como o seu MAGNUS, e no topo da conversa aparece a faixa laranja de identidade:
⬢ MAGNUS · Seu Nome · v21Essa faixa é o seu confirmador de sempre: nome do seu escritório e versão do motor. Enquanto ela estiver laranja, você está no lugar certo.
Por que entrar sem senha é mais seguro
O mecanismo por trás disso se chama chave SSH, e funciona com um par de arquivos: um público e um privado.
A chave pública pode circular sem risco, é ela que fica cadastrada no servidor. A chave privada nunca sai do seu computador, e ninguém deveria pedir para você compartilhá-la, nem mesmo o seu próprio Magnus.
Diferente de uma senha, a chave não pode ser adivinhada por tentativa e erro, e cada computador tem a sua própria. Isso significa que se um dia você perder o computador ou trocar de máquina, dá para revogar o acesso daquele computador específico em segundos, sem afetar os outros.
No dia a dia
- Abrir é rápido: aplicativo Claude, aba Code, escolher a sessão do seu Magnus na lista ou clicar em Novo. Trinta segundos, sem senha.
- Cada aba aberta é um assistente na memória do servidor. Feche as que já cumpriram a tarefa: o histórico fica salvo e você reabre quando quiser.
- Fechar o aplicativo não perde nada. O seu Magnus e todo o material vivem no servidor, não no seu computador. Se formatar o notebook, nada se perde.
- Anexar imagem e arquivo funciona direto na conversa.
Se algo der errado
| Sintoma | O que fazer |
|---|---|
| “Não foi possível configurar o Claude Code” | Feche o aplicativo por completo, abra de novo, apague a conexão e crie outra com o Identity File vazio |
| “Couldn’t open an SFTP session” | O servidor está sobrecarregado. Avise a Equipe Técnica, não é problema do seu computador |
| Ele responde como um Claude comum, sem conhecer o seu escritório | A pasta está errada. Troque para /opt/magnus/SEU-NOME |
| Pede senha toda vez | A chave do passo 1 não foi instalada. Avise a Equipe Técnica |
| Conecta e desconecta sozinho | Geralmente é a sua conexão de internet. Teste com cabo ou em outra rede antes de avisar |
Segundo computador
Repita o passo 1 com a Equipe Técnica. Uma chave por computador, revogável em segundos, sem afetar os outros.
Perguntas frequentes
Por que o acesso deixou de ser pelo VS Code?
Por consumo de memória do servidor, medido no mesmo dia e na mesma máquina de um cliente real: o VS Code ocupava 6.408 MB e o aplicativo Claude ocupa 1.478 MB. Quatro vezes menos, com uma tela mais simples e sem menu de programador. O aplicativo Claude conecta no servidor por conta própria, sem extensão nenhuma.
É seguro conectar sem senha?
Sim. A chave SSH é mais segura que senha, não menos. Ela usa um par de arquivos: um público, que pode circular sem risco, e um privado, que nunca sai do seu computador e ninguém deve pedir. Diferente de senha, não pode ser adivinhada por tentativa e erro, e dá pra revogar o acesso de um computador específico em segundos.
Preciso repetir esse processo em cada computador?
Sim, uma vez por computador. Cada máquina tem a sua própria chave, e quem gera é a Equipe Técnica: você recebe um comando pronto pra colar. Isso é uma vantagem de segurança, porque dá pra desligar o acesso de um computador perdido ou roubado sem afetar os outros.
O Magnus responde como um Claude comum, sem conhecer o meu negócio. O que aconteceu?
A pasta aberta está errada, e esse é o erro mais comum. A pasta certa começa com /opt/magnus/ seguido do seu nome. A pasta que começa com /home/ tem nome parecido e abre um Claude comum, sem a sua memória e sem a sua equipe. Quando isso acontece, a faixa do topo avisa em vermelho: ⚠ fora da pasta do MAGNUS. É só trocar a pasta.
