Como instalar o gstack no Claude Code: passo a passo do zero ao primeiro comando

Fala aí, beleza? O Garry Tan, CEO da Y Combinator, abriu o código do setup de Claude Code que ele mesmo usa, e o pacote se chama gstack

A descrição do projeto é bem direta: "Use Garry Tan’s exact Claude Code setup", ou seja, tu roda o setup exato dele na tua máquina

É open source, licença MIT, sem tier pago, e vive no repositório garrytan/gstack

A descrição oficial fala em 23 ferramentas opinativas cobrindo papéis de CEO, Designer, Eng Manager, Release Manager, Doc Engineer e QA

E o repo já acumula mais de 128 mil estrelas no GitHub, o que dá uma noção do tamanho da onda

A boa notícia pra quem tá com preguiça: a instalação é curta

Um clone, um script, e os papéis começam a aparecer como slash commands dentro do Claude Code

Bora do zero até o primeiro comando?

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

O que você precisa antes de instalar o gstack

O README declara três pré-requisitos, e só isso:

• Claude Code instalado e funcionando
• Git
• Bun v1.0+

Dois detalhes que salvam tempo: tanto o bun quanto o node precisam estar no PATH

E o script setup aborta de imediato se o bun não estiver instalado, então não adianta tentar "na fé"

"Que PATH?" É a lista de pastas onde o sistema procura um programa quando tu digita o nome dele no terminal

Se tu digita bun --version e o terminal responde que não conhece o comando, ele não tá no PATH, e o setup vai morrer no primeiro segundo

Se o Claude Code ainda nem tá rodando na tua máquina, começa por ali antes: tem um guia aqui sobre primeiros passos com o Claude Code que resolve essa parte

Passo a passo: instalando o gstack na sua máquina

1. Clone o repositório dentro da pasta de skills do Claude Code

O comando de instalação individual faz tudo em sequência: clona, entra na pasta e roda o script

git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup

Repara no destino do clone: ~/.claude/skills/gstack

Não é uma pasta qualquer de projetos, é a pasta de skills do Claude Code

O erro comum deste passo: clonar em ~/Documentos/gstack ou no Desktop porque é onde tu sempre clona as coisas

2. Rode o ./setup e entenda o que ele faz

Se tu preferir separar em dois momentos, ou se precisar rodar de novo depois, é isto:

cd ~/.claude/skills/gstack && ./setup

Esse script não é enfeite, ele faz quatro coisas:

• instala as dependências JavaScript
• gera os arquivos SKILL.md de cada papel
• compila um binário standalone
• cria os symlinks dentro de ~/.claude/skills/

Ou seja: sem o setup, tu tem uma pasta com código dentro e mais nada acontecendo

São os symlinks que fazem o Claude Code enxergar cada papel

O erro comum deste passo: rodar o setup sem o bun instalado

Ele aborta na hora, e aí não é bug do projeto, é pré-requisito faltando

3. Verifique a instalação listando a pasta de skills

ls -la ~/.claude/skills/

O -la mostra os detalhes de cada item, e é aí que tu vê se os symlinks foram criados de verdade

O erro comum deste passo: pular a conferência

Parece bobo, mas é essa listagem que separa "instalei" de "acho que instalei"

4. Mantenha uma seção do gstack no CLAUDE.md do projeto

O README orienta manter uma seção do gstack no CLAUDE.md do projeto pro Claude Code reconhecer as skills

É o passo que mais gente esquece, justamente porque não tem comando pra rodar, é edição de arquivo mesmo

O erro comum deste passo: instalar tudo certinho na máquina e depois estranhar que dentro do projeto nada aparece

Erros comuns na instalação do gstack e como resolver

Se o teu problema for anterior a tudo isso, lá no próprio CLI, o caminho é outro: os erros na instalação do Claude Code têm causas bem diferentes das daqui

Agora, os que são do gstack mesmo:

Sintoma: um comando do gstack não é reconhecido

Causa provável: o symlink não foi criado

Solução: rodar o setup de novo

cd ~/.claude/skills/gstack && ./setup

É o mesmo comando do passo 2, e rodar duas vezes não quebra nada

Sintoma: o binário do browser não foi compilado

Solução: dá pra compilar na mão, dentro da pasta do gstack

cd ~/.claude/skills/gstack && bun install && bun run build

Sintoma: no macOS, o processo morre com SIGKILL (exit 137)

