これは自分が使いながら気づいたことを書き留めたメモです。
整理された「ガイド」というより、「使っていて気になったこと・試して効果があったこと」の記録です。日本語でClaude Codeを使う中で感じた、英語圏のTipsとは少し違う話を書きます。
「主語が省略できる日本語」の罠
日本語は主語を省略することが自然な言語です。「やっておいてください」「修正して」「確認してください」——誰が・何を、という部分が文脈から省略されます。
でもClaude Codeとのやりとりでこれをやると、意図が伝わらないことがあります。
「確認してください」より「このコードのセキュリティ上の問題点を確認してください」の方が一発で意図が通ります。日常会話では当たり前の省略が、Claude Codeとのやりとりでは精度を落とす原因になります。
意識するようになったこと:日本語の省略を使わず、「何を・どのように」を毎回明示する。
丁寧語が「強度」を下げる場合がある
日本語は丁寧な表現ほど断定を避ける傾向があります。「〜してみてください」「〜していただけますか」「できれば〜お願いします」という表現は、依頼の強度が下がります。
Claude Codeはこの「強度の低さ」を「提案を求めている」と解釈することがあります。「〜してください」ではなく「〜する」「〜すること」という断定的な書き方の方が、実行指示として伝わりやすいです。
ただし「確認してから動いてほしい」という場面では、「まず提案してください、実行はその後に判断します」と明示する方が安全です。
「なんとなく」「いい感じに」が機能しない
これは以前にも書きましたが、日本語ユーザーが特にやりがちな表現として改めて記録します。
「なんか変な感じがするのでいい感じに直して」は、「変な感じがする理由」と「いい感じの定義」が両方ない指示です。
「この段落、前の段落と繋がりが悪い気がします。接続をもう少しスムーズにして」という形に直すだけで精度が上がります。感覚を言語化することが、Claude Codeとのやりとりを改善する近道です。
「遠慮のある表現」に注意する
日本語には「申し訳ないのですが」「もし可能であれば」「お手数ですが」という前置きの文化があります。Claude Codeにはこの前置きは不要です。
「もし可能であれば、このコードを少し直していただけますか……」より「このコードの〇〇を△△に変更してください」の方が明確です。遠慮は必要なく、指示は直接的に書く方が結果が良くなります。
箇条書きと文章の使い分け
複数の指示を一つのメッセージに含める場合、箇条書きにした方が処理される順序と内容が明確になります。
文章で「まずこれをやって、それからあれをして、最後にこうしてほしい」と書くより、番号付きのリストで書いた方が、処理漏れが起きにくいです。
逆に、文脈の説明や背景の共有は文章の方が自然に伝わります。「状況の説明は文章・指示は箇条書き」という使い分けが効果的です。
「曖昧な否定」に気をつける
「あまり難しくしないで」「そこまで詳しくなくていい」「少し短めに」という日本語の「程度の曖昧な否定」は、解釈の幅が広すぎます。
「箇条書き5項目以内で」「初心者向けの言葉遣いで」「500字以内で」という数字・条件・対象を使った表現に変えると、意図通りの結果が出やすくなります。
長い敬語文は情報量が下がる
「お忙しいところ恐れ入りますが、もしよろしければ〜についてお教えいただけますでしょうか」という敬語文は、情報の密度が低いです。Claude Codeには情報密度の高い短い文の方が伝わります。
ビジネスメールの書き方とClaude Codeへの指示の書き方は別物です。Claude Codeへの指示には「礼儀」は不要で、「明確さ」が優先されます。
ひとつの気づき:日本語は「気持ちを伝える」のに向いている
ここまで「日本語の省略・遠慮・曖昧さ」の問題点を書いてきましたが、逆に日本語が強みを発揮する場面もあります。
「この文章、なんか冷たい感じがするので、もう少し温かみのある表現にしてほしい」という感性的なニュアンスを伝えることは、日本語の方が得意な場合があります。「温かみ」「親しみやすさ」「落ち着いたトーン」といった感覚的な言葉が、日本語では自然に伝わります。
指示の明確さは英語的なシンプルさを参考にして、ニュアンスや感性は日本語のまま使う——このハイブリッドな使い方が、日本語ユーザーとしての一つの答えかもしれないと思っています。
このメモは気づいたことがあれば追加していく予定です。