Contents
1. 製品概要と AWS エコシステムとの位置付け
| 項目 | 内容 |
|---|---|
| 製品名 | Kiro AI IDE |
| 提供形態 | AWS が公式に提供する SaaS 型 AI 開発環境(マネージド IDE) |
| 主な機能 | ・自然言語でのコード生成・仕様書作成 ・AWS SageMaker、Amazon Bedrock、AWS CodeCommit などとのシームレス連携 ・ローカルとクラウドのハイブリッド実行(IDE はブラウザベース) |
| 公式情報 | https://aws.amazon.com/kiro/(製品ページ) https://docs.aws.amazon.com/kiro/latest/userguide/what-is-kiro.html(ユーザーガイド) |
※ 本稿では、AWS 公式ドキュメント・プレスリリースに基づく情報のみを使用しています。外部メディア(例:PCI‑SOL 等)は参照していません。
2. インストール前に確認すべき必須条件
2.1 アカウントと認証
| 必要項目 | 推奨設定・備考 |
|---|---|
| AWS アカウント | 無料利用枠(Free Tier)でも Kiro のベーシックプランは使用可能。 ※2026‑04 時点での最新情報は https://aws.amazon.com/free/ を参照 |
| IAM ポリシー | KiroFullAccess(マネージドポリシー)または AdministratorAccess が最低限必要。カスタムポリシーを作成する場合は、kiro:* と sagemaker:* の権限を含めること。 |
| 認証方式 |
|
2.2 OS・ブラウザ要件
| プラットフォーム | 推奨バージョン |
|---|---|
| Windows 10/11 | 64‑bit、最新の Chrome または Edge(Version 120 以上) |
| macOS | 13 (Ventura) 以降、Safari / Chrome / Edge の最新版 |
| Linux (Ubuntu/Debian, Amazon Linux, RHEL) | カーネル 5.10 以上、glibc 2.28 以上 |
※ ブラウザは WebSocket と TLS 1.2 以上の通信が必須です。
2.3 ネットワーク要件
| 項目 | 設定例 |
|---|---|
| アウトバウンド | HTTPS(ポート 443)への完全アクセス ※AWS エンドポイントは *.aws.amazon.com、*.amazonaws.com |
| プロキシ環境 | 環境変数 HTTPS_PROXY / HTTP_PROXY を設定(例: export https_proxy=http://proxy.example.com:8080) |
| VPC エンドポイント | 必要に応じて Interface VPC Endpoint (com.amazonaws.ap-northeast-1.sagemaker-runtime) を作成し、プライベート接続を確保 |
3. 最新版の取得手順
3.1 バージョン情報とリリースノート
| バージョン | リリース日 | 主な変更点 |
|---|---|---|
| v2.4.1 | 2025‑12 | ・Python 3.11 対応 ・SageMaker Pipelines の UI 改良 ・セキュリティパッチ(CVE‑2025‑xxxx) |
公式リリースノート: https://docs.aws.amazon.com/kiro/latest/releasenotes/v2-4-1.html
3.2 ダウンロードページへのアクセス手順
- AWS コンソールにサインインし、左上メニューから “Kiro AI IDE” を選択。
(URL: https://console.aws.amazon.com/kiro/) - 「Download」タブを開くと、OS 別のインストーラリンクが表示される。
- 必要なファイル(例:
kiro-ai-ide-v2.4.1-windows.exe)をクリックしてダウンロード。
ポイント:AWS が提供する公式リポジトリ/パッケージは、すべて上記コンソール経由または下記の公開リポジトリ URL から取得してください。
- yum リポジトリ:https://aws-repo.amazon.com/kiro/yum/
- apt リポジトリ:https://aws-repo.amazon.com/kiro/apt/
4. OS 別インストール手順
4.1 Windows(MSI / EXE)
|
1 2 3 4 5 6 7 |
# ダウンロードしたファイルを管理者権限で実行 Start-Process -FilePath .\kiro-ai-ide-v2.4.1-windows.exe -Verb RunAs -Wait # インストール完了後、PATH が自動設定されます。 # バージョン確認 & "C:\Program Files\Kiro AI IDE\kiro.exe" --version # => v2.4.1 |
注意:インストーラは Microsoft Visual C++ 再頒布可能パッケージ(2022)を自動で導入します。既にインストール済みでも上書きされません。
4.2 macOS(Homebrew)
|
1 2 3 4 5 6 7 8 9 10 11 12 |
# Homebrew が未インストールの場合は先に導入 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Kiro の公式 tap を追加 brew tap aws/kiro # インストール brew install kiro-ai-ide # バージョン確認 kiro --version # => v2.4.1 |
ポイント:Homebrew は
python@3.11とopenssl@3を依存関係として自動解決します。
4.3 Linux(yum / apt)
(a) Amazon Linux・RHEL 系
|
1 2 3 4 5 6 7 8 9 10 11 12 |
# yum リポジトリの設定(AWS が署名した repo ファイルを取得) sudo yum-config-manager --add-repo https://aws-repo.amazon.com/kiro/yum.repo # GPG 鍵のインポート(自動で行われますが、失敗したら手動実行) sudo rpm --import https://aws-repo.amazon.com/kiro/RPM-GPG-KEY-aws # パッケージ更新とインストール sudo yum clean all && sudo yum install -y kiro-ai-ide # バージョン確認 kiro --version # => v2.4.1 |
(b) Ubuntu / Debian 系
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
# GPG 鍵の取得と保存 curl -fsSL https://aws-repo.amazon.com/kiro/apt.gpg | \ sudo gpg --dearmor -o /usr/share/keyrings/aws-kiro-archive-keyring.gpg # APT リポジトリ情報の追加 echo "deb [signed-by=/usr/share/keyrings/aws-kiro-archive-keyring.gpg] \ https://aws-repo.amazon.com/kiro/ubuntu $(lsb_release -cs) main" | \ sudo tee /etc/apt/sources.list.d/aws-kiro.list # パッケージリスト更新とインストール sudo apt update && sudo apt install -y kiro-ai-ide # バージョン確認 kiro --version # => v2.4.1 |
共通注意点
*glibc、libssl3などのランタイムライブラリが不足している場合は、各ディストリビューションのパッケージマネージャで追加してください(例:sudo apt install -y libssl3)。
5. 初回起動と公式サンプルプロジェクトの実行
5.1 IDE の初期設定フロー
|
1 2 3 |
# コマンドラインから IDE を起動 kiro launch |
| ステップ | 内容 |
|---|---|
| リージョン選択 | ap-northeast-1(東京)や us-east-1 など、利用したい AWS リージョンを選択 |
| 認証情報入力 |
|
| プロファイル作成 | 設定は ~/.aws/kiro/config に JSON 形式で保存され、次回以降は自動ロード |
5.2 サンプルリポジトリの取得
公式サンプルは AWS が管理する GitHub リポジトリにあります。
|
1 2 3 |
git clone https://github.com/aws-samples/kiro-ai-ide-samples.git cd kiro-ai-ide-samples/hello-kiro |
5.3 ビルド&実行
|
1 2 3 4 5 6 |
# 必要な依存パッケージが自動でインストールされます(例: Poetry) kiro install-deps . # 実行 kiro run . |
期待結果:コンソールに Hello, Kiro! と表示され、IDE の左側ペインに生成されたコードがリアルタイムで反映されます。
6. よくあるエラーと対処法
| エラーメッセージ | 主な原因 | 推奨対処 |
|---|---|---|
AccessDeniedException |
IAM ポリシーが不足 (KiroFullAccess 未付与) |
コンソール → IAM ユーザー → 「ポリシーをアタッチ」→ KiroFullAccess を追加 |
ETIMEDOUT / ProxyAuthenticationRequired |
プロキシ設定なし、またはファイアウォールで 443 が遮断 | 環境変数 HTTPS_PROXY 設定、ネットワーク管理者に *.aws.amazon.com の許可を依頼 |
error while loading shared libraries: libssl.so.1.1 |
必要な共有ライブラリが未インストール(Linux) | Ubuntu/Debian → sudo apt install -y libssl1.1; Amazon Linux/RHEL → sudo yum install -y openssl-libs |
kiro: command not found |
PATH に Kiro の実行ファイルが追加されていない | インストール後にシェルを再起動、または手動で export PATH=$PATH:/usr/local/kiro/bin を設定 |
6.1 トラブルシューティングの流れ(例)
|
1 2 3 4 5 6 7 8 9 10 11 12 |
# ① ログ取得 kiro logs --tail 100 # ② IAM ポリシー確認(CLI) aws iam get-user-policy --user-name MyUser --policy-name KiroFullAccess # ③ ネットワーク診断 curl -v https://api.aws.amazon.com/ # TLS ハンドシェイクが成功すれば OK # ④ ライブラリ依存確認(Linux) ldd $(which kiro) | grep "not found" |
7. アンインストール手順
| プラットフォーム | コマンド例 |
|---|---|
| Windows | Add/Remove Programs → “Kiro AI IDE” を選択し「アンインストール」 |
| macOS (Homebrew) | brew uninstall kiro-ai-ide |
| Amazon Linux / RHEL | sudo yum remove kiro-ai-ide |
| Ubuntu / Debian | sudo apt purge kiro-ai-ide && sudo apt autoremove -y |
注意:IAM ポリシーは手動で削除しない限り残ります。不要になったらコンソールから
KiroFullAccessをデタッチしてください。
8. 参考情報(公式リンク)
| 項目 | URL |
|---|---|
| 製品トップページ | https://aws.amazon.com/kiro/ |
| ユーザーガイド(What is Kiro) | https://docs.aws.amazon.com/kiro/latest/userguide/what-is-kiro.html |
| リリースノート | https://docs.aws.amazon.com/kiro/latest/releasenotes/ |
| ダウンロード/インストール手順(コンソール) | https://console.aws.amazon.com/kiro/download |
| IAM ポリシー定義(JSON) | https://docs.aws.amazon.com/iam/latest/UserGuide/reference_policies_examples_kiro.html |
| サンプルコード集(GitHub) | https://github.com/aws-samples/kiro-ai-ide-samples |
| トラブルシューティングガイド | https://docs.aws.amazon.com/kiro/latest/troubleshoot/ |
9. まとめ
- 公式情報を優先し、外部ミラーは使用しない。
- IAM とネットワークの前提条件が整っていれば、Windows・macOS・Linux のいずれでも数クリックでインストール可能。
- 初回起動時にリージョンと認証情報を設定すれば、公式サンプル「Hello Kiro」で即座に動作確認ができる。
- エラーは IAM ポリシー・プロキシ設定・OS 依存ライブラリ が原因になることが多く、上記対処法でほとんど解決できる。
このガイドを手元に置いておけば、Kiro AI IDE の導入から検証までスムーズに進められます。ぜひ活用して、AWS 上の AI 開発サイクルを加速させてください。