Claude Code (클로드 코드)
Anthropic 의 CLI 형 코딩 에이전트. 터미널에서 Claude 에게 파일을 읽히고, 쓰게 하고, 명령을 실행시킨다.
1줄 정의
Anthropic 의 CLI 형 코딩 에이전트. 터미널에서 Claude 에게 파일을 읽히고, 쓰게 하고, 명령을 실행시킨다.
전체 시스템에서 맡는 역할
Claude Code 를 “AI 에게 코드 쓰게 하는 도구” 로 말하면 크게 손해 보는 용어다. 실제로는 에이전트형 도구의 설계 사상을 배울 수 있는 참조 구현 으로 기능한다.
구조를 대충 나누면 이렇다.
- CLI UI: 터미널에서 대화하며 지시를 주는 층
- Harness: Claude 의 메시지 처리, 도구 호출, 권한 제어를 묶는 층 (Claude Agent SDK 로 분리 제공)
- Tools: 파일 편집, bash 실행, 브라우저 조작, MCP 서버 호출 같은 구체 도구 모음
- Skills: 용도별 프롬프트·절차 세트 (
/skill로 호출)
이게 “Cursor 나 Windsurf 와 뭐가 다른가” 라는 질문에 대한 최단 대답이 된다. Cursor 가 에디터 에 에이전트를 얹는 방향이라면, Claude Code 는 터미널 을 작업장으로 삼아 에디터에 묶이지 않는다. 터미널 + 파일시스템 + bash 라는 클래식 Unix 전제의 작업을 그대로 다룬다.
agentic retrieval 이야기와 이으면 더 재미있다. 초기 Claude Code 는 로컬 vector DB 에 사전 embedding 하는 방향이었지만, 지금은 grep/ripgrep 기반 agentic search 중심으로 옮겼다는 설계 변천이 참고된다. “검색을 똑똑하게” 가 아니라 “검색을 부르는 agent 를 똑똑하게” 쪽으로 키를 튼 사례다.
흔한 오해
- 오해 1: Claude Code 는 Anthropic 판 Cursor 다, 라고 받아들여지기 쉽다.
– 실제로는 Cursor 는 IDE 이고 Claude Code 는 agent harness 다. 전자는 VS Code 를 확장하는 발상, 후자는 CLI 에서 Claude 를 직접 부르는 발상. Cursor 가 MCP 로 Claude 를 쓸 수도 있지만, Claude Code 가 하는 일의 대부분은 IDE 에 묶이지 않는 쪽에 있다.
- 오해 2: Claude Code 는 보조 완성 도구다, 라고 여겨지기 쉽다.
– 실제로는 탭 완성이나 인라인 보조 용도가 아니라, 에이전트적인 긴 작업 (파일 교차 리팩터, 스펙 문서 기점의 멀티 파일 구현, 테스트와 병행하는 수정 등) 을 돌리는 도구다. 3~30 분 단위의 작업에 최적화되어 있다.
- 오해 3: Claude Code 는 Claude 의 API 래퍼다, 라고 단순화되기 쉽다.
– 실제로는 래퍼라기보다 harness 다. 도구 실행, 파일 차분 관리, 권한 정책, 서브에이전트 생성, 컨텍스트 관리까지 들어가 있어서 단순 API 호출층이 아니다.
이 용어가 중요한 이유
Claude Code 를 “쓸 수 있는지” 가 아니라 “어떻게 짜여 있는지” 로 볼 수 있게 되면, 자체 에이전트를 설계할 때의 참조점 이 생긴다. 이게 실무 가치다.
이 글을 읽고 있는 독자는 자사 제품에 AI 를 넣는 설계 판단을 해야 하는 자리에 있을 가능성이 높다. 그때 “에이전트 harness 를 어떻게 짤 것인가” 라는 질문에 대해 Claude Code 는 크고 잘 다듬어진 샘플로 기능한다.
- 도구 호출의 입자를 어디서 나눌 것인가
- 권한을 어떻게 설계할 것인가 (파일 쓰기를 매번 확인할 것인가, 모드로 나눌 것인가)
- 서브에이전트와 부모 에이전트의 컨텍스트 경계를 어디에 그을 것인가
- 코드 검색은 사전 index 인가, agent search 인가
- Skills 와 Commands 의 경계는 어디인가
Claude Code 는 여기에 대해 완성된 하나의 답을 갖고 있다. 동의 못 하는 부분도 포함해서, 스스로 설계할 때의 비교 기준이 된다.
이 용어가 나오는 기사
- Claude Code 에서 100만 토큰이 현실이 된다 (※ 발행 후 URL 갱신)
다음에 읽을 용어 3개
- harness — Claude Code 의 핵심 구조.
- agentic retrieval — Claude Code 가 채택한 검색 방식.
- MCP — Claude Code 가 외부 도구와 이어지는 규격.