← Voltar ao curso
Nível 1 — Fundamentos · Módulo 1.8 — Primeiro contato com Claude Code

1.8.2 · Setup atual: instalação e primeiro login

4 min de vídeo TODOS

Objetivo: ao final, o consultor tem o Claude Code instalado e autenticado, e entende a relação entre CLI, extensão e PATH.

O que você precisa levar desta aula

  1. CLI e extensão do VS Code são instalações diferentes. A extensão não coloca claude no PATH.
  2. Com plano pago você não precisa de chave de API. O login com sua conta basta.
  3. A pasta onde você abre o Claude Code é o escopo dele.

As três formas de instalar

Forma O que dá Instale se…
CLI Comando claude em qualquer terminal. Ambiente mais completo: todos os comandos e skills Sempre. É a base
Extensão VS Code Painel gráfico no editor, com diff visual Sempre, se você usa VS Code. Recomendado para começar
App de desktop Claude Code sem terminal Já instalado no módulo 1.2

CLI

# macOS e Linux
curl -fsSL https://claude.ai/install.sh | bash

No Windows, siga o instalador em code.claude.com/docs/en/setup.

Depois, em qualquer terminal:

claude

Extensão do VS Code

  1. Requisito: VS Code 1.94 ou superior (Ajuda → Sobre)
  2. Cmd+Shift+X (Mac) ou Ctrl+Shift+X (Windows/Linux)
  3. Busque "Claude Code" → Install
  4. Se não aparecer depois de instalar, recarregue a janela: Developer: Reload Window na paleta de comandos

Funciona também em forks do VS Code (Cursor, Kiro) e via Open VSX.

⚠️ A confusão número um: extensão e PATH

A extensão traz a própria cópia do CLI para o painel dela, mas não coloca claude no seu PATH.

Você instalou O painel do VS Code funciona claude no terminal funciona
Só a extensão ✅ ❌ command not found
Só o CLI ❌ (sem painel) ✅
Os dois ✅ ✅

Instale os dois. São complementares, não alternativos.

Login

Primeira execução abre o navegador para autorização. Depois disso, autenticado.

Com plano pago (Pro, Max, Team, Enterprise) você não precisa de chave de API. Chave de API serve para integração programática — Nível 3. Se uma instrução te manda gerar chave de API para uso diário, está desatualizada.

claude: command not found — as duas causas

Causa Solução
Você instalou só a extensão do VS Code Instale o CLI
O PATH não foi recarregado Feche e abra o terminal. Se persistir, verifique o PATH

Verificação:

which claude      # macOS e Linux
where claude      # Windows

Sem saída, o binário não está no PATH.

O escopo é a pasta onde você abre

Diferente do Cowork, você não conecta uma pasta: a pasta onde você executa claude é o escopo.

cd ~/Meridiano/Fase2/Evidencias
claude

Ele vê essa pasta e as subpastas. Vale o mesmo princípio da pasta mínima da aula 1.7.2: abra na pasta certa, não na raiz.

📖 Instalação do Claude Code · VS Code

Quiz — 3 questões

1.Você instalou a extensão do Claude Code no VS Code. Abre um terminal, digita claude e recebe "command not found".
  • a)É um bug da extensão; reinstale

    Não é bug. É comportamento documentado.

  • b)A extensão não coloca claude no PATH — instale o CLI separadamente

    Correto. A extensão traz a própria cópia do CLI para o painel dela, e só para ele.

  • c)Você precisa reiniciar o computador

    Reiniciar não instala o que não foi instalado. (Reabrir o terminal resolveria o caso de PATH não recarregado, mas aqui o CLI não existe.)

Ver resposta e por quê
❌a) Não é bug. É comportamento documentado.
✅b) Correto. A extensão traz a própria cópia do CLI para o painel dela, e só para ele.
❌c) Reiniciar não instala o que não foi instalado. (Reabrir o terminal resolveria o caso de PATH não recarregado, mas aqui o CLI não existe.)
2.Você tem plano Team. Para usar o Claude Code no dia a dia:
  • a)Precisa gerar uma chave de API no console

    Chave de API é para integração programática (Nível 3), não para uso diário.

  • b)Precisa de chave de API só na primeira vez

    Não precisa em momento nenhum para uso interativo.

  • c)O login com a sua conta basta; não precisa de chave de API

    Correto. Qualquer plano pago serve.

Ver resposta e por quê
❌a) Chave de API é para integração programática (Nível 3), não para uso diário.
❌b) Não precisa em momento nenhum para uso interativo.
✅c) Correto. Qualquer plano pago serve.
3.Como você define em qual pasta o Claude Code vai trabalhar? ---
  • a)A pasta onde você executa claude é o escopo

    Correto. Vale o mesmo princípio da pasta mínima: abra na pasta certa.

  • b)Conectando a pasta, como no Cowork

    Esse é o mecanismo do Cowork. No Code é diferente.

  • c)Nas configurações do Claude Code

    Não é uma configuração; é a pasta corrente da execução.

Ver resposta e por quê
✅a) Correto. Vale o mesmo princípio da pasta mínima: abra na pasta certa.
❌b) Esse é o mecanismo do Cowork. No Code é diferente.
❌c) Não é uma configuração; é a pasta corrente da execução.