事前セットアップガイド

想定環境

下記の構成を前提とします。まず、自分の PC がこの構成に合っているか確認してください。

VSCode のインストール

1. Windows の場合

公式サイトから「Download for Windows」でインストーラー（User Installer）を入手し、実行します。設定は既定のままで問題ありませんが、「PATH への追加」にチェックが付いていることを確認してください。

2. Mac の場合

同じ公式サイトから Mac 用の ZIP を入手し、展開してできた Visual Studio Code.app を「アプリケーション」フォルダへ移動します。初回起動時に「開いてもよいか」の確認が出た場合は「開く」を選びます。

3. 起動確認

VSCode を起動し、ようこそ画面（Welcome タブ）が表示されれば完了です。

VSCode の日本語化

メニューや設定画面を日本語表示にします。研修は日本語表示を前提に進めます。

1. VSCode 左側の四角が4つ並んだアイコン（Extensions。拡張機能の一覧画面です。Ctrl + Shift + X、Mac は Cmd + Shift + X）を開きます
2. 検索欄に Japanese Language Pack と入力します
3. 「Japanese Language Pack for Visual Studio Code」（Microsoft 公式）の Install を押します
4. 右下に再起動を促す表示が出たら「Change Language and Restart」を押します

再起動後、メニューが「ファイル」「編集」のように日本語になっていれば完了です。

Claude Code 拡張のインストール

本研修の主役は Claude Code です。日本語の文章で指示すると、ファイルの探索・作成・編集・コマンド実行までを自分で順に進めるエージェント型の AI ツールで、VSCode の拡張として使います。

1. 拡張機能（Ctrl + Shift + X、Mac は Cmd + Shift + X）を開きます
2. 検索欄に Claude Code と入力します
3. 「Claude Code」（発行元: Anthropic）の「インストール」を押します
4. インストール後、左側のアクティビティバー（画面いちばん左の縦のアイコン列）に Claude Code のアイコンが追加されます

Amazon Bedrock 接続設定

Claude Code の接続先を Amazon Bedrock（AWS 上で Claude のモデルを利用できるサービス）に切り替えます。環境変数（OS に登録しておく設定値。アプリが起動時に読み取ります）を4つ設定します。値のうち <事務局配布> の部分は、研修事務局から配布される接続情報に置き換えてください。

1. Windows の場合（PowerShell）

スタートメニューで「PowerShell」と検索して起動し、次を1行ずつ実行します。setx は環境変数を恒久的に登録するコマンドです。

setx CLAUDE_CODE_USE_BEDROCK 1
setx AWS_REGION "<事務局配布>"
setx AWS_ACCESS_KEY_ID "<事務局配布>"
setx AWS_SECRET_ACCESS_KEY "<事務局配布>"

実行後、VSCode をいったん終了して起動し直すと反映されます（起動済みのアプリには反映されないためです）。

2. Mac の場合（ターミナル）

「アプリケーション」→「ユーティリティ」→「ターミナル」を起動し、次を実行して設定ファイル（~/.zshrc。ターミナル起動時に毎回読み込まれる設定です）に追記します。

cat >> ~/.zshrc << 'EOF'
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="<事務局配布>"
export AWS_ACCESS_KEY_ID="<事務局配布>"
export AWS_SECRET_ACCESS_KEY="<事務局配布>"
EOF

追記後、VSCode をいったん終了し、ターミナルから code と打つか Dock から起動し直します。

JDK 17 の準備

課題B で Java・Spring Boot のアプリを動かすために使います。Eclipse Temurin の JDK 17 を推奨します。

1. Windows の場合

adoptium.net から Windows x64 の MSI を入手し、インストーラーを実行します。インストール時に「Set JAVA_HOME variable」「Add to PATH」のオプションが選べる場合は、両方を有効にしてください。

2. Mac の場合

同じページから macOS の PKG（Apple Silicon は aarch64、Intel は x64）を入手し、インストーラーを実行します。

3. 確認

Windows は PowerShell、Mac はターミナルで次を実行します。

java -version

出力の先頭が 17. で始まっていれば準備完了です（例: openjdk version "17.0.11"）。

配布 ZIP の展開

1. ZIP の展開

事前配布する handson.zip を、日本語と空白を含まないパスに展開します。展開すると handson フォルダができ、中に課題A の kadaiA、課題B の kadaiB、ヒント集の hints などが含まれます。

Windows の例: C:\handson\
Mac の例:     /Users/<ユーザー名>/handson/

デスクトップや「ダウンロード」など日本語・空白を含む場所はビルドで問題が出ることがあるため避けてください。

2. VSCode でフォルダを開く

VSCode の「ファイル」→「フォルダーを開く」で、展開した handson フォルダを開きます。「このフォルダーの作成者を信頼しますか」と確認された場合は「はい、作成者を信頼します」を選びます。

動作確認

handson フォルダを開いた VSCode で、アクティビティバーの Claude Code アイコンを押してパネルを開きます。入力欄に次のとおり指示してください。

こんにちはと返してください

「こんにちは」を含む応答が返ってくれば、Bedrock 接続まで含めて準備完了です。ファイルは変更されないので、そのまま閉じて構いません。

確認チェックリスト

すべてにチェックが入れば準備完了です。準備が終わらない、または不明点が残る場合は、案内メールの問い合わせ先までご連絡ください。

• VSCode が起動し、メニューが日本語で表示される
• 拡張機能に Claude Code（発行元: Anthropic）が入っている
• 環境変数4つ（CLAUDE_CODE_USE_BEDROCK と AWS の3項目）を事務局配布の値で設定済み
• java -version が 17. から始まる
• 配布 ZIP（handson.zip）を日本語・空白を含まないパスに展開済み
• VSCode で handson フォルダを開ける
• Claude Code に「こんにちはと返してください」と指示して応答が返る

トラブルシューティング

参考リンク