inflearn logo

Claude Code Harness & Graph Engineering: Advanced Claude Code CLI Harness Engineering in Practice

The lecture explains why the harness is more important than the model through the lens of Claude Code architecture. It also covers how to design a Claude Code work system around six structures: Context Harness, Permission Harness, Verification Harness, Tool Harness, Subagent & Worktree Harness, and Debugging Harness. It then connects these concepts to CLAUDE.md, session management, controlling large codebases, parallel worktree operations, error log analysis, and tracking environment variable and configuration scope issues, helping you establish practical standards for continuing to use Claude Code in real-world backend and DevOps work.

(4.3) 52 reviews

704 learners

Level Basic

Course period Unlimited

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

Reviews from Early Learners

4.3

5.0

이태용

61% enrolled

It's great because it allows for a solid understanding of the basic knowledge of harness engineering.

5.0

안준우

32% enrolled

It is great that you list many key words for each step and situation. It is also very helpful that you repeat those words.

5.0

김민재

61% enrolled

You explain how to use Claude Code so well! I love that you also explain the conceptual parts so that even non-majors can use it effectively! (Though I'm not sure if I'll understand everything...)

What you will gain after the course

  • Design Criteria for a Harness That Integrates Claude Code CLI into Real-World Projects

  • Designing the ability to work on large codebases through CLAUDE.md, session management, and context control

  • The ability to design permissions / authorization policies that define the scope of actions Claude can take

  • Practical know-how for a Verification Harness that validates Claude’s output through tests, diffs, and counterexamples instead of trusting it as-is

  • Subagent & Worktree operational skills for safely isolating multiple tasks using worktrees and parallel sessions

  • Practical Debugging Harness skills for organizing error logs, environment variables, configuration scopes, and hard-to-reproduce bugs so Claude can solve them

Claude Code can be fun in a GUI.

However, in CLI harness design, Claude Code pays off.

This course does not introduce Claude Code CLI as a simple AI coding tool. Instead, it covers how to establish Claude Code within real-world backend and DevOps workflows through the lenses of Context, Permission, Verification, Tool, Subagent, and Debugging Harness. By connecting log analysis, bug fixes, test recovery, CLAUDE.md design, session management, and parallel worktree operations, you will learn how to design a work system that enables Claude to operate safely in real-world projects.

Recommended for developers who…

Developers who have installed Claude Code but can't keep using it in real-world projects

If you could ask questions and get answers conveniently through the GUI, but in actual work you found yourself back in the terminal reading logs, running tests, reviewing diffs, and organizing Git branches, you need this course. This course provides the framework for turning Claude Code from a “tool you try out briefly” into a “tool you keep using in real projects.”


A non-technical developer who spent five hours on what Claude could do in 30 minutes in a large codebase

The problem is likely not simply model performance, but insufficient design of what information Claude should see and the scope within which it should operate. This course covers practical patterns for helping Claude navigate large codebases with less confusion through Context Harnesses, CLAUDE.md, session management, and context redesign.

Developers and non-majors who want to advance from merely “trying AI coding tools” to operating them as a real-world system

This is recommended for those who need practical criteria beyond a simple feature introduction—such as which tasks to delegate to Claude and which to judge themselves, which results to verify through tests and diffs, and which automations to extend with Hooks/MCP/Skills. It is especially suitable for backend developers, DevOps engineers, and tech leads.

After completing the course,

After taking this course, you’ll no longer see Claude Code as merely a “tool for writing good prompts.” Instead, you’ll be able to determine what Claude needs to see, how far it can act, how to verify its results, when to use clear/compact/restart if a session becomes polluted, and how to manage worktrees and parallel sessions.

Specifically, you will be able to structurally codify project rules and prohibitions in CLAUDE.md, organize log, environment variable, and configuration scope issues into a form that Claude can solve, and review Claude’s proposed changes through a testing, diff, and counterexample verification loop. In other words, you will take Claude Code beyond being a GUI-based assistant and bring it to a level where it can be integrated into actual backend and DevOps workflows.

Features of this course

