Kiro Beginner Setup Guide: Install, AWS Connect & VS Code Tips

Contents

1 1. ダウンロードページと OS／アーキテクチャ別バイナリ選択
2 2. OS 別インストール手順
3 3. 初回起動時の認証設定 ― AWS クレデンシャル・IAM ロール・Compute Profile
4 4. Kiro UI でプロジェクト作成 → VS Code 連携
5 5. VS Code 拡張機能のインストールと警告対処法
6 6. Kiro CLI の基本操作・設定ファイル位置・請求プラン確認・代表的エラーとその対策
7 7. まとめ

スポンサードリンク

1. ダウンロードページと OS／アーキテクチャ別バイナリ選択

OS	アーキテクチャ例	提供されているパッケージ	主な注意点
Windows	x86_64 (64 bit)	`kiro-windows-x64.exe`	64 bit 環境であることを確認。インストーラは管理者権限が必要です。
macOS	Apple Silicon (arm64)	`kiro-macos-arm64.dmg`	M1/M2 系 CPU 用。 Intel (x86_64) 用は `kiro-macos-x86_64.pkg` を選択してください。
Linux	amd64 (x86_64) arm64 (aarch64) など	`kiro-linux-<arch>.tar.gz`（例: `kiro-linux-amd64.tar.gz`）	解凍後に実行権限を付与し、PATH に配置する必要があります。

取得手順

公式ダウンロードページ https://kiro.dev/downloads/ を開く。
「Operating System」欄で自分の OS とアーキテクチャを選択し、表示されたリンクからバイナリを保存する。
ダウンロードしたファイル名・拡張子が上表と一致していることを必ず確認してください。

ポイント：公式ページ以外のミラーサイトやサードパーティ製ビルドは、改ざんリスクがあるため使用しないでください。

2. OS 別インストール手順

2‑1. Windows

# 1&#xfe0f;&#x20e3; ダウンロードした exe を右クリック → 「管理者として実行」  
Start-Process .\kiro-windows-x64.exe -Verb RunAs

# 1️⃣ ダウンロードした exe を右クリック → 「管理者として実行」

Start-Process .\kiro-windows-x64.exe -Verb RunAs

手順	内容
インストール先	デフォルト (`C:\Program Files\Kiro`) 推奨。カスタマイズが必要な場合はインストーラの指示に従う。
PATH への自動登録	インストーラが `C:\Program Files\Kiro` をシステム PATH に追加します。再起動は不要です。
動作確認	`cmd` または PowerShell で `kiro --version` → バージョン情報が表示されれば完了。

2‑2. macOS

# Apple Silicon (M1/M2) の場合
open kiro-macos-arm64.dmg   # .dmg をマウントし、インストーラを実行

# Intel Mac の場合
sudo installer -pkg kiro-macos-x86_64.pkg -target /

# Apple Silicon (M1/M2) の場合

open kiro-macos-arm64.dmg # .dmg をマウントし、インストーラを実行

# Intel Mac の場合

sudo installer -pkg kiro-macos-x86_64.pkg -target /

手順	内容
パッケージ選択	チップが Apple Silicon か Intel かを「Apple メニュー > このMacについて」から確認。
インストール後の配置	バイナリは `/usr/local/bin/kiro` に配置されます。
PATH 確認	`which kiro` が `/usr/local/bin/kiro` を返せば OK。

2‑3. Linux

# 例: amd64 バイナリを取得してインストール
wget https://kiro.dev/downloads/kiro-linux-amd64.tar.gz -O /tmp/kiro.tar.gz
tar -xzf /tmp/kiro.tar.gz -C /tmp
sudo mv /tmp/kiro /usr/local/bin/
sudo chmod +x /usr/local/bin/kiro

# 動作確認
kiro --version

# 例: amd64 バイナリを取得してインストール

wget https://kiro.dev/downloads/kiro-linux-amd64.tar.gz -O /tmp/kiro.tar.gz

tar -xzf /tmp/kiro.tar.gz -C /tmp

sudo mv /tmp/kiro /usr/local/bin/

sudo chmod +x /usr/local/bin/kiro

# 動作確認

kiro --version

手順	内容
実行権限付与	`chmod +x` が必須です。
PATH への配置	`/usr/local/bin` は多くのディストリビューションで標準的に PATH に含まれますが、カスタム環境の場合は `export PATH=$PATH:/usr/local/bin` を `.bashrc` 等に追記してください。
sudo の有無	バイナリ配置先がシステム領域 (`/usr/local/bin`) になるため、`sudo` が必要です。

共通注意点
- 管理者権限（Windows の「管理者として実行」・Linux/macOS の sudo）は必須です。
- インストール直後にシステム再起動は不要ですが、ターミナルを新しく開くと PATH が正しく反映されます。

3. 初回起動時の認証設定 ― AWS クレデンシャル・IAM ロール・Compute Profile

3‑1. AWS CLI のクレデンシャル登録

aws configure
# → Access Key ID, Secret Access Key, Default region name, Output format を入力

aws configure

# → Access Key ID, Secret Access Key, Default region name, Output format を入力

最低限必要な権限（例）
AmazonS3ReadOnlyAccess
AWSLambdaFullAccess
必要に応じて AmazonSageMakerFullAccess 等を追加してください。

※ IAM ポリシーは最小権限の原則 (Principle of Least Privilege) に従い、実際に使用するサービスだけを許可します。

