로드 중

Claude Code의 작동 방식

강의 25분
로드 중

Claude Code의 작동 방식

요약스크립트

Claude Code는 일반적인 채팅 애플리케이션과 다릅니다. 내부적으로 어떻게 작동하는지 이해하면 더 효과적으로 활용하는 데 도움이 됩니다.

에이전틱 루프

Claude Code는 에이전틱 루프(agentic loop)를 통해 가장 잘 설명할 수 있습니다:

  1. Claude Code에 프롬프트를 입력합니다.
  2. Claude는 모델과 상호작용하며 필요한 컨텍스트를 수집하고, 모델은 텍스트나 Claude Code가 실행할 수 있는 도구 호출을 반환합니다.
  3. Claude는 행동을 취합니다 — 예를 들어 파일을 수정하거나 명령을 실행합니다.
  4. 결과를 검증하여 프롬프트가 의도한 바를 달성했는지 확인합니다.
  5. 달성했다면 Claude는 작업을 마치고 다음 프롬프트를 기다립니다. 그렇지 않다면 루프로 돌아가 결과가 완전하고 검증 가능해질 때까지 다시 시도합니다.

이 루프 전반에 걸쳐 컨텍스트를 추가하거나, 중단하거나, 모델을 목표로 유도하도록 조정할 수 있습니다.

에이전틱 루프 다이어그램: 프롬프트가 컨텍스트 수집, 행동 취하기, 결과 검증의 루프로 흘러가며, 언제든지 중단하거나, 조정하거나, 컨텍스트를 추가할 수 있음

컨텍스트

Claude에는 대화, 파일 내용, 명령 출력 등을 얼마나 저장하고 참조할 수 있는지를 결정하는 컨텍스트 창이 있습니다. 이 한계에 도달하면 Claude Code는 대화를 압축합니다 — 제거하거나 요약할 수 있는 부분을 자동으로 판단하여 컨텍스트 창을 사용 가능한 크기로 되돌립니다.

도구

도구는 에이전트 작동 방식의 근간입니다. 대부분의 AI 어시스턴트는 단순히 텍스트를 입력받아 텍스트를 반환합니다. 도구를 사용하면 Claude Code가 작업을 완료하는 데 더 가까워지기 위해 코드를 실행해야 할 시점을 판단할 수 있습니다. 이는 파일 읽기 도구, 웹 검색 도구, 또는 그 외 다양한 기능일 수 있습니다. Claude Code는 의미론적 이해를 사용하여 언제 도구를 호출할지, 그리고 그 출력을 어떻게 사용할지 판단합니다.

권한

Claude Code에는 여러 권한 모드가 있습니다:

  • 수동: 파일을 수정하거나 셸 명령을 실행하기 전에 Claude가 명시적인 권한을 요청합니다.
  • 자동 승인: 파일은 묻지 않고 수정되며, mkdir, mv, rm과 같은 일반적인 파일시스템 명령도 묻지 않고 실행됩니다. 다른 명령은 여전히 승인이 필요합니다.
  • 계획 모드: Claude는 소스 파일을 수정하지 않고 파일을 읽고 셸 명령을 실행하여 탐색하며, 작업을 시작하기 전에 실행 계획을 작성합니다.
  • 자동 모드: Claude는 일상적인 권한 요청 없이 작업하며, 분류기가 대부분의 작업을 백그라운드에서 확인하여 되돌릴 수 없거나, 파괴적이거나, 작업 환경 밖을 대상으로 하는 작업을 차단하는 데 초점을 맞춥니다. 무언가가 차단되면 Claude는 보통 더 안전한 방법을 찾거나 진행 승인을 요청합니다.

새 세션이 어떤 모드로 시작되는지는 사용 중인 Claude Code 버전과 설정에 따라 다릅니다.

bash 명령을 실행하기 전에 권한을 요청하는 Claude Code

이 모든 것은 설정 파일에서 구성할 수 있습니다. 권한 확인을 건너뛸 때는 주의하세요 — Claude Code에 명령을 자유롭게 실행할 수 있는 권한을 부여하면 실수가 발생하기 전에 이를 포착하기가 더 어려워질 수 있습니다.

요약

Claude Code는 에이전틱 루프, 관리되는 컨텍스트 창, 도구, 그리고 구성 가능한 권한이라는 여러 에이전틱 개념을 터미널 안에서 모두 결합합니다. 코드베이스를 읽고, 행동을 취하고, 자신의 작업을 검증할 수 있습니다. 이것이 바로 Claude Code를 채팅 창과 근본적으로 다르게 만드는 요소입니다.