# Cómo usar Kiro CLI: guía paso a paso

URL: https://agentvera.dev/es/blog/how-to-use-kiro-cli/ · Publicado: 2026-10-29

Cómo usar Kiro CLI: instala kiro-cli, inicia sesión, habla con tu código, elige modelo y configura steering, agentes propios, servidores MCP y specs. Con créditos.

**En resumen:**

- Instálalo con el script oficial, Homebrew o PowerShell, inicia sesión en el navegador con GitHub, Google, AWS Builder ID o IAM Identity Center, ejecuta kiro-cli en tu proyecto y describe el cambio.
- Las reglas del proyecto van en .kiro/steering/ o en AGENTS.md, los agentes propios en .kiro/agents/ y los servidores MCP en .kiro/settings/mcp.json; /spec convierte una funcionalidad en requisitos, diseño y tareas.
- A octubre de 2026, Kiro cobra en créditos: 50 en el plan gratuito y 1.000 en Pro por 20 $ al mes. Auto elige el modelo por ti, y cada modelo tiene su propio multiplicador de créditos.

Para usar Kiro CLI, instálalo con `curl -fsSL https://cli.kiro.dev/install | bash` (o con `brew install kiro-cli` en macOS), inicia sesión en el navegador, ejecuta `kiro-cli` dentro de la carpeta de un proyecto y describe lo que quieres. Kiro lee tu código, edita archivos y ejecuta comandos, y te pregunta antes de usar cualquier herramienta en la que aún no confíes. Escribe `/model` para elegir modelo o deja Auto y que Kiro decida.

Ese es el ciclo básico. Esta guía cubre el resto: el inicio de sesión, los comandos de chat que usarás a diario, modelos y créditos, archivos de steering, agentes propios, servidores MCP, specs, Kiro en CI y cómo usarlo junto a otros agentes. Todo sigue la documentación oficial de Kiro a octubre de 2026.

## Qué es Kiro

Kiro es el entorno de desarrollo agéntico de AWS. Tiene varias formas que comparten una misma cuenta: un IDE de escritorio, la CLI y Kiro Web. La CLI es la parte de terminal. Ofrece un chat interactivo con una interfaz de terminal a pantalla completa, un modo headless para scripts y CI, y puede funcionar como agente en editores que hablan Agent Client Protocol (ACP).

Lo que distingue a Kiro de otros agentes de código es su apuesta por las specs. Antes de escribir el código de una funcionalidad, Kiro puede convertir tu idea en requisitos, un diseño y una lista de tareas, y luego ir completando las tareas. Si el enfoque te resulta nuevo, [Desarrollo guiado por especificaciones con agentes de IA](/es/blog/spec-driven-development-with-ai/ "Desarrollo guiado por especificaciones con agentes de IA") explica la idea y compara Kiro con otras herramientas que lo hacen.

Una nota sobre versiones: el instalador te da Kiro CLI 2.x. La versión 3 es una versión temprana que puedes probar con `kiro-cli --v3`. Convive con tu instalación 2.x y tu configuración queda como está hasta que cambies. Esta guía sigue 2.x y avisa donde V3 es distinta.

## Paso 1: instala Kiro CLI

| Plataforma | Comando |
| --- | --- |
| macOS, Linux | `curl -fsSL https://cli.kiro.dev/install \| bash` |
| macOS (Homebrew) | `brew install kiro-cli` |
| Windows 11 (PowerShell) | `irm 'https://cli.kiro.dev/install.ps1' \| iex` |

En Linux también hay un paquete `.deb`, un AppImage y un zip. La CLI necesita glibc 2.34 o posterior; en distribuciones más antiguas, usa la variante musl del zip. En Windows, ejecuta el instalador en PowerShell o en Windows Terminal; el antiguo Símbolo del sistema no está soportado.

Comprueba que todo funciona:

```bash
kiro-cli doctor
```

`kiro-cli update` busca una versión nueva y `kiro-cli settings app.disableAutoupdates true` desactiva las actualizaciones automáticas. Si instalaste con Homebrew, actualiza con `brew upgrade --greedy kiro-cli`.

