初学者がClaude Codeで学ぶ：コードを書かせず理解するための使い方

先に設定する：ソースコードの編集を止める

以下はターミナル版の手順です。Claude Codeの公式ドキュメント（2026年10月29日に確認）では、「Manual」モードの設定値が default です。起動時のモードはバージョンや設定によって異なるため、使うなら claude --permission-mode default と明示します。別途許可した操作などを除き、ファイルの作成・変更や読み取り専用ではないシェルコマンドには承認が必要です（Choose a permission mode）。編集だけでなく、書き込みにつながるコマンドも承認しないようにします。

より分かりやすいのはプラン（plan）モードです。Claudeはファイルを読んで計画を書き、通常は計画を承認するまでソースコードの編集を止めます。ただし、権限チェックを回避する bypassPermissions が選択可能なターミナルセッションは例外なので、この学習手順では使いません。また、プランモードでも計画の保存やシェルコマンドの実行はあるため、すべてのファイルへの書き込みを禁止する機能ではありません。次のどちらかで入れます。

• 起動時：claude --permission-mode plan
• 起動後：Shift+Tab を押してステータスバーに ⏸ plan mode on と出るまで切り替える

(Common workflowsにも同じ手順があります。)

「acceptEdits」モードは編集を自動承認するので、学習中は避けるほうが安全です。

Learningスタイルは「書かせない」ではなく「一部を自分で書く」

出力スタイルの「Learning」は、Claudeが選択の理由を説明する Insight を出し、設計判断のある一部分をあなたに任せる仕組みです。該当箇所に TODO(human) コメントを置き、何が作ってあって何を書くかを伝えて待ちます。ただし、定型的な実装はClaudeが自分で書きます。つまり、コードを一切書かせないモードではありません。ターミナル版では /config のメニューから選べます。Claude Code v2.1.269以降では /output-style learning でも切り替えられます。あわせて公式は、出力スタイルは「従うべき指示」であり、必ず起きることの保証ではないとも書いています（Output styles）。

• ソースコードを編集させず、読んで説明だけ欲しい、向く設定：プランモード、注意点：権限回避を有効にせず、「No, keep planning」で継続する。コマンド実行はあり得る
• 手を動かしつつ、要所だけ自分で書きたい、向く設定：Learningスタイル、注意点：定型部分はClaudeが書く。全部を自分で書くわけではない
• 理由つきで読みたい、向く設定：Explanatoryスタイル、注意点：説明は会話に出るだけで、ファイルのコメントには書かれない
• 編集を承認画面で確認したい、向く設定：Manual（設定値はdefault）モード、注意点：既存の許可設定も確認し、書き込みにつながる操作を拒否する

依頼文集1：説明させる

目的は「このコードが何をしているか」を自分の言葉で言えるようにすることです。コードの場所を @ファイル名 で指定すると、Claudeにそのファイルを渡せます。

使う依頼文（コピー用）

@src/grade.py を読んでください。ファイルは変更せず、コードも書き直さないでください。
1. このファイルの役割を3行で説明してください。
2. 関数ごとに「入力・処理・出力」を表にしてください。
3. 初学者がつまずきそうな構文を2つ選び、なぜそう書くのかを説明してください。
専門用語には、最初に一言の意味を添えてください。

説明用の例（架空）：次の関数を渡したとします。

def average(scores):
    return sum(scores) / len(scores)

説明を読んだら、すぐ次の一文を自分で書いてみます。「average([]) を呼ぶとどうなるか。理由も」。自分の予想を書いてから、Claudeに確かめてもらいます。

依頼文集2：質問させる

ここでの「質問」は二方向あります。自分がわからない所を聞く場合と、Claudeに出題させて理解度を確かめる場合です。後者は、説明を「読んだつもり」で終わらせないための仕組みです。

わからない所を聞く依頼文

