Claude Code 한눈에 보기: 무엇이 '에이전트 코딩'인가
'에이전트 코딩'은 무엇이 다른가
많은 개발 도구가 "AI 코딩"을 말하지만, 실제로는 두 갈래로 나뉩니다. 하나는 보조(assistant)입니다. 내가 코드를 쓰는 흐름 속에서 다음 줄을 예측하거나, 함수 예시를 만들어 주고, 내가 복사해 붙여 넣는 방식입니다. 다른 하나는 에이전트(agent)입니다. 목표를 주면 스스로 탐색하고, 여러 파일을 고치고, 테스트를 돌리고, 실패하면 다시 고치며, '작업 완료'까지 루프를 돌립니다.
에이전트 코딩을 정의하는 핵심은 지능이 아니라 자율성입니다. 즉 "제안"이 아니라 "수행"입니다. 에이전트형 도구는 목표를 받으면 계획을 세우고, 여러 파일을 바꾸고, 테스트·린트·빌드를 실행하고, 오류를 읽고, 수정하고, 다시 검증하는 닫힌 루프를 반복합니다.3
이 책에서 Claude Code를 "채팅"이 아니라 "일하는 동료"로 보자고 말하는 이유가 여기에 있습니다. 질문에 답만 해주는 챗봇이 아니라, 내 작업공간 안에서 실제 액션을 취하는 동료입니다. 다만 동료가 그렇듯, 방향을 정하고 승인할 책임은 사람에게 있습니다.
Claude Code의 정체: 터미널에 사는 '에이전트 하네스'
Claude Code는 터미널에서 실행되는 에이전트형 코딩 도구입니다. 중요한 점은 Claude(모델)가 곧바로 파일을 고치는 게 아니라, Claude Code가 도구(tool)와 컨텍스트 관리와 실행 환경을 제공해 모델을 "작동하는 에이전트"로 만든다는 것입니다. 공식 문서는 이를 Claude를 둘러싼 agentic harness라고 설명합니다.1
Claude Code를 실행하면, Claude는 텍스트만 내뱉는 대신 다음을 할 수 있습니다.
프로젝트 파일을 읽고, 패턴으로 찾고, 관련 파일을 넓게 탐색한다.1
파일을 직접 편집·생성하고, 필요한 경우 이름 변경이나 재구성까지 수행한다.1
쉘 명령을 실행해 빌드/테스트/린트/git 작업을 수행하고 결과를 다시 읽어 다음 행동을 정한다.1
이 기능들이 합쳐지면, 여러분은 "코드 스니펫 생성기"가 아니라 "작업을 끝까지 밀어붙이는 구현자"를 얻습니다.
Claude Code의 기본 루프: 탐색 → 실행 → 검증
Claude Code의 기본 동작은 에이전트 루프 하나로 설명할 수 있습니다. Claude에게 작업을 주면 컨텍스트 수집(gather context), 행동(take action), 검증(verify results)의 세 단계로 움직이며, 필요하면 이 과정을 반복합니다.1
예를 들어 "실패하는 테스트를 고쳐줘"라고 하면, Claude는 대개 이런 흐름을 스스로 선택합니다.
테스트를 실행해 무엇이 실패하는지 확인한다.
에러 출력에서 단서를 뽑는다.
관련 파일을 찾고 여러 파일을 읽어 원인을 추적한다.
파일을 수정한다.
다시 테스트를 실행해 해결됐는지 검증한다.1
핵심은 '한 번에 완벽한 답'이 아니라 루프를 굴려 결과물을 완성하는 방식입니다. 그래서 Claude Code를 잘 쓰려면, 프롬프트도 "정답을 요구하는 질문"보다 "목표와 제약을 주고, 검증 기준을 제공하는 지시"가 더 강력해집니다.
도구 실행이 만드는 체감 차이: '말'에서 '행동'으로
웹/IDE에서의 대화형 모델은 보통 이렇게 끝납니다.
"아마 이 함수에서 null 체크가 필요해요. 예시는 아래와 같아요…"
반면 Claude Code는 이렇게 끝내는 쪽에 가깝습니다.
"테스트가 여기서 실패합니다. 해당 조건을 수정했고, 테스트를 다시 돌려 통과를 확인했습니다. 변경된 파일은 A/B이고, 필요하면 커밋 메시지를 제안하겠습니다."
공식 문서가 말하는 것처럼, 도구는 Claude를 에이전틱하게 만드는 요소입니다. 도구가 없으면 텍스트만 내지만, 도구가 있으면 읽고·고치고·실행하고·검증할 수 있습니다.1
여기서 "동료" 관점이 실무적으로 중요해집니다. 동료에게 일을 맡기면, 당신은 키보드 타이핑을 대신하는 게 아니라 다음을 맡습니다.
목표를 명확히 한다(무엇을 만들지/무엇은 하지 않을지).
위험한 결정 지점에서 승인·거절을 한다(권한, 보안, 큰 리팩터 방향).
검증 기준을 제공한다(통과해야 할 테스트, 성능 기준, 회귀 위험).
Claude Code는 그 사이의 실행을 맡습니다.
멀티파일 편집: "한 파일"이 아니라 "변경 세트"로 생각하기
현대 개발에서 기능 하나는 보통 여러 파일에 걸쳐 있습니다. 라우트/핸들러, 도메인 로직, 타입, 테스트, 문서까지 같이 바뀌죠. Claude Code는 디렉터리 단위로 프로젝트에 접근하고, 필요한 파일을 탐색·열람한 뒤 여러 파일을 조율해서 수정하는 쪽에 강합니다.1
이 특성이 중요한 이유는 두 가지입니다.
첫째, 작업의 단위가 "함수 하나"가 아니라 작동하는 변경 세트(change set)가 됩니다. 'API 응답을 바꾸면 프론트 타입과 테스트도 함께 바뀌어야 한다' 같은 일관성을 에이전트가 유지하기 쉬워집니다.
둘째, 여러분의 요청도 "이 함수 고쳐줘"에서 "이 요구사항을 만족하는 변경 세트를 만들어줘"로 바뀌어야 합니다. 이 책의 이후 장들이 프롬프트 설계(무엇·어디·왜·검증)와 계획 모드(탐색→계획→실행)를 반복해서 강조하는 이유입니다.
Copilot/ChatGPT/Cursor 대비 Claude Code의 강점(그리고 전제)
여기서 비교의 목적은 승자 가리기가 아니라, 도구마다 '주력 모드'가 다르다는 감각을 만드는 것입니다.
Copilot: 흐름을 깨지 않는 '즉시 제안'
Copilot의 강점은 타이핑 흐름 속에서 빠르게 완성해 주는 자동완성입니다.3
ChatGPT/웹 Claude: 대화는 강하지만 실행은 사용자가 한다
웹 채팅은 아이디어 정리, 설계 토론, 코드 리뷰 요청에 유용합니다. 다만 실제 리포지토리에 반영하려면 사용자가 파일을 열고 붙여 넣고 실행해야 하므로, 실행 루프가 끊기기 쉽습니다.3
Cursor: IDE 안에서의 '감독형 에이전트'
Cursor는 IDE 안에서 강력한 에이전트 경험을 제공합니다. 그러나 일반적으로 편집기 중심의 경험은 "내가 보고 있는 맥락"이 더 강하게 작동합니다. 반대로 Claude Code는 터미널과 프로젝트를 중심에 두고, 목표를 주면 필요한 파일/명령을 스스로 오가며 작업을 밀어붙이는 쪽이 주력입니다.2
Claude Code: 완전 에이전틱(autonomous)하게 끝까지 가는 실행력
비교 글들은 Claude Code를 "자연어로 목표를 주면, 코드베이스를 읽고/파일을 쓰고/명령을 실행하고/서브에이전트를 띄우고/MCP로 외부 도구까지 연결해, 작업이 끝날 때까지 반복하는 도구"로 요약합니다.2 또한 에이전트 코딩의 자율성 스펙트럼에서 Claude Code는 최소 감독으로 다단계 작업을 수행하는 '상위 레벨' 도구로 분류됩니다.3
다만 전제가 있습니다. 자율성은 곧 영향력이고, 영향력은 곧 사고의 반대말이 아닙니다. Claude Code가 빠르게 큰 변경을 만들 수 있는 만큼, 권한과 검증을 설계하지 않으면 위험해집니다. 그래서 Claude Code는 체크포인트(되감기)와 권한 모델(승인)을 안전장치로 둡니다.1
"채팅"이 아니라 "동료"로 쓰는 첫 번째 습관
Claude Code를 동료로 대할 때 가장 먼저 바뀌는 습관은 이것입니다.
질문을 던지고 답을 기다리지 않는다.
목표를 위임하고, 검증을 요구한다.
결과물을 리뷰하고, 다음 작업을 다시 위임한다.
Claude Code는 작업 도중에도 당신이 끼어들어 방향을 바꾸거나 제약을 추가할 수 있는 대화형 루프를 전제로 합니다.1 즉, "한 번의 프롬프트로 끝내는 마법"이 아니라, 짧은 지시–수행–검증–수정의 리듬이 실전에서 가장 강합니다.
다음 장부터는 이 동료와 실제로 함께 일하기 위한 준비를 시작합니다. 어떤 환경에서 실행할지, 어떤 방식으로 세션을 시작하고 끝낼지, 그리고 '한 번에 많이'가 아니라 '안전하게 빠르게' 가는 루틴을 만들어 갈 것입니다.
참고
1How Claude Code works - Claude Code Docs
2Claude Code vs Cursor vs GitHub Copilot: An Honest Comparison
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.