Как пользоваться Kiro CLI: пошаговое руководство

Чтобы пользоваться Kiro CLI, установите его командой curl -fsSL https://cli.kiro.dev/install | bash (на macOS можно brew install kiro-cli), войдите в аккаунт в браузере, запустите kiro-cli в папке проекта и опишите, что нужно сделать. Kiro читает код, правит файлы и выполняет команды, а перед использованием инструмента, которому вы ещё не доверяете, спрашивает разрешения. Чтобы выбрать модель, введите /model, или оставьте Auto, и Kiro решит сам.

Это базовый цикл. Дальше в руководстве всё остальное: вход в аккаунт, повседневные команды чата, модели и кредиты, steering-файлы, свои агенты, MCP-серверы, specs, Kiro в CI и работа рядом с другими агентами. Всё написано по официальной документации Kiro на октябрь 2026 года.

Что такое Kiro

Kiro — агентная среда разработки от AWS. У неё несколько форм с общим аккаунтом: десктопная IDE, CLI и Kiro Web. CLI — это терминальная часть. Она даёт интерактивный чат с полноэкранным терминальным интерфейсом, headless-режим для скриптов и CI и может работать как агент в редакторах, поддерживающих Agent Client Protocol (ACP).

От других агентов для кода Kiro отличается упором на спецификации (specs). Прежде чем писать код фичи, Kiro может превратить идею в требования, дизайн и список задач, а затем выполнять задачи по очереди. Если подход для вас новый, статья Разработка через спецификации с ИИ-агентами объясняет идею и сравнивает Kiro с другими инструментами, которые так умеют.

Пара слов о версиях: установщик ставит Kiro CLI 2.x. Версия 3 — ранняя, её можно попробовать командой kiro-cli --v3. Она работает рядом с установленной 2.x, и ваша настройка остаётся прежней, пока вы не переключитесь. Это руководство описывает 2.x и отмечает, где V3 ведёт себя иначе.

Шаг 1: установите Kiro CLI

Для Linux есть также пакет .deb, AppImage и zip-архив. CLI нужна glibc 2.34 или новее; на более старых дистрибутивах берите musl-вариант zip. В Windows запускайте установщик в PowerShell или Windows Terminal; старая командная строка не поддерживается.

Проверьте, что всё работает:

kiro-cli doctor

kiro-cli update проверяет наличие новой версии, а kiro-cli settings app.disableAutoupdates true отключает автообновления. Если ставили через Homebrew, обновляйтесь командой brew upgrade --greedy kiro-cli.

Шаг 2: войдите в аккаунт

После установки Kiro откроет браузер для входа. Варианты такие:

• GitHub или Google: самый быстрый путь для одного разработчика.
• AWS Builder ID: бесплатная личная учётная запись AWS.
• AWS IAM Identity Center: для компаний, которые управляют Kiro через AWS. Нужно ввести стартовый URL и регион вашей организации.
• Внешний провайдер идентификации: например, Okta или Microsoft Entra ID, если компания его настроила.

Войти заново можно в любой момент командой kiro-cli login. На удалённой машине без браузера kiro-cli login --use-device-flow выводит URL и код, которые нужно открыть на другом устройстве. Device flow работает с Builder ID, IAM Identity Center, Google и GitHub, но не с внешним провайдером идентификации. kiro-cli whoami показывает, под каким аккаунтом вы вошли, а kiro-cli logout выполняет выход.

Полезно знать: на бесплатном и индивидуальных тарифах Kiro может использовать ваш контент для улучшения сервиса. От этого можно отказаться, как именно — описано в документации Kiro.

Шаг 3: основы чата

Перейдите в проект и запустите Kiro:

cd my-project
kiro-cli

По умолчанию открывается терминальный интерфейс. Несколько вещей понадобятся постоянно:

• @путь прикрепляет файл к сообщению.
• ! в начале строки сразу выполняет команду оболочки, например !npm test.
• Shift+Tab переключает в режим плана, где Kiro продумывает изменение, прежде чем трогать код.
• Shift+Enter или Ctrl+J — новая строка, Ctrl+O раскрывает длинный вывод, Ctrl+C — выход.
• /paste вставляет изображение из буфера обмена.

Чаты сохраняются отдельно для каждой папки. kiro-cli chat --resume продолжает последний чат в текущей папке, --resume-picker даёт выбрать нужный, а --list-sessions выводит их список. Если вам привычнее старый построчный интерфейс, запускайте kiro-cli chat --classic.

Шаг 4: модели и кредиты

