Claude Codeが選ぶ「HTMLという解」と反論の構図
AIエージェントとの対話形式は、いつのまにかMarkdown一択になっていた。だがAnthropicの内側から「もうMarkdownでは足りない」という声が上がっている。反論も即座に出ている。
Markdownの時代が静かに終わろうとしている
Anthropicでクロード・コード（Claude Code）を担当するタリク・シヒパー（Thariq Shihipar）が、Xに長文記事を投稿した。タイトルは「Using Claude Code: The Unreasonable Effectiveness of HTML」（クロード・コードを使う：HTMLの不合理な有効性）。要旨はシンプルで、AIエージェントへの出力指示はMarkdownではなくHTMLが優れている、というものだ。
公開からわずか数日で表示回数は1,080万を超え、ハッカー・ニュース（Hacker News）やミディアム（Medium）に反応記事が雪崩のように積み上がっている。中には真っ向から反論する記事も既に出ており、議論は技術コミュニティの中心に居座っている。
シヒパー本人はAnthropicでクロード・コードのチームに所属する技術者で、過去にはMITメディアラボに在籍し、Y Combinator W20卒の起業家でもあった経歴を持つ。社内でクロード・コードを日常使いしている当事者が、出力フォーマットの常識を覆そうとしている構図である。
HTMLが優れる5つの理由
シヒパーが挙げる利点を整理するとこうなる。
第一に情報密度。HTMLは文字情報だけでなく、SVG図、テーブル、コードハイライト、レイアウト、相互作用、画像までを単一ファイルに詰め込める。Markdownでアスキーアートの図表を頑張って書くより、SVGで描画したほうが情報量が圧倒的に多い。
第二に視覚的な読みやすさ。100行を超えるMarkdownファイルを真面目に読む人間はほとんどいない、とシヒパーは認める。HTMLならタブ、見出し、サイドカラム、レスポンシブレイアウトで構造を視覚化でき、スクロールではなく読解の対象になる。
Markdown files are fairly hard to share since most browsers do not render them natively well.（Markdownファイルは大抵のブラウザがネイティブに綺麗に描画してくれないため、共有がそれなりに難しい）
第三が共有のしやすさ。HTMLファイルはS3などにアップロードしてリンクを渡すだけで誰でもブラウザで開ける。Markdownは添付ファイルとして送るか、レンダリングしてくれるサービスに貼る手間がかかる。
双方向性とデータ取り込みという飛び道具
第四の利点が双方向のインタラクションだ。これがシヒパーの議論で最も意外性のある部分にあたる。
Claude Codeに「フラグの優先度を並び替えたいから、ドラッグ&ドロップできるカード型のHTMLを作って」と頼むと、その場限りの簡易エディタが生成される。並び替えた結果を「コピー」ボタンでJSONとして取り出し、そのままプロンプトに貼り戻せばAIが理解する。
つまりテキスト入力だけでは表現しにくい操作――順序付け、色選びイージング曲線の調整、領域の範囲指定など――を、AIに「専用UI」を作らせて解決させる発想だ。一過性の道具を使い捨てる前提に立つことで、UIデザインの常識が変わる。
第五はコンテキスト取り込み。Claude Codeは端末から起動するためファイルシステム、Gitの履歴、ブラウザのMCP（モデルコンテキストプロトコル）、SlackやLinearなどのコネクタにアクセスでき、それらをまとめて1枚のHTMLレポートに落とす作業が得意になる。
シヒパー自身が記事執筆時にAIへ「自分のコードフォルダ内のHTMLファイルを全て読み、種類別にまとめたサンプル集を作ってほしい」と依頼し、記事内のサンプル集はその出力をそのまま使ったと明かしている。
| カテゴリ | 用途 | デモ数 |
|---|---|---|
| 探索・計画 | 複数アプローチの並列検討と 実装計画への落とし込み |
●●●3件 |
| コードレビュー | 注釈付きdiff、PR説明、 モジュール構造の可視化 |
●●●3件 |
| カスタム エディタ |
チケット並び替え、フラグ管理、 プロンプト調整UI |
●●●3件 |
| デザイン | デザインシステムと コンポーネントバリエーション |
●●2件 |
| プロトタイプ | アニメーション調整と 画面遷移の試作 |
●●2件 |
| 図解 | SVG図とフローチャート | ●●2件 |
| 研究・学習 | 機能解説と概念のインタラクティブ な学習教材 |
●●2件 |
| レポート | 週次ステータスと インシデント時系列 |
●●2件 |
| スライド | HTMLだけで動く プレゼンテーション |
●1件 |
Doesn't this take longer to generate than markdown? This does take longer! HTML can take 2–4x longer than Markdown, but I've found the results are worth it.（Markdownより生成に時間がかかるのでは？確かにかかる。HTMLはMarkdownの2〜4倍ほど時間を要する。だが見合うと感じている）
シヒパーはこの2〜4倍という遅さを欠点として認めつつ、100万トークンのコンテキストウィンドウを持つ現在の世代では誤差の範囲だと主張する。バージョン管理についても「HTMLのdiffはノイズが多く、Markdownより圧倒的にレビューしづらい」と弱点を率直に書いている。
即座に上がった反論――「玩具を本気の道具にするな」
公開直後、Mediumにカーティス・リダックス（Kurtis Redux）の反論記事「The Unreasonable Ineffectiveness of HTML」（HTMLの不合理な無効性）が掲載された。タイトルは原典への明確な対抗で、内容も全6項目で逐条反論する構成になっている。
リダックスの論点をひと言で要約すると「ソースとして読めないものは知識労働の道具にならない」になる。HTMLはレンダリング後にしか読みやすくならず、生のソースは人間にとって極めて不親切だ。一方Markdownは生のままでも構造と可読性を持つ。終端でレンダリングできなくても本文を読める形式が、ターミナルやエディタで生きる知識労働者にとっては基盤なのだ、と反論者は書く。
セキュリティの観点も鋭い。AIが生成した未検証のJavaScriptをブラウザで動かすことは、テキストを「読む」から「実行する」への重大な飛躍を意味する。XSS攻撃や情報漏洩のリスクが日常作業に紛れ込む構造を、リダックスは「磨いても糞は糞だ」と痛烈に切り捨てている。
最後の指摘が興味深い。レビューと差分管理ができない出力は玩具に過ぎない、本物の生産性ソフトウェアにはなれないというものだ。シヒパー本人がHTMLのdiffレビューの困難さを弱点として認めた点を、リダックスは「致命的欠陥を軽く扱いすぎている」と突く。
Claude Code is real productivity software. Why race AI toys to the bottom?（Claude Codeは本物の生産性ソフトウェアだ。なぜAI玩具で底辺競争をしなければならない？）
加えてリダックスは利害関係も指摘する。トークン消費量で課金される事業者の人間が、より多くのトークンを消費する形式を推奨することへの利益相反（COI）の警告である。これはAnthropicという会社の立場を逆撫でする一撃で、シヒパー個人の主張を読む際の補助線として無視できない論点だろう。
| 論点 | シヒパーの主張 | リダックスの反論 |
|---|---|---|
| 情報密度 | SVG図・テーブル・コード ハイライトまで1枚に詰 め込める |
複雑さは効率ではない Markdown＋Mermaidで 十分 |
| 視覚性 | 100行超のMarkdownは 誰も読まない HTMLは構造で読ませる |
大事なのはソースの 可読性 HTMLの生は読めない |
| 共有性 | S3にアップしてリンク を渡すだけで開ける |
ホスティング前提は インフラ依存と 権限リスクを生む |
| 双方向性 | 使い捨てのUIをAIに 作らせてデータを 取り出せる |
未検証JSの実行は XSSや漏洩の温床 過剰実装だ |
| 生成速度 | 2〜4倍遅いが 100万トークン時代では 誤差の範囲 |
対話的AIで 2〜4倍の待ち時間は 致命的だ |
| レビュー | HTMLのdiffは ノイズが多く レビューしづらい（自認） |
レビューできない出力は 玩具に過ぎない 本物の道具ではない |
どちらが正しいか、ではなく、何を選ぶか
両者の主張は実は対立していない、と読むこともできる。シヒパーは「AIに作らせ、AIに読ませる」用途を想定しており、リダックスは「人間が書き、人間が読む」用途を想定している。前提が違えば最適解も違う。
問われているのは、AIエージェント時代におけるドキュメントの定義だ。読むためのドキュメントなのか、操作するためのインターフェースなのか。レビューされるためのソースなのか、消費されるための出力なのか。
Claude Codeが内部で実際に何を採用しているかは公開されていない。だがシヒパーのような中核メンバーがHTMLを推す現状を見るかぎり、Anthropicは「使い捨てHTML」を新たな標準に据えようとしている可能性がある。ウェブの原点であるHTMLが、AIエージェント時代の主役として戻ってこようとしている。皮肉でもあり、納得でもある。
サイモン・ウィリソン（Simon Willison）も自身のブログでシヒパーの記事を取り上げ「GPT-4時代のトークン制限の頃から自分はMarkdownをデフォルトにしてきたが、考え直す時期かもしれない」と書いている。同様の問い直しは、これから多くの開発者の手元で起こるだろう。
選択の主導権は使い手にある。だが、その選択肢が増えたことだけは確かだ。
参照元
他参照
- Kurtis Redux - The Unreasonable Ineffectiveness of HTML
- Simon Willison's Weblog - Using Claude Code: The Unreasonable Effectiveness of HTML
