클로드 코드 AI 에이전트 가상 사무실, 설치부터 첫 미션까지

어떻게 돌아가요?

1. 사장 Max한테 하고 싶은 일을 한 줄로 적어요. 키보드로 써도 되고, 🎙️ 버튼으로 말해도 돼요.
2. Max가 그 일을 읽고, 맞는 전문가 직원들을 불러요. 조사, 코딩, 디자인, 글쓰기, 분석 담당이 따로 있어요.
3. 직원들이 문으로 들어와서 자기 책상에 앉아요.
4. 머리 위 말풍선에 지금 실제로 하는 일이 떠요. "사이트 읽는 중", "파일 쓰는 중" 같은 식이에요.
5. 일이 끝나면 각자 보고서를 내고, 결과 파일은 프린터로 나와요.

애니메이션 아니에요. 공식 설명에 이렇게 적혀 있어요. 로봇 하나하나가 진짜 클로드 코드 에이전트이고, 내 컴퓨터에서 내 구독으로 일해요. 말풍선은 지어낸 연출이 아니라 그 직원이 실제로 쓰는 도구(검색, 웹페이지 읽기, 파일 쓰기 등)를 그대로 옮긴 거예요.

에이전트가 뭐예요? 일 하나를 맡아서 끝까지 해내는 AI예요. 여기서는 사장(Max)도 클로드 코드 한 명이고, 직원들은 사장이 부르는 서브에이전트(보조 에이전트)예요.

설치: 문장 한 줄

먼저 확인: 클로드 코드가 설치돼 있고 로그인돼 있어야 해요.

클로드 코드를 열고 아래 문장을 그대로 붙여넣으세요.

Installe et lance le Bureau des agents : https://github.com/devlikemasta/bureau-des-agents

프랑스어가 부담스러우면 한국어로 말해도 돼요. 클로드 코드는 저장소 안내문을 읽고 똑같이 진행해요.

이 저장소의 안내대로 Bureau des agents를 설치하고 실행해 줘: https://github.com/devlikemasta/bureau-des-agents
Node.js 버전부터 확인하고, 없거나 22.18보다 낮으면 설치 방법을 알려 줘.

그러면 클로드 코드가 알아서 이렇게 해요.

1. Node.js 버전 확인 (node -v). 없거나 낮으면 nodejs.org에서 LTS 버전을 깔라고 알려 줘요
2. 프로그램을 내려받고 (git clone) 필요한 부품 설치 (npm install)
3. 실행 (npm start). 브라우저가 저절로 열리면서 http://localhost:4848 에 사무실이 떠요

다음에 다시 켤 때는 클로드 코드에 "Bureau des agents 다시 켜 줘"라고만 하면 돼요. 공식 안내 문장은 «Relance le Bureau des agents»예요.

직접 설치하고 싶다면

터미널에 한 줄씩 입력하세요.

git clone https://github.com/devlikemasta/bureau-des-agents.git
cd bureau-des-agents
npm install
npm start

끌 때는 터미널에서 Ctrl + C. 사무실은 이 명령이 켜져 있는 동안만 돌아가요.

첫 미션 전에 꼭: '사무실 규정' 채우기

오른쪽 패널에 « Le règlement du bureau »(사무실 규정) 버튼이 있어요. 여기에 내가 누구고, 무슨 일을 하는지 적어 두면 Max가 매 미션 전에 읽어요. 그래야 직원들이 아무나가 아니라 나를 위해 일해요.

뭘 적을지 막막하면 이 틀을 채워서 붙여넣으세요.

나는 [이름/닉네임]이고, [하는 일: 예) 1인 카페 운영, 인스타 정보 계정 운영]을 해.
고객은 주로 [누구: 예) 20~30대 직장인]이야.
결과물은 한국어로, 쉬운 말로 써 줘. 전문 용어를 쓰면 괄호 안에 한 줄 설명을 붙여 줘.
조사할 때는 공식 사이트나 공식 문서를 먼저 보고, 출처 링크를 꼭 남겨 줘.
가격·날짜·숫자는 확인한 날짜와 함께 적어 줘.

첫 미션 예시 3개

Max한테 이렇게 말해 보세요. 공식 안내에 있는 예시를 우리 상황에 맞게 바꾼 거예요.

1. 경쟁 가게 조사 + 소개 페이지 (여러 직원이 동시에 움직이는 걸 보기 좋아요)

우리 동네에 작은 카페를 열려고 해. 근처 경쟁 카페 5곳을 조사해 줘. 한 곳에 직원 한 명씩 맡아서 메뉴, 가격, 분위기, 리뷰에서 자주 나오는 말을 정리하고, 마지막에 비교표와 우리 카페 소개 페이지 초안을 만들어 줘.

2. 이번 주 AI 소식 정리 (조사 담당이 일하는 모습을 보기 좋아요)

