01-개념

01. 개념과 멘탈 모델

개발자 가 Claude 를 만나는 지점

개발자에게 Claude Code 는 IDE 자동완성의 확장 이 아니라 하네스(Harness)+도구 루프(Tool Loop) 위에서 돌아가는 부하 직원이다. 시스템 프롬프트, 권한 모델, hooks, 메모리(/compact), Plan Mode 다섯 가지를 이해해야 “왜 이렇게 동작하지?” 를 디버그할 수 있다. 코드 품질의 책임은 여전히 개발자에게 있다 — Claude 는 git diff 의 작성자 일 뿐 리뷰어 가 아니다.

왜 이 멘탈 모델이 중요한가

Claude Code 는 단순한 코드 자동완성 도구가 아니라, 프로젝트 폴더를 읽고·쓰고·실행 하는 하네스(Harness) 위에서 동작한다. 즉 입력한 한 줄 명령이 파일 시스템을 바꾸거나 외부 API를 호출할 수 있다. 이 사실을 모르면 (1) 권한 사고, (2) 컨텍스트 폭주, (3) 환각의 세 가지 함정 에 빠진다.

영문 인용

“The agent did exactly what its tools allowed it to do. The fix is fewer permissions, not smarter prompts.”

의역: 에이전트는 도구가 허용한 만큼만 행동했다. 해법은 더 똑똑한 프롬프트가 아니라 더 좁은 권한 이다.

— DataTalks.Club 포스트모템

다음 단계

• 02-패턴.md 로 이동해 실전 워크플로우 3종을 익힌다.