1. Rather than merely explaining features, this course teaches from a “harness engineering” perspective grounded in academic papers.

This course does not list Claude Code’s features like official documentation. Instead, it explains how to design Context, Permission, Verification, Tool, Subagent, and Debugging Harnesses so that Claude Code can work safely on real projects. As a result, you are less affected by rapidly changing version information and are left with principles that can be applied to real projects.

2. It covers large codebases and real-world work problems

Rather than simply building demo apps, this course covers how to keep Claude from getting lost in large codebases, reduce session contamination, safely manage worktrees and parallel sessions, and connect the GitHub Issue → PR workflow with Claude. It starts with the points where people actually get stuck in practice.

What you'll learn

Getting Started with Claude Code CLI in Practice /

Architecture / Memory / CLAUDE.md / Plan Mode / Skills

In the first section, we clearly lay out the differences between GUI-based Claude and the CLI. Rather than simply comparing interface differences, we explain why GUI use tends to stop at “asking a question and receiving an answer,” while the CLI can connect all the way to actual logs, tests, Git, and deployment preparation. We then use Claude Code architecture to understand why the harness is more important than the model, and explore the roles of memory across sessions and CLAUDE.md, as well as the differences between Plan/Thinking Mode and Subagents, and between Skills and Tool use.

Harness Map / Context Harness / Permission Harness / Verification Harness / Tool Harness / Subagent & Worktree / Debugging Harness

The second section is the core of this course.

This course explains the six harnesses needed to integrate Claude Code into a real project as a unified work system. It provides the big picture of what information Claude should see, how far it can act, how to verify results, which tools to connect and in what structure, how to isolate parallel work, and how to turn logs and environment variables into a form that makes troubleshooting possible. In the hands-on section that follows, you will implement this map in practice.



Harness configuration files you can copy and use right away

We provide all the harness configurations you create in the course as completed files.
After taking the course, you can copy them into your own project and apply them right away without having to rewrite them from scratch.

The provided settings are as follows.

  • CLAUDE.md
    Defines the working rules Claude must follow in the project.

  • codecraft-harness/SKILL.md
    Transforms a short, ambiguous one-sentence request into a concrete design and implementation plan.

  • solid-review/SKILL.md
    Before starting implementation, check whether responsibilities are properly separated and whether the design is unnecessarily complex.

  • block-sensitive-paths.sh
    .env, SSH keys, and sensitive files and paths such as the parent folder of the project are blocked from access.

  • run-tests-after-edit.sh
    Automatically runs the relevant tests every time Claude modifies a file.

  • block-stop-without-tests.sh
    It prevents you from reporting a task as complete when tests have not been run or have failed.

  • guard.sh
    It blocks even unauthorized external network requests, creating a safe execution environment.

The Hooks included in the course are not merely sample code.
We ran them all in real-world environments and verified that they work.

Once you register the configuration file, tests run automatically every time Claude modifies the code, and it cannot arbitrarily end by saying “I’ve completed the task” when the tests are failing.

In other words, you will learn how to go beyond asking Claude to perform verification through prompts and make the system forcibly execute the verification process.


3. Model-Specific Prompt Playbook

Even when using the same harness, each model differs in which instructions it follows well and which ones it is likely to miss.

In this course, instead of using the same prompt for every model, we provide five copy-ready prompt blocks that outline which instructions to remove and which to add based on each model’s characteristics.

  • Opus 5
    Reduce instructions for validations the model performs on its own to prevent unnecessary duplicate work.

  • Opus 4.8
    Specify tool execution conditions more clearly so that the necessary tools are used at exactly the right time.

  • Sonnet 5
    This covers how to specify, literally and concretely, the files that need to be modified and the scope of the changes.

  • Haiku 4.5
    Lay out the execution procedure step by step so you can work reliably even with models that do not have the effort option.

  • Fable 5
    We provide a reference approach for leaving only the necessary prescriptions without giving the model excessive instructions.

