Kiro CLIとは

Kiro CLIは、AWSが提供するAI搭載の開発者向けコマンドラインツールです。ターミナルから直接AIエージェントと対話し、コードの生成・テスト・デプロイを自然言語で指示できます。

IDE（統合開発環境）を起動しなくても、ターミナルひとつでAIの力を活用した開発が可能になります。

Kiro IDE との違い

Kiro IDE と Kiro CLI は同じ Kiro エコシステムの一部ですが、用途と操作方法が異なります。

項目	Kiro IDE	Kiro CLI
インターフェース	GUI（Visual Studio Code ベース）	ターミナル
ファイル編集	エディタ上で直接	自動適用 or 確認付き
Specs	対応	非対応
Powers	対応	非対応
Custom Agents	限定的	フル機能
Code Intelligence	基本	Tree-sitter + LSP
Autocomplete	IDE内補完	ターミナルコマンド補完
パイプ連携	不可	可能
ACP（エディタ連携）	不要	対応

重要なポイントは、設定が共有されることです。MCP サーバー、ステアリングファイル、プロジェクト設定は IDE と CLI で共通して使えます。

flowchart TB
    subgraph Kiro["Kiro エコシステム"]
        IDE["Kiro IDE<br/>GUI開発"]
        CLI["Kiro CLI<br/>ターミナル開発"]
    end
    subgraph Shared["共有リソース"]
        Steering["ステアリング<br/>.kiro/steering/"]
        MCP["MCP設定<br/>.kiro/settings/mcp.json"]
        Agents["エージェント<br/>.kiro/agents/"]
    end
    subgraph External["外部連携"]
        Model["AI モデル<br/>Claude Opus/Sonnet/Haiku"]
        Tools["外部ツール<br/>GitHub, AWS, DB..."]
    end
    IDE --> Shared
    CLI --> Shared
    Shared --> Model
    Shared --> Tools
    style Kiro fill:#3b82f6,color:#fff
    style Shared fill:#8b5cf6,color:#fff
    style External fill:#22c55e,color:#fff

インストール

macOS

macOS へのインストールはワンコマンドで完了します。

curl -fsSL https://cli.kiro.dev/install | bash

Linux（ZIP）

Linux 環境では、アーキテクチャに合わせたパッケージをダウンロードします。

# x86_64 (glibc 2.34+)
curl --proto '=https' --tlsv1.2 -sSf \
  'https://desktop-release.q.us-east-1.amazonaws.com/latest/kirocli-x86_64-linux.zip' \
  -o 'kirocli.zip'

# ARM aarch64 (glibc 2.34+)
curl --proto '=https' --tlsv1.2 -sSf \
  'https://desktop-release.q.us-east-1.amazonaws.com/latest/kirocli-aarch64-linux.zip' \
  -o 'kirocli.zip'

# 展開とインストール
unzip kirocli.zip
./kirocli/install.sh

glibc のバージョンは ldd --version で確認できます。2.34 未満の場合は musl 版を使用してください。

Ubuntu（.deb パッケージ）

wget https://desktop-release.q.us-east-1.amazonaws.com/latest/kiro-cli.deb
sudo dpkg -i kiro-cli.deb
sudo apt-get install -f

Linux AppImage

ポータブル形式で実行できます。

wget https://desktop-release.q.us-east-1.amazonaws.com/latest/kiro-cli.appimage
chmod +x kiro-cli.appimage
./kiro-cli.appimage

Windows

現時点でネイティブの Windows 版はありません。WSL（Windows Subsystem for Linux） を通じて Linux 版をインストールしてください。

企業環境でのプロキシ設定

企業ネットワークなどプロキシが必要な環境では、環境変数を設定します（v1.8.0+）。

export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1,.company.com

# 認証付きプロキシ
export HTTP_PROXY=http://username:password@proxy.company.com:8080

認証とログイン

インストール後、最初にログインが必要です。

kiro-cli login

以下の認証プロバイダーに対応しています。

プロバイダー	コマンド
AWS Builder ID（デフォルト）	kiro-cli login
Google	kiro-cli login --social google
GitHub	kiro-cli login --social github
IAM Identity Center	kiro-cli login --license pro --identity-provider <URL> --region <REGION>

ログイン後、認証状態を確認するには以下のコマンドを使います。

kiro-cli whoami

JSON 形式で詳細を確認することもできます。

kiro-cli whoami --format json

初回起動

インタラクティブモード

プロジェクトディレクトリに移動して kiro-cli を実行するだけで、AIとの対話を開始できます。

cd my-project
kiro-cli

プロンプトが表示されたら、自然言語で指示を入力します。

> このプロジェクトの構造を説明してください

ワンショット実行

一度きりの質問やタスクには、引数として直接渡せます。

kiro-cli "package.jsonの依存関係を一覧にしてください"

基本コマンド

kiro-cli --help       # ヘルプ表示
kiro-cli --version    # バージョン確認
kiro-cli version --changelog  # 変更履歴表示

料金プラン

Kiro CLI は Kiro IDE と共通の料金体系を使用します。

プラン	月額	クレジット	備考
Free	$0	50	初回30日間は500クレジットのボーナス
Pro	$20	1,000	オーバーエッジ可（$0.04/クレジット）
Pro+	$40	3,000	オーバーエッジ可
Power	$200	大容量	オーバーエッジ可

利用状況はチャット中に /usage コマンドで確認できます。

環境診断

インストール後に問題がないか確認するには doctor コマンドを使います。

kiro-cli doctor

すべての診断テストを実行する場合：

kiro-cli doctor --all

JSON 形式で出力する場合：

kiro-cli doctor --format json

アンインストール

不要になった場合のアンインストール方法です。

# macOS
kiro-cli uninstall

# Ubuntu
sudo apt-get remove kiro-cli
sudo apt-get purge kiro-cli

まとめ

項目	内容
Kiro CLI の役割	ターミナルからAIエージェントを活用する開発ツール
インストール	curl -fsSL https://cli.kiro.dev/install | bash
認証	kiro-cli login（AWS Builder ID、GitHub、Google）
起動方法	kiro-cli（対話）/ kiro-cli "質問"（ワンショット）
環境診断	kiro-cli doctor
IDE との関係	設定共有、機能は異なる

Day 2 では、インタラクティブチャットの詳細な使い方を学びます。