3과3-1
하네스엔지니어링이란
AI를 도구로서 제어하는 개념, CLAUDE.md와 설정 파일의 역할을 배웁니다
하네스(Harness)의 의미
하네스(harness)는 원래 말(馬)에 씌우는 마구(馬具)를 뜻합니다. 강한 말의 힘을 안전하고 원하는 방향으로 이끄는 도구입니다. 하네스엔지니어링은 이 비유에서 출발합니다. AI라는 강력하지만 통제되지 않으면 예측 불가능한 도구에 '고삐'를 달아 원하는 방향으로 작동하게 하는 기술입니다.
컨텍스트엔지니어링이 '무엇을 말할지'에 집중한다면, 하네스엔지니어링은 '어떻게 작동할지 시스템을 설계하는 것'에 집중합니다. 프로젝트 전반에 걸쳐 AI의 행동, 규칙, 도구 접근권을 설정하는 것입니다.
CLAUDE.md — AI의 행동 지침서
Claude Code를 쓰다 보면 CLAUDE.md라는 파일을 접하게 됩니다. 이 파일은 Claude Code가 프로젝트를 시작할 때 가장 먼저 읽는 설정 파일입니다. 마치 신입 직원에게 주는 '업무 매뉴얼'과 같습니다.
CLAUDE.md에 담을 수 있는 내용:
- 프로젝트 개요와 구조 설명
- 코딩 규칙과 스타일 가이드
- 절대 수정하면 안 되는 파일 목록
- 자주 쓰는 명령어와 절차
- 협업 규칙 (커밋 메시지 형식 등)
CLAUDE.md를 잘 작성하면 매 대화마다 배경을 다시 설명할 필요 없이 AI가 프로젝트의 맥락을 바로 파악합니다.
# CLAUDE.md 예시
## 프로젝트 개요
이 프로젝트는 노무사 업무 자동화 도구입니다.
주요 기능: 취업규칙 검토, 임금 계산, 신고서 작성
## 코딩 규칙
- TypeScript 사용, any 타입 금지
- 함수명은 영어 camelCase
- 주석은 한국어로 작성
## 절대 수정 금지
- src/data/법령/*.ts (법령 데이터)
- .env (환경변수)
## 자주 쓰는 명령어
- npm run dev: 개발 서버 시작
- npm run build: 빌드 검증TIP: CLAUDE.md는 프로젝트 루트에 두면 Claude Code가 자동으로 읽습니다. 처음에는 간단하게 시작하고 작업하면서 필요한 규칙을 추가해 나가세요.
설정 파일로 AI 행동 제어하기
CLAUDE.md 외에도 `.claude/settings.json`으로 Claude Code의 세부 동작을 설정할 수 있습니다. 어떤 파일에 접근할 수 있는지, 어떤 명령어를 실행할 수 있는지, 자동화 훅을 어떻게 설정할지 등을 제어합니다.
하네스엔지니어링의 핵심은 AI에게 모든 자유를 주지 않는 것입니다. '이 프로젝트에서 너는 이것만 할 수 있어'라는 경계를 설정하면 예상치 못한 사고를 방지하고 일관된 작업 결과를 얻을 수 있습니다.
핵심 정리
- ✓하네스엔지니어링은 AI에게 경계와 규칙을 설정해 원하는 방향으로 제어하는 기술입니다.
- ✓CLAUDE.md는 Claude Code가 프로젝트 시작 시 읽는 행동 지침서입니다.
- ✓설정 파일로 AI의 접근 권한과 자동화 동작을 제어할 수 있습니다.
자주 묻는 질문
CLAUDE.md는 모든 AI에서 쓸 수 있나요?+
CLAUDE.md는 Claude Code에 특화된 파일 형식입니다. 하지만 같은 개념으로 ChatGPT의 Custom Instructions, GitHub Copilot의 .github/copilot-instructions.md 등 각 도구별로 유사한 설정 파일이 있습니다.
하네스엔지니어링을 배우면 어떤 업무에 적용할 수 있나요?+
반복적인 문서 작업 자동화, 코드 품질 관리, 팀 협업 규칙 적용 등에 활용됩니다. 특히 여러 사람이 같은 AI 도구를 쓰는 환경에서 일관성을 유지하는 데 큰 도움이 됩니다.