事前セットアップ

コードを書くエディタです。すでに入っている方は Step 2 へ進んでください。

1. code.visualstudio.com を開き、Windows 版をダウンロードします
2. ダウンロードしたインストーラを実行します。設定はすべて既定のままで構いません
3. 途中の「追加タスクの選択」で、PATH への追加 にチェックが入っていることを確認します

Java を動かすための実行環境です。研修の題材は Java 17 で動きます。すでに 17 系が入っている方は Step 3 へ進んでください。

1. adoptium.net を開きます
2. Version は 17 - LTS、Operating System は Windows、Architecture は x64 を選びます
3. .msi のインストーラをダウンロードして実行します
4. インストール中の「カスタムセットアップ」で、Set JAVA_HOME variable と Add to PATH を有効にします。既定では無効になっている項目があるので、ここだけ確認してください

入ったかどうかは、次のステップで一緒に確かめます。

ターミナルで動く AI のコーディング支援ツールです。研修の主役になります。

1. スタートメニューで PowerShell と入力して起動します。管理者として実行する必要はありません
2. 次の1行を貼り付けて Enter を押します

irm https://claude.ai/install.ps1 | iex

インストールが終わるまで待ちます。完了したら、PowerShell をいったん閉じて開き直してください。

初回だけログインが必要です。

1. PowerShell で claude と打って Enter を押します
2. ブラウザが開くので、ご案内したアカウントでログインします
3. ターミナルに戻り、入力欄が出ていることを確認します
4. /exit と打って、いったん終了します

研修で手を動かすプロジェクト一式です。

1. 教材トップの「配布データ」から id-cc-handson_20260903.zip をダウンロードします
2. ダウンロードした ZIP を右クリックして「すべて展開」を選びます
3. 展開先を C:\handson に指定します。深い階層に置くとパスが長くなり、後で困ることがあります
4. 展開してできた handson フォルダを、VSCode の「ファイル」から「フォルダーを開く」で開きます

ここまでの5つがつながっているかを、まとめて確かめます。VSCode で handson フォルダを開いた状態で、Ctrl+@ を押してターミナルを出してください。ターミナルの現在地が handson になっていることを確認してから、次を順に打ちます。

# Java のバージョンを確認する
java -version

openjdk version "17. で始まる行が返れば大丈夫です。17 以外が返る場合は Step 2 をやり直してください。

# ビルドツールが動くかを確認する
.\mvnw.cmd -v

Apache Maven のバージョンと、Java version が 17 であることが表示されます。

# コンパイルが通るかを確認する（初回は依存関係の取得で数分かかります）
.\mvnw.cmd clean compile

最後に BUILD SUCCESS と出れば通っています。

# アプリを起動する
.\mvnw.cmd spring-boot:run

Started OrderApplication という行が出たら起動しています。ブラウザで http://localhost:8080/api/orders を開くと、受注データが文字列で表示されます。読みにくくて構いません。研修の初日に、これを読める画面に変えます。

確認できたら、ターミナルで Ctrl+C を押してアプリを止めてください。