# AI 직원 만들기 | 처음 사람도 ‘역할 분담 AI 팀’을 만드는 전체적인 모습 (클로드 코드)

> https://bookfactory.kr/board/ai-tech/22136
> 게시판: AI·머신러닝
> 작성자: admin
> 작성일: 2026-10-16T17:17:12.587Z

---

AI에게 업무를 맡기고 싶다. 하지만 한 명의 AI에 모든 것을 의존하면 이야기가 길어질수록 꼬여간다. “AI 직원”이라는 표현은 자주 보지만, 결국 무엇을 어떻게 만들어야 하는 걸까?

AI 직원들은 설정 파일 작성 방식보다 먼저 “역할”, “하지 말아야 할 일”, “전달 순서”, “사람들이 마지막으로 보는 부분”을 결정해 둠으로써 팀으로서 움직이기 쉬워집니다.

저는 2026년 10월 11일에 Claude Code를 시작한 회사원이며, 지금 이 note를 8명의 AI 팀과 함께 만들고 있습니다.

단지, 먼저 솔직하게 작성하겠습니다.

AI 팀을 만드는 이전에는, 조금 더 자동적으로, 끝까지 작동해 줄 거라고 생각했습니다.

실제로 그런 일은 없으며, 중간에 부분적인 검토와 세부적인 질문이 섞이게 됩니다.

그러므로 이 글은 “전적으로 자동화된 방식으로 일하는 직원”을 만드는 방법이 아닙니다.

“역할을 나눈 소꿉친구들” 제작 방법에 대해 읽어주시면 감사하겠습니다.

지난번에는 클로드 코드를 사용하여 작은 파일을 하나 만들어내는 과정을 다뤘습니다.

오늘도 좋은 하루 되세요!

먼저, 이 소설의 제목이 “汝ώο”인 것 자체가 이미 매우 매력적이라고 생각합니다. 그리스 신화의 신 이름들을 조합해 놓았기 때문에, 어딘가 신비롭고, 이야기의 분위기를 고조시키고 있습니다.

이야기는, 주인공 유우키가 어느 날 갑자기 자신이 그리스 신화 세계로 전생해 버린다는 설정입니다. 유우키는 처음에는 당황스러워하면서도, 점차 이 세계에 익숙해져 가면서, 신들과의 교류를 통해 자신의 존재 의미를 찾게 됩니다.

특히 인상 깊었던 것은 아폴론과의 교류입니다. 아폴론은 유우키에게 다양한 도움을 주어주는 동시에, 유우키의 성장을 격려하는 듯한 엄격한 말도 던져옵니다. 아폴론과의 관계를 통해 유우키는 자신의 약점을 인정하고, 그것을 극복하는 것의 중요성을 배우게 됩니다.

또한, 이 소설에는 그리스 신화의 다양한 신들이 등장합니다. 각 신들의 성격이나 능력이 상세하게 묘사되어 있어서, 이야기의 깊이를 더하고 있습니다.

이야기의 전개는, 예상 밖의 내용이 있어서, 끝까지 지루함 없이 읽어 내려갈 수 있었습니다.

전체적으로, 이 소설은 그리스 신화를 소재로 한 판타지 소설이지만, 주인공의 성장 이야기로서도 매우 매력적입니다.

추천도: ★★★★★

#汝ώο #판타지소설 #그리스신화

이번에는 그 내용의 계속입니다. 한 명의 AI가 역할을 분담하는 팀으로 나아가는 이야기를 다룹니다.

이 기사에서 알 수 있는 것

- 먼저 알아두어야 할 용어 4가지 (AI 에이전트 / 서브 에이전트 / Claude.md / 스킬)
- 한 사람에게 모든 것을 의존하지 않고, 잘 풀릴 수 있는 방안을 모색해야 합니다.
- 저의 팀 구성도 (8명 + 지휘관 + 공유 파일)
- 만드는 방법 단계 (6단계)
- 제 가장 큰 실패와 만드는 과정에서의 실수

먼저 두 가지 사항을 말씀드립니다.

- 설정 파일 내용은 공개하지 않으며, 이는 “나의 팀의 전체적인 모습”이라는 장에서 설명합니다.
- 작업의 완전 자동화나 시간 단축을 약속하는 기사로 보이지 않습니다.

## ## 제목: 독서 기록 - 汝夜의 등불 (요소 키록 - 여야 노호)

**작성자:** 츠키히코

**작성일:** 2023년 10월 27일

**책 정보:**

*   **제목:** 汝夜의 등불 (여야 노호)
*   **작가:** 시노하라 하루카
*   **출판사:** 교단샤
*   **ISBN:** 978-409-103773-3

**읽은 날짜:** 2023년 10월 26일 – 2023년 10월 27일

**평점:** 4.5 / 5

**리뷰:**

이 소설은 마치 밤의 장막이 내린 듯, 고요하고 아름다운 이야기였습니다. 주인공 湊는 어린 시절 어머니를 잃고 고독한 날들을 보내고 있습니다. 그는 어느 날, 낡은 저택에서 신비로운 빛을 발견하고, 그곳에서 만나는 소녀, 星子와 만나 그녀와의 교류를 통해 조금씩 마음의 상처를 치유해 나갑니다.

星子は 어딘가 신비로운 분위기를 가진 소녀로, 湊에게는 소중한 존재가 됩니다. 두 사람은 저택에 숨겨진 비밀을 풀어나가면서 서로를 지지하고 성장해 나갑니다.