## Paso 2: inicia sesión

Tras la instalación, Kiro abre el navegador para que inicies sesión. Las opciones son:

- **GitHub o Google:** lo más rápido para uso individual.
- **AWS Builder ID:** una identidad personal y gratuita de AWS.
- **AWS IAM Identity Center:** para empresas que gestionan Kiro desde AWS. Introduces la URL de inicio y la región de tu organización.
- **Un proveedor de identidad externo:** como Okta o Microsoft Entra ID, si tu empresa lo ha configurado.

Usa `kiro-cli login` para volver a iniciar sesión cuando quieras. En una máquina remota sin navegador, `kiro-cli login --use-device-flow` muestra una URL y un código para abrir en otro dispositivo. El device flow funciona con Builder ID, IAM Identity Center, Google y GitHub, pero no con un proveedor de identidad externo. `kiro-cli whoami` muestra con qué cuenta estás conectado y `kiro-cli logout` cierra la sesión.

Conviene saberlo: en el plan gratuito y en los planes individuales, Kiro puede usar tu contenido para mejorar el servicio. Puedes desactivarlo; la documentación de Kiro explica cómo.

## Paso 3: lo básico del chat

Entra en un proyecto e inicia Kiro:

```bash
cd my-project
kiro-cli
```

La interfaz de terminal es la opción por defecto. Hay unas cuantas cosas que usarás todo el rato:

- **`@ruta`** adjunta un archivo a tu mensaje.
- **`!`** al inicio de una línea ejecuta un comando de shell directamente, por ejemplo `!npm test`.
- **Shift+Tab** cambia al modo plan, donde Kiro piensa un cambio antes de tocar el código.
- **Shift+Enter** o **Ctrl+J** inserta un salto de línea, **Ctrl+O** despliega la salida larga y **Ctrl+C** sale.
- **`/paste`** pega una imagen del portapapeles.

| Comando | Qué hace |
| --- | --- |
| `/model` | Elegir modelo |
| `/effort` | Ajustar el esfuerzo de razonamiento |
| `/agent` | Cambiar a otro agente |
| `/context` | Ver, añadir o quitar archivos de contexto |
| `/compact` | Resumir el chat para liberar contexto |
| `/plan` | Planificar un cambio antes de construirlo |
| `/spec` | Crear o ejecutar una spec |
| `/tools` | Confiar o dejar de confiar en herramientas |
| `/mcp` | Revisar servidores MCP e iniciar sesión en ellos |
| `/usage` | Ver tu plan y los créditos que te quedan |
| `/guide` | Preguntar sobre el propio Kiro CLI |
| `/quit` | Salir |

Los chats se guardan por carpeta. `kiro-cli chat --resume` retoma el último chat de la carpeta actual, `--resume-picker` te deja elegir uno y `--list-sessions` los lista. Si prefieres la interfaz antigua línea a línea, arranca con `kiro-cli chat --classic`.

## Paso 4: modelos y créditos

Por defecto, Kiro usa **Auto**, que envía cada petición a un modelo adecuado. La documentación lo recomienda para la mayoría de tareas. Para elegir tú, escribe `/model` en el chat o lista los modelos desde la shell:

```bash
kiro-cli chat --list-models
```

Para dejar un modelo como predeterminado, configúralo:

```bash
kiro-cli settings chat.defaultModel "claude-sonnet-4.6"
```

Kiro cobra en créditos y cada modelo tiene un multiplicador. A octubre de 2026, Claude Opus 5 cuenta 2,2 veces, Claude Sonnet 5.5 1,3 veces, DeepSeek 3.2 0,25 veces y Qwen3 Coder Next 0,05 veces. La misma tarea puede costar muy distinto según el modelo, así que mira `/usage` de vez en cuando.

| Plan (octubre de 2026) | Precio | Créditos |
| --- | --- | --- |
| Free | 0 $ | 50 |
| Pro | 20 $ por usuario al mes | 1.000 |
| Pro+ | 40 $ por usuario al mes | 2.000 |
| Pro Max | 100 $ por usuario al mes | 5.000 |
| Power | 200 $ por usuario al mes | 10.000 |
| Enterprise | Contactar con ventas | Personalizado |

