事前準備ガイド

上流工程 要件定義・設計 生成AI活用研修 株式会社インフォメーション・ディベロプメント様向け

期限 10月7日(水)まで 所要 [22min]前後 Day1 2026年10月8日(木)
事前準備の分担

貴社の手順書

ツールを導入する

Claudeデスクトップアプリ、Git、Python、Node.js、LibreOfficeを入れます。

このガイド

置いて、読ませて、確かめる

配布フォルダをデスクトップに置き、Claudeに読み込ませ、環境チェックで確かめます。

当日の演習の途中で変換ツールが動かなかったり、ファイルが開けなかったりすると、その演習をそこから先へ進められません。3回の研修は前の回の成果物を次の回で使うので、1回の遅れがあとまで響きます。導入が済んだら、このガイドの6つのStepで、当日と同じ操作が通ることを先に確かめておいてください。

10月7日(水)までに済ませてください。Step 4 の環境チェックでNGが残った方は、どの行がNGだったかを、貴社の研修ご担当者を通じてお知らせください。

Step 1 導入するものの確認

STEP 1 表の6項目がパソコンにそろっている [3min]
なぜ要るか

下の図のように、ツールを入れるのは貴社の手順書、入ったあとの置き場所と確かめはこのガイドの受け持ちです。

研修では、Claudeデスクトップアプリに頼んで、Markdownの文書をWord、Excel、PowerPointに変換し、LibreOfficeで開いて確かめます。1つでも欠けると、その演習の途中で止まります。導入の手順は貴社の手順書にあるので、ここでは何がそろっていればよいかだけを確かめてください。

事前準備の全体の流れ。ツールの導入は貴社の手順書で行い、そのあと Step 1〜6 を受講者の方が進めます
図1:事前準備の全体の流れ。ツールの導入は貴社の手順書で行い、そのあとStep 1〜6を受講者の方が進めます
手順
項目版研修での使い道どこで確かめるか
ClaudeデスクトップアプリWindows x64の最新版Codeタブで演習をします。貴社から案内されたアカウントでサインインしておきますStep 3
Git for Windows最新版Codeタブを使うために要ります。研修でGitの操作はしませんStep 4
Python3.12系。python-docx、openpyxl、python-pptxを含む変換ツールと環境チェックをClaudeが動かしますStep 4
Node.js22 系のLTS受講者が直接使うことはありませんStep 4
LibreOffice最新の安定版作ったWord、Excel、PowerPointを開いて確かめますStep 5
ブラウザChromeまたはEdge現行画面と、演習で作るモックを開きますStep 6
  • Windowsの設定 → アプリ → インストールされているアプリを開きます。
  • 表の6項目が一覧にあるかを、名前で検索して確かめてください。Pythonは「Python 3.12」、Gitは「Git」と出ます。Pythonのライブラリ3つは一覧に出ないので、Step 4の環境チェックで確かめます。
  • 足りないものがあれば、貴社の手順書に従って導入します。
  • Claudeデスクトップアプリを起動し、貴社から案内されたアカウントでサインインします。

使わないもの

次のものは研修で使いません。入っていなくても構いませんし、入っていても開きません。

もの扱い
JDK、MavenJavaのコードを書いたり動かしたりする場面はありません
TomcatなどのWebサーバ現行画面とモックは、HTMLをダブルクリックで開きます
VS Code、WSL、ターミナル操作はすべてClaudeデスクトップアプリのCodeタブで行います
Microsoft OfficeWord、Excel、PowerPointの形式のファイルはLibreOfficeで開きます
PowerShell 7系Windowsに最初から入っている5系のままで構いません
確認
  • 表の6項目が、インストールされているアプリの一覧にある。PythonのライブラリはStep 4で確かめる
  • Claudeデスクトップアプリにサインインできる

Step 2 配布フォルダの展開

STEP 2 エクスプローラーのアドレス欄がC:\Users\<名前>\Desktop\idup-handsonになっている [7min]
なぜ要るか

演習で読むヒアリングメモ、データ、テンプレート、変換ツールは、すべて配布フォルダに入っています。Claudeはこのフォルダの中のファイルを読み、作ったファイルもこの中の成果物/に置きます。使うフォルダは、3回ともこの配布フォルダです。

