Guia do Embaixador
Claude Code + hub4u
macOS
Windows
Progresso
0 de 9

Este guia tem duas partes. A primeira instala o Claude Code dentro do VS Code, e são três passos sem terminal. A segunda te coloca dentro do hub4u, que é onde você vai descrever a sua área, e são cinco passos.

Siga na ordem. A primeira parte leva cerca de 5 minutos; a segunda, cerca de 20. Se travar em algum passo, pare e chame o facilitador em vez de improvisar.

Pré-requisitos
  • Mac com macOS 13 (Ventura) ou mais recente, 4 GB de RAM ou mais
  • VS Code 1.94 ou mais recente. Se o seu é antigo, atualize antes
  • A conta Claude fornecida pela empresa, no seu e-mail @market4u.com.br. Não use conta pessoal e não contrate assinatura
  • Sua conta corporativa @market4u.com.br do Google
Tenha em mãos antes de começar
  • O pacote do hub4u, um arquivo .zip, que o facilitador te envia
  • Seu e-mail @market4u.com.br e a senha. Você vai usá-lo em três logins diferentes: a conta Claude, o Drive do computador e o conector do Drive dentro do Claude
  • O nome da sua área como a empresa a chama, minúsculo e com hífen: customer-success, expansao, saf
  • Meia hora sem reunião. O setup faz perguntas e é melhor responder de uma vez
Parte 1 de 2
Instalar o Claude Code

Três passos, e nenhum deles usa terminal. A extensão do VS Code já traz o Claude Code dentro dela, então não existe Node.js para instalar, nem comando para colar, nem senha de administrador.

1
Passo 1 de 8

Entrar com a conta da empresa

Este é o passo que mais trava gente, e é por isso que ele vem primeiro. A empresa já forneceu a sua conta Claude. Você não precisa contratar nada, nem pagar nada, nem usar conta pessoal. O que você precisa é garantir que é a conta da empresa que está ativa no navegador antes de abrir o VS Code, porque é ela que a extensão vai pegar.

O que fazer
1
Acesse claude.ai e entre com a conta @market4u.com.br que a empresa te forneceu.
2
Se o navegador já estava logado numa conta pessoal, saia dela primeiro. Ter as duas abertas é a causa mais comum de o Claude Code aparecer sem acesso depois.
3
Confirme que o Claude abre normalmente e responde. Deixe essa aba logada e siga para o próximo passo.
Se o Claude Code disser que você não tem acesso Não é problema seu e não se resolve comprando plano. Significa que o acesso ao Claude Code precisa ser habilitado no seu usuário por quem administra a conta da empresa. Pare e chame o facilitador. Nunca contrate assinatura pessoal para contornar: além do custo, o seu trabalho ficaria fora da conta corporativa.
console.anthropic.com é outra coisa O Console é a via de crédito de API, cobrada por uso, e não é o que usamos neste projeto. Criar conta lá não libera o Claude Code. O login é o da sua conta claude.ai corporativa.
2
Passo 2 de 8

Instalar a extensão no VS Code

Se ainda não tiver o VS Code, baixe em code.visualstudio.com. A extensão é a instalação inteira do Claude Code: ela carrega o programa dentro de si.

O que fazer
1
Abra o VS Code.
2
Abra as extensões com + Shift + X.
3
Busque Claude Code, publicada pela Anthropic.
4
Clique em Install e aguarde.
Dica Se a extensão não aparecer depois de instalar, feche e abra o VS Code, ou rode Developer: Reload Window pela paleta de comandos ( + Shift + P).
3
Passo 3 de 8

Abrir o painel e entrar na conta

O ícone do Claude Code é uma faísca. Ele aparece na barra lateral esquerda, no canto inferior direito e no topo do editor quando você tem um arquivo aberto.

O que fazer
1
Clique no ícone da faísca na barra lateral esquerda. O painel do Claude abre.
2
Aparece uma tela de login. Clique em Sign in.
3
O navegador abre. Autorize com a mesma conta claude.ai do passo 1.
4
Volte ao VS Code. O painel já está pronto para conversar, em português.
Dica Dentro do painel, digite / para ver os comandos disponíveis. É assim que você vai chamar /setup e os outros comandos do hub4u mais adiante.
Se der ruim Se a tela de login não aparecer, recarregue a janela com Developer: Reload Window. Existe também uma instalação do Claude Code por linha de comando, que serve para quem precisa digitar claude no terminal, mas nada neste guia precisa dela. Se algum dia precisar, chame o facilitador.
Parte 2 de 2
Entrar no hub4u

