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

URL: https://agentvera.dev/ru/blog/how-to-use-kiro-cli/ · Опубликовано: 2026-10-29

Как пользоваться Kiro CLI: установка kiro-cli, вход, чат с кодом, выбор модели, steering-файлы, свои агенты, MCP-серверы и specs. И как устроены кредиты.

**Коротко:**

- Установите официальным скриптом, через Homebrew или PowerShell, войдите в браузере через GitHub, Google, AWS Builder ID или IAM Identity Center, затем запустите kiro-cli в проекте и опишите изменение.
- Правила проекта кладите в .kiro/steering/ или AGENTS.md, свои агенты в .kiro/agents/, MCP-серверы в .kiro/settings/mcp.json; /spec разбивает фичу на требования, дизайн и задачи.
- На октябрь 2026 года Kiro берёт оплату кредитами: 50 на бесплатном тарифе, 1000 на Pro за 20 $ в месяц. Auto сам выбирает модель, а у каждой модели свой множитель кредитов.

Чтобы пользоваться 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 может превратить идею в требования, дизайн и список задач, а затем выполнять задачи по очереди. Если подход для вас новый, статья [Разработка через спецификации с ИИ-агентами](/ru/blog/spec-driven-development-with-ai/ "Разработка через спецификации с ИИ-агентами") объясняет идею и сравнивает Kiro с другими инструментами, которые так умеют.

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

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

| Платформа | Команда |
| --- | --- |
| 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` |

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

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

```bash
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:

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

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

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

| Команда | Что делает |
| --- | --- |
| `/model` | Выбрать модель |
| `/effort` | Задать уровень рассуждений |
| `/agent` | Переключиться на другого агента |
| `/context` | Посмотреть, добавить или убрать файлы контекста |
| `/compact` | Сжать чат, чтобы освободить контекст |
| `/plan` | Спланировать изменение перед реализацией |
| `/spec` | Создать или запустить spec |
| `/tools` | Выдать или отозвать доверие инструментам |
| `/mcp` | Проверить MCP-серверы и войти в них |
| `/usage` | Посмотреть тариф и оставшиеся кредиты |
| `/guide` | Задать вопрос о самом Kiro CLI |
| `/quit` | Выйти |

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

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

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

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

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

```bash
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`.

| Тариф (октябрь 2026) | Цена | Кредиты |
| --- | --- | --- |
| Free | 0 $ | 50 |
| Pro | 20 $ за пользователя в месяц | 1000 |
| Pro+ | 40 $ за пользователя в месяц | 2000 |
| Pro Max | 100 $ за пользователя в месяц | 5000 |
| Power | 200 $ за пользователя в месяц | 10 000 |
| Enterprise | По запросу | Индивидуально |

На платных тарифах можно работать и после исчерпания кредитов по 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:

```markdown
---
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: лучшие практики](/ru/blog/claude-md-agents-md/ "CLAUDE.md: лучшие практики").

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

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

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

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

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

Чат с ним открывается командой `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-серверы](/ru/blog/what-is-mcp-server/ "Что такое MCP-сервер") дают Kiro новые инструменты: поиск по документации, браузер, ваш трекер задач. Они описываются в файле `mcp.json`: либо `.kiro/settings/mcp.json` в проекте, либо `~/.kiro/settings/mcp.json` для всех проектов:

```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:

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

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

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

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

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

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

```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` перечисляет инструменты, которые 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](/ru/blog/how-to-use-opencode/ "Как пользоваться opencode") с любым провайдером. Если вы уже платите за Claude или ChatGPT, Claude Code или Codex CLI работают напрямую по этой подписке. В статье [Лучшие альтернативы Claude Code](/ru/blog/best-claude-code-alternatives/ "Лучшие альтернативы Claude Code") основные CLI-агенты сравниваются бок о бок.

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

Многие команды не ограничиваются одним агентом. Kiro пишет spec, Claude Code или Codex реализует часть, ещё один агент делает ревью. Во вкладках терминала это быстро превращается в хаос. AgentVera — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и входами. [Поддержка Kiro CLI](/ru/agents/kiro-cli/ "Kiro CLI в AgentVera") устроена так:

- **Ваш вход в 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](/ru/features/workspace/ "Workspace") рядом с Claude Code или Codex, каждый в своём git worktree. Агенты Kiro работают во flows, массовых рассылках и запланированных задачах и получают автоматическое код-ревью в конце каждого хода.

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

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

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

## Частые вопросы

**Kiro CLI бесплатный?** Сама CLI ничего не стоит, а бесплатный тариф включает 50 кредитов. На октябрь 2026 года платные тарифы начинаются с 20 $ в месяц за 1000 кредитов (Pro), выше идут Pro+, Pro Max и Power. Дополнительное использование стоит 0,04 $ за кредит.

**Чем Kiro IDE отличается от Kiro CLI?** Это два способа работать с одним и тем же Kiro: IDE — десктопный редактор, CLI — чат в терминале. Оба используют ваш аккаунт и кредиты Kiro и понимают steering-файлы, specs и MCP-серверы из папки .kiro.

**Читает ли Kiro CLI файл AGENTS.md?** Да. Kiro считает AGENTS.md steering-файлом, который подключается всегда. Собственные steering-файлы Kiro лежат в .kiro/steering/ внутри проекта и в ~/.kiro/steering/ для глобальных правил.

**Что такое Kiro CLI V3?** Ранняя версия следующего поколения. Попробуйте её командой kiro-cli --v3: она работает рядом с установленной 2.x, которая остаётся без изменений, пока вы не переключитесь. V3 использует тот же движок, что и Kiro IDE, и добавляет, среди прочего, /rewind, хуки и агента для specs.

**Можно ли использовать Kiro CLI в CI?** Да. Запустите kiro-cli chat --no-interactive с промптом и задайте KIRO_API_KEY. API-ключи доступны на тарифах Pro, Pro+, Pro Max и Power, но не на бесплатном.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/