Claude CodeのHarnessとMods、Graph Engineering：高度なCLIハーネスエンジニアリング実務

GUIではClaude Codeは楽しいかもしれません。

しかし、CLIのハーネス設計において、Claude Codeはお金になります。

この講義では、Claude Code CLIを単なるAIコーディングツールとして紹介するのではありません。代わりに、Context、Permission、Verification、Tool、Subagent、Debugging Harnessという観点から、Claude Codeを実際のバックエンド・DevOpsワークフローに定着させる方法を扱います。ログ分析、バグ修正、テストの復旧、CLAUDE.mdの設計、セッション管理、worktreeの並列運用までをつなげながら、Claudeが実際のプロジェクトで安全に作業できるワークシステムの設計方法を学べます。

このような方におすすめです

受講後には

この講義を受講すると、Claude Codeを単なる「うまくプロンプトを入力するためのツール」とは捉えなくなります。代わりに、Claudeが何を見るべきか、どこまで行動できるのか、どのように結果を検証すべきか、セッションが汚染された場合にいつclear/compact/restartすべきか、worktreeと並列セッションをどのように運用すべきかまで判断できるようになります。

具体的には、CLAUDE.mdにプロジェクトのルールや禁止事項を構造化して固定できるようになり、ログ・環境変数・設定スコープの問題をClaudeが解決できる形に整理できるようになります。また、Claudeが提案した修正案を、テスト・diff・反例検証のループで検討できるようになります。つまり、Claude CodeをGUI型の補助ツールではなく、実際のバックエンド・DevOpsの作業フローに組み込めるレベルまで引き上げられるようになります。

毎回指示するClaude Codeから、私のルールどおりに動くClaude Codeへ

「テストまで確認して。」
「そのコマンドは実行する前に聞いて。」
「ログに機密情報を残さないで。」

Claude Codeを実務で使うほど、同じ指示を繰り返すようになります。コードを素早く作ることと同じくらい、どの作業を許可し、何を確認すれば完了とみなすのかを決めることが重要だからです。

今回のClaude Code Modsセクションでは、こうした要件をコードで実装します。8つの講義に沿って、1つの実習プロジェクトであるHarness Guard Kitを段階的に作成します。

• 実行前に判断する:ツール呼び出しを確認し、定めたルールに従って転送・承認依頼・拒否を処理します。

• 機密情報と作業記録を管理する: ログ内の機密情報をマスキングし、作業を追跡できる記録を設計します。

• 完了条件を確認する: 必要な検証を抜かしたまま作業が完了しないように、Completion Gateを構成します。

• コンテキストとコストを観察する：コンテキスト・キャッシュ・コスト情報を読み取り、観測値と推定値を区別します。

• 動作をテストしチームに共有する: 正常な状況だけでなく、拒否・エラーの状況も評価し、デプロイ・アップデート・撤回のフローまで扱います。

インストールした機能を使用するだけでなく、自分のプロジェクトに必要なClaude Codeの動作を自ら設計するプロセスです。

作業原則を実際の実行フローと結び付けたい開発者、AIが生成した結果を何度も確認することに時間を費やしている開発者、チームの作業基準を再利用可能なツールにしたい開発者におすすめです。

実習はテスト環境で行い、自作したGuardとClaude Code・組織の既存の権限ポリシーがどのように連携して機能するのかも学びます。

この講義の特徴

1. 機能の説明ではなく、論文に基づく「ハーネスエンジニアリング」の視点から教えます

この講義では、Claude Codeの機能を公式ドキュメントのように列挙することはありません。代わりに、Claude Codeが実際のプロジェクトで安全に作業できるよう、Context、Permission、Verification、Tool、Subagent、Debugging Harnessを設計する観点から説明します。そのため、頻繁に変わるバージョン情報に左右されにくく、実際のプロジェクトに適用できる基準が身につきます。

2. 大規模なコードベースと実際の実務上の課題を基準に扱います

単なるデモアプリの制作ではなく、大規模なコードベースでClaudeが迷わないようにする方法、セッションの汚染を減らす方法、worktreeと並列セッションを安全に運用する方法、GitHub Issue → PRのフローをClaudeと連携する方法まで扱います。実務で実際につまずくポイントから始めます。

