コース一覧
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 エージェントは、書き換えるだけの道具ではありません。読んで説明させる使い方があります。しかも、こちらの方が先に覚えるべきです。

書き換えを頼むと、AI が何を理解したのかは差分からしか分かりません。説明を頼めば、理解のズレが変更が起きる前に見えます。

プレーンテキスト

先に聞く kakeibo.py の summarize は何をしていますか 次に頼む summarize を、食費だけの合計に変えてください

最初の質問で AI が「支出を月ごとに集計しています」と答えたら、そこで違うと気づけます。気づいた時点では、まだ1行も書き換わっていません。

質問の粒度

漠然と聞くと、漠然と返ってきます。

プレーンテキスト

悪い このコードを説明して 良い kakeibo.py の summarize 関数が、引数に何を受け取って何を返すかを教えてください

聞きたいことを入力と出力に分けると、答えが具体的になります。関数の理解に必要なのは、だいたいこの2つと、途中で何を捨てているかです。

聞き方のパターンは次のとおりです。

プレーンテキスト

何を受け取って何を返すか どんな入力のときに壊れるか この行はなぜ必要か

3つ目が特に効きます。意味の分からない1行を指して「なぜ必要か」と聞くと、その1行が消してよいものかどうかが判断できます。

答えを鵜呑みにしない

AI の説明は、もっともらしい間違いを含むことがあります。説明を読んだら、コードと照合してください。

照合の手順は次のとおりです。説明の中の具体的な部分を1つ選び、そこだけコードで確かめます。全部を検算する必要はありません。1つ合っていれば、残りも同じ精度で書かれている見込みが立ちます。1つ外れていたら、その説明は全部疑ってかかります。

質問から修正につなげる

読ませて理解が揃ったら、そのまま修正を頼めます。同じ会話の中なら、AI は直前の説明を覚えています。

プレーンテキスト

先の説明のとおりなら、食費のときだけ合計に入れるように変えてください

理解を揃えてから変更を頼む。 これが遠回りに見えて一番速い順序です。今回の演習では、まず自分がコードを読み、何が足りていないかを言葉にしてから修正を頼んでみてください。

完成条件

  • 触ってよいのは kakeibo.py だけです
  • 戻り値は カテゴリ名 をキー、件数 を値にした辞書にしてください
  • countByCategory 関数の戻り値で採点します

依頼

kakeibo.py の countByCategory を、カテゴリごとの件数を数える関数にしてください。いまは全体の件数しか返していません。

  • ・触ってよいのは kakeibo.py だけです
  • ・戻り値は カテゴリ名 をキー、件数 を値にした辞書にしてください
  • ・countByCategory 関数の戻り値で採点します

いまのコード

kakeibo.py

def countByCategory(records):
    """おこづかい帳の記録を数える"""
    return len(records)

AI への指示

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

ヒント