Cómo instalar AgentKit (ak CLI) desde cero para Claude Code (2026)
Puedes instalar AgentKit (la CLI ak) para Claude Code en menos de 5 minutos, en 5 pasos: (1) tener Claude Code instalado, (2) instalar el binario ak con un comando de una línea, (3) ejecutar ak login para autorizar tu cuenta, (4) ejecutar ak kit init engineer --target claude-code --global para cargar un kit y (5) escribir /ak: dentro de Claude Code. Una cosa que conviene tener clara: tu clave de licencia activa la app de escritorio, no la CLI: la CLI se autoriza al iniciar sesión en tu cuenta.
Cada comando de esta guía proviene de la documentación oficial en agentkit.best/docs y docs.agentkit.best (comprobado en 08/2026). La CLI ak está ahora mismo en un canal beta, así que los comandos y las flags pueden cambiar: vuelve a comprobar el comando más reciente en la documentación antes de ejecutarlo.
¿Qué AgentKit? La CLI ak para Claude Code, no el AgentKit de OpenAI
Antes de copiar un solo comando, tómate 30 segundos para asegurarte de que estás instalando lo correcto. Ahora mismo la palabra "agentkit" está repartida entre varios productos sin relación entre sí: OpenAI AgentKit (lanzado en 10/2025), el agentkit de BCG-X (un starter kit de Next.js/FastAPI/LangChain), el agents-cli de Google y un puñado de sitios más con el mismo nombre. Instala uno de esos por error y los comandos nunca funcionarán para Claude Code.
Este artículo trata de: el kit para Claude Code en agentkit.best, gobernado por una CLI llamada
ak. Es el sucesor del antiguo Claude Kit (ckse renombró aak). Convierte Claude Code (además de Codex y Copilot) en un "equipo de desarrollo y marketing con IA" mediante skills y agents. Si buscas el producto de OpenAI o de BCG, no es este.
Para conocer toda la historia detrás del cambio de nombre y por qué ak reemplaza a ck, lee cómo Claude Kit se renombró a AgentKit (de ck a ak).
Antes de instalar (requisitos previos)
AgentKit funciona por encima de Claude Code; no lo reemplaza. Necesitas dos cosas antes de empezar:
- ① Claude Code instalado y funcionando. Compruébalo con
claude --version. Si aparece un error "command not found", instala primero Claude Code con esta guía de instalación de Claude Code (requisito previo). Claude Code necesita Node 18+, y también te hará falta un plan de Claude (Pro, Max o API) para ejecutar el modelo. - ② Una cuenta de AgentKit. Inicias sesión en la CLI con un correo o una clave de API. Para descargar un kit de verdad (Engineer o Marketing), necesitas un permiso vinculado a esa cuenta; es decir, ya eres propietaria del kit.
Un punto que hace tropezar a mucha gente: el propio binario ak es nativo y no necesita Node.js ni Bun para ejecutarse. Pero cuando el kit de destino es Claude Code, el entorno de Claude Code sí necesita Node 18+. Son dos cosas distintas.
¿Aún no tienes un kit? Igual puedes instalar la CLI e iniciar sesión, pero
ak kit initte dirá que falta el permiso. Si quieres usarlo de verdad, echa un vistazo a los planes de AgentKit y consigue una licencia (20% de descuento por el enlace): los kits Engineer y Marketing son de pago único cada uno, y el Bundle combina ambos.
Paso 1 - Instala la CLI ak (macOS / Linux / Windows)
El instalador detecta automáticamente tu SO y arquitectura, descarga la build estable, verifica la suma de comprobación SHA-256 e instala en ~/.local/bin. Elige el comando de tu sistema operativo:
macOS / Linux:
curl -fsSL https://agentkit.best/install.sh | shWindows (PowerShell):
irm https://agentkit.best/install.ps1 | iexSi la red de tu empresa bloquea el dominio principal, usa el dominio de respaldo releases.agentkit.best/install.sh (o .ps1). Algunas variables de entorno opcionales vienen muy bien:
AK_INSTALL_DIR- cambia el directorio de instalación si prefieres no usar el predeterminado.AK_CHANNEL=beta- instala el canal beta (el más nuevo, posiblemente menos estable).AK_VERSION=x.y.z- fija una versión concreta.
Una vez instalado, verifica de inmediato con dos comandos:
ak --version
ak doctorak --version imprime el número de versión; ak doctor analiza tu entorno e informa del PATH, los permisos y los conflictos: si todo está en verde, vas bien. Un pequeño consejo: si ak doctor marca un problema de PATH, no te apresures a iniciar sesión ni a instalar un kit; arregla el PATH primero, porque casi todos los errores posteriores se remontan a esto. En macOS/Linux el binario está en ~/.local/bin/ak, así que puedes ejecutarlo por su ruta completa para una comprobación rápida antes de preocuparte por el PATH.
Paso 2 - Inicia sesión y autoriza (ak login)
Aquí es donde surge la mayor parte de la confusión, así que léelo con atención.
Una clave de licencia NO activa la CLI. La clave de licencia solo activa la app de escritorio de AgentKit. La CLI
akse autoriza (se habilita) al iniciar sesión en tu cuenta. Si sigues buscando un campo del tipo "pega tu clave de licencia" en la terminal, nunca lo encontrarás: no existe.
En una máquina personal (abre un navegador o envía un OTP por correo):
ak login --email [email protected]En CI o cualquier entorno no interactivo, usa una clave de API:
ak login --api-key ak_live_... --no-interactiveConfirma que iniciaste sesión en la cuenta correcta y mira a qué tienes acceso:
ak whoami
ak licensesak whoami te dice con qué cuenta has iniciado sesión; ak licenses enumera los permisos (kits) que puedes descargar. Si ak licenses aparece vacío aunque estés segura de haber comprado un kit, revisa que no hayas iniciado sesión con el correo equivocado.
Seguridad: nunca subas ni compartas tu clave de API (lleva el prefijo ak_live_, que los bots rastrean en GitHub). En una máquina compartida, acuérdate de ejecutar ak logout cuando termines.
Paso 3 - Instala un kit en Claude Code (ak kit init)
Ahora llegamos a la parte que carga skills y agents en Claude Code. El comando estándar para el Engineer Kit:
ak kit init engineer --target claude-code --globalCambia engineer por marketing si vas a instalar el Marketing Kit. La flag --global instala para todos los proyectos; quítala si solo lo quieres en el directorio actual.
No tienes que instalar todas las skills: puedes elegir a mano para mantener tu contexto ligero:
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 qué kits y skills están disponibles antes de instalar:
ak kit list-kits
ak versions¿Aún no tienes el kit Engineer/Marketing? Este paso necesita un permiso. Mira qué hay dentro del Engineer Kit para conocer qué skills y flujos de trabajo incluye, o consigue el kit Engineer o Marketing: 20% de descuento, ahora $79.20/kit si ya lo has decidido.
Paso 4 - Pruébalo en Claude Code (/ak:)
Abre Claude Code en un proyecto, escribe / y luego ak:: verás aparecer como sugerencias los comandos de barra que el kit acaba de cargar:
/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 codebasePrueba a ejecutar /ak:cook en una tarea real pequeña (por ejemplo, añadir un endpoint) para confirmar que toda la cadena de instalación está conectada. Si Claude Code acepta el comando y empieza a recorrer el flujo del kit, lo has instalado con éxito. Si escribes /ak: y no aparece ningún comando, suele significar que el kit no se cargó en el destino correcto: vuelve y ejecuta ak kit init con la flag --target claude-code correcta, o reinicia Claude Code para que recargue la lista de comandos. A estas alturas has recorrido toda la cadena de verificación por capas: ak --version (el binario funciona), ak doctor (entorno limpio), ak whoami (sesión iniciada), ak licenses (tiene permiso) y, por último, /ak: apareciendo en Claude Code (el kit está activo).
Migrar desde el antiguo Claude Kit (de ck a ak)
Si antes usabas Claude Kit (ck), ak es el sucesor directo. No dejes que los dos binarios convivan: el viejo ck puede secuestrar tu PATH o dejar un shim en conflicto. Después de instalar ak, ejecuta:
ak doctor --check ck_shim_collisionEste comando detecta conflictos de shim que quedaron de ck. Quita el antiguo binario ck de tu PATH si te avisa. La documentación también se mudó de docs.claudekit.cc a docs.agentkit.best, así que deja de seguir los antiguos comandos de ck. Todo el contexto sobre el cambio de nombre está en Claude Kit renombrado a AgentKit.
Solución de errores comunes
La mayoría de los problemas al instalar ak encajan en uno de los casos siguientes:
| Error | Cómo solucionarlo |
|---|---|
ak: command not found (macOS/Linux) | El directorio de instalación no está en tu PATH. Añade ~/.local/bin al PATH en ~/.zshrc / ~/.bashrc y luego abre una nueva terminal. |
Windows dice 'ak' is not recognized | La terminal que ya tienes abierta no ve el nuevo PATH. Ciérrala y abre una NUEVA ventana de terminal: esta es la solución número uno en Windows. |
| El instalador queda bloqueado por Windows/SmartScreen | Vuelve a ejecutar el comando desde un dominio de confianza (agentkit.best o releases.agentkit.best). No desactives tus funciones de seguridad para forzar la instalación. |
| Falla la verificación de suma de comprobación / firma | La descarga está corrupta o algo la manipuló por el camino. Vuelve a ejecutar el comando de instalación. Nunca te saltes el paso de verificación. |
El viejo ck se ejecuta en lugar de ak | Quita el binario ck de tu PATH y ejecuta ak doctor --check ck_shim_collision para resolver el conflicto. |
| Falla el inicio de sesión | La clave de API arrastró espacios en blanco al copiarla, o el OTP caducó. Copia una clave limpia, o pide un OTP nuevo y ejecuta ak login otra vez. |
ak kit init informa de que falta un permiso | Tu cuenta no tiene permiso para ese kit. Compruébalo con ak licenses; si está vacío, necesitas ser propietaria del kit o iniciar sesión con la cuenta que lo compró. |
Preguntas frecuentes (FAQ)
¿Necesito Node.js para instalar la CLI ak?
No. El binario ak es nativo (macOS/Linux/Windows) y funciona por sí solo, sin Node.js ni Bun. Solo el entorno de Claude Code —el destino en el que cargas los kits— necesita Node 18+.
¿Dónde introduzco la clave de licencia y por qué la CLI no necesita una?
La clave de licencia activa la app de escritorio de AgentKit, no la CLI. La CLI ak se autoriza al iniciar sesión en tu cuenta (ak login con un correo o una clave de API). Este es el punto de confusión más común de todos.
¿Puedo instalarlo en Windows?
Sí. Usa PowerShell con irm https://agentkit.best/install.ps1 | iex. Si al escribir ak tras la instalación dice "not recognized", basta con abrir una nueva ventana de terminal.
¿Necesito Claude Code Pro?
Necesitas algún plan de Claude que funcione con Claude Code (Pro, Max o API de pago por uso) para que el modelo se ejecute. AgentKit no reemplaza ese plan: solo añade skills y agents por encima de Claude Code.
¿Cómo desinstalo ak?
Ejecuta ak uninstall. En una máquina compartida, ejecuta ak logout primero para borrar tu sesión.
¿Cuántas máquinas cubre una licencia?
El número de máquinas por licencia depende de los términos vigentes en agentkit.best.
Conclusión y cómo conseguir una licencia
Para recapitular los 5 pasos: instala Claude Code (requisito previo), instala el binario ak, ejecuta ak login para autorizar, ejecuta ak kit init engineer --target claude-code --global y luego escribe /ak: en Claude Code. Recuerda la mayor trampa: licencia = app de escritorio, CLI = inicio de sesión en la cuenta. Como la CLI está en beta, comprueba los comandos más recientes en la documentación antes de ejecutarlos.
Para entender hasta qué punto merece la pena AgentKit de verdad, lee la reseña completa de AgentKit y sopesa el coste con el desglose de precios de AgentKit.
¿Quieres un Claude Code más potente ahora mismo? Si acabas de terminar de instalar la CLI y has visto cobrar vida a los comandos /ak:, el siguiente paso natural es tener un kit para desbloquear las más de 108 skills y 45 agents completos. Los kits son de pago único e incluyen actualizaciones de por vida.