클로드 코드 (1) - 클로드 코드의 작동 방식 / 정의, 작동 방식, 도구, 환경 인터페이스, 세션

클로드 코드를 사용해서 개발을 하고 있는데,

일단 써보면서 배우는 게 좋다고 생각해서 무작정 쓰고 있다.

 

좀 더 알고 쓰면 좋지 않을까 싶어 문서를 보며 정리해보려 한다. 

 

기본적인 뻔한 내용 보다는

기억 하면 좋을 만한, 다음에 와서 찾아볼 것 같은 그런 내용을 적으려 한다. 

모든 내용은 클로드코드 문서를 기준으로 작성

 

 

클로드 코드란?

클로드라는 것과 클로드 코드라는 것은 분리되는 개념이다. '클로드 코드'는 '클로드'를 둘러싼 에이전트 기반 장치이며,

클로드를 이용해서 코드 관련 작업을 더 원활히 할 수 있게 하는 도구, 컨텍스트, 실행 환경을 제공한다.

 

 

클로드 코드의 작동 방식

 

사용자의 요청을 시작으로 에이전트 루프 - 맥락 파악 , 조치 실행 , 결과 검증 세가지 단계를 거쳐 작업이 진행된다. 이 세가지 단계는 유기적으로 연결되어 있다. 모든 요청에 대해 세가지를 다 사용하지 않고, 필요에 따라서 결정된다. 예를 들면, 코드베이스에 대한 질문은 맥락 파악 정도만 필요할 수 있는 것. 

 

 

에이전트 루프는 추론하는 모델과 실행하는 도구라는 두 가지 구성 요소에 의해 구동된다.

 

 

클로드 코드의 모델과 도구

클로드 코드의 모델은 오푸스, 소넷 이런 것들을 지칭 한다. 각각의 모델별로 특징? 특징이라기 보다는 얼마나 더 열심히 생각해서 큰 토큰을 소모하고 있느냐의 차이인 것 같다. 토큰을 더 소모할 수록 응답 시간이 길고, 덜 소모할 수록 빠르다.

 

도구라는 개념은 조금 생소했다.

 

'도구를 사용하면 클로드는 코드를 읽고, 파일을 편집하고, 명령어를 실행하고, 웹을 검색하고, 외부 서비스와 상호 작용하는 등 다양한 작업을 수행할 수 있습니다.'

 

라고 문서에 나와있다. 결국 클로드 코드를 활용해서 하는 어떤 동작들은 클로드 코드 자체가 아닌 클로드 코드의 '도구' 기능을 사용한다는 개념으로 이해하면 될 것 같다. 예를 들면 클로드 코드에게 웹검색을 해서 대답을 하라고 시키면 권한 질문을 한 뒤에 웹검색을 진행하는데 이 때 검색을 하는 것이 도구를 사용해서 가능 하다는 것.

 

 

도구는 일반적으로 아래 다섯가지로 나뉜다고 한다. 

파일 작업	파일 읽기, 코드 편집, 새 파일 생성, 이름 변경 및 재구성
찾다	패턴으로 파일을 찾고, 정규 표현식으로 콘텐츠를 검색하고, 코드베이스를 탐색하세요.
실행	셸 명령 실행, 서버 시작, 테스트 실행, Git 사용
웹	웹을 검색하고, 문서를 가져오고, 오류 메시지를 찾아보세요.
코드 인텔리전스	편집 후 타입 오류 및 경고를 확인하고, 정의로 이동하고, 참조를 찾을 수 있습니다( 코드 인텔리전스 플러그인 필요 ).

 

기타, 서브 에이전트를 생성한다던지 질문을 한다던지, 오케스트레이션 작업을 할 때에도 이 도구를 사용한다고 한다. 클로드는 한 작업에 여러가지 도구를 사용하고, 각 도구를 사용한 작업을 통해 얻은 정보로 다음 단계를 결정한다. 에이전트적 순환 이라고 한다. 

 

 

일반적인 도구 외에 클로드의 기능을 확장 시킬 수 있는 방법들이 있다. 

스킬, MCP, 서브 에이전트, 훅. 이러한 확장 기능들은 핵심 에이전트 루프 위에 추가 레이어를 형성한다.

 

 

 

 

환경 및 인터페이스

위의 기능들은 클로드 코드를 사용하는 모든 곳에서 동일하다. 달라지는 것은 코드가 실행되는 위치와 코드와 상호 작용하는 방식.

 

 

클로드 코드는 세가지 환경에서 실행되며, 각각의 장단점이 있다. 

Local	Your machine	Default. Full access to your files, tools, and environment
Cloud	Anthropic-managed VMs	Offload tasks, work on repos you don’t have locally
Remote Control	Your machine, controlled from a browser	Use the web UI while keeping everything local

 

 

인터페이스

클로드코드는 터미널, 데스크톱 앱, IDE 확장프로그램 (Vs code), claude.ai/code, 원격제어 (휴대폰, 태블릿 또는 모든 웹 브라우저에서 로컬 Claude Code 세션을 이어서 진행가능. claude.ai/code 및 Claude 모바일 앱과 호환)

 

핸드폰과의 연동(깃허브에 코드를 올려놓고 연동해두면 클로드 앱에서 수정)의 경우 이동중에도 개발을 시킬 수 있다는 점에서 좋긴한데, 아무래도 집중력도 떨어지고 PC에서 하는 만큼 테스트를 직접 해보지 못해서 운영 중인 제품의 코드를 개발하기엔 부담이 있다.

 

 

 

세션

모든 대화 내용들은 로컬에 저장된다. 각 세션은 독립적이다. 라고 하는데 철저하게 독립적이진 않다. 자동 메모리 기능이 있어 이 기능을 꺼두면 세션간의 대화 내용이 절저하게 독립적이게 되겠다. 

 

자동메모리 - Claude는 빌드 명령, 디버깅 정보, 아키텍처 관련 메모, 코드 스타일 선호도, 워크플로 습관 등 작업 과정에서 필요한 정보를 스스로 저장합니다. 매 세션마다 모든 정보를 저장하는 것은 아니며, 향후 대화에 유용할지 여부를 기준으로 기억할 가치가 있는 정보를 판단합니다.

 

자동 메모리 사용은 기본적으로 활성화되어 있다.

활성화/비활성화하려면 /memory세션에서 열고 자동 메모리 토글 버튼을 사용하거나 autoMemoryEnabled프로젝트 설정에서 설정 가능.