Agora a ferramenta existe. Estes cinco passos preparam o ambiente onde você vai documentar a sua área. Eles não têm relação com a instalação do Claude Code: são exigências do hub4u e do Drive corporativo.

4
Passo 4 de 8

Instalar o Google Drive no computador

A sua pasta de trabalho vai ficar dentro do seu Meu Drive, e é isso que te dá backup sem você pensar nisso. Sincronizar não é publicar: o repositório da empresa é outro lugar, e nada do que você escrever aparece lá antes de você mandar.

O que fazer
1
Baixe o Google Drive para computador no site oficial do Google e rode o instalador. Ele pede a sua senha do Mac uma vez, como qualquer instalador.
2
Abra o app e entre com a conta @market4u.com.br. O login abre no navegador. Não use conta pessoal.
3
Espere a primeira sincronização. O ícone do Drive fica na barra de cima; enquanto ele estiver girando, a pasta ainda não existe.
Dica Duas coisas que costumam assustar e não são problema. O caminho do Drive passa por Library, que o Finder esconde por padrão: é normal, é esse mesmo. E não é preciso aprovar extensão de sistema nem reiniciar o Mac: em macOS 13 ou mais novo o Drive usa o mecanismo nativo e aparece direto no Finder, em Locais.
5
Passo 5 de 8

Colocar a pasta do hub4u no lugar certo

Leia este passo com calma. Ele define onde o seu trabalho vai morar, e é o que mais custa tempo quando sai errado.

É uma pasta só. A pasta do hub4u que o facilitador te envia é, ao mesmo tempo, o programa e o seu espaço de trabalho: você abre ela no VS Code, e é dentro dela que o repositório da sua área vai nascer. Por isso ela vai para dentro do Meu Drive, e não para a Área de Trabalho nem para Downloads.

Extrair e posicionar
1
O facilitador te envia o arquivo hub4u.zip. Baixe.
2
dois cliques no arquivo. O Mac cria uma pasta ao lado dele.
3
No Finder, abra Google Drive na barra lateral, em Locais, e entre em Meu Drive.
4
Crie ali uma pasta chamada hub4u, se ela ainda não existir.
5
Arraste a pasta extraída para dentro dela e renomeie com o nome da sua área.
6
Pode apagar o arquivo .zip. Não precisa mais dele.
Caminho final da sua pasta
/Users/seu-usuario/Library/CloudStorage/GoogleDrive-seu-email/Meu Drive/hub4u/sua-area
Regras do nome Só letras sem acento, números e hífen, tudo minúsculo. Exemplo: customer-success, expansao, saf. É o mesmo nome que você vai dizer ao /setup.
Não trabalhe aqui A única coisa proibida é trabalhar direto na pasta da sua área dentro do Drive compartilhado da empresa. Ali é destino, não oficina. O seu Meu Drive é outro lugar, e é o lugar certo.
Atenção O Google também cria um atalho curto na sua pasta de usuário, /Users/seu-usuario/Google Drive. Ele é um link, e alguns programas tropeçam nele. Quando precisar do caminho, pegue sempre pelo Finder, com botão direito no arquivo → Copiar como caminho segurando a tecla Option.
Como voltar amanhã O VS Code reabre sozinho a última pasta que você usou. Se ele abrir vazio, vá em Arquivo → Abrir Recente e escolha a pasta da sua área. É sempre essa.
6
Passo 6 de 8

Ligar o conector do Google Drive

O Claude precisa de acesso de leitura ao Drive para conferir, depois, que o que você publicou realmente chegou lá. É uma conexão separada do aplicativo de sincronização que você acabou de instalar.

O que fazer
1
No painel do Claude, digite /mcp.
2
Escolha o Google Drive e conclua a autorização no navegador, com a conta corporativa.
3
Feche o VS Code e abra de novo.
4
Rode /mcp outra vez e confirme que aparece como conectado.
Atenção O passo 3 não é frescura, é a armadilha mais comum aqui: autorizar não basta. Enquanto você não reiniciar, as ferramentas do Drive não aparecem na sessão, e parece que a autorização falhou. Se ainda assim não aparecer, pode ser que o TI precise liberar o aplicativo Claude no Workspace. Chame o facilitador.
Dica Este passo não bloqueia você de começar a documentar. Ele só faz falta na hora de publicar. Se travar aqui, siga para o próximo e volte depois.
7
Passo 7 de 8

Rodar o setup do hub4u

A pasta já está no lugar. Agora é abrir ela no VS Code e chamar o comando. Sempre esta pasta, sempre o mesmo caminho.

