事前セットアップガイド

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

02所要時間の目安

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

03各セッションの読み方

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

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

04うまくいかないとき

まず SESSION 14 のトラブルシューティングを見てください。つまずきやすい18件を、症状から引ける形でまとめています。それでも解決しない場合は、次の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 のサービスに直接つながりますが、環境変数を立てることで、その接続先を Amazon Bedrock へ切り替えます。入口を通る資格のほうは、AWS CLI で行う SSO のサインインが受け取ります。

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 で行います。

起動直後の画面は大きく3つに分かれています。本ガイドと当日の説明では、この名前で場所を指します。

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アイコンの場所を覚える

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

アイコンは、画面いちばん左のアクティビティバーに追加されます。もとから並んでいるアイコン（ファイル、検索、ソース管理など）の下に足されるため、列の下のほうを探してください。中心から放射状に線が伸びた印が目印です。押すと画面の右側または下側にパネルが開き、いちばん下に文字を入力する欄が現れます。もう一度押すと閉じます。

アイコンが見当たらないときは、VSCode をいったん完全に終了してから開き直してください。インストール直後は表示が追いついていないことがあります。

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

01このセッションで行うこと

Claude Code は、AWS の標準的な認証の仕組みをそのまま使います。本研修では、AWS の SSO（IAM Identity Center のシングルサインオン）でサインインし、そこで受け取った一時的な通行証を Claude Code に使わせます。アクセスキーの文字列を PC に貼り付けて持ち続ける必要はありません。

その通行証を受け取る役目を担うのが AWS CLI です。ターミナルから AWS を操作するための公式ツールで、サインインの窓口もこれが受け持ちます。以下の順に進めます。

02AWS CLI を入れる（Windows）

Mac をお使いの方は手順03 へ進んでください。すでに AWS CLI が入っている方は、この手順を飛ばして手順04 へ進んで構いません。バージョンが 1 系の場合は、下のインストーラーを実行すると 2 系に置き換わります。

1. 1
   公式のインストーラーをダウンロードします

   ブラウザで https://awscli.amazonaws.com/AWSCLIV2.msi を開くと、そのままダウンロードが始まります。これは AWS の公式配布元です。導入手順の説明は 公式ドキュメント にあります。

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

   ファイル名は AWSCLIV2.msi です。ブラウザの下部か、右上のダウンロード一覧から開けます。

3. 3
   画面の指示どおりに進めます

   使用許諾に同意し、インストール先はそのままで「Next」を押し続けます。最後に「Install」を押すと1分ほどで終わります。

4. 4
   PowerShell を開き直して、入ったことを確認します

   すでに開いている PowerShell には反映されません。いったん閉じて、新しく開いてから次を実行してください。

   aws --version

次のような形で、バージョンが1行返れば入っています。数字はダウンロードした時期によって変わります。

aws-cli/2.x.x Python/3.x.x Windows/10 exe/AMD64

03AWS CLI を入れる（Mac）

Windows をお使いの方は手順02 をご覧ください。Mac では、公式の PKG インストーラーを使います。Apple Silicon と Intel のどちらでも、同じファイルで入ります。

1. 1
   公式のインストーラーをダウンロードします

   ブラウザで https://awscli.amazonaws.com/AWSCLIV2.pkg を開くと、そのままダウンロードが始まります。

2. 2
   ダウンロードした AWSCLIV2.pkg をダブルクリックします

   インストーラーが開きます。「続ける」を押して進めます。

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

   Mac のログインパスワードを求められます。会社支給の PC で管理者権限がない場合は、この時点で止まります。情報システム部門へご相談ください。

4. 4
   ターミナルを開き直して、入ったことを確認します

   「アプリケーション」から「ユーティリティ」を開き、「ターミナル」を起動して次を実行します。

   aws --version

次のような形で、バージョンが1行返れば入っています。数字はダウンロードした時期によって変わります。

aws-cli/2.x.x Python/3.x.x Darwin/23.x.x source/arm64

04SSO のプロファイルを作る

ターミナル（Windows は PowerShell）で次を実行します。対話形式で順番に質問されるため、案内に書かれた値を入力していきます。

aws configure sso

聞かれる項目と、入力するものは次のとおりです。値はすべて研修事務局が指定します。案内に記載のない項目は、何も入力せずに Enter を押して既定のまま進めてください。

途中でブラウザが自動的に開き、サインイン画面が表示されます。案内された ID でサインインし、画面に表示された確認コードがターミナルの表示と一致することを確かめてから「Allow access」を押してください。そのあとターミナルに戻ると、使えるアカウントとロールの一覧が出ます。案内に書かれたものを矢印キーで選び、Enter を押します。

実行すると、ターミナルには次のような順で文字が出ます。[ ] や [None] は既定値の表示です。ご自身の画面と見比べる目安にしてください。AWS CLI のバージョンによって、文言が多少異なることがあります。