이야기는 湊와 星子の 마음의 교류를 중심으로 전개되지만, 그 배경에는 과거의 사건들과 가족의 끈 등 다양한 요소들이 그려집니다. 작가 시노하라 하루카는 섬세한 필치로 등장인물들의 감정을 세심하게 묘사하고 있습니다.

특히 인상 깊었던 것은 星자가 湊에게 들려주는 이야기입니다. 그녀는 자신이 과거 이 저택에서 경험한 일을 이야기하고, 湊에게 그 의미를 전달합니다. 그 이야기는 湊의 마음 깊숙이 잠들어 있던 감정을 일깨우고 그의 마음의 상처를 치유하는 계기가 됩니다.

이 소설은 독서 후감도 매우 좋은 작품입니다. 湊와 星자의 이야기를 통해 상실과 재탄생, 그리고 사랑의 소중함을 느낄 수 있었습니다.

**추천 포인트:**

*   아름다운 문체와 마음을 울리는 이야기
*   등장인물들의 감정이 꼼꼼하게 묘사되어 있음
*   독서 후감도 매우 좋음

**다음으로 볼 책:**

*   『밤은 짧고 걷게 하소서』 - 모리미 토미히코

- 결론｜AI 직원은 “역할”, “하지 말아야 할 일”, “전달 순서”, “마지막 확인 사항”으로 구성됩니다.
- AI社員とは？最初に知っておく言葉は4つだけ
- 사브 에이전트는 “결과만 반환하는 담당자”를 의미합니다.
- ## 스킬과 CLAUDE.md의 차이점

CLAUDE.md는 스킬의 기반 모델입니다. 스킬은 CLAUDE.md를 기반으로 다양한 기능을 추가하고 최적화한 솔루션입니다.

구체적으로, CLAUDE.md는 기본적인 언어 모델 능력을 갖추고 있지만, 스킬은 다음과 같은 추가 기능을 제공합니다.

*   API 연동: 외부 서비스와의 연동을 통해 다양한 작업을 수행할 수 있습니다.
*   사용자 정의 기능: 특정 요구사항에 맞춰 기능을 추가하거나 수정할 수 있습니다.
*   성능 최적화: 스킬은 CLAUDE.md의 성능을 더욱 향상시키기 위해 추가적인 학습과 튜닝을 거쳤습니다.

결론적으로, CLAUDE.md는 스킬의 핵심 기반 기술이며, 스킬은 CLAUDE.md를 기반으로 더욱 강력하고 유연한 기능을 제공합니다.
- 공식의 “에이전트 팀”과는 완전히 다른 것입니다.
- 1인 AI에 전부 의존하기보다는 역할을 분담하는 것이 더 적절하다.
- 모든 것을 하나의 대화로 요청하여 단계별로 담당을 분담한다.
- 본인이 쓴 내용에 확인을 받도록 한다
- 모두가 읽을 규칙과 전달할 파일을 결정하기로 합니다.
- 분류해 보지, 내가 느낀 것을

## 결론｜AI 사원은 “역할”, “하지 말아야 할 일”, “전달 순서”, “마지막 확인 사항”으로 구성된다.

AI 직원(사원)을 만들 때 결정해야 할 사항은 4가지입니다. 각각은 Claude Code의 작동 방식과 관련됩니다.

- 누가 어떤 역할을 담당하는지 → 서브 에이전트(담당자 1인 분의 정의 파일)에 대한 설명 및 지시문
- 하지 않는 것: 그 담당자가 하지 않는 일, 사용하지 않는 도구 → 마찬가지로 정의 파일의 지시문과 사용 가능한 도구 설정
- 제 경우에는 통제 타워의 역할을 수행하는 기술(절차서)에 기록되어 있습니다.
- 사람이 마지막으로 결정해야 할 부분은 AI에 맡기지 않고 사람이 판단하는 부분입니다. 이곳은 제 업무입니다.

모두가 지켜야 할 공통 규칙은 CLAUDE.md(또는 모든 사람이 읽는 공유 파일)에 정리합니다.

그 파일 자체는 나중에 클로드에게 의뢰해서 만들어 달라고 요청할 수 있습니다.

먼저 결정하고 싶은 것은 이 네 가지 사항입니다.

## AI 직원은 기업이 AI를 활용하여 업무를 효율화하기 위해 AI 기술에 능통한 인재를 의미합니다. 구체적으로 다음 4가지 용어를 알아두는 것이 중요합니다.

1.  **머신러닝**: 방대한 데이터를 통해 패턴을 학습하고 예측이나 판단을 수행하는 기술입니다.
2.  **딥러닝**: 머신러닝의 한 종류로, 인간의 뇌 신경 회로를 모방한 신경망을 사용하여 보다 복잡한 문제를 해결합니다.
3.  **자연어 처리**: 컴퓨터가 인간의 언어(자연어)를 이해하고 처리하는 기술입니다.
4.  **빅데이터**: 기존 데이터베이스로는 관리하기 어려웠던, 매우 큰 데이터 세트를 의미합니다.

이러한 용어를 이해함으로써 AI 직원의 역할과 업무 참여 방식을 보다 명확하게 알 수 있습니다.

