はじめに
Claude Code に頼めば、サーバを用意しなくても、HTML 1 ファイルで動く社内ツールを作って配れます。このやり方が X で話題になっています。発端は次の投稿です。
Claude CodeでHTMLアプリを作って社内に配布するというのに慣れると、もはやサーバとかサーバレスにアプリをデプロイするという思想がなくなる。いかに単一HTMLファイルに機能を集約してモノリスにできるかの勝負になって、マイクロサービスという考え方ではなくなる。要らなくなったら捨てるのみ。
これを引用した中小企業診断士の方の投稿では、中小企業との相性の良さが指摘されています。
ベンダーに見積もりを取って、サーバを契約して、保守費を払い続ける。あの「システム導入の大げささ」が、ファイル1個で消えるかもしれない。
(中略)
CSVの整形や入力チェックみたいな、データを抱えない小さな道具は、捨てる前提で作るくらいがちょうどいい。
道具は軽く。残すのは仕事のほうです。
本記事では、この「単一 HTML ファイルで配る」アプローチがなぜ成り立つのか、どんな道具に向いていて何に向かないのか、Claude Code で作るときに何を指示すればよいのかを整理します。最後に、API サーバがある構成への応用と、使う人もエージェントを使う場合に Git でソースを受け渡す方法も考えます。
用語の整理
| 用語 | この記事での意味 |
|---|---|
| 単一 HTML アプリ | HTML・CSS・JavaScript を 1 つの .html ファイルにまとめ、ブラウザで開くだけで動く道具 |
| 配布 | 共有ドライブ・チャット・メール添付などでファイルそのものを渡すこと。サーバへのデプロイは伴わない |
| データを抱えない道具 | 入力を受け取って変換・検査し、結果を返すだけで、データを保存し続けない道具 |
| CDN | ライブラリなどをインターネット経由で配信する仕組み。HTML から <script src="https://..."> で読み込む |
| BOM | ファイルの先頭に付ける目印。Excel が CSV を UTF-8 だと判別するのに使う |
file:// | 共有ドライブやデスクトップの HTML をダブルクリックで開いたときの URL の形。Web サーバから配信されたページ(https://)とは扱いが異なる |
| SPA | Single Page Application。React などで作る、ブラウザ側で画面を組み立てる Web アプリ。データは API サーバから取得する |
| アトミックな API | 1 回の呼び出しで 1 つの操作を完結させ、途中で失敗したら何も変えない API |
| Tauri | ローカル環境(ファイルやほかのプログラム)にアクセスできるデスクトップアプリを作る基盤。画面は HTML/JavaScript で作る |
| PR | プルリクエスト。Git リポジトリへの変更を、取り込む前にレビューしてもらう仕組み |
| ロックファイル | 使うライブラリの版を正確に記録したファイル。どの PC でも同じ版でビルドするために使う |
| 不変条件 | どんな操作の後でも成り立っていなければならない業務上の条件(承認済みの申請は編集できない、在庫はマイナスにならない、など) |
なぜ単一 HTML なのか
「システム導入」に必要だったものが要らなくなる
社内向けの小さな道具でも、Web アプリとして作るなら従来は次のものが必要でした。
- 実行環境(サーバ、サーバレス基盤、コンテナ)
- ドメイン・証明書・認証
- デプロイの仕組みと、それを保守する担当者
- 月々のインフラ費用と保守契約
単一 HTML アプリでは、実行環境は利用者のブラウザです。インストールもデプロイも不要で、ファイルをダブルクリックすれば動きます。サーバが無いので、止まる心配も、パッチを当て続ける必要もありません。
作るコストが下がったので「捨てる前提」が成り立つ
この方式自体は昔からありましたが、HTML・CSS・JavaScript を 1 ファイルに書き切るのは、非エンジニアには敷居が高い作業でした。Claude Code のようなコーディングエージェントに「1 ファイルで完結させて」と頼めば、その部分を任せられます。
作り直すコストが下がると、道具に対する考え方が変わります。
- 仕様が変わったら、直すより作り直すほうが速いことがある
- 使われなくなったらファイルを消すだけで廃止が終わる
- 部署ごとに少しずつ違う版があっても、サーバ側の整合性を気にしなくてよい(ただし、どれが最新版かは分かりにくくなります。後述の「版の管理」を参照)
元の投稿が、マイクロサービスではなくモノリスだと言っているのは、この性質を指しています。分割して組み合わせるのではなく、1 つの用途に 1 つのファイルを割り当てます。用途が終われば捨てる、という単位の取り方です。
単一 HTML アプリに向く道具・向かない道具
判断の軸は「データを抱えるかどうか」と「複数人で状態を共有するかどうか」です。
| 観点 | 向いている | 向かない |
|---|---|---|
| データの扱い | 入力 → 変換 → 出力で完結する | データを蓄積・検索し続ける |
| 利用者の関係 | 各自が手元で使う | 複数人が同じデータを同時に更新する |
| 外部連携 | 不要、またはファイルの読み書きだけ | 社内 DB や外部 API を毎回叩く |
| 秘密情報 | 持たない | API キーや DB のパスワードを埋め込む必要がある |
向いている例
- CSV の列の並べ替え・文字コード変換・全角半角の統一
- 入力値のチェック(郵便番号・電話番号・法人番号の桁数など)
- 見積もりや按分の計算シート
- 定型文やメール文面の組み立て
- JSON・YAML の整形や差分表示
向かない例
- 顧客台帳や在庫管理のように、他の資料の基準になる元データを持つもの
- 承認フローのように、複数人の操作の順序に意味があるもの
- 外部サービスの API キーが必要なもの(HTML に書いた時点で、ファイルを受け取った全員に見えます)
ただし、これらは「単一 HTML だけでは向かない」という意味です。バックエンドを足せば、「フロントは作り直せる・捨てられる」という考え方のまま、扱える業務を広げられます(後述の「API がある構成への応用」を参照)。
Claude Code に単一 HTML アプリを作らせるプロンプト例
単一 HTML アプリを作らせるときは、最初に制約をはっきり伝えるのがコツです。たとえば次のように指示します。
CSV を読み込んで、指定した列だけを残し、文字コードを UTF-8(BOM 付き)にして
ダウンロードできる道具を作ってください。
制約:
- 1 つの index.html で完結させる(CSS と JavaScript もインラインで書く)
- 外部の CDN やライブラリを読み込まない。ネットワークが無くても動くこと
- データはブラウザの外に送らない。サーバへの通信を一切しない
- ファイルの読み込みは <input type="file"> とドラッグ&ドロップで行う
- 入力の CSV は UTF-8 と Shift_JIS の両方がありうる
- 結果はファイルとしてダウンロードさせる
- 画面の文言は日本語
「外部 CDN を使わない」は重要です。CDN からライブラリを読み込む作りにすると、社外のネットワークに出られない端末では動きません。また、CDN 側の変更の影響も受けます。どうしてもライブラリが必要なら、ファイルの中に埋め込ませます。
「社内の CSV は Shift_JIS が多い」といった事情も、最初の指示に書いておくとやり直しが減ります。
最小構成の例: CSV 列抽出ツール(HTML + JavaScript)
上の指示から生成される道具の骨格を、説明用に簡略化すると次のくらいの分量です(入力は UTF-8 のみ対応)。
<!doctype html>
<html lang="ja">
<head>
<meta charset="utf-8">
<title>CSV 列抽出ツール</title>
<style>
body { font-family: sans-serif; max-width: 40rem; margin: 2rem auto; }
#drop { border: 2px dashed #888; padding: 2rem; text-align: center; }
</style>
</head>
<body>
<h1>CSV 列抽出ツール</h1>
<div id="drop">ここに CSV をドロップ、または <input type="file" id="file" accept=".csv"></div>
<p>残す列(カンマ区切りの列名): <input id="cols" placeholder="氏名,メール"></p>
<button id="run" disabled>変換してダウンロード</button>
<script>
let rows = [];
// 簡易パーサ(ダブルクォート内のカンマ・改行に対応)
function parseCSV(text) {
const out = []; let row = []; let cell = ""; let q = false;
for (let i = 0; i < text.length; i++) {
const c = text[i];
if (q) {
if (c === '"' && text[i + 1] === '"') { cell += '"'; i++; }
else if (c === '"') q = false;
else cell += c;
} else if (c === '"') q = true;
else if (c === ",") { row.push(cell); cell = ""; }
else if (c === "\n") { row.push(cell.replace(/\r$/, "")); out.push(row); row = []; cell = ""; }
else cell += c;
}
if (cell || row.length) { row.push(cell); out.push(row); }
return out;
}
const toCSV = (rs) => rs.map(r => r.map(v => /[",\r\n]/.test(v) ? `"${v.replace(/"/g, '""')}"` : v).join(",")).join("\r\n");
async function load(file) {
rows = parseCSV(await file.text());
document.getElementById("run").disabled = rows.length === 0;
}
document.getElementById("file").addEventListener("change", e => load(e.target.files[0]));
const drop = document.getElementById("drop");
drop.addEventListener("dragover", e => e.preventDefault());
drop.addEventListener("drop", e => { e.preventDefault(); load(e.dataTransfer.files[0]); });
document.getElementById("run").addEventListener("click", () => {
const want = document.getElementById("cols").value.split(",").map(s => s.trim()).filter(Boolean);
const idx = want.map(name => rows[0].indexOf(name)).filter(i => i >= 0);
if (idx.length === 0) { alert("指定した列名が見つかりません"); return; }
const result = rows.map(r => idx.map(i => r[i] ?? ""));
// 先頭に BOM を付けて、Excel で開いても文字化けしないようにする
const blob = new Blob(["\uFEFF" + toCSV(result)], { type: "text/csv;charset=utf-8" });
const url = URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = "extracted.csv";
a.click();
// クリック直後に解放するとダウンロードに失敗するブラウザがあるので、少し待つ
setTimeout(() => URL.revokeObjectURL(url), 1000);
});
</script>
</body>
</html>
ポイントは 3 つです。
- 読み込みは
<input type="file">とドラッグ&ドロップ。File.text()で中身を読むので、ファイルはブラウザの外に出ません - 書き出しは
Blobを作ってダウンロードリンクをクリックさせるだけ。サーバは要りません - 外部依存はゼロ。ファイル 1 つをコピーすれば、どの PC でも同じように動きます
なお、この例の File.text() は常に UTF-8 として読みます。Shift_JIS の CSV を扱うなら、await file.arrayBuffer() で読んだ中身を new TextDecoder("shift_jis").decode(...) で文字列にします。
社内配布するときの注意点
サーバが無いぶん、気を付けるところはサーバ側からファイル側に移ります。
版の管理
ファイルがコピーされて広がるので、どれが最新か分からなくなりがちです。
- 画面の隅に版数と更新日を表示させる
- 置き場所を 1 か所(共有ドライブの特定フォルダなど)に決め、そこから開いてもらう
- ソースは Git で管理する(作り直すときに、Claude Code に前の版を読ませられる)
使う人もエージェントを使うなら、ファイルではなく Git リポジトリで受け渡す方法もあります。そうすれば、この問題は仕組みで解決できます(後述の「使う人もエージェントを使うなら — Git でソースを受け渡す」を参照)。
file:// で開いたときの制約(fetch・localStorage)
ダブルクリックで開いた HTML は file:// のページになり、Web サーバから配信されたページとは扱いが異なります。
fetch()で同じフォルダの別ファイルを読む処理は、現行の主要ブラウザではほぼ失敗しますlocalStorageに設定を保存する処理も、ブラウザによって挙動が一定しません
必要なものはすべてファイル内に入れ、データは利用者に毎回選んでもらう作りにしておくのが無難です。
「野良ツール」にしないために
手軽に作れるぶん、誰が作ったか分からない道具が増えるリスクもあります。作者が異動して誰も直せない Excel マクロが社内に残る、という問題と同じです。
- 作成者・問い合わせ先・用途をファイル内(画面かコメント)に書いておく
- 業務の元データを扱う用途には使わない、という線を引いておく
- 社内で配る前に、ブラウザの開発者ツールの[ネットワーク]タブを開いたまま操作し、外部への通信が 1 件も出ないことを確かめる
API がある構成への応用 — 業務ロジックはできるだけフロントに
ここからは、単一 HTML の外側の話です。
複数人でデータを共有するなら、サーバは必要です。では、API サーバ + React などの SPA という構成になったら、この考え方は捨てるしかないのでしょうか。そうではありません。前半で見た「作り直せるから捨てられる」という性質は、業務ルールを正本(基準となる唯一の原本)として扱うことで、API がある構成にも持ち込めます。形としては、業務ロジックはできるだけフロントエンド(以下、フロント)で実装するということです。
正本はコードではなく業務ルール
Claude Code のようなエージェントでソフトウェアを作るとき、業務ロジックは、エージェントに渡す業務ルールそのものです。業務ルールを正本にし、コードはそこから生成するものと考えれば、用途ごとにフロントがいくつあっても困りません。どれも同じルールから生成した成果物にすぎず、要らなくなれば捨てて、必要になれば作り直せます。後で述べるバックエンドの検査も、同じ業務ルールから導きます。
業務ロジックをフロントに置くと、画面ごとに実装が散らばって保守できなくなる。そんな心配が出るのは、コードを正本とみなしているからです。ルールが正本なら、直す対象はルールで、実装は作り直せばよいので、この心配は小さくなります。残るのは「作り直したものが正しいか」の確認で、これは後の「正しさは境界条件とテストで決める」で扱います。
バックエンドは権限と不変条件を守るアトミックな API にする
ブラウザで動くコードは、利用者が開発者ツールで書き換えられます。そのため、共有データを守る役目はバックエンドに残します。ここで大事なのは、バックエンドをアトミックな API の集まりとして小さく保つことです。
各 API は、呼び出しのたびに次の 2 つを自分で検査します。
- 権限: この人がこの操作をしてよいか
- 状態に対する前提条件(不変条件): いまこのデータに対して、この操作をしてよいか(承認済みは編集不可、在庫を超えて引き当てない、など)
権限だけでは足りません。正当な利用者でも、API を想定外の順番で呼べば不変条件を壊せるからです。どの順番で呼ばれても壊れない API にしておけば、API の組み合わせ方、つまり業務フローはフロントに任せられます。
| 置き場所 | 持つもの |
|---|---|
| バックエンド(アトミックな API) | 権限、不変条件、整合性。どの順番で呼ばれても壊れないこと |
| フロントエンド | 業務フロー、API の組み合わせ方、画面ごとの業務ロジック |
この分担は、業務ルールが変わったときにも効きます。ルールが変われば、どのみちソフトウェアの改修は必要です。それでも、用途ごとに作ったフロントのうち更新し忘れたものが新しい API を呼んだ場合、API が検査している不変条件に反する操作は拒否されます。
ただし、拒否されるのは API が検査している範囲だけです。たとえば古いフロントが変更前の単価で計算した金額を送ってきても、API が金額の妥当性を検査していなければ、そのまま通ってしまいます。単価や税率のように結果を左右するルールは、API 側でも検査する(または API 側で計算する)不変条件に含めておく必要があります。
反対に、バックエンドを持たない単一 HTML アプリでは、拒否してくれる相手がいません。税率や単価のようなルールをファイルの中に持っていると、古いコピーは古い計算をし続けます。前述の「版の管理」が欠かせないのはこのためです。
正しさは境界条件とテストで決める
LLM は、同じルールからでも生成のたびに少しずつ違う実装を出します。しかし、これは人間が書く場合も同じです。A さんと B さんが同じ仕様から書いたコードは違うものになりますが、どちらも正しく動く必要があります。
つまり、実装が違っても正しく動くように、境界条件とテストを業務設計の段階で決めておくことが必要です。これは LLM 特有の問題ではなく、業務設計の責任です。
違いがあるとすれば頻度です。フロントを使い捨てにすると作り直す回数が増えるので、テストは「たまに回すもの」から「作り直すたびに必ず通すもの」になります。テストが実質的な契約になる、ということです。
単一 HTML アプリとの関係
整理すると、単一 HTML アプリは、この構成からバックエンドを取り除いた特殊な場合にあたります。
| 構成 | バックエンド | フロントエンド |
|---|---|---|
| 単一 HTML アプリ | なし(共有データを持たない) | 業務ロジックのすべて |
| API + SPA | 権限と不変条件を守るアトミックな API | 業務フローと画面ごとの業務ロジック |
どちらも、業務ルールを正本にし、フロントはそこから生成して捨てられるようにする、という点で同じ考え方です。
使う人もエージェントを使うなら — Git でソースを受け渡す
単一 HTML をファイルで配るという話は、AI を使って作る人と、AI を使わずに道具を使うだけの人が分かれている、という前提に立っています。使う人の PC にあるのはブラウザだけなので、「ファイル 1 個を渡せば動く」単一 HTML が最も手軽でした。
しかし、使う人もみな AI エージェントを扱うようになれば(今後はそうなっていくはずです)、この前提は変わります。作った道具は、ファイルではなく Git リポジトリのソースとして受け渡せばよいからです。
Git で受け渡すと解決すること
前半の「社内配布するときの注意点」で挙げた課題の多くが、仕組みで解決します。
- 版の管理: どれが最新かは
mainブランチを見れば分かる。誰がいつ何を変えたかも履歴に残る - 野良ツール化: 作成者と変更の経緯がリポジトリに残る。push できる人を限り、変更を PR でレビューすれば、ファイルを回すよりも統制が効く
- 配り直しと回収:
git pullしてビルドし直すだけ。要らなくなればリポジトリを消せば終わる file://の制約: 手元でhttp://localhostのローカルサーバから開くようにすれば、file://特有の制約を避けられる
使う人がビルドや起動の手順を覚える必要もありません。手元のエージェントに「最新にして起動して」と頼めば済みますし、ビルドが失敗したときの対応も任せられます。これまで非エンジニアには無理だった部分を、エージェントが肩代わりするわけです。
HTML か Tauri かは、ローカルにどこまで触るかで選ぶ
ソースで受け渡すなら、1 ファイルにまとめる必要もありません。「ファイル 1 個で配れる」という単一 HTML の利点は、決め手ではなくなります。AI に作らせるので、HTML のほうが作りやすいということもありません。選ぶ基準は、ローカル環境にどこまで触る必要があるかだけになります。
ブラウザでも、利用者が操作してファイルを選ぶ範囲なら、かなりのことができます。
<input type="file" multiple>やドラッグ&ドロップで、複数のファイルを読める。Excel もブラウザ内で動くライブラリ(SheetJS など)で読める- File System Access API の
showDirectoryPicker()で、利用者が選んだフォルダを読み書きできる。ただし対応しているのは Chrome・Edge などの Chromium 系ブラウザだけ
一方、次のような道具なら、Tauri のほうが向いています。Tauri は、ローカル環境にアクセスできるデスクトップアプリの基盤です。
- 決まったフォルダの複数の Excel ファイルを、毎回フォルダを選ばずにまとめて読み書きする
- 利用者の操作なしに処理する(毎朝の自動処理、フォルダの監視など)
- Excel 本体や Python など、ローカルのプログラムと連携する
Tauri で作ったアプリも、業務ルールを正本にしておけば、HTML と同じように捨てて作り直せます。ビルドしたアプリ(バイナリ)を配る場合は、OS ごとのビルドや署名が要ります。署名が要るのは、macOS の Gatekeeper などが、インターネットからダウンロードしたアプリを厳しく検査するからです。ソースを受け渡して各自の PC でビルドしたアプリはダウンロードしたものではないので、配る側の署名の手間はほぼかかりません。
受け渡し方ごとに整理すると、次のとおりです。
| 受け渡し方 | 使う人の PC に要るもの | 配り直し・回収 |
|---|---|---|
| 単一 HTML をファイルで渡す | ブラウザだけ | 手作業(版の管理が課題) |
| ビルドしたアプリを配る | なし | OS ごとのビルド、署名、更新の仕組みが要る |
| Git でソースを渡す(HTML でも Tauri でも) | 開発環境とエージェント | git pull してビルド、不要なら削除 |
前提として整えるもの
その代わり、使う人の PC を開発環境として整えておく必要があります。
- ツールチェーン: HTML なら Git とエージェントがあれば足りる。Tauri なら Rust と OS ごとのビルド環境が要り、JavaScript のフロントエンドを使うなら Node.js も要る。入れるのは最初の 1 回だが、開発者以外の PC に入れてよいかは会社の方針で決める
- ビルドの再現性: PC ごとに環境が違うので、ロックファイル(
Cargo.lock、package-lock.json)をコミットして依存の版を固定する - リポジトリへの信頼: 各自が手元でビルドして実行するので、リポジトリの中身が信頼できるかどうかが、そのまま安全性を左右する。push 権限とレビューの運用を、バイナリの署名の代わりと考える
作る人と使う人が分かれているうちは、単一 HTML をファイルで配るのが手軽です。みながエージェントを使うようになれば、前提を整えたうえで Git で受け渡すほうが、版の管理や回収の面で有利です。そのときは、道具の中身に合わせて HTML でも Tauri でも選べます。
まとめ
- 単一 HTML アプリは、実行環境を利用者のブラウザに任せることで、サーバ・デプロイ・保守費をまとめて不要にする
- Claude Code で作り直すコストが下がったことで、「直して使い続ける」より「作り直す・捨てる」が現実的な選択肢になった
- 向いているのは、データを抱えず、各自が手元で使い、秘密情報を持たない小さな道具
- 作らせるときは「1 ファイルで完結」「外部 CDN 禁止」「通信しない」を最初に伝える
file://で開く前提で、必要なものはすべてファイル内に入れる- 配るときは版数の表示・置き場所の一本化・作成者の明記で、野良ツール化を防ぐ
- 共有データが要るなら、バックエンドは権限と不変条件を守るアトミックな API に絞り、業務ロジックはできるだけフロントに置く
- フロントの正しさは、業務ルールの境界条件とテストで決める
- 使う人もエージェントを使うなら、Git でソースを受け渡せば、版の管理も配り直しも仕組みで解決できる
- その場合、HTML か Tauri かはローカル環境にどこまで触るかで選ぶ
引用した投稿の言葉を借りれば、「道具は軽く。残すのは仕事のほう」です。システムを導入するかどうかを迷う前に、まずファイル 1 個で済まないかを考えてみる価値はありそうです。