Causa: o --compile do Bun pode gerar uma assinatura de código corrompida, e o sistema simplesmente mata o processo

Solução: o próprio setup trata isso, removendo e reassinando o binário

Então aqui vale de novo a receita de sempre: roda o ./setup

Sintoma: no Windows, aparecem cópias no lugar de symlinks

No Windows sem o Modo de Desenvolvedor (MSYS2 / Git Bash), o setup usa cópia de arquivos em vez de symlink

Não é falha, é fallback

O efeito prático vem na manutenção, que é o próximo ponto

Prevenção, que é sempre mais barato

Antes de qualquer coisa: confere se bun e node estão no PATH

E depois de cada git pull do gstack, o README orienta rodar o setup de novo pros arquivos de skill baterem com o repositório

Em Unix e WSL os symlinks são mantidos, então nesses casos a repetição não é necessária

Tome cuidado com isso: é o tipo de detalhe que faz alguém jurar que "parou de funcionar do nada" depois de atualizar

O que aparece depois: os slash commands do gstack

Aqui é a parte legal, porque é o retorno prático de tudo que tu rodou

Depois de instalado, os papéis do gstack aparecem como slash commands dentro do Claude Code

A ideia por trás é bem clara: em vez de tu escrever um prompt gigante explicando "aja como um QA e faça X", tu chama o papel por um comando

Os comandos documentados, agrupados por finalidade:

Uma ressalva importante antes que tu vá contar: essa tabela é a lista de comandos DOCUMENTADOS, e ela não bate um a um com as ferramentas anunciadas na descrição do repositório

Ou seja, "ferramenta" e "slash command com nome próprio na doc" não são a mesma contagem, e eu prefiro te mostrar só o que tá documentado a chutar o resto

Três deles merecem detalhe, porque resolvem dor real de quem trabalha com agente:

/careful avisa antes de comandos destrutivos: rm -rf, DROP TABLE, force-push e git reset --hard

Os rm -rf da vida com agente solto é exatamente o pesadelo que esse comando tenta evitar

/freeze trava as edições em um diretório durante a depuração

É o "fica quietinho aqui nesse canto enquanto eu investigo", ótimo pra quando o agente resolve refatorar meio mundo enquanto tu só queria entender um bug

/qa consome automaticamente o plano de teste gerado na revisão de engenharia, sem copiar e colar manual

Esse encaixe entre os papéis é o que dá o sentido de "stack" no nome

E o /browse abre uma sessão de navegador que o agente usa pra navegar, tirar screenshot e verificar páginas: abrir o site, testar o deploy, conferir o fluxo visualmente

O binário nativo dele é compilado pra macOS e Linux (x64 e arm64), e o servidor do browse tem fallback automático pra Node.js

Como levar o gstack para o repositório do time

Instalou na tua máquina e gostou? Dá pra levar pro repo do projeto, aí todo mundo pega junto com o código

1. Copie a pasta pra dentro de .claude/skills do projeto

2. Remova o .git da cópia

3. Rode o setup dentro da nova pasta

Os três passos em sequência:

cp -Rf ~/.claude/skills/gstack .claude/skills/gstack && rm -rf .claude/skills/gstack/.git && cd .claude/skills/gstack && ./setup

"Por que remover o .git?" Porque assim os arquivos entram como arquivos reais commitados no teu repositório, e não como submódulo

O ganho é que os colegas não precisam clonar nada à parte: eles só rodam o ./setup uma vez

O erro comum deste passo: esquecer de remover o .git antes de commitar

Conclusão

Instalar gstack é basicamente um clone e um script

Recapitulando o caminho todo: confere Claude Code, Git e Bun v1.0+ com bun e node no PATH, clona em ~/.claude/skills/gstack, roda ./setup, verifica com ls -la ~/.claude/skills/ e mantém a seção do gstack no CLAUDE.md do projeto

Deu ruim? Roda o setup de novo, que é a resposta pra boa parte dos sintomas

É curto e é reversível, o que ajuda bastante a testar sem medo, ainda mais sendo open source com licença MIT e sem tier pago

O próximo passo concreto é escolher um comando e usar: /review num código que tu já conhece, ou /browse pra ver o agente abrindo a página

E depois de cada git pull do repositório, roda o ./setup de novo pra tudo continuar batendo

agora bora testar aí e ver no que dá 😀

até o próximo post!