AI CLI - Claude Code와 에이전틱 코딩

6장. PKM 방법론

Dec 11. 2025 brunch_membership's

구조에서 실행으로

폴더 구조를 잡고, 메모 습관을 만들고 나면 남는 것은 실행입니다. 파일을 3초 안에 찾고, 맥락을 잃지 않으며, 어제 한 일을 정확히 기억하는 시스템이 필요합니다. 이 시스템을 가능하게 만든 것은 CLI(Command Line Interface) 기반 AI 에이전트였습니다. 터미널에서 자연어로 명령하면 AI가 파일을 읽고 수정하고 생성합니다. 브라우저를 열 필요도, 복사-붙여넣기를 할 필요도 없습니다.

터미널로 돌아온 AI

GUI(Graphical User Interface)가 지배하는 시대에 왜 다시 커맨드라인일까요. 세련된 IDE(Integrated Development Environment) 시대에 터미널 기반 도구가 부활하는 것은 직관에 어긋나 보입니다.

그러나 에이전틱 코딩의 거의 모든 돌파구는 커맨드라인 도구로 먼저 세상에 나왔습니다. Claude Code, Aider, Gemini CLI, OpenCode. 가장 진보한 AI 도구들이 가장 오래된 인터페이스로 돌아온 것입니다. 터미널은 건강한 제약을 부과합니다. 에이전트가 숨을 수 있는 시각적 장식이 없기 때문에 자신이 무엇을 하고 있는지 반드시 설명해야 합니다. 이 투명성이 신뢰를 만듭니다.

터미널이 AI 에이전트의 기반이 된 데는 구조적 이유가 있습니다. 세션이 유지되는 동안 컨텍스트가 보존되고, 창을 여러 개 열어 에이전트를 동시에 돌릴 수 있으며, 명령어 하나를 스크립트로 만들면 반복 작업이 자동화됩니다. 무엇보다 AI가 지금 무엇을 하고 있는지 화면에 그대로 드러납니다.

터미널 에이전트와 IDE 확장은 서로 다른 강점을 가집니다. 터미널 에이전트는 복잡한 다중 파일 작업이나 자율적 리팩토링, 장시간 실행 작업에 적합합니다. IDE 확장은 코드를 작성하면서 실시간으로 제안을 받는 상호작용에 어울립니다. 둘 중 하나를 고르는 문제가 아닙니다. 터미널은 자율적 작업의 기반이고, IDE는 협업의 표면입니다.

에이전틱 코딩이란 무엇인가

에이전틱 코딩(Agentic Coding)은 AI를 자동완성에서 자율적 작업 실행자로 전환합니다. 기존 코딩 어시스턴트가 한 줄 한 줄 입력할 때까지 기다리며 다음에 올 것을 제안했다면, 에이전틱 시스템은 고수준 목표를 받아 단계로 나누고 독립적으로 실행하며 환경의 피드백에 따라 접근 방식을 스스로 조정합니다. '다음 줄에 뭐 쓸까요'라고 묻는 대신 '이 기능을 구현해주세요'라는 요청을 받아 스스로 완수하는 것입니다.

핵심 차이는 자율성과 범위에 있습니다. 기존 AI 도구가 에디터에서 보이는 코드를 분석하고 다음 조각을 제안한다면, 에이전틱 코딩 도구는 전체 코드베이스를 읽습니다. 디렉토리 전체의 파일 관계를 이해하고, 변경 사항이 작동하는지 확인하기 위해 명령을 실행하고, 테스트가 통과하고 요구사항이 충족될 때까지 반복합니다. 관련 파일 파악, 코드 수정, 테스트 검증, 문제 발견 시 재시도. 이 순환이 요구사항을 충족할 때까지 계속됩니다.

2025년 현재 가장 실용적인 도구들은 완전 자율이 아닌 '감독된 자율성(Supervised Autonomy)'에 집중합니다. 목표와 가드레일을 제공하면 에이전트가 독립적으로 실행하고, 결정 지점에서 사람이 승인하거나 거부합니다. 자율성의 스펙트럼에서 자동완성과 코드 제안은 낮은 단계에 속하고, 감독된 자율 실행이 현재 실용적 지점이며, 완전 자율은 아직 실험 단계입니다.