Como instalar o AgentKit (ak CLI) do zero para o Claude Code (2026)
Você consegue instalar o AgentKit (a CLI ak) para o Claude Code em menos de 5 minutos, em 5 passos: (1) ter o Claude Code instalado, (2) instalar o binário ak com um comando de uma linha, (3) rodar ak login para autorizar sua conta, (4) rodar ak kit init engineer --target claude-code --global para carregar um kit e (5) digitar /ak: dentro do Claude Code. Uma coisa que você precisa acertar: a sua chave de licença ativa o aplicativo de desktop, não a CLI — a CLI é autorizada ao entrar na sua conta.
Cada comando deste guia veio da documentação oficial em agentkit.best/docs e docs.agentkit.best (verificado em 08/2026). A CLI ak está no canal beta no momento, então comandos e flags podem mudar — confira o comando mais recente na documentação antes de rodar.
Qual AgentKit? A CLI ak para o Claude Code, não o AgentKit da OpenAI
Antes de copiar um único comando, reserve 30 segundos para ter certeza de que está instalando a coisa certa. A palavra "agentkit" está espalhada por vários produtos sem relação entre si agora: OpenAI AgentKit (lançado em 10/2025), o agentkit da BCG-X (um starter kit em Next.js/FastAPI/LangChain), o agents-cli do Google e mais alguns sites de mesmo nome. Instale um deles por engano e os comandos nunca vão funcionar para o Claude Code.
Este artigo é sobre: o kit para o Claude Code em agentkit.best, controlado por uma CLI chamada
ak. É o sucessor do antigo Claude Kit (ockfoi renomeado paraak). Ele transforma o Claude Code (além do Codex e do Copilot) em um "time de desenvolvimento e marketing com IA" por meio de skills e agents. Se você procura o produto da OpenAI ou da BCG, não é este.
Para a história completa por trás da mudança de nome e do porquê de o ak substituir o ck, leia como o Claude Kit foi renomeado para AgentKit (de ck para ak).
Antes de instalar (pré-requisitos)
O AgentKit roda por cima do Claude Code — ele não o substitui. Você precisa de duas coisas antes de começar:
- ① Claude Code instalado e funcionando. Verifique com
claude --version. Se aparecer um erro "command not found", instale primeiro o Claude Code usando este guia de instalação do Claude Code (pré-requisito). O Claude Code precisa de Node 18+, e você também vai precisar de um plano Claude (Pro, Max ou API) para rodar o modelo. - ② Uma conta AgentKit. Você entra na CLI com um e-mail ou uma chave de API. Para de fato baixar um kit (Engineer ou Marketing), você precisa de uma permissão vinculada a essa conta — ou seja, você já é dona do kit.
Um ponto que confunde muita gente: o próprio binário ak é nativo e não precisa de Node.js nem de Bun para rodar. Mas quando o kit de destino é o Claude Code, o ambiente do Claude Code ainda precisa de Node 18+. São duas coisas separadas.
Ainda não tem um kit? Você ainda pode instalar a CLI e fazer login, mas o
ak kit initvai avisar que falta a permissão. Se quiser usar de verdade, dê uma olhada nos planos do AgentKit e garanta uma licença (20% de desconto pelo link) — os kits Engineer e Marketing são compra única cada um, e o Bundle combina os dois.
Passo 1 - Instale a CLI ak (macOS / Linux / Windows)
O instalador detecta automaticamente seu SO e arquitetura, baixa a build estável, verifica o checksum SHA-256 e instala em ~/.local/bin. Escolha o comando do seu sistema operacional:
macOS / Linux:
curl -fsSL https://agentkit.best/install.sh | shWindows (PowerShell):
irm https://agentkit.best/install.ps1 | iexSe a rede da sua empresa bloquear o domínio principal, use o domínio reserva releases.agentkit.best/install.sh (ou .ps1). Algumas variáveis de ambiente opcionais são úteis:
AK_INSTALL_DIR- muda o diretório de instalação se você preferir não usar o padrão.AK_CHANNEL=beta- instala o canal beta (mais novo, possivelmente menos estável).AK_VERSION=x.y.z- fixa uma versão específica.
Assim que estiver instalado, verifique na hora com dois comandos:
ak --version
ak doctorO ak --version mostra o número da versão; o ak doctor examina seu ambiente e reporta PATH, permissões e conflitos — se tudo estiver verde, você está pronta. Uma dica: se o ak doctor apontar um problema de PATH, não corra para o login e a instalação do kit; conserte o PATH primeiro, porque quase todo erro depois vem daí. No macOS/Linux o binário fica em ~/.local/bin/ak, então dá para rodá-lo pelo caminho completo para uma checagem rápida antes de se preocupar com o PATH.
Passo 2 - Entre na conta e autorize (ak login)
É aqui que mora a maior parte da confusão, então leia com atenção.
Uma chave de licença NÃO ativa a CLI. A chave de licença ativa apenas o aplicativo de desktop do AgentKit. A CLI
aké autorizada (habilitada) ao entrar na sua conta. Se você ficar procurando por um campo do tipo "cole sua chave de licença" no terminal, nunca vai achar — ele não existe.
Em uma máquina pessoal (abre um navegador ou envia um OTP por e-mail):
ak login --email [email protected]Em CI ou qualquer ambiente não interativo, use uma chave de API:
ak login --api-key ak_live_... --no-interactiveConfirme que você entrou na conta certa e veja a que você tem acesso:
ak whoami
ak licensesO ak whoami diz em qual conta você está logada; o ak licenses lista as permissões (kits) que você pode baixar. Se o ak licenses voltar vazio mesmo com você certa de que comprou um kit, confira de novo se não está logada com o e-mail errado.
Segurança: nunca faça commit nem compartilhe sua chave de API (ela tem o prefixo ak_live_, que bots procuram no GitHub). Em uma máquina compartilhada, lembre-se de rodar ak logout quando terminar.
Passo 3 - Instale um kit no Claude Code (ak kit init)
Agora chegamos à parte que carrega skills e agents no Claude Code. O comando padrão para o Engineer Kit:
ak kit init engineer --target claude-code --globalTroque engineer por marketing se estiver instalando o Marketing Kit. A flag --global instala para todos os projetos; tire-a se quiser apenas no diretório atual.
Você não precisa instalar todas as skills — dá para escolher a dedo e manter seu contexto enxuto:
ak kit init engineer --target claude-code --global --skills ak-cook,ak-plan
ak kit init engineer --target claude-code --global --exclude-skills ak-deep-swePara ver quais kits e skills estão disponíveis antes de instalar:
ak kit list-kits
ak versionsAinda não tem o kit Engineer/Marketing? Este passo precisa de uma permissão. Veja o que tem dentro do Engineer Kit para saber quais skills e fluxos ele traz, ou garanta o kit Engineer ou Marketing — 20% de desconto, agora $79.20/kit se já decidiu.
Passo 4 - Teste no Claude Code (/ak:)
Abra o Claude Code em um projeto, digite / e depois ak: — você vai ver os comandos de barra que o kit acabou de carregar aparecerem como sugestões:
/ak:cook # implement a feature within scope
/ak:plan # plan the work, break it into phases
/ak:fix # fix bugs, failing tests, CI
/ak:ask # quick questions about the codebaseExperimente rodar /ak:cook em uma tarefa real pequena (digamos, adicionar um endpoint) para confirmar que toda a cadeia de instalação está ligada. Se o Claude Code aceitar o comando e começar a percorrer o fluxo do kit, você instalou com sucesso. Se você digitar /ak: e nenhum comando aparecer, geralmente é porque o kit não foi carregado no destino certo — volte e rode ak kit init com a flag --target claude-code correta, ou reinicie o Claude Code para ele recarregar a lista de comandos. A esta altura você percorreu toda a cadeia de verificação em várias camadas: ak --version (o binário roda), ak doctor (ambiente limpo), ak whoami (logada), ak licenses (tem permissão) e, por fim, /ak: aparecendo no Claude Code (o kit está ativo).
Migrando do antigo Claude Kit (de ck para ak)
Se você usava o Claude Kit (ck) antes, o ak é o sucessor direto. Não deixe os dois binários conviverem — o antigo ck pode sequestrar seu PATH ou deixar um shim conflitante. Depois de instalar o ak, rode:
ak doctor --check ck_shim_collisionEste comando detecta conflitos de shim que sobraram do ck. Remova o binário antigo ck do seu PATH se ele avisar. A documentação também mudou de docs.claudekit.cc para docs.agentkit.best, então pare de seguir os antigos comandos do ck. Todo o contexto sobre a mudança de nome está em Claude Kit renomeado para AgentKit.
Solução de problemas comuns
A maioria dos problemas ao instalar o ak cai em um dos casos abaixo:
| Erro | Como resolver |
|---|---|
ak: command not found (macOS/Linux) | O diretório de instalação não está no seu PATH. Adicione ~/.local/bin ao PATH no ~/.zshrc / ~/.bashrc e depois abra um novo terminal. |
O Windows diz 'ak' is not recognized | O terminal já aberto não enxerga o novo PATH. Feche-o e abra uma NOVA janela de terminal — esta é a correção número um no Windows. |
| Instalador bloqueado pelo Windows/SmartScreen | Rode o comando de novo a partir de um domínio confiável (agentkit.best ou releases.agentkit.best). Não desative seus recursos de segurança para forçar a instalação. |
| Falha na verificação de checksum / assinatura | O download está corrompido ou algo o adulterou no caminho. Rode o comando de instalação de novo. Nunca pule a etapa de verificação. |
O antigo ck roda no lugar do ak | Remova o binário ck do seu PATH e rode ak doctor --check ck_shim_collision para limpar o conflito. |
| Falha no login | A chave de API pegou espaços em branco quando você copiou, ou o OTP expirou. Copie uma chave limpa, ou peça um novo OTP e rode ak login de novo. |
O ak kit init informa que falta uma permissão | Sua conta não tem permissão para esse kit. Verifique com ak licenses; se estiver vazio, você precisa ser dona do kit ou entrar com a conta que o comprou. |
Perguntas frequentes (FAQ)
Preciso de Node.js para instalar a CLI ak?
Não. O binário ak é nativo (macOS/Linux/Windows) e roda por conta própria, sem Node.js nem Bun. Só o ambiente do Claude Code — o destino em que você carrega os kits — precisa de Node 18+.
Onde eu insiro a chave de licença, e por que a CLI não precisa de uma?
A chave de licença ativa o aplicativo de desktop do AgentKit, não a CLI. A CLI ak é autorizada ao entrar na sua conta (ak login com e-mail ou chave de API). Este é o ponto de confusão mais comum de todos.
Dá para instalar no Windows?
Sim. Use o PowerShell com irm https://agentkit.best/install.ps1 | iex. Se, depois de instalar, digitar ak e aparecer "not recognized", basta abrir uma nova janela de terminal.
Preciso do Claude Code Pro?
Você precisa de algum plano Claude que funcione com o Claude Code (Pro, Max ou API pré-paga) para o modelo rodar. O AgentKit não substitui esse plano — ele só acrescenta skills e agents por cima do Claude Code.
Como desinstalo o ak?
Rode ak uninstall. Em uma máquina compartilhada, rode ak logout antes para limpar sua sessão.
Quantas máquinas uma licença cobre?
O número de máquinas por licença depende dos termos atuais em agentkit.best.
Conclusão e como obter uma licença
Recapitulando os 5 passos: instale o Claude Code (pré-requisito), instale o binário ak, rode ak login para autorizar, rode ak kit init engineer --target claude-code --global e então digite /ak: no Claude Code. Lembre da maior armadilha: licença = aplicativo de desktop, CLI = login na conta. Como a CLI está em beta, confira os comandos mais recentes na documentação antes de rodar.
Para entender até onde o AgentKit realmente vale a pena, leia a análise completa do AgentKit e pese o custo com a análise de preços do AgentKit.
Quer um Claude Code mais forte agora mesmo? Se você acabou de instalar a CLI e viu os comandos /ak: ganharem vida, o próximo passo natural é ter um kit para liberar todas as 108+ skills e 45 agents. Os kits são compra única e incluem atualizações vitalícias.