AI 실전 활용

반복 업무 나눠 맡길 AI 팀 만들기｜Claude Code 사무실·직원 역할 설정

최종 확인 2026-09-24

상품을 찾고, 수익을 계산하고, 릴스 대본까지 혼자 만들다 보면 정작 촬영은 시작도 못 할 때가 있습니다. Claude Code에 일을 나눠 맡기는 사무실을 만들면 대본·촬영표·검수 문서를 한 흐름으로 관리할 수 있습니다. 이번에는 가상의 쇼핑 릴스 회사를 만들어 실제로 대본과 손익표가 나오는지 시험했습니다.

이 글은 Mac에서 설치한 Agents Office 3.2.1-beta.2 기준입니다. Claude 계정 로그인으로 실행했고 별도 Anthropic API 키는 사용하지 않았습니다. 완성한 범위는 로컬 사무실과 제작 문서입니다. 영상 렌더링·게시·판매는 별도 단계입니다.

먼저 답부터: API 없이 가능한가요?

이번 구성은 로그인한 Claude Code CLI를 호출하는 방식으로 작동했습니다. Claude 웹사이트만 열어 둔 것과는 다릅니다. 터미널에서 Claude Code가 실행되고 해당 환경에서 로그인이 되어 있어야 합니다. 사용량은 해당 계정의 한도에 영향을 주므로, 별도 API 청구가 없다는 말을 무제한 무료로 이해하면 안 됩니다.

처음에는 상품 하나와 작은 업무로 시험하세요. 팀 실행은 업무 분배, 담당자 작업, 결과 취합에 여러 번 모델을 호출합니다. 간단한 계산 한 번까지 모두 팀으로 돌릴 필요는 없습니다.

1. 어떤 사무실을 만들 것인지 정하기

예시는 ‘쇼핑 릴스 스튜디오’입니다. 책상 위 케이블 정리 클립을 소개하는 20초 릴스를 준비합니다. 직접 상품을 판매하는 경우와 제휴 링크로 수수료를 받는 경우는 수익 구조가 달라 따로 계산합니다.

이름보다 중요한 것은 산출물입니다. ‘마케팅을 잘해줘’ 대신 ‘20초 대본 1개와 5컷 촬영표를 만들어줘’처럼 끝나는 기준을 정하세요. 첫 시험에서 이름과 역할을 지정한 핵심 담당자는 10명이며, 프로그램의 기본 35개 좌석 자체를 줄인 것은 아닙니다.

2. 설치 전 준비: 터미널에서 세 가지 확인

Mac의 터미널을 열고 다음 명령을 하나씩 실행합니다. Node.js는 20 이상, Git과 Claude Code가 필요합니다. 버전 대신 command not found가 나오면 그 항목부터 설치하세요. Node.js 공식 사이트, Git 설치 안내, Claude Code 설치 안내를 이용합니다.

node --version
git --version
claude --version

Claude Code를 설치했다면 같은 터미널에서 로그인 상태를 확인합니다. 로그인되지 않았다면 브라우저 인증을 완료한 다음 다시 확인하세요.

claude auth login
claude auth status

앱에 로그인해도 다른 터미널이나 다른 사용자 환경에 인증이 연결되지 않을 수 있습니다. 실제 사무실을 실행할 터미널에서 확인하는 것이 가장 확실합니다.

3. 프로그램 받기와 실행

작업할 폴더에서 아래 순서로 진행합니다. 이미 같은 폴더에 설치했다면 다시 복제하지 말고 기존 폴더로 이동하세요. 설치 명령은 Agents Office 원본 저장소에서 버전 변경 여부를 함께 확인할 수 있습니다.

git clone https://github.com/ajsahni/agents-office.git
cd agents-office
npm install
node build.mjs
npm start

브라우저 주소창에 http://localhost:4520/을 입력합니다. localhost는 설치한 컴퓨터 자신을 뜻합니다. 다른 휴대폰에서 같은 주소를 열어도 이 사무실에 연결되지 않습니다.

