Claude Codeでぼくが気をつけている『質問の質』3つ

「Claudeに聞いても、欲しい答えが返ってこない」

これ、最初の1ヶ月のぼくの悩みでした。

ーーーーーーーーーーーーーーーーーーーーー

📊 質問の質を変えたら起きたこと

• やり取りの往復回数：平均5回 → 平均2回
• 1つの質問で解決する率：3割 → 8割
• 「やっぱり違う」のやり直し：週10回 → 週2回

ーーーーーーーーーーーーーーーーーーーーー

この記事は、Claudeから欲しい答えが返ってこない非エンジニアに向けた、ぼくの「質問の型」3つです。

型1：1行目に「目的」を書く

before：「このコード直して」

after：「ブログのトップに新着3件出したい。このコード直して」

ーーーーーーーーーーーーーーーーーーーーー

⚠️ いきなり「直して」と言うと、Claudeは何のために直すかわからない

その結果、見当違いの修正が返ってくる。

ーーーーーーーーーーーーーーーーーーーーー

⭕️ 1行目に「何のため」を必ず書く

ぼくの定型フレーズ：

「○○したい。やり方教えて。」

「○○を実現したい。今のコードはこう。」

「○○が目的。一番シンプルな方法は?」

ーーーーーーーーーーーーーーーーーーーーー

⭕️ 効果：見当違いの修正が9割減った

「何を直すか」より「何のために直すか」を伝えるほうが、いい答えが返ってきます。

型2：「使っているもの」を箇条書きで添える

before：「エラー出た。直して。」

after：「エラー出た。直して。」 （環境：Windows 11 / Python 3.12 / Cloudflare Workers）

ーーーーーーーーーーーーーーーーーーーーー

⚠️ Claudeは前提を知らないので、間違った環境向けの解決策を出してくる

「Macなら〜」「Linuxなら〜」と書かれても、Windowsユーザーには使えません。

ーーーーーーーーーーーーーーーーーーーーー

⭕️ 自分の環境を3行で添える

ぼくの定型：

環境： - Windows 11 - Python 3.12（pyenv不使用） - Cloudflare Workers無料枠

ーーーーーーーーーーーーーーーーーーーーー

⭕️ 効果：「自分の環境に合った答え」が一発で返ってくる

たった3行で、やり取りが半分になります。

型3：「答えの形式」を指定する

before：「比較して教えて」

after：「比較して教えて。3行・表形式・推奨1つ明記で。」

ーーーーーーーーーーーーーーーーーーーーー

⚠️ Claudeは「いい感じ」が苦手

放置すると長文で返ってくる。または短すぎる。

ーーーーーーーーーーーーーーーーーーーーー

⭕️ 答えの「長さ」と「形」を指定する

ぼくの定型：

「3行で。」

「表で。」

「コードだけ。説明なし。」

「推奨1つ明記して、理由を1行で。」

ーーーーーーーーーーーーーーーーーーーーー

⭕️ 効果：「読まなくていい長文」が消えた

時間も節約。集中力も節約。

学んだ3つのこと

今後

質問の型を覚えると、Claudeとの会話が「短いやり取りの積み重ね」になります。

⭕️ 1往復で解決する質問が増える

⭕️ 長文を読まなくていい

⭕️ 「やっぱり違う」のやり直しが減る

ーーーーーーーーーーーーーーーーーーーーー

3つの型は、CLAUDE.mdに書いておくと毎回守ってもらえます。

毎回打ち直す必要はありません。

最後に:自分の思い

最初の1ヶ月、ぼくはClaudeに「察してほしい」と思っていました。

「これ聞いたらわかるよね?」と。

ーーーーーーーーーーーーーーーーーーーーー

でもAIは察しません。

伝えたことだけを使って答えます。

ーーーーーーーーーーーーーーーーーーーーー

非エンジニアにとって、これは新しい言語の練習に近い。

最初は面倒。 慣れると速い。

伝えたいことは1つだけ。

質問の質は「目的・環境・形式」の3つで決まる。

ーーーーーーーーーーーーーーーーーーーーー

ぼくはこの3つを意識し始めてから、Claudeとの会話が「相棒との作業」になりました。

察してほしいと思わなくなって、初めてAIは道具になります。

この記事も Claude Code に書いてもらいました。「結論先行・一文60文字以内・数字を使う・誰向けか明確・自分の思いで締める」の5点を意識した版です。