ClaudeCodeで「いい感じで」と指示したら、「いい感じ」で終わった話は、滅多にない
「ClaudeCodeに仕事を任せたら、期待と全然違う結果が返ってくる」
こんなお悩みをよく聞きます。実は、これは「あなたの想像」と「Claudeの解釈」のズレが原因です。
曖昧な指示 = 曖昧な結果
逆に、制約を明示すれば、精度は激変します。
「いい感じで」という指示の問題点
ClaudeCodeは優秀ですが、「あなたの『いい感じ』がどれか」を知りません。
「いい感じ」には、人によって違う定義があります：
- シンプルなのか、詳細なのか
- 短いのか、長いのか
- 数字中心なのか、文章中心なのか
- 日本語なのか、英語なのか
- 図表ありなのか、テキストのみなのか
Claudeは推測できません。つまり、「いい感じ」と言った瞬間、外れる確率は極めて高いんです。
実例：レポート作成での失敗パターン
❌ ダメな指示
「売上データをレポートにして」
Claudeの解釈の一例：
- Excelファイル生成？ Markdown？ PDF？
- グラフ入り？テキストのみ？
- 概要だけ？詳細分析まで？
- 前月比を入れる？前年比まで？
- 経営者向け？担当者向け？
→ 結果：期待と違うレポートが完成
✅ 良い指示
【売上レポート作成】
■ 形式：Markdown
■ 対象：経営層（CEO向け）
■ 分析内容：
– 月別売上トレンド（折れ線グラフ）
– カテゴリ別売上構成比（円グラフ）
– 前月比・前年比 の成長率（%表記）
– 売上上位5商品（ランキング）
– 傾向分析（3行以内）
■ トーン：客観的・数字重視（感情的な表現不可）
■ 長さ：A4用紙1枚分（改行含めて1500字以内）
■ 作成後：表示して確認してから保存
→ 結果：1回でOK。修正なし
制約を明示する3つの領域
制約明示 = 精度UP
1️⃣ 形式の制約
「何の形で欲しいのか」を明示。これが最も曖昧になりやすい部分です。
形式の指定例：
– ファイル形式：.xlsx（Excel）/ .md（Markdown）/ .pptx（PowerPoint）
– 見た目：シンプル / 詳細 / 視覚的
– 長さ：〇〇字以内 / 〇ページ以内 / 〇分で読める
– 構成：見出し3つ / 箇条書き / 段落形式
– 言語：日本語 / 英語 / コード
2️⃣ 内容の制約
「何を含めるか、何を含めないか」を境界線で明確に。
内容指定の例：
■ 必ず含める：XXX、YYY、ZZZ
■ 絶対に含めない：感情的表現、推測、学術用語
■ オプション：図表、コード例
3️⃣ トーン・スタイルの制約
「どういう口調で」「誰向けに」を指定。これを忘れると、AIっぽい出力になります。
トーン指定の例：
■ 対象者：CEO / エンジニア / 初心者
■ トーン：プロフェッショナル / フレンドリー / カジュアル
■ 視点：客観的 / 批判的 / 提案的
よくある失敗パターンと対策
| 失敗パターン | 原因 | 対策 |
|---|---|---|
| 「思ってた感じと違う」 | 形式が曖昧 | ファイル形式・長さ・見た目を明示 |
| 「内容がズレてる」 | 何を含めるか曖昧 | 「必ず含める」「絶対含めない」を列挙 |
| 「AIっぽい」 | トーンが曖昧 | 対象者・トーン・禁止ワードを明示 |
| 「修正が何度も」 | 全ての制約が曖昧 | 最初から形式＋内容＋トーンを全て指定 |
実例：メール作成での制約明示
実例タスク：クライアント向けメール
❌ 悪い指示：
「クライアントにメール書いて」
→ 返信時間？敬語レベル？内容？すべてが曖昧
✅ 良い指示：
【クライアントメール作成】
■ 目的：来週の打ち合わせ日程を提案する
■ 形式：メール本文（件名+本文）
■ 対象：営業部の意思決定者向け
■ トーン：丁寧かつプロフェッショナル（フレンドリーすぎない）
■ 必須要素：
– 3つの日程案（時間帯も指定）
– 各案の所要時間
– 確認期限（「〇月〇日までにご回答ください」）
■ 絶対含めない：
– 相手への命令口調
– 感情的な表現
– ビジネス用語の過度な使用
■ 長さ：200-300字（改行含む）
→ 1回で完成。修正なし。
禁止ワードの指定もコツ
ClaudeCodeは、AI感が出た表現を避けるために、禁止ワードの指定も効果的です。
- ❌ 「画期的」「圧倒的」「最適」「素晴らしい」「革新的」
- ❌ 「〜が可能です」「いかがでしょうか」（過度な敬語）
- ❌ 「つまり」「すなわち」（説教的に聞こえる）
「これらの言葉を使わないでください」と明示するだけで、ぐっと人間らしい出力になります。
まとめ：プロンプト＝「品質管理の仕様書」
ClaudeCodeの精度を上げるコツは、プロンプトを「製造業の仕様書」と同じレベルで書くことです。
仕様書には、曖昧性がありません。それと同じ精度で書けば、Claudeの出力精度は極めて高くなります。
コメント