HTML 파일을 더블클릭해 열지 마세요. 서버 없이 보이는 데모 화면과 실제 Claude 연결은 다릅니다. 오른쪽의 LIVE · CLAUDE 표시를 확인한 뒤 작은 작업을 넣고 결과까지 받아야 실행 확인이 됩니다. 종료할 때는 서버를 실행한 터미널에서 Control+C를 누릅니다.

4. 예제 회사 대신 내 회사의 업무 자료 넣기

프로젝트 안에 shopping-brain 폴더를 만들고 세 파일부터 준비합니다. AI에게 매번 긴 설명을 보내는 대신 공통 기준을 파일로 보관하는 것입니다.

제품 자료는 다음처럼 씁니다. 테스트 숫자를 실제 견적과 섞지 않는 것이 핵심입니다.

# TEST-001 케이블 정리 클립
가상 테스트 상품. 실제 견적이나 판매 실적이 아니다.
기능 가정: 책상 위 케이블 끝을 한곳에 둔다.
미확인: 접착력, 재사용성, 소재, 내구성.
판매가 12,900원 / 원가 4,000원 / 포장 500원
배송 3,000원 / 수수료 6% / 반품충당 3%
주문당 광고비 1,500원
산출물: 손익표, 20초 대본, 5컷 촬영표, 검수표.

프로젝트 최상위의 office.config.local.json에 회사 이름과 자료 폴더를 지정합니다. 아래 예시는 첫 시험에서 웹·브라우저·외부 커넥터 없이 제공한 자료만 처리하도록 구성한 값입니다.

{
  "name": "쇼핑 릴스 스튜디오",
  "brain": "./shopping-brain",
  "mcp": {
    "allow": ["local-office-no-connectors"],
    "deny": [],
    "departments": {}
  },
  "tools": { "web": false, "browser": false },
  "teams": { "enabled": true, "max": 2 }
}

여기서 allow에 넣은 문자열은 실제 연결된 서버 이름과 일치하지 않게 정한 테스트 값입니다. 빈 배열은 모두 차단이 아니라 연결된 서버 허용을 뜻하므로 빈 배열로 바꾸지 마세요. 이후 조사·게시 도구가 필요해지면 허용할 서버를 개별 검토해 연결합니다.

설정을 바꾼 뒤에는 서버를 종료하고 다시 시작합니다. 자료 파일과 업무 기록에는 개인정보나 비밀번호를 넣지 않습니다.

5. 직원에게 직함보다 명확한 역할 주기

office.agents.local.json은 기본 좌석의 이름과 역할을 바꾸는 파일입니다. 아래는 대본 작가와 검수자만 지정하는 최소 예시입니다. 다른 직원도 같은 방식으로 배열에 추가할 수 있지만, id는 실제 존재하는 좌석을 사용해야 합니다.

{
  "agents": [
    {
      "id": "newt",
      "name": "카피",
      "role": "릴스 대본 작가",
      "does": "20초 대본과 자막을 작성",
      "tools": [],
      "brief": "한국어. 구체적인 불편으로 시작. 가짜 후기나 확인 안 된 성능을 쓰지 않는다. 대본은 1개만 작성."
    },
    {
      "id": "qa",
      "name": "체크",
      "role": "발행 전 검수자",
      "does": "주장과 광고 표시, 권리를 점검",
      "tools": [],
      "brief": "한국어. 통과/수정 필요/확인 필요로 나누고 수정문을 제시. 외부 게시 승인은 대표에게 받는다."
    }
  ]
}

이 테스트에서 사용한 주요 좌석은 콘텐츠 총괄 mlead, 작가 newt, 영상 기획 vid, 손익 alead, 검수 qa입니다. 도구 이름을 적는 것만으로 영상 생성기나 쇼핑몰이 연결되지는 않습니다.

5-1. 실제 운영용으로 확장하기: 6개 부서와 35개 역할

