パーソルクロステクノロジー様 第3回第3回セミナー当日に、手元でどこまで動かせる状態にしておくかをまとめた資料です。全員に共通するSTEP 01からSTEP 03とSTEP 06は無料の範囲で進められ、所要は30〜60分です。Claude Codeを手元で動かすSTEP 04だけ、Claudeの有料プランまたはAPIクレジットが必要になります。ライセンスをお持ちでない方の参加のしかたは、このページの冒頭に書いてあります。
Claude Codeが使える方、GitHub Copilotが使える方、どちらもない方。それぞれの当日の進み方を先に決めます。
当日の画面をそろえるためのエディタを入れます。無料で使えます。
当日打ち込む命令は5つです。うち実際に練習するのは移動と一覧の2つで、残りは何をするものかだけ確認します。
置き場所を先に決めておきます。配布データは当日の朝に届きます。
有料プランをお持ちの方向けです。起動して応答が返るところまで確認します。
すでにCopilotをお使いの方向けです。読み替え版の配布データを使います。
前回いちばん多かったつまずきです。当日ではなく事前に一度試します。
5分で終わる確認項目です。どれか落ちても参加できる形にしてあります。
前回実際に起きたトラブルへの対応をまとめています。
本セミナーは無料公開セミナーです。AIツールの有料ライセンスをお持ちでない方の参加を前提に設計しています。まず、ご自身がどの型で参加されるかを決めてください。この後のStepは、型によって実施する範囲が変わります。
Claudeの有料プランをお持ちの方です。当日のハンズオンをすべて手元で実行できます。STEP 01からSTEP 04、およびSTEP 06とSTEP 07を実施してください。
会社または個人でGitHub Copilotをお使いの方です。配布データにCopilot用の読み替え手順を同梱します。STEP 01からSTEP 03、STEP 05、STEP 06、STEP 07を実施してください。
AIツールのライセンスがない方です。当日は講師の画面と本サイトを見ながら進めます。STEP 01からSTEP 03、STEP 06、STEP 07を実施してください。手元にエディタがあれば参加していただけます。
当日のハンズオンで受講者の方が実際に書くのはMarkdownのテキストだけです。AIに渡す前提情報を、どのファイルに、どの粒度で書くかを決める作業が中心になります。テキストエディタがあれば同じ作業ができます。
ハンズオンの各手順には、講師が実行したときの入力プロンプトと出力の全文を、実行ログとして本サイトに載せる予定です。講師は各手順の冒頭で必ず一度その操作を自分の画面で実行し、結果を出してから受講者の方に時間をお渡しします。手元で動かせない場合でも、投影されている実行ログを読めば、何を入力して何が返ってきたかを追えます。
当日は、判断を問う場面も設ける予定です。「この問い合わせは、何回直せば通りますか」「人を呼ぶ条件を1行足すなら、どこに足しますか」といった問いの答えをZOOMのチャットへ投稿していただき、講師が読み上げる流れです。画面を見ているだけで答えられる問いにしてあります。
当日その場で動かせなくても、後日ご自身の環境で同じ手順を再現できます。配布データのREADME.mdに、開催後に一人で追う場合の順番を書いています。ライセンスを後から用意した方も、同じ内容を最初から実行できる形です。
| 時間 | 内容 | 本ガイドの対応 |
|---|---|---|
| [10min] | オープニング(今夜の見取り図) | 準備なしで参加できます |
| [30min] | 概念整理(コンテキストとハーネス) | 準備なしで参加できます |
| [20min] | ハーネス設計の講師ライブデモ | 見ていただく時間です |
| [40min] | ハンズオン | STEP 01からSTEP 05が効いてきます |
| [20min] | 振り返り・次回予告・質疑応答 | 準備なしで参加できます |
準備が必要なのは[40min]のハンズオンだけです。残りの[80min]は、接続さえできれば参加していただけます。
当日のハンズオンはVisual Studio Codeの画面を前提に進めます。無料で、WindowsとMacのどちらでも同じ画面になります。すでにお使いの方はSTEP 02へ進んでください。
当日は、AIに渡す前提情報を書いたファイルを複数開いて、その中身を書き換えながら進めます。フォルダ全体を左側に並べて表示できるエディタがあると、どのファイルを触っているかを見失いません。講師の投影画面も同じエディタで進めますので、画面が一致します。
TYPE Cの方にとっても、このエディタが当日の作業場所になります。AIツールがなくても、ここにテキストを書く作業は同じです。