このような内容を学びます

Claude Code CLIを実務で使い始める /

アーキテクチャ / メモリ / CLAUDE.md / プランモード / スキル

第1セクションでは、GUI型ClaudeとCLIの違いから明確に整理します。単にインターフェースの違いを比較するのではなく、なぜGUIでは「質問して答えをもらうこと」にとどまりやすく、CLIでは実際のログ、テスト、Git、デプロイ準備までつなげられるのかを説明します。その後、Claude Codeのアーキテクチャを通じて、モデルよりもハーネスが重要な理由を理解し、セッション間のメモリとCLAUDE.mdの役割、Plan/Thinking ModeとSubagents、SkillsとTool useの違いまで見ていきます。

コピーしてすぐに使えるハーネス設定ファイル

講義で直接作成するハーネス設定を完成したファイル形式ですべて提供します。
講義を受講した後、最初から書き直す必要はなく、自分のプロジェクトにコピーしてすぐに適用できます。

提供される設定は次のとおりです。

• CLAUDE.md
  Claudeがプロジェクトで従うべき作業ルールを定義します。

• codecraft-harness/SKILL.md
  短く曖昧な一文の依頼を、具体的な設計と実装計画に変換します。

• solid-review/SKILL.md
  実装を開始する前に、責任の分離が適切か、不必要に複雑な設計になっていないかを確認します。

• block-sensitive-paths.sh
  .env、SSH Key、プロジェクトの親フォルダなど、機密性の高いファイルやパスへのアクセスをブロックします。

• run-tests-after-edit.sh
  Claudeがファイルを変更するたびに、関連するテストを自動的に実行します。

• block-stop-without-tests.sh
  テストを実行していない、またはテストに失敗した状態では、作業を完了したと報告できないようにします。

• guard.sh
  許可されていない外部ネットワークへのリクエストまでブロックし、安全な実行環境を構築します。

講義に含まれるHookは単なるサンプルコードではありません。
すべて実際の環境で実行し、動作を確認しました。

設定ファイルを登録すると、Claudeがコードを修正するたびに自動でテストが実行され、テストに失敗した状態では勝手に「作業を完了しました」として終了することはできません。

つまり、プロンプトでClaudeに検証を求める段階を超え、検証手順をシステムが強制的に実行するようにする方法を学びます。

3. モデル別プロンプト・プレイブック

同じハーネスを使用していても、モデルごとに従いやすい指示と見落としやすい指示は異なります。

この講義では、すべてのモデルに同じプロンプトを使用するのではなく、各モデルの特性に合わせてどの指示を削除し、どの指示を追加すべきかを整理した、コピーして使えるプロンプトブロックを5種類提供します。

• Opus 5
  モデルが自律的に行う検証指示を減らし、不要な重複作業を防ぎます。

• Opus 4.8
  必要なツールを適切なタイミングで使用するよう、ツール実行条件をより明確に指定します。

• Sonnet 5
  修正するファイルと適用範囲を文字どおり具体的に記述する方法を扱います。

• Haiku 4.5
  effortオプションがないモデルでも安定して作業できるよう、実行手順を段階ごとに詳しく記述します。

• Fable 5
  モデルに過度に多くの指示を与えず、必要な指示だけを残す方法を参考として紹介します。

各プレイブックには、以下の内容も併せて含まれます。

• リクエスト時に400 Errorが発生するパラメータの組み合わせ

• モデルごとの基本パラメータと動作の違い

• effort値を変更しながら結果を比較する記録表

• 同じプロンプトを複数のモデルで実行し、結果を比較するLab 04 実習

単に「どのモデルが優れているか」を説明するのではなく、同じタスクを繰り返し実行して結果を記録しながら、モデルごとの最適な設定を自分で見つける方法を身につけます。

Graph Engineering 実習資料 — Lab 05

複雑な作業を一度に順番どおり処理する方法と、複数の作業を依存関係に応じて分割して処理するGraph Engineering方式を実際に比較します。

インタラクティブ学習シート

別途インストールやサーバーの起動をせずに、HTMLファイルをブラウザで開いて使用できます。