작은 시험을 마친 뒤에는 기존 좌석을 아래처럼 나눌 수 있습니다. 이번 로컬 구성도 6개 공간의 35개 역할을 바꾸었습니다. 처음부터 35명을 동시에 실행할 필요는 없습니다. 상품 하나를 골라 발굴→소싱→제작→검수 순서로 필요한 담당자만 호출하세요.

파일에서 바꾸는 것은 직원의 이름과 직무입니다. 기본 부서 키와 좌석 id는 유지합니다. 화면에 표시되는 부서 제목까지 바꾸려면 이 설치본의 src/data.js에 있는 DEPTS 표시명을 수정하고 다시 빌드해야 합니다. 좌석을 추가하거나 id를 새로 만드는 작업과는 다릅니다.

① 각 역할은 이 다섯 가지를 정하세요

1. 입력: 무엇을 보고 일할지. 상품 URL, 비교표, 실제 성과 CSV처럼 구체적으로 지정합니다.
2. 해야 할 일: ‘좋은 제품 찾기’보다 ‘저가 대안·다른 브랜드와 비교하기’로 씁니다.
3. 산출물: 표 1개, 대본 1개, 수정 티켓 1개처럼 끝을 정합니다.
4. 보류 조건: 상품 모델이나 영상 사용권이 없으면 추천·제작을 멈추게 합니다.
5. 다음 담당: 누구에게 무엇을 넘길지 적습니다. 문서에 이름을 쓰는 것만으로 자동 전달이 구현되는 것은 아닙니다.

② 직원 설정 예시를 기존 배열에 추가하기

아래 객체를 agents 배열에 추가합니다. 기존 elead 항목이 있다면 중복 추가하지 말고 해당 항목을 고칩니다. JSON의 쉼표와 따옴표를 확인하세요.

{
  "id": "elead",
  "name": "발굴장",
  "role": "상품 발굴 총괄",
  "does": "생활 불편을 해결할 상품을 비교하고 소싱팀에 검토서를 전달",
  "tools": [],
  "brief": "한국어. 독립 제품 3개와 비구매 대안을 비교한다. 정확한 모델·옵션·배송 포함 가격·반복 불만·출처·확인일을 표로 작성한다. 근거가 없으면 선정보류. 끝에 소싱팀이 확인할 항목을 적는다."
}

다른 담당자도 같은 방식입니다. 예를 들어 gfx는 썸네일·자막 위계, vid는 초별 편집표, report는 실제 성과 분석, qa는 게시 전 확인을 맡깁니다. 비밀번호나 인증 토큰은 이 파일에 넣지 않습니다.

③ 부서 공통 기준은 짧은 노트로 분리하기

이 설치본은 부서별 노트와 관련 문서 일부를 읽는 방식입니다. 자료 폴더에 수백 개 파일을 넣었다고 매번 전부 읽는 것은 아닙니다. 중요한 기준을 노트 앞쪽에 두고, 작업에 필요한 원문과 비교표를 함께 지정하세요.

④ 상품·제작·판매 담당에게 넣을 실제 요청

상품 발굴팀: 1인 가구가 남기지 않고 먹을 과일 후보를 비교해줘.
품종·구성·실중량·배송 포함 가격·출고일·파손 보상·출처를 정리하고 추천은 보류해.

소싱팀: 선정 후보의 제휴 프로그램과 우리 채널 승인 여부를 구분해줘.
도매 구매 차익을 제휴 커미션으로 표시하지 말고, 문의는 초안만 작성해.

제작팀: 검증표를 바탕으로 첫 3초 화면+대사+약속 5안을 만들어줘.
한 가지 불편과 실제 해결 장면에 집중하고, 초별 대본·자막·필요 자산을 작성해.

분석팀: 제공한 실제 CSV만 분석해줘. 누락은 0이 아닌 미확인으로 표시해.
조회·시청 유지·클릭·승인 주문을 나누고 다음 실험에서 바꿀 요소 하나만 골라줘.

