Claudeを雑に使う人ほど損をする。Anthropic公式ベストプラクティスを現場目線で再解釈する
最近、Anthropic公式ドキュメント をかなり読み込んでいる。
結論から言うと、Claudeは「ふわっとお願いするAI」ではない。 むしろ逆で、設計された情報を投入するほど性能が跳ね上がるタイプだ。
これは、単に「プロンプトを丁寧に書きましょう」みたいな話ではない。
実際の現場では、
- AIに仕様を誤解される
- UIを勝手に変えられる
- 処理Aと処理Bを混同される
- 修正したら別の場所が壊れる
みたいな事故が頻発する。
今回は、Anthropic公式のベストプラクティスをベースに、実際に自分が現場で効いたと思っているテクニックをまとめる。
1. 「AIは空気を読まない」が前提
Anthropic公式が一貫して言っているのはこれ。
曖昧に書くな 文脈を分離しろ 構造化しろ
人間同士だと、
「前と同じ感じで」 「いつものアレで」 「いい感じに」
で通る。
でもAIは通らない。
特にClaude Code系は、巨大コンテキストを扱える代わりに、曖昧な情報も大量に飲み込む。
結果として、
- 関係ないコードを触る
- UIの意図を誤解する
- 以前の処理を再利用して事故る
みたいなことが起きる。
つまり重要なのは、
「どれだけ情報を与えるか」ではなく、 「どう整理して与えるか」
になる。
2. 画像よりAA（アスキーアート）が強い理由
ここは完全に自分の体感だが、かなり効く。
普通はスクショを貼りたくなる。
でも実際は、スクショにはノイズが多い。
- 色
- ボタン
- 余計な余白
- UI装飾
- 関係ない情報
Claudeが「どこを重要視すべきか」を誤る。
そこで使うのがAA。
例えばテーブル。
+----------+------------+-------------------+
| 項目名 | 重要度 | 根拠 |
+----------+------------+-------------------+
| XMLタグ | 高 | Anthropic公式 |
+----------+------------+-------------------+これだけで、
- 列構造
- 関係性
- 優先順位
が一瞬で伝わる。
しかも重要なのは、AAは「抽象化」されていること。
つまり、
見た目ではなく構造を伝えられる。
これが強い。
3. Claudeは「フロー図」に異常に弱い
これ、かなり重要。
Claudeは局所的なコード理解は強い。 でも、処理全体の流れになると混乱することがある。
特に危険なのが、
- 処理A
- 処理B
が似ているケース。
人間なら空気で区別できるが、AIは普通に混同する。
そこで効くのが、フローをAA化すること。
[入力]
|
v
+--------------+
| バリデーション |
+--------------+
|
YES
v
+--------------+
| 今回の処理A |
+--------------+
※ 処理Bと混同しないことこの「混同しないこと」が大事。
Anthropic公式でも、
- 指示を分離しろ
- ステップ化しろ
- 中間思考を作れ
と書かれている。
つまりAIは、
「工程を見せる」と急に賢くなる。
4. XMLタグは「ただの装飾」ではない
これは公式でもかなり強調されている。
例えばこう。
<instruction>
ReactのUIだけ修正してください。
バックエンドは変更禁止です。
</instruction>
<code>
...
</code>これをやるだけで、Claudeの誤爆率がかなり下がる。
理由は単純。
Claudeは「意味」だけでなく、 構造そのものを見ているから。
つまりXMLタグは、
- 人間向けの見た目 ではなく、
- AI向けの境界線
として機能している。
5. 「過去の失敗」を共有すると精度が上がる
これもかなり重要。
AIは「正解」だけ渡すより、
- 以前こう間違えた
- ここを誤解しやすい
- 前回は処理Bを触った
みたいな失敗情報を渡したほうが安定する。
これは新人教育に近い。
例えば、
注意:
以前、処理Bと混同して
認証ロジックを壊した。
今回はUIのみ修正。これだけで事故率が下がる。
Anthropic公式でも、
- Few-shot
- Counter example
- Negative example
を推奨している。
つまり、
「こうしてほしい」だけじゃなく、 「こうするな」も重要。
6. AIに全部読ませれば良いわけではない
これも勘違いしやすい。
Claudeは長文コンテキストが強い。
だからといって、
「全部読ませれば最強」
ではない。
むしろ逆。
情報が多すぎると、
- 古い仕様
- 不要コード
- 廃止ロジック
まで参照し始める。
結果、
「なぜそこ触った？」
みたいな修正が発生する。
だから重要なのは、
- 必要な範囲だけ渡す
- 責務単位で切る
- フォルダ分離する
こと。
これ、完全にSOLID原則と同じ。
AI時代になって、むしろ設計の重要性が増している。
7. Claudeは「超優秀な新人」と思ったほうがうまくいく
ここを勘違いすると、AI活用は失敗する。
Claudeは、
- 超高速
- 超博識
- 超長時間働ける
でも、
- 文脈を誤解する
- 思い込みで修正する
- 指示不足を補完しようとして事故る
という特徴がある。
つまり、
放置すると暴走する。
逆に、
- 仕様
- フロー
- 禁止事項
- 過去の失敗
を整理して渡すと、異常な性能を出す。
だからAI活用って、
「雑に投げる技術」ではなく、
「情報設計の技術」
なんだと思う。
まとめ
Anthropic公式のベストプラクティスを、自分なりに現場へ落とし込むと、重要なのはこの辺。
- XMLタグで境界を作る
- AAで構造を伝える
- フローを可視化する
- 過去の失敗を共有する
- 情報を削ぎ落とす
- 「こうするな」も書く
結局、AI時代に必要なのは、
「コードを書く能力」だけではなく、
“相手が誤解しない形で情報を構造化する能力”
なんだと思う。
そしてこれは、実は昔から設計書レビューや新人教育でやっていたことと、本質的にはそんなに変わらない。