클로드 코드 서브에이전트 만들기, 비개발자가 폴더 하나로 시작하는 법

클로드 코드 서브에이전트는 클로드가 일을 나눠 맡기는 AI 직원입니다. 코딩을 몰라도 폴더 하나, 규칙 파일 하나, 직원 파일 몇 개면 시작할 수 있습니다. 이 글은 클로드 데스크톱 앱의 코드 탭에서 폴더를 열고, 내 상황을 알리고, 규칙집과 직원을 만들고, 첫 일을 맡기는 21단계를 안내합니다.

클로드 코드는 파일을 만들고 바꾸고 명령을 실행할 수 있는 도구입니다. 처음에는 권한 모드를 "묻고 진행"(Manual)으로 두고, 되돌릴 수 없는 일은 직접 확인하세요. 메뉴 이름은 2026년 10월 기준입니다.

채팅 AI와 에이전트는 무엇이 다른가

채팅 AI는 물어보면 답을 줍니다. 에이전트는 일을 맡기면 끝까지 해 옵니다. 채팅 AI를 쓸 때는 복사하고, 붙여 넣고, 다음 지시를 내리는 일이 전부 사용자 몫이라 AI의 심부름꾼이 된 것 같은 기분이 듭니다. 이 수고를 줄이려는 것이 에이전트입니다.

비유하면 이렇습니다.

• 일반 채팅 AI는 아무것도 모르는 인턴입니다.
• 프로젝트 기능은 내 상황을 어느 정도 아는 대리급 직원입니다.
• 에이전트는 업무를 숙지한 베테랑 비서입니다. 비서가 여러 AI 직원에게 지시하고 결과를 보고합니다.

이 비유는 일을 맡기는 "위임"의 개념과 닿아 있습니다. 내가 모든 일을 하는 대신, 맡길 사람과 맡길 일을 정하는 쪽으로 내 역할이 바뀝니다.

준비물과 용어

준비물

• AI 구독: 클로드 데스크톱 앱의 코드 탭은 유료 구독이 필요합니다. Pro 요금제(월 결제 기준 월 20달러, 2026년 10월 기준)로 시작할 수 있고, 요금제와 사용량 한도는 공식 안내에서 확인합니다. ChatGPT나 제미나이를 직원으로 붙이는 방법은 뒤에서 다룹니다.
• 컴퓨터: 맥과 윈도우 모두 됩니다. 스마트폰만으로는 어렵습니다.

용어 네 가지

이 글에서는 클로드 코드의 기능을 일터에 비유해 부릅니다.

• 비서: 내가 대화하는 클로드 본체입니다.
• AI 직원: 비서가 일을 시키는 서브에이전트(전문 업무를 맡은 보조 AI)입니다. 직원마다 자기만의 작업 공간(컨텍스트)이 있어서 내 대화 기록을 모르고, 맡은 일을 끝낸 뒤 결과 보고만 비서에게 돌려줍니다.
• 업무 지시서: 직원이 먼저 읽는 안내문입니다. 서브에이전트 정의 파일(.md)이 이 역할을 합니다.
• 규칙집: 모두가 따를 공통 규칙입니다. CLAUDE.md라는 파일이며 클로드가 세션을 시작할 때마다 읽습니다.
• 폴더: 직원들의 사무실이자 책상입니다. 클로드 코드는 내가 고른 폴더 안에서 일합니다.

1부. 폴더와 클로드 데스크톱 앱 준비

1. 바탕화면에 폴더를 하나 만듭니다. 이름은 마음대로 정해도 됩니다. 이 폴더가 AI 직원들의 사무실이 됩니다.

확인: 바탕화면에 새 폴더가 보입니다.

2. 검색해서 클로드 공식 사이트(claude.com/download)에서 데스크톱 앱을 내려받습니다. 맥, 윈도우(x64와 ARM64) 설치 파일이 있습니다.

확인: 설치 파일이 내려받아집니다.

3. 내려받은 앱을 설치하고 로그인합니다.

확인: 앱 메인 화면이 열립니다.

4. 앱 위쪽의 "Code" 탭을 누릅니다. 이것이 클로드 코드입니다. 앱 안에 클로드 코드가 들어 있어서 터미널에 따로 설치하지 않아도 됩니다.

확인: 새 세션을 시작하는 화면이 보입니다.

5. 왼쪽의 "+ New"를 누릅니다(맥 Cmd+N, 윈도우 Ctrl+N). 입력창 아래에서 실행 환경을 "Local"로 고릅니다.

확인: 내 컴퓨터에서 작업하는 모드가 선택됩니다.

6. 옆의 프로젝트 폴더 선택을 눌러 1단계에서 만든 폴더를 고릅니다.

확인: 채팅 AI가 그 폴더 안에서 일하는 모드로 바뀝니다.

7. 입력창 아래에서 권한 모드를 확인합니다. 처음에는 파일을 고치거나 명령을 실행하기 전에 묻는 "Manual"을 권합니다. 편하게 쓰려는 마음에 권한 확인이 없는 모드("Bypass permissions")를 켜면 사고가 났을 때 되돌리기 어렵습니다.

