コンテンツにスキップ

Claude CodeでWebアプリのユーザーアカウント管理を始める

⚠️ このハンズオンは作り替えの途中です。2026-10-29 にプロンプトを新しい形にした。画面の画像は前の版のもので、差し替える予定。

この記事では、メールアドレスもパスワードも使わないアカウント管理を作る。ランダムな鍵(ログインキー)をひとつ発行して、それを持っている人を本人とみなす、いちばん軽い方式。

題材は「みんなの寄せ書き」。同じ寄せ書きを、パスキー(PKA)、ソーシャルログイン(SOL)、メールに届くリンク(MLA)でも作っている。違うのは本人確認の方法だけで、アプリは同じ。

付箋のようなカードで寄せ書きが並び、その下に名前と一言の入力欄がある画面

完成イメージ(前の版の画面)。書いた一言が付箋のように並ぶ

Cloudflare Workers と D1 だけで作り、外部のサービスは使わない。無料プランの範囲で動く。

ログイン方式の選び方は AUM にまとめてある。特定の少人数に使わせるなら、合言葉(BAU)か Cloudflare Access(CFA)で足りる。この記事は、不特定多数が登録して使うアプリ向けの方式の1つ。

方式本人確認を任せる先使う人に求めるもの記事
ログインキー本人が保管する文字列文字列を自分で保管することこの記事
パスキー本人の端末対応した端末PKA
ソーシャルログインGoogle などのサービスGoogle などのアカウントSOL
メールに届くリンク本人のメールメールアドレスだけMLA

前提として、D1W で Worker と D1 を一度使ったことがあるものとする。D1 の作成やデプロイの流れはそちらで説明しているので、この記事では認証の部分に絞る。

名前と一言を書くと、みんなの寄せ書きに並ぶ。閲覧はだれでもでき、書き込みと編集はログインキーを持っている本人だけができる。

  • 初めて書く人に、ログインキーを1つ渡す
  • 別の端末でもキーを入れれば、同じ自分として続けられる。キーを渡すリンクも作れる
  • キーが漏れたかもしれないときは、本人が作り直せる

1-2. 3つの「名前」を分けて考える

Section titled “1-2. 3つの「名前」を分けて考える”

各利用者は、役割の違う3つの識別子を持つ。

識別子役割秘密か
内部の主キーデータベースが内部で使う、変わらない ID。寄せ書きと本人を結びつける秘密ではない(が、むやみに見せない)
表示名寄せ書きに出る名前。本人が決める公開
ログインキー本人であることの証明。これを持つ人が本人秘密。他人に渡さない

ログインキーは、表示名でも主キーでもない。合言葉(パスワードのランダム版)であって、データベースの行を指す ID とは別のもの。そのため、キーはサーバーにそのまま保存せず(ハッシュにする)、URL やログに出さない。漏れたら、表示名や寄せ書きを残したまま、キーだけを作り直せる。

表示名を変えても寄せ書きが同じ人のものとして残るのも、この分け方による。表示名で結びつけていたら、名前を変えたときに過去の寄せ書きと切り離される。

この方式は、メールもパスワードも要らない代わりに、はっきりした弱点がある。キーが漏れたら、その人になりすませる(だれが使ったかも分からない)。キーは本人も覚えられないので、保管も本人まかせになる。

そのため、向くのは漏れても致命的でない情報を扱うアカウントに限る(寄せ書き、アンケートの回答、趣味の記録など)。強いのは「推測されない」ことであって、「漏れない」ことではない。

もう1つ、どれくらいの頻度で使うサービスかで向き不向きが分かれる。ログインキーは端末の localStorage に置くが、ここは永続的な保存場所ではない。iPhone・iPad のブラウザ(Safari も Chrome も中身は同じ WebKit)と Mac の Safari は、そのサイトを7日ほど開かないでいると中身を消す(→ ブラウザに保存したデータは消える)。

