홍드로이드의 야매코딩

Claude Code 아티팩트 공유 — 커넥터를 부르면 공개 링크가 막히고, 데이터는 보는 사람 계정으로 나갑니다 본문

AI & Vibe Coding

Claude Code 아티팩트 공유 — 커넥터를 부르면 공개 링크가 막히고, 데이터는 보는 사람 계정으로 나갑니다

홍드로이드 2026. 8. 17. 01:06
반응형

AI가 만든 결과를 남에게 보여줄 때, 터미널 출력을 통째로 복사해 붙여넣은 경험 다들 있으실 겁니다. 공식 문서에 그걸 웹페이지 링크 하나로 대체하는 기능이 있어서 읽어봤습니다. 차트나 비교표처럼 읽는 것보다 보는 게 빠른 결과에 쓰라는 건데, 살아 있는 데이터까지 붙일 수 있더군요. 다만 그 순간 공유 방식에 제약이 걸리고, 데이터를 가져오는 계정이 만든 사람이 아니라 보는 사람으로 바뀝니다.

📌 30초 요약

  • 작업 결과가 실시간으로 갱신되는 웹페이지가 됩니다. 링크를 열어둔 사람 화면도 같이 바뀝니다.
  • 연결한 도구에서 데이터를 끌어올 수 있는데, 그 호출이 보는 사람 계정으로 나갑니다.
  • 그래서 같은 페이지를 봐도 사람마다 다른 데이터가 보입니다. 페이지는 남의 자격증명을 못 봅니다.
  • 데이터를 붙인 페이지는 공개 링크로 못 나눕니다. 어떤 요금제에서도요.
  • 개인 요금제는 공개 링크가 유일한 공유 수단입니다. 조직 내 공유는 팀 요금제부터입니다.
  • 같은 내용이라도 페이지가 터미널보다 토큰을 더 씁니다. 문서가 직접 줄이는 법을 안내합니다.

터미널 글자가 아까울 때 씁니다

언제 쓰는지를 문서가 한 문장으로 정리합니다 — "한 줄씩 읽는 것보다 보고 만지는 게 나은 결과일 때." 예시로 든 것이 주석 달린 코드 변경 안내, 이미 끌어온 데이터로 만든 대시보드, 여러 안을 나란히 놓은 비교, 긴 작업이 도는 동안 채워지는 진행 기록입니다. 만드는 건 말로 시키면 됩니다.

# 그냥 말로 시키면 됩니다
> 이 PR을 훑어보는 페이지로 만들어줘. 변경분에 주석을 달아서.

# 오래 도는 작업의 진행 상황판
> 이 마이그레이션 계획을 체크리스트 페이지로 만들고,
  끝낼 때마다 체크하면서 갱신해줘.

# 최근 페이지 다시 열기
Ctrl + ]

처음 발행할 때는 확인을 한 번 받습니다. 이미 승인한 페이지를 다시 올릴 땐 안 묻고요. 제목과 탭 아이콘은 Claude가 알아서 정하는데, 원하는 게 있으면 말해두라고 안내합니다. 브라우저가 자동으로 열리는 게 싫으면 환경변수로 끌 수 있습니다.

보는 사람마다 다른 데이터가 보입니다

여기가 이 문서에서 가장 중요한 대목입니다. 페이지에 연결된 도구를 호출하는 구역을 넣으면, 만들 때 퍼온 스냅숏이 아니라 열 때마다 최신 데이터를 보여줍니다. 그런데 그 호출이 나가는 계정이 만든 사람이 아닙니다.

⚠️ 호출도 행동도 보는 사람 계정으로 나갑니다

문서 표현이 명확합니다 — 같은 대시보드를 열어도 두 사람이 서로 다른 데이터를 볼 수 있습니다. 각자의 계정이 접근할 수 있는 범위가 다르니까요. 페이지가 누구의 자격증명도 보지 못하고, 호출은 서비스가 대신 해줍니다. 여기에 한 겹 더 있는데 — 부수효과가 있는 행동, 예컨대 메시지를 올리거나 이슈를 고치는 버튼도 누른 사람 계정으로 실행됩니다. 그리고 첫 호출 전에 보는 사람에게 허락을 묻고, 거절하면 그 구역만 비어 보입니다. 그래서 문서가 팁을 하나 답니다 — 각 구역에 "무엇을 연결해야 하는지" 안내 문구를 넣어두라고요. 안 그러면 상대는 빈 화면만 보게 됩니다.

