事前セットアップガイド

01このガイドが目指す状態

02所要時間の目安

すでに VSCode が入っている方は、SESSION 05・06 を飛ばせます。回線が遅い環境ではダウンロードだけで時間を取られるため、余裕のある日に進めてください。

03各セッションの読み方

どのセッションも同じ形で書いています。操作の説明のあとに、必ず「これができていればOK」という灰色の枠を置いています。次に進む前に、この枠に書かれた状態になっているかだけ確認してください。

Windows と Mac で手順が分かれる箇所は、左右2列に並べています。ご自身の環境の列だけを読んでください。折りたたまれた「＋」の見出しは補足です。詰まっていなければ開かなくて構いません。

04うまくいかないとき

まず SESSION 14 のトラブルシューティングを見てください。つまずきやすい14件を、症状から引ける形でまとめています。それでも解決しない場合は、次の3点を添えて研修事務局までご連絡ください。

• どのセッションのどの手順で止まったか（例: SESSION 09 の手順3）
• 画面に出ているメッセージ（スクリーンショットか、文字をそのままコピーしたもの）
• OS の種類（Windows 10 / Windows 11 / macOS のいずれか）

01通信が許可されているか

本研修のセットアップでは、次のサイトから配布物を取得します。社内ネットワークで外部通信が制限されている場合、この一覧を情報システム部門へ共有し、通信の許可を依頼してください。研修当日も、Claude Code が Amazon Bedrock と通信し続けます。

02PC にソフトを入れられるか

VSCode と JDK 17 をインストールします。会社支給の PC で管理者権限が制限されている場合、インストーラーが途中で止まります。

03事務局から受け取るもの

次の2点は、研修事務局から別途ご案内します。ご自身で用意するものではありません。案内が届いていない場合は事務局へご連絡ください。

01入れるものと使う場面

02想定環境

03Claude Code とはどういう道具か

先に道具の性質を掴んでおくと、設定の意味がわかります。Claude Code は、質問に答えるだけの AI ではありません。「一覧画面に検索欄を足してください」と書くと、自分で関係するファイルを探して読み、変更内容を決め、ファイルを書き換え、必要ならコマンドを実行するところまで進めます。人間は結果を確認して、次の指示を出す側に回ります。

01セットアップの7段階

02研修当日の流れ

準備が済んでいる前提で組んだ時間配分です。環境構築の時間は取っていません。

03指示がどこを通って AI に届くか

SESSION 09 で設定する環境変数が何をしているのかは、経路を見るとわかります。Claude Code は本来 Anthropic のサービスに直接つながりますが、環境変数を1つ立てることで、その接続先を Amazon Bedrock へ切り替えます。

01公式サイトを開く

ブラウザで code.visualstudio.com を開きます。検索エンジンで「VSCode ダウンロード」と調べると、公式ではない配布サイトが上位に出ることがあります。必ずこのアドレスから入手してください。

02Windows 用のインストーラーを選ぶ

ダウンロードページには Windows・macOS・Linux の3つが並びます。左端の Windows の欄にある「Windows」ボタンを押すと、標準のインストーラーがダウンロードされます。

03インストーラーを実行する

1. 1
   ダウンロードしたファイルをダブルクリックします

   ファイル名は VSCodeUserSetup-x64-（バージョン番号）.exe のような形です。ブラウザの下部か、右上のダウンロード一覧から開けます。

2. 2
   使用許諾に同意します

   「同意する」を選んで「次へ」を押します。

3. 3
   インストール先はそのままで進めます

   変更する必要はありません。「次へ」を押し続けます。

4. 4
   追加タスクの画面でチェックを確認します

   「PATH への追加（再起動後に使用可能）」にチェックが入っていることを確認してください。既定で入っています。ここを外すと、あとでターミナルから VSCode を開けなくなります。他の項目は好みで構いません。

5. 5
   「インストール」を押します

   1〜2分で終わります。完了画面で「Visual Studio Code を実行する」にチェックを入れて「完了」を押すと、そのまま起動します。

04起動を確認する

スタートメニューから「Visual Studio Code」を探して起動します。「ようこそ」と書かれたタブが表示されれば成功です。この時点では画面はすべて英語です。日本語化は SESSION 07 で行います。

01Mac 用のファイルを取得する

ブラウザで code.visualstudio.com を開き、ダウンロードページへ進みます（図5）。macOS の欄に表示されるボタンを押します。

02アプリケーションフォルダへ移動する

1. 1
   ダウンロードした ZIP を展開します

   ダブルクリックすると同じ場所に Visual Studio Code.app ができます。Safari の場合、ダウンロード時に自動で展開されていることもあります。

2. 2
   アプリケーションフォルダへドラッグします

   Finder のサイドバーにある「アプリケーション」へドラッグして移動してください。「ダウンロード」フォルダに置いたまま使うと、更新の適用や設定の保存で問題が出ることがあります。