과일·농수산물은 보기 좋은 사진보다 실제 중량·원산지·보관·배송 사고 보상이 중요합니다. 판매 모니터링도 마찬가지입니다. 판매 계정이나 CSV가 연결되지 않았다면 분석 담당자를 만들어도 매출을 자동으로 알 수 없습니다.

⑤ 저장하고 한 부서부터 시험하기

설정 파일을 저장하고 npm run check로 점검한 뒤, 화면 소스를 바꿨다면 node build.mjs를 실행합니다. 서버를 재시작하고 직원 이름·역할을 확인하세요. 첫 시험은 상품 조사 표 한 장처럼 작게 시작하고, 결과 문서가 실제로 저장되는지 확인한 뒤 팀 실행으로 넓히면 됩니다.

6. 첫 업무 넣기: 대본과 촬영표를 나눠 맡기기

오른쪽 부서 선택에서 MARKETING(확장 구성에서는 릴스 제작·디자인)을 고르고 아래 요청을 넣습니다. 대본과 촬영표를 분담할 때만 TEAM을 켠 뒤 ADD를 누르세요. 다음 작업에서도 TEAM이 켜졌는지 확인해야 불필요한 분배·취합을 줄일 수 있습니다.

TEST-001 가상 케이블 정리 클립 콘텐츠 제작.
회사 노트 test-product의 조건만 사용하세요.
카피는 20초 한국어 대본 1개,
컷은 5컷 촬영표 1개를 작성하고
콘텐츠 총괄이 검수용 브리프로 합쳐주세요.
처음 3초는 책상 아래 충전 케이블을 찾는 불편으로 시작.
접착력·재사용성은 미확인이므로 단정하지 마세요.
외부 게시나 실제 영상 생성은 하지 마세요.

실행 결과 작가와 영상 기획자의 개별 결과가 나온 뒤 총괄이 합본을 만들었습니다. 완료된 업무를 클릭하면 결과를 읽을 수 있고, 문서는 shopping-brain/Agents Office에도 저장됩니다. 화면의 진행률보다 실제 결과 파일과 오류 여부를 확인하세요.

7. 손익표를 먼저 보면 만들지 말아야 할 영상도 보입니다

FINANCE에서 상품 노트로 손익을 계산하게 했습니다. 아래는 실제 매출이 아닌 가정값을 직접 검산한 결과입니다.

4,239원은 입력한 비용만 고려한 광고비 전 여유입니다. 세금·고정비·인건비가 빠졌으므로 ‘이 금액까지 광고를 써도 회사가 적자가 아니다’라고 해석하면 안 됩니다. 부가세 역시 판매가에 일률적으로 10% 비용을 더하는 대신 과세 유형과 매입세액 등을 따로 확인해야 합니다.

제휴 수수료가 적은 상품은 조회수가 많이 나와도 제작비를 회수하지 못할 수 있습니다. 그래서 대본을 많이 만드는 것보다 승인 주문 몇 건이 필요한지 먼저 보는 편이 낫습니다.

8. 검수 직원이 필요한 이유: 실제로 수정한 부분

첫 결과를 그대로 게시하기에는 문제가 있었습니다. 접착력을 모른다고 입력했는데 ‘클립을 붙이는’ 장면이 들어갔고, 광고 표시는 마지막 컷에만 배치됐습니다. 손익표의 계산은 맞았지만 세금과 적자 여부를 설명한 문장은 지나치게 단정적이었습니다.

검수 요청에는 ‘다시 잘 써줘’ 대신 문제 문장을 정확히 전달했습니다. 부착 방식이 확인되기 전에는 제품 배치 장면으로 바꾸고, 경제적 이해관계 표시는 마지막에만 숨기지 않도록 첫 화면과 게시 설명의 눈에 띄는 위치를 확인하는 식입니다. 실제 제품을 정하면 그 제품과 게시 플랫폼에 맞춰 다시 검수해야 합니다.

체크 담당에게 최종 검수 요청.
접착 방식 미확인인데 부착 장면이 있는지 확인.
광고 표시가 마지막 컷에만 있는지 확인.
기여이익을 순이익처럼 설명한 문장을 수정.
통과/수정 필요/추가 확인 사항과 수정문만 보여주세요.