설계가 깔끔합니다. 외부 사건을 세션으로 밀어넣는 기능을 정리하면서 "허용목록에 넣은 사람은 내 도구 사용을 승인할 수 있다"는 경고를 봤는데, 이쪽은 반대로 권한이 절대 넘어가지 않게 만들어져 있습니다. 같은 회사가 미는 쪽과 당기는 쪽에서 권한을 다르게 다룬다는 게 흥미로웠습니다. 참고로 내 컴퓨터에 설정한 로컬 도구는 만들 때만 쓰이고, 발행된 페이지는 못 부릅니다.

공유 범위가 요금제로 갈립니다

요금제 조직 안에서 공유 공개 링크 같이 고치기
개인 요금제 없음 유일한 공유 수단 불가
팀 요금제 사람 지정 또는 전원 기본 꺼짐. 관리자가 켬 가능
기업 요금제 역할별로도 제한 가능 기본 꺼짐. 관리자가 켬 가능

🔗 두 규칙을 곱하면 개인 요금제에선 못 나눕니다

규칙 두 개를 따로 읽으면 안 보이는데, 곱하면 결론이 하나 나옵니다. 첫째, 데이터를 끌어오는 페이지는 어떤 요금제에서도 공개 링크로 못 나눕니다. 둘째, 개인 요금제에서는 공개 링크가 유일한 공유 수단입니다. 그러면 개인 요금제에서 만든 살아 있는 대시보드는 영원히 나만 볼 수 있습니다. 남에게 보여줄 생각이라면 만들 때 데이터를 박아 넣은 정적 페이지로 가야 한다는 뜻이죠. 문서가 이 결론을 한 줄로 적어주진 않아서, 두 절을 오가며 맞춰봐야 했습니다.

페이지가 할 수 없는 것

문서가 "이건 앱이 아니라 작업의 포착물"이라고 선을 긋습니다. 엄격한 보안 정책이 걸린 채로 제공되기 때문인데, 제약이 꽤 셉니다.

제약 실제로 어떻게 되나
외부 요청 구글 폰트와 커넥터 데이터 말고는 전부 차단. 이미지도 파일에 박아 넣음
백엔드 없음 폼에 입력한 값을 저장 못 함. 보는 사람 인증도 스스로 못 함
한 페이지 상대 링크가 안 풀림. 여러 절은 페이지 안 앵커로 처리
크기 16메가바이트 제한. 발행 실패의 주범은 큰 이미지

비용 이야기도 문서가 먼저 꺼냅니다 — 같은 내용이라도 꾸민 페이지가 터미널 글자보다 출력 토큰을 더 씁니다. 주범 셋은 인라인 CSS, 조작용 자바스크립트, 특히 파일에 박아 넣은 이미지고요. 줄이는 법도 셋을 제시합니다 — 그림은 벡터나 HTML·CSS로, 필요 없는 조작 기능은 빼고, 큰 데이터는 통째로 넣지 말고 요약하라는 것. 하루에 얼마나 쓰는지를 재봤을 때와 같은 결론입니다 — 보기 좋은 출력에는 값이 붙습니다.

🚫 아예 못 쓰는 조건이 다섯 있습니다

조건이 하나라도 안 맞으면 로컬 파일만 쓰고 링크를 못 만듭니다.요금제(무료는 제외) ②계정 로그인으로 붙은 세션이어야 함 — API 키·게이트웨이 토큰·클라우드 자격증명으로 붙었으면 불가 ③앤트로픽 API 경유만(아마존·구글·마이크로소프트 클라우드는 불가) ④조직에 고객 관리 암호화 키나 의료정보 보호, 무보존 정책이 켜져 있으면 불가 ⑤버전. 특히 ④가 눈에 띕니다 — 데이터를 안 남기기로 한 조직에서는 이 기능 자체가 성립하지 않습니다. 페이지가 회사 서버에 저장되는 물건이니까요. 반대로 보관 기간은 관리자가 정할 수 있고, 비공개인 것과 공유된 것에 각각 다른 기간을 걸 수 있습니다.

