コース一覧
Claude Code入門
計画させてから実行

Claude Code入門

AIコーディングエージェント「Claude Code」への指示の出し方、生成コードの読み方とレビュー、テストと安全確認、バグ修正から機能追加までの実践ワークフローを、毎レッスン実際にエージェントと開発しながら学びます。入門で自分が書いたおこづかい帳を、AIと一緒に機能拡張していきます。

1
Claude Codeとは
01. AIエージェントとは5分
02. 起動と最初の対話5分
03. はじめての指示5分
04. 動きのしくみ5分
05. つくる:最初の一巡6分
06. 第1章クイズ5分
2
基本操作
01. コードについて質問する5分
02. 修正を依頼する5分
03. 差分を読む6分
04. 動かして確かめる5分
05. 元に戻す5分
06. つくる:操作の一巡6分
07. 第2章クイズ5分
3
良い指示の出し方
01. 要件の伝え方5分
02. 受け入れ条件6分
03. タスクを分割する6分
04. 計画させてから実行6分
05. CLAUDE.mdを書く6分
06. つくる:指示の型6分
07. 第3章クイズ5分
4
レビューと安全
01. 生成コードを読む6分
02. 自分で試験する6分
03. テストを書かせる6分
04. 危険な操作の見極め6分
05. 修正の往復6分
06. つくる:レビュー一巡7分
07. 第4章クイズ5分
5
実践ワークフロー
01. バグ修正を任せる6分
02. 機能追加を任せる6分
03. リファクタを任せる6分
04. ドキュメントを書かせる6分
05. 知らないコードを解説させる6分
06. つくる:ワークフロー実践7分
07. 第5章クイズ5分
6
総合制作
01. 大型機能を共同実装8分
02. 総レビュー7分
03. 任せる/書くの境界6分
04. 自由拡張8分
05. 完成と次のステップ5分

計画させてから実行

書かせる前に方針を聞く

ここまでで、要件を書き、条件を書き、タスクを分けました。それでも思っていたものと違う実装が返ることがあります。あなたと AI の頭の中が同じかどうかを、確かめていないからです。

方法は簡単です。コードを書かせる前に、方針だけ出させます。

プレーンテキスト

まだコードは書かないでください。どう実装するつもりか、方針を3行で説明してください。

返ってきた3行を読めば、噛み合っているかどうかが分かります。ずれていたら、そこで直します。コードが1行も書かれていない段階なので、直すコストはほぼゼロです。

計画で見えること

計画には、依頼文からは見えなかった判断が現れます。

プレーンテキスト

受講者の依頼 日付ごとに支出をまとめる関数を作って AI の計画 1 records をループして date をキーにする 2 同じ日付があれば金額を足す 3 日付の昇順に並べた辞書を返す

3行目で「並べ替えるつもりだ」と分かります。あなたが並び順を気にしていなかったなら、ここで決められます。逆に、この計画に日付が無い月の扱いが書かれていなければ、そこが抜けていると気づけます。

計画は、抜けを見つけるための道具です。

合意してから着手させる

計画に納得したら、そのまま実装に進ませます。

プレーンテキスト

その方針で進めてください。ただし3つ目だけ、昇順ではなく降順にしてください。

計画を1度通しているので、指示は差分だけで済みます。全部を書き直す必要はありません。

納得できなければ、計画のやり直しを頼みます。ここで妥協して実装させると、結局あとで書き直しになります。

いつ計画を挟むか

毎回やる必要はありません。目安は次のとおりです。

プレーンテキスト

挟む 新しく関数を作る、複数ファイルに触る、設計の選択肢が複数ある 挟まない 文言を1つ変える、明らかに1行で済む

小さな変更で計画を挟むと、往復が増えるだけで得がありません。やり直しが痛い依頼にだけ挟むと考えてください。

練習

今回は日付ごとの集計です。並び順という、計画を見ないと気づきにくい判断が含まれています。まず方針を出させ、並び順を確認してから実装させてください。

完成条件

  • 触ってよいのは kakeibo.py だけです
  • 最初の1回は方針だけ出させ、コードを書かせないでください
  • 日付ごとの合計金額を、日付の昇順に並べたリストで返します
  • 1件は日付と合計金額の2要素リストです

依頼

kakeibo.py の summarize_by_date を完成させてください。まず方針だけ出させ、並び順を確認してから実装させてください。

  • ・触ってよいのは kakeibo.py だけです
  • ・最初の1回は方針だけ出させ、コードを書かせないでください
  • ・日付ごとの合計金額を、日付の昇順に並べたリストで返します
  • ・1件は日付と合計金額の2要素リストです

いまのコード

kakeibo.py

def summarize_by_date(records):
    """支出を日付ごとに合計する"""
    return []

AI への指示

残り 4 回
AI に依頼するにはが必要です

ヒント