コース一覧
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分

つくる:操作の一巡

4手を1周する

この章で1つずつ扱ってきた操作を、続けて1周します。順番は次のとおりです。

プレーンテキスト

1. 依頼 対象、現状、変更後を書いて頼む 2. 差分 何が消えて何が足されたかを読む 3. 実行 端と例外を含めて動かす 4. 判断 採用するか、差し戻すか、破棄するか

この4手が基本サイクルです。以降の章で扱うことは全部、このサイクルの上に乗ります。順番を飛ばさないことだけを守ってください。

飛ばしたときに何が起きるか

プレーンテキスト

差分を飛ばす 頼んでいない変更に気づかないまま取り込む 実行を飛ばす 読んで納得したコードが、空リストで落ちる 判断を飛ばす 何となく採用して、後で理由を説明できなくなる

どれも「今回はたぶん大丈夫」で飛ばせてしまいます。飛ばした回に限って壊れる、というのが厄介なところです。毎回同じ手順を踏むのが結局いちばん速くなります。

依頼に書き切る

1周を1回で終わらせるコツは、依頼の時点で条件を出し切ることです。この章で出てきた要素を並べると次のようになります。

プレーンテキスト

ファイル名と関数名 いまどうなっているか どう変えたいか 境界の扱い (0を含むか、一致は完全一致か) 該当が無いときの戻り値 変えてはいけないもの (関数名、引数の順) 触ってよいファイルの範囲

多く見えますが、書くのは数行です。この数行を惜しんで、差し戻しを2往復する方がずっと時間を使います。

今回つくるもの

おこづかい帳に、カテゴリごとの合計を一度に出す機能を足します。これまでは1カテゴリずつ合計していました。今回は全カテゴリぶんをまとめて返します。

戻り値の形を、依頼の時点で決めておいてください。決めずに頼むと、リストで返ってくるか辞書で返ってくるかが AI 任せになります。

書いたら差分を読み、空の記録でも動くことを確かめてから採用してください。

完成条件

  • 触ってよいのは kakeibo.py だけです
  • 戻り値は カテゴリ名 をキー、そのカテゴリの合計金額 を値にした辞書にします
  • 記録が空のときは空の辞書を返します
  • categoryTotals 関数の戻り値で採点します

依頼

kakeibo.py の categoryTotals を、カテゴリごとの合計金額を辞書で返すように仕上げてください。いまは全体の合計しか返していません。

  • ・触ってよいのは kakeibo.py だけです
  • ・戻り値は カテゴリ名 をキー、そのカテゴリの合計金額 を値にした辞書にします
  • ・記録が空のときは空の辞書を返します
  • ・categoryTotals 関数の戻り値で採点します

いまのコード

kakeibo.py

def categoryTotals(records):
    """おこづかい帳の金額をまとめる"""
    total = 0
    for r in records:
        total += r["amount"]
    return total

AI への指示

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

ヒント