확인: 권한 모드가 정해졌습니다.

2부. 내 상황 알리기

이 단계가 가장 중요합니다. 간단히 말해도 클로드가 에이전트를 만들어 주지만, 원하는 에이전트를 얻으려면 내 상황을 정확히 알려야 합니다. 질문을 대신 던져 주는 스킬이나 템플릿이 없어도, 클로드에게 질문을 시키면 됩니다. 아래 프롬프트를 입력창에 붙여 넣어 시작합니다.

8. 클로드에게 내 상황을 한 번에 하나씩 묻게 합니다.

나는 코딩을 모르는 직장인이야. 내가 하는 일과 앞으로 AI 직원들에게 맡기고 싶은 일을 파악하고 싶어. 한 번에 질문 하나씩, 쉬운 말로 물어봐 줘. 내가 모르는 질문은 넘어가도 돼. 질문은 서른 개 안팎으로 하고, 끝나면 내가 한 답을 요약해서 보여 줘.

확인: 클로드가 질문을 하나씩 던지기 시작합니다.

9. 질문에 답합니다. 어려운 질문은 건너뛰고, 자세히 말하고 싶은 부분은 길게, 단답도 괜찮습니다. 맡기고 싶은 일, 지금 하는 방식, 하기 싫은 일, 지켜야 할 규칙을 이야기합니다.

확인: 모든 질문에 답하면 클로드가 요약을 보여 줍니다.

3부. 규칙집과 직원 만들기

10. 요약이 맞는지 확인한 뒤, 클로드에게 규칙집과 직원을 만들어 달라고 합니다.

지금까지 답한 내용을 바탕으로 이 폴더에 CLAUDE.md(우리 팀 규칙집)를 만들어 줘. 규칙에는 쉬운 말로 설명하기, 파일은 지우기 전에 반드시 먼저 묻기, 글 게시와 결제는 하기 전에 반드시 먼저 묻기를 넣어 줘. 그리고 .claude/agents 폴더에 서브에이전트(AI 직원) 3명의 업무 지시서를 만들어 줘. 내 일에 맞게 조사 담당, 기획 담당, 대본 담당처럼 역할을 정해 줘.

확인: 클로드가 파일을 만들겠다고 허락을 구합니다. 허락하면 규칙이 파일로 만들어지고, 직원마다 업무 지시서 파일이 생깁니다.

11. 만들어진 파일을 열어 읽어 봅니다. 서브에이전트 파일은 맨 위에 name과 description이 있고, 그 아래에 직원의 역할과 지침이 적혀 있습니다. description은 비서가 "이 일은 이 직원에게 맡기자"라고 판단하는 근거라서 한두 줄로 간결하게 적는 것이 좋습니다.

확인: 파일 내용이 내 상황과 맞습니다. 맞지 않으면 "조사 담당의 지침에 이 내용을 추가해 줘"처럼 말로 고치게 합니다.

12. 처음에는 직원 3명이면 충분합니다. 많이 만들수록 사용량 한도를 빨리 쓰고 관리가 복잡해집니다. 서브에이전트도 같은 사용 한도에서 소모됩니다.

확인: 직원이 3명 안팎입니다.

규칙집에 "반드시 먼저 묻기"라고 적어도 항상 지켜진다는 보장은 없다는 점을 알아 둡니다. CLAUDE.md는 클로드에게 주는 지침이지 차단 장치가 아닙니다. 반드시 막아야 하는 일은 권한 모드(Manual)와 권한 설정으로 막습니다.

4부. 첫 일 맡기고 다듬기

13. 만들어진 직원에게 일을 하나 맡깁니다. 직원의 역할을 말해 지정하거나, 일만 말하면 비서가 description을 보고 알맞은 직원에게 맡깁니다.

조사 담당에게 최근 한 달 동안 내 분야에서 화제가 된 주제 다섯 개를 조사해서 표로 정리하라고 시켜 줘.

확인: 직원이 결과물을 내놓습니다.

14. 결과가 마음에 들지 않으면 어디가 어떻게 다른지 적어 고쳐 달라고 요청합니다. 이렇게 다듬는 과정이 곧 에이전트를 키우는 과정입니다.

확인: 수정된 결과가 나옵니다.

15. 중간에 막히면 막힌 화면을 캡처합니다.

확인: 캡처 이미지가 준비됩니다.

16. 캡처 이미지를 클로드에게 보여 주고 "여기서 막혔어, 어떻게 해야 해?"라고 묻습니다.

확인: 클로드가 문제를 읽고 고치거나 다음 방법을 안내합니다.

5부. 다른 AI 직원 연결과 수정(선택)

17. 클로드 하나로도 충분합니다. 다른 회사 AI를 직원으로 더하고 싶다면 클로드 코드에게 설치와 연결을 시킵니다. 사용법을 몰라도 설치와 연결은 클로드가 합니다.

