開発はLinuxで、確認はWindows。こういう体制だと、手順書を「どうやって相手の画面に届けるか」で毎回つまずきます。
ママゴトラボでは2026年8月から、この手順書をClaude Codeのアーティファクト(Claude Codeが作ったHTMLページを、claude.ai上の非公開URLに公開する機能)で渡しています。
アーティファクトは11月15日までに計36枚作りました。このうち実機確認・操作手順は7枚で、残りは案の比較や顧客との共有などです(内訳は5章)。この記事は、その手順書の型と、運用して分かった制約の記録です。
結論から書きます。
- 手順書はURL1本で別のPCに渡せる。 ページに組み込んだチェックボックスやコピーボタンも、そのまま動きます。
- ただし、私の作り方では、付けたチェックはClaudeに戻らない。 チェックの状態は、開いたブラウザの中にしか残りません。
- だから手順書の最後に「持ち帰るもの」欄を置き、結果は会話に貼り戻してもらう。この形に落ち着きました。
以下、実物の型と制約を順に書きます。
前提(この記事の数字と事実の出どころ)
- 環境:開発機はArch Linux、確認に使うのは家のWindows PC
- 枚数:2026-11-15時点で、自分のアカウントに残っている公開済みのアーティファクトが36枚(Claude Codeの一覧機能で数えた値。最も古い更新日は2026-08-22)
- プラン:個人プラン。チーム向けの組織内共有やコメント機能は使っていません
- 機能の仕様:公式ドキュメント「セッション出力をアーティファクトとして共有する」を2026-11-15に確認
- アーティファクトは2026年6月にベータ公開された機能です。仕様は今後変わります
1. なぜmdの手順書をやめたか
以前は、実機確認の手順をMarkdown(md)ファイルで書き、開発機に置いていました。この運用で困ったのは次の3点です。
| 困りごと | mdのとき | アーティファクトにしてから |
|---|---|---|
| 別のPCで開く | ファイルをUSBやNASで運ぶ | 同じclaude.aiアカウントでログインし、URLを開くだけ |
| どこまで進んだか | 頭で覚える・紙に書く | チェックボックスと進捗バー(ページに自分で組み込む) |
| コマンドを打つ | 選択してコピー(はみ出しやすい) | 「コピー」ボタン(同上) |
チェックボックスやコピーボタンは、アーティファクトの標準機能ではありません。Claudeに頼んでHTMLとJavaScriptで組み込んだものです。アーティファクトが担うのは「そのページを、別の端末からURLで開ける場所に置く」部分です。
手順書の読み手は、たいてい別の端末の前にいる人です。開発機の中にあるファイルは、その人の手元にありません。ここが一番大きい理由でした。
なお、記事は今もmdのままです。記事は公開用の仕組みに流すため、HTMLにする理由がありません。使い分けは「人が画面の前で、順番に操作するか」で決めています。
2. 1手順=「打つもの・期待する表示・つまずいたら」
手順書を作るうちに、手順1つの中身はこの3点で固定しました。通信を測る試作ツールを、Windowsで動かして確かめたときの手順書から抜粋します(構造だけの抜粋で、コピーボタンの処理などは省いています)。
<li class="step">
<input type="checkbox" id="s-test">
<label for="s-test">テストを流す</label>
<div class="body">
<!-- 打つもの -->
<div class="cmd"><pre>python -m unittest test_logic</pre><button type="button">コピー</button></div>
<!-- 期待する表示 -->
<div><div class="k">期待する表示(30秒ほど)</div>
<pre class="out">Ran 59 tests in …s
OK</pre></div>
<!-- つまずいたら -->
<p class="tip"><b>つまずいたら</b> FAILやERRORが出たら、その画面をそのまま持ち帰ってください。</p>
</div>
</li>
3点をそろえる理由はこうです。
- 打つもの:コピーボタンで渡します。手で打ち写すと、1文字違いで別のエラーになります。
- 期待する表示:これがないと、確認する人は「動いた」のか「動いたように見える」のかを判断できません。判断基準を手順書の側に持たせるための欄です。
- つまずいたら:よくある失敗と、そのとき持ち帰ってほしいものを書きます。例えば
pythonと打ってMicrosoft Storeが開く場合は、Pythonが入っていないか、PATH(コマンドの置き場所の登録)が通っていないかを疑います。
手順の番号は実際に作業する順に振ります。準備・Python版で動かす・exeにして動かす、のように節を分け、番号は節をまたいで通しにしました。
3. チェックの状態は、Claudeに戻らない
ここが運用して一番大事だった点です。
私の手順書では、チェックボックスの状態を、ページの中のJavaScriptでブラウザのlocalStorage(ブラウザがサイトごとに持つ小さな保存場所)に入れています。
var KEY = 'netprobe-win-check';
try { state = JSON.parse(localStorage.getItem(KEY) || '{}') || {}; } catch (e) { state = {}; }
// …変更のたびに
try { localStorage.setItem(KEY, JSON.stringify(state)); } catch (e) {}
localStorageは、開いたブラウザの中にしかありません。WindowsのChromeで付けたチェックは、そのChromeにだけ残ります。この作りには、状態をClaude Codeへ送る仕組みがありません。開発機のClaudeからは見えませんし、別の端末で開けば白紙です。
なお公式には、組織内で共有したページにコメントを残し、Claudeに読ませる機能もあります(チーム向けプランの機能)。個人プランの私の運用では使っておらず、チェックの状態とも別物です。
try で囲んでいるのは、プライベートウィンドウなど、保存が使えない環境でもページ自体は動くようにするためです。
そこで、手順書の最後に必ずこの欄を置いています。
終わったら持ち帰るもの
・手順5(と6)の画面の表示(コピーして貼るだけで十分)
・つまずいた手順があれば、その画面
・余裕があれば ログファイルとレポートのHTML
確認した人は、この3つを開発機の会話に貼ります。Claudeはそれを見て直します。
公式ドキュメントにも、同じ考え方の使い方が「結果をセッションに戻す」として載っています。ページで操作した結果をテキストにして、ターミナルに貼り戻す形です。私の運用では、確認結果の正本は会話かファイルに残し、ページは操作の道具と割り切るのが合っていました。
4. 運用で分かった制約
公式ドキュメントに書かれている制約のうち、実際に効いたものを挙げます。
| 制約(公式) | 運用での影響 | やったこと |
|---|---|---|
| ページは自分ではダウンロードを始められない(通常のダウンロードリンクも不可) | 手順書のページにzipを添えて配る作りにできない | zipはUSBやNASで別に渡し、手順書にはその置き場所だけ書く |
| 外部の画像は読み込めない。スクリプトは指定の5つのCDNのみ | 画面写真を外部URLで貼れない | 図はHTMLとCSSで描く。写真は使わない |
| フォントはGoogle Fontsのみ外部から読める | 読みやすい日本語フォントを使いたい | BIZ UDPゴシックをGoogle Fontsから読み、読めないときの代わりも指定 |
| 表示サイズは16MiBまで | 画像を埋め込むと膨らむ | 画像を入れない設計で、上限に当たったことはない |
ダウンロードについては、公式に「ダウンロード機能」という別の仕組みがあり、アカウント単位で有効になると書かれています。ページが作ったCSVなどを保存させる用途です。私の運用では、手順書とツール本体を分けて渡す形で困っていないので、使っていません。
もう1つ、使えない条件も押さえておく必要があります(公式ドキュメントの「利用可能性」より)。
- Pro・Max・Ultra・Team・Enterpriseプランで、claude.aiアカウントでログインしたセッションが必要
- APIキーやクラウド事業者経由(Amazon Bedrockなど)のセッションでは公開できない
-p(スクリプトから1回だけ実行する使い方)や、Agent SDKなどからの実行では無効(SDKなどは既定で無効)
自動化の途中で手順書を作らせたいときは、-p では公開されない点に注意が要ります。
5. 手順書以外に広がった使い道
36枚を題名で分けると、こうなりました(題名から私が分類した数です)。
| 種類 | 枚数 | 中身 |
|---|---|---|
| 個人開発の案出し・選択 | 18 | 案を並べて、どれにするかを選んでもらう |
| 実機確認・操作手順 | 7 | この記事の本題。チェック付きの作業票 |
| 顧客との共有 | 4 | 作業計画の表(WBS)や提案 |
| 出品文の下書き | 3 | 見た目ごと確認したい文面 |
| その他 | 4 | 設定の見直し・コマンドの早見表など |
意外だったのは、一番多いのが「選んでもらう」用途だったことです。案をA・B・Cと文章で並べる代わりに、絵と短い説明を並べたページにしています。ターミナルの文字だけでは比べにくい案ほど、ページのほうが選びやすくなります。
作業計画のように更新が続くものは、進むたびに同じURLへ公開し直します。開いている人は、その場で更新を見られます(公式の仕様)。
社外の人に見せるときは、公開範囲に注意が要ります。 公式ドキュメントでは、組織内の特定の人だけに見せる共有はTeam・Enterpriseプランの機能です。個人プランで社外の相手に渡すと、リンクを知っている人なら誰でも見られる公開リンクになります。顧客の情報を載せるページは、この前提で中身を決める必要があります。
6. 業務での線引き
最後に、どこまでをアーティファクトにするかの判断基準です。
- アーティファクトにする:人が画面の前で順番に操作するもの(実機確認、移行作業の手順、納品前の確認表)。選んでもらうもの
- ファイルのままにする:記事、READMEなどコードと一緒に管理するもの、正本として残す記録
- アーティファクトに頼らない:結果の保存。私の作りではチェックの状態がブラウザにしか残らないので、結果は必ず会話かファイルに戻す
私の環境では、手順書の課題は書き方より先に、読む人の手元に届く形になっていないことでした。URL1本で開けて、判断基準と持ち帰るものが書いてある。手順書に必要なのは、まずこの形です。
別のPCでの確認や引き継ぎで、説明の往復が増えていませんか。今の手順書と、困っている箇所をテキストで送っていただければ、組み直し方からご提案します。
関連記事
- 引き継ぎ手順書が伝わらない原因と直し方──読む人が詰まる3つの言葉
- ブラウザ操作を記録して手順書を作るChrome拡張──CSVで同じ登録を一括入力する
ママゴトラボは、業務の自動化ツールを「何を作るか」を決めるところ(要件定義)から設計してつくる開発ラボです。
属人化した業務の見える化から、自動化ツールの開発・保守まで承っています。
👉 ママゴトラボ|業務自動化の開発ラボ
その業務、自動化できるかもしれません
「毎回手でやっている作業」を、「何を作るか」を決めるところ(要件定義)から見直してツールにします。GAS・Python・VBAでの自動化のご相談を承っています。
クラウドワークスで相談する →