コンテンツにスキップ

AI Agent Development Code Server

AI Agent Development Code Server は、Amazon Bedrock Agent Core を活用した AI エージェントの開発に必要なソフトウェア等が事前セットアップされた開発環境です。ブラウザベースの VS Code (Code-Server) を使用し、AWS 上に開発環境を構築します。

overview

主な機能

  • ブラウザベース開発環境 - code-server による VS Code 互換の開発体験
  • 事前設定済み開発ツール - AgentCore CLI、AWS CLI、SAM CLI、Kiro CLI、Claude Code、uv、Docker などを標準装備
  • Amazon Bedrock Agent Core 対応 - エージェント開発に必要な権限とツールを事前設定
  • CloudFront 経由のセキュアアクセス - HTTPS による安全な接続
  • 自動環境構築 - SSM Document による一貫性のある環境セットアップ

活用いただいた記事

AWS へのデプロイ

次のボタンからデプロイできます。AWS へログイン後クリックしてください。

 Deploy

パラメーター設定

デプロイ時に以下のパラメーターを設定できます:

  • UserEmail (必須)
    • ユーザーのメールアドレスです。Git 設定と Code Server のユーザー名として使用されます。
    • デプロイ完了通知もこのアドレスに送信されます。
  • UserFullName (デフォルト: AIAgent Developer)
    • Git 設定に使用されるフルネームです。
  • InstanceType (デフォルト: t4g.large)
    • EC2 インスタンスタイプです。ARM64 アーキテクチャ (Graviton) のインスタンスを使用します。性能と価格は以下を目安にしてください。ハイパフォーマンスな環境が必要な場合、m7g/c7g を検討ください。
    • 以下は us-east-1 のオンデマンド料金 の目安です (AWS Price List API 2026-08-31 時点、1 USD = 160 円換算)。
    • 価格・為替レートはいずれも変動します。 また料金はリージョンによって異なります (例: 東京リージョンは us-east-1 の約 1.29 倍)。実際の費用は必ず最新の料金とその時点の為替レートでご確認ください。
    • t4g.medium : 2 vCPU + 4G メモリ, 24 時間で 130 円ぐらい (エージェント実行には非推奨)
    • t4g.large : 2 vCPU + 8G メモリ, 24 時間で 260 円ぐらい (デフォルト)
    • t4g.xlarge : 4 vCPU + 16G メモリ, 24 時間で 520 円ぐらい (コンテナビルドを多用する場合)
    • t4g.2xlarge : 8 vCPU + 32G メモリ, 24 時間で 1,030 円ぐらい
    • m7g.large : 2 vCPU + 8G メモリ, 24 時間で 310 円ぐらい (バースト不要の場合)
    • m7g.xlarge : 4 vCPU + 16G メモリ, 24 時間で 630 円ぐらい
    • メモリについて: code-server、エージェント CLI のセッション、agentcore dev で起動するローカルエージェント、Docker が同時に動作します。4G (t4g.medium) では OOM でハングアップする可能性があるため、8G 以上を推奨します。
  • InstanceVolumeSize (デフォルト: 40)
    • EBS ボリュームサイズ (GB) です。
  • HomeFolder (デフォルト: /workshop)
    • 作業ディレクトリのパスです。リポジトリがクローンされる場所になります。
  • RepoUrl (デフォルト: https://github.com/aws-samples/sample-amazon-bedrock-agentcore-onboarding.git)
    • 自動的にクローンする Git リポジトリの URL です。
  • EnableAdministratorAccess (デフォルト: false)
    • EC2 インスタンスロールに AdministratorAccess ポリシーをアタッチするかどうかを指定します。CDK のブートストラップやデプロイなど、IDE から AWS リソースを操作する場合は true に設定してください。

デプロイ後の設定

デプロイのボタンを押すと、しばらくしてから AI Agent Dev Code Server Deployment Notifications - Subscription Confirmation というメールが届くため Confirm subscription のリンクを押してください。これで、デプロイが完了したらメールが届くようになります。

デプロイ完了後、通知メールに記載された URL からブラウザベースの開発環境にアクセスし、パスワードを入力し環境にログインしてください。

  • パスワードは CloudFormation の出力 / Outputs で確認できます
  • 必要に応じ、Amazon Bedrock のモデルを有効化してください
  • Kiro CLI が設定済みです。利用する場合、 kiro-cli login --use-device-flow を使用し認証を完了してください

開発環境の特徴

開発環境には以下のツールが事前インストールされています:

  • AWS ツール: AgentCore CLI (agentcore)、AWS CLI v2、AWS SAM CLI、Kiro CLI
  • AI コーディングツール: Kiro CLI、Claude Code (claude)
  • 開発ツール: Git、Docker、Python、UV、NVM (Node.js LTS、NPM)
  • エディタ: Code-Server (Claude Code 拡張機能を同梱。その他の拡張機能はディスク容量を抑えるため既定では導入していません)

環境変数も自動設定されます:

  • AWS_REGION - デプロイしたリージョン
  • AWS_ACCOUNTID - AWS アカウント ID

セキュリティ

  • EC2 インスタンスへの直接アクセスは制限され、CloudFront 経由のみアクセス可能
  • セキュリティグループは CloudFront の Prefix List のみを許可(リージョンごとに設定)
  • パスワードは AWS Secrets Manager で安全に管理
  • EBS ボリュームは暗号化済み
  • SSM Session Manager による管理アクセス

コスト

主なコストは以下のリソースから発生します:

  • EC2 インスタンス - t4g.large (2 vCPU, 8GB メモリ) の実行時間に応じた課金 (us-east-1 のオンデマンドで 24 時間使った場合 260 円程度です)
  • EBS ボリューム - 40GB (デフォルト) の gp3 ストレージ料金
  • CloudFront - データ転送量に応じた課金
  • その他 - VPC、Secrets Manager、SNS などの最小限のコスト

使用しない場合は EC2 インスタンスを停止することでコストを削減できます。ただし、CloudFront と EBS ボリュームは停止中も課金されます。

リソースの削除

使用を終了する場合は、CloudFormation コンソールからスタックを削除してください:

  1. CloudFormation コンソールにアクセス
  2. デプロイしたスタック(デフォルト: AIAgentDevDeploymentStack)を選択
  3. 「削除」ボタンをクリック

削除時の注意

  • スタックを削除すると、EC2 インスタンスと EBS ボリュームも削除されます
  • 作業中のコードやデータは事前にバックアップしてください
  • Secrets Manager のシークレットは削除されますが、復旧期間(デフォルト 30 日)があります

追加リソース

Amazon Bedrock Agent Core のハンズオンがデフォルトで設定されています。詳細は README.md をご覧ください。

他、書籍のハンズオンを行う際にも活用ください!