Los planes de pago pueden seguir más allá de sus créditos a 0,04 $ por crédito, y hay paquetes adicionales. El plan gratuito cubre los modelos open-weight y Claude Sonnet 4.5; para los modelos Claude más nuevos necesitas un plan de pago. Precios y modelos cambian a menudo, así que revisa kiro.dev/pricing antes de decidir.

## Paso 5: archivos de steering y AGENTS.md

Los archivos de steering son archivos Markdown con las reglas de tu proyecto: qué hace el producto, el stack técnico, dónde está cada cosa, qué evitar. Kiro los busca en dos sitios:

- **Workspace:** `.kiro/steering/` dentro del proyecto, versionado junto al código.
- **Global:** `~/.kiro/steering/`, para reglas que quieres en todas partes. Si se contradicen, gana el workspace.

La documentación recomienda empezar con tres archivos: `product.md`, `tech.md` y `structure.md`. Por defecto, un archivo de steering se incluye en todos los chats. Puedes limitarlo a ciertos archivos con front matter:

```markdown
---
inclusion: fileMatch
fileMatchPattern: "components/**/*.tsx"
---

- Los componentes son funcionales y usan exportaciones con nombre.
- Los estilos usan CSS modules; nada de estilos en línea.
```

Hay cuatro modos: `always` (el predeterminado), `fileMatch`, `manual` (lo incorporas con `#nombre-de-archivo`) y `auto` (Kiro decide según el nombre y la descripción del archivo). Kiro CLI 2.x solo carga automáticamente los archivos `always`; V3 admite los cuatro.

Kiro también lee `AGENTS.md` y lo trata como un archivo de steering que se incluye siempre. Si tu equipo ya mantiene uno para Codex, opencode u otros agentes, Kiro lo usa tal cual. Para saber qué poner, consulta [Buenas prácticas de CLAUDE.md](/es/blog/claude-md-agents-md/ "Buenas prácticas de CLAUDE.md").

## Paso 6: agentes propios

Un agente propio es una configuración guardada con su prompt, modelo, herramientas y archivos de contexto. Créalo con:

```bash
kiro-cli agent create my-agent
```

Los agentes viven en `.kiro/agents/` (por proyecto) o `~/.kiro/agents/` (globales), en JSON o, con V3, también en Markdown. Un ejemplo corto:

```json
{
  "name": "my-agent",
  "description": "Reviews backend changes",
  "prompt": "You are a careful backend reviewer.",
  "model": "claude-sonnet-4.6",
  "includeMcpJson": true,
  "resources": ["file://.kiro/steering/**/*.md", "file://./ARCHITECTURE.md"]
}
```

Abre un chat con él usando `kiro-cli --agent my-agent`, cambia dentro del chat con `/agent` o conviértelo en el predeterminado con `kiro-cli settings chat.defaultAgent my-agent`. `kiro-cli agent list` muestra tus agentes y `kiro-cli agent validate` revisa un archivo.

Dos detalles. Primero, los agentes propios no incluyen los archivos de steering por sí solos; por eso el ejemplo añade `.kiro/steering/**/*.md` en `resources`. Segundo, los agentes de la carpeta de un proyecto solo se cargan cuando confías en ese workspace. Los campos de permisos de herramientas difieren entre 2.x y V3; `/upgrade-agent` convierte un agente cuando pasas a V3.

## Paso 7: servidores MCP

Los [servidores MCP](/es/blog/what-is-mcp-server/ "¿Qué es un servidor MCP?") dan a Kiro herramientas nuevas: búsqueda en documentación, un navegador, tu gestor de incidencias. Van en un archivo `mcp.json`, ya sea `.kiro/settings/mcp.json` en el proyecto o `~/.kiro/settings/mcp.json` para todos los proyectos:

```json
{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "disabled": false
    },
    "my-remote": {
      "url": "https://mcp.example.com/mcp"
    }
  }
}
```

