Claude Code Artifacts를 사용하면 세션 컨텍스트(diffs, 로그, 결정 사항 등)를 호스팅된 페이지로 게시할 수 있습니다. 독자와 목적을 포함하여 프롬프트를 작성하세요. URL을 공유하기만 하면 됩니다. 별도의 구문(syntax)은 필요하지 않습니다.

핵심 요약 (Key Takeaways)

• Claude Code Artifacts를 사용하면 세션 컨텍스트(diffs, 로그, 결정 사항 등)를 호스팅된 페이지로 게시할 수 있습니다.
• 독자와 목적을 포함하여 프롬프트를 작성하세요.

변경 사항 — 구체적인 업데이트

Claude Code Artifacts는 2026년 6월에 Team 및 Enterprise 플랜을 대상으로 처음 베타 버전으로 출시되었습니다. 이 기능은 코딩 에이전트(coding-agent) 세션을 다른 사람이 브라우저에서 검토할 수 있는 호스팅된 웹 페이지로 변환해 줍니다. 주석이 달린 diffs가 포함된 풀 리퀘스트(pull-request) 워크스루, 로그로 구성된 인시던트(incident) 페이지, 또는 Claude가 작업하는 동안 업데이트되는 릴리스 체크리스트를 떠올려 보세요.

핵심 아이디어는 다음과 같습니다: Claude Code는 이미 세션에서 어떤 일이 일어났는지 알고 있습니다. 즉, 사용자가 무엇을 요청했는지, 어떤 파일을 읽었는지, 무엇을 변경했는지, 어떤 테스트가 실행되었는지, 그리고 연결된 MCP 도구로부터 어떤 데이터가 돌아왔는지 등을 알고 있습니다. Artifact는 이러한 컨텍스트를 독자를 위해 설계된 목적 맞춤형 페이지로 재구성합니다.

사용자에게 주는 의미

터미널 출력을 Slack 메시지에 붙여넣거나 상태 업데이트를 작성하는 데 20분을 소비한 적이 있다면, Artifacts가 그 워크플로우를 바꿔 놓을 것입니다. 더 이상 수동으로 요약할 필요가 없습니다. 대신 Claude에게 페이지를 구축하도록 프롬프트를 입력하면 됩니다.

원문의 주요 예시:

• diffs 뒤에 숨겨진 논리적 근거를 설명하는 풀 리퀘스트(pull-request) 워크스루
• 재현 단계, 근본 원인, 패치 및 테스트 증거가 포함된 버그 보고서
• 로그, 타임라인 및 복구 작업을 결합한 인시던트(incident) 페이지
• 완료된 작업과 남은 작업을 추적하는 릴리스 준비 체크리스트
• 심각도 및 영향받은 파일별로 그룹화된 보안 검토
• 기술적 진행 상황을 시각적 요약으로 변환한 이해관계자 업데이트

이 기능의 중심축은 커뮤니케이션입니다. 소스 코드를 보여주는 대신, 작업 세션을 독자를 위해 설계된 페이지로 변환합니다.

생성 방법 — 프롬프트 패턴

생성은 프롬프트(prompt) 중심입니다. 별도의 특수 구문은 없습니다. 그저 Claude Code에게 원하는 페이지를 요청하고, 의도한 독자가 누구인지 이름을 지정하기만 하면 됩니다.

좋은 프롬프트:

리뷰어를 위해 이 풀 리퀘스트 (pull request)를 설명하는 아티팩트 (artifact)를 생성해줘.
목표, 중요한 파일들, 의미 있는 디프 (diff) 섹션, 통과된 테스트, 그리고 내가 여전히 피드백을 원하는 두 가지 결정 사항을 보여줘.

더 나은 프롬프트 — 네 가지 질문에 답합니다:

1. 누가 읽는가? (코드 리뷰어, 엔지니어링 매니저, 고객 지원팀)
2. 무엇을 이해해야 하는가? (결론, 결정 사항, 또는 워크플로 (workflow))
3. 어떤 증거가 중요한가? (정확한 파일, 디프 (diff) 섹션, 테스트 결과, 로그)
4. 독자가 다음에 무엇을 해야 하는가? (승인, 피드백 제공, 인지하기)

예시:

이 인시던트 (incident)에 대한 아티팩트 (artifact)를 생성해줘. 타임라인, 우리가 발견한 증거, 근본 원인 (root cause), 수정 사항, 그리고 후속 작업들을 포함해줘. 디버깅 세션에 참여하지 않았던 엔지니어링 매니저가 읽기 쉽게 만들어줘.

반드시 알아야 할 현재의 제한 사항

아티팩트 (Artifacts)는 호스팅된 페이지이지, 소형 프로덕션 환경이 아닙니다. 이로 인해 다음과 같은 경계가 생깁니다.

1. 독립적인 형식 (Self-contained format). 출시 버전은 16 MiB의 페이지 용량 제한이 있으며, 외부 스크립트, 스타일, 폰트, 이미지 및 뷰 타임 (view-time) 네트워크 요청을 차단하는 엄격한 콘텐츠 보안 정책 (content security policy)을 적용합니다. 설명, 보고서, 다이어그램 및 대시보드에는 적합하지만, 라이브 백엔드나 제3자 API가 필요한 작업에는 부적합합니다.

2. 버전 기록은 영구적이지 않습니다. 컴플라이언스 API (Compliance API)는 최근에 게시된 약 20개의 버전을 노출합니다. 오래된 버전은 무기한 유지되지 않습니다. 중요한 소스 코드는 귀하의 리포지토리 (repository)에 보관하십시오.

3. 개인정보 보호 모델 변경 사항 (Privacy model changes). Artifact는 세션 컨텍스트(session context)—소스 코드, 로그, 내부 데이터—를 기반으로 구축됩니다. 게시하기 전에 생성된 페이지를 검토하십시오. Anthropic의 API 모델에는 owner, users, org, 그리고 public 읽기 모드가 포함되어 있습니다. URL을 통해 추측하기보다는 현재 활성화된 공유 설정을 직접 확인하십시오.

4. Artifact 대 프리뷰 배포 (Artifact vs preview deployment). 누군가가 실행 중인 프론트엔드 (frontend)를 직접 클릭해 보거나, 인증 (authentication)을 테스트하거나, 서버 측 통합 (server-side integration)을 확인해야 한다면 프리뷰 배포 (preview deployment)를 게시하십시오. 만약 무엇이 왜 변경되었는지 이해해야 한다면, Artifact가 종종 더 빠른 해답이 됩니다.

지금 바로 시도해 보세요

다음 Claude Code 세션에서 중요한 작업을 완료한 후, 다음과 같이 프롬프트(prompt)를 입력하십시오:

[독자 유형]을 위해 우리가 방금 수행한 내용을 요약하는 artifact를 생성해줘.
[특정 증거]를 포함해줘. 독자는 [특정 행동]을 해야 해.

게시하기 전에 생성된 페이지를 검토하십시오. URL을 공유하십시오. 검토자는 터미널 텍스트의 벽 대신 시각적인 요약을 받게 됩니다.

출처: dev.to

원문 게시지: gentic.news