부서 사이의 완전 자동 인계까지 만든 것은 아닙니다. 이번 시험에서는 팀 내부의 분담·취합은 프로그램이 처리했고, 금융 분석과 최종 검수 요청은 별도로 넣었습니다. 이 구분을 알아야 실제 운영에서 빠지는 업무가 없습니다.

9. 예제 실적과 실제 업무가 섞이면 먼저 정리하세요

확인한 설치본은 서버에 연결돼도 예제 업무와 숫자가 함께 보였습니다. 이번 로컬 구성에서는 서버로 여는 화면에 예제 업무가 생성되지 않도록 수정하고, 가상 실적 카드도 숨긴 뒤 다시 빌드했습니다. 따라서 위 캡처는 원본의 무수정 첫 화면과 다릅니다.

같은 현상이 있으면 Claude Code에 다음처럼 요청할 수 있습니다. 결과 파일을 지우라는 요청이 아니라 데모 표시를 실제 운영 화면과 분리하는 요청입니다.

실제 서버 모드에서는 예제 업무와 가상 실적을 표시하지 않게 해줘.
기존 실제 작업 기록은 보존해줘.
src/tasks.js의 예제 초기화와 자동 데모 업무 생성을 분리하고
실제 모드의 가상 통계 카드를 숨긴 뒤 빌드해서 확인해줘.
제작사 로고와 라이선스 표시는 그대로 유지해줘.

사무실 서버는 로컬만 사용하도록 이번 구성에서 127.0.0.1에 바인딩했습니다. 이 테스트에는 외부 접속 주소나 클라우드 서버가 필요하지 않습니다.

10. 자주 막히는 지점

GPT로도 AI 사무실을 만들 수 있나요? Codex로 시작하는 방법

업무를 역할별로 나누고 결과 파일을 만드는 방식은 Codex로도 구성할 수 있습니다. 다만 이 글에서 실행을 확인한 3D 사무실은 Claude 연결 버전입니다. 설치된 버전에서 GPT 전환이 검증되지 않았으므로 모델 이름만 바꾸면 같은 화면에서 작동한다고 안내하지는 않겠습니다.

GPT 사용자라면 먼저 아래처럼 Codex에 업무 폴더와 역할 지침을 주는 방식으로 시작하세요. 이는 움직이는 캐릭터 화면을 자동으로 설치하는 명령이 아니라, 실제 업무 결과물을 만드는 별도 구성입니다.

1단계. Codex 설치와 로그인 확인

Codex 공식 설치 안내에 따라 설치한 뒤 터미널에서 아래를 확인합니다. codex를 찾지 못하면 설치 또는 실행 경로부터 해결합니다.

codex --version
codex login
codex login status

브라우저에서 ChatGPT 계정으로 인증할 수 있습니다. API 키 인증은 별도의 사용량 과금 방식이므로 두 방식을 섞지 마세요. 계정별 사용 가능 범위와 한도도 확인해야 합니다. 공식 인증 설명

2단계. 업무 폴더와 AGENTS.md 준비

새 폴더 my-shopping-office를 만들고 그 안에 AGENTS.md, products, outputs를 준비합니다. 첫 파일에는 아래 지침을 넣고 products에는 확인한 상품 자료를 넣습니다. 아래 부서 구성은 이 글의 업무 설계 예시입니다.

# 쇼핑 콘텐츠 업무 지침

목표: 비교 근거가 있는 상품 소개 콘텐츠를 만든다.
상품 담당: 독립 후보 3개, 총구매가, 장단점, 출처를 비교한다.
소싱 담당: 제휴 프로그램, 허용 채널, 정산과 제외 조건을 확인한다.
대본 담당: 첫 3초 후킹 5안과 20초 대본 1개를 만든다.
디자인 담당: 썸네일과 자막 위계, 필요한 실제 자산을 지정한다.
검수 담당: 모델 일치, 사용권, 표현, 구매 링크를 확인한다.
분석 담당: 제공된 실제 성과만 비교하고 다음 수정 1개를 제안한다.

