Manual de configuração
Claude Code no VS Code, do download às primeiras skills · Mac
macOS 13 ou mais recente
Progresso
0 de 8

Este manual monta o ambiente de trabalho com IA da sua agência: o VS Code como mesa de trabalho, o Claude Code ligado dentro dele e o kit inicial de skills instalado. É copiar, colar e seguir. Não precisa saber programar.

São 8 passos em duas partes. Reserve de 25 a 35 minutos e siga na ordem.

O que você vai precisar
Parte 1 · Instalar e ligar
VS Code com o Claude Code dentro

O VS Code é o editor onde a operação vai morar: as pastas, os arquivos e o Claude trabalhando ao lado. Primeiro instalamos o editor, depois ligamos o Claude nele.

1
Passo 1 de 8

Baixar e instalar o VS Code

O VS Code é gratuito e feito pela Microsoft. Se você já usa, confira só a versão no fim deste passo.

Instalar
1
Acesse code.visualstudio.com e clique em Download for macOS
2
Abra o arquivo baixado (.zip). Ele vira o aplicativo Visual Studio Code
3
Arraste o aplicativo para a pasta Aplicativos no Finder
4
Abra o VS Code pelo Launchpad ou com ⌘ + Espaço e Visual Studio Code. Se o Mac avisar que o app foi baixado da internet, clique em Abrir
Atenção

Arraste para Aplicativos antes de abrir. Rodando direto da pasta Downloads, o VS Code não consegue se atualizar sozinho. Já tem o VS Code? Confira em Code › About Visual Studio Code: precisa ser a versão 1.94 ou mais nova.

2
Passo 2 de 8

Instalar a extensão Claude Code

A extensão é o que coloca o Claude dentro do VS Code: um painel de conversa ao lado dos seus arquivos, em que você vê cada alteração antes de aceitar. Com o VS Code instalado, clique no botão:

Instalar a extensãoO navegador pergunta se pode abrir o VS Code. Confirme e clique em Install.

Link de instalação: vscode:extension/anthropic.claude-code

Ou pelo próprio VS Code
1
Abra a aba de extensões: ícone de quatro quadrados na barra lateral esquerda, ou ⌘ + Shift + X
2
Busque por Claude Code
3
Escolha a extensão publicada pela Anthropic, com o selo azul de verificado
4
Clique em Install
Atenção

Existem extensões com nome parecido feitas por terceiros. Confira que o publicador é Anthropic antes de instalar.

Dica

Se a faísca do Claude não aparecer depois de instalar, feche e abra o VS Code de novo.

3
Passo 3 de 8

Instalar o Claude Code no terminal do VS Code

A extensão já traz o Claude para o painel. Instalar também o comando claude no terminal libera o diagnóstico, a instalação de skills por linha de comando e o uso fora do VS Code. Não precisa abrir outro programa: o VS Code tem um terminal embutido.

