Chapter 4

클로드 아티팩트와 프로젝트 흔한 실수 6가지: 체크리스트로 점검

2026-08-21 · 34 min read · 10 XP
챕터 4 시작 · 웹 작업실: 사이드바 기능 다 써먹기
1
2
3
4
0/4

"프로젝트까지 만들어봤는데 이걸 제대로 쓰고 있는 게 맞을까요?"

이 구간에서 가장 많이 나오는 실수는 여섯 가지입니다. 아티팩트 창이 안 열리는 설정, 게시하지 않아 목록에 없는 아티팩트, 아티팩트로는 나오지 않는 발표 자료, AI가 읽지 않는 프로젝트 이름과 설명, 지침을 비워둔 채 자료만 쌓은 방, 사라진 줄 알고 새로 만드는 프로젝트입니다. 여섯 가지 대부분은 원인이 공식 문서에 적혀 있고 해결도 한 줄씩입니다. 지난 레슨에서 자료와 지침을 방에 올려두셨다면, 오늘은 그 방과 그 창이 실제로 굴러가는지 확인하는 차례입니다. 아티팩트나 프로젝트가 뜻대로 안 움직여서 오셨다면 이 레슨만 보셔도 됩니다.

트랙을 닫기 전에 점검할 7가지

점검표부터 펼치겠습니다. 앞의 세 레슨에서 한 번씩 손으로 해본 것들입니다. 읽어서 아는 것과 해본 것은 다르니 O와 X로만 표시해 보시기 바랍니다.

  1. 사이드바를 끝까지 내려보고 받기, 정리, 잇기, 위임 네 계단 중 몇 개가 내 화면에 보이는지 적어봤다.
  2. 리포트 골격을 요청해 채팅 오른쪽에 아티팩트 창이 열리는 것을 봤다.
  3. 수정 요청을 한 번 더 보내 버전 2를 만들고 버전 선택기로 버전 1과 2를 오가봤다.
  4. 다 다듬은 아티팩트를 게시하거나 복사 또는 다운로드로 대화 밖으로 꺼내봤다.
  5. 프로젝트를 하나 만들고 프로젝트 지식에 파일을 한 개 이상 올렸다.
  6. 프로젝트 지침에 역할, 작업, 자료, 형식 네 줄을 적어뒀다.
  7. 그 방에서 한 줄짜리 요청만 보냈는데 올려둔 자료의 형식이나 표기가 답에 묻어났다.
체크포인트— 일곱 개 중 다섯 개 이상에 O를 치셨다면 다음 트랙으로 넘어가셔도 됩니다. X가 셋 이상이면 그 항목이 나온 레슨으로 한 번 돌아가시는 편이 낫습니다. 1번은 레슨 1, 2번부터 4번은 레슨 2, 5번부터 7번은 레슨 3입니다.

이 구간에서 가장 흔한 실수 6가지

X가 찍히는 자리는 대체로 정해져 있습니다. 여섯 가지를 증상과 원인과 해결 순서로 짚겠습니다. 앞 레슨에서 지나가듯 나왔던 조건들이 실제로는 여기서 발목을 잡습니다.

실수 1. 아티팩트 창이 열리지 않는 설정

문서로 만들어 달라고 분명히 요청했는데 답이 채팅에 그대로 풀리는 경우입니다. 오른쪽에 창이 열리지 않으니 결과물이 다시 대화 속으로 섞여 들어갑니다.

가장 먼저 볼 곳은 설정 한 칸입니다. 이 항목은 무료를 포함해 대부분의 플랜에서 기본으로 켜져 있어서 대개는 문제가 없지만 누가 꺼 두었다면 여기서 끝납니다. 클로드 공식 문서는 설정의 기능에서 코드 실행 및 파일 생성이 켜져 있지 않으면 아티팩트를 더 이상 지원하지 않는다고 못 박아 두었습니다. 설정의 기능 항목으로 들어가 이 스위치부터 확인하세요. 회사 계정이라면 조직 설정에서 소유자가 끄고 켤 수 있습니다. 설정이 켜져 있는데도 안 열린다면 요청한 내용이 조건에 못 미쳤을 가능성이 큽니다. 공식 문서가 드는 판정 기준은 보통 15줄이 넘고 앞뒤 설명 없이도 말이 되는 독립적인 내용입니다. 한 문단짜리 문구를 아티팩트로 받으려 하면 창이 안 열릴 수 있습니다.

