コース一覧
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 エージェントに最初に頼むことは、間違えてもすぐ気づける小ささにしてください。

プレーンテキスト

良い最初の依頼 表示されている文言を変える 悪い最初の依頼 データベースの設計をやり直す

表示が変わったかどうかは、動かせば1秒で分かります。設計のやり直しは、良し悪しが分かるまでに何時間もかかります。

AI の癖を掴むまでは、検証が速いものから頼む。 これは慣れてからも有効な進め方です。

対象と変更を分けて書く

指示は2つの要素でできています。

プレーンテキスト

対象 どのファイルの、どこを 変更 どう変えるのか

片方が抜けると、AI は推測で埋めます。

プレーンテキスト

悪い 合計を直して 良い report.py の合計表示を、税込10パーセントを足した金額にして

「直して」では、何が正しいのか AI には分かりません。いまどうなっていて、どうなってほしいのかを書きます。

数字は数字で書く

プレーンテキスト

悪い 税込にして 良い 10パーセントを足して、小数は切り捨てて

税率が何パーセントかは、国や時期によって変わります。切り捨てか四捨五入かも決めないと、AI がどちらかを選びます。

指定しなかったものは、AI が決める。 これがエージェントを使うときの基本の性質です。決まっていることは全部書く、と考えてください。

変更範囲を縛る

プレーンテキスト

report.py だけを変えてください。他のファイルは触らないでください。

頼んでいないファイルまで「ついでに」整理されることがあります。親切ではありますが、レビューする側は差分が増えるほど見落とします。

このコースの演習では、触ってよいファイルがあらかじめ決まっています。それ以外を書き換えて返してきても、システムの側で捨てます。実務でも同じ考え方で、変更範囲を先に決めてから頼むのが安全です。

返ってきたら必ず読む

AI が返したコードは、動くとは限りません。読まずに採用するのは、他人が書いたコードをレビューせずにマージするのと同じです。

次の回で差分の読み方を扱いますが、まずは「返ってきたものを自分の目で見る」ところから始めてください。

完成条件

  • 触ってよいのは report.py だけです
  • 税率は10パーセント、小数は切り捨てにしてください
  • returnTotal 関数の戻り値で採点します

依頼

report.py の合計表示を、税込10パーセントを足した金額にしてください。小数は切り捨ててください。

  • ・触ってよいのは report.py だけです
  • ・税率は10パーセント、小数は切り捨てにしてください
  • ・returnTotal 関数の戻り値で採点します

いまのコード

report.py

def returnTotal(items):
    """商品の価格をまとめて合計する"""
    return sum(items)

AI への指示

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

ヒント