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.4) 62 reviews

775 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.4

5.0

wogml6026

100% enrolled

I now have a good understanding of the harness structure and how to use it in practice.

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.

What you will gain after the course

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

  • The ability to design a workspace for working 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, Claude Code pays off in CLI harness design.

This course does not introduce Claude Code CLI as merely an AI coding tool. Instead, it covers how to integrate Claude Code into 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 work safely on real projects.

Recommended for people who…

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

If you could ask questions and receive answers comfortably in the GUI, but found yourself returning to the terminal in actual work to read logs, run tests, review diffs, and organize Git branches, you need this course. This course gives you the framework for turning Claude Code from a “tool you try out briefly” into a “tool you keep using in real projects.”


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

The problem may not simply be model performance; it’s likely that the design was lacking in terms 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 go beyond merely “trying out AI coding tools” and elevate their use to the level of operating them as a real-world system

It 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 will no longer see Claude Code as merely a tool for “entering good prompts.” Instead, you will be able to determine what Claude should see, how far it can act, how to verify its results, when to clear/compact/restart if a session becomes polluted, and how to manage worktrees and parallel sessions.

Specifically, you can structurally codify project rules and prohibitions in CLAUDE.md, organize logs, environment variables, and configuration scope issues in a form that Claude can solve, and review Claude’s proposed changes through testing, diffing, and counterexample verification loops. 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 simply explaining features, this course teaches from the perspective of “harness engineering” based on research 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 actual projects.

2. It focuses on 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 real-world work.

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 organize the differences between GUI-based Claude and the CLI, starting with the basics. Rather than simply comparing interface differences, we explain why GUI usage tends to remain at the level of “asking questions and receiving answers,” while the CLI can connect to actual logs, tests, Git, and deployment preparation. We then use the Claude Code architecture to understand why the harness is more important than the model, and explore the role 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.

It explains the 6 harnesses needed to integrate Claude Code into a real project as a single work system. It provides an overall picture of what information Claude should see, how far it can act, how results should be verified, 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.



A harness configuration file you can copy and use right away

The harness configuration you create directly in the course is provided in full as completed files.
After taking the course, you can copy it into your own project and apply it right away without having to rewrite it from scratch.

The provided configuration is as follows.

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

  • codecraft-harness/SKILL.md
    Transforms a short, ambiguous, one-sentence request into a detailed 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 parent project folders 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 Claude from reporting a task as complete when tests have not been run or have failed.

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

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

Once the configuration file is registered, tests run automatically every time Claude modifies the code, and when a test fails, it cannot arbitrarily terminate by saying, “I’ve completed the task.”

In other words, you will learn how to go beyond asking Claude to verify its work 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 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 verification instructions that the model performs on its own to prevent unnecessary redundant work.

  • Opus 4.8
    Clearly specify the tool execution conditions so that the necessary tools are used at the right time.

  • Sonnet 5
    This section covers how to describe exactly, in literal terms, the files to modify and the scope of the changes.

  • Haiku 4.5
    We 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, for reference, an approach that avoids giving the model excessive instructions and retains only the necessary guidance.

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 comparing the results while changing the effort value

  • Lab 04 exercise comparing results by running the same prompt on multiple models

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

You will directly compare the approach of handling complex tasks sequentially in one go with the Graph Engineering approach of dividing and handling 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 launch.

You can play back step by step how the same request is processed 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

When you select 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 comprising a total of 645 lines.

Instead of explaining the theory at length from the beginning, it is structured in the following order.

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

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

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

Three demo projects you can run directly

Rather than just reading the configuration files, you will run claude in an actual project folder and see firsthand how Hooks block and validate tasks.

Each project intentionally includes the following issues.

  • 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 → Fix the code → Run the tests → Pass validation

Loop-based and graph-based projects use the same code, with only the harness configuration 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 documents

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, and Tests
    Explains what each component is responsible for and which tool to use for which problem.

  • Harness Inspection Checklist
    Verify that nothing is missing from the prompt, design, implementation, testing, and completion criteria.

  • Question and test cards
    Provides questions to use when requirements are unclear, test design criteria, and verification table templates.

  • Model-specific playbook documents
    Parameter settings, behavioral characteristics, and prompt-writing guidelines for each model are organized 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 reuse repeatedly in real-world projects.


The person who created this course

  • Silicon Valley Survivor | American Snail 

    Based on experience and know-how gained at the forefront of the Global Tech Scene, this course shows 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 self-developed AI tool 'Snailer CLI' (20K+ downloads)

      • Selected for the Google for Startups Program

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

      • Gave up the final stage at Amazon 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, those who have used Claude Code even briefly are more likely to find this course especially valuable. If it seemed convenient at first, but you found that Claude kept losing its way when you tried to use it in a real project, or that you still had to handle the final steps—such as testing, Git, and deployment—yourself, this course addresses exactly those problems. Rather than simply introducing features, the course focuses on “a structure that keeps you using it.”

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

Official documentation is the most up-to-date and accurate source of information. 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 get back on track when a session becomes polluted.” Although this course refers to the official documentation, it is based on the contents of the paper. It provides structures and criteria you can apply directly in practice.

Q. What level of material does this course cover?

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

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

Notes Before Enrolling

Practice environment

  • macOS is the most recommended operating system, and Windows users are encouraged to use a WSL environment. You can follow along similarly in a Linux environment as well. The hands-on exercises will focus on the Claude Code CLI, so having experience using the terminal will make things much easier. Since the course covers project structures and uses Git/worktree to some extent, it is best to have a basic development environment already set up.

