海外の部品集で、Claude に社内の管理画面を作らせた。つまずき7つを自分で報告してきた
「佐藤 健一」のしるしが「佐健」に。AI は画面を見て直し、つまずき7つを一覧で報告してきた。
この記事で分かったこと
- 海外の部品集を日本語で使うと、小さなずれが出る「佐藤 健一」さんのしるしが「佐健」になった。AI が自分で画面を見て気づき、「佐」に直した
- 「正直に報告して」と頼むと、つまずきが一覧で返る7つ返ってきた。日本語のずれが1つ、できたての道具らしい所が4つ、安全の確かめが2つ
- 止まった自動の処理を、読んでから判断した部品集を取り寄せたときに止まった処理。中身を読み、動かさないと決めた
- 部品集を使うと、時間は約2倍4分0秒と1分52秒。できたファイルは 1.3MB と 236KB。画面1つ、1回ずつの記録
「佐藤 健一」さんの名前の横に出る丸いしるしが、「佐健」になっていました。海外の会社が作った「画面の部品集」で、AI に社内の画面を作らせたときのことです。
AI は、できた画面を自分で開いてこれに気づき、直していました。この記事は画面を作る人向けですが、 プログラムを書かない人にも役に立つ話が2つあったので、そこを中心に書きます。

頼んだのは、工事の予定を見る画面を1つ
舞台は、架空の会社「みなと設備」です。水道や空調の工事の予定を、社内で見る画面を頼みました。
- 上に、今週の件数などの数字を4つ
- その下に、工事の一覧を10件(日付、現場、担当、内容、状態)
- 右に、今日の担当の一覧
- 状態(予定、作業中など)で絞りこめること
「部品集」は、ボタン、表、カードといった画面の部品を、ひとそろいにしたものです。同じ部品で組めば、だれが作っても同じ見た目になります。作る人のあいだでは「デザインシステム」と呼ばれます。
使わせたのは、Meta が GitHub で公開している Astryx(アストリクス)という部品集です。試したのは 0.7.12 という版で、まだ 1.0 になっていません。付いてきた説明書には、「AI と一緒に作るなら」という案内がありました。
同じ注文で、2回やりました。
Astryx の回
- 見た目の部品には Astryx を使って
- 使い方は、取り寄せたものの中の説明で確かめて
- うまく使えなかった所は、正直に報告して
部品集なしの回
- 部品集は使わないで
- 見た目は、自分で書いて
Astryx の回の3つ目の一文が、この記事の主役です。
どちらの画面も、動いた
上が Astryx の部品で組んだ画面、下が部品集なしの画面です。会社も、人の名前も、工事も、すべて架空です。


どちらも、「保留」のボタンを押すと、一覧が保留の工事だけになりました。これは、こちらでも開いて確かめました。
Astryx の画面は、白い地に細い線。大きなサービスの管理画面で見かける、くせのない見た目です。
部品集なしの画面は、AI が自分で決めた見た目です。上に紺の帯を引き、今日の工事の行を薄い黄色にしています。
同じ場所を大きくすると、ちがいがよく分かります。

件数がちがうのは、架空のデータを AI が回ごとに作ったためです。見た目だけを比べてください。

1つの画面だけなら、部品集なしのほうが、目の行く場所がはっきりしていました。これは、こちらの感想です。
日本語の名前を入れたら、しるしが「佐健」になった
ここが、技術者でない人にも覚えておいてほしい1つ目です。
名前の横の丸いしるしは、写真がないときに、名前の頭文字を出す部品です。英語の名前なら、John Doe は「JD」になります。

同じ仕組みに「佐藤 健一」を入れると、名字の1字目と名前の1字目がつながって「佐健」になります。こわれているわけではありません。ただ、日本の会社の画面では見かけない書き方です。
AI は、できた画面を自分で開いて、画像に撮って見ました。そこで気づいています。作業の記録には、こう残っていました。
the avatar initials read oddly (“佐健”) (しるしの頭文字が、変に読める)
AI は、名字だけを部品に渡すように直しました。報告には、こう書いてあります。
「佐藤 健一」が「佐健」と表示されてしまいます。名字だけを渡して「佐」と出るようにしました。
海外で作られた道具を日本語で使うと、こういう小さなずれが出ます。作る人に頼む側も、名前、日付、金額が画面でどう出ているかは、自分の目で見ておく値打ちがあります。
AI が自分の画面を見て直した所は、もう1つありました。