3. 3
   ダブルクリックで起動します

   初回は「インターネットからダウンロードされたアプリケーションです。開いてもよろしいですか」という確認が出ます。「開く」を押してください。

03起動を確認する

「Welcome」タブが表示されれば成功です。この時点では画面はすべて英語です。日本語化は次のセッションで行います。

01方法A　表示言語の設定から切り替える

公式ドキュメントが案内している方法です。こちらを先に試してください。

1. 1
   コマンドパレットを開きます

   Windows は Ctrl+Shift+P、Mac は Cmd+Shift+P です。画面の上部に入力欄が出ます。ここは VSCode のあらゆる操作を名前で呼び出せる場所です。

2. 2
   Configure Display Language と入力します

   途中まで打つと候補に出ます。「Configure Display Language」を選んでください。

3. 3
   「日本語」を選びます

   言語の一覧が出ます。「日本語 (ja)」を選ぶと、まだ入っていない場合は言語パックのインストールが自動で始まります。

4. 4
   再起動します

   「Restart」を押すか、VSCode をいったん閉じて開き直します。再起動しないと表示は変わりません。

02方法B　拡張機能の一覧から入れる

方法A で候補に「日本語」が出てこない場合は、こちらで直接入れます。

1. 1
   拡張機能の一覧を開きます

   左端のアクティビティバーにある、四角が4つ並んだアイコンを押します。キーボードなら Windows は Ctrl+Shift+X、Mac は Cmd+Shift+X です。

2. 2
   検索欄に Japanese Language Pack と入力します

   候補が並びます。発行元が Microsoft のものを選んでください。名前が似た非公式のものが混ざることがあります。

3. 3
   「Install」を押します

   数秒で終わります。完了すると右下に「Change Language and Restart」というボタンが出ます。

4. 4
   「Change Language and Restart」を押します

   VSCode が再起動し、表示が日本語に変わります。ボタンを見逃した場合は、方法A の手順で言語を選び直してください。

03切り替わったか確認する

01拡張機能の一覧から入れる

1. 1
   拡張機能の一覧を開きます

   左端のアクティビティバーで四角が4つ並んだアイコンを押すか、Windows は Ctrl+Shift+X、Mac は Cmd+Shift+X を押します。

2. 2
   検索欄に Claude Code と入力します

   名前に Claude を含む拡張が複数並びます。次の手順で見分けてください。

3. 3
   発行元が Anthropic のものを選びます

   正しいものは、名前が Claude Code for VS Code、発行元が Anthropic です。名前だけで選ぶと、他の開発者が作った別の拡張を入れてしまうことがあります。

4. 4
   「インストール」を押します

   数十秒で終わります。完了すると、左端のアクティビティバーに Claude Code のアイコンが追加されます。

02アイコンの場所を覚える

研修中は、この拡張のパネルを開いたり閉じたりを繰り返します。場所を先に覚えておいてください。

アイコンが見当たらない場合は、SESSION 14 のトラブル 05 に対処を書いています。表示されているアイコンの数が多いと、下部の「…」の中に隠れていることがあります。

01環境変数とは何か

環境変数は、OS に登録しておく名前付きの設定値です。アプリは起動するときにこれを読み取り、自分の動きを変えます。Claude Code の場合、CLAUDE_CODE_USE_BEDROCK という名前の値が 1 になっていると、接続先を Anthropic のサービスから Amazon Bedrock へ切り替えます。残りの3つは、その Bedrock に入るための場所と鍵です（図3 を参照してください）。

02設定する（Windows）

スタートメニューで「PowerShell」と検索し、Windows PowerShell を起動します。次のコマンドを1行ずつ実行してください。setx は、環境変数を次回以降も残る形で登録するコマンドです。

実行する前に、配布された値 の部分を、案内に書かれた実際の値に置き換えてください。引用符（"）は消さずに残します。

setx CLAUDE_CODE_USE_BEDROCK 1
setx AWS_REGION "配布された値"
setx AWS_ACCESS_KEY_ID "配布された値"
setx AWS_SECRET_ACCESS_KEY "配布された値"

1行ごとに 成功: 指定した値は保存されました。 と表示されれば登録できています。

確認方法

いったん PowerShell も閉じて、新しく開き直してから次を実行します。

echo $env:CLAUDE_CODE_USE_BEDROCK
echo $env:AWS_REGION

1行目に 1、2行目に配布された地域の文字列が表示されれば設定できています。何も表示されない場合は、PowerShell を開き直したか確認してください。

03設定する（Mac）

「アプリケーション」から「ユーティリティ」を開き、「ターミナル」を起動します。次のコマンドを実行すると、ターミナルを開くたびに読み込まれる設定ファイル（~/.zshrc）に4行を追記します。

