事前セットアップ

Windows の中で Linux を動かす仕組みです。すでに入っている方は、確認だけして Step 2 へ進んでください。

スタートメニューで cmd と入力し、出てきた「コマンド プロンプト」を右クリックして「管理者として実行」を選びます。

wsl --install

終わったら PC を再起動してください。再起動しないと次のステップが動きません。

wsl --version

次のような表示が返れば入っています。

WSL version: 2.x.x.x
Kernel version: 5.15.x.x-microsoft-standard-WSL2
Windows version: 10.0.x.x

WSL の上で動かす Linux の中身です。バージョンは 22.04 に揃えてください。

wsl.exe --install Ubuntu-22.04

途中でユーザー名とパスワードを聞かれます。ユーザー名は英小文字と数字だけにしてください。ここで決めたパスワードは、あとで sudo を打つたびに使います。忘れないよう控えておいてください。

設定が終わると、そのままプロンプトが Ubuntu のものに変わります。以降の作業はここで行います。

# どこで動いているかを確認する
uname -a

Linux <hostname> 5.15.x.x-microsoft-standard-WSL2 #1 SMP ... x86_64 GNU/Linux

# パッケージを最新にする（数分かかります）
sudo apt update
sudo apt upgrade -y

Java を動かすための実行環境です。研修の題材は Java 17 で動きます。

sudo apt install -y openjdk-17-jdk curl wget unzip jq

JDK のほかに4つ入れています。curl は Step 5 の Claude Code 導入、wget は Step 4 の Maven 取得、unzip は Step 8 の配布データ展開、jq は Day3 で API の応答を読むときに使います。すでに入っているものは飛ばされるので、そのまま実行してください。

# JAVA_HOME を設定して、次回以降も有効にする
echo 'export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java))))' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 確認する
java -version
echo $JAVA_HOME

Java プロジェクトをビルドして、テストを走らせる道具です。

apt で入る Maven は 3.6 系で古いため、公式サイトから 3.9.15 を直接取ってきます。

# ホームディレクトリで作業する
cd ~
MVN_VERSION=3.9.15
wget https://archive.apache.org/dist/maven/maven-3/${MVN_VERSION}/binaries/apache-maven-${MVN_VERSION}-bin.tar.gz

# 展開して /opt/maven に置き、書庫は消す
MVN_VERSION=3.9.15
tar -xzf apache-maven-${MVN_VERSION}-bin.tar.gz
sudo mv apache-maven-${MVN_VERSION} /opt/maven
rm apache-maven-${MVN_VERSION}-bin.tar.gz

# パスを通して、次回以降も有効にする
echo 'export M2_HOME=/opt/maven' >> ~/.bashrc
echo 'export PATH=$M2_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 確認する
mvn -v

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

curl -fsSL https://claude.ai/install.sh | bash

# 置き場所にパスを通して、次回以降も有効にする
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 確認する
claude --version

2.1.234 (Claude Code) のようにバージョンが返ります。数字は導入した時期で変わります。

続けてログインします。初回だけ必要です。

claude

1. ブラウザが開くので、ご案内したアカウントでログインします
2. ブラウザが開かないときは、ターミナルに URL が表示されます。それをコピーして Windows のブラウザに貼り付けてください
3. ターミナルに戻り、入力欄が出ていることを確認します
4. /exit と打って、いったん終了します

Ubuntu の初期状態は、日本語を扱えない文字コードになっていることがあります。このまま進めると Day2 と Day3 の演習で、日本語が ? に化けて期待どおりの結果が出ません。

locale

最初の行が LANG= のあとに何もない、または UTF-8 で終わっていない場合は、次を実行してください。

echo 'export LANG=C.UTF-8' >> ~/.bashrc
source ~/.bashrc

# 設定できたかを確認する
locale charmap

コードを書くエディタです。本体は Windows 側に入れて、拡張機能で Ubuntu につなぎます。

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

起動したら Ctrl+Shift+X で拡張機能の一覧を開き、次の3本を検索して入れます。ID で検索すると確実です。

入れ終わったら、VSCode の左下にある >< のアイコンをクリックして、「Connect to WSL」を選びます。初回は VSCode Server のダウンロードが自動で走るので、数分かかります。

研修で手を動かすプロジェクト一式を置いて、ここまでの7つがつながっているかをまとめて確かめます。

教材トップの「配布データ」から id-cc-handson_20260903.zip をダウンロードします。保存先は既定の「ダウンロード」フォルダのままで構いません。

# Windows 側のダウンロードフォルダから持ってくる
cd ~
cp /mnt/c/Users/*/Downloads/id-cc-handson_20260903.zip ~/
unzip id-cc-handson_20260903.zip
rm id-cc-handson_20260903.zip

~/handson ができます。ZIP の中身が handson フォルダから始まるので、展開先を指定する必要はありません。

# 中身を確認する
cd ~/handson
ls

src、docs、exercises、CLAUDE.md が並んでいれば展開できています。

ここから動作確認です。上から順に打ってください。

# ビルドが通るかを確認する（初回は依存関係の取得で数分かかります）
mvn clean compile

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

# アプリを起動する
mvn spring-boot:run

Started OrderApplication という行が出たら起動しています。Windows のブラウザで http://localhost:8080/api/orders を開いてください。次のように、受注データが1かたまりの文字列で表示されます。

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

最後に、VSCode から同じフォルダを開けることを確かめます。VSCode で WSL: Ubuntu-22.04 につないだ状態で「ファイル」から「フォルダーを開く」を選び、/home/<ユーザー名>/handson を指定してください。