По умолчанию Kiro использует Auto, который отправляет каждый запрос подходящей модели. Документация советует его для большинства задач. Чтобы выбрать модель самостоятельно, введите /model в чате или выведите список моделей из оболочки:

kiro-cli chat --list-models

Чтобы сделать модель моделью по умолчанию, задайте настройку:

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

Kiro считает расход в кредитах, и у каждой модели есть множитель. На октябрь 2026 года Claude Opus 5 стоит 2,2x, Claude Sonnet 5.5 — 1,3x, DeepSeek 3.2 — 0,25x, а Qwen3 Coder Next — 0,05x. Одна и та же задача на разных моделях обходится очень по-разному, так что время от времени заглядывайте в /usage.

На платных тарифах можно работать и после исчерпания кредитов по 0,04 $ за кредит, есть и дополнительные пакеты. Бесплатный тариф покрывает open-weight-модели и Claude Sonnet 4.5; для новейших моделей Claude нужен платный тариф. Цены и модели часто меняются, поэтому перед выбором загляните на kiro.dev/pricing.

Шаг 5: steering-файлы и AGENTS.md

Steering-файлы — это Markdown-файлы с правилами проекта: что делает продукт, какой стек, где что лежит, чего избегать. Kiro ищет их в двух местах:

• Workspace: .kiro/steering/ внутри проекта, хранится в репозитории вместе с кодом.
• Глобально: ~/.kiro/steering/, для правил, которые нужны везде. При конфликте побеждает workspace.

Документация советует начать с трёх файлов: product.md, tech.md и structure.md. По умолчанию steering-файл подключается в каждый чат. Ограничить его определёнными файлами можно через front matter:

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

- Компоненты — функциональные, с именованными экспортами.
- Стили — через CSS modules, без inline-стилей.

Режимов четыре: always (по умолчанию), fileMatch, manual (подключаете сами через #имя-файла) и auto (Kiro решает по имени и описанию файла). Kiro CLI 2.x автоматически загружает только файлы always; V3 поддерживает все четыре режима.

Kiro также читает AGENTS.md и считает его steering-файлом, который подключается всегда. Если команда уже ведёт такой файл для Codex, opencode или других агентов, Kiro использует его как есть. Что туда писать, разобрано в статье CLAUDE.md: лучшие практики.

Шаг 6: свои агенты

Свой агент — это сохранённая конфигурация с собственным промптом, моделью, инструментами и файлами контекста. Создаётся он так:

kiro-cli agent create my-agent

Агенты хранятся в .kiro/agents/ (для проекта) или ~/.kiro/agents/ (глобально), в формате JSON, а в V3 ещё и Markdown. Короткий пример:

{
  "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"]
}

Чат с ним открывается командой kiro-cli --agent my-agent, внутри чата агента можно сменить через /agent, а сделать его агентом по умолчанию — командой kiro-cli settings chat.defaultAgent my-agent. kiro-cli agent list показывает ваших агентов, kiro-cli agent validate проверяет файл.

Две тонкости. Во-первых, свои агенты не подключают steering-файлы автоматически; поэтому в примере .kiro/steering/**/*.md добавлен в resources. Во-вторых, агенты из папки проекта загружаются, только когда вы доверяете этому workspace. Поля разрешений для инструментов в 2.x и V3 различаются; /upgrade-agent конвертирует агента при переходе на V3.

Шаг 7: MCP-серверы

MCP-серверы дают Kiro новые инструменты: поиск по документации, браузер, ваш трекер задач. Они описываются в файле mcp.json: либо .kiro/settings/mcp.json в проекте, либо ~/.kiro/settings/mcp.json для всех проектов:

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

Локальный сервер — это команда, которую запускает Kiro; удалённый — URL (HTTPS или HTTP на localhost), с необязательными headers и входом через OAuth. Из оболочки kiro-cli mcp add добавляет сервер, kiro-cli mcp list показывает конфигурацию, а kiro-cli mcp status — запущен ли каждый сервер. В чате то же самое делает /mcp, он же обрабатывает серверы, которые требуют входа.

Если один и тот же сервер описан в нескольких местах, настройка агента важнее файла workspace, а файл workspace важнее глобального. Каждый сервер добавляет инструменты в контекст, так что ненужные отключайте через "disabled": true.

Шаг 8: specs

Specs — фирменная черта Kiro. Для всего, что крупнее быстрого исправления, создайте spec:

/spec new user-invitations