https://code.visualstudio.com/Downloadをブラウザで開きます。Windows Linux Macの3つのボタンが横に並んでいます。
Windowsのボタンを押してインストーラーをダウンロードします。ダウンロードしたファイルを実行し、使用許諾に同意してNextを押し続けます。Add to PATHのチェックは付いたままにしてください。最後にInstallを押します。
Macのボタンを押してZIPをダウンロードします。ダウンロードフォルダに現れたVisual Studio Code.appを、Applicationsフォルダへドラッグして移動します。ダウンロードフォルダから起動したままだと、後の手順でファイルの場所が分かりにくくなるためです。
Windowsはスタートメニューから、MacはApplicationsからVisual Studio Codeを起動します。初回起動時に配色やキー割り当てを選ぶ画面が出た場合は、そのまま既定値で進めて構いません。
左端のアクティビティバーでExtensionsのアイコンを押し、検索欄にJapanese Language Packと入力します。Japanese Language Pack for Visual Studio Codeを選んでInstallを押し、右下に出るChange Language and Restartを押すと日本語表示になります。英語のままでも当日の進行に支障はありません。
入れるのはVisual Studio Codeです。名前がよく似たVisual Studio 2022は別の製品で、こちらは入れないでください。検索エンジンで「Visual Studio」とだけ検索すると後者が上位に出ることがあります。上の手順のリンクから開けば取り違えません。
当日ターミナルに打ち込む命令は5つです。ここでは、ターミナルを触ったことがない方向けに、そのうちcdとlsを実際に打つところまでを扱います。残り3つは、何をする命令かだけ先にお伝えします。
cdでフォルダを移動できるlsでフォルダの中身を一覧表示できる当日は、配布データのフォルダの中でAIツールを起動します。AIツールは起動した場所を基準に設定ファイルを読み込むため、いまどのフォルダにいるかが結果を左右します。移動と一覧の2つが分かっていれば、起動の場所でつまずくことはありません。
ターミナルは、文字を打って命令を送り、文字で結果が返ってくる画面です。マウスで押すボタンの代わりに、キーボードで命令の名前を打ち、最後にEnterキーを押すと実行されます。打ち間違えても、もう一度打ち直せば問題ありません。