결과는 outputs에 작업별 Markdown으로 저장한다.
확인하지 않은 사실과 실제 판매 수치는 만들지 않는다.
공개 게시, 구매, 계약은 별도 승인 전 실행하지 않는다.

Codex는 프로젝트의 AGENTS.md를 작업 지침으로 사용할 수 있습니다. 다만 역할을 여럿 적었다고 독립 프로세스가 자동으로 여러 개 생기는 것은 아닙니다. 먼저 순서대로 한 작업을 끝내는 구조로 시험하세요. AGENTS.md 공식 설명

3단계. 폴더에서 실행하고 결과 확인

터미널에서 만든 업무 폴더로 이동한 뒤 codex를 실행하고 다음 요청을 입력합니다. 파일 접근이나 실행 권한을 묻는 경우 대상 폴더와 요청 내용을 보고 승인합니다.

products의 상품 자료를 먼저 읽고 AGENTS.md를 따라 작업해줘.
오늘은 상품 비교표와 20초 릴스 대본, 디자인 브리프, QA만 만들어줘.
자료가 부족한 항목은 보류하고 공개 게시나 결제는 하지 마.
outputs에 결과를 저장하고 실제 만들어진 파일과 남은 일을 알려줘.

완료 후에는 outputs의 비교표와 대본을 직접 열어 보세요. 출처가 없거나 영상 자산이 비어 있으면 다음 단계로 넘기지 않습니다. 영상 파일 제작과 채널 게시까지 하려면 해당 도구와 계정 인증을 별도로 연결해야 합니다.

어느 쪽부터 쓰면 좋을까요?

이미 Claude Code를 쓰고 있고 캐릭터 사무실 화면을 원한다면 본문의 테스트 구성을, GPT를 주로 쓰고 업무 파일을 먼저 정리하고 싶다면 Codex 구성을 출발점으로 삼을 수 있습니다. 두 계정을 동시에 많이 호출하기보다 같은 상품 하나로 결과 품질과 사용량을 비교해 보세요.

여러 사무실도 만들 수 있나요?

이 구성에서는 회사마다 설치 폴더·brain·작업 기록을 분리하고 포트를 다르게 지정하는 방식으로 나눌 수 있습니다. 다만 같은 Claude 계정을 쓰면 사용량이 별도 계정처럼 늘어나지는 않습니다. 지금은 사무실 하나에서 업무가 제대로 끝나는지 확인한 뒤 분리하는 편이 관리하기 쉽습니다.

운영 전 마지막 체크

• 가상 상품을 실제 상품 자료와 견적으로 교체했는가?
• 제휴 소개인지 직접 판매인지 정했는가?
• 실제 제품 장면, 이미지·음원 사용권, 광고 표시를 확인했는가?
• 최종 승인자와 외부 게시 담당을 정했는가?
• 조회수뿐 아니라 클릭·승인 주문·기여이익을 기록하는가?

Agents Office는 Sahni.ai의 제품입니다. MIT에서 배포한 소프트웨어나 MIT 라이선스 프로젝트가 아니며, 원본은 개인·내부 이용과 재판매 등에 관한 별도 조건을 안내합니다. 제품 재판매나 유료 서비스에 결합하려면 라이선스 원문부터 확인하세요. 이번 예시는 개인 컴퓨터의 가상 업무 시험이며 제작사 표시를 유지했습니다.

함께 읽기: Claude 사용량 줄이기와 스킬 설치 가이드. Ponytail·Graphify 설치와 사무실 직원 실행 환경은 별개이므로, 설치돼 있다는 이유만으로 모든 직원에게 적용됐다고 판단하지 마세요.

최종 확인: 2026년 9월 24일. 참고: Agents Office 원본, Claude Code 공식 설치 문서. 화면과 설정 예시는 위 버전의 실제 로컬 테스트 기준입니다.