Artifacts로 세션 결과 공유
기준일: 2026-07-26
난이도: 중급
공식 기준: Share session output as artifacts
Artifact는 Claude Code 세션 작업을 claude.ai의 인터랙티브 웹 페이지로 게시하는 기능입니다. 세션이 진행되면 같은 URL이 제자리에서 갱신됩니다. Pro / Max / Team / Enterprise, claude.ai 로그인 세션이 필요합니다.
핵심 개념
| 항목 | 내용 |
|---|---|
| 무엇 | 단일 self-contained HTML/Markdown 페이지 (백엔드·멀티 라우트 없음) |
| 언제 | 터미널 텍스트보다 시각·비교·대시보드가 나을 때 |
| 최소 CLI | v2.1.183+ (Desktop은 공식 문서 버전표 확인) |
| 미지원 | API key only, LLM gateway token, Bedrock/Vertex/Foundry 세션, CMEK/HIPAA/ZDR 조직 등 |
| 단축키 | Ctrl+] 최근 artifact 다시 열기 |
페이지는 외부 호스트 요청이 CSP로 막히고, 라이브 데이터의 예외는 뷰어 계정 MCP connector 호출입니다 (v2.1.209+, Pro/Max/Team/Enterprise).
선택 기준
적합한 예:
- PR 주석 달린 diff 워크스루
- 조사 타임라인·체크리스트
- 레이아웃/구현안 나란히 비교
- 팀원에게 터미널 붙여넣기 대신 링크
부적합한 예: 폼 저장 백엔드가 필요한 내부 앱 → 자체 호스팅.
실습
Make an artifact that walks through this PR with the diff annotated inline.
Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.
최초 게시 시 권한 확인 프롬프트가 뜹니다. 재게시 승인된 artifact는 추가 프롬프트 없이 같은 URL로 갱신됩니다.
다른 세션에서 갱신:
Update https://claude.ai/code/artifact/5fbea6f3-... with today's numbers.
라이브 MCP 대시보드 예:
Build a dashboard artifact of our open pull requests that pulls the live list
through my GitHub connector when the page loads.
- 커넥터 호출은 보는 사람 계정 기준
- 공개 링크와 connector-backed artifact는 호환되지 않음
- 자동 브라우저 오픈 끄기:
CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0
끄기
| 방법 | 설정 |
|---|---|
| settings | "disableArtifact": true |
| env | CLAUDE_CODE_DISABLE_ARTIFACT=1 |
| permissions | Artifact를 deny |
조직 Owner는 admin settings에서 Artifacts / external sharing / connector calls 토글을 제어합니다.
도구에 입력할 프롬프트
이번 조사 결과를 팀이 볼 수 있는 artifact 페이지 초안으로 만들어줘.
민감 정보·시크릿은 제외하고, 근거 파일 경로와 다음 액션만 남겨.
게시 전에 로컬 HTML 초안을 먼저 보여줘.
체크리스트
- claude.ai 로그인과 플랜 가용성을 확인했다.
- 공유 범위(개인 / org / public)를 정했다.
- connector-backed 페이지면 뷰어 connector·권한을 안내했다.
- 16 MiB 렌더 한도와 토큰 비용(인라인 이미지)을 의식했다.
다음 단계
- MCP 통합에서 claude.ai connectors를 연결합니다.
- 최신 운영 기능 맵에서 공유·자동화 표면을 비교합니다.
- 데이터 사용 정책과 조직 retention을 확인합니다.