Claude Code 아티팩트 — 세션 결과를 공유 페이지로

개발 세션의 결과물을 공유 가능한 웹 페이지로 만들 수 있게 됐습니다.

무엇을 해결하나

터미널에서 나온 좋은 분석 결과를 팀에 공유하려면 지금까지는 이런 과정을 거쳤습니다.

1. 터미널 출력을 복사
2. 문서 도구에 붙여넣기
3. 표와 코드 블록 서식이 깨진 것을 수동 정리
4. 링크 공유

아티팩트는 이 과정을 없앱니다. 결과가 곧 페이지가 됩니다.

잘 맞는 용도

• 아키텍처 분석 리포트 — 다이어그램과 표가 포함된 구조 설명
• 코드 리뷰 요약 — 발견 사항을 심각도별로 정리한 대시보드
• 온보딩 문서 — 저장소 구조를 훑어 만든 안내 페이지
• 의사결정 자료 — 여러 접근법을 비교한 표

특히 시각적으로 봐야 이해되는 것에 효과적입니다. 텍스트로 설명하면 길어지는 의존 관계나 데이터 흐름 같은 것입니다.

주의할 점

기본은 비공개이지만, 공유 링크를 만들면 그 링크를 가진 사람이 볼 수 있습니다. 다음은 페이지로 만들기 전에 한 번 더 생각하세요.

• 사내 시스템 구조가 상세히 드러나는 다이어그램
• 실제 데이터가 포함된 분석 결과
• 아직 공개되지 않은 제품 정보

운용 요령

• 수명을 정하세요 — 일회성 분석 결과가 계속 남아 있으면 나중에 낡은 정보로 오해를 부릅니다.
• 원본 근거를 남기세요 — 페이지에 결론만 있으면 나중에 검증할 수 없습니다. 어느 커밋 기준인지 적어 두세요.
• 문서 도구를 대체하지는 않습니다 — 지속적으로 갱신할 문서는 기존 위키에 두는 편이 낫습니다.