🧾 정직하게 — 이 글의 한계

  • 커넥터를 붙인 페이지를 남에게 열어보게 하진 못했습니다. 계정이 둘 필요해서, "사람마다 다른 데이터"는 문서 설명을 옮긴 것입니다.
  • 토큰이 얼마나 더 드는지 숫자는 없습니다. 문서도 "더 쓴다"까지만 말하고 배수를 안 줍니다. 제가 잰 범위에도 없습니다.
  • 버전 경계가 여럿입니다. 커넥터 호출과 디자인 처리가 각각 특정 버전부터라, 옛 버전이면 그냥 조용히 다르게 동작합니다.
  • 공유 정책은 조직 설정에 좌우됩니다. 여기 적은 기본값이 회사 계정에서는 다를 수 있습니다.

🗺️ AI 지출 전체 지도

보기 좋은 결과물은 그만큼 출력 토큰입니다. 문서가 스스로 절감법을 안내할 정도고요. 구독과 종량제 선택부터 캐시, 모델 조합, 상한 걸기까지 지금까지 확인한 것들을 일곱 단계 지도 한 장으로 묶어뒀습니다.

자주 묻는 것

Q. 우리 회사 디자인에 맞출 수 있나요?

됩니다. Claude가 페이지를 만들 때 프로젝트에 이미 있는 디자인 규칙부터 찾아봅니다. 그래서 색·글꼴·간격을 프로젝트 메모리 파일이나 테마 파일에 적어두면 그걸 따릅니다. 우선순위도 명확한데 — 내 프롬프트 > 우리 디자인 규칙 > Claude의 기본 선택 순입니다. 어느 파일에 무엇을 적는지를 정리해 뒀으니 자리를 잡는 데 참고하시고요. 글꼴은 구글 폰트만 외부에서 불러올 수 있고, 나머지는 파일에 박아 넣습니다.

Q. 다른 세션에서 같은 페이지를 고치려면요?

주소를 줘야 합니다. 안 주면 새 세션은 무조건 새 페이지를 만듭니다 — 고쳐달라고 해도요. 팀 요금제 이상에서 편집자로 지정된 사람도 같은 방식입니다. 자기 세션에서 그 주소를 주면 Claude가 현재 내용을 가져와 자기 변경을 얹어 다시 발행합니다. 열어둔 사람 화면은 그때마다 바뀌고요. 발행할 때마다 버전이 쌓여서, 보는 사람에게 어느 버전을 보여줄지 고를 수 있습니다.

Q. 페이지에서 정한 결과를 다시 세션으로 가져올 수 있나요?

문서가 권하는 패턴이 하나 있습니다 — "프롬프트로 복사" 버튼을 페이지에 넣으라는 것. 예로 든 게 이슈를 카드로 만들어 지금·다음·나중·제외 칸에 끌어다 놓는 분류판인데, 다 정리하고 버튼을 누르면 최종 순서가 붙여넣을 수 있는 글로 나옵니다. 페이지에서 눈으로 정하고 결과만 터미널로 되돌리는 거죠. 백엔드가 없어서 페이지가 스스로 저장을 못 하니, 사람이 옮기는 경로를 만들어두는 셈입니다.

✨ 오늘 확인한 것 정리

터미널 출력을 살아 있는 웹페이지 링크로 바꾸는 기능입니다. 데이터를 붙이면 열 때마다 갱신되는데, 그 호출과 행동이 전부 보는 사람 계정으로 나갑니다 — 그래서 같은 페이지를 봐도 사람마다 다른 데이터가 보입니다. 대신 그런 페이지는 공개 링크로 못 나눠서, 개인 요금제에서는 결국 나만 보게 됩니다. 그리고 꾸민 페이지는 그만큼 토큰을 더 씁니다.

※ 확인 경로(2026년 8월 17일 기준): code.claude.com/docs/en/artifacts. 우리말 표현은 제가 옮긴 것입니다.

※ 요금제별 공유 범위와 관리자 설정은 조직 정책에 따라 다를 수 있고, 일부 기능은 특정 버전 이상에서만 동작합니다.

반응형
Comments