실수 2. 만든 아티팩트가 목록에 없는 이유

어제 만든 리포트 골격을 사이드바의 아티팩트에서 찾는데 목록이 비어 있는 경우입니다. "클로드 아티팩트 모음"이 검색되는 이유가 이것입니다.

지워진 것이 아닙니다. 클로드 공식 문서는 대화에서 만든 아티팩트가 사이드바에 자동으로 나타나지 않는다고 안내합니다. 그 자리에 올리려면 아티팩트를 열고 게시(Publish)를 눌러야 합니다. 여기서 플랜을 한 번 확인하세요. 게시 버튼은 Free와 Pro와 Max에만 있고 Team과 Enterprise에서는 같은 자리가 공유(Share)입니다. 회사 계정이라면 조직 안에서만 공유되고 외부 공개는 되지 않습니다. 그러니 나중에 다시 꺼내 쓸 물건이면 다듬은 김에 게시까지 해두시는 편이 낫습니다. 다만 게시 버튼은 가볍게 누르고 무르는 버튼이 아닙니다. 게시는 지금 열려 있는 버전을 그대로 내보내고, 게시를 취소하면 같은 아티팩트를 다시 게시할 수 없습니다. 되살리려면 아티팩트를 새로 만들어야 합니다. 누르기 전에 버전 선택기가 내보내려는 그 버전에 있는지부터 보세요.

실수 3. 아티팩트에 발표 자료를 기대하는 함정

"클로드 아티팩트 ppt"가 자동완성에 뜰 만큼 흔한 기대입니다. 리포트를 슬라이드로 받아 고객사에 첨부하려는데 파일이 나오지 않아 헤매게 됩니다.

아티팩트로는 나오지 않습니다. 공식 문서가 대표 예로 드는 아티팩트 유형은 문서, 코드, 한 페이지 웹사이트, SVG 이미지, 다이어그램과 순서도, 흔히 미니앱이라 부르는 대화형 React 컴포넌트 여섯 가지이고 여기에 슬라이드가 없습니다. 대신 파일 생성 기능이 그 일을 합니다. 공식 문서는 클로드가 엑셀(.xlsx), 파워포인트(.pptx), 워드(.docx), PDF를 만들 수 있다고 명시하고 파일당 30MB까지 다룹니다. 두 기능이 헷갈리는 이유는 스위치가 하나이기 때문입니다. 둘 다 실수 1에서 본 그 설정 항목으로 켜집니다. 기준은 이렇게 잡으시면 됩니다. 대화 옆에 두고 계속 고칠 물건은 아티팩트, 메일에 붙여 보낼 물건은 파일 생성입니다.

실수 4. AI가 읽지 않는 자리에 정보를 두는 습관

프로젝트 설명란에 "고객사 A 월간 리포트용, 문장은 짧게"라고 적어두고 답이 달라지기를 기다리는 경우입니다. 또는 클로드에서 어제 대화에 합의한 표 항목을 오늘 새로 연 대화가 그대로 이어가 주기를 기대하는 경우입니다.

둘 다 공식 문서에 반대로 적혀 있습니다. 클로드 공식 문서는 프로젝트에 이름과 설명을 붙이되 클로드가 그 내용에 접근하지는 않는다고 밝히고, 프로젝트 지식에 넣지 않는 한 방 안의 대화끼리 맥락이 공유되지 않는다고도 밝힙니다. 이름과 설명은 내가 방을 찾기 위한 표지판이고 대화는 그 방에서 벌어진 일회성 사건입니다. 챗GPT는 이 대목이 반대라서 같은 방 안의 대화끼리 서로 참조합니다. 클로드도 설정에서 메모리를 켜두면 프로젝트마다 별도 메모리 공간이 생겨 일부는 묻어납니다. 다만 그것은 지식과 다른 장치라 무엇이 남을지 내가 정할 수 없습니다. 그러니 남겨야 할 결정은 대화에 두지 말고 지침이나 지식으로 올려야 합니다. 리포트 표 항목을 세 번째 대화에서 확정했다면 그날 지침 한 줄을 고쳐두는 것이 다음 달의 나를 살립니다.