Learning materials

  • PPT, Notion

  • The course provides more than just a collection of links—it offers 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 model-routing criteria are designed so that you can review the material without having to replay the videos 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


    ▎ - Complete 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, verification checklist, question and test cards, record sheet

Prerequisites and Important Notes

  • It is best if you have basic development experience, experience using the CLI, and an understanding of Git concepts.

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

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

2,112

Learners

123

Reviews

84

Answers

4.4

Rating

8

Courses

  • Silicon Valley Survivor | American Snail

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

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

      • Operating the self-developed AI tool 'Snailer CLI' (20K+ downloads)

      • Selected for the Google for Startups Program

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

      • Gave up an Amazon final-round opportunity 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 teaching expertise

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

      • Produced 2,100+ cumulative students, with 4.6K+ followers on SNS Threads and 500+ Substack followers.

More

Curriculum

All

58 lectures ∙ (8hr 23min)

Course Materials:

Lecture resources
Published: 
Last updated: 

Reviews

All

62 reviews

4.4

62 reviews

  • claid님의 프로필 이미지
    claid

    Reviews 10

    ∙

    Average Rating 4.2

    1

    8% enrolled

    Unlike the previous lectures, this PPT seems to have been created using an AI tool, so the text is too small to understand the content. In addition to the small font size, the text has borders around it on the PPT, which significantly reduces readability. The lecture materials you created yourself, as you did before, were much higher quality, so I’m somewhat disappointed with these materials.

    • americasnail
      Instructor

      Hello NPE, thank you for your feedback. We understand that you found the materials difficult to read at the 8% completion point. We will review the font size and layout you mentioned. However, this course is structured as a complete flow that includes hands-on exercises and additional materials in the latter half. If possible, we would appreciate it if you could continue a little further and then reevaluate the course as a whole.

  • kmsaa2862님의 프로필 이미지
    kmsaa2862

    Reviews 2

    ∙

    Average Rating 3.5

    2

    68% enrolled

    1. There is a lot of unnecessary content in the middle. 2. The target audience is unclear. - Is it for non-majors? Or for majors? - Is it for job seekers? Or for working professionals? - Etc. 3. Looking at the curriculum and titles, it seems like a course for professional developers, but the actual hands-on sessions are nothing more than just watching the instructor do it.

    • americasnail
      Instructor

      Hello Min-seok, thank you for your course review. 1. First, I will review and improve the unnecessary content in the middle to reflect your feedback. 2. When creating the course, the target audience was both non-majors and majors. 3. In the practical lectures, I made it possible to use the prompts directly from the class notes. I also divided the lectures so that you can practice at every step. I believe that if students do not actively participate, the practical lectures will just feel like watching. Nevertheless, to improve upon the feedback you provided, I will reinforce the course with checkpoints and missions so that students can follow along and create actual practical results. Thank you, and have a great day.

  • 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...

  • jonghun7lee0826님의 프로필 이미지
    jonghun7lee0826

    Reviews 1

    ∙

    Average Rating 2.0

    2

    32% enrolled

    • americasnail
      Instructor

      Hello, Jonghoon Lee. Thank you for leaving a course review. Since you gave a 2-star rating after completing 32% of the course, I take this to mean that there were areas that did not meet your expectations. However, as there are no specific comments provided, it is difficult for me to pinpoint exactly what needs improvement. If you could let me know which parts you found disappointing, I will actively reflect your feedback in future course updates. Currently, I am planning to update the CodeCraft Harness Engineering practice course to include new updates aligned with the release of the Opus 4.8 model. I will continue to improve the course to make it easier to understand and more applicable. Thank you.

  • dolilu님의 프로필 이미지
    dolilu

    Reviews 12

    ∙

    Average Rating 4.8

    2

    23% enrolled

    I can't focus because the lecture materials are completely out of sync with the content. I honestly wonder what the intention was behind recording it this way—with all the zooming in, zooming out, and moving the materials around—it makes it impossible to immerse myself in the lecture. Many others have also pointed out issues with the lecture materials, to the point where I started wondering if you recorded the audio first and then used AI to match the visuals to it. I purchased this course with high expectations for the content, but I've stopped watching because I simply can't concentrate. I hope you can improve this.

    • americasnail
      Instructor

      Hello, Doriru. Thank you for your valuable feedback. As you mentioned, I fully understand your point that the lecture materials and screen layout made it difficult to focus on the content. Since many other students also expressed disappointment regarding the lecture materials, we have already distributed a completely revised set of new materials. While the core content of the lecture remains largely unchanged, leading us to prioritize video updates lower, we plan to continuously improve the screen layout and delivery methods. My intention was to help understanding by showing the explanation and materials together, but if it ultimately hindered immersion, I agree it is an area that needs improvement. I also noted your comment about it feeling like an AI voice was used. Because many people found the speaking style and pace in previous lectures uncomfortable, I have been recording and editing multiple times during the production process to enhance clarity and naturalness. However, if it felt that way from a student's perspective, I believe the delivery method is also something that needs to be improved. In the future, I will organize the materials to be easier to read and minimize screen transitions, zooming in, and zooming out so that you can focus more on the lecture content itself. I will actively reflect your feedback to create better lectures.

americasnail's other courses

Check out other courses by the instructor!

Similar courses

Explore other courses in the same field!

Limited time deal

$51.70

24%

$68.20