01-개념

01. 개념 — Claude Code 하네스의 구성 요소

Claude Code의 하네스를 분해하면 다음 5개 덩어리가 나온다 (WaveSpeedAI breakdown 기준).

시스템 프롬프트 빌더 — Anthropic이 제공하는 기본 프롬프트 + 사용자/프로젝트 CLAUDE.md + 환경 정보(작업 디렉터리, OS, 모델 ID 등)를 매 턴 합쳐서 모델에 전달.
도구 카탈로그 — Read, Edit, Write, Bash, Grep, Glob, WebFetch, WebSearch, Task(서브에이전트), TodoWrite, NotebookEdit 등. MCP 서버가 추가되면 동적으로 합류.
메시지 루프 — messages.create → tool_use 응답 → 디스패처 → tool_result → 다음 messages.create … 를 stop_reason="end_turn"까지 반복.
컨텍스트 매니저 — 토큰 카운팅, auto-compact 트리거, todo/플랜 메모리 보존.
권한 게이트(canUseTool) — 도구 호출이 실행되기 직전 끼어들어 모드와 규칙으로 통과/거부/사용자 확인을 결정.

Anthropic 공식 How Claude Code works 문서는 위 1·3·4를 묶어 “agentic loop”라 부르며 다음 한 줄로 요약한다.

“models that reason and tools that act”

의역 — 추론하는 모델과 행동하는 도구.

이 한 줄이 하네스 코어의 전부다. 나머지는 이 두 가지를 안전하고 효율적으로 묶기 위한 부속물이다.

”유출된 시스템 프롬프트”라는 표현에 대해

WaveSpeedAI/zainhas/brightcoding이 분석한 자료들은 Claude Code의 번들된 JS를 디컴파일해 시스템 프롬프트와 도구 정의를 추출한 결과다. 본 위키는 그 구체적 문자열을 옮기지 않는다 — 빌드마다 바뀌고, 라이선스 이슈가 있으며, 사실 학습 가치도 떨어진다. 대신 구조(어떤 섹션이 있고 어떤 순서로 합쳐지는가)만 다룬다.