실수 5. 지침은 비워둔 채 자료만 쌓는 방

파일을 열 개 올려뒀는데 방 안에서 받은 답이 방 밖에서 받은 답과 다르지 않은 경우입니다. 자료를 더 올려도 나아지지 않습니다.

지식과 지침은 역할이 다릅니다. 지식이 재료라면 지침은 조리법입니다. 클로드 공식 문서는 프로젝트마다 지침을 정해 클로드의 응답 방식을 맞출 수 있다고 안내합니다. 재료만 쌓아두면 무엇을 기준으로 삼을지가 매번 달라집니다. 지난 리포트 두 건과 브랜드 가이드를 함께 올려놓고 어느 쪽이 양식 기준인지 적어두지 않으면 클로드도 아무거나 골라 씁니다. 지침에 적을 것은 네 줄이면 충분합니다. 어떤 역할로 답할지, 이 방에서 무엇을 만들지, 올려둔 자료 중 무엇이 기준인지, 어떤 구조로 쓸지입니다. 구글이 젬 지침 작성법으로 안내하는 페르소나, 작업, 관련 정보, 형식 네 요소를 프로젝트에 맞게 옮긴 것이고 클로드와 챗GPT 프로젝트 지침에도 그대로 쓸 수 있습니다.

실수 6. 프로젝트가 사라졌다고 새로 만드는 일

"챗gpt 프로젝트를 불러올 수 없습니다"와 "챗gpt 프로젝트 사라짐"이 나란히 자동완성에 뜹니다. 방이 안 보이니 급한 마음에 같은 이름으로 새 방을 만들게 됩니다.

새로 만들기 전에 확인이 먼저입니다. 대부분은 지워진 것이 아니라 다른 자리에 있거나 화면이 못 불러온 상태입니다. 로그인한 계정과 워크스페이스가 맞는지부터 보고 그다음 보관 여부를 봅니다. 확인할 자리는 서비스마다 다릅니다. 챗GPT는 프로젝트 자체를 보관하는 경로가 공식 문서에 안내되어 있지 않아 설정의 데이터 제어에 있는 보관된 채팅부터 확인하게 되고, 클로드는 프로젝트 목록의 보관 탭에서 보관된 프로젝트를 봅니다. 클로드 공식 문서는 보관해도 구성원과 권한과 프로젝트 지식이 그대로 보존된다고 안내합니다. 보관된 프로젝트는 삭제도 바로 되지 않아서 지우려면 보관을 먼저 풀어야 합니다. 사라진 것과는 거리가 먼 상태입니다. 챗GPT 쪽 확인 순서는 레슨 3에 여섯 단계로 정리해 뒀으니 그대로 밟으시면 됩니다. 새 방을 만들면 지침과 지식을 처음부터 다시 채워야 합니다. 확인에 드는 5분이 훨씬 쌉니다.

남겨둔 코드와 코워크는 언제 배우나요

두 항목의 자리와 정체는 레슨 1에서 짚어뒀습니다. 오늘 확인하실 것은 순서 하나입니다. 코드와 코워크는 둘 다 4계단 위임에 속합니다. 위임은 내가 결과를 확인하는 단계가 아니라 작업 과정을 통째로 맡기는 단계입니다. 무엇을 맡겨도 되는지 감이 없는 상태에서 먼저 열면 나온 결과를 믿을 근거가 없습니다. 그래서 코드는 CLI 트랙에서 열고 코워크는 그 뒤 심화 과정으로 미뤄 뒀습니다. 사이드바에 아직 눌러보지 않은 항목이 남아 있거나 입력창에 골라보지 않은 모드가 있다고 해서 뭔가를 놓치고 계신 것이 아닙니다.

프로젝트에 올린 자료는 그 시점의 사본입니다

트랙을 닫기 전에 한 가지만 더 짚겠습니다. 앞에서 만든 고객사 리포트 방을 다시 떠올려 볼까요? 지난달 리포트와 브랜드 가이드를 프로젝트 지식에 올려두셨을 겁니다. 그런데 그 파일들은 올리던 순간의 모습 그대로입니다.