Visual Studio CodeのメニューからTerminalを押し、New Terminalを選びます。日本語化している場合は「ターミナル」から「新しいターミナル」です。ウィンドウの下半分に黒っぽい領域が現れ、文字を打てる状態になります。
次の2文字を打ってEnterキーを押します。フォルダやファイルの名前が並んで表示されます。
ls
lsは、WindowsのPowerShellでも使える命令です。表示の形式がMacと少し違いますが、一覧が出れば同じことができています。
cdはフォルダを移動する命令です。半角スペースを1つ空けてから移動先を書きます。
cd Desktop ls
1行目で移動し、2行目でその場所の中身を確認しています。デスクトップに置いてあるファイルの名前が並べば成功です。
移動先の代わりにピリオド2つを書くと、1つ上の階層に戻ります。
cd ..
実際に打っていただくのはここまでです。残りの命令は、下の表で何をするものかだけ確認してください。
ハンズオンで打ち込む内容は、本サイトのハンズオンページに全文を掲載します。コピーして貼り付けていただければ、打ち間違いは起きません。WindowsはCtrlとV、MacはCmdとVで貼り付けられます。
WindowsでNew Terminalを開いたとき、右側の切り替えで選ぶのはPowerShellです。Command Promptを選ぶと当日の説明と表示が変わります。Macは既定のzshのままで構いません。
当日打ち込む命令は、下の5つだけです。上の2つは、いま打っていただいた命令です。下の3つは当日、ハンズオンページに出てくる行をコピーして貼り付けるだけですので、覚える必要はありません。何をする命令かだけ分かっていれば、画面で何が起きたかを追えます。
| 命令 | すること | 当日どこで使うか |
|---|---|---|
| cd | フォルダを移動する | 配布データのフォルダへ入るとき |
| ls | フォルダの中身を一覧表示する | 生成されたファイルを確認するとき |
| mkdir | フォルダを作る | STEP 03で作業フォルダを作るとき |
| chmod | ファイルに実行の許可を与える | Macの方のみ。ハンズオンStep 1で、検証とフックのスクリプトを実行できる状態にするとき |
| cp / xcopy | ファイルを複製する | 詰まったときに完成版を上書きコピーして先へ進むとき。Macはcp、Windowsはxcopy |
MacとLinuxでは、スクリプトファイルに「実行してよい」という印が付いていないと動きません。chmod +xは、その印を付ける命令です。WindowsのPowerShellにはこの仕組み自体がありませんので、chmodは打ちません。当日はWindows用の手順を別に用意しています。
lsと打ってEnterを押すと、ファイルやフォルダの名前が表示されるcd Desktopと打つとエラーが出ず、続けてlsでデスクトップの中身が見える当日の作業場所を先に1つ作っておきます。配布データ(ZIP)は開催当日の朝までにメールでお送りしますので、届いたらこのフォルダへ展開してください。事前にできるのはフォルダを作るところまでです。
loop-2026という名前のフォルダがある展開先が決まっていないと、当日「ファイルがどこにあるか分からない」という状態から始まります。前回のセミナーでは、ここで時間を使ってしまった方が一定数いらっしゃいました。置き場所を先に決めておくと、当日は展開して開くだけで済みます。
フォルダ名を半角英数字にしているのは、日本語や空白を含むパスでAIツールが読み込みに失敗する場合があるためです。

STEP 02で開いたターミナルに、次を打ってEnterを押します。WindowsとMacで同じ内容です。
cd ~/Desktop mkdir loop-2026 ls
mkdirはフォルダを作る命令です。3行目の一覧にloop-2026が出れば、フォルダはできています。デスクトップを見ると、同じ名前のフォルダが増えています。
メニューのFileからOpen Folder...を選び、いま作ったloop-2026を指定してOpenを押します。MacではOpen...という表示の場合があります。左側にフォルダ名が出ていれば、フォルダを開けた状態です。
配布データは20261126_handson.zip(Windows用)と20261126_handson_Mac.zip(Mac用)の2本をお送りします。中身は同じです。ご自身のOSに合うほうを、いま作ったloop-2026フォルダの中へ展開してください。展開するとloop-kitというフォルダが1つできます。
ターミナルで次を打つと、配布データの中身が一覧で表示されます。
cd ~/Desktop/loop-2026/loop-kit ls
README.md、loop、context、checks、copilot、hintsなどの名前が並びます。
Windowsの方が選ぶのは20261126_handson.zip、Macの方が選ぶのは20261126_handson_Mac.zipです。逆を展開するとファイル名が文字化けする場合があります。文字化けした場合は、展開したフォルダを削除して、もう一方のZIPを展開し直せば直ります。
配布データにはsolutionsという完成版のフォルダが入っています。当日つまずいたときの復旧用です。先に中身を読むと、当日の「自分で考えて書く」という時間が成立しなくなります。hintsフォルダも同様で、90秒以上詰まったときに1ファイルだけ開く想定にしています。
loop-2026フォルダがあるloop-kitフォルダが見えるClaudeの有料プランをお持ちの方向けの手順です。TYPE BとTYPE Cの方は、このStepを飛ばしてSTEP 05またはSTEP 06へ進んでください。ここで確認するのは、起動して応答が返るところまでです。
claudeと打つと対話画面が開く/helpと打つとコマンドの一覧が表示される当日のハンズオンでは、配布データに入っているループのSkillと、検証の結果を記録するフックをClaude Codeから動かします。フックはClaude Codeの機能に依存していますので、起動できる状態を先に作っておく必要があります。
Claude Codeの利用にはClaudeの有料プラン、またはAPIクレジットが必要です。プランの内容と料金は変わることがあるため、契約前に公式ページで当日の表示をご確認ください。参照先は本セクション末尾のSOURCESに置いています。