@src/grade.py の average 関数について質問です。
len(scores) が 0 のとき何が起きるかを知りたいです。答えを書く前に、
私が理解しているかを確かめる質問を1つ出してください。修正コードはまだ出さないでください。

出題させる依頼文

今の説明の内容から、理解度を確かめる問題を3つ出してください。
・1問ずつ出し、私が答えるまで正解を言わないでください。
・答えが間違っていたら、答えを言う前にヒントを1つだけ出してください。
・問題は「コードを読んで結果を予想する」形式にしてください。

予想が外れた箇所が、まだ理解できていない場所です。メモしておけば、次回の依頼文にそのまま使えます。

依頼文集3：自分で書く練習

ここでは、仕様と確認方法だけをClaudeに出してもらい、実装は自分で書きます。

課題を出してもらう

average 関数を、空のリストでも落ちないように直す練習をしたいです。
・完成コードは書かないでください。
・直す条件を3行の仕様にしてください。
・私が確認できるテストの入力と期待値を3組、表で出してください。

書いた後にレビューしてもらう

@src/grade.py の average 関数を自分で直しました。
・書き換えずに、問題点だけ指摘してください。
・直し方そのものは書かず、「どの入力で何が起きるか」を例で示してください。
・良かった点も1つ挙げてください。

指摘に納得できなかったら、「別の書き方もあるか」「その書き方だと何が困るか」を聞き返します。それでも自分で直せないときだけ、「ヒントを1段階ずつ出してください」と頼みます。答えを丸ごと求めるのは最後です。

1回分の進め方

1回の学習は15〜30分程度に収めると続けやすいです（時間は編集部の目安です）。

1. 権限回避を有効にせずプランモードで起動するか、Manualモードで許可設定を確認し、書き込みにつながる操作を承認しない。
2. 見たいファイルを1つだけ決め、依頼文集1で説明させる。
3. 説明を閉じて、自分の言葉で3行にまとめる。
4. 依頼文集2で出題させ、予想を書いてから答え合わせする。
5. 理解できた箇所を使い、依頼文集3で小さな課題を自分で書く。
6. 自分で実行して確かめる。Claudeの「動くはず」という説明だけで済ませない。

作業では、会社や個人の機密情報、鍵、個人情報の入ったファイルは渡さないでください。練習用にはダミーのデータに置き換えます。

迷ったときの判断表

• 説明を読んでもピンとこない、次にすること：「具体的な入力値を3つ使って1行ずつ追って」と頼む、避けること：同じ説明を繰り返し読む
• 自分のコードが動かない、次にすること：まずエラー文を自分で読み、予想を書いてからClaudeに聞く、避けること：エラーを貼って「直して」だけ頼む
• 課題が難しすぎる、次にすること：課題を半分に小さくしてもらう、避けること：完成コードを求める
• 説明が長すぎて頭に入らない、次にすること：「3行で」「例は1つだけ」と制限をつける、避けること：質問を増やす
• Claudeの説明が正しいか不安、次にすること：実際にコードを動かして確かめる。言語やライブラリの公式資料でも確認する、避けること：説明だけを信じる

毎回の指示を省くには（任意）

毎回の依頼文に同じ文を書くのが面倒なら、公式ドキュメントにある「カスタム出力スタイル」を使う手があります。~/.claude/output-styles などにMarkdownファイルを置く形式です。以下は公式の書式にならった編集部の案で、動作は確認していません。

---
name: Study buddy
description: 完成コードを出さず、説明と質問で学習を助ける
keep-coding-instructions: true
---

完成コードを先に出さない。まず説明し、次に確認の質問を1つ出す。
ユーザーが答えるまで正解を言わない。ヒントは1段階ずつ出す。

例えば ~/.claude/output-styles/study-buddy.md として保存し、ターミナル版のClaude Codeを再起動してから、/config の Output style で「Study buddy」を選びます（Output styles）。スタイルは指示にすぎないので、編集を止めたいときは、先に説明した権限モードと許可設定も確認してください。