다음 달이 되면 어떻게 될까요? 성과 수치가 갱신되고 브랜드 가이드에는 신제품 표기가 한 줄 늘어납니다. 방은 그대로입니다. 우리가 파일을 다시 내려받아 방에 다시 올려야 합니다. 고객사가 한 곳이면 견딜 만합니다. 다섯 곳이고 방마다 자료가 세 개씩이면 매달 열다섯 번을 나르게 됩니다. 자료를 재사용하려고 만든 방인데 자료 나르는 일이 그대로 남는 셈입니다.

해답은 이미 공식 문서에 적혀 있습니다. 클로드는 구글 드라이브에서 가져온 구글 문서(Google Docs)가 드라이브의 최신 버전과 계속 동기화된다고 안내합니다. 사본을 나르는 대신 원본을 이어두는 방식입니다. 다만 조건이 둘 붙습니다. 동기화를 약속하는 대상은 구글 문서까지이고 스프레드시트나 PDF는 읽어 오기만 합니다. 그리고 이 경로는 비공개 프로젝트에서만 열리고 조직에 공유한 프로젝트에서는 비활성화됩니다. 이 연결을 만드는 것이 커넥터입니다. 커넥터는 내가 올린 파일을 읽는 것이 아니라 내 서비스에 들어가 필요한 것을 찾아옵니다. 볼 수 있는 범위는 내가 그 서비스에서 이미 가진 권한을 그대로 물려받습니다. 내가 못 여는 파일은 클로드도 못 엽니다.

레슨 1에서 잇기를 3계단에 놓고 이 트랙 밖으로 뺀 이유가 여기 있습니다. 조작이 어려워서가 아니라 무엇을 허용하고 언제 회수할지 읽는 판단이 필요하기 때문입니다. 체크리스트에 O가 다섯 개 이상 찍혔다면 그 판단을 해보실 준비가 된 것입니다.

저도 웹 안에서 꽤 오래 버텼습니다. 그런데 한계를 느낀 장면은 자료를 나르는 쪽이 아니라 기다리는 쪽에서 왔습니다.

원하는 것을 채팅에 잔뜩 설명하고 아티팩트에 반영되기를 한참 기다렸는데 전혀 다른 결과물이 나왔습니다. 다시 설명하고 다시 기다렸습니다. 그 왕복을 몇 번이나 반복하다 보니 내가 하는 일이 만드는 쪽이 아니라 기다리는 쪽에 가깝다는 생각이 들었습니다. 설명이 길어질수록 기다림도 길어지는데, 길게 설명했다고 해서 맞게 나오는 것도 아니었습니다.

이 지점이 웹 작업실의 경계입니다. 방을 만들고 자료를 올려두는 것까지는 잘 되는데, 그 방이 내 실제 자료와 이어져 있지 않으니 매번 말로 설명해서 좁혀 가야 합니다. 다음 트랙이 그 설명을 줄입니다.

30초 요약
  • 트랙 점검표는 일곱 개입니다. 다섯 개 이상 O면 다음 트랙으로, X가 셋 이상이면 해당 레슨으로 돌아가시면 됩니다.
  • 아티팩트 창이 안 열리면 설정의 코드 실행 및 파일 생성부터 확인하세요. 공식 문서가 드는 판정 기준이 보통 15줄이 넘는 독립적인 내용이라 짧은 요청은 안 열릴 수 있습니다.
  • 대화에서 만든 아티팩트는 사이드바에 자동으로 안 올라갑니다. Free와 Pro와 Max는 게시해야 목록에 들어가고 게시 취소 후에는 재게시가 안 됩니다. Team과 Enterprise에는 게시 대신 조직 내 공유만 있습니다.
  • 발표 자료는 아티팩트가 아니라 파일 생성 기능이 만듭니다. 공식 문서가 대표 예로 드는 여섯 가지에 슬라이드가 없습니다.
  • 클로드에서 프로젝트 이름과 설명은 읽히지 않고 같은 방 안 대화끼리도 맥락을 공유하지 않습니다. 챗GPT는 반대입니다. 남길 결정은 지침이나 지식으로 올리세요.
  • 프로젝트가 안 보이면 계정과 보관함부터 확인하세요. 보관해도 지식과 권한은 그대로 남습니다.
  • 프로젝트에 올린 파일은 올린 시점의 사본입니다. 구글 드라이브에서 가져온 구글 문서만 최신 버전과 계속 이어지고, 원본을 통째로 잇는 일은 다음 트랙의 커넥터가 맡습니다.