claudeで対話画面が開いたあとの流れが、当日の正の手順です。
ターミナルで次を打ちます。v20以上の数字が表示されれば入っています。command not foundと出た場合は次の手順へ進んでください。
node -v
https://nodejs.org/en/downloadを開き、LTSと表示されているほうのインストーラーをダウンロードします。選ぶのはLTSで、Currentではありません。インストール後、ターミナルを一度閉じて開き直してからnode -vをもう一度打ちます。
ターミナルで次を打ちます。WindowsとMacで同じです。完了までに数分かかります。
npm install -g @anthropic-ai/claude-code claude --version
バージョン番号が表示されればインストールできています。ほかのインストール方法を使う場合は、公式のクイックスタートに従ってください。
STEP 03で作ったフォルダへ移動してから起動します。
cd ~/Desktop/loop-2026 claude
初回はブラウザが開き、サインイン画面に移ります。お持ちのアカウントでサインインしてください。ターミナルに戻ると、対話できる状態になっています。
対話画面で/helpと打ってEnterを押します。コマンドの一覧が表示されれば動作しています。確認はここまでで十分です。終了するときは/exitと打ちます。
用意するのは、ターミナルで動くClaude Codeです。ブラウザで使うclaude.aiやデスクトップアプリのClaudeでは、当日のハンズオンで使うSkillsやHooks(決めた地点で必ず走る仕掛け)の機能を動かせません。Visual Studio Codeの拡張機能Claude Code for VS Codeは補助として入れても構いませんが、必須ではありません。
社内のプロキシや証明書の設定により、npm installが途中で止まる、サインイン時のブラウザ認証が完了しない、といった事象が起きることがあります。会社のセキュリティ設定を無理に変更しないでください。前回はここで時間を使ってしまった方が複数いらっしゃいました。個人の端末をお持ちであればそちらのほうが早く、なければTYPE Cの参加に切り替えていただいて構いません。
claude --versionでバージョン番号が表示されるclaudeで対話画面が開き、/helpにコマンド一覧が返る/exitで終了できる会社または個人でGitHub Copilotをお使いの方向けの手順です。配布データにはCopilot用の読み替え版を同梱しますので、当日は同じ内容をCopilotのチャットで進められます。TYPE AとTYPE Cの方はこのStepを飛ばしてください。
これまでのセミナーのアンケートでは、業務で使えるAIツールとしてGitHub Copilotがもっとも多く挙がりました。当日の題材はClaude Codeを中心に進めますが、AIに渡す前提情報をどこに置くかという考え方はツールを問いません。配布データのcopilotフォルダに、前提情報を.github/copilot-instructions.mdへ置き換える手順と、ループの依頼文をCopilotのエージェントに送る手順を入れています。