同じリクエストが次の2つの方式でどのように異なる処理をされるのか、段階ごとに再生して確認できます。

• 1つのフローを繰り返すループ型実行

• 複数のノードと依存関係に分けてタスクを実行するグラフ型実行

各ステップを選択すると、その動作を作成した設定ファイルも併せて確認できるため、実行結果と設定の関係をすぐに理解できます。

ステップ別学習ガイド

全645行にわたる学習ガイドを提供します。

最初から理論を長々と説明するのではなく、次の順序で構成しています。

結論を確認 → 30分の実習 → 核心概念 → 発展理論

非専攻者向けの学習パスと、開発経験のある受講生向けの学習パスも分けられています。

バイブコーディングでClaude Codeを初めて使う方も実習から始められ、開発者は内部動作や設計原理までより深く学ぶことができます。

直接実行できるデモプロジェクト3種

設定ファイルを読むだけで終わるのではなく、実際のプロジェクトフォルダでclaudeを実行し、Hookが作業をブロックして検証するプロセスを自分で確認します。

各プロジェクトには、次の問題が意図的に含まれています。

• 型エラー

• テスト失敗

• 一見正常に見えるロジックバグ

受講生は次の流れを自ら体験することになります。

問題検知 → 作業ブロック → コード修正 → テスト実行 → 検証合格

ループ型プロジェクトとグラフ型プロジェクトは同じコードを使用し、ハーネス設定のみ異なるように構成されています。

したがって、コードの違いではなく、作業を組織する方法の違いによって結果がどのように変わるかを正確に比較できます。

参考ドキュメント

講義を受講した後も、プロジェクトを構成したり問題を解決したりする際に参照できるよう、実務向けのドキュメントも併せて提供します。

• 環境設定ガイド
  実行環境の準備、Hookの登録方法、よくあるエラーと解決方法をまとめます。

• Skill / Hook / CLAUDE.md / Testの役割の違い
  各構成要素が何を担当し、どのような問題にどのツールを使用すべきかを説明します。

• ハーネス点検チェックリスト
  プロンプト、設計、実装、テスト、完了条件に漏れがないか確認できます。

• 質問カードとテストカード
  要件が曖昧なときに使う質問、テスト設計の基準、検証表テンプレートを提供します。

• モデル別プレイブック文書
  モデル別のパラメータ、動作特性、プロンプト作成基準を一か所にまとめます。

• モデル評価記録表
  同じタスクを複数のモデルや設定で実行した後、結果を比較して記録できます。

これらの資料は単なる講義の付録ではなく、実際のプロジェクトで繰り返し使用できるClaude Codeハーネス運用マニュアルとして構成されています。

この講義を作った人

• シリコンバレーのサバイバー | アメリカカタツムリ 

  Global Tech Sceneの最前線で培った経験とノウハウをもとに、非専攻者が技術の壁を乗り越え、ビジネスのオーナーになる道筋を示します。

  • 現）シリコンバレーAIコーディング＆amp;ローカルモデルファインチューニングエージェントスタートアップFounder

    • Closiro CLI/Macデスクトップの開発・運用（20K+ダウンロード）

    • Google for Startups Program 선정

    • Anthropic for Startups Programに選出

  • 前）米国ビッグテックおよび有望スタートアップのエンジニアとしてのキャリア

    • Amazon最終段階、起業のため辞退

    • シリコンバレーAIフィンテックスタートアップエンジニア

    • OpenAI / Meta / Apple / Adobe / Amazon フルスタック・フェローシップ

    • 国内検索エンジンポータル、フィンテック開発

    • AIスタートアップ AR/B2B/SDK開発

  • 実証された教育力

    • ソウル市内の4年制大学でコンピュータ工学・経営学を複数専攻し、複数の起業経験あり

    • 累計受講生2,100名以上を輩出、SNSのスレッド4.5K以上／Substackフォロワー500人以上を保有

    • Threads: https://www.threads.com/@rich_l_2024?igshid=NTc4MTIwNjQ2YQ==

    • Substack サブスタック：https://open.substack.com/pub/1234373801

何か気になる点はありますか？

受講前の参考事項