手順
  • 上のボタンからidup-handson_20261008.zipをダウンロードします。
  • エクスプローラーでダウンロードを開き、ZIPを右クリック → すべて展開を選びます。
  • 展開先の欄をC:\Users\<名前>\Desktopに書き換えます。<名前>はサインインしているWindowsのユーザー名です。参照でデスクトップを選んでも同じです。
  • 展開を押すと、デスクトップにidup-handsonフォルダができます。
  • idup-handsonを開き、アドレス欄の何もないところをクリックします。表示がパスの文字に変わるので、それを読みます。
  • エクスプローラーの表示 → 表示 → ファイル名拡張子に印を付けます。成果物/に同じ名前の.mdと.docxが並んだときに、見分けられるようにするためです。
ZIP の展開の流れ。右クリックのメニューの[すべて展開]を選び、展開先をデスクトップに書き換えます
図2:ZIPの展開の流れ。右クリックのメニューのすべて展開を選び、展開先をデスクトップに書き換えます

配布フォルダの中身

展開したフォルダの中は、下の図の形になっています。演習で読むものは資料/、作ったものは成果物/に入ります。

配布フォルダ idup-handson の中身
図3:配布フォルダidup-handsonの中身
フォルダ中身
資料/day1/資料/day2/資料/day3/ヒアリングメモ、改修依頼書、レビュー対象の画面設計書。各回の演習で読みます
資料/データ/9月の勤怠工数CSV、マスタ、予定工数表、問い合わせ履歴、売上実績表
資料/データ/過去分/7月と8月の勤怠工数CSV
資料/データ/請求回収/6月からの請求一覧と入金明細
資料/参考/現行のテーブル定義書、CSV出力仕様書、月次締め運用手順書、入力チェックの書き分け、用語集
資料/記入例/会議室予約システムという別の題材で書いた、要件一覧、要件定義書、画面設計書、レビュー記録の記入例
資料/発展/早く終わった方が発展課題で使う資料。ファイル名は演習番号で始まります
現行画面/KINTAIの現行画面のモック。ブラウザで開きます
テンプレート/tools/成果物の雛形6本と、Word・Excel・PowerPointへの変換ツール
成果物/作ったファイルを置く場所。day1、day2、day3のフォルダと、合流版を展開する場所の 合流用 があります
.claude/Claudeの設定です。開いたり消したりしません

資料/の中は読むだけで、書き換えません。資料/は.claude/settings.jsonの設定で、Claudeのファイル編集とコマンドからの書き込みを止めてあります。pythonのスクリプトは止められないので、コマンドを読んで、資料/に書き込む内容のときは拒否します。

OneDriveのデスクトップとの見分け方

会社のパソコンでは、デスクトップがOneDriveと同期されていることがあります。見た目は同じデスクトップでも、置かれている場所が違います。決め手は、アドレス欄のパスにOneDriveの文字が入っているかどうかです。入っていたら置き直します。

アドレス欄の表示場所扱い
C:\Users\<名前>\Desktop\idup-handson個人のデスクトップこのまま進めます
C:\Users\<名前>\OneDrive\Desktop\idup-handsonOneDriveと同期したデスクトップ置き直します
C:\Users\<名前>\OneDrive - 会社名\Desktop\idup-handson会社のアカウントのOneDriveと同期したデスクトップ置き直します

OneDriveの中に置くと、Claudeがファイルを書き換えるたびに同期が走ります。同期の途中のファイルを読んだり、競合したコピーができたりして、演習の途中でファイルが食い違うことがあります。

デスクトップがOneDriveにしかない場合は、展開先をC:\Users\<名前>にして、C:\Users\<名前>\idup-handsonに置いてください。OneDriveの外なら、別の場所でも構いません。

展開先をC:\Users\<名前>\Desktopにしたのに、画面のデスクトップにidup-handsonが出てこないことがあります。画面に見えているデスクトップがOneDrive側のときです。展開のあとに開いたウィンドウのアドレス欄が正しい場所なので、そのまま進め、Step 3ではそのフォルダを選びます。

置き場所の見分け方。アドレス欄のパスに OneDrive の文字が入っていたら、OneDrive の外へ置き直します
図4:置き場所の見分け方。アドレス欄のパスにOneDriveの文字が入っていたら、OneDriveの外へ置き直します
Tipsエクスプローラーでは、ZIPを展開しなくても中を開いて見られます。その状態ではClaudeがファイルを読み書きできないので、必ずすべて展開をしてください。
Tips開いたフォルダの中にもう1つidup-handsonがある二重の状態になったら、内側のidup-handsonをデスクトップへ移し、外側の空のフォルダは消して構いません。

メモ帳での.mdの表示