O que fazer
1
No VS Code, use Arquivo → Abrir Pasta e escolha a pasta da sua área, dentro de Meu Drive/hub4u.
2
Abra o painel do Claude pelo ícone da faísca.
3
Digite /setup. O M4 se apresenta, faz uma entrevista curta sobre a sua área e monta o ambiente com você.
4
Ele mostra a árvore que vai criar e espera a sua aprovação antes de escrever qualquer coisa.
Dica Os comandos do hub4u só aparecem quando a pasta aberta no VS Code é a da sua área. Se você abrir outra pasta e digitar /, eles não aparecem, e parece que a instalação falhou. O /setup roda uma vez na vida; depois dele, toda sessão começa com /iniciar.
No fim do setup Ele vai pedir o caminho da pasta da sua área no Drive compartilhado, que é o destino da publicação. Esse destino ainda está sendo definido, então é normal você não ter o caminho hoje: deixe em branco, siga em frente e documente. Não invente caminho e não peça acesso por conta própria. O estado atualizado fica em documentar.leandrozenkaram.com. Nada é publicado neste passo.
8
Passo 8 de 8

Documentar a primeira coisa

Aqui o trabalho começa. São três comandos, na ordem, e você conversa com o Claude em português normal em cada um deles.

O ciclo
1
/estruturar monta o levantamento da sua área nas três portas: estrutura, indicadores e processos. Só a lista, nada é documentado ainda.
2
/documentar escreve uma cadeira, um indicador ou um processo, e amarra as ligações entre eles.
3
/publicar consolida o que você fez, fecha versão e roda a auditoria. Subir para o repositório da empresa só acontece quando você pedir.
Dica Duas réguas que valem mais que qualquer comando. Documente a cadeira, não a pessoa: o que a posição precisa dar conta, não o que você entrega hoje. E nunca aceite uma suposição: se não souber, escreva pendente, não medido ou a confirmar.
Continua aqui Você não vai digitar documento nenhum. O caminho que mais rende é falar, em reunião gravada ou conversando com o Claude. O passo a passo de como conduzir isso, com pautas e prompts prontos, está em documentar.leandrozenkaram.com.
Pronto. Agora é trabalho de verdade.

O Claude Code está rodando no seu VS Code e o seu espaço no hub4u existe. A partir daqui, cada sessão começa com /iniciar e fecha com /publicar. O próximo passo é aprender a conduzir: o guia de como documentar falando, com pautas e prompts prontos, está em documentar.leandrozenkaram.com.

Este guia tem duas partes. A primeira instala o Claude Code dentro do VS Code, e são três passos sem terminal. A segunda te coloca dentro do hub4u, que é onde você vai descrever a sua área, e são cinco passos.

O caminho é o mesmo do Mac; só mudam os cliques do Explorador e o formato do caminho da pasta. Siga na ordem. Se travar, pare e chame o facilitador em vez de improvisar.

Pré-requisitos
  • Windows 10 versão 1809 ou mais recente, ou Windows 11, em 64 bits
  • VS Code 1.94 ou mais recente. Se o seu é antigo, atualize antes
  • A conta Claude fornecida pela empresa, no seu e-mail @market4u.com.br. Não use conta pessoal e não contrate assinatura
  • Sua conta corporativa @market4u.com.br do Google
Tenha em mãos antes de começar
  • O pacote do hub4u, um arquivo .zip, que o facilitador te envia
  • Seu e-mail @market4u.com.br e a senha. Você vai usá-lo em três logins diferentes: a conta Claude, o Drive do computador e o conector do Drive dentro do Claude
  • O nome da sua área como a empresa a chama, minúsculo e com hífen: customer-success, expansao, saf
  • Meia hora sem reunião. O setup faz perguntas e é melhor responder de uma vez
Parte 1 de 2
Instalar o Claude Code

Três passos, e nenhum deles usa terminal. A extensão do VS Code já traz o Claude Code dentro dela, então não existe Node.js para instalar, nem comando para colar, nem "executar como administrador".

1
Passo 1 de 8

Entrar com a conta da empresa

Este é o passo que mais trava gente, e é por isso que ele vem primeiro. A empresa já forneceu a sua conta Claude. Você não precisa contratar nada, nem pagar nada, nem usar conta pessoal. O que você precisa é garantir que é a conta da empresa que está ativa no navegador antes de abrir o VS Code, porque é ela que a extensão vai pegar.