SSO session name (Recommended): 事務局が指定する名前
SSO start URL [None]: 事務局が指定するアドレス
SSO region [None]: 事務局が指定する地域
SSO registration scopes [sso:account:access]: （何も入力せず Enter）

Attempting to automatically open the SSO authorization page in your default browser.
If the browser does not open or you wish to use a different device to authorize
this request, open the following URL:

（ここにアドレスが表示されます）

Then enter the code:

（ここに8文字の確認コードが表示されます）

ブラウザでの承認が終わってターミナルに戻ると、続きの質問が出ます。使えるアカウントとロールが1つだけの場合は、選ぶ画面が出ずに自動で決まります。

CLI default client Region [None]: 事務局が指定する地域
CLI default output format [None]: （何も入力せず Enter）
CLI profile name [xxxxxxxx]: 事務局が指定するプロファイル名

To use this profile, specify the profile name using --profile, as shown:

aws s3 ls --profile プロファイル名

05サインインする

プロファイルを作った直後はサインイン済みです。ここで行うのは、日をまたいだあとや、あとから入り直すときの手順です。研修当日の朝にも一度実行してください。

プロファイル名 の部分を、案内に書かれた実際の名前に置き換えてから実行します。

aws sso login --profile プロファイル名

1. 1
   ブラウザが開き、確認コードが表示されます

   ターミナルにも同じコードが出ます。両方が一致していることを確かめてください。一致しない場合は、そのまま進めずに閉じてもう一度実行します。

2. 2
   「Confirm and continue」を押し、次の画面で「Allow access」を押します

   案内された ID でのサインインを求められた場合は、先にサインインします。

3. 3
   ブラウザを閉じて、ターミナルに戻ります

   ターミナルに Successfully logged into Start URL と表示されていれば完了です。以降の操作はターミナルと VSCode で行います。

ターミナルの表示は次のような形です。確認コードは実行のたびに変わります。

Attempting to automatically open the SSO authorization page in your default browser.
If the browser does not open or you wish to use a different device to authorize
this request, open the following URL:

（ここにアドレスが表示されます）

Then enter the code:

（ここに8文字の確認コードが表示されます）

Successfully logged into Start URL: （事務局が指定したアドレス）

06設定ファイル（settings.json）を置く

接続先、使うモデル、サインインの方法は settings.json という1つのファイルにまとめます。Claude Code は起動するときにこのファイルを読み、書かれたとおりに動きます。研修事務局が用意した内容をそのまま貼り付けてください。中身を変える必要はありません。

置き場所

.claude は先頭にピリオドが付いたフォルダです。まだ無い場合は、次の手順の中で作ります。

作る（Windows）

スタートメニューで「PowerShell」と検索し、Windows PowerShell を起動して、次を1行ずつ実行します。1行目でフォルダを作り、2行目で空のファイルを VSCode で開きます。

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"
code "$env:USERPROFILE\.claude\settings.json"

作る（Mac）

「アプリケーション」から「ユーティリティ」を開き、「ターミナル」を起動して、次を1行ずつ実行します。

mkdir -p ~/.claude
code ~/.claude/settings.json

貼り付ける中身

開いたファイルに、次の内容をそのまま貼り付けて保存します。すでに何か書かれている場合は、すべて消してから貼り付けてください。書き換える箇所はありません。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "awsAuthRefresh": "aws sso login --profile aidd-prd-br",
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: orao5i9up2jb\nX-Amzn-Bedrock-GuardrailVersion: 1",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "us.anthropic.claude-fable-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "us.anthropic.claude-haiku-4-5-20251001-v1:0",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "us.anthropic.claude-opus-5[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "us.anthropic.claude-sonnet-5[1m]",
    "AWS_PROFILE": "aidd-prd-br",
    "AWS_REGION": "us-east-1",
    "CLAUDE_CODE_USE_BEDROCK": "1"
  },
  "model": "sonnet",
  "language": "japanese",
  "effortLevel": "high"
}

それぞれの項目が何をしているか

当日の説明で触れるため、いまは目を通すだけで構いません。

確認方法

ファイルが正しい形式で書けているかは、ターミナル（Windows は PowerShell）で次を実行すると確かめられます。中身がそのまま表示されれば、形式として問題ありません。エラーが出る場合は、貼り付けが途中で欠けています。

Get-Content "$env:USERPROFILE\.claude\settings.json" | ConvertFrom-Json

cat ~/.claude/settings.json | python3 -m json.tool

接続まで含めた確認は SESSION 12 で行います。ここではファイルが置けていれば先へ進んで構いません。

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

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
   入力欄に /status と打って送信します

   いまの接続の状態が一覧で表示されます。provider の行に Amazon Bedrock と出ていれば、SESSION 09 の設定が届いています。別の表示になっている場合は、先に SESSION 09 の手順06 を見直してください。

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

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

4. 4
   応答を待ちます

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

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用語のおさらい

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