Claude와 Claude-code의 차이점은 무엇일까요? (Desktop 기준)

Claude를 처음 사용한다면 "Claude Chat"(일반)과 "Claude-Code"의 차이가 궁금할 것입니다.

저 또한 Harness란 개념을 처음 접할 때는 이 둘을 구분하지 못하고 무작정 사용하기 시작했습니다. 그러다 문득 깨닫게 된거죠. "아... 이럴 때 Claude-Code를 사용하는구나"하고 말이죠.

그래서 이번 글에서는 Claude(클로드)와 Claude-Code(클로드-코드)의 차이에 대해 다뤄보고자 합니다. 유로 플랜을 사용할 지 고민되시는 분들에게 도움이 될 수 있겠네요.

본 글에서는 편의상 한글로 "클로드"와 "클로드-코드"라 적으며 설명하겠습니다.

클로드 — 대화창 안에서 끝나는 작업

클로드는 사람들이 웹이나, 데스크탑 앱, 스마트폰에서 일반적으로 사용하는 대화형 AI라고 보시면 됩니다.

엔트로픽 또한 공식 제품 소개페이지를 통해 클로드를 다음과 같이 설명하고 있습니다.

클로드에게 질문이 아니라 일을 맡겨라.

(Hand Claude a task, not just a question.)

"Task"라고는 했지만, 실제로는 대화 안에서만 동작합니다. (물론 예외는 있습니다!!)

내가 올린 파일을 읽고, 연결해 둔 구글 드라이브나 슬랙에서 자료를 가져오고, 문서나 표나 슬라이드를 만들어 대화창에 내놓는 활동을 하지만, 그 결과물을 실제 업무로 옮기는 일은 결국 사람이 해야합니다. 내려받아서 메일에 첨부하든, 복사해서 붙여넣든 결국 사람의 손이 가게되는 반(semi)-자동화 작업이라고 보면 좋을 것 같습니다.

클로드 코드 — 내 컴퓨터를 직접 조작하는 작업

반면 클로드 코드는 엔트로픽의 공식 문서에서의 설명부터 조금 차이가 있습니다.

클로드 코드는 당신의 코드베이스를 읽고, 파일을 고치고, 명령을 실행하고, 개발 도구와 연동되는 에이전트형 코딩 도구다.

(Claude Code is an agentic coding tool that reads your codebase, edits files, runs commands, and integrates with your development tools.)

앞선 클로드 설명보다는 조금 길죠? 그 만큼 클로드 보다는 다양한 작업을 할 수 있다는 얘기를 하고싶은 것 아닌가 합니다 :)

클로드 코드를 직접 사용하다보면 파일을 직접 수정하고, 프로그램을 돌려 보고, 결과가 틀리면 다시 고치는 활동을 확인할 수 있습니다.

즉, "클로드"에서는 대화창에 "이렇게 고치세요"라고 알려 주었다면 "클로드-코드"에서는 직접 파일을 수정한 뒤 "이렇게 수정했습니다"라고 알려줍니다.

그렇다고 클로드-코드가 무조건 마음대로 파일을 수정하는 것은 아닙니다. 파일을 직접 수정할 수 있는 위험이 따르는만큼, 클로드-코드에는 안정장치도 제공하고 있습니다.

기본적으로 클로드-코드는 기본(수동) 모드에서 읽기 권한만 가지며, 필요에 따라 모드를 변경해 자동으로 실행되도록 설정할 수 있습니다.

자동모드에 대한 책임은 결국 시키는 사람의 몫이겠지만, 최근에는 이러한 문제도 완충하고자 보안 단계에 따라 몇 가지 모드로 나눈 것도 확인해 볼 수 있습니다.

한눈에 비교

"클로드"와 "클로드-코드"를 표로 한 눈에 비교해보면 다음과 같습니다.

구분	클로드	클로드-코드
쓰는 곳	웹·데스크톱·모바일 대화창	터미널, 코드 편집기, 데스크톱 앱의 'Code' 탭, 웹
만지는 대상	대화에 올린 파일, 연결한 외부 서비스	내 컴퓨터의 프로젝트 폴더 전체
결과가 남는 곳	대화 안(문서·슬라이드 등), 내려받기	파일 자체가 바뀌고 변경 이력에 기록됨
일하는 방식	내가 묻고 클로드가 답한다	목표를 주면 읽고·고치고·실행하고·확인한다
권한	올린 것만 본다	기본은 읽기 전용, 고칠 땐 허락을 구한다
주 사용자	누구나	개발자 중심
요금	무료 플랜부터	유료 플랜에만 포함

요금은 별도로 계산할 필요가 없고, 사용한 토큰량 기준으로 시간 할당량에서 자동으로 차감됩니다. (주간 할당량도 있으니 사용에 주의)

사용량을 보려면 "/usage" 혹은 "설정창"에서 확인 가능합니다.

그래서 무엇을 쓰면 되나요?

짧게 정리하면 다음과 같습니다.

• 클로드 : 결과물을 받아서 내가 작업하면 되는 일 (보고서 초안, 자료 정리, 번역, 슬라이드, 메일 회신)
• 클로드-코드 : 내 컴퓨터 안의 파일이 실제로 바뀌어야 하는 일 (프로그램 개발, 폴더 정리, 장기 작업)

정리

쉽게 설명하고자 파일을 바꾸는 작업을 하려면 "클로드-코드"를 사용해야 한다고 했으나, 엄밀히 따지면 클로드에서도 파일 작업이 가능하고, 반대로 클로드-코드에서 항상 파일을 바꾸는 작업이 일어나는 것도 아니며 제어 또한 가능합니다.

그럼에도 클로드-코드를 쓰는 이유는 프로젝트를 구분하여 나만의 하네스(Harness) 혹은 팀 공유 하네스를 구축할 수 있기 때문입니다. 예를들면 에이전트가 항상 참조하는 CLAUDE.md 파일을 직접 구현하거나, 프로젝트 아키텍처 구조를 설명하고 강제하는 ADR을 작성하거나, 해당 프로젝트만을 위한 스킬을 정의/사용하는 등, 클로드-코드에서는 나만의 하네스 환경을 구축해 사용할 수 있습니다.

해당 글이 길어기는 것 같아 더 이상의 자세한 설명은 하지 않겠습니다.

선택은 자유입니다. 그럼에도 "클로드 (무로)" vs "클로드-코드 (유료)" 중 하나만 추천하라면, 일단 "클로드-코드"를 제대로 경험해 보라고 추천드리고 싶네요.

'AI' 카테고리의 다른 글

pass@k vs pass^k 비교  (0)	2026.09.15
[Paper] Adaptive Mixtures of Local Experts (1991)  (0)	2025.01.06
[AI] jinaai Embedding 모델 샘플코드  (1)	2024.12.03
[AI] LLM Judge 적용 방법 정리  (0)	2024.10.31
[AI] 키워드/용어 정리 for research  (0)	2024.10.10