ChatGPT와 제미나이를 직원으로 두려고 해. 네가 지휘해야 하니까 코덱스와 안티그래비티를 설치하고 서로 일을 주고받도록 연결해 줘.

확인: 클로드가 설치와 연결을 진행합니다. 다만 각 서비스의 로그인과 구독은 내가 직접 해야 하니, 로그인이 필요한 단계에서 멈추고 알려 달라고 덧붙이면 안전합니다.

OpenAI의 코덱스(Codex)와 구글의 제미나이는 터미널에서 쓰는 도구(Codex CLI, Gemini CLI)가 따로 있어서, 클로드 코드가 명령으로 일을 넘기기에 연결이 쉽습니다. 안티그래비티(Antigravity)는 구글의 에이전트 중심 편집기 앱이라 클로드 코드가 지휘하는 방식이 다를 수 있습니다. 제미나이를 직원으로 쓰려면 이렇게 요청하는 편이 정확합니다.

ChatGPT와 제미나이도 직원으로 쓰고 싶어. 네가 지휘할 수 있도록 Codex CLI와 Gemini CLI를 설치하고 서로 일을 주고받게 연결해 줘. 로그인이 필요한 곳에서는 멈추고 나에게 알려 줘.

확인: 설치가 끝나면 클로드가 두 도구의 버전을 확인해 알려 줍니다.

18. 유튜브 같은 서비스의 데이터를 쓰려면 API 연결을 지시합니다. 유튜브 데이터 API는 기본 할당량(하루 10,000 단위) 안에서 쓸 수 있습니다. API 키는 구글 클라우드 콘솔에서 내 계정으로 발급해야 합니다. 클로드에게 "유튜브 API를 연결하고 싶어, 키 발급부터 순서대로 알려 줘"라고 하면 단계를 안내합니다. 키는 채팅에 붙여 넣지 말고 안내받은 위치에 저장합니다.

확인: 연결이 끝나면 클로드가 데이터를 가져올 수 있다고 알려 줍니다.

19. 마음에 안 드는 부분이나 오류가 있으면 클로드에게 말하듯 이야기하고 고치라고 지시합니다.

확인: 고쳐진 결과가 나옵니다.

20. 고친 내용이 직원의 업무 지시서와 규칙집에 반영되도록 요청합니다. "방금 고친 방식을 해당 직원의 지침에 반영해 줘"라고 시킵니다.

확인: 지침 파일이 갱신되고, 다음부터 같은 실수를 덜 합니다.

21. 처음부터 완벽하게 돌아가지 않으니 여러 번 고칠 각오를 합니다. 개발자나 AI 전문가가 보기에는 엉성해 보일 수 있어도, 비개발자에게는 폴더 하나에서 시작해 직접 키워 간다는 점이 중요합니다.

확인: 한 번 맡길 때마다 결과가 조금씩 나아집니다.

큰 구조로 키운 사례

폴더 하나에서 시작해 키운 구조의 예를 소개합니다. 한 직장인은 클로드와 ChatGPT 요금제 두 개에 제미나이 프로 요금제까지 AI 세 개를 직원으로 썼습니다. 그래도 같은 구조는 클로드 하나로도 만들 수 있습니다.

• 구조: 사용자가 의사결정자이고, 수석 비서실장 한 명(클로드)과만 대화합니다. 전략 기획 실장은 ChatGPT가 맡아 판단이 한쪽으로 쏠리지 않게 견제합니다.
• 직원: AI 직원 역할이 23개입니다. 팀은 다섯 개로, 비서실, 리서치, 콘텐츠 기획, 콘텐츠 제작, 기술⁠·수익입니다.
• 업무 흐름: 콘텐츠 후보를 요청하면 리서치 팀이 유튜브 API로 구독자 대비 조회수가 높은 영상을 분석하고, 사실 검증을 거쳐 결재함(승인 문서)에 올립니다. 이후 기획과 제작(음성, 자막, 모션 그래픽, 컷 편집)으로 이어지고, 사용자는 지시 한 번과 승인 두 번만 합니다.
• 지켜야 할 선: 잘된 영상은 주제와 구조만 참고하고 원고와 소스는 새로 만듭니다. 양산형 콘텐츠는 유튜브 정책에 어긋나고 가치도 없어서 일부러 만들지 않습니다.

이 정도 구조는 처음부터 만들 필요가 없습니다. 직원 세 명으로 시작해, 반복해서 막히는 일이 생길 때 직원과 규칙을 하나씩 더하는 순서가 안전합니다.

끝난 뒤 점검 목록

• 바탕화면에 만든 폴더가 클로드 코드의 작업 폴더로 선택돼 있습니다.
• 규칙집(CLAUDE.md)과 직원별 업무 지시서가 만들어졌습니다.
• 직원에게 일 하나를 맡겨 결과를 받았습니다.
• 권한 모드가 "묻고 진행"으로 되어 있습니다.