O que fazer
1
Acesse claude.ai e entre com a conta @market4u.com.br que a empresa te forneceu.
2
Se o navegador já estava logado numa conta pessoal, saia dela primeiro. Ter as duas abertas é a causa mais comum de o Claude Code aparecer sem acesso depois.
3
Confirme que o Claude abre normalmente e responde. Deixe essa aba logada e siga para o próximo passo.
Se o Claude Code disser que você não tem acesso Não é problema seu e não se resolve comprando plano. Significa que o acesso ao Claude Code precisa ser habilitado no seu usuário por quem administra a conta da empresa. Pare e chame o facilitador. Nunca contrate assinatura pessoal para contornar: além do custo, o seu trabalho ficaria fora da conta corporativa.
console.anthropic.com é outra coisa O Console é a via de crédito de API, cobrada por uso, e não é o que usamos neste projeto. Criar conta lá não libera o Claude Code. O login é o da sua conta claude.ai corporativa.
2
Passo 2 de 8

Instalar a extensão no VS Code

Se ainda não tiver o VS Code, baixe em code.visualstudio.com. A extensão é a instalação inteira do Claude Code: ela carrega o programa dentro de si.

O que fazer
1
Abra o VS Code.
2
Abra as extensões com Ctrl + Shift + X.
3
Busque Claude Code, publicada pela Anthropic.
4
Clique em Install e aguarde.
Dica Se a extensão não aparecer depois de instalar, feche e abra o VS Code, ou rode Developer: Reload Window pela paleta de comandos (Ctrl + Shift + P).
3
Passo 3 de 8

Abrir o painel e entrar na conta

O ícone do Claude Code é uma faísca. Ele aparece na barra lateral esquerda, no canto inferior direito e no topo do editor quando você tem um arquivo aberto.

O que fazer
1
Clique no ícone da faísca na barra lateral esquerda. O painel do Claude abre.
2
Aparece uma tela de login. Clique em Sign in.
3
O navegador abre. Autorize com a mesma conta claude.ai do passo 1.
4
Volte ao VS Code. O painel já está pronto para conversar, em português.
Dica Dentro do painel, digite / para ver os comandos disponíveis. É assim que você vai chamar /setup e os outros comandos do hub4u mais adiante.
Se der ruim Se a tela de login não aparecer, recarregue a janela com Developer: Reload Window. Existe também uma instalação do Claude Code por linha de comando, que serve para quem precisa digitar claude no terminal, mas nada neste guia precisa dela. Se algum dia precisar, chame o facilitador.
Parte 2 de 2
Entrar no hub4u

Agora a ferramenta existe. Estes cinco passos preparam o ambiente onde você vai documentar a sua área. Eles não têm relação com a instalação do Claude Code: são exigências do hub4u e do Drive corporativo.

4
Passo 4 de 8

Instalar o Google Drive no computador

A sua pasta de trabalho vai ficar dentro do seu Meu Drive, e é isso que te dá backup sem você pensar nisso. Sincronizar não é publicar: o repositório da empresa é outro lugar, e nada do que você escrever aparece lá antes de você mandar.

O que fazer
1
Baixe o Google Drive para computador no site oficial do Google e rode o instalador. Se ele pedir para reiniciar, reinicie.
2
Abra o app e entre com a conta @market4u.com.br. O login abre no navegador. Não use conta pessoal.
3
Espere a primeira sincronização. O Drive aparece como uma unidade nova no Explorador, quase sempre G:. Se a sua instalação estiver em modo espelho, ele aparece como uma pasta dentro de C:\Users\seu-usuario. Vale a que aparecer.
Dica O nome da pasta muda com o idioma da conta e pode ser Meu Drive ou My Drive. Quando precisar do caminho, abra o Explorador, clique na barra de endereço e copie de lá. Copie, nunca digite.
5
Passo 5 de 8

Colocar a pasta do hub4u no lugar certo

Leia este passo com calma. Ele define onde o seu trabalho vai morar, e é o que mais custa tempo quando sai errado.

É uma pasta só. A pasta do hub4u que o facilitador te envia é, ao mesmo tempo, o programa e o seu espaço de trabalho: você abre ela no VS Code, e é dentro dela que o repositório da sua área vai nascer. Por isso ela vai para dentro do Meu Drive, e não para a Área de Trabalho nem para Downloads.