日付の列がせまくて、「今日」のしるしが「今…」と切れていました。AI は列の幅を広げて直しています。
どちらも、プログラムを読むだけでは分からず、画面を見て初めて分かることです。
部品集なしの回は、できた画面を開いていません。AI は報告(英語で返ってきました)に、こう書いています。
I haven’t opened it in a browser, so the look and the filter buttons haven’t been checked by eye yet. (ブラウザでは開いていません。見た目と絞りこみのボタンは、まだ目で確かめていません)
確かめていないことを、確かめていないと書いてきた点はよい所です。ただ、頼む側としては「できた画面を開いて、目で確かめて」と一言足すべきでした。
「正直に報告して」と頼んだら、つまずきが7つ返ってきた
2つ目の学びです。
初めての道具なので、うまくいかない所が出るだろうと考えました。そこで、先に「うまく使えなかった所は、正直に報告してください」と頼んでおきました。
返ってきた報告の、実物です。

7つを、こちらで3つに分けました。

青の4つは、作る人向けの話です。短く書きます。
- 1番:説明書が2つあり、片方に書いてある部品の名前(XDSTheme)が、実物にはなかった。AI は、もう片方の説明書と、付属の道具の説明に合わせた
- 2番:見た目を細かく変える仕組み(StyleX)は、追加の準備が要る。今回は準備をせず、でき上がった部品だけで組んだ
- 3番:付属の道具が勧めてくるひな形は、その準備と、別の部品も入れないと使えない。ひな形は使わず、部品を1つずつ組み合わせた
- 5番:仕上げの変換(ビルド)のときに「ファイルが大きい」と注意が出た。エラーではないので、そのままにした
この一覧があると、あとで人が引きつぐときに、「どこを使っていないか」「どこがあやしいか」から読み始められます。この一文を足さなかったら同じ一覧が返ってきたかは、試していません。
止まった自動の処理を、読んでから「動かさない」と決めた
緑の2つは、安全の話です。作る人でなくても、知っておいてよい所です。
部品集を取り寄せると、その直後に自動で動こうとする処理が付いていることがあります。今回は、取り寄せに使う道具(npm)の安全の仕組みが、それを止めました。

AI は、「止まったから、許可して動かす」とはしませんでした。先に、その処理の中身を開いて読んでいます。報告には、こうあります。
中身は
astryx initを勧めるメッセージを出すだけでした。astryx initは AGENTS.md や CLAUDE.md を書き足すコマンドで、今回は不要なので実行していません。
AGENTS.md と CLAUDE.md は、AI への指示を書いておくファイルです。知らない道具に、そこを書きかえさせなかった、ということです。
6番も同じ向きの判断です。英字の書体は、外のサイトから読みこむ作りでした。AI は「社内画面なので外部への通信を避け」、パソコンに入っている書体で表示しています。
知らない道具が自動でやろうとすることは、読んでから通す。 この順番は、人が作業するときも同じです。
部品集を使った回は、時間が約2倍かかった
2回の比べは、図1枚にまとめます。

