Claude Code Harness & 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の作業フローに組み込めるレベルまで引き上げられます。

この講義の特徴

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

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

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

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

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

Claude Code CLIを実務で始める /

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

最初のセクションでは、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コーディングエージェントスタートアップ創業者

    • 自社開発AIツール 'Snailer CLI' を運営（18K+ダウンロード）

    • Google for Startups Programに選出

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

    • Amazonの最終選考まで進むも、起業のため辞退

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

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

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

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

  • 実証された教育力

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

    • 累計受講生1,900人以上を輩出、SNSのスレッド4.5K+／Substackフォロワー480+を保有

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

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

何かご質問はありますか？

受講前の参考事項