inflearn logo
知識共有
inflearn logo

Claude Codeハーネス実践 — AIが忘れず、ルールを守り、自ら検証するようにする14ステップ

プロンプトを長く書く代わりに、実際のプロジェクトで事故が起きるたびに、ルールファイル、記録、権限、フック、検証ルーチンを一つずつ作ります。5日間で実際に作成してサーバーにアップしたニュース通知ボットを題材に、画面キャプチャ211枚と指示87個を原文のまま収録。

1名 が受講中です。

難易度 中級以上

受講期間 無制限

claude
claude
AI
AI
JavaScript
JavaScript
PostgreSQL
PostgreSQL
Business Productivity
Business Productivity
claude
claude
AI
AI
JavaScript
JavaScript
PostgreSQL
PostgreSQL
Business Productivity
Business Productivity

受講後に得られること

  • 新しいセッションに昨日の決定を忘れさせないためのルールファイルと記録構造(CLAUDE.md、事実ファイル、思考記録)

  • セッションがしてはいけないことをできないようにする権限ファイルとフックのセット、そして本当に阻止されているかを確認する方法

  • 「できた」を信じず、コミット・サービス・回次ログで確認する検証ルーチンとデプロイスキル

  • 毎時ニュースを読み、キーワードに関連する記事をTelegramで送り、朝にはAI要約を送る、サーバー上で実際に稼働するボット

テキスト講義 — PDF 282ページ、画面キャプチャ211枚、指示87個の原文、実習リポジトリ公開

プロンプトをより長く書くのではなく、問題が起きるたびに仕組みを一つずつ作る

Claude Codeを数日使った人は、同じ3つの問題に直面します。昨日決めたルールを今日の新しいセッションは知りません。するなと言ったことをします。「完了しました」と言うのに、開いてみると完了していません。この3つを、より長いプロンプトを書いて直そうとして失敗したことがあるなら、この講義がぴったりです。

この講座は理論書ではありません。空のフォルダから始めて、実際に動くボットを1つ作ります――20社の報道機関のRSSを毎時間読み取り、自分のキーワードに該当する記事だけをTelegramに送り、毎朝AI要約レポートを送信するボットです。コードはすべてクロードコードが書きます。著者が行ったのは指示を出し、問題が起きたときにそれを1行のルールに変えることでした。その指示87個は原文のまま実習リポジトリに収録されており、画面キャプチャ211枚はすべて実際のターミナル画面です。

章ごとに一つずつ事故が起きます。新しいセッションが昨日の決定を覆しかけ(1章)、画面表示用の数字が保存方法まで決めてしまい(2章)、死んだフィード一つが全体を止め(3章)、セッションが数えていない数字を事実のように記録し(4章)、デプロイは青信号なのに通知が届かず(5章)、他人のサーバーを毎秒18回叩き(6章)、'防いだ'と信じていたものが漏れ出し(7章)、データベースが切れると静かに死に(8章)、ルールファイルが503行になり(9章)、9秒で作った要約がTelegramの9通のメッセージになり(10章)、「上げた」と3回聞いたのにサーバーは古いコードのままで(11章)、1日で記録17文が古くなります(12章)。計画したものの起きなかった事故も、そのまま記録しました。

インシデントが起きるたびに、ハーネスが一つずつ増えていきます。ルールファイル(CLAUDE.md)、インシデント記録と事実ファイル、データ決定文書、権限ファイル、フックセットとGitフック、デプロイスキル、検証ルーチンセット、リクエストとコストの台帳、記録リンター。最終章では、それらを七つの要素に整理し、最初から作り直すなら初日に用意するものと、インシデントが起きて初めて作るものを分けます。

テキスト講義です。 動画なしでPDF 282ページ(S章と0~13章、付録A~G)および授業ノートを読み進めます。実習リポジトリ:https://github.com/JCLab-coder/news-radar(公開、コードはMIT、章別タグch00~ch12)。