Abrir o terminal
1
No menu, vá em Terminal › New Terminal, ou pressione Ctrl + ` (tecla da crase)
2
Abre um painel escuro na parte de baixo da janela. É ali que você cola os comandos

Copie, cole no terminal e pressione Enter. Leva cerca de um minuto:

Terminal do VS Code
%curl -fsSL https://claude.ai/install.sh | bash
Installing Claude Code...

Depois, feche esse terminal (ícone de lixeira no canto do painel), abra um novo e confira:

Terminal do VS Code
%claude --version
2.x.x (Claude Code)
Terminal do VS Code
%claude doctor
Mostra o que está certo e o que está pendente na instalação
Dica

Não precisa instalar Node.js nem nada antes. O instalador oficial baixa o programa pronto e se atualiza sozinho. Se aparecer command not found, é só fechar o terminal e abrir outro.

4
Passo 4 de 8

Criar a pasta da operação e abrir no VS Code

O Claude Code trabalha sobre uma pasta: tudo que ele lê, cria e edita fica ali dentro. Por isso a agência inteira trabalha numa pasta só, sempre organizada do mesmo jeito.

Padrão de pasta
1
Em Documentos, crie uma pasta chamada Operacao-NomeDaAgencia (sem acento e sem espaço)
2
Dentro dela, crie três pastas: clientes, processos e modelos
3
No VS Code, vá em File › Open Folder (⌘ + O) e escolha a pasta Operacao-NomeDaAgencia
4
Na pergunta Do you trust the authors of the files in this folder?, clique em Yes, I trust the authors
Atenção

Se você clicar em No, o VS Code abre em Modo Restrito e a extensão do Claude Code não funciona. Para corrigir, clique em Restricted Mode na barra inferior e marque a pasta como confiável.

Dica

Prefira uma pasta local. Pasta dentro do Google Drive ou OneDrive funciona, mas a sincronização às vezes trava arquivos enquanto o Claude está editando. Se a equipe precisa compartilhar, a gente configura o GitHub depois.

5
Passo 5 de 8

Abrir o painel do Claude e entrar na conta

O ícone do Claude Code é uma faísca laranja (✻). Abra o painel por um destes caminhos:

Abrir o painel
1
Clique em ✻ Claude Code na barra azul, no canto inferior direito da janela, ou
2
Clique na faísca na barra lateral esquerda, ou
3
Pressione ⌘ + Shift + P, digite Claude Code e escolha Open in New Tab

Na primeira vez aparece a tela de login. Clique em Sign in, autorize no navegador e volte para o VS Code.

Atenção

O Claude Code exige um plano pago: Pro, Max, Team, Enterprise ou conta de Console (API). O plano gratuito do Claude.ai não dá acesso. Use a mesma conta em que a agência já assina o Claude.

Dica

Se aparecer Not logged in · Please run /login ou o painel ficar em branco, pressione ⌘ + Shift + P e rode Developer: Reload Window. Isso resolve a maioria dos travamentos.

6
Passo 6 de 8

Configurar o projeto: modo de permissão e memória

Dois ajustes que fazem diferença desde o primeiro dia.

1. Modo de permissão
1
Embaixo da caixa de mensagem existe um seletor de modo
2
Deixe em Manual nas primeiras semanas: antes de alterar qualquer arquivo, o Claude mostra o antes e o depois lado a lado e espera você aceitar
3
Quando pegar confiança, passe para Edit automatically, em que ele edita sem perguntar a cada arquivo

2. Memória do projeto. O arquivo CLAUDE.md é o que o Claude lê toda vez que você abre uma conversa nessa pasta: quem é a agência, para quem vende, como fala, onde guarda cada coisa. Cole o pedido abaixo no painel, trocando o que está entre colchetes:

Painel do Claude Code
>Crie o arquivo CLAUDE.md desta pasta. Ele é a memória da nossa operação e você vai ler esse arquivo toda vez que abrirmos uma conversa aqui. Use estas informações: - Agência: [nome da agência] - O que vendemos: [serviços e pacotes] - Para quem: [nicho e perfil de cliente] - Como falamos: [tom de voz em 3 palavras] - Regras: responda sempre em português; cada cliente tem uma pasta dentro de clientes/; processos desenhados ficam em processos/; modelos reutilizáveis ficam em modelos/. Antes de salvar, me mostre o rascunho.
Dica

O CLAUDE.md é vivo. Toda vez que você corrigir o Claude em algo que vale para sempre ("nunca chame cliente de lead", "proposta sempre em PDF"), peça para ele anotar lá. É a forma mais barata de ele parar de repetir o mesmo erro.

Parte 2 · Skills
As primeiras skills da operação

Skill é um manual de procedimento que o Claude lê na hora certa: um arquivo com o passo a passo de uma tarefa que a sua agência repete. Você instala as que já existem prontas e, com o tempo, transforma os processos que desenhamos no Destrava em skills próprias. É assim que o processo sai do papel e passa a rodar no dia a dia, do mesmo jeito para qualquer pessoa da equipe.

7
Passo 7 de 8

Instalar o kit inicial de skills

São três pacotes, todos publicados pela própria Anthropic. Clique no botão de cada um: o VS Code abre o painel do Claude Code com a janela de instalação pronta. Quando ele perguntar onde instalar, escolha Install for you (vale para todos os seus projetos).

skill-creatorMarketplace oficial

A skill que cria skills. É ela que transforma um processo da sua operação em um procedimento que o Claude segue sempre igual. A mais importante das três.

Instalar skill-creatorAbre o VS Code direto na instalação.

Link de instalação: vscode://anthropic.claude-code/install-plugin?plugin=skill-creator

document-skillsanthropics/skills

Leitura e criação de PDF, Word, Excel e PowerPoint. Relatório de cliente, proposta, planilha de mídia e apresentação saem prontos em arquivo, não só em texto no chat.

Instalar document-skillsNa primeira vez ele pede para adicionar a fonte anthropics/skills. Confirme.

Link de instalação: vscode://anthropic.claude-code/install-plugin?plugin=document-skills&marketplace=anthropics/skills

marketinganthropics/knowledge-work-plugins

Conteúdo, planejamento de campanha, briefing, revisão de marca e relatório de performance. A base de trabalho de uma agência.

Instalar marketingTambém pede para adicionar a fonte na primeira vez. Confirme.

Link de instalação: vscode://anthropic.claude-code/install-plugin?plugin=marketing&marketplace=anthropics/knowledge-work-plugins

Dica

Depois de instalar, a janela mostra Restart Claude to apply plugin changes. Clique e as skills passam a valer. Para ver tudo que está instalado, digite /plugins no painel.

Se o botão não abrir o VS Code (alguns navegadores bloqueiam), faça pelo terminal do VS Code (Ctrl + `). Cole uma linha por vez:

