事前セットアップガイド

研修でClaude Codeを動かすのは、Windowsの中のUbuntuです。貴社の全社手順で入っているはずなので、ここでは確かめるだけです。

Windowsのコマンドプロンプト

スタートメニューでcmdと入れてコマンド プロンプトを開き、次を打ちます。

wsl --list --verbose

Ubuntu-22.04の行のVERSIONが2なら入っています。行が無いときは、貴社の全社手順のWSL2とUbuntuの導入に戻ってください。

Ubuntuのターミナル

スタートメニューでUbuntuと入れて開きます。プロンプトがユーザー名@ホスト名:~$の形ならUbuntuの中です。続けて次を打ちます。

lsb_release -d
sudo apt update

Ubuntu 22.04で始まる行が出ます。sudoのパスワードは、Ubuntuを入れたときに決めたものです。

• wsl --list --verboseでUbuntu-22.04のVERSIONが2
• lsb_release -dにUbuntu 22.04と出る

Day2の配布フォルダは、勤怠・工数管理システムKINTAIのJavaのプロジェクトです。演習はClaude Codeの振る舞いを見比べるので、ビルドは発展課題でだけ使います。全社手順で入っているので、確かめるだけです。

java -version
mvn -v

openjdk version "17.で始まる行と、Apache Maven 3.9.15の行が出れば入っています。

• java -versionが17系を返す
• mvn -vが3.9.15を返す

配布ZIPはUbuntuの中でunzipを使って展開します。全社手順にはunzipが入っていません。python3はUbuntuに最初から入っていて、演習で作る画面をブラウザに配るときと、Day2とDay3のHooksで使います。

sudo apt install -y unzip
unzip -v | head -1
python3 --version

UnZip 6.00で始まる行と、Python 3.10で始まる行が出れば済みです。すでに入っている場合、aptは何も変えずに終わります。

• unzip -vがUnZip 6.00を返す
• python3 --versionが3.10系を返す

全社手順には無い設定で、必ず行ってください。Ubuntuの初期状態のままだと、文字コードがUTF-8になっていないことがあります。そのまま進めると、日本語のファイル名や、Claude Codeが書いた日本語が?に化けます。

locale charmap

UTF-8と返れば、何もしなくて構いません。Step 5へ進んでください。ANSI_X3.4-1968など別の値が返ったら、次の3行を打ちます。

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

最後の行でUTF-8と返れば設定できています。

• locale charmapがUTF-8を返す

研修の主役になる道具です。Claude Codeは全社手順で入っていますが、使うには研修用の組織のアカウントでのログインが要ります。

研修事務局から、研修用の組織への招待のメールが届きます。招待を承認したアカウントでログインしてください。無料のClaude.aiのプランではClaude Codeを使えません。招待が届いていない場合は、セットアップを始める前に研修事務局へお問い合わせください。

claude --version

2.1.300 (Claude Code)のようにバージョンが返ります。数字は導入した時期で変わります。command not foundのときは、全社手順のClaude Codeの節に戻ってください。

続けてログインします。

claude

• 最初に文字の色の選択（Choose the text style）が出たら、Enterで既定のまま進めます。
• ログインの方法を聞かれたら、Claude account with subscriptionを選びます。
• ブラウザが開いたら、招待を承認したアカウントでログインし、Claude Codeからのアクセスを許可します。WSLではブラウザが開かないことがあります。そのときは、ターミナルに出るURLをコピーしてWindowsのブラウザに貼ってください。
• 許可のあとにブラウザにコードが出たら、コピーしてターミナルに貼り、Enterを押します。
• フォルダを信頼するかを聞かれたら、↓キーでYes, I trust this folderを選んでEnterを押します。最初はNoの側が選ばれています。
• ターミナルに戻り、入力欄が出ていれば済みです。
• /exitと打って、いったん終了します。

• もう一度claudeを起動したとき、ログインを求められずに入力欄が出る

研修では、WindowsのVS CodeをUbuntuにつなぎ、VS Codeの中のターミナルでClaude Codeを動かします。ファイルの中身やClaude Codeの変更は、VS Codeの画面で読みます。VS Codeと拡張機能は全社手順で入っているので、ここではつながるかの確認だけです。

• WindowsでVS Codeを起動します。
• 左下の><のアイコンを押し、Connect to WSLを選びます。日本語の表示ではWSLへの接続です。
• 初回はVS Code Serverのダウンロードが自動で始まり、数分かかります。
• 左下にWSL: Ubuntu-22.04と出たら、つながっています。
• ターミナル → 新しいターミナルで、画面の下にターミナルが開きます。研修では、ここでclaudeを起動します。

• VS Codeの左下にWSL: Ubuntu-22.04と出る
• VS Codeのターミナルのプロンプトがユーザー名@ホスト名の形

Day1の演習で使う配布フォルダを置き、ここまでの6つがつながっているかをまとめて確かめます。当日の演習でも、同じ手順で作った画面をブラウザで開きます。

Windowsのブラウザ

教材サイトのトップのDay1の欄からidcc-day1_20261110.zipをダウンロードします。保存先は既定のダウンロードのままで構いません。

Ubuntuのターミナル

cd ~
cp /mnt/c/Users/*/Downloads/idcc-day1_20261110.zip ~/
unzip -o idcc-day1_20261110.zip
rm idcc-day1_20261110.zip
ls ~/idcc-day1

~/idcc-day1ができ、index.html、data、はじめにお読みください.mdが並べば展開できています。ZIPの中身がidcc-day1のフォルダから始まるので、展開先は指定しません。

続けて、お題カードをブラウザに配ります。

cd ~/idcc-day1
python3 -m http.server 8000

Serving HTTP on 0.0.0.0 port 8000と出たら、Windowsのブラウザで次のURLを開きます。

http://localhost:8000/

「このページがブラウザに出ていれば、事前セットアップの確認は完了です。」と書かれたお題カードが出れば成功です。確かめたら、ターミナルでCtrl+Cを押して止めます。

VS Code

WSLにつないだVS Codeでファイル → フォルダーを開くを選び、/home/ユーザー名/idcc-day1を開きます。左のエクスプローラーにdataとindex.htmlが見えれば済みです。

• ~/idcc-day1でpython3 -m http.server 8000を動かし、Windowsのブラウザでhttp://localhost:8000/のお題カードが開く
• VS Codeで~/idcc-day1を開ける

• VS CodeがWSLにつながり、~/idcc-day1を開ける（Step 6）
• claudeを起動すると、ログイン済みの状態で入力欄が出る（Step 5）
• locale charmapがUTF-8を返す（Step 4）
• ~/idcc-day1でpython3 -m http.server 8000を動かし、Windowsのブラウザでhttp://localhost:8000/のお題カードが開く（Step 7）
• java -versionが17系、mvn -vが3.9.15を返す（Step 2）

研修では、研修用の組織の利用枠を全員で使います。研修の演習は、応答を短くさせる設定と、同時に動かすAIを1体までに絞った手順で作ってあります。研修の時間の外で長く使い続けることは控えてください。

事前セットアップで行うのは、Step 5のログインの確認までです。ログインできたら、Claudeに作業を頼まずに/exitで終了して構いません。利用量の見方は、Day1の最初に講師が見せます。