Un servidor local es un comando que Kiro arranca; uno remoto es una URL (HTTPS, o HTTP en localhost), con `headers` opcionales e inicio de sesión OAuth. Desde la shell, `kiro-cli mcp add` añade un servidor, `kiro-cli mcp list` muestra la configuración y `kiro-cli mcp status` indica si cada servidor está en marcha. Dentro del chat, `/mcp` hace lo mismo y gestiona los servidores que piden iniciar sesión.

Si el mismo servidor está definido en varios sitios, la configuración de un agente se impone al archivo del workspace, y el del workspace al global. Cada servidor añade herramientas al contexto, así que desactiva los que no uses con `"disabled": true`.

## Paso 8: specs

Las specs son la seña de identidad de Kiro. Para cualquier cosa mayor que un arreglo rápido, crea una:

```text
/spec new user-invitations
```

Kiro escribe tres archivos en `.kiro/specs/user-invitations/`: `requirements.md` con historias de usuario y criterios de aceptación en notación EARS («Cuando X, el sistema deberá Y»), `design.md` con el enfoque técnico y `tasks.md` con una lista numerada de tareas. Lee y corrige cada archivo antes de seguir; esa revisión es justo lo que da sentido al proceso. Después, deja que Kiro complete las tareas:

```text
/spec run user-invitations
```

Los archivos de la spec son Markdown normal. Si los versionas, se convierten en documentación para el siguiente cambio. Para cambios más pequeños, el modo plan (Shift+Tab o `/plan`) ofrece una versión más ligera del mismo hábito.

## Paso 9: modo headless y CI

Para scripts y CI, ejecuta Kiro sin la interfaz de chat:

```bash
export KIRO_API_KEY=your-key
kiro-cli chat --v3 --no-interactive --trust-tools=read_file,grep_search "Summarize the risky changes in this branch"
```

`--trust-tools` lista las herramientas que Kiro puede usar sin preguntar (los nombres de aquí son de V3, por eso el ejemplo usa `--v3`, igual que el ejemplo de GitHub Actions de la documentación). `--trust-all-tools` lo permite todo, así que úsalo solo en un sandbox. `--require-mcp-startup` hace fallar la ejecución si un servidor MCP no arranca. Las claves de API están disponibles en los planes Pro, Pro+, Pro Max y Power. Para editores compatibles con ACP, `kiro-cli acp` ejecuta Kiro como su agente.

## Errores habituales

- **El instalador falla en Windows.** Estás en el Símbolo del sistema. Usa PowerShell o Windows Terminal en Windows 11.
- **El binario no arranca en un Linux antiguo.** La glibc es anterior a la 2.34. Usa el zip musl.
- **Tus reglas de steering se ignoran.** El archivo usa `fileMatch` o `auto`, que 2.x no carga automáticamente, o estás en un agente propio sin el recurso de steering.
- **Los créditos se van rápido.** Un modelo caro o un chat largo. Mira `/usage`, prueba Auto y usa `/compact`.
- **Los comandos de AWS dejaron de funcionar en V3.** V3 eliminó la herramienta de AWS integrada; usa en su lugar un servidor MCP de AWS.
- **No aparece la opción de clave de API.** El modo headless necesita un plan de pago.

## ¿Kiro CLI u otro agente?

Kiro encaja bien si te gusta planificar con specs, si tu empresa ya gestiona el acceso con AWS IAM Identity Center o si quieres una sola factura que cubra modelos premium y modelos open-weight baratos. Encaja peor si quieres usar tu propia clave de API o modelos locales; eso lo hace [opencode](/es/blog/how-to-use-opencode/ "Cómo usar opencode") con cualquier proveedor. Si ya pagas Claude o ChatGPT, Claude Code o Codex CLI aprovechan directamente esa suscripción. [Mejores alternativas a Claude Code](/es/blog/best-claude-code-alternatives/ "Mejores alternativas a Claude Code") compara los principales agentes de CLI uno junto a otro.

## Usar Kiro CLI junto a otros agentes

