はじめに
プログラミング初心者がTypeScriptを学ぶとき、最大の壁は型エラーです。
Type 'string' is not assignable to type 'number'.
この1行を見て「何が起きているか」を理解できる初心者はほとんどいません。しかし、Claude CodeのCLAUDE.mdを適切に設計すれば、AIが型エラーの意味をその場で噛み砕いて説明してくれる「エラー解説モード」を実現できます。
この記事では、実際にプログラミング教材で使用している設計パターンを紹介します。
型エラー解説の設計方針
やってはいけないこと：エラーを直してしまう
Claude Codeのデフォルトの振る舞いでは、型エラーを見つけると勝手に修正してしまいます。学習目的ではこれが最大の問題です。
# CLAUDE.md（アンチパターン）
TypeScriptのエラーがあったら修正してください。
これでは学習者は何も学べません。
正しい設計：エラーを「教材」にする
# CLAUDE.md（学習モード）
## TypeScript型エラーの対応ルール
型エラーが発生した場合、以下の手順で対応すること：
1. **エラーを修正しない**
2. エラーメッセージを日本語で説明する
3. 「なぜこのエラーが出るか」を3行以内で説明する
4. 修正のヒントを出す（ただし正解のコードは書かない）
5. 学習者が自分で修正するのを待つ
実装例：エラー解説テンプレート
CLAUDE.mdに以下のようなテンプレートを定義しておくと、AIの応答が安定します。
## エラー解説のフォーマット
### 型エラーが出たとき
以下のフォーマットで説明すること：
🔴 エラー: [エラーメッセージの日本語訳]
📝 意味: [何が起きているかの説明]
💡 ヒント: [修正の方向性（コードは書かない）]
実際の動作例
学習者が以下のコードを書いたとする：
function add(a: number, b: number): number {
return a + b;
}
const result = add("5", 3);
Claude Codeの応答：
🔴 エラー: 「string型」は「number型」に代入できません
📝 意味: add関数の第1引数aはnumber型を期待していますが、
"5"は文字列（string型）です。見た目は数字でも、
ダブルクォートで囲むと文字列になります。
💡 ヒント: "5"を数値の5にするにはどうすればいいでしょうか？
クォートを外すか、変換関数を使う方法があります。
フェーズ別の段階制御
学習の進度によって、エラー解説の詳しさを変えることもできます。
## フェーズ別エラー対応
### フェーズ1（セッション1-5）: 手厚い解説
- エラーメッセージを完全に日本語化
- 型の概念そのものから説明
- 類似の正しいコード例を1つ提示
### フェーズ2（セッション6-12）: ヒントのみ
- エラーメッセージは原文のまま
- 日本語での意味説明は1行
- ヒントのみ、コード例なし
### フェーズ3（セッション13-20）: 自力解決
- エラーメッセージを指摘するのみ
- 「このエラーを調べてみてください」と促す
- 5分経っても解決しない場合のみヒント
よくある型エラーパターンの事前定義
初心者が遭遇しやすい型エラーをCLAUDE.mdに事前定義しておくと、より的確な説明ができます。
## 頻出型エラーと解説方針
| エラーパターン | 初心者向け説明 |
|---|---|
| string → number | 「クォートの有無で型が変わる」ことを説明 |
| undefined is not assignable | 「値がまだ入っていない可能性」を説明 |
| Property does not exist | 「オブジェクトの設計図（型）に定義されていない」と説明 |
| Argument of type X is not assignable to parameter of type Y | 「関数が期待する型と実際に渡した型が違う」と説明 |
まとめ
TypeScriptの型エラーは、初心者にとっては壁ですが、適切に設計されたCLAUDE.mdがあれば最高の教材になります。
ポイントは3つ：
- エラーを直さない（学習機会を奪わない）
- 日本語で噛み砕く（英語のエラーメッセージの壁を下げる）
- 段階的に手を離す（自力解決力を育てる）
AIは「間違いを指摘してくれる優しい先生」として、プログラミング学習を根本から変える可能性を持っています。
この仕組みを使ったプログラミング学習サポートをMENTAで提供しています。→ https://menta.work/plan/20251
YouTubeでもAI×プログラミングの情報を発信中 → https://www.youtube.com/channel/UC1rXVD9WYsQPQEWZyd-A1KA/