Each playbook also includes the following content.

  • Parameter combinations that cause a 400 Error when requested

  • Default parameters and behavioral differences by model

  • A record sheet for comparing results while changing the effort value

  • Run the same prompt on multiple models and compare the results in the Lab 04 exercise

Rather than simply explaining “which model is better,” you will learn how to find the optimal settings for each model yourself by repeatedly running the same task and recording the results.


Graph Engineering Hands-on Materials — Lab 05

Directly compare the approach of processing complex tasks sequentially in one go with the Graph Engineering approach of dividing multiple tasks according to their dependencies.

Interactive Learning Sheet

You can use it by opening the HTML file in a browser, without any separate installation or server startup.

You can play back step by step how the same request is handled differently in the following two approaches.

  • Repeating a single flow with loop-based execution

  • Graph-based execution that divides a task into multiple nodes and dependencies

By selecting each step, you can also view the configuration file that created that action, allowing you to immediately understand the relationship between the execution result and the configuration.

Step-by-Step Learning Guide

We provide a learning guide totaling 645 lines.

Rather than explaining the theory at length from the outset, it is structured in the following order.

Check the conclusion → 30-minute practice → key concepts → advanced theory

There are also separate learning paths for non-majors and for students with development experience.

Even if you’re using Claude Code for the first time through vibe coding, you can start with hands-on practice, while developers can delve deeper into its internal workings and design principles.

Three demo projects you can run yourself

Rather than simply reading the configuration file and stopping there, you will run claude in an actual project folder and see firsthand how the Hook blocks and validates the work.

The following issues have been intentionally included in each project.

  • Type error

  • Test failure

  • A logic bug that appears normal on the surface

Learners will directly experience the following flow.

Detect the issue → Block the task → Modify the code → Run the tests → Pass verification

Loop-based and graph-based projects use the same code, with only the harness configurations set up differently.

Therefore, you can accurately compare how results differ due not to code differences, but to differences in how the work is organized.


Reference documentation

We also provide practical documentation that you can refer to when setting up projects or solving problems even after completing the course.

  • Environment Setup Guide
    A summary of how to prepare the execution environment, register Hooks, and resolve common errors.

  • Distinguishing the Roles of Skills / Hooks / CLAUDE.md / Tests
    Explains what each component is responsible for and which tool to use for each problem.

  • Harness Inspection Checklist
    You can verify that nothing is missing from the prompt, design, implementation, tests, and completion criteria.

  • Question and test cards
    Provides questions to use when requirements are ambiguous, test design criteria, and a verification checklist template.

  • A model-specific playbook document
    It organizes each model’s parameters, behavioral characteristics, and prompt-writing guidelines in one place.

  • Model evaluation log
    You can run the same task with multiple models and configurations, then compare and record the results.

These materials are not merely course supplements; they are structured as a Claude Code harness operations manual that you can repeatedly use in real-world projects.


The person who created this course

  • Silicon Valley Survivor | American Snail 

    Based on experience and expertise gained at the forefront of the Global Tech Scene, this presents a path for non-majors to overcome technical barriers and become the owners of their businesses.

    • Current) Founder of a Silicon Valley AI coding agent startup

      • Operating the in-house AI tool 'Snailer CLI' (18K+ downloads)

      • Selected for the Google for Startups Program

    • Former engineer at major U.S. tech companies and promising startups

      • Gave up Amazon’s final-stage offer to start a company

      • Silicon Valley AI fintech startup engineer

      • OpenAI / Meta / Apple / Adobe / Amazon Full-Stack Fellowship

      • Domestic search engine portal, fintech development

      • AI startup AR/B2B/SDK development

    • Proven educational expertise

Do you have any questions?

Q. I've used Claude Code a little before. Will this course still be helpful?

Yes. In fact, this course is likely to resonate even more with those who have used Claude Code, even briefly. If it initially seemed convenient but, when you tried applying it to a real project, Claude kept losing its way, or you were disappointed that you still had to handle the final stages—such as testing, Git, and deployment—yourself, this course addresses exactly those problems. Rather than focusing on feature introductions, this course focuses on “the structure that makes you keep using it.”

Q. Can't I just refer to the official documentation?