週に何度も開くサービスならキーは実質消えないが、年に数回しか使わないサービスでは、次に開いたときには消えていることが多い。そのとき頼れるのは本人が控えたキーだけで、この方式には復旧の手段がない。作る側にできるのは保存を促すところまで。

年に数回しか使わないサービスなら、この方式は選ばない。メールに届くリンクやソーシャルログインのように、本人確認の手段をアプリの外に持つ方式にする。

作業フォルダ・D1 データベース・Worker に付ける名前の元になるベース名を決めて、作るものの仕様と一緒に AGENTS.md に書いてもらう。この記事では yosegaki-key を例に使う。

新しく作った作業フォルダ ~/claude/yosegaki-key を Claudeデスクトップアプリで開く。

プロンプト
このプロジェクトのベース名と、これから作るアプリの仕様を、以下のとおり AGENTS.md に書いてください。CLAUDE.md からは AGENTS.md を読み込むようにしてください。
====
## 名前
- ベース名は yosegaki-key
- アプリ名・Worker 名・作業フォルダ名 = ベース名
- D1データベース名 = ベース名のうしろに -db を付けた名前
## 作るもの:みんなの寄せ書き
- 名前と一言を書くと、みんなの寄せ書きに並ぶ
- 1人1件。あとから自分の分だけ編集できる
- 表示名は本人が決める。あとから変えられる
- 閲覧は誰でもできる。書き込みと編集は本人だけ
- 画面は上から「みんなの寄せ書き」の一覧、「あなたの寄せ書き」の入力欄、の順に並べる
- 寄せ書きは付箋のようなカードを並べ、本文の下に右寄せで名前を出す
- ログアウトと、アカウントの削除(自分の寄せ書きも消える)ができる
## ログイン
- 本人確認はログインキーで行う。メールアドレスもパスワードも使わない
- 別の端末でも使えるように、ログインキーを渡すリンクを作れる
- キーが漏れたかもしれないときに、本人がキーを作り直せる
- 発行したキーは、ブラウザのパスワード保存機能にも保存できるようにする