3‑2. IAM ロール作成と信頼ポリシー

公式ドキュメントに記載されている Kiro のサービスプリンシパル はバージョンやリージョンによって変わる可能性があります。

※ 本稿ではプレースホルダー <Kiro-Service-Principal> を使用しています。実際の文字列は https://kiro.dev/docs/aws-integration#service-principal で確認してください。

手順（AWS コンソール）

IAM → ロール → 「ロールを作成」
信頼関係 タブで以下 JSON を貼り付け

json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "<Kiro-Service-Principal>" }, "Action": "sts:AssumeRole" } ] }

ポリシーのアタッチ
AmazonSageMakerFullAccess（SageMaker を利用する場合）
CloudWatchLogsFullAccess（ジョブログ取得用）
必要に応じてカスタムポリシーを追加
ロール名例：KiroComputeRole

3‑3. Managed Compute Profile (MCP) の有無

現行の Kiro バージョンが MCP をサポートしている場合は、UI → Settings → Compute から「Create Compute Profile」ボタンで作成できます。
MCP が未実装の場合は、代替として直接 SageMaker ノートブックインスタンスやジョブ定義を利用してください（公式ドキュメント参照）。

MCP 作成例（サポートあり）

項目	設定値の例
プロファイル名	`my-mcp`
IAM ロール	`KiroComputeRole`
インスタンスタイプ	`ml.m5.large`
最大同時ジョブ数	`3`

作成後は kiro-cli config set-profile my-mcp で CLI のデフォルトプロファイルとして設定できます。

3‑4. トークン自動更新

設定ファイル (~/.kiro/config.yaml) に以下を追記すると、CLI 起動時にトークンが自動的にリフレッシュされます。

auto_refresh: true
refresh_margin_minutes: 10   # 有効期限の10分前に更新

auto_refresh: true

refresh_margin_minutes: 10 # 有効期限の10分前に更新

ポイント：auto_refresh が無効の場合は、手動で kiro-cli auth refresh を定期実行してください。

4. Kiro UI でプロジェクト作成 → VS Code 連携

Kiro 起動（デスクトップアプリまたは kiro ui）
左上メニューの New Project をクリック。
必要項目を入力
プロジェクト名
使用する Compute Profile（MCP があれば選択）
Git リポジトリ URL（任意）
「Create」 → 作成完了画面に Open a project ボタンが表示されるのでクリック。
VS Code が自動起動し、プロジェクトルートに .kiro/ ディレクトリが生成されます。主なファイルは
config.yaml（Kiro の設定）
requirements.txt（Python 依存パッケージ）
main.py（サンプルスクリプト）

ポイント：UI 操作だけでローカル環境が整うため、CLI で手動設定する必要はありません。

5. VS Code 拡張機能のインストールと警告対処法

公式 Marketplace に掲載されている Kiro 用拡張機能は kiro.dev が発行元です。未署名（Unsigned）という警告が出る場合は、以下の手順で安全に導入できます。

5‑1. 拡張機能インストール

VS Code の 拡張機能 パネル (Ctrl+Shift+X) を開く。
検索ボックスに Kiro と入力し、公式掲載のもの（発行元が kiro.dev）を選択 → Install。

5‑2. 未署名警告への対処

警告	原因	推奨対応
「この拡張機能は未検証です」	Microsoft のコード署名プロセスを通過していない	1️⃣ 拡張機能の詳細画面で Trust を選択 2️⃣ `settings.json` に以下を追加（公式ドキュメント参照）

{
  &quot;extensions.ignoreRecommendations&quot;: true,
  &quot;security.workspace.trust.enabled&quot;: false
}

{

"extensions.ignoreRecommendations": true,

"security.workspace.trust.enabled": false

}

注意：組織のセキュリティポリシーが厳格な場合は、settings.json の変更は管理者に確認を取ってから実施してください。

5‑3. 公式情報へのリンク

拡張機能インストール手順（最新版）: https://kiro.dev/docs/vscode-extension
未署名警告の詳細と対処法: 同上ページ内「Extension security」セクション

6. Kiro CLI の基本操作・設定ファイル位置・請求プラン確認・代表的エラーとその対策

6‑1. 基本コマンド一覧

コマンド	主な用途	例
`kiro-cli init`	プロジェクト雛形作成	`kiro-cli init --name my-project`
`kiro-cli config set-profile <profile>`	デフォルト Compute Profile を切替	`kiro-cli config set-profile my-mcp`
`kiro-cli run <script.py>`	SageMaker ジョブとして Python スクリプト実行	`kiro-cli run train.py --env dev`
`kiro-cli auth refresh`	認証トークン手動更新
`kiro-cli status`	現在のジョブ・プロジェクト状態を表示	`kiro-cli status -v`

6‑2. 設定ファイル（config.yaml）の格納場所

OS	パス
Linux / macOS	`~/.kiro/config.yaml`
Windows	`%USERPROFILE%\.kiro\config.yaml`

config.yaml のサンプル

default_profile: my-mcp
profiles:
  my-mcp:
    iam_role: arn:aws:iam::123456789012:role/KiroComputeRole
    region: us-east-1
auto_refresh: true
refresh_margin_minutes: 5

default_profile: my-mcp

profiles:

my-mcp:

iam_role: arn:aws:iam::123456789012:role/KiroComputeRole

region: us-east-1