Claude 아티팩트 사용법, 채팅 답변을 문서와 코드로 다루는 순서

Claude 아티팩트처럼 채팅 옆 독립 작업 패널에 문서 결과물이 표시된 노트북 화면 1

AI를 활용하여 생성한 이미지입니다.

Claude에게 문서나 코드를 부탁한 뒤 채팅창을 다시 찾느라 시간을 쓰고 있다면 아티팩트(Artifact)가 더 맞을 수 있습니다. 아티팩트는 대화 옆의 별도 영역에서 문서, 코드 조각, 시각화, 한 페이지 HTML 앱처럼 독립적인 결과물을 수정·복사·다운로드하는 흐름입니다.[1] 짧은 질문의 답과 계속 다듬을 작업물을 구분하는 것이 첫 단계예요.

기능이 모든 Claude 환경에서 동일한 것은 아닙니다. 일반 Claude, Claude Desktop, Claude Code, Claude Cowork는 결과물의 생성·게시·공유 방식과 이용 조건이 다를 수 있으므로, 사용 중인 앱과 요금제를 먼저 확인해야 합니다.[1][2][3]

일반 채팅과 아티팩트를 나누는 기준

하려는 일 아티팩트가 잘 맞는 경우 일반 채팅이 나은 경우
문서 안내문·기획서처럼 계속 수정할 결과물 한 문장 번역·짧은 답
코드 복사·실행·검토할 독립 코드 한 줄 문법 설명
웹 화면 한 페이지 HTML 초안·간단한 인터랙션 웹 기술의 개념 질문
공유 다른 사람이 보고 사용할 결과물 개인 메모나 민감한 원문

아티팩트로 만들기 전에 독자, 결과 형식, 반드시 들어갈 항목, 하지 말아야 할 일을 한 문장으로 정하세요. “문서 만들어 줘”보다 “초보자용 네트워크 점검표를 Markdown으로 만들고 각 단계에 확인 칸을 넣어 줘. 전문용어는 괄호로 설명해 줘”가 수정 기준을 만들기 쉽습니다.

처음 만드는 순서

  1. 결과물의 경계를 적습니다. 문서인지 코드인지, 파일로 내려받을지 웹에서 볼지 정합니다.
  2. 필수 조건을 먼저 전달합니다. 독자, 길이, 입력 형식, 금지할 정보, 출력 구조를 함께 적습니다.
  3. 아티팩트 창을 확인합니다. 채팅 답변과 별도의 결과물 영역에 표시되는지, 제목과 형식이 맞는지 봅니다.[1]
  4. 부분 수정으로 요청합니다. “3번째 표의 열을 두 개로 줄이고, 나머지 문장은 유지해 줘”처럼 범위와 유지할 부분을 함께 말합니다.
  5. 버전과 결과를 비교합니다. 버전 기능이 제공되는 환경이라면 이전 상태와 현재 상태를 비교한 뒤 필요한 버전을 선택합니다.[1][2]

한 번에 완벽한 결과를 요구하기보다 구조를 먼저 만든 다음 누락된 조건을 채우는 편이 안정적입니다. 문서는 문장보다 제목·목차·링크를 먼저 읽고, 코드는 입력값과 오류 처리부터 확인하세요.

복사·다운로드 뒤에 확인할 것

아티팩트 창에서 코드 보기, 내용 복사, 파일 다운로드를 할 수 있습니다.[1] 그러나 내려받은 파일이 완성된 제품이나 안전한 코드가 되는 것은 아닙니다. HTML은 외부 링크와 입력값을 확인하고, 코드는 실행 환경·파일 접근·네트워크 요청·의존성을 검토해야 합니다.

실행하기 전에는 실제 API 키, 비밀번호, 고객 자료를 넣지 말고 가짜 입력으로 범위를 확인하세요. 다른 사람이 공개한 아티팩트의 코드를 가져올 때도 출처와 변경 이력을 먼저 보고, 이해하지 못한 명령이나 외부 요청을 그대로 실행하지 않는 편이 안전합니다.

Publish와 Share를 구분하세요

Anthropic의 안내에 따르면 Free·Pro·Max에서 공개한 아티팩트는 링크를 가진 사람이 보고 상호작용할 수 있는 공개 결과물이 될 수 있고, Team·Enterprise에서는 조직 내부 공유 흐름을 사용할 수 있습니다.[4] 버튼 이름만 보고 비공개 문서라고 생각하지 마세요.

공유 전에는 결과물뿐 아니라 대화에 첨부한 파일, 예시 데이터, 이미지, 코드의 주석, 환경 변수와 로컬 경로까지 확인해야 합니다.[4] 개인정보·회사 자료·API 키가 들어 있으면 지우거나 비식별화하고, 링크를 받은 사람이 최신 버전까지 볼 수 있는지와 사용을 중단할 방법이 있는지도 확인하세요.

Claude Code와 Cowork를 사용할 때

Claude Code는 세션 결과물을 claude.ai의 라이브 페이지로 게시하고, 계속 업데이트되는 결과물이나 공유 범위를 관리하는 별도 흐름을 제공합니다.[2] 명령줄 세션에서 생성됐다는 이유로 코드가 자동 검증되는 것은 아니므로, 게시 전 로컬에서 변경 파일과 실행 명령을 확인하세요.

