Playbook·Capítulo 02·10 min

Instalação do Claude Code (ou Desktop)

Instalar Claude Code (CLI) ou criar Project no Claude Desktop. Garantir que abriu na pasta certa.

Resultado esperado: Claude aberto na pasta do kit e reconhecendo a estrutura.

Você tem duas formas de rodar o kit. Escolhe UMA. Não precisa ser as duas.

Qual escolher?

9 em cada 10 mentorados usam o Claude Desktop (o app). É mais simples no dia a dia: você abre, digita e pronto. Claude Code (terminal) é pra quem já mexe com programação. Se está em dúvida, vai de Desktop.

Opção A — Claude Desktop (app) ·recomendado

Baixar e instalar o Claude Desktop

Vai em claude.ai/download no navegador. Clica no botão que aparece pro seu sistema operacional (Windows, Mac ou Linux). Baixa o instalador.

Roda o instalador igual qualquer outro programa: clica em "Avançar" até terminar. Abre o app. Faz login com a sua conta Anthropic (mesma do site claude.ai).

Criar o Project pro KPA V30

Com o Claude Desktop aberto, você vai ver uma sidebar à esquerda. Olha pra cima da sidebar, vai ter um botão + New Project. Clica nele.

No campo nome do Project, escreve: Kit Piloto Automático V30
No campo System Prompt / Custom Instructions, cola o conteúdo do arquivo: 22_CLAUDE_DESKTOP/cos-desktop-system-prompt.md (abre o arquivo no Bloco de Notas, seleciona tudo com Ctrl+A, copia com Ctrl+C, cola no Project).
Em Project Knowledge, clica em "Upload files" e adiciona os arquivos listados em 22_CLAUDE_DESKTOP/knowledge-files.md (são uns 10-15 arquivos do Tier 1).
Clica em Save ou Create.

Vai ficar parecido com isso:

Claude Desktopclaude.ai

Projects

Kit Piloto Automático V30

Projetos pessoais

Estudos

Kit Piloto Automático V30

Project criado · 15 arquivos no Knowledge · system prompt configurado

00_INDEX.md

CLAUDE.md

cos-desktop-system-prompt.md

INICIO_RAPIDO.md

cos.md

voz-ptbr.md

Validar que o Project está funcionando

Dentro do Project, escreve essa mensagem no chat e manda:

O que você vai ver

leia esta pasta e me diga por onde começar

Identifiquei o Kit Piloto Automático V30. A trilha recomendada é: 1. Roda /preflight-acessos pra mapear acessos 2. Roda /setup-nicho pra adaptar ao seu negócio 3. Roda /primeira-tarefa pra gerar tua primeira entrega útil Mas antes, melhor rodar o wizard único de instalação: "instalar kpa30" Ele cobre tudo em 7 etapas. Bora?

Pergunte ao Claude...

Funcionou?

Se o Claude respondeu reconhecendo o V30, está tudo certo. Vai pro próximo capítulo (Setup do nicho).

Não reconheceu o kit?

Provavelmente o upload do Project Knowledge não terminou ou faltou arquivo. Volta no Project, clica em "Manage Project Knowledge" e confirma que os arquivos do Tier 1 estão lá. Se persistir, manda print pra suporte@choqueounada.com.

Opção B — Claude Code (terminal) ·avançado

Só se você já mexe com terminal

Se a palavra "terminal" te assusta, fica no Desktop (Opção A). O Code tem o mesmo poder, mas a interface é o terminal preto com comandos. Programador prefere. Aluno comum, não.

Instalar o Claude Code

Vai em claude.com/code e segue a instalação oficial. Quando terminar, abre o terminal e confirma:

terminal

$ claude --version
claude version 1.x.x

Se aparecer a versão, está instalado.

Abrir o Claude Code na pasta correta

Aqui mora o erro mais comum dos alunos. Você precisa navegar PARA DENTRO da pasta do kit e abrir o Claude DALI. Não na home, não no Desktop genérico.

No Mac/Linux:

terminal

$ cd ~/Desktop/Kit-Piloto-Automatico-V30
$ claude

No Windows (PowerShell):

terminal

$ cd $env:USERPROFILE\Desktop\Kit-Piloto-Automatico-V30
$ claude

Pasta certa vs pasta errada

Visualmente, é assim que tem que ficar. Se o Claude abriu na pasta de cima, dá errado. Se abriu na pasta de baixo, dá certo:

Pasta errada❌ Não abre o Claude aqui

Desktop

Kit-Piloto-Automatico-V30

outros arquivos

Downloads

Pasta certa✓ Abre o Claude dentro daqui

Kit-Piloto-Automatico-V30

00_OS

00_INDEX.md

CLAUDE.md

02_AGENTS

15_PRODUCT_RELEASE

README.md

Validar que reconheceu o kit

Com o Claude aberto na pasta correta, digita:

Output esperado

leia esta pasta e me diga por onde começar

Detectei o Kit Piloto Automático V30. Estrutura V30 reconhecida em 00_OS/, 02_AGENTS/, 04_DIRETRIZES/, 12_WHATSAPP_STACK/, 18_AUTOMATION_STACK/. Recomendo começar pelo wizard único: /instalar-kpa30 Ele te guia em 7 etapas (~15-20 min): dependências, .env, MCPs, Meta CLI opcional, Projects do Desktop, onboarding do negócio, primeira tarefa.

Pergunte ao Claude...

Próximo passo direto

Independente da Opção (A ou B), o próximo comando é instalar kpa30 (Desktop) ou /instalar-kpa30 (Code). Ele cobre dependências, MCPs, Meta CLI, Project, onboarding e primeira tarefa em um único fluxo guiado.