研修では、ヒアリングメモなどの.mdのファイルをメモ帳で読みます。Windows 11のメモ帳は、.mdを書式付きの表示で開くことがあります。書式付きのままだと空行が行数に入らないので、下の帯の行番号がファイルの行番号とずれ、#や|も画面に出ません。Claudeは根拠をファイルの行番号で示すので、ずれたままだと根拠の行を探せません。

  • idup-handsonの中のはじめにお読みください.mdを右クリック → プログラムから開く → メモ帳を選びます。
  • 表示のしかたを選ぶ画面が出たら、Markdown構文ビューで開くを選びます。出なければ、そのまま次へ進みます。
  • メモ帳で.mdを開いたら、下の帯の右側を見てください。書式付きと出ていたら押して、マークダウン構文に切り替えます。下の帯が出ていないときは、表示 → ステータス バーに印を付けます。
  • 表示 → 右端で折り返すの印を外します。
  • 1行目の先頭に#が見え、2行目が空いた行になっていることを確かめます。
  • 保存せずに閉じます。
Tips研修中も、.mdをメモ帳で開くたびに下の帯の右側を見て、マークダウン構文になっていることを確かめます。
確認
  • アドレス欄がC:\Users\<名前>\Desktop\idup-handsonになっている。OneDriveの外に置いた方は、そのパスになっている
  • 開いたフォルダの中に、資料現行画面テンプレートtools成果物.claudeとCLAUDE.mdが見え、資料の中に参考記入例発展データがある
  • はじめにお読みください.mdをメモ帳のマークダウン構文の表示で開き、1行目の#が見えた

Step 3 Codeタブでの読み込み

STEP 3 Claudeデスクトップアプリの画面の上部にidup-handsonと出ている [3min]
なぜ要るか

Claudeは、開いたフォルダの中だけを読み書きします。フォルダを開くと、最初にCLAUDE.mdを読み、そこからAGENTS.mdの約束ごとを読み込みます。約束ごとの例は、要件に根拠を付けることです。資料/は.claude/settings.jsonの設定で、Claudeのファイル編集とコマンドからの書き込みを止めてあります。pythonのスクリプトは止められないので、コマンドを読んで、資料/に書き込む内容のときは拒否します。

手順
  • Claudeデスクトップアプリを開き、上のCodeタブを選びます。
  • 環境がローカルになっていることを確かめます。
  • フォルダを選択を押し、Step 2で置いたidup-handsonを選びます。
Code タブで配布フォルダを開くまでの流れ
図5:Codeタブで配布フォルダを開くまでの流れ
Tips環境のローカルが灰色で選べないときは、社内の設定でローカルでの実行が止められています。ご自身では直せないので、貴社の研修ご担当者に知らせてください。
Code タブで、環境が ローカル になっているところ
図6:Codeタブで、環境が ローカル になっているところ
idup-handson を開いたあと。画面の上部にフォルダ名が出ます
図7:idup-handsonを開いたあと。画面の上部にフォルダ名が出ます
確認
  • 画面の上部にidup-handsonと出ている

Step 4 環境チェック

STEP 4 環境チェックの表の全行がOKになっている [5min]
なぜ要るか

Python、3つのライブラリ、Git、Node.js、LibreOfficeがそろっているか、配布フォルダの置き場所と中身、成果物/に書き込めるかを、配布フォルダのtools/check_env.pyがまとめて確かめます。自分で実行する必要はありません。Claudeに頼むと、Claudeが実行して結果を表にします。当日と同じ手順でClaudeにコマンドを実行させる練習も兼ねています。

研修中にファイルを作る流れは、下の図のとおりです。環境チェックで確かめるPython、変換ツールのライブラリ、LibreOfficeは、この流れの途中で使うものです。

研修中のファイルの流れ。Claude が Markdown を書き、変換ツールで Office 形式にして、LibreOffice で確かめます
図8:研修中のファイルの流れ。ClaudeがMarkdownを書き、変換ツールでOffice形式にして、LibreOfficeで確かめます
手順
  • Codeタブの入力欄に、下の文面を入れて送ります。
  • コマンドを実行してよいかを聞かれたら、コマンドがpython tools/check_env.pyかpy tools/check_env.pyになっていることを見て一度だけ許可を押します。ボタンは拒否常に許可一度だけ許可の3つです。常に許可は押しません。
  • Claudeが結果を表で返すので、全行がOKかを見ます。
