Conecte o Claude Code
A ferramenta de código da Anthropic, no terminal. Siga os passos abaixo: cada imagem mostra a tela que vai aparecer e onde clicar.
Antes de começar
- Uma assinatura do Claude (Pro ou superior) ou uma conta do Claude Console.
- Sua conta na RTCloud.
- 1
Abra o terminal
No seu computador
No Windows, aperte a tecla Windows, digite PowerShell e dê Enter. No Mac, abra o app Terminal. É uma janela de texto, com a linha começando em PS C:\ no Windows.
Os comandos deste tutorial vão nessa janela. Se você colar em uma conversa com a IA, eles viram mensagem e nada acontece.
- 2
Instale o Claude Code
No terminal
Já tem instalado? Pule este passo. Cole o comando do seu sistema, aperte Enter e espere terminar. Depois, feche a janela e abra um terminal novo.
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
Mac e Linux
curl -fsSL https://claude.ai/install.sh | bash
- 3
Confira se instalou
Em um terminal novo
No terminal novo, rode o comando abaixo. Se aparecer um número de versão, siga para o próximo passo.
Cole no terminal
claude --version
Apareceu que claude não é reconhecido?
É comum no Windows e não quer dizer que a instalação falhou: o Claude Code está no computador, mas o terminal ainda não sabe onde ele fica. Cole o comando do seu sistema uma vez só. Ele apenas ensina esse caminho.
Windows (PowerShell)
[Environment]::SetEnvironmentVariable('PATH', [Environment]::GetEnvironmentVariable('PATH', 'User') + ";$env:USERPROFILE\.local\bin", 'User')Mac (zsh)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
Linux (bash)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
Depois, feche esta janela, abra um terminal novo e rode claude --version outra vez. Quem usa o terminal de dentro de um editor precisa fechar e abrir o editor.
- 4
Adicione a RTCloud
No terminal
Cole o comando abaixo. O --scope user faz a RTCloud valer em qualquer pasta. Sem ele, ela fica presa à pasta em que você está.
Cole no terminal
claude mcp add --transport http --scope user rtcloud https://rtcloud.com.br/mcp
- 5
Abra o Claude Code numa pasta de trabalho
No terminal
Rode um comando de cada vez. Use a pasta de um projeto seu ou crie uma vazia, como aqui: o Claude Code pede acesso à pasta em que abrir.
1. Crie a pasta
mkdir $HOME/teste-rtcloud
2. Entre nela
cd $HOME/teste-rtcloud
3. Abra o Claude Code
claude
Não abra em C:\Windows\system32 nem na pasta do seu usuário: elas têm arquivos que a ferramenta não precisa ver.
- 6
Entre e confie na pasta
Dentro do Claude Code
Na primeira vez, escolha a opção 1, Claude account with subscription, e entre pelo navegador. Quando ele perguntar se confia na pasta, aperte a seta para baixo até Yes, I trust this folder e dê Enter.
A opção marcada no começo é No, exit. Se apertar Enter direto, ele fecha.
- 7
Autentique a RTCloud
Dentro do Claude Code
Digite /mcp e aperte Enter. Escolha rtcloud com as setas, aperte Enter e selecione Authenticate. O navegador abre sozinho.
Digite dentro do Claude Code
/mcp
- 8
Autorize na RTCloud
No navegador
A página da RTCloud abre sozinha. Entre na sua conta se ela pedir. As permissões de leitura já vêm marcadas: para o primeiro teste, é só clicar em Autorizar. Para a ferramenta poder alterar algo, use Liberar tudo ou marque uma a uma.
- 9
Faça o primeiro pedido
Dentro do Claude Code
Peça: Liste minhas aplicações. A ferramenta pode pedir sua aprovação antes de agir. Se aparecerem as suas aplicações, está tudo certo.
Pronto, está conectado
A conexão aparece em Ferramentas MCP, no painel. Toda alteração feita pela ferramenta fica registrada na sua Atividade. Quando quiser liberar mais, desconecte e autorize de novo com outras permissões.
Prefere usar uma chave?
Sem navegador, como em um servidor por SSH: gere uma chave MCP, salve na variável RTCLOUD_MCP_KEY e adicione assim:
Cole no terminal (Mac e Linux)
claude mcp add --transport http --scope user rtcloud https://rtcloud.com.br/mcp --header "Authorization: Bearer $RTCLOUD_MCP_KEY"
Deu algo errado?
Apareceu “Pedido não aceito” na página da RTCloud
Nada foi liberado na sua conta. Confira se o endereço está exato, sem espaço nem barra no fim, e conecte de novo. Se continuar, fale com o suporte e mande o print.
O terminal diz que claude não é reconhecido
O Claude Code está instalado, mas o terminal não sabe onde ele fica. Siga a correção do passo Confira se instalou, com imagens, e abra um terminal novo.
Apareceu que irm não é reconhecido
Você abriu o Prompt de Comando, não o PowerShell. Aperte a tecla Windows, digite PowerShell e use a janela em que a linha começa com PS.
O Claude Code fechou quando apertei Enter
A opção marcada era No, exit. Abra de novo com claude e aperte a seta para baixo antes do Enter.
O rtcloud não aparece no /mcp
Rode claude mcp list no terminal. Se ele não estiver na lista, repita o passo de adicionar com --scope user.
Digitei os comandos e virou uma conversa
Você está dentro de uma ferramenta, não no terminal. Volte ao PowerShell, onde a linha começa com PS C:\.
Conectou, mas ela não vê as minhas aplicações
Confira se a permissão Ver aplicações ficou marcada ao autorizar. Se precisar mudar, desconecte em Ferramentas MCP e conecte de novo.
Para desconectar
No painel da RTCloud, abra Ferramentas MCP e clique em Desconectar: o acesso acaba na hora. No terminal, rode claude mcp remove rtcloud --scope user.
Outras ferramentas
Coloque a sua IA para cuidar do deploy
Crie a conta, publique a aplicação e conecte a sua ferramenta em poucos minutos.