클로드 코드 공부 기록

클로드코드를 사용하고 있지만 막상 사용하다보면 “내가 이걸 잘 쓰고 있는건가?” , “다른 사람들은 나보다 더 잘 쓰는거 같은데?” 라는 생각과 함께 계속해서 새롭게 들어오는 지식들과 합쳐지다 보니 뇌속에 정리가 안되어있다.

때문에 클로드 코드 공부 내용을 기록 하려고한다.

---

1단계 : 아무거나 만들어보기

to-do app , 랜딩페이지, 계산기 같은 간단한 SaaS 서비스 하나 만들어보기

• 완벽한 결과물일 필요도 없고, 클로드 코드가 어떻게 돌아가는지 알아보는 단계이다.
• 다만 중요한점은 / 명령어로 작업 환경과 감각을 익혀보자

2단계 : 결과물이 마음에 안든다 → SDD / TDD

1단계에서 최종결과물로 만들어졌지만 구조가 지저분하고 수정해도 만족스럽지 못할때 활용

기준을 먼저 세우는기획의 단계이다.

• 설계 하는 단계이다.
• “어떤 하나를 만들어달라” 라는 요청의 개념에서 이 기능의 목적은 뭐고, 입력은 뭐고, 성공조건, 실패케이스 등 어떻게 통과하는지를 주는것이다.
• SDD , TDD 작성하기

3단계 : 반복되는 작업이 보인다. → Skills

3단계 에서는 작업하는 단계에서 계속 반복하는 작업이 있을것이다. 이 부분을 캐치하는것이다.

• 내가 자주쓰는 방식, 체크리스트, 플레이북, 노하우를 Claude가 다시 사용할 수 있게 만드는것
• Skills 는 MCP 와 다르게 재사용 가능한 능력의 개념이다.
• / 형태로 호출해보기, 직접 Skills 만들어보기, 다른사람이 만든 Skills 사용하기

4단계 : 메모리와 컨텍스트 관리

프로젝트 룰, 파일 구조를 매번 다시 설명하고 있을때 사용한다.

• CLAUDE.md 를 작성할것, /init 을 통한 초안 작성하고 메모리를 점진적으로 축적할 것
• 빌드 / 테스트 명령, 폴더 역할, 선호 라이브러리, 커밋전 점검 항목
• 메모리 관리, 컨텍스트 관리

5단계 : 자동화의 시작 → Hooks 를 통한 외부 연결

Claude 에게 일을 시키는 것이 아니라 작업 흐름 자체를 자동화 한다.

• Hooks 의 개념 → 클로드 코드 라이프 사이클에서 특정 지점에 자동 실행되는 사용자 정의 명령어
• 파일 수정후 → 포맷팅, 검증, 알림, 규칙 위반시 차단등자동화 작업이다.
• MCP로 외부 서비스 연결 가능
• Chrome, Github Actions, 스케줄 같은 작업 연결

6단계 : 프로젝트가 커졋을때 → Subagents / Agent Teams

파일도 많아지고 역할도 나뉘고 병렬처리의 시작이다.

• Subagents 는 한 세션 안에서 분리된 컨텍스트로 하위작업을 수행하고 요약된 결과를 메인으로 돌린다.
• Agent Teams 는 독립적인 세션들이 서로 소통하며 협업 구조이다. (front , back, test)
• Subagents는 짧고 집중된 작업을 깨끗하게 분리할때 좋다.
• Agent Teams 는 서로의 역할을 나누면서 조금 더 큰단위의 일을 굴릴때 사용

7단계 : 클로드 코드 작업 시스템을 설계하는 단계 Agent Harness

Claude Code 위에 도구, 컨텍스트 관리, 실행 환경을 넣은 하나의 agentic harness단계이다.

AI agents 가 코드를 잘 짤 수 있는 환경을 만들어주는것이 Harness ( AI 가 인간의 개입 없이 최대한 스스로 만들 수 있게끔 하는 그 시스템을 만들자 하는게 하네스 엔지니어링의 시작 )

• 즉 위에서 했던 모든 단계 , 제약 조건 + 도구 + 피드백 루프 + 문서화 등 이 모든것의 전체 운영 환경을 만들어주는것이 Harness engineering 이다.
• Harness engineering : 하네스를 체계적으로 설계하고 개선하는 기술
• 실수 시 프롬프트 변경이 아니라 실수가 구조적으로 재발하지 못하도록 만들어내는것!

---

7단계의 Claude 에 관한 개발단계를 적었다. 직접 해본 경험이 있어서 추후에 빠른 학습이 될거 같다.

각각 단계별로 글을 추가적을 작성하겠다.