copilot/に入れています。Visual Studio Codeの左端でExtensionsのアイコンを押し、検索欄にGitHub Copilotと入力します。GitHub Copilotが表示され、すでに入っている場合はInstalledと出ます。入っていない場合は、Installを押してください。
画面右下または左下にSign in to GitHubの案内が出たら押します。ブラウザが開き、GitHubの認証画面に移ります。会社のライセンスをお使いの場合は、会社から案内されているアカウントでサインインしてください。
左端のアクティビティバーでChatのアイコンを押すとチャット欄が開きます。「このフォルダに何が入っているか教えてください」と送って、返答が返れば動作しています。
このStepは、すでにライセンスをお持ちの方の動作確認です。本セミナーのために新しく契約していただく必要はありません。ライセンスがない場合はTYPE Cの参加になりますが、当日の内容は同じように追えます。
業務端末で使えるAIツールや、入力してよい情報の範囲は会社ごとに決まっています。当日の題材は架空の会社の架空の問い合わせで構成していますので、実際の業務情報を入力する必要はありません。ご自身の業務に置き換える手順もありますが、そこで何を書くかはご自身の判断でお決めください。
前回のセミナーでいちばん多かったつまずきが、当日になってからの音声トラブルでした。開始前に一度だけ、音が聞こえる状態かを確かめておいてください。3分で終わります。
本セミナーはZOOMのウェビナー形式で、受講者の方のマイクとカメラは使いません。聞くための音声だけが必要です。前回は延べ205名の方に接続いただき、途中入退出も多くありました。開始直後は接続が揃わない前提で進行しますので、遅れて入っても内容は追える構成にしています。
ZOOMを起動し、右上のプロフィールアイコンからCheck for Updatesを選びます。更新がある場合は案内に従って更新します。ブラウザから参加する場合、この手順は不要です。
https://zoom.us/testを開き、Joinを押してテスト用のミーティングに入ります。Test Speakerを押して着信音が聞こえるか確認してください。聞こえない場合は、出力先を選ぶ一覧から、実際に使っているスピーカーやイヤホンに切り替えます。
申込時に届いた案内メールに参加URLがあります。開始の5分前を目安に入室してください。入室時に音声の接続方法を尋ねられたらJoin with Computer Audioを選びます。
入室時にPhone CallとJoin with Computer Audioの選択肢が出た場合、選ぶのはJoin with Computer Audioです。Phone Callを選ぶと通話料が発生するうえ、画面共有の音声が届かない場合があります。
当日に音が聞こえなくなった場合は、いったん退出してもう一度入り直すのが最も早い復旧方法です。復帰までに1分もかかりません。復旧できない場合はチャットにその旨をお書きください。事務局から個別にご案内します。
開催前日に5分だけ時間を取って、下の項目を確認してください。落ちている項目があっても参加していただけます。落ちた項目に応じて、当日どの型で参加するかを決めるための確認です。
| 対象 | 確認すること | 落ちた場合 |
|---|---|---|
| 全員01 | Visual Studio Codeが起動する | STEP 01をやり直す。間に合わなければメモ帳でも参加できます |
| 全員02 | ターミナルでlsが動く | STEP 02をやり直す。当日はコピーと貼り付けで進められます |
| 全員03 | デスクトップにloop-2026がある | STEP 03をやり直す。当日の朝でも間に合います |
| 全員04 | ZOOMのスピーカーテストで音が聞こえる | STEP 06をやり直す。当日は入り直しで復旧する場合が多いです |
| TYPE A | claudeが起動して/helpが返る | TYPE BかTYPE Cに切り替えて参加してください |
| TYPE B | Copilotのチャットに返答が返る | TYPE Cに切り替えて参加してください |
当日のハンズオンで受講者の方が書くのは、AIに渡す前提情報のテキストです。その中身を決める作業は、AIツールがなくても同じように行えます。講師は各手順を先に自分の画面で実行し、入力と出力の全文を投影しますので、手元で動かない場合でも何が起きたかを追えます。
前回のセミナーで実際に寄せられた内容を中心にまとめています。ここに載っていない点は、当日のチャットにお書きいただければ質疑の時間にお答えします。
claudeと打つとcommand not foundと出ますnode -vを打ってNode.jsが入っているかを確認し、入っていなければSTEP 04の手順2から進めてください。当日にこの復旧を試すのは90秒までにして、うまくいかない場合はTYPE Cの参加へ切り替えていただくほうが、内容を追えます。npm installが途中で止まります20261126_handson.zip、Macの方は20261126_handson_Mac.zipを展開してください。展開済みのフォルダを削除して、もう一方のZIPを展開し直せば直ります。cd(移動)、ls(一覧)、mkdir(フォルダを作る)、chmod(実行の許可を与える。Macの方のみ)、cpまたはxcopy(複製)の5つです。覚える必要はありません。打ち込む内容は本サイトのハンズオンページに全文を掲載しますので、コピーして貼り付けていただけます。STEP 02に、初めての方向けの手順と、5つの命令が何をするものかの一覧を置いています。ここを一度なぞっておけば、当日の操作には足りる内容です。本ガイドで解決しない場合は、当日までの解決を目指さずTYPE Cへ切り替えてください。切り替えに手続きは要りません。当日そのまま入室していただければ進行に支障はありません。準備の状況をご連絡いただく必要もありません。ご質問は当日のチャットへお書きいただければ、質疑の時間にお答えします。