Claude Code의 작동 방식

에이전틱 루프

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

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

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



컨텍스트

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

도구

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

권한

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

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

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



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

요약

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