Official documentation is the most up-to-date and accurate reference. However, simply reading the official documentation makes it difficult to gain practical decision-making criteria such as “when to use which feature,” “why things fail in a large codebase,” “which rules to put in CLAUDE.md and which to move to permissions,” and “how to regain control when a session becomes corrupted.” Although this course references the official documentation, it is based on the content of the paper. It provides structures and criteria you can apply directly in real-world work

Q. What level of material does this course cover?

This course is not an introductory “quickly build an app” course.

This is an intermediate, hands-on course designed to integrate the Claude Code CLI into workflows for real-world projects, mobile app development, backend, frontend, DevOps, and more. Accordingly, it will cover topics such as log analysis, session management, CLAUDE.md, context redesign, parallel worktree operations, and bonus lessons on topics like model routing and context budget management.

Notes Before Taking the Course

Practice environment

  • macOS is the most recommended operating system, and Windows users are encouraged to use a WSL environment. You can follow along in a Linux environment as well, for the most part. The exercises center on the Claude Code CLI, so having experience using the terminal will make things much easier. Since the course covers project structure and includes some use of Git/worktree, it is best to have a basic development environment set up in advance.

Learning materials

  • PPT, Notion

  • The course provides more than a simple collection of links—it offers materials centered around templates and reference tables that can be applied directly to real-world work. For example, materials such as the CLAUDE.md template, context pack examples, session summary prompts, a worktree operations playbook, and a model routing reference table are designed so that you can review without having to replay the video from the beginning.

  • Provided materials


    ▎ GitHub repository exclusively for course participants (33 documents · 5,540 lines)


    ▎ - 5 hands-on exercises — step-by-step guides + 29 copy-ready prompts + sample data


    ▎ - Completed harness configuration — 2 Skills, 4 Hooks, and CLAUDE.md (operation verified)


    ▎ - 5 Model-Specific Prompt Blocks — Opus 5 / 4.8 / Sonnet 5 / Haiku 4.5 / Fable 5


    ▎ - Graph Engineering Materials — Interactive learning sheets + 3 executable demo projects


    ▎ - 6 reference documents — environment setup, validation checklist, question and test cards, record sheet

Prerequisites and Important Notes

  • Basic development experience, experience using the CLI, and an understanding of Git concepts are ideal.

  • Rather than being a course where you casually “sample” Claude Code for fun, this course focuses on creating a structure you can continue using in real-world projects, so it provides harness engineering techniques suitable for all learners, regardless of their academic background.

Recommended for
these people

Who is this course right for?

  • Developers who installed Claude Code but couldn’t get themselves to keep using it in real projects

  • Developers who feel limited by GUI-based Claude and need practical CLI-based usage techniques

  • Those who want to learn CLAUDE.md, permissions, hooks, MCP, and subagents from a practical, hands-on perspective rather than through feature introductions

  • Developers who want to take AI coding tools beyond merely “trying them out” and up to the level of “operating them as a work system”

Need to know before starting?

  • Experience using LLMs such as ChatGPT or Claude is a plus.

Hello
This is americasnail

Inflearn Verified

1,929

Learners

106

Reviews

80

Answers

4.4

Rating

8

Courses

  • Silicon Valley Survivor | American Snail

    Drawing on experience and expertise gained at the forefront of the Global Tech Scene, I show non-majors how to overcome technical barriers and become the owners of their businesses.

    • Current) Founder of a Silicon Valley AI coding agent startup

      • Operating the internally developed AI tool 'Snailer CLI' (18K+ downloads)

      • Selected for the Google for Startups Program

    • Former engineer at U.S. big tech companies and promising startups

      • Gave up Amazon’s final-stage opportunity to found a startup

      • Silicon Valley AI Fintech Startup Engineer

      • OpenAI / Meta / Apple / Adobe / Amazon Full-Stack Fellowship

      • Domestic search engine portal, fintech development

      • AI startup AR/B2B/SDK development

    • Proven educational expertise

      • Dual major in Computer Engineering and Business Administration at a four-year university in Seoul, with extensive startup experience

      • Over 1,800 students taught cumulatively, with 4.5K+ followers on SNS Threads and 470+ Substack followers.

