Manual de configuração
Claude Code no VS Code, do download às primeiras skills · Windows
Windows 10 (1809+) ou 11
Progresso
0 de 9

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 9 passos em duas partes. No Windows entra um passo a mais, o Git. Reserve de 30 a 40 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 9

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 Windows
2
Abra o instalador baixado e aceite o contrato
3
Na tela Select Additional Tasks, marque as quatro opções, principalmente Add to PATH e Add "Open with Code" action
4
Clique em Install e, no fim, em Finish com Launch Visual Studio Code marcado
Atenção

Não precisa ser administrador: o instalador padrão grava na sua pasta de usuário. Já tem o VS Code? Confira em Help › About: precisa ser a versão 1.94 ou mais nova.

2
Passo 2 de 9

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 Ctrl + 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 9

Instalar o Git para Windows

Recomendado. O Git traz o Git Bash, o terminal que o Claude Code usa para rodar comandos no Windows. Sem ele o Claude cai no PowerShell e funciona com menos recursos. Também é ele que vai ligar a operação ao GitHub mais para frente.

Durante o instalador
1
Acesse git-scm.com/downloads/win e baixe o instalador de 64-bit
2
Abra o arquivo e vá clicando em Next. As opções padrão já estão corretas
3
Na tela Adjusting your PATH environment, mantenha a opção do meio: Git from the command line and also from 3rd-party software
4
Clique em Install e depois feche e abra o VS Code, para ele enxergar o Git
4
Passo 4 de 9

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, que no Windows é o PowerShell.

Abrir o terminal
1
No menu, vá em Terminal › New Terminal, ou pressione Ctrl + ` (tecla da crase)
2
Abre um painel na parte de baixo da janela começando com PS C:\Users\SeuNome>. O PS confirma que é o PowerShell

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

Terminal do VS Code · PowerShell
PS>irm https://claude.ai/install.ps1 | iex
Installing Claude Code...

Depois, feche o VS Code e abra de novo (o Windows só enxerga o comando novo assim) e confira num terminal novo:

Terminal do VS Code · PowerShell
PS>claude --version
2.x.x (Claude Code)
Terminal do VS Code · PowerShell
PS>claude doctor
Mostra o que está certo e o que está pendente na instalação
Atenção

Se aparecer 'irm' is not recognized, o terminal está no Prompt de Comando (CMD). Clique na setinha ao lado do + no painel do terminal, escolha PowerShell e rode de novo. Não precisa rodar como administrador.

5
Passo 5 de 9

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 (Este Computador › 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 (Ctrl + K e depois Ctrl + 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.

6
Passo 6 de 9

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 Ctrl + 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 Ctrl + Shift + P e rode Developer: Reload Window. Isso resolve a maioria dos travamentos.

7
Passo 7 de 9

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.

8
Passo 8 de 9

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
PS>claude plugin install skill-creator@claude-plugins-official
Terminal do VS Code
PS>claude plugin marketplace add anthropics/skills
Terminal do VS Code
PS>claude plugin install document-skills@anthropic-agent-skills
Terminal do VS Code
PS>claude plugin marketplace add anthropics/knowledge-work-plugins
Terminal do VS Code
PS>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.

9
Passo 9 de 9

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.