Kiro запишет три файла в .kiro/specs/user-invitations/: requirements.md с пользовательскими историями и критериями приёмки в нотации EARS («Когда X, система должна Y»), design.md с техническим подходом и tasks.md с пронумерованным списком задач. Прочитайте и поправьте каждый файл, прежде чем идти дальше: именно ради этой проверки всё и затевается. Затем пусть Kiro выполнит задачи:

/spec run user-invitations

Файлы spec — обычный Markdown. Если закоммитить их, они станут документацией для следующего изменения. Для небольших изменений режим плана (Shift+Tab или /plan) даёт облегчённую версию той же привычки.

Шаг 9: headless-режим и CI

Для скриптов и CI запускайте Kiro без интерфейса чата:

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 перечисляет инструменты, которые Kiro может использовать без вопросов (имена здесь из V3, поэтому в примере стоит --v3, как и в примере для GitHub Actions из документации). --trust-all-tools разрешает всё, так что используйте его только в песочнице. --require-mcp-startup завершает запуск с ошибкой, если какой-то MCP-сервер не стартовал. API-ключи доступны на тарифах Pro, Pro+, Pro Max и Power. Для редакторов с поддержкой ACP команда kiro-cli acp запускает Kiro как их агента.

Частые ошибки

• Установщик падает в Windows. Вы в старой командной строке. Используйте PowerShell или Windows Terminal в Windows 11.
• Программа не запускается на старом Linux. glibc старше 2.34. Возьмите musl-zip.
• Steering-правила игнорируются. Файл использует fileMatch или auto, которые 2.x не загружает автоматически, либо вы в своём агенте без steering-ресурса.
• Кредиты быстро тают. Дорогая модель или длинный чат. Проверьте /usage, попробуйте Auto и используйте /compact.
• Команды AWS перестали работать в V3. В V3 убрали встроенный инструмент для AWS; вместо него используйте MCP-сервер AWS.
• Нет опции API-ключа. Headless-режиму нужен платный тариф.

Kiro CLI или другой агент?

Kiro хорошо подходит, если вам нравится планировать через specs, если компания уже управляет доступом через AWS IAM Identity Center или если вы хотите один счёт и за премиальные модели, и за дешёвые open-weight. Хуже он подходит, если вы хотите использовать собственный API-ключ или локальные модели; это умеет opencode с любым провайдером. Если вы уже платите за Claude или ChatGPT, Claude Code или Codex CLI работают напрямую по этой подписке. В статье Лучшие альтернативы Claude Code основные CLI-агенты сравниваются бок о бок.

Kiro CLI рядом с другими агентами

Многие команды не ограничиваются одним агентом. Kiro пишет spec, Claude Code или Codex реализует часть, ещё один агент делает ревью. Во вкладках терминала это быстро превращается в хаос. AgentVera — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и входами. Поддержка Kiro CLI устроена так:

• Ваш вход в Kiro. AgentVera открывает kiro-cli chat в настоящем терминале. Вы входите через kiro-cli login; если вход не выполнен, терминал агента попросит войти.
• Модель и уровень рассуждений для каждого агента. Оставьте модель пустой, чтобы использовать модель Kiro по умолчанию, или выберите свою для каждого агента. Уровень рассуждений — от низкого до max.
• Правила из ваших файлов. У Kiro CLI нет флага для дополнительных инструкций, поэтому постоянные инструкции берутся из AGENTS.md или файлов правил в проекте.
• Ваш mcp.json остаётся вашим. MCP-серверы, добавленные в AgentVera, и браузер AgentVera объединяются с вашим собственным mcp.json Kiro при каждом запуске.
• Сессии продолжаются. При возобновлении агент открывается со своим ID сессии или с последней сессией папки.
• Панели, flows и ревью. Запускайте Kiro в сетке Workspace рядом с Claude Code или Codex, каждый в своём git worktree. Агенты Kiro работают во flows, массовых рассылках и запланированных задачах и получают автоматическое код-ревью в конце каждого хода.

Сетка, worktree, код-ревью и менеджер MCP есть на бесплатном тарифе; flows — на Pro и Team. Скачайте AgentVera, чтобы попробовать.

Подведём итог

Чтобы пользоваться Kiro CLI, установите его, войдите в аккаунт, запустите kiro-cli в проекте и опишите изменение. Оставьте модель на Auto, пока нет причин её менять, и следите за /usage. Правила проекта кладите в .kiro/steering/ или AGENTS.md, инструменты — в mcp.json, повторяющиеся настройки — в своих агентов. Для всего, что крупнее быстрого исправления, начинайте с /spec new: проверить требования и список задач до появления кода — то, что Kiro умеет лучше всего.