yosegaki-key を自分のベース名に置き換えて渡す。ベース名はそのまま公開 URL(https://yosegaki-key.<アカウント>.workers.dev)になる。

ログインの節の2行目から4行目は、作ってほしい機能の行。安全のために足した行は無い。何も足さなくても、キーをハッシュで保存する、URL に載せない、といった安全策は Claude Code が入れた(3-1)。

仕様は、ほかの3つの記事と同じ。自分のアプリを作るときは、「作るもの」の節を差し替える。

仕様が書けたら、まとめて作ってもらう。

プロンプト
AGENTS.md の仕様のとおりに、寄せ書きアプリを作って。D1 データベースがまだ無ければ作って。
作ったら、ローカルで動かして、ブラウザで開いて、ログインして寄せ書きを書けるところまで確かめて。

2行目は、作ったものを Claude Code 自身に試させるための行。「ブラウザで開いて」があると、画面を実際に操作して確かめる。試したときは、すでに開いているタブでキーを渡すリンクを開くとキーが取り込まれない不具合を、Claude Code が自分で見つけて直した。

この章のプロンプトを決めるときに、Claude Code(Sonnet 5.5)に、ログインの節を1行だけにした仕様から作らせた。安全のための作りは、次のものが入った。

安全策何を防ぐか
キーは長い乱数で作る(256ビット)キーを推測して当てられること
サーバーにはキーのハッシュだけを保存するデータベースが漏れたときに、キーが出ること
キーは URL ではなく、リクエストのヘッダで送るサーバーやネットワークの途中の記録(アクセスログ)にキーが残ること
キーを渡すリンクは #key= の形にし、開いたらアドレスバーから消す# から後ろはサーバーに送られないので、リンクを開いてもログにキーが残らない
発行したキーは1回だけ見せて、保存を促す保存しないまま、ログアウトやブラウザの削除でキーを失うこと
キーをレスポンスやログに出さない(発行時の1回を除く)ログや画面から漏れること

何も足さなくても、これまでの記事でプロンプトに書いていた安全策がそろった。仕様に足した3行(リンク・作り直し・パスワード保存)は機能の行で、どれも1行で記事の機能どおりに入った。

プロンプト
本番に公開して。D1 の表を本番にも作って。

公開すると、https://yosegaki-key.<アカウント>.workers.dev の形の URL が出る。

公開した URL を開いて、表示名を入れて始める。キーが表示されたら保存しておく。

確かめることやり方こうなればよい
別の端末で同じ自分になれるシークレットウィンドウで開き、キーを入れる自分の寄せ書きを編集できる
リンクで渡せるキーを渡すリンクを、別の端末(またはシークレットウィンドウ)で開く同じ自分になり、アドレスバーからキーが消える
表示名を変えても自分のまま表示名を変えて保存する寄せ書きが自分のものとして残る
作り直せるキーを作り直し、古いキーで入ってみる古いキーでは入れず、新しいキーでは同じ自分
キーを保存していない下のプロンプトでデータベースの中を見るキーそのものが出てこない

データベースの中は、Claude Code に見てもらう。

プロンプト
本番の D1 の中身を見て、ログインキーがそのまま保存されていないか確かめて。

パスワード保存機能の提案が出るかは、ブラウザによって違う。出ないブラウザもあるので、コピーやリンクで控える方法も残しておく。

  • キーそのものはサーバーに無いので、データベースが漏れてもキーは出ない
  • キーは推測では当たらない。256ビットの乱数は、毎秒1兆回試しても全部試し終わらない
  • キーが漏れたら、その人になりすませる。気づいたら作り直す。ただし、漏れたキーを手にした人が先に作り直すと、本人のほうが締め出される。漏れても致命的でない情報に限って使う前提での割り切り
  • キーをなくして、どの端末にも残っていなければ、その人には戻れない。作り直しは、いまログインしている本人が鍵を差し替える操作で、なくした人を戻す操作ではない
  • キーは localStorage にあるので、ページに不正なスクリプトが入り込むと読まれる。画面の表示で、利用者が書いた文字をそのまま HTML として扱わない作り(Claude Code は textContent で表示した)が前提になる

ここまでできると、次のような発展が同じ仕組みで作れる。

  • マイページ:自分の寄せ書きだけを一覧する画面。寄せ書きを本人に結びつけてあるので、そのまま作れる
  • 1人1件をやめる:何度でも書けるようにして、それぞれを本人だけが編集・削除できるようにする。掲示板に近づく

この方式の弱点(漏れたら終わり、なくしたら戻れない、たまにしか使わないサービスには向かない)が気になるなら、ほかの方式に替える。

  • パスキー:端末の指紋・顔・PIN でログインする。漏れる合言葉が無く、回復用コードも持てる → PKA
  • ソーシャルログイン:Google などに本人確認を任せる → SOL
  • メールに届くリンク:メールを受け取れることで本人を確かめる → MLA

ログインキーの方式で作るときの要点(キーはハッシュで保存する、ヘッダで送る、リンクは #key= にする、発行したキーの保存を促す、など)は、Claude Code のスキル uuid-key-auth にまとめてある。入れ方は AUM の6章にある。

  • 2026-10-29 に、工程ごとのプロンプト(データベース・API・画面を順に頼む形)から、仕様を書いて作ってもらう形に作り替えた。あわせて Cloudflare Pages Functions から Workers に移した
  • 3章のプロンプトは、Sonnet 5.5 で試した。この記事を書くときに試したのはローカルまでで、作るたびに細かい作りは変わる
  • キーを渡すリンク(#key=)は、すでにそのサイトを開いているタブで開くと、# から後ろが変わるだけでページが読み込み直されない。作りによってはキーが取り込まれない。別の端末で開く本来の使い方では起きない
  • localStorage はオリジンごとに分かれる。プレビュー用の URL は本番と別のオリジンなので、キーも別になる。案内は本番の URL で