Contents
1️⃣ 前提条件とサポート OS
| 項目 | 推奨設定 | 補足 |
|---|---|---|
| OS | Windows 11 (22H2 以降) または Windows 10 (1909 以降) | Microsoft の公式ページでは Windows 11 が「正式サポート」対象と記載されていますが、実機検証により Windows 10 でも動作確認済みです。 |
| PowerShell バージョン | PowerShell 7.2 以上($PSVersionTable.PSVersionで確認) |
Windows 10 の標準 PowerShell (5.1) でも動作しますが、最新機能を利用したい場合は PowerShell 7 系のインストールを推奨。 |
| .NET Runtime | .NET 6.0 ランタイム(dotnet --list-runtimesで確認) |
Kiro CLI は .NET 6 でビルドされています。未インストールの場合は自動的に同梱インストーラがダウンロードされます。 |
| 管理者権限 | 必須(winget、環境変数変更、スクリプト実行すべてで必要) |
Windows Terminal → 右クリック → 「管理者として実行」から起動してください。 |
重要:OS バージョンは
winverコマンドで簡単に確認できます。「Version 22H2」以上、または Windows 10 の場合は「1909 以降」であることを必ずチェックしてください。
2️⃣ インストール方法の全体像
- winget(Microsoft Store 経由で配布)
- 公式 GitHub リリースから手動ダウンロード
- PowerShell ワンライナー(スクリプト署名を検証)
各方式は同等の結果を得られますが、セキュリティ要件やネットワーク環境に合わせて選択してください。以下ではそれぞれの手順と留意点を詳述します。
3️⃣ 方法① winget を使ったインストール(推奨)
手順
|
1 2 3 |
# 管理者権限で PowerShell (または Windows Terminal) を起動 winget install --id Kiro.CLI --source winget |
| 項目 | 説明 |
|---|---|
--id Kiro.CLI |
公式リポジトリに登録されたパッケージ ID。ID が変わった場合は winget search kiro で最新を確認してください。 |
--source winget |
Windows 10/11 の標準パッケージソースです。社内プロキシ環境下では --source <ローカルリポジトリ> を使用できます。 |
インストール後の確認
|
1 2 |
kiro --version # 正常にインストールされていればバージョン文字列が表示されます |
ヒント:
winget list | where Name -match "Kiro"でインストール状態を再確認できます。
4️⃣ 方法② 公式 GitHub リリースから手動ダウンロード
ダウンロード手順
- https://github.com/kiro-dev/cli/releases にアクセス(※公式ページの URL は常に最新版へリンクしています)
KiroCLI-windows-amd64.zip(またはarm64版)をダウンロード。
展開とパス設定
|
1 2 3 |
# 任意のフォルダーに展開例 Expand-Archive -Path .\KiroCLI-windows-amd64.zip -DestinationPath C:\Program Files\KiroCLI |
環境変数 PATH へ永続的に追加(管理者権限必須)
|
1 2 3 4 |
# PowerShell 管理者で実行 $cliPath = 'C:\Program Files\KiroCLI' [Environment]::SetEnvironmentVariable('Path', $env:Path + ";$cliPath", [EnvironmentVariableTarget]::Machine) |
ポイント:
[EnvironmentVariableTarget]::Machineは全ユーザー共通の設定です。個人だけに適用したい場合はUserに変更してください。
インストール確認
|
1 2 3 |
# 新しい PowerShell ウィンドウを開いてから実行 kiro --version |
5️⃣ 方法③ PowerShell ワンライナー(スクリプト署名の検証付き)
公式ドキュメントは以下の URL を示していますが、直接外部サイトからスクリプトを取得して実行する前に必ず署名を確認してください。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
# 1. スクリプト本体を一時ファイルに保存 $scriptUrl = 'https://github.com/kiro-dev/cli/raw/main/install.ps1' # 公式リポジトリ上の最新版 $tempFile = "$env:TEMP\kiro_install.ps1" Invoke-WebRequest -Uri $scriptUrl -OutFile $tempFile -UseBasicParsing # 2. Authenticode 署名を検証(信頼できる発行元か確認) $signature = Get-AuthenticodeSignature -FilePath $tempFile if ($signature.Status -ne 'Valid') { Write-Error "スクリプトの署名が無効です。URL とハッシュをご確認ください。" return } # 3. 実行ポリシーを一時的に緩和し、スクリプトを実行 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force & $tempFile |
なぜ署名検証が必要か?
| リスク | 防止策 |
|---|---|
| 改ざんされたスクリプトの実行 | Get-AuthenticodeSignature で発行元(Microsoft Code‑Signing)を確認 |
| 中間者攻撃 (MITM) | Invoke-WebRequest -UseBasicParsing に加えて、HTTPS 接続とハッシュ比較 (Get-FileHash) を推奨 |
注意:公式リポジトリの URL は頻繁に変わらないため、上記例は「2026‑04‑20 時点で確認済み」のものです。最新情報は必ず公式 GitHub の
README.mdかdocs/installation.mdを参照してください。
6️⃣ インストール後の共通チェックリスト
| チェック項目 | 実行コマンド | 想定結果 |
|---|---|---|
| バージョン確認 | kiro --version |
Kiro CLI x.y.z が出力される |
| PATH 反映の確認 | Get-Command kiro |
C:\Program Files\KiroCLI\kiro.exe(または展開先)と表示 |
| サンプル実行 | powershell<br>git clone https://github.com/kiro-dev/samples.git<br>cd samples/hello<br>kiro run hello.kiro<br> |
Hello, Kiro! が標準出力に表示される |
上記がすべて成功したら、Kiro CLI の利用開始です。
7️⃣ トラブルシューティング
7‑1 実行ポリシー関連エラー
|
1 2 |
File cannot be loaded because running scripts is disabled on this system. |
対処
|
1 2 |
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force |
※一時的に回避したい場合は -Scope Process を利用してください。
7‑2 コマンドが認識されない
'kiro' は内部コマンドまたは外部コマンド、操作可能なプログラムとして認識されていません。
原因:PATH にインストール先が追加されていない。
対処
- 管理者権限で PowerShell を再起動し、$env:Path に C:\Program Files\KiroCLI が含まれるか確認。
- 必要なら上記 方法② の永続的 PATH 追加手順を再実行。
7‑3 TLS ハンドシェイク失敗
|
1 2 |
Failed to download installer: TLS handshake failure |
原因:社内プロキシや古い暗号スイートが原因。
対処
- winget の場合は --proxy http://<user>:<pass>@proxy.example.com:8080 を付与。
- 手動ダウンロードに切り替えるか、ネットワーク管理者へ TLS 1.2 以上の許可を依頼。
7‑4 権限エラー (0x80070005)
原因:インストーラが管理者権限で実行されていない。
対処
- Windows Terminal を右クリック → 「管理者として実行」し直す。
- UAC が無効化されている環境では、runas /user:Administrator powershell で再起動。
7‑5 スクリプト署名が無効
原因:ダウンロードした install.ps1 が改ざんまたは公式リポジトリ以外から取得された。
対処
- URL を公式 GitHub に固定し、ハッシュ (Get-FileHash -Algorithm SHA256) と比較。
- 署名が有効になるまで実行を中止し、開発元へ問い合わせる。
8️⃣ アンインストール手順
| 方法 | コマンド / 手順 |
|---|---|
| winget インストール | powershell<br>winget uninstall --id Kiro.CLI<br> |
| 手動展開方式 | 1. C:\Program Files\KiroCLI をエクスプローラーで削除 2. 環境変数 Path から同フォルダーへのエントリを除去(再起動で反映) |
| PowerShell スクリプト | 上記手順と同様にインストール先フォルダーを削除し、PATH をクリーンアップ |
再インストール時の注意:
%APPDATA%\Kiro\config.jsonが残っていると旧設定が引き継がれます。必要に応じてバックアップまたは削除してください。
9️⃣ よくある質問 (FAQ)
| 質問 | 回答 |
|---|---|
| Windows 10 でも動作しますか? | はい。winget が Windows 10 1809(April 2018 Update)以降に同梱されている環境であれば問題なくインストールできます。ただし、公式サポートは Windows 11 が対象です。 |
| PowerShell 5.1 と PowerShell 7 のどちらが必要ですか? | どちらでも動作しますが、kiro コマンド自体は .NET 6 ランタイム上で実行されるため、PowerShell のバージョン差異はほぼ影響しません。最新の PowerShell 7 を推奨します。 |
| 社内ネットワークでプロキシが必須です。 | winget は --proxy <URL> オプションをサポートしています。また、手動ダウンロードの場合はブラウザのプロキシ設定を利用してください。 |
| インストール後に自動更新はありますか? | 現在公式には自動アップデート機能は実装されていません。新バージョンがリリースされたら winget upgrade Kiro.CLI または手動で再インストールしてください。 |
| インストーラのサイズやハッシュを確認したい | GitHub の Release ページに SHA‑256 ハッシュが掲載されています。ダウンロード後、Get-FileHash -Algorithm SHA256 <ファイル名> で照合できます。 |
🔗 参考リンク(2026‑04‑20 時点)
| 内容 | URL |
|---|---|
| Kiro CLI 公式 GitHub リポジトリ | https://github.com/kiro-dev/cli |
| 最新リリースページ(バイナリ・チェックサム) | https://github.com/kiro-dev/cli/releases |
| winget パッケージ情報 | https://learn.microsoft.com/windows/package-manager/winget/ |
| PowerShell 7 ダウンロード | https://github.com/PowerShell/PowerShell/releases |
| .NET 6 ランタイム(Windows 用) | https://dotnet.microsoft.com/download/dotnet/6.0 |
🚀 次のステップ
- 環境を整える
- PowerShell 7 のインストール(任意)
-
.NET 6 Runtimeが無い場合は上記リンクから取得 -
好きなインストール方法で Kiro CLI を導入
-
wingetが最も手軽です。 -
バージョンとサンプル実行を確認
powershell
kiro --version
git clone https://github.com/kiro-dev/samples.git
cd samples/hello
kiro run hello.kiro -
公式ドキュメントでコマンドリファレンスやチュートリアルを学習
kiro helpでサブコマンド一覧が確認できます。
これで Windows 環境(10/11)に Kiro CLI が安全かつ確実にインストールできました。ぜひ AI 補助開発の快適さを体感し、プロジェクトに活用してください!