지시 대신 위임하는 방식 | Agentic Coding

Overview

AI 코딩 도구는 처음엔 코드 한 줄을 자동완성하는 정도였지만, 지금은 "완료된 할 일을 숨기는 필터를 추가해줘" 같은 방향만 주면 파일을 직접 찾아 고치고 실행해 결과까지 확인합니다. 같은 도구라도 사람이 어디까지 손을 떼고 맡길 수 있는지는 단계마다 다릅니다.

Claude Code는 이 흐름 안에서도 터미널에서 일을 통째로 맡기는 데 집중한 도구입니다. 이 레슨을 읽으면 AI 코딩 도구가 넓혀 온 단계를 구분하고, Claude Code가 그 위에 더한 두 가지 특징을 설명할 수 있습니다.

학습 목표

• AI 코딩 도구가 자동완성·대화형 편집·Agentic 코딩으로 역할을 넓혀 온 흐름을 구별합니다.
• Agent 공식(Tool + Loop + 자율 판단)이 실제 개발 작업에서 어떻게 구체화되는지 이해합니다.
• Claude Code가 Agentic 코딩 위에 더한 Terminal-native·프로그래밍 가능 두 특징을 설명할 수 있습니다.

Agentic 코딩: 지시 대신 위임하는 방식

코딩 도구는 자동완성에서 출발해 점점 더 넓은 맥락과 더 큰 자율성으로 진화해 왔습니다.

코딩 도구의 진화 3단계

자동완성은 "지금 이 줄"만 보고 다음 줄을 제안합니다. 대화형 편집은 사용자가 지정한 파일과 범위 안에서 요청대로 코드를 고칩니다. Agentic은 프로젝트 전체와 실제 실행 결과까지 보면서 탐색·수정·실행을 스스로 반복합니다. 단계를 거듭할수록 AI가 보는 맥락이 넓어지고 맡는 판단이 커집니다.

그래서 Agentic 코딩은 "완료된 할 일을 숨기는 필터를 추가해줘"처럼 방향만 제시하면, AI가 관련 파일을 찾고 고치고 테스트까지 스스로 실행하는 방식입니다. 개발자가 직접 조작하는 일은 줄고, AI에게 맡기는 판단이 늘어납니다.

세 단계는 우열이 아니라 상황이 다릅니다. 한 줄을 채울 땐 자동완성, 짧은 수정엔 대화형 편집, 여러 파일을 오가며 실행 결과까지 봐야 하는 작업엔 Agentic이 강합니다. Copilot·Cursor 같은 도구도 Agentic 방식을 함께 제공하고, 차이는 지금 작업에서 AI에게 어느 단계까지 맡기느냐입니다. Claude Code는 그중 Agentic에 집중한 도구입니다.

Agent 공식을 코딩에 대입하기

Agent 공식입니다.

Agent = Tool + Loop + 자율적 판단

Agentic 코딩은 이 공식을 코딩 맥락에 그대로 대입한 것입니다.

• Tool: 파일 읽기/쓰기, 터미널 명령어 실행, 웹 검색. 개발자가 IDE·터미널에서 하는 모든 행동
• Loop: 한 번의 요청 뒤에 탐색 → 수정 → 실행 → 확인을 여러 차례 반복
• 자율적 판단: "다음에 어느 파일을 열지", "테스트가 실패했으면 어디를 고칠지"를 스스로 결정

Agentic 코딩은 새로운 원리가 아니라, Agent 구조가 코딩 도구의 진화 속에서 구체화된 결과입니다.

실제 개발 작업에서 달라지는 점

앞 레슨에서 Agent가 어떤 구조인지 봤으니, 여기서는 그 구조가 코딩 도구 안에서 개발자의 역할을 어떻게 바꾸는지 봅니다.

"이 Todo 앱에 완료된 할 일을 숨기는 필터를 추가해줘."

같은 요청이라도 어느 단계로 다루느냐에 따라 사람이 맡는 일이 달라집니다.

한 문장 뒤에서 벌어지는 작업 흐름

자동완성 단계에서는 개발자가 Todo 목록 컴포넌트를 직접 열고, 필터 상태와 렌더링 위치를 찾아야 합니다. AI는 지금 쓰는 줄 다음에 올 코드를 제안하는 데 그칩니다.

대화형 편집 단계에서는 개발자가 수정할 범위를 지정합니다. "이 컴포넌트에 completed 필터를 추가해줘"처럼 파일과 요구사항을 좁혀 주면, AI가 그 범위 안에서 코드를 고칩니다.

Agentic 단계에서는 목표만 받고 다음 흐름을 스스로 이어 갑니다.

1. 파일 검색으로 Todo 상태와 목록 렌더링 위치를 찾습니다.
2. 관련 컴포넌트와 테스트를 읽고 수정 범위를 정합니다.
3. 필터 UI와 상태 로직을 파일에 씁니다.
4. 테스트나 개발 서버로 결과를 확인합니다.
5. 실패하면 다시 1~4를 반복합니다.