Claudeに送る文面
環境チェックをして
コマンドを実行してよいかを聞かれたところ。[一度だけ許可] を押します。Mac で撮ったので ⌘ と出ていますが、Windows では Ctrl です
図9:コマンドを実行してよいかを聞かれたところ。一度だけ許可を押します。Macで撮ったので⌘と出ていますが、WindowsではCtrlです
環境チェックの結果の表。表の言い回しは、そのときの Claude の返事で少し変わります
図10:環境チェックの結果の表。表の言い回しは、そのときのClaudeの返事で少し変わります

結果の読み方

環境チェックは、1行に1項目ずつ、OKかNGと、項目名、詳細を出します。NGの行には、すぐ下に直し方が出ます。Claudeが返す表は、この出力をまとめたものです。版の数字は人によって違います。

環境チェック結果
----------------------------------------
[OK] Python  3.12.x(C:\Users\<名前>\AppData\Local\Programs\Python\Python312\python.exe)
[OK] python-docx  1.x.x
[OK] openpyxl  3.x.x
[OK] python-pptx  1.x.x
[OK] Git  git version 2.xx.x.windows.x
[OK] Node.js  v22.xx.x
[NG] LibreOffice  見つかりません
       直し方: 既定の場所に無いときも NG になります。確認用.pptx が LibreOffice で開ければ研修は受けられます。入っていなければ、貴社の手順書に従って最新の安定版を入れてください
[OK] 置き場所  C:\Users\<名前>\Desktop\idup-handson
[OK] 配布フォルダの中身  そろっています
[OK] 成果物への書き込み  書き込めます
----------------------------------------
確認用ファイル: C:\Users\<名前>\Desktop\idup-handson\tools\sample\確認用.pptx
LibreOffice で開けるか確かめてください。

この例では、LibreOfficeだけがNGです。

最後に出る確認用ファイルを、LibreOfficeで開くのがStep 5です。

NGが出たときの直し方

NGの項目直し方
PythonClaudeが「pythonが見つからない」と返したら、「pyで実行して」と送ります。どちらも見つからないときは、Windowsの設定 → アプリ → アプリの詳細設定 → アプリ実行エイリアスでpython.exeとpython3.exeをオフにします。Claudeデスクトップアプリを開き直し、同じ文面をもう一度送ってください。版が3.12より古くてNGのときは、「py -3.12 tools/check_env.pyで実行して」と送ります。「No suitable Python runtime found」と出たら、「py -0を実行して」と送り、入っている版を見ます。3.12がなければ、貴社の手順書で3.12を入れてください
python-docx、openpyxl、python-pptx貴社の手順書のライブラリ導入の項をやり直します。社内のネットワークの設定によっては、手順書にある方法でないと入りません
GitCodeタブを使うために要ります。貴社の手順書で導入してください。入れた直後でNGのままなら、Claudeデスクトップアプリを終了して開き直してから、もう一度送ります。アプリは起動したときの設定で動くので、あとから入れたものは開き直すまで見えません
Node.js貴社の手順書で導入します。受講者が直接使うことはありません。入れた直後でNGのままなら、Gitと同じくClaudeデスクトップアプリを終了して開き直します
LibreOffice既定の場所に見つからないときにNGになります。別の場所に入れた場合は、Step 5でファイルが開ければ研修は受けられます。入っていなければ、貴社の手順書で導入してください
置き場所OneDriveの中にあるとNGです。C:\Users\<名前>\idup-handsonのようなOneDriveの外へ移し、Codeタブで開き直します。展開したフォルダの中にもう1つidup-handsonがあるときは、内側をデスクトップへ移し、外側の空のフォルダを消してから開き直します。パスが長すぎると出たときは、デスクトップ直下など浅い場所へ移してください
配布フォルダの中身ZIPを展開し直します。二重のフォルダになっていないか、ZIPの中を開いたままになっていないかをStep 2で見直してください。.claude/settings.jsonが無いときや、中身が書き換わっているときもNGになります。このときもZIPから展開し直します
成果物への書き込みWindowsセキュリティのコントロールされたフォルダー アクセスや、フォルダの読み取り専用を確かめます。直せないときは、貴社の研修ご担当者を通じて講師に知らせてください
確認
  • 環境チェックの表の全行がOK。LibreOfficeだけNGの方は、Step 5でファイルが開けること

Step 5 LibreOfficeでの表示

STEP 5 確認用.pptxを開き、スライドが1枚表示されている [2min]
なぜ要るか

研修で作る要件定義書はWord、画面設計書とレビュー記録はExcel、レビュー会資料はPowerPointの形式です。Microsoft Officeのないパソコンで、これをLibreOfficeで開けることを先に確かめます。

