AI 에이전트 →

워크스페이스Workspace

워크스페이스 (Workspace)는 내 방 서랍장 같은 것 — 에이전트가 일할 때 쓰는 파일·설정·규칙 문서가 내 기기의 한 폴더 안에 정리되어 보관되는 전용 공간이다.

워크스페이스 (Workspace)는 내 컴퓨터 안의 '전용 서랍장'이라고 생각하면 쉽다. 클로드 코드(Claude Code)나 코덱스(Codex)는 내가 실행한 프로젝트 폴더를 작업 공간으로 삼고, 그 안의 파일과 규칙 문서(CLAUDE.md·AGENTS.md), 스킬 (Skill) 설정을 읽으며 일한다. 서랍장 안에 어떤 도구가 들어 있느냐에 따라 에이전트가 할 수 있는 일이 달라지듯, 워크스페이스 안의 스킬 구성이 내 AI 어시스턴트의 능력 범위를 결정한다.

1인 비즈니스(1인 사이트 운영)를 운영할 때 워크스페이스는 '내 자동화 도구 창고' 역할을 한다. 블로그 글 초안을 뽑아내는 스킬, 뉴스레터 발송을 트리거하는 스킬, SaaS 고객 문의를 처리하는 스킬 등 내가 만든 확장 기능들이 모두 워크스페이스 안에 저장된다. 워크스페이스를 잘 구성해 두면 에이전트를 다시 실행해도 기존 규칙과 스킬 설정이 그대로 유지되어 처음부터 다시 세팅할 필요가 없다.

초보자가 흔히 혼동하는 점은 워크스페이스를 클라우드 서비스로 오해하는 것이다. 클로드 코드·코덱스의 워크스페이스는 인터넷 어딘가가 아니라 '내 기기 안의 폴더'에 존재하는 로컬 (local-first) 공간이다. 덕분에 데이터가 외부 서버로 나가지 않아 개인 정보 보호 측면에서 유리하지만, 반대로 기기가 바뀌면 워크스페이스 폴더를 직접 옮겨야 설정이 이어진다는 점을 기억해 두자.

💡 대표 예시

  • 블로그 운영 — 'SEO 초안 스킬'을 만들어 워크스페이스에 추가하면 에이전트가 글 주제를 받자마자 초안을 뽑아주는 환경이 완성된다
  • 뉴스레터 — 발송 자동화 스킬을 워크스페이스에 설치해 두면 에이전트를 다시 실행해도 설정이 유지되어 매번 다시 연결하지 않아도 된다
  • SaaS 도구 사이트 — 고객 문의 분류 스킬을 워크스페이스에 넣어두고, 스킬 하나만 교체해서 응대 방식을 빠르게 바꿀 수 있다
  • 커뮤니티 운영 — Discord 채널 (Channel) 연동 스킬을 워크스페이스에 추가해 멤버 가입 환영 메시지를 자동화한다
  • 포트폴리오 사이트 — 문의 폼 응답 스킬을 워크스페이스에 저장해, 에이전트가 문의를 받으면 자동 답장 흐름이 작동하도록 구성한다

🔗 관련 용어

에이전트

에이전트 (Agent)는 나 대신 심부름을 해주는 AI 직원 같은 것 — 내가 '블로그 글 올려줘'라고 말하면 브라우저를 열고, 글을 작성하고, 발행까지 스스로 처리한다.

샌드박스

샌드박스 (Sandbox)는 아이들 모래 놀이터 같은 것 — 모래를 아무리 흩뿌려도 놀이터 밖은 더럽혀지지 않듯, 에이전트 (Agent)가 실험적으로 코드를 실행해도 내 컴퓨터 실제 환경에는 전혀 영향을 주지 않는 격리된 공간이다.

툴

툴 (Tool)은 에이전트 (Agent)의 손 같은 것 — 머리(AI)만 있으면 생각만 하지만, 손(툴)이 생겨야 브라우저를 열고, 파일을 만들고, 예약 작업을 실행하는 등 실제로 무언가를 할 수 있다.

스킬

스킬 (Skill)은 에이전트 (Agent)에게 끼워 넣는 앱 모듈 같은 것 — 스마트폰에 앱을 설치하면 기능이 늘어나듯, 스킬을 추가하면 에이전트가 할 수 있는 일이 하나씩 늘어난다.

게이트웨이

게이트웨이 (Gateway)는 내 기기 안의 우체국 같은 것 — 슬랙·텔레그램·디스코드 등 어느 채널로 메시지가 와도 게이트웨이가 한 곳에서 받아서 에이전트 (Agent)에게 넘기고, 답장도 같은 길로 돌려보낸다.

세션

세션 (Session)은 대화방의 '문이 열려 있는 동안' 같은 것 — 에이전트 (Agent)가 사용자를 기억하고 맥락을 유지하는 시간 단위로, 문이 닫히면 그 안의 흐름도 끝난다.

이 개념, 직접 적용해볼까요?

AI 에이전트를 직접 만들고 24시간 운영하는 법을 단계별 강의로 배워보세요.