More

Curriculum

All

49 lectures ∙ (6hr 38min)

Course Materials:

Lecture resources
Published: 
Last updated: 

Reviews

All

52 reviews

4.3

52 reviews

  • wowmen17577817님의 프로필 이미지
    wowmen17577817

    Reviews 2

    Average Rating 5.0

    5

    61% enrolled

    It's great because it allows for a solid understanding of the basic knowledge of harness engineering.

    • americasnail
      Instructor

      Hello Taeyong Lee, thank you for your valuable course review. I hope you have a wonderful day today. Please look forward to this month's update as well!

  • kevinx64님의 프로필 이미지
    kevinx64

    Reviews 2

    Average Rating 5.0

    5

    61% enrolled

    You explain how to use Claude Code so well! I love that you also explain the conceptual parts so that even non-majors can use it effectively! (Though I'm not sure if I'll understand everything...)

    • americasnail
      Instructor

      Thank you for your valuable review. We are currently establishing an update plan based on various feedback. We will make sure to create it in a way that is easy for everyone to understand. Thank you. Have a great day.

  • jbsh님의 프로필 이미지
    jbsh

    Reviews 13

    Average Rating 5.0

    5

    32% enrolled

    It is great that you list many key words for each step and situation. It is also very helpful that you repeat those words.

    • americasnail
      Instructor

      Hello Junwoo Ahn, thank you for your detailed and valuable course review. I hope you have a great day today :)

  • jinp19933808님의 프로필 이미지
    jinp19933808

    Reviews 6

    Average Rating 5.0

    5

    32% enrolled

    I tried to apply Harness in practice but failed every time and only wasted time, so this was the first time I realized it needs to be built so systematically. In particular, I didn't know when to use things like agent skills or hooks and even asked AI to write those features for me, but now that I know their purpose and how to use them, I think I'll be able to utilize them much better.

    • americasnail
      Instructor

      Thank you so much for your valuable review. ☺️ I will continue to reinforce the content with practical methods for using Claude Code more stably in real-world tasks, based on research papers and actual case studies.

  • hoojunlee7658님의 프로필 이미지
    hoojunlee7658

    Reviews 1

    Average Rating 3.0

    Edited

    3

    37% enrolled

    The instructor's level of knowledge is high, but the delivery of the lecture fell short of expectations, so I am leaving feedback focused on drawbacks and areas for improvement. 1. The teaching materials are poor. Regarding the attached PPT materials: I can tell they were made with Claude, but shouldn't there at least be some post-editing for line breaks or broken blocks? (It's only a few pages, so it wouldn't even take 30 minutes.) The font in the video materials is too small to see clearly, and the focus keeps shifting, so I gave up trying to follow along visually. The explanation and the materials feel disconnected. 2. There is too much redundant and unnecessary theoretical explanation from the beginning through the middle. (It felt like being teased, wondering when we would finally get to the main point.) It seems like you have a lot of information to share, but from a learner's perspective, it is difficult to summarize or organize the core points. 3. I was expecting hands-on practice in the latter half, but it ultimately felt like just watching the instructor's demo presentation. It would be much better if you organized the curriculum to be more core-focused, added practical explanations, and guided students to actually type out sample code or markdown files while explaining. I've only skimmed parts of the latter half, but I still have high hopes and will definitely finish the course.

    • americasnail
      Instructor

      Hello jjun1004, First of all, thank you very much for your suggestions for improvement. We will review the points you mentioned and update the service by reflecting those improvements in the latter half of July. We apologize for any disappointment caused. Thank you for taking the course, and we wish you a wonderful day.

    • Now I understand what this review was about. I paid today and realized it after getting past three pages... I’ve already gone over 7%, so I can’t cancel it. Sigh... Ah... the text is way too hard to see...

americasnail's other courses

Check out other courses by the instructor!

Similar courses

Explore other courses in the same field!

25% off for new members

$48.20

25%

$68.20