Claude Code Harness & Graph Engineering クロードコード応用 CLIハーネスエンジニアリング実務

講義では、Claude Code architectureを通じて、なぜモデルよりもハーネスが重要なのかを説明します。そして、Context Harness、Permission Harness、Verification Harness、Tool Harness、Subagent & Worktree Harness、Debugging Harnessという6つの構造で、Claude Codeの作業システムを設計する方法を扱います。その後は、CLAUDE.md、セッション管理、大規模なコードベースの制御、worktreeの並列運用、エラーログの分析、環境変数および設定スコープの問題追跡までつなげながら、実際のバックエンド・DevOpsの実務でClaude Codeを継続的に使っていくための基準を身につけていただきます。

難易度 初級

受講期間 無制限

AI
AI
claude
claude
Vibe Coding
Vibe Coding
harness
harness
AI
AI
claude
claude
Vibe Coding
Vibe Coding
harness
harness

学習した受講者のレビュー

4.4

5.0

이태용

61% 受講後に作成

ハーネスエンジニアリングの基礎知識をしっかりと学ぶことができて良かったです。

5.0

안준우

32% 受講後に作成

段階別、状況別の重要単語をたくさん挙げてくださるので助かります。 その単語を繰り返し言ってくださることも、非常に役に立っています。

5.0

김민재

61% 受講後に作成

Claude Codeの活用法について、とても分かりやすく説明してくださっていますね!非専門家でもうまく活用できるように、概念的な部分も説明してくれて助かります!(すべて理解できるかは分かりませんが…)

受講後に得られること

  • Claude Code CLIを実プロジェクトに組み込むためのハーネス設計基準

  • CLAUDE.md、セッション管理、コンテキスト制御を通じた大規模コードベースの作業環境設計能力

  • Claudeが実行できる行動範囲を定めるpermissions / 権限ポリシーの設計能力

  • Claudeが作成した結果をそのまま信じず、テスト・diff・反例で検証するVerification Harnessの実務感覚

  • worktreeと並列セッションを活用してマルチタスクを安全に隔離するSubagent & Worktree運用能力

  • エラーログ、環境変数、設定スコープ、再現が難しいバグをClaudeが解決できるように整理する、Debugging Harnessの実践スキル

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をインストールしてみたものの、実際のプロジェクトでは使い続けられない開発者

GUIでは気軽に質問して回答を得られたものの、いざ実務となると再びターミナルに戻り、ログを読み、テストを実行し、diffを確認し、Gitブランチを整理していたなら、この講座が必要です。この講座では、Claude Codeを「ちょっと試してみるツール」から「実際のプロジェクトで使い続けるツール」へと変えるための基準を学べます。


Claudeが大規模なコードベースで30分でできることに5時間も取り組んだ、非専攻出身の開発者

問題は単にモデルの性能ではなく、Claudeがどの情報を参照し、どの範囲で動くべきかという設計が不足していた可能性が高いです。この講座では、Context HarnessとCLAUDE.md、セッション管理、コンテキストの再設計を通じて、Claudeが大規模なコードベースで迷いにくくなる実践的なパターンを扱います。

AIコーディングツールを「うまく使ってみるレベル」ではなく「実務システムとして運用するレベル」まで引き上げたい開発者/非専攻者

単なる機能紹介ではなく、どの作業をClaudeに任せ、どの作業は自分で判断すべきか、どの結果をテストやdiffで検証すべきか、どの自動化をHooks/MCP/Skillsで拡張すべきかといった実務的な基準を求めている方におすすめです。特にバックエンド開発者、DevOpsエンジニア、テックリードに適しています。

受講後は

この講座を受講すると、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 / プランモード / スキル

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

ハーネス・マップ / コンテキスト・ハーネス / 権限ハーネス / 検証ハーネス / ツール・ハーネス / サブエージェント & ワークツリー / デバッグ・ハーネス

第2セクションは、この講義の核心です。

Claude Codeを実際のプロジェクトに組み込むために必要な6つのハーネスを、1つの作業システムとして説明します。Claudeがどの情報を見るべきか、どこまで行動できるのか、どの結果をどのように検証すべきか、どのツールをどのような構造で接続するのか、並列作業をどのように隔離するのか、ログと環境変数をどのように問題解決可能な形に変えるのかを、大きな全体像として捉えます。その後の実習セクションでは、このマップを実際に実装します。



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

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

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

  • CLAUDE.md
    Claude가 프로젝트에서 따라야 할 작업 규칙을 정의합니다.

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

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

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

  • 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開発

    • 実証された教育力

何か質問がありますか?

Q. Claude Codeを少し使ったことがありますが、それでもこの講義は役立ちますか?