手順
  • エクスプローラーでidup-handson → tools → sampleを開きます。
  • 確認用.pptxを右クリック → プログラムから開く → LibreOffice Impressを選びます。一覧にないときは別のプログラムを選択から探します。
  • 初めて起動したときに出る案内の画面は、閉じて構いません。
確認用.pptx を LibreOffice Impress で開いたところ。英語表示の Mac 版で撮っています。Windows の日本語版ではメニューが日本語です
図11:確認用.pptxをLibreOffice Impressで開いたところ。英語表示のMac版で撮っています。Windowsの日本語版ではメニューが日本語です
Tipsプログラムから開くで常にこのアプリを使って.pptxファイルを開くに印を付けておくと、当日はダブルクリックで開けます。.docxと.xlsxも同じようにしておくと、演習中の手間が減ります。
開いた確認用.pptxは保存せずに閉じてください。確かめるためのファイルなので、中身を変えずに残しておきます。当日うまく開けないときに、同じファイルで開き直して確かめられます。
確認
  • スライドが1枚表示された

Step 6 現行画面の表示

STEP 6 KINTAIのメニュー(KIN010)がブラウザに出ている [2min]
なぜ要るか

演習の題材は、架空の会社の勤怠・工数管理システムKINTAIの改修です。配布フォルダに入っている現行画面のモックを、ブラウザで開けることを確かめます。サーバは要りません。

手順
  • エクスプローラーでidup-handson → 現行画面を開きます。
  • index.htmlをダブルクリックします。ChromeかEdgeが開きます。
  • メモ帳など別のアプリが開いたときは、右クリック → プログラムから開く → ChromeかEdgeを選びます。
KIN010 メニュー。各画面へのリンクと、ログイン中の氏名、締め状態が出ます
図12:KIN010メニュー。各画面へのリンクと、ログイン中の氏名、締め状態が出ます
確認
  • KINTAIのメニューが出て、各画面へのリンクが並んでいる

最終確認

CHECK 10月7日(水)までに、ここがそろっていれば準備は完了です
  • 表の6項目がそろい、Claudeデスクトップアプリにサインインできる(Step 1)
  • 配布フォルダがOneDriveの外にあり、アドレス欄で場所を確かめた(Step 2)
  • メモ帳で.mdをマークダウン構文の表示にできた(Step 2)
  • Codeタブで〔idup-handson〕を開いた(Step 3)
  • 環境チェックの表の全行がOK(Step 4)
  • 確認用.pptxがLibreOfficeで開けた(Step 5)
  • KINTAIのメニューがブラウザに出た(Step 6)

よくある質問

管理者権限がなく、ツールを入れられません

ツールの導入は、貴社の手順書と社内のご担当者の案内に従ってください。研修で使うパソコンは、管理者権限のある共通ユーザーで準備していただく前提です。

「環境チェックをして」と送ったのに、表が返ってきません

コマンドを実行してよいかの確かめで一度だけ許可を押していないと、止まったままになります。確かめの表示が見当たらなければ、「python tools/check_env.pyを実行して、結果を表にしてください」と送り直してください。

Codeタブでフォルダを選ぶと、idup-handsonの中にもう1つidup-handsonがあります

ZIPを展開したときに二重になっています。内側のフォルダをデスクトップへ移し、外側の空のフォルダは消してください。Codeタブでは、移した内側のフォルダを開き直します。

デスクトップがOneDriveにしかありません

展開先をC:\Users\<名前>にして、C:\Users\<名前>\idup-handsonに置いてください。当日の手順は、どこに置いても同じです。

配布フォルダの日本語のファイル名が化けています

Windowsのエクスプローラーのすべて展開で展開し直してください。ほかの展開ソフトでは、日本語のファイル名が化けることがあります。

Codeタブで、接続のエラーや証明書のエラーが出ます

社内のプロキシや、通信の検査のための証明書が原因のことがあります。貴社の情報システムのご担当者に確かめてください。プロキシや社内の証明書は、Codeタブの環境ローカルの歯車を押して開く環境の編集で、HTTPS_PROXYやNODE_EXTRA_CA_CERTSとして設定できます。入れる値はご担当者の案内に従ってください。

Macでも受講できますか

研修は、貴社配布のWindows 11のパソコンを前提にしています。配布フォルダもWindows用です。

事前準備が期限までに終わりませんでした

どのStepで止まったかを、貴社の研修ご担当者を通じてお知らせください。当日は、Zoomに入った時点でチャットに書いていただければ、講師が確かめます。