Pular para o conteúdo

Builder OS

&
Builder · OS
L03 · Instalação
PRÓXIMA L04
~6 MIN DE LEITURA

Lição 3 de 10: Instalação e primeiro acesso

lição 3/10 do Módulo 1
AO FIM, VOCÊ VAI TER
  • Claude Code instalado na superfície que você prefere (terminal, Cursor, VS Code, ou app desktop)
  • Autenticação feita por OAuth (sem API key copiada e colada em lugar nenhum)
  • Primeira mensagem trocada com o Claude, em qualquer pasta, antes de existir um projeto

Você vai instalar o Claude Code, autenticar e ver ele respondendo.

O objetivo é confirmar que o Claude Code está vivo na sua máquina e responde quando você fala com ele. A lição 04 cria o projeto.

Passo 1: Escolha a superfície

O Claude Code roda em 4 lugares. Pega a que você já usa pra trabalhar:

Passo 2: Autentique-se

A autenticação é por : o Claude Code abre uma janela do navegador, você loga na sua conta Anthropic (ou cria uma), e a sessão fica autorizada na sua máquina. Você nunca precisa colar uma em arquivo nenhum: nem em CLAUDE.md, nem em .env, nem em settings.json. Se algum tutorial pedir, ignora.

No terminal

terminal
claude login

Abre uma URL no navegador. Loga. Quando você voltar pro terminal, ele vai mostrar:

saída esperada
✓ Logged in as <seu-email>

A sessão fica salva localmente e renova sozinha; você não precisa relogar a cada uso.

No Cursor / VS Code

Abre o painel do Claude Code (⌘+L). A primeira vez vai mostrar um botão "Sign in to Anthropic". Clica, completa no navegador, volta. Painel agora mostra a interface de chat.

No app desktop

Mesma coisa, com botão "Sign in" na primeira tela.

Passo 3: Diga oi

Antes de criar projeto nenhum, confirma que o Claude responde. Vai pra qualquer pasta na sua home (cd ~ no terminal, ou abre o Cursor/desktop sem projeto carregado):

terminal
cd ~ && claude

A interface abre. Cole este prompt:

prompt · text
Oi! Sou novo no Claude Code. Em 2 frases curtas: o que você consegue fazer aqui que eu deveria saber antes de criar meu primeiro projeto?

A resposta vai mencionar coisas como: lê arquivos do diretório atual, roda comandos com sua aprovação, lembra do contexto via CLAUDE.md quando dentro de um projeto.

Você pode brincar mais um pouco se quiser:

  • "Lista os arquivos da minha home." Vai pedir aprovação pra rodar ls.
  • "Que dia é hoje?" Responde sem rodar nada, é texto puro.
  • "Cria um arquivo oi.txt com 'olá mundo'." Vai pedir aprovação pra escrever o arquivo.

Cada [y/n] é o modelo de permissões em ação. A lição 09 desce no detalhe; aqui é só pra você ver acontecendo.

Quando estiver satisfeito, sai com Ctrl+D (terminal) ou fecha o painel/janela. Apaga o oi.txt se criou (rm ~/oi.txt).

Takeaways

  • Claude Code roda em 4 superfícies (terminal, Cursor, VS Code, app desktop). Escolhe uma pra esta lição; pode adicionar outras depois.
  • Autenticação é OAuth, sem nenhuma chave em arquivo do projeto. A sessão fica salva localmente e renova sozinha.
  • Confirmação de que tá rodando = um prompt qualquer trocado em pasta vazia (não precisa de projeto ainda).
  • Em rede corporativa que bloqueia o callback, claude login --no-browser resolve.

Confirma que está rodando