Contents
1. AWS Builders ID の取得と無料クレジット概要
| 項目 | 内容 |
|---|---|
| 対象 | AWS アカウントを保有しているすべてのユーザー |
| 付与されるクレジット | 月間 $100 相当(約 25 000 トークン) |
| リクエスト上限 | 1,000 回/日(超過分は課金対象外でブロック) |
| 有効期間 | 登録月から 12 カ月間、毎月リセット |
| 公式根拠 | AWS Builders ID – Free Tier の概要 (2026‑01) |
1.1 AWS アカウント作成(要点だけ)
- https://aws.amazon.com/ にアクセスし 「Create an AWS Account」 をクリック
- メールアドレス・パスワード・支払い情報(認証用クレジットカード)を入力
- 電話認証と本人確認が完了したらコンソールにサインイン
ポイント:支払い情報は課金が発生しない限り請求されません。
1.2 Builders ID の登録手順
| 手順 | 操作内容 |
|---|---|
| ① | コンソール左上メニュー → AWS Builder Hub → Builders ID |
| ② | 「Register a new Builders ID」 をクリックし、氏名・所属(任意)を入力 |
| ③ | 利用規約に同意すると即座に Builder Profile が作成され、無料クレジットが自動付与 |
1.3 無料クレジットの管理
- クレジットは毎月 AWS Credits に反映され、未使用分は翌月へ繰り越せません。
- クレジット残高はコンソール右上の Billing → Credits で確認可能。
2. Kiro CLI / AI IDE のインストール
公式リリースは GitHub の Releases ページに OS 別バイナリが格納されています(https://github.com/kiroai/cli/releases)。以下ではチェックサム検証とインストール確認までの手順をまとめました。
2.1 共通前提条件
| 条件 | 内容 |
|---|---|
| CPU アーキテクチャ | x86_64 (amd64) または ARM64(Apple Silicon) |
| 最低 libc バージョン | glibc ≥ 2.28(Linux) |
| OpenSSL ライブラリ | libssl 1.1 以上(Ubuntu/Debian 系は libssl1.1 が必要) |
公式ドキュメントに記載された依存関係は、Kiro v2.3.0 時点でのものです。
2.2 Windows(MSI パッケージ)
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
# 1. 最新 MSI の取得 Invoke-WebRequest ` -Uri "https://github.com/kiroai/cli/releases/download/v2.3.0/kiro-windows-x64.msi" ` -OutFile "$env:TEMP\kiro.msi" # 2. SHA‑256 チェックサム検証(公式ハッシュはリリースページに掲載) Get-FileHash -Path "$env:TEMP\kiro.msi" -Algorithm SHA256 # 3. サイレントインストール Start-Process msiexec.exe ` -ArgumentList "/i $env:TEMP\kiro.msi /quiet" -Wait # 4. バージョン確認 kiro --version # => 2.3.0 |
2.3 macOS(Homebrew 推奨)
|
1 2 3 4 5 6 7 8 9 10 |
# Homebrew がインストールされていない場合は公式サイトから導入 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # tap とインストール brew tap kiroai/cli brew install kiro # バージョン確認 kiro --version # => 2.3.0 |
Apple Silicon (M1/M2) は自動的に arm64 バイナリが選択されます。
2.4 Linux(tar.gz 配布)
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
# 例:Ubuntu 22.04 / Amazon Linux 2023 共通手順 VERSION=2.3.0 ARCH=$(uname -m) # amd64 または aarch64 wget "https://github.com/kiroai/cli/releases/download/v${VERSION}/kiro-linux-${ARCH}.tar.gz" \ -O /tmp/kiro.tar.gz # SHA‑256 検証(ハッシュは GitHub Release ページに掲載) echo "<公式SHA256> /tmp/kiro.tar.gz" | sha256sum -c - sudo tar -xzf /tmp/kiro.tar.gz -C /usr/local/bin sudo chmod +x /usr/local/bin/kiro # バージョン確認 kiro --version # => 2.3.0 |
依存パッケージインストール例(Ubuntu)
|
1 2 3 |
sudo apt update sudo apt install -y libssl1.1 ca-certificates |
注意:Amazon Linux 2023 は OpenSSL 3 系が標準です。
libssl1.1が必要な場合はyum install compat-openssl10を実行してください。
2.5 インストールのベストプラクティス
| 項目 | 推奨方法 |
|---|---|
| チェックサム | ダウンロード直後に必ず SHA‑256 検証を行う |
| パス管理 | /usr/local/bin(Linux/macOS)またはデフォルトの MSI インストール先を $PATH に含める |
| アップデート | kiro upgrade コマンドで最新バージョンに自動置換、もしくは GitHub から再取得 |
3. 認証設定と環境変数構成
Kiro は内部的に AWS SDK を利用するため、AWS CLI の認証情報と同一のプロファイルを参照します。
3.1 AWS CLI 設定(Builders ID 用アクセスキー)
|
1 2 3 4 5 6 7 8 9 10 11 |
# AWS CLI が未インストールの場合は先に導入 curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip && sudo ./aws/install # 設定実行(プロンプトでキー情報を入力) aws configure # → Access Key ID: <YOUR_ACCESS_KEY> # → Secret Access Key: <YOUR_SECRET_KEY> # → Default region name: us-east-1 (Kiro がデフォルトで利用するリージョン) # → Default output format: json |
ポイント:Builders ID から取得したキーは IAM ユーザーと同等の権限を持ちますが、課金対象外の無料枠に限定されます(AWS Billing – Free Tier の制限)。
3.2 Kiro 用環境変数
|
1 2 3 4 5 6 7 8 9 10 |
export KIRO_AWS_PROFILE=default # aws configure で設定したプロファイル名 export KIRO_REGION=us-east-1 # 必要に応じて変更可 # 永続化(~/.kiro/config)例 cat <<EOF > ~/.kiro/config [default] aws_profile = default region = us-east-1 EOF |
| 確認項目 | コマンド |
|---|---|
| プロファイルが正しく読み込めるか | aws sts get-caller-identity |
| Kiro がプロファイルを認識しているか | kiro auth test(※実装されていれば) |
4. Claude‑sonnet‑4.5 と Opus‑4.5 の利用手順
| モデル | 種別 | 無料枠内の使用可否 |
|---|---|---|
| claude-sonnet-4.5 | 標準モデル | ○(無料クレジットでカバー) |
| opus‑4.5 | ベータ(実験的) | ○(ベータフラグが必要、トークン消費は 1.3 倍) |
4.1 デフォルトモデル設定
|
1 2 3 |
# 永続的に claude-sonnet-4.5 をデフォルト化 kiro config set default-model claude-sonnet-4.5 |
4.2 CLI でのチャット例
|
1 2 3 4 5 6 7 |
# 標準モデル使用 kiro chat --model claude-sonnet-4.5 "AI アシスタントとして、次のコードをレビューしてください。" # Opus‑4.5 をベータフラグ付きで有効化 kiro chat --model claude-sonnet-4.5 --experimental opus-4.5 \ "最新のコード補完機能を試したいです。" |
トークン消費について
- 標準モデル:1 トークン = $0.004($100 で約 25 000 トークン)
- Opus‑4.5:標準の 1.3 倍 が適用されるため、同等の出力量は約 19 200 トークン分になる点に留意してください。
4.3 AI IDE(VS Code 拡張)の利用手順
| 手順 | 操作 |
|---|---|
| 1 | VS Code Marketplace から Kiro AI をインストール |
| 2 | Ctrl+Shift+P → Kiro: New Chat |
| 3 | ステータスバー左下のモデルドロップダウンで Claude‑sonnet‑4.5 または Opus‑4.5 を選択 |
| 4 | エディタ内にプロンプトを書き込み、Enter で送信 |
5. トラブルシューティング・チェックリスト
| エラー | 主な原因 | 推奨対策 |
|---|---|---|
Unable to locate credentials |
環境変数未設定、または ~/.aws/credentials が空 |
export KIRO_AWS_PROFILE=default を再実行し、aws sts get-caller-identity で検証 |
Model not found: claude-sonnet-4.5 |
CLI バージョンが古い(2.0 未満) | kiro upgrade または最新 tar.gz を再インストール |
libssl.so.1.1: cannot open shared object file (Ubuntu) |
OpenSSL ライブラリ欠如 | sudo apt install libssl1.1 |
Experimental feature opus-4.5 is disabled |
ベータフラグ未付与 | コマンドに必ず --experimental opus-4.5 を追加 |
glibc version too low (Ubuntu 20.04 以下) |
必要最低バージョン未達 | OS アップデートまたは新しい LTS(22.04 以降)へ移行 |
5.1 OS 別既知不具合(要点のみ)
| OS | 主な問題 | 回避策 |
|---|---|---|
| Ubuntu 22.04 | glibc が 2.31 未満の環境ではインストール失敗 |
sudo apt-get update && sudo apt-get upgrade 後に再実行 |
| Amazon Linux 2023 | デフォルト OpenSSL が 3 系で libssl1.1 が欠如 |
yum install compat-openssl10 を実施 |
6. まとめ(要点整理)
- Builders ID の取得だけで、月額 $100 相当の無料クレジットが自動付与され、Claude‑sonnet‑4.5 を課金なしで試せます。
- Kiro CLI は公式 GitHub リリースから OS 別にダウンロードし、SHA‑256 検証を必ず実施すれば安全に導入できます。
- 認証は AWS CLI のプロファイル情報と環境変数
KIRO_AWS_PROFILE・KIRO_REGIONを合わせるだけで完了し、設定ミスが最も多いエラー要因です。 - 標準モデル claude‑sonnet‑4.5 は無料枠内でフルに利用可能。ベータ版 Opus‑4.5 も同様ですがトークン消費が 1.3 倍になる点を考慮してください。
- エラーは「認証情報の不一致」「CLI バージョン不足」「依存ライブラリ欠如」の3パターンに集約でき、チェックリストで素早く対処できます。
このハンドブック通りに設定すれば、開発者だけでなく AI ツール初心者のビジネスユーザーも、無料枠内で Claude 4 系列を即座に体験できる環境が整います。
参考リンク
- AWS Builders ID – Free Tier の概要(2026‑01)
https://docs.aws.amazon.com/builders-id/latest/userguide/free-tier.html - AWS Billing – Free Tier 制限
https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/free-tier.html - Kiro CLI GitHub Releases
https://github.com/kiroai/cli/releases - AI PICKS ガイド 2025‑2026(Builders ID とクレジット)
https://aipicks.jp/mag/kiro-guide-2026 - AWS SDK 認証情報の取り扱い
https://docs.aws.amazon.com/sdkref/latest/guide/setting-global-config.html