講義を受講すると、このような成果物を作れるようになります

  • 実際に動くボット。サーバー(Railway)で毎時間ニュースを読み込み、自分のキーワードに該当したものだけをTelegramに送り、毎朝AI要約レポートを送信します。キーワードを変更するだけでそのまま使えます。

  • ハーネス一式。 ルールファイル1つ、プロジェクトドキュメント23個、権限ファイル1つ、スキル1つ、Claude Codeフック3つとgitフック1つ、スクリプト10本。ファイル全文と別プロジェクト用のテンプレートは付録にあります。

  • 1つの習慣。事故が起きたら、それを1行のルールに変える習慣。ボットはいずれ使わなくなり、ルールファイルもプロジェクトごとに書き直すことになりますが、この習慣は残ります。

最初のTelegram通知(1件)

キーワードに該当する記事だけをタイトルとリンクで。4,096文字の上限を行単位に分けて送ることもこのとき学ぶ。

朝のレポートのAI要約(10章)

87件を9.2秒で要約し、その次の事故が'テレグラム9通'だった。

'올렸다'の形式(11章)

コミット、サービス、回次ログの三つが揃って初めて「上げた」だ。レポートサービスは翌朝まで「上げている途中」。

13章時点のリポジトリ

docs/facts、docs/lessons、scripts/hooks、.claude/skills――コードよりも、これらの仕組みこそがこのリポジトリの本体だ。

  • 新しいセッションが昨日の決定を忘れないようにするルールファイルと記録構造を自分で構築できます――ルールだけを残すCLAUDE.md、根拠と実測値を置くファクトファイル、思考の記録、データに関する意思決定文書。

  • セッションがしてはいけないことをできないよう権限ファイルとフックで防ぎ、「防いだ」と信じ込まず、偽の入力で本当に防げるか確認できます。

  • 「できた」にコミット、サービス、実行回ログが紐づいていなければならないという検証ルーチンを、デプロイスキルとスクリプトで定着させられます。

  • 他人のサーバーや有料APIを呼び出す際に、まず上限と台帳を設ける理由を、1秒間に18回叩いた事故とTelegramを9通送った事故から学びます。

  • 記録が一日で古びることを理解し、事実の各文に確認コマンドを付けてリンターで再確認する構造を作れます。

学習内容

  • 14段階(0章〜13章)と準備章(S章)、付録7つ。各章は「事故 → 原因 → ルール → 確認」の順に進みます。機能を一つずつ紹介する本ではなく、事故が先に起こり、それに続いて仕組みが導入される構成なので、順番どおりに読む必要があります。

  • すべての章にセッション画面のキャプチャと著者が実際に入力した指示(P番号)があり、章末には読者向けチェックリストがあります。

第1章 — 最初のルールファイル CLAUDE.md が作成された場所

セクション1. 準備と第1部 — 忘れないようにする(S章、0~2章)

準備するものは、このプロジェクトのために新たに作るものだけ。ルールファイルのない最初のセッションで、同じ指示が毎回違う形に組み立てられるのを目にし、新しいセッションが昨日を知らない場所で最初のルールファイルが、画面用の数字が保存方法まで決めていた場所でデータ決定文書が生まれます。

セクション2。第2部 — ルールを守らせる仕組み(第3〜7章)

死んだフィード1つが全体を止めたことから最初の検証ルーチンが、数えていない数字を書いたことからインシデント記録が、緑色なのに通知が届かないデプロイからデプロイスキルが、他人のサーバーを毎秒18回叩いたことから上限と台帳と権限ファイルが、「止めた」が漏れ出したことからフックセットとgitフックが生まれます。

7章 — フックが .env へのアクセスを防ぐ章

第11章——每小时服务都在运行旧代码

セクション3. 第3部 — 自ら検証するようにする(8〜11章)

データベースが切断されると静かに死んでいたところから失敗処理の骨格と実行回数の上限が生まれ、503行になったルールファイルから記録の4か所への分離とレポートサービスが生まれ、Telegramの9通からコスト台帳と1日の上限が生まれ、「上げた」3回からサーバーは古いコードだったことが判明し、コミットを🏁の行に記録する3つ目の検証ルーチンが生まれます。

セクション4、5。運用と振り返り、付録(12~13章、付録A~G)