Claude Cowork의 최신 아티팩트 시스템은 특정 시점 이후 만들어진 결과물을 계정의 Artifacts 보기에서 저장·공유하고 웹에서 여는 흐름을 안내합니다. Pro·Max·Team·Enterprise 플랜에서 제공되더라도 최신 Claude Desktop·웹 환경과 조직 보안 설정에 따라 이용 조건이 달라질 수 있습니다.[3]

Cowork 아티팩트가 연결된 앱을 사용하거나 Claude에 질문하도록 구성됐다면, 보는 사람의 연결 앱과 권한이 관여할 수 있습니다. 만든 사람의 권한이 다른 사람에게 자동으로 이전된다고 생각하면 안 됩니다.[1][3] 특정 조직 설정에서는 업데이트된 시스템이 제공되지 않고 기존 라이브 아티팩트가 유지될 수 있다는 제한도 안내되어 있으므로, 회사 계정은 관리자 공지를 확인하세요.

작업물을 넘기기 전 검토할 항목

문서를 다른 사람에게 넘길 때는 본문만 읽지 말고 제목, 표, 링크, 날짜, 예시 데이터의 출처를 확인하세요. 코드라면 실행에 필요한 패키지와 환경 변수, 파일 쓰기 위치, 네트워크 요청, 오류 처리 경로를 목록으로 만들면 검토가 쉬워집니다. 결과물에 “초안”이나 “검토 필요” 표시가 없으면 받는 사람이 완성품으로 오해할 수 있으므로 사용 목적도 함께 적는 편이 좋습니다.

공개용 아티팩트와 내부 작업물은 같은 자료로 만들지 않는 것이 안전합니다. 공개 버전에는 가짜 입력과 최소 기능만 넣고, 내부 버전은 접근 권한과 보관 기간을 정하세요. 특히 회사 문서에서 복사한 표·스크린샷·주석·파일명에도 개인정보나 비밀이 남을 수 있으니 결과물을 만들기 전부터 공개용 자료를 따로 준비하세요.

작업이 끝난 뒤에도 공유 링크를 계속 관리해야 합니다. 프로젝트가 끝났거나 담당자가 바뀌면 누가 볼 수 있는지 다시 확인하고, 더 이상 필요하지 않은 공개 결과물은 게시 상태와 연결된 자료를 정리하세요. 다운로드한 파일을 메신저나 저장소에 다시 올릴 때는 원래 아티팩트의 공유 범위와 별개로 새로운 복사본이 생긴다는 점도 기억해야 합니다.

오류가 나면 범위를 줄이세요

  1. 오류 메시지와 발생한 입력을 먼저 보관합니다.
  2. 아티팩트 창에 오류 수정 기능이 보이면 메시지를 그대로 넣고 원인과 수정 범위를 요청합니다.[1]
  3. 반복되면 외부 연결·복잡한 데이터·스타일을 제거하고 최소한의 문서나 코드로 다시 만듭니다.
  4. 최소 예제가 동작한 뒤 기능을 하나씩 되돌립니다.
  5. 문서는 링크·목차를 읽고, 코드는 입력값이 바뀐 경우와 실패한 경우를 확인합니다.

오류 메시지가 사라진 것과 결과물이 요구사항을 충족하는 것은 다릅니다. 아티팩트가 보여 주는 미리보기와 내려받은 파일의 내용이 같은지, 외부 링크가 실제로 열리는지도 확인하세요.

자주 묻는 질문

모든 답변을 아티팩트로 만들어야 하나요?

아닙니다. 한 번 읽고 끝나는 번역·정의·짧은 답은 일반 채팅이 간단합니다. 수정·다운로드·공유할 결과물일 때 아티팩트를 선택하세요.

공유하면 첨부파일도 함께 공개될 수 있나요?

공유 범위에 대화의 첨부 자료나 결과물에 포함된 정보가 영향을 줄 수 있으므로, 공개 전 원문·주석·링크·권한을 직접 확인해야 합니다.[4] 민감한 자료는 처음부터 넣지 않는 편이 가장 안전합니다.

다운로드한 코드를 바로 실행해도 되나요?

바로 실행하지 마세요. 파일 접근, 외부 통신, 의존성 설치, 인증 정보 요구 여부를 먼저 읽고 가짜 데이터와 제한된 환경에서 확인하세요.

정리

아티팩트는 Claude의 답변을 반복 수정할 수 있는 작업물로 분리하는 기능입니다. 결과물의 목적과 형식을 먼저 정하고, 부분 수정·버전 비교·다운로드·공유를 순서대로 확인하세요. 앱·플랜별 차이와 공개 범위를 확인하고, 코드와 민감 자료는 사람이 마지막으로 검토해야 안전합니다.[1][4]

Sources

  1. [1] Anthropic Help Center: What are artifacts and how do I use them?
  2. [2] Claude Code Docs: Share session output as artifacts
  3. [3] Anthropic Help Center: Use artifacts in Claude Cowork
  4. [4] Anthropic Help Center: Publish and share artifacts

함께 읽을 글