Quick Reference

Artifact는 대화 본문과 분리된 창에서 수정·반복·재사용할 독립 결과물입니다. 유의미하고 스스로 읽히는 문서, 코드, SVG, 다이어그램, 단일 HTML, 상호작용 React 컴포넌트에 맞습니다. Artifacts는 모든 Claude 플랜에서 제공되지만 Code execution and file creation capability가 켜져 있어야 합니다.

요청: 결과물의 타입 + 대상 + 포함 조건을 명시
  -> Artifact 생성
  -> 부분 수정 또는 새 버전 반복
  -> 보관하려면 Publish로 Artifacts sidebar에 추가

언제 Artifact가 되는가

Claude는 대화만으로 이해되지 않는, 보통 15줄 이상인 독립 결과물을 Artifact로 만들 수 있습니다. 예를 들어 문서 초안, 코드 조각, 단일 페이지 HTML, SVG, 흐름도, 상호작용 React 컴포넌트가 적합합니다. "사용자가 다시 열어 편집하거나 다른 사람에게 보여 줄 독립 결과인가"가 핵심 기준입니다.

좋은 요청
"교수용 10분 발표 outline을 Markdown으로 만들고,
 각 slide의 학습 목표와 말할 핵심을 포함해라."

모호한 요청
"대시보드 하나 만들어 줘."

후자처럼 결과물 타입이 불명확하면 문서 초안인지, 단일 페이지 UI인지, 실제 제품 구현인지부터 정합니다. Artifact는 빠른 탐색과 반복에는 좋지만, 복잡한 패키지 구성, 비밀값, 서버 처리, 장기 유지보수가 필요한 제품 코드의 기준 원본이 되지는 않습니다.

수정과 보관

생성된 Artifact는 대화 오른쪽 전용 창에서 봅니다. Markdown 문서는 일부를 선택해 Edit with Claude로 그 부분만 고칠 수 있고, 일반 수정은 대화에서 요구 사항을 바꿔 반복합니다. 대화에서 만든 Artifact가 sidebar Artifacts 영역에 자동으로 쌓이지는 않습니다. 계속 보관·정리할 결과물은 Artifact를 열고 Publish해야 sidebar에 추가됩니다.

Artifacts sidebar는 모든 플랜에서 만들고 관리하는 공간이지만, organization의 Code execution and file creation capability가 꺼져 있으면 Artifact 생성 자체가 동작하지 않습니다. Team·Enterprise에서 보이지 않으면 개인 UI 문제로 단정하지 말고 Owner가 Organization settings > Capabilities에서 이 기능을 허용했는지 확인합니다.

파일과 제품 코드의 경계

Artifact는 산출물의 모양을 빠르게 다듬는 공간이고, file creation은 다운로드할 office 문서와 PDF를 만드는 기능입니다. Artifact 안의 interactive prototype이 실제 서비스 요구와 맞아도, 다음 경우에는 개발 환경으로 옮깁니다.

• 여러 원본 파일과 패키지 잠금 파일을 관리해야 할 때
• test, lint, build, 배포를 반복해야 할 때
• 자격 증명, 데이터베이스, 외부 API, 사용자 데이터를 다뤄야 할 때
• 팀 코드 검토와 버전 관리가 필요할 때

자주 틀리는 부분

• Artifact를 만들기 전에 Code execution and file creation capability가 켜져 있는지 확인합니다.
• "코드"라는 이유만으로 Artifact를 제품 원본으로 취급하지 않습니다. 의존성과 실행 환경이 생기면 repository로 옮깁니다.
• 외부로 공유하기 전에는 공개 범위, 포함한 데이터, 연결한 서비스를 별도로 점검합니다.