はい。むしろClaude Codeを少しでも使ったことがある方ほど、この講義の内容がより強く実感できる可能性が高いです。最初は便利そうに見えたものの、実際のプロジェクトに導入してみるとClaudeが何度も道に迷ったり、テスト・Git・デプロイといった最後の段階では結局人が直接作業しなければならなかったりして、物足りなさを感じた経験があるなら、この講義はまさにその問題を扱います。この講義は機能紹介よりも、「使い続けられる構造」に重点を置いています。

Q. 公式ドキュメントを見ればよいのではないですか?

公式ドキュメントは、最新かつ正確な情報の基準点です。しかし、公式ドキュメントを読むだけでは、「いつ、どの機能を使うべきか」「大規模なコードベースでなぜ失敗するのか」「どのルールをCLAUDE.mdに入れ、どれをpermissionsに切り出すべきか」「セッションが汚染されたときに、どう立て直せばよいか」といった実務上の判断基準まで身につけるのは難しいでしょう。この講義では公式ドキュメントにも触れますが、論文の内容をもとにしています。実務ですぐに適用できる構造と判断基準を提供します。

Q. この講義ではどのレベルまで扱いますか?

この講義は、入門向けの「手早くアプリを1つ作ってみる」講義ではありません。

Claude Code CLIを実際のプロジェクトやモバイルアプリ開発、バックエンド、フロントエンド、DevOpsなどの作業フローに定着させるための中級実践講座です。そのため、ログ分析、セッション管理、CLAUDE.md、contextの再設計、worktreeの並列運用、ボーナス講義ではモデルルーティングやコンテキスト予算の管理といった内容まで提供する予定です。

受講前の参考事項

実習環境

  • オペレーティングシステムはmacOSを最も推奨しており、WindowsユーザーにはWSL環境を推奨します。Linux環境でもほとんど同様に進められます。実習はClaude Code CLIを中心に進めるため、ターミナルの使用経験があるとよりスムーズです。プロジェクト構造を扱い、Git/worktreeも一部使用するため、基本的な開発環境が整っている状態が望ましいです。

学習教材

  • PPT、Notion

  • 講義では単なるリンク集ではなく、実務ですぐに活用できるテンプレートと基準表を中心とした資料を提供します。たとえば、CLAUDE.mdテンプレート、context packの例、セッション整理用プロンプト、worktree運用プレイブック、モデルルーティング基準表などの資料を通じて、復習時に動画を最初から見直さなくても済むように構成しています。

  • 提供資料


    ▎ 受講生専用GitHubリポジトリ(ドキュメント33件・5,540行)


    ▎ - 実習5種 — ステップ別進行ガイド + コピー用プロンプト29個 + サンプルデータ


    ▎ - ハーネス設定完成版 — Skill 2種、Hook 4種、CLAUDE.md(動作確認済み)


    ▎ - モデル別プロンプトブロック 5種 — Opus 5 / 4.8 / Sonnet 5 / Haiku 4.5 / Fable 5


    ▎ - Graph Engineering資料 — インタラクティブな学習シート+実行可能なデモプロジェクト3種


    ▎ - 参考ドキュメント6種 — 環境準備、検証表、質問・テストカード、記録表

前提知識および注意事項

  • 基本的な開発経験、CLIの使用経験、Gitの概念を理解していると、より望ましいです。

  • この講義はClaude Codeを楽しく「ちょっと試してみる」講義というより、実際のプロジェクトで継続して使える仕組みを作る講義なので、専門を問わず受講者に適したハーネスエンジニアリングの手法を提供します。

こんな方に
おすすめです

学習対象は
誰でしょう?

  • Claude Codeをインストールしてみたものの、実際のプロジェクトで使い続けるまでには至らなかった開発者

  • GUI型Claudeに限界を感じ、CLIベースの実務的な使い方を必要としている開発者

  • CLAUDE.md、権限、フック、MCP、サブエージェントについて、機能紹介ではなく実務基準で学びたい方

  • AIコーディングツールを「使ってみるレベル」ではなく、「作業システムとして運用するレベル」まで引き上げたい開発者

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

  • ChatGPT、ClaudeなどのLLMの使用経験があれば、なお良いです。

こんにちは
americasnailです。

インフラン認証

1,968

受講生

111

受講レビュー

81

回答

4.4

講座評価

8

講座

  • シリコンバレーの生存者|アメリカカタツムリ

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

    • 現)シリコンバレーのAIコーディングエージェントスタートアップ創業者

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

      • Google for Startups Programに選出

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

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

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

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

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

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

    • 実証された教育力

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

      • 累計受講生1800+人を輩出、SNSスレッド4.5K+/Substackフォロワー470+を保有