Extrair e posicionar
1
O facilitador te envia o arquivo hub4u.zip. Baixe.
2
Abra o Explorador de Arquivos e entre na unidade do Drive, quase sempre G:, depois em Meu Drive.
3
Crie ali uma pasta chamada hub4u, se ela ainda não existir.
4
Clique com o botão direito no .zip, escolha Extrair Tudo e aponte o destino para essa pasta hub4u.
5
Renomeie a pasta extraída com o nome da sua área.
6
Pode apagar o arquivo .zip. Não precisa mais dele.
Caminho final da sua pasta
G:\Meu Drive\hub4u\sua-area
Regras do nome Só letras sem acento, números e hífen, tudo minúsculo. Exemplo: customer-success, expansao, saf. É o mesmo nome que você vai dizer ao /setup.
Não trabalhe aqui A única coisa proibida é trabalhar direto na pasta da sua área dentro do Drive compartilhado da empresa. Ali é destino, não oficina. O seu Meu Drive é outro lugar, e é o lugar certo.
Atenção ao OneDrive Em máquina corporativa o OneDrive costuma capturar Documentos e Área de Trabalho sem avisar. Se a sua pasta cair lá, você acaba com dois clientes de sincronização brigando pelo mesmo arquivo. Confira que o caminho começa na unidade do Google Drive.
Como voltar amanhã O VS Code reabre sozinho a última pasta que você usou. Se ele abrir vazio, vá em Arquivo → Abrir Recente e escolha a pasta da sua área. É sempre essa.
6
Passo 6 de 8

Ligar o conector do Google Drive

O Claude precisa de acesso de leitura ao Drive para conferir, depois, que o que você publicou realmente chegou lá. É uma conexão separada do aplicativo de sincronização que você acabou de instalar.

O que fazer
1
No painel do Claude, digite /mcp.
2
Escolha o Google Drive e conclua a autorização no navegador, com a conta corporativa.
3
Feche o VS Code e abra de novo.
4
Rode /mcp outra vez e confirme que aparece como conectado.
Atenção O passo 3 não é frescura, é a armadilha mais comum aqui: autorizar não basta. Enquanto você não reiniciar, as ferramentas do Drive não aparecem na sessão, e parece que a autorização falhou. Se ainda assim não aparecer, pode ser que o TI precise liberar o aplicativo Claude no Workspace. Chame o facilitador.
Dica Este passo não bloqueia você de começar a documentar. Ele só faz falta na hora de publicar. Se travar aqui, siga para o próximo e volte depois.
7
Passo 7 de 8

Rodar o setup do hub4u

A pasta já está no lugar. Agora é abrir ela no VS Code e chamar o comando. Sempre esta pasta, sempre o mesmo caminho.

O que fazer
1
No VS Code, use Arquivo → Abrir Pasta e escolha a pasta da sua área, dentro de Meu Drive/hub4u.
2
Abra o painel do Claude pelo ícone da faísca.
3
Digite /setup. O M4 se apresenta, faz uma entrevista curta sobre a sua área e monta o ambiente com você.
4
Ele mostra a árvore que vai criar e espera a sua aprovação antes de escrever qualquer coisa.
Dica Os comandos do hub4u só aparecem quando a pasta aberta no VS Code é a da sua área. Se você abrir outra pasta e digitar /, eles não aparecem, e parece que a instalação falhou. O /setup roda uma vez na vida; depois dele, toda sessão começa com /iniciar.
No fim do setup Ele vai pedir o caminho da pasta da sua área no Drive compartilhado, que é o destino da publicação. Esse destino ainda está sendo definido, então é normal você não ter o caminho hoje: deixe em branco, siga em frente e documente. Não invente caminho e não peça acesso por conta própria. O estado atualizado fica em documentar.leandrozenkaram.com. Nada é publicado neste passo.
8
Passo 8 de 8

Documentar a primeira coisa

Aqui o trabalho começa. São três comandos, na ordem, e você conversa com o Claude em português normal em cada um deles.

O ciclo
1
/estruturar monta o levantamento da sua área nas três portas: estrutura, indicadores e processos. Só a lista, nada é documentado ainda.
2
/documentar escreve uma cadeira, um indicador ou um processo, e amarra as ligações entre eles.
3
/publicar consolida o que você fez, fecha versão e roda a auditoria. Subir para o repositório da empresa só acontece quando você pedir.
Dica Duas réguas que valem mais que qualquer comando. Documente a cadeira, não a pessoa: o que a posição precisa dar conta, não o que você entrega hoje. E nunca aceite uma suposição: se não souber, escreva pendente, não medido ou a confirmar.
Continua aqui Você não vai digitar documento nenhum. O caminho que mais rende é falar, em reunião gravada ou conversando com o Claude. O passo a passo de como conduzir isso, com pautas e prompts prontos, está em documentar.leandrozenkaram.com.
Pronto. Agora é trabalho de verdade.

O Claude Code está rodando no seu VS Code e o seu espaço no hub4u existe. A partir daqui, cada sessão começa com /iniciar e fecha com /publicar. O próximo passo é aprender a conduzir: o guia de como documentar falando, com pautas e prompts prontos, está em documentar.leandrozenkaram.com.