Claude Code — 터미널 에이전트와 자율 워크플로우

3장에서 본 Cursor가 "에디터 안에 AI를 심는" 접근이었다면, Claude Code는 애초에 에디터를 전제하지 않습니다. 같은 "AI 코딩 도구"라는 상자에 담겨 있지만, 시작점이 다릅니다.

에디터가 아니라 터미널이 무대다

Claude Code를 처음 켜면 인라인 자동완성이 나오지 않아 당황하는 분들이 있습니다. 회색 글씨로 다음 줄을 제안하는 그 기능이 없습니다. 결함이 아니라 설계입니다. 이 도구는 IDE 확장이 아니라 터미널에서 도는 에이전트입니다. VS Code나 JetBrains와 연동은 되지만, 본체는 셸 안에서 대화하며 파일을 읽고 쓰고 명령을 실행하는 프로그램입니다.

자동완성이 없다는 게 방향을 말해준다

GitHub Copilot의 원형은 "사람이 타이핑하고 AI가 다음 글자를 거드는" 구조입니다. 커서 뒤를 예측하고, Tab을 누르면 채워지죠. 손을 키보드에서 떼지 않는다는 게 핵심 가치였습니다.

Claude Code는 그 축을 뒤집습니다. 사람이 한 줄씩 치는 걸 돕는 게 아니라, 작업 단위를 통째로 위임받아 스스로 수행합니다. "이 버그 고쳐줘"라고 하면 관련 파일을 찾아 읽고, 원인을 추정하고, 수정하고, 테스트를 돌려 결과를 보고 다시 손봅니다. 그 과정에서 자동완성이 끼어들 자리가 없습니다.

"AI가 작성, 사람이 감독"이라는 반대 철학

이 차이는 취향이 아니라 세계관의 차이입니다. 코파일럿류가 "사람이 운전하고 AI가 조수석에서 거든다"면, Claude Code는 "AI가 운전하고 사람이 방향을 감독한다"에 가깝습니다. 개발자의 역할이 타이핑에서 리뷰와 판단으로 옮겨갑니다.

그래서 실무 습관도 달라집니다. 에이전트가 여러 파일을 한 번에 바꾸는 만큼, 커밋을 자주 찍어 되돌릴 지점을 만들어 두는 게 안전벨트가 됩니다. 자율성이 높다는 건 편한 만큼 의도 밖 변경 위험도 크다는 뜻이니까요.

Claude Code에는 인라인 자동완성 기능이 없습니다. 타이핑을 보조하는 도구가 아니라, 작업을 위임받아 끝내는 에이전트라는 점이 다른 모든 성격을 결정합니다.

자율성을 조립하는 부품들

에이전트가 "알아서 잘한다"는 말은 막연합니다. Claude Code는 자율성을 몇 개의 구체적 부품으로 쪼개서 사용자가 조립하게 합니다.

Subagents와 Skills

Subagents는 독립된 컨텍스트를 가진 하위 에이전트입니다. 메인 대화가 오염되지 않도록 별도 맥락에서 특정 작업을 처리하고, 기본적으로 백그라운드로 돌다가 끝나면 커밋이나 PR로 결과를 돌려줍니다. 큰 작업을 여러 갈래로 쪼개 병렬로 굴릴 때 쓰입니다.

Skills는 SKILL.md라는 폴더형 지시서입니다. "이런 요청이 오면 이런 절차를 따르라"는 재사용 가능한 작업 규격을 파일로 적어두면, 그 조건에 맞는 요청이 왔을 때 해당 절차가 자동으로 로드됩니다. 즉흥적으로 매번 다르게 처리하던 반복 작업을 결정적인 레시피로 고정하는 장치입니다.

MCP·Plan Mode·Hooks

MCP(Model Context Protocol)는 외부 도구와 데이터를 에이전트에 물리는 표준 연결부입니다. 사내 DB, 이슈 트래커, 문서 저장소 같은 걸 붙여 코드 바깥의 맥락까지 끌어옵니다.

Plan Mode는 실행 전에 계획만 먼저 세우고 사람 승인을 받는 모드입니다. 자율성을 높이되 위험한 변경 앞에서는 브레이크를 거는 조절 장치죠. 참고로 2026년 8월 14일부터 Auto 권한 모드가 Pro·Max·Team 플랜의 기본값으로 전환되면서, 자율성의 기본 눈금 자체가 한 칸 올라갔습니다.

