貴社の手順書
ツールを導入する
Claudeデスクトップアプリ、Git、Python、Node.js、LibreOfficeを入れます。
このガイド
置いて、読ませて、確かめる
配布フォルダをデスクトップに置き、Claudeに読み込ませ、環境チェックで確かめます。
当日の演習の途中で変換ツールが動かなかったり、ファイルが開けなかったりすると、その演習をそこから先へ進められません。3回の研修は前の回の成果物を次の回で使うので、1回の遅れがあとまで響きます。導入が済んだら、このガイドの6つのStepで、当日と同じ操作が通ることを先に確かめておいてください。
Step 1 導入するものの確認
下の図のように、ツールを入れるのは貴社の手順書、入ったあとの置き場所と確かめはこのガイドの受け持ちです。
研修では、Claudeデスクトップアプリに頼んで、Markdownの文書をWord、Excel、PowerPointに変換し、LibreOfficeで開いて確かめます。1つでも欠けると、その演習の途中で止まります。導入の手順は貴社の手順書にあるので、ここでは何がそろっていればよいかだけを確かめてください。

| 項目 | 版 | 研修での使い道 | どこで確かめるか |
|---|---|---|---|
| Claudeデスクトップアプリ | Windows x64の最新版 | Codeタブで演習をします。貴社から案内されたアカウントでサインインしておきます | Step 3 |
| Git for Windows | 最新版 | Codeタブを使うために要ります。研修でGitの操作はしません | Step 4 |
| Python | 3.12系。python-docx、openpyxl、python-pptxを含む | 変換ツールと環境チェックをClaudeが動かします | Step 4 |
| Node.js | 22 系の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、Maven | Javaのコードを書いたり動かしたりする場面はありません |
| TomcatなどのWebサーバ | 現行画面とモックは、HTMLをダブルクリックで開きます |
| VS Code、WSL、ターミナル | 操作はすべてClaudeデスクトップアプリのCodeタブで行います |
| Microsoft Office | Word、Excel、PowerPointの形式のファイルはLibreOfficeで開きます |
| PowerShell 7系 | Windowsに最初から入っている5系のままで構いません |
- 表の6項目が、インストールされているアプリの一覧にある。PythonのライブラリはStep 4で確かめる
- Claudeデスクトップアプリにサインインできる
Step 2 配布フォルダの展開
演習で読むヒアリングメモ、データ、テンプレート、変換ツールは、すべて配布フォルダに入っています。Claudeはこのフォルダの中のファイルを読み、作ったファイルもこの中の成果物/に置きます。使うフォルダは、3回ともこの配布フォルダです。
- 上のボタンから
idup-handson_20261008.zipをダウンロードします。 - エクスプローラーでダウンロードを開き、ZIPを右クリック → すべて展開を選びます。
- 展開先の欄を
C:\Users\<名前>\Desktopに書き換えます。<名前>はサインインしているWindowsのユーザー名です。参照でデスクトップを選んでも同じです。 - 展開を押すと、デスクトップに
idup-handsonフォルダができます。 idup-handsonを開き、アドレス欄の何もないところをクリックします。表示がパスの文字に変わるので、それを読みます。- エクスプローラーの表示 → 表示 → ファイル名拡張子に印を付けます。
成果物/に同じ名前の.mdと.docxが並んだときに、見分けられるようにするためです。
![ZIP の展開の流れ。右クリックのメニューの[すべて展開]を選び、展開先をデスクトップに書き換えます](assets/figures/unzip.png)
配布フォルダの中身
展開したフォルダの中は、下の図の形になっています。演習で読むものは資料/、作ったものは成果物/に入ります。

| フォルダ | 中身 |
|---|---|
資料/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-handson | OneDriveと同期したデスクトップ | 置き直します |
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ではそのフォルダを選びます。

