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

Overview

같은 AI 코딩 도구라도 한 줄씩 제안을 받는 방식과 일을 통째로 맡기는 방식은 개발자가 하는 일이 다릅니다. 어떤 작업을 어느 방식에 맡길지는 그때그때 개발자가 정합니다.

이 레슨을 마치면 지금 하는 작업을 어느 단계의 도구에 맡길지 판단하고, Claude Code가 무엇에 집중한 도구인지 설명할 수 있습니다.

학습 목표

• 하나의 요청이 자동완성·대화형 편집·Agentic 코딩에서 각각 어떻게 처리되는지 구분합니다.
• 일을 위임할 때 개발자와 AI가 판단을 어떻게 나누는지 설명할 수 있습니다.
• Claude Code의 두 가지 특징(어디서나 같은 Agent, 동작 설계)을 설명할 수 있습니다.

지시에서 위임으로: 코딩 도구의 진화 3단계

코딩 도구는 자동완성에서 출발해 점점 더 넓은 맥락과 더 큰 자율성으로 진화해 왔습니다. 단계가 올라갈수록 AI가 보는 범위가 넓어지고, AI가 스스로 정하는 일이 늘어납니다.

같은 요청, 세 가지 처리 방식

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

같은 요청이라도 어느 단계의 도구에 맡기느냐에 따라 개발자가 하는 일이 달라집니다.

자동완성 단계에서 AI는 지금 작성 중인 줄만 보고 다음 코드를 제안합니다. 개발자가 Todo 목록 컴포넌트를 직접 열고, 목록이 렌더링되는 위치를 찾고, 필터 상태를 어디에 만들지 정해야 합니다.

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

Agentic 코딩 단계에서 AI는 프로젝트 전체와 실행 결과까지 보면서 탐색·수정·실행을 스스로 반복합니다. 앞의 두 단계와 달리, 개발자가 파일을 열어 주거나 수정 범위를 지정할 필요가 없습니다.

세 단계는 우열이 아니라 쓰임이 다릅니다. 한 줄을 채울 땐 자동완성이, 짧은 수정엔 대화형 편집이, 여러 파일을 오가며 실행 결과까지 봐야 하는 작업엔 Agentic 코딩이 빠릅니다. Copilot·Cursor 같은 도구도 세 단계를 함께 제공하기 때문에, 이 구분의 쓸모는 지금 작업을 어느 단계에 맡길지 정하는 데 있습니다.

Agentic 코딩의 작업 흐름

위의 Todo 요청을 받은 AI는 다음 흐름으로 진행합니다.

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

이 흐름은 앞 레슨에서 배운 Agent 공식(Tool + Loop + 자율적 판단)이 코딩 작업에 그대로 적용된 모습입니다. 파일을 읽고 명령을 실행하는 것이 Tool이고, 탐색부터 확인까지의 반복이 Loop이며, 다음에 어느 파일을 열지 정하는 것이 자율적 판단입니다.

판단을 나눠 맡기기

일을 위임할 때 바뀌는 것은 판단의 분업입니다.

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

앞의 Todo 요청에서 개발자가 정한 것은 "완료된 할 일을 숨길 수 있어야 한다"는 목표뿐이고, 어디를 볼지·어떻게 고칠지·고친 뒤 무엇을 확인할지는 AI가 정했습니다. 개발자의 역할은 코드를 직접 조작하는 일에서, 방향을 정하고 결과를 검증하는 일로 이동합니다.

Claude Code: 위임에 집중한 도구

Agentic 코딩을 제공하는 도구는 여럿이지만, Claude Code는 그중에서도 일을 통째로 맡기는 방식에 처음부터 집중한 도구입니다.

어디서나 같은 Agent

Claude Code는 터미널 CLI로 시작했지만, 지금은 터미널, VS Code·JetBrains 확장, 데스크톱 앱, 웹 브라우저 어디서 실행하든 같은 엔진이 작동합니다. 프로젝트에 정의한 규칙과 설정도 그대로 적용됩니다.

덕분에 작업 환경이 바뀌어도 도구를 갈아타거나 프로젝트 상황을 다시 설명할 필요가 없습니다. 코드를 편집할 때는 IDE에서, 자리를 비울 때는 웹에서, 같은 Agent에게 같은 방식으로 일을 맡길 수 있습니다.

동작을 내 프로젝트에 맞게 설계

Claude Code는 Agent가 일하는 방식 자체를 프로젝트 안에 파일로 정의할 수 있습니다.

• CLAUDE.md: 프로젝트 지침서로, 코드 컨벤션과 주의사항을 매 세션 자동으로 전달합니다.
• Hooks: 작업 전후에 자동으로 실행되는 스크립트로, lint·테스트·차단 규칙을 강제합니다.
• Skills: 반복 작업을 정리해 둔 매뉴얼입니다.
• Subagent: 맡긴 작업을 별도 Context에서 처리하고 결과만 돌려주는 보조 AI입니다.
• MCP: 데이터베이스·외부 API 같은 외부 시스템과의 연결 통로입니다.

이 장치들이 없으면 프로젝트 규칙을 위임할 때마다 다시 설명해야 하고, 설명을 빠뜨린 만큼 결과가 달라집니다. 규칙을 파일로 정의해 두면 Claude Code는 범용 도구가 아니라 내 프로젝트에 맞춰진 Agent가 됩니다. 각 장치의 사용법은 강의 뒷부분에서 하나씩 다룹니다.

핵심 포인트 정리

1. 단계 선택 기준: 한 줄을 채울 땐 자동완성에, 좁은 범위의 수정엔 대화형 편집에, 여러 파일을 오가며 실행 결과까지 봐야 하는 작업엔 Agentic 코딩에 맡깁니다.
2. 판단의 분업: 개발자는 무엇을 만들지 정하고 결과를 검증하며, AI는 그 목표까지 가는 중간 단계를 판단합니다.
3. Claude Code의 두 특징: 터미널·IDE·데스크톱·웹 어디서나 같은 Agent로 실행되고, 동작 방식을 프로젝트 안에 파일로 설계할 수 있습니다.

FAQ

이어서 배울 내용

다음에는 Claude Code를 직접 설치하고 첫 대화를 시작합니다. 요금제와 작업 성격에 맞는 모델을 고르는 기준도 함께 다룹니다.