この操作はコピーして貼り付け、まとめて実行して構いません。ただし 配布された値 は先に書き換えておいてください。

cat >> ~/.zshrc << 'EOF'
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="配布された値"
export AWS_ACCESS_KEY_ID="配布された値"
export AWS_SECRET_ACCESS_KEY="配布された値"
EOF

確認方法

ターミナルも新しく開き直してから次を実行します。

echo $CLAUDE_CODE_USE_BEDROCK
echo $AWS_REGION

1行目に 1、2行目に配布された地域の文字列が表示されれば設定できています。

04設定時によくある取りこぼし

01先に、入っているか確認する

PC によっては、別の研修や業務ですでに Java が入っていることがあります。先に確認してください。すでに 17 が入っていれば、このセッションは飛ばせます。

java -version

java -version

出力の1行目が openjdk version "17. のように 17 から始まっていれば、そのまま使えます。次の SESSION 11 へ進んでください。

02Temurin の JDK 17 を入れる

ブラウザで adoptium.net の Temurin リリース一覧 を開きます。上部のタブで JDK 17 - LTS が選ばれていることを確認してください。LTS は長期サポート版という意味で、企業で広く使われている版です。

下へたどると、OS ごとの区画が現れます。ご自身の OS の区画から、次のファイルを選んでください。左側の JDK / JRE の切り替えは JDK のままにします。JRE は実行専用で、ビルドができません。

03入ったか確認する

インストールが終わったら、ターミナル（PowerShell）をいったん閉じて開き直してから、もう一度実行します。開いたままだと、古い状態のままで動くため反映されません。

java -version

次のような出力になれば成功です。バージョンの細かい数字は時期によって変わります。

openjdk version "17.0.20" 2026-07-15
OpenJDK Runtime Environment Temurin-17.0.20+8 (build 17.0.20+8)
OpenJDK 64-Bit Server VM Temurin-17.0.20+8 (build 17.0.20+8, mixed mode)

01展開する場所を決める

次の2つを満たす場所に展開してください。

迷ったら、次の場所をそのまま使ってください。

# Windows
C:\training\

# Mac
/Users/ユーザー名/training/

02展開する

03展開後の構造と、VSCode で開く場所

展開すると genai-nyumon-handson というフォルダができ、その中に はじめにお読みください.txt、資料 フォルダ、handson フォルダの3つが入っています。VSCode で開くのは、この handson フォルダです。研修中も、最初から最後までここを開いたままにします。資料 フォルダには本ガイドと手元ガイド共通編の PDF が入っているので、当日は印刷版としても使えます。

1. 1
   VSCode を起動します
2. 2
   「ファイル」から「フォルダーを開く」を選びます

   Mac では「フォルダを開く」と表示されます。

3. 3
   handson フォルダを選んで開きます

   フォルダの中に入った状態で「フォルダーの選択」を押してください。ひとつ上の階層を選ばないよう注意してください。

4. 4
   「このフォルダー内のファイルの作成者を信頼しますか」に答えます

   「はい、作成者を信頼します」を選んでください。「いいえ」を選ぶと制限モードになり、Claude Code がファイルを書き換えられません。

01Claude Code が応答するか

1. 1
   handson フォルダを開いた VSCode で、アクティビティバーの Claude Code アイコンを押します

   右側または下側にパネルが開き、文字を入力する欄が現れます。

2. 2
   入力欄に次のとおり打って送信します

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

3. 3
   応答を待ちます

   数秒で「こんにちは」を含む返事が返ってきます。初回はやや時間がかかることがあります。ファイルは何も変更されません。

02Java のアプリがビルドできるか

課題B のアプリは、動かす前に必要なライブラリをインターネットから取得します。この取得が初回だけ数分から十数分かかります。当日この時間を使うと演習が終わらないため、前日までに1回だけ済ませてください。2回目以降は手元に残ったものを使うため、数十秒で終わります。

1. 1
   VSCode のメニューから「表示」を開き、「ターミナル」を選びます

   画面の下部にターミナルが開きます。開いている場所は handson フォルダです。

2. 2
   課題B のフォルダへ移動し、ビルドを実行します

   ご自身の OS に合わせて、次のとおり入力してください。

cd kadaiB
.\mvnw.cmd -q -DskipTests package

cd kadaiB
./mvnw -q -DskipTests package

実行すると、ダウンロードの進捗が大量に流れます。止まっているように見えても待ってください。最後に BUILD SUCCESS と表示されれば成功です。-DskipTests はテストを飛ばす指定で、ここでは依存ライブラリの取得だけが目的です。

01当日の持ち物

02本ガイドで参照した公式ドキュメント

03用語のおさらい

本ガイドに出てきた言葉のうち、当日も繰り返し使うものをまとめます。