idup-handsonがある二重の状態になったら、内側のidup-handsonをデスクトップへ移し、外側の空のフォルダは消して構いません。メモ帳での.mdの表示
研修では、ヒアリングメモなどの.mdのファイルをメモ帳で読みます。Windows 11のメモ帳は、.mdを書式付きの表示で開くことがあります。書式付きのままだと空行が行数に入らないので、下の帯の行番号がファイルの行番号とずれ、#や|も画面に出ません。Claudeは根拠をファイルの行番号で示すので、ずれたままだと根拠の行を探せません。
idup-handsonの中のはじめにお読みください.mdを右クリック → プログラムから開く → メモ帳を選びます。- 表示のしかたを選ぶ画面が出たら、Markdown構文ビューで開くを選びます。出なければ、そのまま次へ進みます。
- メモ帳で.mdを開いたら、下の帯の右側を見てください。書式付きと出ていたら押して、マークダウン構文に切り替えます。下の帯が出ていないときは、表示 → ステータス バーに印を付けます。
- 表示 → 右端で折り返すの印を外します。
- 1行目の先頭に
#が見え、2行目が空いた行になっていることを確かめます。 - 保存せずに閉じます。
- アドレス欄が
C:\Users\<名前>\Desktop\idup-handsonになっている。OneDriveの外に置いた方は、そのパスになっている - 開いたフォルダの中に、
資料現行画面テンプレートtools成果物.claudeとCLAUDE.mdが見え、資料の中に参考記入例発展データがある はじめにお読みください.mdをメモ帳のマークダウン構文の表示で開き、1行目の#が見えた
Step 3 Codeタブでの読み込み
Claudeは、開いたフォルダの中だけを読み書きします。フォルダを開くと、最初にCLAUDE.mdを読み、そこからAGENTS.mdの約束ごとを読み込みます。約束ごとの例は、要件に根拠を付けることです。資料/は.claude/settings.jsonの設定で、Claudeのファイル編集とコマンドからの書き込みを止めてあります。pythonのスクリプトは止められないので、コマンドを読んで、資料/に書き込む内容のときは拒否します。
- Claudeデスクトップアプリを開き、上のCodeタブを選びます。
- 環境がローカルになっていることを確かめます。
- フォルダを選択を押し、Step 2で置いた
idup-handsonを選びます。



- 画面の上部に
idup-handsonと出ている
Step 4 環境チェック
Python、3つのライブラリ、Git、Node.js、LibreOfficeがそろっているか、配布フォルダの置き場所と中身、成果物/に書き込めるかを、配布フォルダのtools/check_env.pyがまとめて確かめます。自分で実行する必要はありません。Claudeに頼むと、Claudeが実行して結果を表にします。当日と同じ手順でClaudeにコマンドを実行させる練習も兼ねています。
研修中にファイルを作る流れは、下の図のとおりです。環境チェックで確かめるPython、変換ツールのライブラリ、LibreOfficeは、この流れの途中で使うものです。

- Codeタブの入力欄に、下の文面を入れて送ります。
- コマンドを実行してよいかを聞かれたら、コマンドが
python tools/check_env.pyかpy tools/check_env.pyになっていることを見て一度だけ許可を押します。ボタンは拒否常に許可一度だけ許可の3つです。常に許可は押しません。 - Claudeが結果を表で返すので、全行がOKかを見ます。
環境チェックをして
![コマンドを実行してよいかを聞かれたところ。[一度だけ許可] を押します。Mac で撮ったので ⌘ と出ていますが、Windows では Ctrl です](assets/screens/app/env_check_permission.png)

結果の読み方
環境チェックは、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の項目 | 直し方 |
|---|---|
| Python | Claudeが「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 | 貴社の手順書のライブラリ導入の項をやり直します。社内のネットワークの設定によっては、手順書にある方法でないと入りません |
| Git | Codeタブを使うために要ります。貴社の手順書で導入してください。入れた直後で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での表示
研修で作る要件定義書はWord、画面設計書とレビュー記録はExcel、レビュー会資料はPowerPointの形式です。Microsoft Officeのないパソコンで、これをLibreOfficeで開けることを先に確かめます。
- エクスプローラーで
idup-handson→tools→sampleを開きます。 確認用.pptxを右クリック → プログラムから開く → LibreOffice Impressを選びます。一覧にないときは別のプログラムを選択から探します。- 初めて起動したときに出る案内の画面は、閉じて構いません。

- スライドが1枚表示された
Step 6 現行画面の表示
演習の題材は、架空の会社の勤怠・工数管理システムKINTAIの改修です。配布フォルダに入っている現行画面のモックを、ブラウザで開けることを確かめます。サーバは要りません。
- エクスプローラーで
idup-handson→現行画面を開きます。 index.htmlをダブルクリックします。ChromeかEdgeが開きます。- メモ帳など別のアプリが開いたときは、右クリック → プログラムから開く → ChromeかEdgeを選びます。

- KINTAIのメニューが出て、各画面へのリンクが並んでいる
最終確認
よくある質問
管理者権限がなく、ツールを入れられません
ツールの導入は、貴社の手順書と社内のご担当者の案内に従ってください。研修で使うパソコンは、管理者権限のある共通ユーザーで準備していただく前提です。
「環境チェックをして」と送ったのに、表が返ってきません
コマンドを実行してよいかの確かめで一度だけ許可を押していないと、止まったままになります。確かめの表示が見当たらなければ、「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に入った時点でチャットに書いていただければ、講師が確かめます。