Astryx の回は、時間の多くを「使い方を調べる」ことに使っていました。23回の命令のうち13回は、説明を読んで、部品の名前と使い方を調べるものでした。
ファイルが大きいのは、部品集のぶんです。社内で数人が使う画面なら、気にする大きさではありません。
画面が1つだけなら、部品集なしのほうが早くできました。部品集の値打ちは、画面が10、20と増えて、見た目をそろえたくなったときに出るはずです。そこは、画面1つを1回ずつ作っただけの今回の実験では、確かめていません。
気をつけること
| 気づいたこと | 中身 |
|---|---|
| 1回ずつ、画面1つだけ | 同じ注文でもう一度頼めば、組み方も、時間も、つまずきの数も変わる |
| 1.0 になる前の版 | 試したのは 0.7.12。説明書の食い違いは、この時点の話。直っているかもしれない |
| 持ち味の一部は使っていない | 見た目を細かく変える仕組みと、付属のひな形は使わなかった。使えば、結果は変わる |
| 確かめたのは2つだけ | 開いて表示されることと、絞りこみが動くこと。スマホの幅や、キーボードだけでの操作は見ていない |
| 作る人向けの道具 | 使うには、React(画面を組み立てるための、よく使われる仕組み)の知識が要る。プログラムを書かない人が、そのまま使えるものではない |
| 場所をとる | Astryx の回は、取り寄せた部品が 214MB、取り寄せの控えが 301MB、作業フォルダに入った |
自分でやるなら:貼って使える頼み文
初めての道具を AI に使わせるときに、頼みの終わりに足す文です。【 】の所を書きかえてください。部品集にかぎらず使えます。
【使わせたい道具の名前】を使ってください。
使い方は、取り寄せたものの中の説明で確かめてください。
うまく使えなかった所は、正直に報告してください。
できた画面は、自分で開いて、目で確かめてください。
取り寄せのときに自動で動こうとするものは、中身を読んでから判断してください。
画面に出る日本語(人の名前、日付、金額)が、おかしくないかも見てください。
3行目までは、今回じっさいに頼んだ文と同じ中身です。4行目からは、今回の結果を見て足したもので、まだ試していません。
- 「使わなかったもの」「やらなかったこと」が書いてあるか
- 人の名前、日付、金額が、画面でどう出ているか
- AI が、できた画面を自分で開いて確かめたか
- 自動で動こうとしたものを、どう扱ったか
実験の記録
実際に頼んだ文を開く
2回に共通の文です。
架空の会社「みなと設備」の、工事の予定を見る社内の管理画面を、React で作ってください。画面は1つ。上に今週の件数などの数字が4つ、その下に工事の一覧(日付、現場、担当、内容、状態)が10件、右に「今日の担当」の一覧。状態で絞りこめること。データは架空のものを画面の中に直接書いてください。npm run build でビルドが通り、dist/ に出ること。Vite を使ってください。
Astryx の回は、こう続けました。
見た目の部品には、Meta が公開しているデザインシステム Astryx(npm の @astryxdesign/core、@astryxdesign/theme-neutral、@stylexjs/stylex。CLI は @astryxdesign/cli)を使ってください。使い方は、入れたパッケージの中の説明や CLI で確かめてください。うまく使えなかった所は、正直に報告してください。
部品集なしの回は、こう続けました。
見た目の部品のライブラリは使わず、自分で CSS を書いてください。
どちらも、最後にこの文を足しています。
今日は2026年11月10日です。このフォルダの外には何も書かないでください。道具を入れる必要があるときは、このフォルダの中に入れてください。
言葉の説明:Vite は、画面のプログラムを仕上げの形に変換する道具。npm は、部品を取り寄せる道具。CLI は、文字で命令を打って使う道具。CSS は、見た目を決める書き方です。
AI の報告の「うまくいかなかった所」を全文で開く
- 説明書どうしで食い違いがありました。 テーマのパッケージの README には
XDSThemeを使うと書いてあります。ところが実際のパッケージにあるのはThemeでした。core の README と CLI の説明はThemeなので、そちらに合わせました。 - StyleX は、パッケージを入れただけで、自分では使っていません。 自分で StyleX の書き方を使うには、ビルドの設定に StyleX 用の変換の仕組みを足す必要があります。今回はそれをせず、Astryx のでき上がった CSS と部品の設定だけで見た目を作りました。そのため、部品の
xstyleという見た目の調整機能は使っていません。 - CLI が勧めるひな形は使いませんでした。 CLI は
table-filterなどのひな形を勧めてきます。ただ、これには StyleX の変換の仕組みと、別のパッケージ(lucide-react)が必要です。そこで、ひな形は使わず、部品(Layout、Grid、Card、Table、Badge、SegmentedControl、List、Avatar)を組み合わせて作りました。 - アバターの頭文字が日本語の名前に合いませんでした。 「佐藤 健一」が「佐健」と表示されてしまいます。名字だけを渡して「佐」と出るようにしました。
- ビルド時に「ファイルが大きい」という注意が出ます。 JS が約 830KB あるためです。エラーではなく、ビルドは成功しています。
- 英字のフォントは読みこんでいません。 テーマが使う英字フォント(Figtree)は、外部のサイトから読みこむ必要があります。社内画面なので外部への通信を避け、OS に入っているフォントで表示しています。
- インストール時の自動処理は止まりました。 npm の安全のための仕組みで止まりましたが、中身は
astryx initを勧めるメッセージを出すだけでした。astryx initは AGENTS.md や CLAUDE.md を書き足すコマンドで、今回は不要なので実行していません。
2回の数字を開く
| 項目 | Astryx | 部品集なし |
|---|---|---|
| かかった時間 | 4分0秒 | 1分52秒 |
| AI が打った命令 | 23回 | 4回 |
| できたファイル | 1.3MB | 236KB |
| 取り寄せた部品 | 214MB | 39MB |
| AI の利用料の目安 | 約1.12ドル | 約0.36ドル |
使ったモデルは、どちらも claude-opus-5-5 です。ファイルの大きさは、でき上がりのフォルダを 2026年11月11日に測り直した値です。絞りこみが動くことも、同じ日に、2つの画面を開いて確かめ直しました。
- 試したもの
- Meta が公開している画面の部品集 Astryx(0.7.12。1.0 になる前の版)と Claude Code
- 試し方
- 同じ画面を、Astryx の部品で作る回と、部品集なしで作る回で、1回ずつ
- 結果
- どちらも画面ができ、絞りこみも動いた。Astryx の回は、つまずきを7つ報告した
- かかった時間
- Astryx 4分0秒、部品集なし 1分52秒