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

動きのしくみ

行動ログが流れている

依頼を出すと、返事が来るまでのあいだに画面へ短い行が流れます。これが行動ログです。エージェントが「いま何をしたか」を1行ずつ残していきます。

プレーンテキスト

Read kakeibo.py Read report.py Edit kakeibo.py Bash python kakeibo.py

読んだファイル、書き換えたファイル、走らせたコマンド。全部ここに出ます。読み飛ばさないでください。 最後の返事より、この途中経過のほうが情報量が多いことがよくあります。

ログから分かる3つのこと

ログを見て、次の3つを毎回確かめます。

プレーンテキスト

読んだ範囲 狙ったファイルを開いたか。見当違いを探し回っていないか 書いた範囲 頼んでいないファイルまで Edit されていないか 実行の有無 直したあと、動かして確かめたか

たとえば「kakeibo.py の合計を直して」と頼んだのに、ログに Edit report.py が混ざっていたら、その時点で止めます。その1行を見逃すと、あとで原因不明の不具合になります。

読んでいないものは直せない

ありがちな失敗は、エージェントが対象を読まずに書き換えることです。

プレーンテキスト

良い Read kakeibo.py → Edit kakeibo.py 悪い Edit kakeibo.py (読まずに書いている)

読まずに書いたコードは、既存の書き方を無視した推測です。動くこともありますが、既存の関数と重複したり、命名がバラバラになったりします。

ログに Read が無いまま Edit が来たら、一度戻して「まず該当ファイルを読んでから直してください」と頼み直すのが早道です。

実行の結果まで見る

エージェントが python kakeibo.py を走らせたなら、その出力もログに出ます。ここでエラーが出ているのに、返事のほうは「修正しました」となっていることがあります。

返事の文章とログの事実が食い違ったら、ログを信じてください。 文章は書けてしまいますが、実行結果は書き換えられません。

追えるようにしておく責任

作業を1回で大量に頼むと、ログが数十行になって追えなくなります。追えない量を頼んだのはこちら側の問題です。

1回の依頼は、ログを目で追いきれる量にする。 これが、この先ずっと効いてくる目安です。

演習で確かめること

下の演習では、おこづかい帳の記録からカテゴリ別の合計を出す関数を直させます。返ってきたコードを読む前に、まずログでどのファイルを読み書きしたかを追ってみてください。

完成条件

  • 触ってよいのは kakeibo.py だけです
  • 該当するカテゴリが1件もないときは 0 を返します
  • sumByCategory 関数の戻り値で採点します

依頼

kakeibo.py の sumByCategory 関数を、指定したカテゴリの支出だけを合計するように直してください。該当がないときは 0 を返します。

  • ・触ってよいのは kakeibo.py だけです
  • ・該当するカテゴリが1件もないときは 0 を返します
  • ・sumByCategory 関数の戻り値で採点します

いまのコード

kakeibo.py

def sumByCategory(records, category):
    """記録の金額を合計する"""
    return sum(r["amount"] for r in records)

AI への指示

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

ヒント