이번 주 AI 소식 중에 1인 사업자한테 중요한 것 5개만 골라서, 각각 무슨 일인지, 나한테 왜 중요한지, 공식 출처 링크를 정리해 줘.

3. SNS 글 3개 (작고 빨리 끝나서 처음 시험하기 좋아요)

내 사업을 소개하는 인스타그램 게시글 3개를 써 줘. 하나는 정보형, 하나는 후기형, 하나는 이벤트 안내형으로. 각각 첫 줄은 짧고 궁금하게 써 줘.

처음엔 3번처럼 작은 일부터 해 보세요. 직원 수가 많을수록 구독 사용량도 많이 써요.

안에서 할 수 있는 것

뭐든 눌러 보세요. 사무실 물건마다 정보가 숨어 있어요.

사진: 팀이 만든 사이트를 사무실 안 화면에서 보는 모습 (공식 저장소)

• 팀이 만든 사이트는 사무실 안 화면에서 컴퓨터 모양·폰 모양으로 바로 볼 수 있어요. 코드와 지난 버전도 같이 볼 수 있어요.
• 다시보기: H를 누르고 « Rejouer »(다시보기)를 고르면 끝난 미션이 처음부터 똑같이 다시 재생돼요. 팀을 다시 부르지 않아서 구독 사용량이 안 나가요.
• 주크박스로 음악을 틀 수 있고, T를 누르면 Max가 사무실 안내를 해 줘요.
• 숨은 재미도 있어요. 고양이 한 마리, 그리고 게이머라면 아는 비밀 코드 하나.

단축키 (영상 찍을 때 특히 유용)

릴스용 꿀조합: V로 세로 화면 → F로 촬영 모드 → 화면 녹화. 미션이 끝난 뒤라면 다시보기로 틀어 놓고 찍으면 사용량도 안 나가요.

사진: 저녁 모드의 사무실 (공식 저장소)

요금: 내 클로드 구독으로 돌아가요

이 프로그램 자체는 무료지만, 직원들이 일하는 건 내 클로드 코드 구독 사용량을 써요. 내가 클로드 코드한테 직접 시킨 것과 똑같이 계산돼요.

• 만든 사람이 시험해 본 값: **직원 7명이 일한 미션 하나가 5시간 사용 한도의 2~3%**를 썼대요.
• 일의 크기, 조사할 사이트 수, 모델에 따라 달라져요. 처음엔 작은 미션으로 내 사용량이 얼마나 줄어드는지 먼저 보세요.
• 다시보기(H → « Rejouer »)는 사용량이 안 나가요.

안전: 내 컴퓨터는 괜찮을까?

공식 설명에 적힌 안전장치예요.

• 모든 게 내 컴퓨터 안에서만 돌아가요. 사무실은 내 컴퓨터 주소(127.0.0.1)만 듣고 있어서, 다른 웹사이트가 내 팀을 대신 부릴 수 없어요.
• 직원들은 미션 폴더 밖으로 못 나가요. 결과물은 내 문서/Bureau des agents/Missions/ 아래에 쌓여요. 내 다른 설정이나 다른 에이전트는 건드리지 않아요.
• 위험한 명령은 나한테 먼저 물어봐요. 직원이 손을 들면 '예/아니요'로 답하면 돼요. 잘 모르겠으면 아니요가 안전해요.
• 팀이 만든 사이트는 격리된 칸에서 열려요. 사무실이나 클로드 코드에 손댈 수 없어요.
• 사무실 화면 자체는 가벼워요. 탭을 숨기면 그리기를 멈춰요.

윈도우에서 쓴다면

공식적으로 시험된 건 macOS예요. 윈도우·리눅스는 "될 것"이라고 적혀 있고, 안 되면 알려 달라고(Issues 탭) 해요. 설치하다 막히면 에러 메시지를 그대로 복사해서 클로드 코드에 이렇게 말하세요.

Bureau des agents 설치(또는 실행) 중에 아래 에러가 났어. 원인을 찾아서 고쳐 줘. 고친 뒤에 다시 실행해서 http://localhost:4848 이 열리는지 확인해 줘.

[에러 메시지 붙여넣기]

프랑스어 화면 읽는 법

화면이 아직 프랑스어예요. 자주 보이는 말만 알면 충분해요.

영어로 바꾸는 번역은 아직 없어요. 만든 사람이 "첫 기여로 딱 좋다"고 적어 뒀을 정도라, 나중에 생길 수도 있어요.

용어 정리

꼭 기억할 것

이 사무실은 AI가 일하는 걸 눈으로 보게 해 주는 도구예요. 일을 더 잘하게 만드는 마법은 아니에요. 결과가 좋으려면 여전히 사무실 규정을 잘 채우고, 미션을 구체적으로 적는 게 제일 중요해요.

출처

• devlikemasta/bureau-des-agents README (2026-10-25 확인, MIT)
• Node.js 공식 사이트