Muchos equipos no se quedan con un solo agente. Kiro escribe la spec, Claude Code o Codex construye una parte y otro agente revisa. Con pestañas de terminal, eso se desordena enseguida. AgentVera es una app de escritorio que ejecuta estas CLI lado a lado en terminales reales, con tus propias instalaciones y sesiones. El [soporte de Kiro CLI](/es/agents/kiro-cli/ "Kiro CLI en AgentVera") funciona así:

- **Tu sesión de Kiro.** AgentVera abre `kiro-cli chat` en una terminal real. Inicias sesión con `kiro-cli login`; si no la tienes iniciada, la terminal del agente te pide que lo hagas.
- **Modelo y esfuerzo por agente.** Deja el modelo vacío para usar el predeterminado de Kiro o elige uno por agente. El esfuerzo va de bajo a máximo.
- **Reglas desde tus archivos.** Kiro CLI no tiene un flag de instrucciones adicionales, así que las instrucciones permanentes salen de `AGENTS.md` o de los archivos de reglas del proyecto.
- **Tu mcp.json sigue siendo tuyo.** Los servidores MCP que añades en AgentVera y el navegador de AgentVera se combinan con tu propio `mcp.json` de Kiro en cada arranque.
- **Las sesiones continúan.** Al reanudar un agente, se abre con su ID de sesión o con la última sesión de la carpeta.
- **Paneles, flujos y revisión.** Ejecuta Kiro en la cuadrícula del [workspace](/es/features/workspace/ "Workspace") junto a Claude Code o Codex, cada uno en su propio git worktree. Los agentes de Kiro funcionan en flujos, mensajes masivos y tareas programadas, y reciben una revisión de código automática al terminar cada turno.

La cuadrícula, los worktrees, la revisión de código y el gestor de MCP están en el plan gratuito; los flujos, en Pro y Team. [Descarga AgentVera](/es/download/ "Descargar AgentVera") para probarlo.

## Conclusión

Para usar Kiro CLI, instálalo, inicia sesión, ejecuta `kiro-cli` en un proyecto y describe el cambio. Deja el modelo en Auto hasta que tengas un motivo para cambiarlo y vigila `/usage`. Las reglas del proyecto van en `.kiro/steering/` o `AGENTS.md`, las herramientas en `mcp.json` y las configuraciones que repites en agentes propios. Para cualquier cosa mayor que un arreglo rápido, empieza con `/spec new`: revisar requisitos y una lista de tareas antes de que exista el código es lo que Kiro hace mejor.

## Preguntas frecuentes

**¿Kiro CLI es gratis?** La CLI no cuesta nada y el plan gratuito incluye 50 créditos. A octubre de 2026, los planes de pago empiezan en 20 $ al mes por 1.000 créditos (Pro), y por encima están Pro+, Pro Max y Power. El uso adicional cuesta 0,04 $ por crédito.

**¿Qué diferencia hay entre Kiro IDE y Kiro CLI?** Son dos formas de usar el mismo Kiro: el IDE es un editor de escritorio y la CLI es un chat en la terminal. Ambos usan tu cuenta y tus créditos de Kiro, y entienden los archivos de steering, las specs y los servidores MCP de la carpeta .kiro.

**¿Kiro CLI lee AGENTS.md?** Sí. Kiro trata AGENTS.md como un archivo de steering que se incluye siempre. Los archivos de steering propios de Kiro viven en .kiro/steering/ dentro del proyecto y en ~/.kiro/steering/ para las reglas globales.

**¿Qué es Kiro CLI V3?** Una versión temprana de la siguiente generación. Pruébala con kiro-cli --v3; convive con tu instalación 2.x, que queda intacta hasta que cambies. Comparte motor con Kiro IDE y añade cosas como /rewind, hooks y un agente de specs.

**¿Puedo usar Kiro CLI en CI?** Sí. Ejecuta kiro-cli chat --no-interactive con un prompt y define KIRO_API_KEY. Las claves de API están disponibles en los planes Pro, Pro+, Pro Max y Power, no en el gratuito.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/