もっと見る

カリキュラム

全体

57件 ∙ (8時間 3分)

講座資料(こうぎしりょう):

授業資料
講座掲載日: 
最終更新日: 

受講レビュー

全体

55件

4.4

55件の受講レビュー

  • jbsh님의 프로필 이미지
    jbsh

    受講レビュー 13

    平均評価 5.0

    5

    32% 受講後に作成

    段階別、状況別の重要単語をたくさん挙げてくださるので助かります。 その単語を繰り返し言ってくださることも、非常に役に立っています。

    • americasnail
      知識共有者

      アン・ジュヌ様、具体的で貴重な受講の感想をいただきありがとうございます。今日も良い一日をお過ごしください :)

  • kevinx64님의 프로필 이미지
    kevinx64

    受講レビュー 2

    平均評価 5.0

    5

    61% 受講後に作成

    Claude Codeの活用法について、とても分かりやすく説明してくださっていますね!非専門家でもうまく活用できるように、概念的な部分も説明してくれて助かります!(すべて理解できるかは分かりませんが…)

    • americasnail
      知識共有者

      貴重な受講評をいただき、ありがとうございます。様々なフィードバックを通じて、現在アップデート計画を策定中です。すべての方に理解していただけるよう作り上げていきます。 ありがとうございます。良い一日をお過ごしください。

  • jinp19933808님의 프로필 이미지
    jinp19933808

    受講レビュー 6

    平均評価 5.0

    5

    32% 受講後に作成

    実務でハーネスを適用しようと試みたものの、毎回失敗して時間を無駄にするばかりでしたが、これほど体系的にハーネスを構築すべきだということを初めて知りました。特にエージェントスキルやhooksなど、いつ使うべきかも分からず、こうした機能までAIに作成を任せていましたが、用途と使い方が分かったので、これからはより上手く活用できそうです。

    • americasnail
      知識共有者

      貴重な受講評、誠にありがとうございます。☺️ これからも論文や実例に基づき、Claude Codeを実務でより安定的に活用できる内容で、継続的に補強してまいります。

  • wowmen17577817님의 프로필 이미지
    wowmen17577817

    受講レビュー 2

    平均評価 5.0

    5

    61% 受講後に作成

    ハーネスエンジニアリングの基礎知識をしっかりと学ぶことができて良かったです。

    • americasnail
      知識共有者

      イ・テヨン様、こんにちは。大切な受講レビューをいただきありがとうございます。 今日も良い一日をお過ごしください。 今月のアップデートもぜひご期待ください!

  • hoojunlee7658님의 프로필 이미지
    hoojunlee7658

    受講レビュー 1

    平均評価 3.0

    修正済み

    3

    37% 受講後に作成

    講師の方の知識は豊富ですが、講義の伝達力の面では期待よりも残念な点が多く、中間評価としてデメリットや改善点を中心に残します。 1. 教材が不十分です。 添付されたPPT教材ですが、Claudeで作ったのは分かりますが、せめて改行やブロックの崩れなどの修正くらいはすべきではないでしょうか?(枚数も少ないので30分もかからないはずですが)。 動画内の教材はフォントが小さすぎて見えづらく、フォーカスが定まらないため、目で追うのを諦めました。説明と教材がバラバラです。 2. 導入から中盤にかけて、重複した不要な理論的説明が多すぎます。(聞いているうちに、いつ本論に入るのかと生殺しにされている気分です)。伝えたい内容は多いようですが、受講者の立場からは本論や核心を要約・整理するのが難しいです。 3. 後半こそは実習を期待していましたが、結局は講師の方のデモを見学しているような感じです。 もっと核心を中心とした目次構成にした上で、実務的な説明を加え、実質的なサンプルコードやmdをタイピングするように誘導しながら説明していただければ、より良くなると思います。 後半は一部しか目を通していませんが、期待を込めて必ず最後まで受講します。

    • americasnail
      知識共有者

      こんにちは、쭌1004様。 まず、改善点について貴重なご意見をいただき、心より感謝申し上げます。 7月後半に、お伝えいただいた部分について検討し、 改善事項を反映してアップデートを行う予定です。 ご不便をおかけし、申し訳ございません。 受講していただきありがとうございます。 それでは、良い一日をお過ごしください。

    • このレビューがどういうことを言っていたのか、今日決済して3ページほど進んだところで分かりました……進捗が7%を超えていてキャンセルもできないし……まったく…… ああ……文字が小さすぎてよく見えません……】【。

americasnailの他の講座

知識共有者の他の講座を見てみましょう!

似ている講座

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