개발자가 한 일은 "완료된 할 일을 숨길 수 있어야 한다"는 방향 제시입니다. 어디를 볼지, 어떻게 고칠지, 고친 뒤 뭘 확인할지는 AI가 판단합니다.

판단을 나눠 맡기기

핵심 변화는 판단의 분업입니다.

• 개발자: "무엇을 만들 것인가", "어떤 제약을 둘 것인가", "이 결과가 맞는가"
• AI: "그걸 만들려면 지금 뭘 해야 하는가"

이 분업이 성립하려면 AI가 프로젝트 전체의 파일을 읽고, 명령어를 실행하고, 실패 결과를 해석할 수 있어야 합니다. 자동완성과 대화형 편집에서는 개발자가 중간 단계를 더 자주 조정하지만, Agentic 코딩에서는 그 조정의 일부를 AI에게 넘깁니다.

Claude Code: 어디서든 실행, 동작 설계 가능한 Agent

Agentic 코딩 도구는 하나가 아닙니다. 여러 AI 코딩 도구가 Agent 기능을 갖춰 가고 있습니다. 그중 Claude Code는 Tab 자동완성이나 IDE 안의 편집 패널보다, 터미널에서 일을 통째로 맡기는 데 집중한 도구입니다.

Claude Code = Agentic 코딩 + Terminal-native + 프로그래밍 가능

Terminal-native: 어디서든 호출

Claude Code는 터미널에서 돌아가는 독립 CLI 도구입니다. 특정 IDE 안의 Tab 제안 기능이 아니라, 터미널이 있으면 어디서든 호출할 수 있는 Agent입니다.

• 로컬 개발 환경: IDE를 안 띄우고 터미널만으로도 사용
• 원격 서버: SSH로 붙은 서버 안에서 실행
• CI/CD 파이프라인·스크립트·Docker 컨테이너: 자동화 흐름 안에 끼워 넣기

VS Code·JetBrains 확장으로도 제공하긴 하지만, 본질은 "어디서든 돌아가는 CLI"입니다.

프로그래밍 가능: 동작 방식 자체를 코드로 정의

Claude Code에서는 동작 규칙 자체를 프로젝트 안에 파일로 정의할 수 있습니다. Agent가 파일을 읽고 명령어를 실행하는 방식을 프로젝트 규칙에 맞춰 고정하는 장치입니다.

• CLAUDE.md: 프로젝트 지침서. 코드 컨벤션·주의사항을 AI에게 상시로 전달
• Hooks: 작업 전/후에 자동으로 돌아가는 스크립트 (lint, 테스트, 차단 규칙)
• Skills: 반복 작업을 정리해둔 매뉴얼
• Subagent: "테스트 담당", "리뷰 담당"처럼 역할을 나눈 전문 AI
• MCP: 데이터베이스·외부 API 등 외부 시스템과의 연결 통로

이 도구들을 어떻게 쓰는지는 Chapter 03과 Chapter 06-08에서 하나씩 다룹니다. 지금은 "Claude Code는 Agentic 작업을 내 프로젝트에 맞게 설계할 수 있다"는 점만 기억하면 됩니다.

두 가지 특징이 중요한 이유

Terminal-native와 프로그래밍 가능은 "있으면 편한 부가 기능"이 아닙니다. Agentic 코딩의 가치를 실제 작업 환경에서 작동하게 하는 핵심 특징입니다.

• Agent를 어디서든 실행할 수 없으면 자동화 흐름에 끼워 넣을 수 없습니다.
• 동작을 직접 설계하지 못하면 프로젝트 규칙을 AI에게 매번 다시 설명해야 합니다.

이 두 가지 특징이 있으면 Claude Code는 범용 도구가 아니라 내 프로젝트에 맞춰진 Agent가 됩니다.

핵심 포인트 정리

1. AI 코딩 도구의 역할 확장: 자동완성은 다음 줄을 제안하고, 대화형 편집은 지정한 범위를 고치고, Agentic 코딩은 탐색·수정·실행까지 스스로 반복합니다.
2. 판단의 분업: 개발자는 무엇을·왜 만드는지를 정하고, AI는 그걸 만드는 중간 단계를 판단합니다.
3. Claude Code = Agentic 코딩 + Terminal-native + 프로그래밍 가능: 터미널에서 작업 루프를 이어 가고, 동작 방식 자체를 프로젝트 안에 파일로 설계할 수 있는 Agent입니다.

FAQ

이어서 배울 내용

이 레슨에서는 Agentic 코딩과 Claude Code의 두 가지 특징을 살펴봤습니다. 다음 챕터에서는 Claude Code를 직접 설치하고 첫 대화를 나눠봅니다.

• Claude Code 설치 방법과 비용 구조
• 작업별 모델 선택 가이드 (Opus·Sonnet·Haiku)
• 설치 확인과 첫 실행