자주 묻는 질문

만든 아티팩트가 사이드바 목록에 없는데 어디로 갔나요?

지워진 것이 아니라 아직 올라가지 않은 것입니다. 클로드 공식 문서는 대화에서 만든 아티팩트가 사이드바의 아티팩트 항목에 자동으로 나타나지 않는다고 안내합니다. 그 아티팩트를 열고 게시를 눌러야 목록에 들어갑니다. 게시 버튼은 Free와 Pro와 Max 플랜에 있고 Team과 Enterprise에서는 같은 자리가 조직 내 공유입니다. 게시는 지금 보고 있는 버전을 그대로 내보내니 버전 선택기가 내보내려는 버전에 있는지 확인하고 누르세요. 한 가지 주의할 점은 게시를 취소하면 같은 아티팩트를 다시 게시할 수 없다는 것입니다. 다시 공개하려면 아티팩트를 새로 만들어야 합니다.

프로젝트에 올린 파일은 원본이 바뀌면 같이 바뀌나요?

어떻게 올렸는지에 따라 다릅니다. 구글 드라이브에서 가져온 구글 문서는 드라이브의 최신 버전과 계속 동기화된다고 클로드 공식 문서가 안내합니다. 동기화를 약속하는 대상은 구글 문서까지이고 스프레드시트나 PDF는 읽어 오는 데 그칩니다. 내 컴퓨터에서 파일로 올린 자료에는 그런 연결이 없어서 내용이 바뀌면 새 파일로 다시 올려야 합니다. 매달 갱신되는 자료를 다루신다면 업로드보다 연결이 맞습니다. 참고로 드라이브에서 파일을 추가하는 경로는 비공개 프로젝트에서만 열리고 공유된 프로젝트에서는 비활성화됩니다.

클로드 아티팩트로 PPT를 못 만드나요?

아티팩트로는 안 됩니다. 공식 문서가 대표 예로 드는 아티팩트 유형은 문서, 코드, 한 페이지 웹사이트, SVG 이미지, 다이어그램과 순서도, 흔히 미니앱이라 부르는 대화형 React 컴포넌트 여섯 가지이고 슬라이드가 없습니다. 파워포인트(.pptx) 파일은 파일 생성 기능이 만듭니다. 엑셀(.xlsx), 워드(.docx), PDF도 같은 기능으로 만들어지고 파일당 30MB까지 다룹니다. 두 기능 모두 설정의 코드 실행 및 파일 생성 항목으로 켜지기 때문에 헷갈리기 쉽습니다.

프로젝트가 안 보이는데 되살릴 수 있나요?

새로 만들기 전에 확인부터 하세요. 대부분은 삭제된 것이 아니라 다른 계정이나 워크스페이스에 있거나 보관된 상태입니다. 클로드 공식 문서는 프로젝트를 보관해도 구성원과 권한 수준과 프로젝트 지식이 모두 보존된다고 안내하고 보관된 프로젝트는 보관을 풀기 전에는 삭제할 수도 없다고 밝힙니다. 보관을 풀면 그대로 돌아옵니다. 챗GPT에서 프로젝트를 불러올 수 없다고 나올 때의 확인 순서는 이 트랙 레슨 3에 정리해 두었습니다.

클로드 코드와 코워크는 언제 배우면 되나요?

지금은 아닙니다. 둘 다 목표만 던지고 작업 과정을 맡기는 위임 단계에 속합니다. 무엇을 맡겨도 되는지 감이 생긴 다음이 순서상 맞습니다. 이 여정에서는 코드를 CLI 트랙에서 열고 코워크는 그 뒤 심화 과정에서 다룹니다. 그전까지 사이드바의 코드나 입력창의 코워크를 눌러보지 않으셔도 문제가 아닙니다. 두 기능의 자리와 정체는 이 트랙 레슨 1에 정리해 두었습니다.

Sources (12)펼쳐서 전체 출처 보기
quest_log.txt
획득
✓챕터 4 완료
✓+10 XP (누적 0)
✓막히는 이유는 실력이 아니라 켜지 않은 설정과 누르지 않은 버튼이다
1
2
3
4
0/4 · 0%
Lv.1 입문자
0 / 100 XP
다음 레벨까지 100 XP
트랙 완주웹 작업실: 사이드바 기능 다 써먹기→