Terminal do VS Code
%claude plugin install skill-creator@claude-plugins-official
Terminal do VS Code
%claude plugin marketplace add anthropics/skills
Terminal do VS Code
%claude plugin install document-skills@anthropic-agent-skills
Terminal do VS Code
%claude plugin marketplace add anthropics/knowledge-work-plugins
Terminal do VS Code
%claude plugin install marketing@knowledge-work-plugins
✔ Successfully installed
Atenção

Skill roda com as mesmas permissões que você dá ao Claude. Só instale de fonte que você conhece: as três acima são da Anthropic. Skill achada em grupo ou site desconhecido, leia o arquivo antes ou mande para a gente olhar.

8
Passo 8 de 8

Criar a primeira skill da sua operação

Aqui o Destrava vira rotina. Escolha um processo que já desenhamos juntos (onboarding de cliente novo é um bom começo), abra uma conversa nova no painel e cole o pedido abaixo trocando o que está entre colchetes:

Painel do Claude Code
>Use a skill-creator para transformar um processo da nossa operação em uma skill deste projeto. O processo é: [cole aqui o passo a passo, por exemplo o onboarding de cliente novo desenhado no Destrava]. Me faça as perguntas que faltarem antes de escrever. Salve a skill na pasta .claude/skills deste projeto e me diga como chamar.

O Claude vai fazer perguntas, escrever a skill e testar. Depois disso, qualquer pessoa da equipe chama o processo digitando / e o nome da skill, ou só pedindo a tarefa com as próprias palavras.

Dica

Uma skill por processo, e só quando o processo já roda no papel. Skill de processo que ainda muda toda semana vira retrabalho. A ordem é sempre a mesma: desenhar, rodar, só então automatizar.

Ambiente pronto para operar.

Você tem o VS Code com o Claude Code ligado, a pasta da operação no padrão, a memória do projeto escrita e o kit inicial de skills instalado. No próximo encontro, traga a primeira skill criada: a gente revisa junto.