Hooks는 특정 이벤트(예: 작업 종료, 파일 저장) 시점에 사용자가 정한 스크립트를 강제로 실행시키는 장치입니다. "매번 이렇게 해줘" 같은 자동 규칙은 기억이 아니라 Hooks로 박아야 실제로 매번 실행됩니다. 이 부품들을 조합하는 정도에 따라 같은 Claude Code라도 자율성 수준이 완전히 달라집니다.

대형 코드베이스를 다루는 방식

수십만 줄짜리 회사 코드에 붙였을 때 버티느냐가 실무 도입의 갈림길입니다. Claude Code는 두 갈래로 접근합니다. 큰 컨텍스트, 그리고 컨텍스트 관리 규율입니다.

Sonnet 5의 100만 토큰, 그리고 Opus 4.8

모델은 목적에 따라 갈아 끼웁니다. 대량의 코드를 한 번에 밀어 넣어야 할 때는 Sonnet 5(claude-sonnet-5)를, 어려운 추론이 필요할 때는 Opus 4.8을 씁니다. 가볍고 빠른 처리에는 Haiku 4.5 같은 선택지도 있습니다.

Sonnet 5는 100만 토큰 컨텍스트를 다룹니다. 다만 CLI 기본값의 정확한 적용 수치는 플랜에 따라 다를 수 있으니 실제 사용 전 확인이 필요합니다.

100만 토큰은 어림잡아 중형 리포지토리 상당 분량을 한 창에 올려두고 대화할 수 있다는 뜻입니다. 관련 파일을 사람이 일일이 찾아 붙여넣는 수고가 크게 줄어듭니다.

CLAUDE.md와 컴팩션

컨텍스트가 아무리 커도 무한하지는 않습니다. 그래서 Claude Code는 두 가지 관행을 씁니다. 첫째, CLAUDE.md로 프로젝트의 규칙·구조·주의사항을 고정해 둡니다. 세션이 새로 시작돼도 이 파일은 늘 먼저 읽히므로, 매번 배경을 다시 설명할 필요가 없습니다. .claudeignore로 볼 필요 없는 경로를 걸러내는 것도 같은 맥락입니다.

둘째, 대화가 길어져 컨텍스트가 차오르면 컴팩션으로 오래된 맥락을 압축하고 /compact·/clear 같은 명령으로 체크포인트를 끊습니다. 방대한 코드베이스에서 긴 세션을 이어갈 때 정확도를 지키는 실전 규율입니다.

요금과 한국어 지원

가격 구조는 다른 도구들과 결이 다릅니다. 가장 눈에 띄는 건 무료 티어가 없다는 점입니다. Claude Code 자체를 쓰려면 유료 구독이 필요합니다.

방향만 짚자면, 개인용 Pro 구간에서 시작해 사용량이 많은 Max 구간(대략 $100~200대)까지 올라가고, 팀·엔터프라이즈 좌석제와 API 종량제가 별도로 병행됩니다. 결제는 전부 USD 기준 해외카드입니다. 원화 로컬 결제수단 지원은 확인이 필요합니다. 구체적인 금액과 좌석 조건은 자주 바뀌므로 공식 요금 페이지에서 직접 확인하시길 권합니다.

한국어는 지원됩니다. 한국어로 직접 지시하고 대화하는 데 문제가 없고, Anthropic 한국어 지원 창구도 존재합니다. 다만 이건 제품 UI 로컬라이제이션과는 층위가 다른 얘기라, 결제 편의성까지 기대하긴 이르다는 점은 감안해야 합니다.

정리하면 Claude Code는 "타이핑을 돕는 도구"가 아니라 "일을 맡기는 동료"에 가깝습니다. 자동완성형이 편한 사람에게는 낯설고, 자율 위임에 익숙해지면 다른 방식으로 돌아가기 어렵습니다. 자신의 작업이 어느 쪽인지 먼저 가늠하는 게 순서입니다. 도구 조합이 궁금하다면 AI 꿀조합과 이 시리즈의 후반 챕터가 참고가 됩니다.

다음 챕터에서는

Windsurf에서 Devin Desktop으로 — 에이전트형 전환에서 한때 유력 후보였던 Windsurf가 왜 브랜드째 사라지고 Devin Desktop으로 흡수됐는지, 그 통합이 에이전트형 시장에 무엇을 남겼는지 짚겠습니다.