1日で、古い記録17文から記録用リンターが生まれ、最終章ではハーネスの7要素と「最初から作り直すなら初日に置くもの」を整理します。付録には、CLAUDE.md全文、テンプレート5種、フックとスクリプト全文、思考→ルール表20件、チェックリスト52個、参考資料と著作権、キー・環境変数・サーバー設定の総まとめを収録しています。

第12章 — リントが古い記録の17文を検出する

受講前の注意事項

  • この講義はテキスト講義です。動画はなく、各ユニットにPDFと授業ノートがあります。最後の授業に全体をまとめたPDF 1冊(282ページ)があります。

  • インストール、登録、支払いの手順は扱いません。Claude Code のインストールと料金プラン、Telegram と Railway と OpenRouter の登録については、各サービスの案内に従ってください。

実習環境

  • オペレーティングシステム:著者は macOS で進めました。ターミナルと Node.js が動作する環境であれば問題ありません。

  • 使用ツール:Claude Code(すでに使用している必要があります)、Node.js 20.12以上、ローカルPostgreSQL、Telegramアカウント(ボット1つ)、git。

  • 有料:5章からサーバーのRailway(Hobby、月5ドル未満――本書の実習では2日間でわずか$0.03)、10章からOpenRouter APIキー(本書の10章の実習全体でわずか$0.1)。

  • PC仕様:特別な要件なし。GPU不要。

学習資料

  • PDF 282ページ(全編1冊+ユニット別8本、ページ番号は全編基準)。本文約165,000字、スクリーンショット211枚。

  • 実習リポジトリ(公開、MIT):https://github.com/JCLab-coder/news-radar。各章の終わりごとにタグ(ch00~ch12)があり、いつでも任意の時点に戻って新しいフォルダーで動かしてみることができます。著者がセッションに入力した指示87件がprompts/に原文のまま収録されています。

  • 付録にルールファイル全文、テンプレート5つ、フックとスクリプト全文、思考→ルール表、チェックリスト総まとめ、準備物の総まとめ。

前提知識および注意事項

  • 前提知識:Claude Codeを数日以上使ったことがあり、JavaScriptを読めれば十分です。書けなくても構いません。

  • 順番どおりに読む必要があります。フックが第7章に登場する理由は、第6章で先に問題が起きるからです。自分で作ることをおすすめします。リポジトリは、行き詰まったときに照らし合わせるためのものです。Claude Codeは同じ指示でも毎回少しずつ違うコードを書きます。自分のコードが本と違っていても、間違いというわけではありません。


  • ご質問は講義の質問掲示板に投稿していただければ、回答いたします。Claude Codeや各サービスの画面は変更される場合があり、変更された箇所はお知らせでご案内します。

  • 著作権:本文、画面キャプチャ、PDFは購入者本人の学習目的にのみ使用でき、他人に渡したり、公開された場所に掲載したりすることは許可されていません。実習リポジトリのコードにはリポジトリのライセンス(MIT)が適用されます — コードと本は別の条件です。

こんな方に
おすすめです

学習対象は
誰でしょう?

  • Claude Codeを数日使ってみたけど、今日新しいセッションを始めると、昨日決めたルールを知らない。

  • 「完了しました」と聞いて開いてみたら、完了していなかった経験がある人

  • プロンプトをもっと長く書いてその問題を直そうとして失敗した人

前提知識、
必要でしょうか?

  • すでにClaude Codeを使用している必要があります。インストール、料金プラン、登録手順については扱いません。

  • JavaScriptを読めれば大丈夫です。書けなくても構いません。第5章からRailway(月5ドル以下)、第10章でOpenRouter APIキー(全実習で0.1ドル)が必要です。

こんにちは
jclabです。

キャリア認証

サービスを作り、運用する開発者です。

Claude Codeを実務で使う中で経験したことと、そこから生まれたルールを共有します。理論よりも、実際に起きた問題とコードの原文をもとにお話しします。

開発、運用、データ、自動化まで、必要なものは自分で作って使います。

もっと見る

受講レビュー

まだ十分な評価を受けていない講座です。
みんなの役に立つ受講レビューを書いてください!

似ている講座

同じ分野の他の講座を見てみましょう!

期間限定セール

¥74,250

25%

¥12,177