Claude CodeでHTML出力を推奨、Markdownより優れる理由

Claude Codeが示す、HTMLの新たな可能性

長年、大規模言語モデル（LLM）へのプロンプトでは、出力形式として「Markdown」が暗黙の了解のように使われてきた。しかし、AnthropicのClaude Codeチームに所属するThariq Shihipar氏が、「HTMLの unreasonable effectiveness（型破りな有効性）」を説く記事を発表し、再考を促している。

Markdownの常識を覆すHTMLの優位性

GPT-4の時代、8,192トークンという制限が厳しかった頃、Markdownはそのトークン効率の良さから好まれていた。しかし、Thariq氏はClaude Codeのような環境では、HTMLを出力として要求することの利点を強調する。

HTMLは単なるテキスト整形を超える。例えば、以下のような高度な表現が可能になるという。

• SVGによる図表の直接描画
• JavaScriptを用いたインタラクティブなウィジェット
• ページ内ナビゲーションによる情報の体系的な提示

これにより、ユーザーは複雑なコードの説明やデータの分析結果を、はるかに直感的で理解しやすい形で受け取ることができる。

著名開発者の実証：HTML出力の実践例

この議論を後押しするのが、著名なテックブロガーであり開発者でもあるSimon Willison氏の実験だ。彼は以前からHTMLツールの構築を推奨してきたが、Thariq氏の記事に触発され、さらなる可能性に興味を示した。

Willison氏は、最近発見されたLinuxセキュリティ脆弱性「copy.fail」の説明を、LLM（GPT-5.5）にHTML形式で生成させることを試みた。難読化されたPythonスクリプトの解析を依頼し、「HTML、CSS、JavaScriptの機能を活用して、リッチでインタラクティブ、かつ可能な限り明確な説明を生成せよ」とプロンプトした結果、有用な解説ページが生成されたと報告している。

プロンプトエンジニアリングのパラダイムシフト

この議論は、単なる出力形式の好みの問題ではない。プロンプトエンジニアリングの在り方そのものに影響を与える可能性がある。

Thariq氏が提示するプロンプト例は示唆に富む。「このPRをレビューし、HTMLアーティファクトとして説明を作成してほしい。特にストリーミング／バックプレッシャーのロジックに焦点を当て、実際の差分をマージン注釈付きで表示し、重要度に応じて色分けせよ」といった具合に、出力形式を具体的に指定することで、LLMの能力をより引き出すことができる。

今後の展望：リッチなAI出力の時代へ

Willison氏は「GPT-4時代以来、私はほとんどのものをMarkdownで要求することをデフォルトにしていたが、この記事を機に考えを改めた」と述べ、特に出力においてHTMLの実験を増やすことに意欲を見せている。

LLMのコンテキストウィンドウが拡大し、処理能力が向上した今、トークン効率を気にする必要は薄れつつある。SVG、インタラクティブ要素、リッチなスタイリングを駆使したHTML出力は、AIとの対話から得られる情報を質的に向上させる鍵となるかもしれない。Claude Codeが切り拓く、この「HTMLファースト」のアプローチが、今後のAI開発ワークフローを変革する可能性に注目が集まる。