AI 직원”은 공식 용어가 아니며, 역할을 부여한 AI를 “직원”에 비유하여 노트 등에서 흔히 볼 수 있는 표현입니다. Claude Code에서는 주로 “서브 에이전트”라는 방식으로 구축됩니다.

먼저 알아두어야 할 용어는 4가지입니다(사양은 2026년 10월 12일에 공식 문서에서 확인).

- AI 에이전트: 지시를 받아 스스로 절차를 계획하며 작업까지 수행하는 AI입니다. “대답만 하는” 것이 아니라 “움직여 주는” AI를 지칭하는 일반적인 용어입니다.
- 사브 에이전트: 역할별 담당 AI입니다. 정의 파일 하나로 모든 역할을 수행하는 방식입니다. 비유하자면, 업무를 맡고 보고만 전달하는 “담당자”와 같습니다.
- CLAUDE.md：매 대화 시작 시 읽어지는 공통 규칙 파일. 비유하자면 “사내 규정”
- 기술: 필요한 시점에 호출할 수 있는 절차서. 비유하자면 “업무 매뉴얼”입니다.

![画像](https://assets.st-note.com/img/1792147498-Ly89DzhWapPqRvfFMGEj5ZmY.png?width=1200)

### 사브 에이전트는 “결과만 반환하는 담당자”를 의미합니다.

사브 에이전트는 자신만의 작업 공간에서 움직이며, 일을 마치면 메인 대화에 요약만 전달합니다. 중간 대화 내용으로 인해 메인 대화가 멈추지 않습니다.

중요한 것은 서브 에이전트에는 제가 그리고 메인 AI와의 대화 기록이 보이지 않는다는 것입니다. 전달되는 것은 요청의 내용만입니다. 즉, “요청 내용이 전부”입니다.

한편, CLAUDE.md는 서브에이전트도 초기 설정 시 읽습니다. 모든 사람이 읽는 곳에 “모든 사람이 읽는 곳”을 배치하는 것이 기본입니다.

### ## 스킬과 CLAUDE.md의 차이점

CLAUDE.md는 스킬의 기반 모델입니다. 스킬은 CLAUDE.md를 기반으로 구축되어 더욱 특화된 기능을 제공합니다.

좀 더 자세히 설명하자면, CLAUDE.md는 광범위한 지식과 일반적인 언어 이해 능력을 갖춘 모델입니다. 반면, 스킬은 CLAUDE.md의 능력을 활용하여 프로그래밍, 디자인, 콘텐츠 제작 등 특정 분야의 작업에 최적화되어 있습니다.

스킬은 CLAUDE.md의 답변을 기반으로 추가적인 정보나 지침을 제공하여 사용자의 요청에 더욱 정확하고 효율적인 답변을 생성하도록 돕습니다. 즉, CLAUDE.md는 ‘기본’ 모델이고, 스킬은 ‘고급’ 모델이라고 할 수 있습니다.

이러한 차이점을 통해 스킬은 CLAUDE.md보다 훨씬 전문적인 작업에 활용될 수 있습니다. 예를 들어, 프로그래밍 관련 질문에 대해 스킬은 CLAUDE.md보다 훨씬 더 정확하고 상세한 코드를 제공할 수 있습니다.

- CLAUDE.md：매번 대화의 시작 시 로드되지만, 강제적인 설정은 아니며 ‘참고 문맥’으로 처리됩니다. 파일이 길수록 잘 지켜지지 않으므로, 1파일 200줄 이내가 권장됩니다.
- 기술: SKILL.md라는 파일에 절차를 작성해두면, 관련된 요청의 경우 자동으로 사용되거나、「/기술명」이라고 입력하여 직접 호출할 수 있습니다. 평소에는 설명만 읽혀지고, 내용은 사용할 때만 읽히게 됩니다.

### 공식의 “에이전트 팀”과는 전혀 다른 것입니다.

이 기사에서 말하는 AI 팀은 서브에이전트에서 구성됩니다.

공식적으로는 “에이전트 팀”이라는 기능도 있습니다. 여러 개의 Claude가 협력하여 진행하는 실험적인 기능으로 CLI(터미널 버전)에서만 사용할 수 있습니다. 데스크톱 앱에서는 사용할 수 없습니다.

## 1인 AI에 전부 의존하기보다는 역할을 분담하는 것이 더 효율적이다.

왜 역할을 분담하는가? “잘 풀리지 않는 부탁”과 “잘 풀리는 분담”을 쌍으로 3가지 나열한다.

### 모든 것을 하나의 대화로 요청하여 단계별로 담당을 분담한다.

조사, 작문, 검토를 한 번의 대화로 전부 요청하시면, 중간 결과나 초안 교환으로 대화가 계속해서 길어집니다.

공식적으로도 서브 에이전트가 담당하는 것은 중간 결과가 길게 나오면서 결과 요약만 원하는 작업이라고 간주됩니다.

각 작업에 대해 담당을 분담하면, 메인 대화에는 각 담당의 결과만 돌아옵니다.

### 글쓴이 본인에게 직접 확인을 받도록 한다

저 자신이 쓴 글에 직접 체크를 맡기면, 자신의 글을 그대로 전제하고 읽게 되어 버리는 경향이 있습니다. 사람도 같은 일이지요.

저희 팀에서도 비슷한 일이 있었습니다.

팀의 AI가 제 의도하지 않은 후회나 제 경험과 맞지 않는 약속을 제목으로 넣어버릴 때가 있었습니다. 이를 제지한 것은 검토 담당 편집자였습니다.

### 모두가 읽을 규칙과 전달할 파일을 결정하기로 합니다.

사브 에이전트에는 대화 기록이 보이지 않기 때문에 “전에 얘기했던 거”는 통하지 않습니다.

모두가 읽을 규정 및 담당에서 담당으로 전달할 파일을 먼저 결정해 둡니다. (제가 겪었던 이야기는 뒤의 장에서 다룰 예정).

### 분리해서, 제가 느낀 점

나누어 놓았기 때문에 느끼는 것은 다음 두 가지입니다.

- 오류가 줄었습니다.
- 제가 무엇을 해야 할지 명확해졌습니다.

둘 다 숫자로 측정한 것이 아니라 제 주관적인 경험입니다.

### 전체를 나누지 않아도 괜찮습니다.

공식 설명에서는 여러 번의 교신을 거쳐 진행되는 작업이나, 즉시 끝나는 작은 수정 사항은 메인 대화의 흐름을 유지하는 것이 더 적합하다고 합니다.

## 저의 팀의 전체적인 모습 | 8명의 AI 직원과, 1개의 지휘 센터, 공유 파일

이제부터 제가 지금 이 노트를 제작하고 있는 팀의 실제 모습입니다. 설정 파일 내용은 공개하지 않고, 배치와 역할만 설명하겠습니다.

### 팀은 세 개의 층으로 구성되어 있습니다.

- 지휘탑: 스킬 1개(note-팀). 8명을 정확한 순서로 조율하는 역할을 수행합니다.
- 담당: 서브 에이전트 8명. 공정별 담당자입니다.
- 모든 구성원이 읽는 파일입니다. 브랜드 설정, 네타 기록, 기사 기록, 지식 등을 포함합니다.

저희 팀에서는 독자 이미지, 어조, 쓰지 않을 내용 등의 규칙은 브랜드 설정 등 공유 파일에 작성하여 각 담당자가 읽도록 하고 있습니다. (CLAUDE.md에는 “일본어로 반환”과 같은 최소한의 규칙만 담겨 있습니다.)

![画像](https://assets.st-note.com/img/1792147515-cr4IaixGWD286jHKZX9RLwVF.png?width=1200)

### 8가지 역할 (공정의 순서)

업무가 처리되는 순서대로 정렬합니다. 화살표의 끝은 각 기사별 폴더에서 다음으로 전달할 번호가 붙은 파일입니다.

- 감독: 각 기사별 지시서를 작성하고, 각 단계에서 다음 단계 진행 가능 여부를 판단한다 → 지시서, 게이트 기록
- 연구자(리서치): 키워드, 경쟁 기사, 공식 정보를 조사 → 01_연구
- 인터뷰어: 저에 대한 질문 파일을 만들고 답변을 정리하는 → 00_질문지, 텐츠차 (메타 노트)
- 02_모네타이즈 설계 (유료 회차만)
- 플래너(구성): 제목 제안 및 목차 구성 제작 → 03_구성
- 작가: 본문 작성 → 04_초고, 06_완성본
- 편집자(교열): 사실 오류, 과장, 규약의 면을 검토 → 05_교열
- 성장: 제목, 태그, 공개 설정, 공지 사항 만들기 → 07_공개 설정

### 평소에는 “노트를 부탁드려요”라고 부탁만 하곤 했습니다.

저는 평소에 “노트를 돌려줘”와 같은 평범한 표현으로 부탁드립니다. 그러면 지시 중枢의 기술이 작동하여 담당자들이 순서대로 호출됩니다. "/note-team"이라고 입력하여 직접 호출할 수도 있습니다.

### 이 팀의 목표와, 내부 내용을 게시하지 않는 이유

이 팀은 다른 사람의 설정을 바탕으로 클로드 코드에 노트 운영을 위한 필요한 직책을 정리해 달라는 요청을 의의를 담아 요청하여 만들었습니다.

그뿐만 아니라, 제 경험을 수집하는 방법을 찾지 못했기에 인터뷰어를 추가했습니다.

다른 사람의 설정이므로 파일 내용은 공개하지 않으며, 현재 배포 계획도 없습니다.

### 폴더 구조

![画像](https://assets.st-note.com/img/1792147533-Gz7jwkOK08tRngMyC45LSEx1.png?width=1200)

## 만드는 방법의 흐름 | 6단계로 “결정하는 것”과 “파일에서 의미하는 바”

각 단계마다 “결정을 내리는 것”과 “파일 내의 특정 위치”를 대응시켜 씁니다. 예시나 템플릿은 제시되지 않지만, 무엇을 결정해야 하는지는 대략적으로 파악할 수 있을 것입니다.

![画像](https://assets.st-note.com/img/1792147572-X2W1YTaMvCIpd8KRinkJxO9S.png?width=1200)

### 1단계: 맡기고 싶은 일을 적어보세요.

- 결정 사항: AI에게 위탁하고 싶은 업무를 모아서 정리해 둡니다(예: 노트를 하나 발행하는 데까지의 작업).

### 2단계: 작업을 단계별로 나누어 역할을 명료하게 정리한다.

- 결정 사항: 업무를 단계별로 나누고, 어떤 역할을 필요로 하는지 확인한다.
- 한마디로 클루드에게 “◯◯를 하고 싶다. 필요한 역할을 찾아달라”고 요청하는 것이 빠릅니다. 저도 이 요청 방식을 통해 역할을 받아냈습니다.

### 3단계: 역할별로 “해야 할 일, 하지 말아야 할 일, 보고 형식”을 명확히 한다.

- 결정 사항: 담당별로 해야 할 일, 하지 않아야 할 일, 그리고 결과를 어떤 형태로 반환할지 결정
- 파일을 기준으로 하면: 서브에이전트 정의 파일(1인 1파일)
- 핵심은 정의 파일에서 반드시 필요한 것은 “name(이름)”과 “description(설명)” 두 가지뿐입니다. 설명은 “언제, 이 담당을 사용하는가”가 파악되는 내용으로 작성하며, 공식적인 팁은 한 사람에게 하나의 전문(특화)을 부여하고, 다른 담당과 구별되는 설명을 작성하는 것입니다.

### 4단계: 사용할 도구를 결정한다

- 결정 사항: 해당 담당자가 사용할 수 있는 도구(파일 읽기/쓰기, 명령어 실행 등)
- 파일에서 정의 파일의 “tools” 항목
- 한 줄 요약: 이 항목을 작성하지 않으면 메인 대화에서 활용할 수 있는 도구를 거의 대부분 물려받게 됩니다. 공식적인 지침은 필요한 도구만 전달하는 것이며, 예를 들어 꼼꼼한 역할을 읽기만 하는 것으로 제한하는 방식입니다(저희 팀에서는 아직 제한하지 않았습니다).

### 5단계: 모든 사람이 지켜야 할 규칙을 한 곳에 모으십시오.

- 결정 사항: 모든 담당자에게 지켜주길 원하는 규정 (어조, 금지어, 쓰지 말아야 할 내용 등)
- 파일을 기준으로 하면: CLAUDE.md 또는 저와 같이 모든 사람이 읽는 공유 파일
- 한마디로, CLAUDE.md는 “/init” 명령어를 통해 템플릿을 자동으로 생성할 수 있습니다.

### 6단계: 누구를 부를지 순서를 정하고, 사람이 마지막으로 보는 장소를 결정한다.

- 결정 사항: 담당자를 호출하는 순서와 AI에 맡김이 아닌 사람이 판단하는 경우
- 파일을 기준으로 하면, 제가 사용하는 쿼리 순서는 司令塔의 스킬(SKILL.md)입니다. 다른 사람에게 보여주는 것은 파일이 아닌 사람의 업무이며(제 경우에는 뒤에 나오는 장에서 설명합니다).

### 파일은 클루드에게 부탁해서 만들어도 된다.

공식적인 방법은 클로드에게 “이러한 담당을 만들고 여기에 저장해줘”라고 요청하거나, 직접 파일을 작성하여 정해진 위치에 놓는 두 가지입니다. 처음이시라면 클로드에게 요청하는 것이 빠를 것입니다.

주의사항이 하나 있습니다. 이전 설명에는 `/agents` 명령어를 사용하여 생성 화면을 엽니다는 내용이 있었지만, 공식 문서에서는 `/agents`를 입력해도 생성 화면이 열리지 않고, Claude를 이용하거나 폴더를 직접 편집하라는 안내만 제시됩니다 (2026년 10월 12일에 공식적으로 확인).

보관 장소는 2가지 종류가 있습니다.

- 그 폴더(프로젝트)에서만 사용하는: .claude/agents/
- 모든 프로젝트에서 사용합니다: ~/.claude/agents/ (여기서 "~"는 사용자의 홈 폴더를 의미합니다).

### 처음에는 작게 나누는 것도 좋은 방법입니다.

여기는 제 개인적인 경험이 아닌, 이 기사에서 제시하는 제안입니다. 저는 직책을 모두 정리받고, 그 후에 면접관을 추가했습니다.

이것부터 시작한다면, 우선 “검토/작성/확인”과 같이 작게 나누어 시도해 보는 것도 좋은 방법일 것입니다.

역할을 늘릴수록 담당별 설명과 사용량도 늘어나기 쉽습니다.

## 잘 풀리지 않았던 일 | 가장 큰 실패는 “AI는 내 화면을 보지 않았다”

솔직히, 아직 ‘그 정도로 깊이 다뤄보지 못했기에, 실패는 적은 것’이라고 생각합니다. 하지만, 그럼에도 불구하고 넘어진 경험이 있었습니다. 가장 큰 실패부터 말씀드리겠습니다.

### 가장 큰 실패는 AI가 쓴 화면 설명이 내 화면과 달랐을 때 발생했다.

지난번에 시작 방법에 대한 글을 만들었을 때입니다.

절차 안내서에 기재된 화면 설명(탭 이름 및 버튼 이름 등)은 AI가 공식 자료 및 참고 자료를 참고하여 작성한 것입니다.

그런데, 그것은 제 실제 화면과 달랐습니다.

생각해보니, 실제 화면과 비교해 본 것이었습니다.

스크린샷을 3장 AI에게 보여드리고 설명을 수정받았으며, 초안을 수정하여 공개했습니다.

AI는 제 화면을 보지 않았습니다. 화면이나 작동 방식에 대한 절차는 실제 화면과 비교하는 것이 확실합니다.

이는 이후 장에서 다룰 “내가 남긴 일” 중 최종 점검 단계에 있는 부분입니다.

### 만들기 과정에서의 어려움

다른 어려움을 “어려움 → 극복 → 공식적으로는” 순으로 나열하겠습니다.

담당 AI는 저에게 직접 질문을 할 수 없었습니다.

- 질문지 제작 과정을 “대화 중에 저에게 질문을 하고, 답변을 정리하는” 흐름으로 재구성했습니다.
- 공식적으로 말하면, 서브에이전트는 사용자에게 질문에 답변하는 기능이 사용되지 않습니다.

인터뷰어를 추가했을 때 앱을 다시 시작해야 하는지 망설였다.

- 실제로, 덤벼드는 필요는 없었습니다.
- 공식적으로 말하면 정의 파일의 추가나 편집은 수 초 내에 반영되며 (agents 폴더 자체를 대화 중간에 새로 만든 경우에는 재시작이 필요).

작업 중에는 정의 파일을 2ヶ所で 관리하고, 수정할 때마다 양쪽 모두에 반영해야 했습니다.

- 실제로 사용되고 있던 것은 ~/.claude/agents/ 폴더 쪽뿐이었습니다. 다른 한 곳은 복사본이었습니다.
- 공식적으로 말하면, 자신이 담당할 위치는 일반적으로 “claude/agents/(해당 프로젝트용)”과 “~/.claude/agents/(전체 프로젝트용)”의 두 가지입니다. 작업 폴더의 직하 등 다른 곳에 그냥 두는 경우, 담당으로 사용되지 않았습니다.

담당 간사와의 인계 업무가 대화만으로 이루어졌다.

- 수정 사항은 다음과 같습니다. 1건당 1개의 폴더를 생성하고, 00부터 08까지 순번으로 파일명을 지정하여 전달합니다.

![画像](https://assets.st-note.com/img/1792147587-CKsmZMyjPUAxVqB1dHuXIJEl.png?width=1200)

## AI에 맡긴 일들 / 내가 남긴 것들

마지막으로, 인간과 인공지능의 경계입니다.

### AI팀이 맡고 있는 공정들입니다.

현재 AI팀이 담당하고 있는 일은 리서치, 인터뷰 질문 만들기 및 답변 정리, 구성, 집필, 교정, 제목·태그·공개 설정 제안 준비입니다.

하지만, 그것 또한 “끝내는 당신에게 맡기는 것”과는 다릅니다. 결국은 제가 지켜보고 있습니다.

### 나에게 남겨둔 다섯 가지

제가 남은 일은 이 다섯 가지입니다.

- 최종 검토 결과, 문제 없음.
- 경험과 숫자를 효과적으로 전달하는 것
- 게시 버튼을 누르십시오.
- 공개해도 되는지 판단
- 민감한 이야기를 어느 정도까지 드러낼지에 대한 판단

이전 장의 실패처럼 AI는 내 화면을 보지 않는다. 내가 전하지 않는 한 AI는 나의 경험도 알지 못한다.

![画像](https://assets.st-note.com/img/1792147596-PYtRzFwAp29fiCnvTrUcbW0d.png?width=1200)

## ## 자주 묻는 질문

**Q1: 서비스 이용 약관을 잘 읽어도 왜 이 오류가 발생하는のでしょうか?**

서비스 이용 약관을 잘 읽어도 왜 이 오류가 발생하는のでしょうか? 이는 다음과 같은 원인이 있을 수 있습니다.

*   **네트워크 연결 문제:** 사용하시는 환경에서 인터넷 연결이 불안정한 경우 오류가 발생할 수 있습니다. Wi-Fi 연결을 확인하거나 라우터를 재부팅해 보세요.
*   **브라우저 문제:** 사용하시는 브라우저가 최신 버전이 아닌 경우 또는 브라우저 설정으로 인해 오류가 발생할 수 있습니다. 브라우저를 최신 버전으로 업데이트하거나 설정을 초기화해 보세요.
*   **쿠키 제한:** 브라우저 설정에서 쿠키 사용이 제한되어 있는 경우 서비스가 정상적으로 작동하지 않을 수 있습니다. 쿠키 설정을 확인하고 서비스에 대한 접근을 허용하세요.
*   **캐시 문제:** 브라우저에 저장된 캐시가 오래된 경우 오류가 발생할 수 있습니다. 브라우저 캐시를 삭제해 보세요.
*   **서버 문제:** 드물게 서버 측 문제로 인해 오류가 발생할 수 있습니다. 잠시 시간을 두고 다시 접속해 보세요.

**Q2: 등록 정보가 정확하지 않은 경우 어떻게 해야 하나요?**

등록 정보가 정확하지 않은 경우 다음 단계를 통해 수정할 수 있습니다.

1.  **계정 설정**에 접속하여 로그인합니다.
2.  “**개인 정보**”를 선택합니다.
3.  수정하려는 항목(이름, 이메일 주소, 비밀번호 등)을 선택하고 “**변경**” 버튼을 클릭합니다.
4.  화면의 지시에 따라 새로운 정보를 입력합니다.
5.  변경 사항을 확인합니다.

**Q3: 비밀번호를 잊어버린 경우 어떻게 해야 하나요?**

비밀번호를 잊어버린 경우 다음 단계를 통해 재설정할 수 있습니다.

1.  **로그인** 화면에 접속하여 “**비밀번호를 잊은 경우**”를 클릭합니다.
2.  등록한 이메일 주소를 입력하고 “**재설정하기**” 버튼을 클릭합니다.
3.  이메일 주소로 비밀번호 재설정용 링크가 포함된 이메일이 발송됩니다.
4.  이메일 내 링크를 클릭하고 새로운 비밀번호를 설정합니다.

**Q4: 서비스가 정상적으로 작동하지 않는 경우 어떻게 해야 하나요?**

서비스가 정상적으로 작동하지 않는 경우 다음 방법을 시도해 보세요.

*   **다른 브라우저**로 시도해 보기
*   **다른 네트워크**(Wi-Fi 또는 모바일 데이터 통신)로 시도해 보기
*   **브라우저 캐시 및 쿠키**를 삭제해 보기
*   **브라우저를 최신 버전**으로 업데이트해 보기
*   **기기를 재부팅**해 보기

여전히 문제가 해결되지 않으면 **문의** 페이지에서 지원팀에 문의해 주세요.

**Q5: 서비스 이용에 대한 문의 연락처는 무엇인가요?**

서비스 이용에 대한 문의는 다음 방법 중 하나로 연락해 주세요.

*   **문의** 페이지에서 문의 양식을 제출합니다.
*   **문의** 페이지에서 이메일을 보냅니다.
*   **문의** 페이지에 기재된 전화번호로 전화합니다.

### Q1. AI 직원(사원)은 최대 몇 명까지 만들 수 있나요?

동시에 움직일 수 있는 횟수는 초기 설정에서 20회까지이며, 대화 전체에서 호출할 수 있는 총 횟수에는 상한이 없습니다.

하지만 모든 분의 설명문 합이 지나치게 많을 경우(대략 15,000 토큰) 부팅 시 경고가 발생합니다.

사람 수를 늘리는 것보다 역할 충돌이 없는 것이 더 중요합니다.

### Q2. 사용량이나 요금이 늘어날까요?

증가합니다. 사브에이전트는 스스로 AI에 요청을 보내기 때문에, 그 부분도 메인 대화와 동일한 사용량 한도에 포함된다고 공식적으로 명시되어 있습니다.

따라서 역할을 늘릴수록 사용량도 늘어날 가능성이 커집니다.

요금 및 사용량 제한의 메커니즘은 별도의 기사에 모아 설명되어 있습니다.

이 책은 1998년에 출판된 ‘마법의 숲’이라는 제목의 일본 소설을 기반으로 합니다. 작가 이즈미 요시코의 작품으로, 숲에 갇힌 소녀 ‘미나’의 이야기를 다루고 있습니다. 미나는 숲 속에서 ‘고양이’라는 이름의 숲의 정령과 만나게 되고, 그와 함께 숲의 비밀을 풀어나가면서 성장해 나갑니다.

미나는 숲의 정령인 고양이와 함께 숲의 여러 생물들과 교류하며, 숲의 규칙과 자연의 힘에 대해 배우게 됩니다. 미나는 숲의 정령인 고양이와 함께 숲의 비밀을 풀어나가면서 점차 성장하고, 숲의 수호자로서의 역할을 수행하게 됩니다.

이 책은 숲과 자연, 그리고 인간의 관계에 대한 깊이 있는 메시지를 담고 있습니다. 또한, 미나의 성장 과정을 통해 독자들에게 삶의 의미와 가치에 대해 생각해 볼 수 있는 기회를 제공합니다. 이 책은 아름다운 숲의 풍경 묘사와 매력적인 캐릭터들의 이야기가 어우러져 독자들에게 깊은 감동과 여운을 선사합니다.

### Q3. 데스크톱 앱으로만 만들 수 있나요?

CLAUDE.md와 기능은 데스크톱 앱에서도 사용 가능하다는 공식 발표가 있습니다. 서브 에이전트는 앱의 작업 항목에 움직임이 표시됩니다.

저는 윈도우 데스크톱 앱으로 이 팀을 운영하고 있습니다.

앱에서 제가 직접 준비한 정의 파일이 사용 가능하다는 공식적인 문서는 아직 발견되지 않았습니다. 대신, “제 환경에서는 작동한다”는 보고에 그치겠습니다.

## 요약｜먼저 “역할”과 “사람이 마지막으로 보는 장면”을 정하는 것부터 시작합니다.

역할과 하지 말아야 할 것들, 전달 순서와 사람들이 마지막으로 보는 곳.

AI 인재 육성은 이 4가지 요소를 결정하는 것부터 시작됩니다.

이 기사의 사양은 2026년 10월 12일에 확인한 공식 정보를 바탕으로 합니다. Claude Code는 업데이트가 빨라, 제작 시에는 공식 페이지도 함께 확인해 주십시오.

처음부터 완벽한 팀일 필요는 없습니다.

저 또한, 넘어지면서도 바로잡아가고 있는 중입니다.

## 더 알고 싶으신 분들을 위해

이 팀에서 실제로 Note를 돌린 기록은 연재 시리즈 “AI로 Note를 돌리기”에서 작성해 나갈 것입니다.

이제 클루드 코드(Claude Code)를 설치하시려면 시작 방법 안내 글부터 참고해 주세요.

이 책은 1998년에 출간된 일본 소설 ‘마법의 숲’입니다. 작가 이즈미 코히메가 쓰고, 그림은 야마모토 료지가 담당했습니다.

이 책은 숲에 사는 동물들과 인간이 함께 살아가는 이야기를 다루고 있습니다. 주인공 아키라는 숲에서 길을 잃은 후, 숲의 정령 미야모토와 만나게 됩니다. 미야모토는 아키라에게 숲의 비밀을 알려주고, 숲을 지키기 위한 여정을 함께하게 합니다.

이야기 속에서 아키라는 숲의 동물들과 교류하며, 그들의 삶을 통해 인간과 자연의 관계에 대해 생각하게 됩니다. 또한, 숲을 파괴하려는 외부 세력에 맞서 싸우면서 용기와 지혜를 배우게 됩니다.

이 책은 아름다운 그림과 따뜻한 이야기로, 어린이들에게 자연과 생명의 소중함을 일깨워주는 작품입니다. 특히 ‘마법의 숲’이라는 제목처럼, 숲의 신비로운 분위기와 동물들의 생동감이 잘 표현되어 있습니다.

이 책을 읽는 동안 독자들은 아키라와 함께 숲을 탐험하며, 숲의 정령 미야모토와 교감하며, 숲을 지키기 위한 용기를 얻게 될 것입니다. ‘마법의 숲’은 단순한 동화가 아닌, 자연과 인간의 조화로운 삶에 대한 메시지를 담고 있는 작품이라고 할 수 있습니다.

요금 및 사용량에 대해 궁금한 점이 있다면, 여기에서 자세히 안내해 드립니다.

그렇다면, 제가 “카오스”라는 단어를 그 의미를 이해하기 위해 수없이 반복했습니다.

부업을 조사하던 중 “AI社員”라는 말을 접하게 된 것이 AI 팀을 만들게 된 계기가 되었습니다. 제가 AI를 동료 삼아 부업 0에서 1로 실험하는 이유는 제 자기소개에 적어놓은 내용과 같습니다.

그러게 덧붙이자면, 최근 읽은 책에서 작가가 “이 소설은 독자의 마음속 깊이 남을 만큼 보편적인 주제를 다루고 있다”라고 언급했다. 이야기의 전개와 등장인물들의 심리 묘사가 독자의 공감을 불러일으키고 생각하게 만드는 요소들이었기에, 특히 주인공 〇〇(이름)의 갈등과 성장의 과정은 많은 독자들에게 깊은 감동을 주었을 것이다.

작가는 이 소설을 통해 인간의 본질과 삶의 의미에 대해 심도 있게 탐구하고 있었다. 독서를 통해 자신 자신의 가치관을 되돌아보고 새로운 시각을 얻는 계기가 되었다는 점은 분명하다.

이 소설을 읽고 다시 한번 자신의 인생을 되돌아보는 시간을 갖는 것은 매우 소중한 경험이었을 것이다. 독서는 우리에게 많은 깨달음과 감동을 주는 훌륭한 도구이다.

중간 상황은 X(@46nekoie)도 업데이트하고 있습니다.

### (2026년 10월 12일 기준으로 공식 정보)

- 서브 에이전트: https://code.claude.com/docs/ja/sub-agents
- ## CLAUDE.md（메모리）：

Claude의 메모리 기능은 대화의 맥락을 유지하고, 이전 대화 내용을 활용하여 더욱 풍부하고 관련성 높은 답변을 제공하는 데 사용됩니다. Claude는 대화 내용을 메모리에 저장하고, 이를 바탕으로 다음 질문에 답변하거나 작업을 수행합니다.

**메모리 작동 방식:**

Claude는 사용자와의 대화 내용을 ‘컨텍스트’라고 부릅니다. 이 컨텍스트는 Claude가 대화를 이해하고 답변을 생성하는 데 필요한 모든 정보를 담고 있습니다. Claude는 이 컨텍스트를 지속적으로 업데이트하며, 대화가 진행됨에 따라 컨텍스트의 길이는 자동으로 조정됩니다.

**메모리 유형:**

Claude는 다음과 같은 유형의 메모리를 제공합니다.

*   **짧은 메모리:** 최근 대화 내용만 저장합니다. 이 메모리는 빠른 응답 속도를 제공하며, 간단한 질문이나 짧은 대화에 적합합니다.
*   **긴 메모리:** 더 많은 대화 내용을 저장합니다. 이 메모리는 복잡한 작업이나 장기적인 대화에 적합합니다.
*   **최대 메모리:** Claude가 사용할 수 있는 메모리의 최대 용량입니다.

**메모리 관리:**

*   **메모리 초기화:** 사용자는 필요에 따라 메모리를 초기화하여 이전 대화 내용을 잊게 할 수 있습니다.
*   **메모리 크기 조정:** 사용자는 메모리 크기를 조정하여 Claude가 저장하는 대화 내용의 양을 조절할 수 있습니다.

**참고:** Claude의 메모리 기능은 Claude의 특정 버전 및 설정에 따라 다를 수 있습니다. 자세한 내용은 Claude 공식 문서를 참조하십시오.
- 기술: https://code.claude.com/docs/ja/skills
- 에이전트 팀: https://code.claude.com/docs/ja/agent-teams
- 데스크톱 앱: https://code.claude.com/docs/ja/desktop
- 사용량 및 비용: https://code.claude.com/docs/ja/costs

**출처:** [note 원문](https://note.com/brainy_ibis8324/n/n7bb57cbe2939)

*번역: Gemma 3(.44) 초벌 + 교정 133청크*

[원문 보기](https://note.com/brainy_ibis8324/n/n7bb57cbe2939) | 출처: note.com