| 일 | 월 | 화 | 수 | 목 | 금 | 토 |
|---|---|---|---|---|---|---|
| 1 | 2 | 3 | 4 | 5 | ||
| 6 | 7 | 8 | 9 | 10 | 11 | 12 |
| 13 | 14 | 15 | 16 | 17 | 18 | 19 |
| 20 | 21 | 22 | 23 | 24 | 25 | 26 |
| 27 | 28 | 29 | 30 |
- 바이브코딩
- Gemini
- 무료로 시작하기
- Claude
- 자동화
- claude code
- 홍드로이드
- AI 에이전트 개발
- 안드로이드
- 안드로이드 스튜디오
- AI 에이전트
- ai 뉴스
- claudecode
- LLM
- 개발 생산성
- 실무
- Anthropic
- 오픈모델
- OpenAI
- 개발환경
- 카드 없이
- 무료 ai
- MCP
- 클로드코드
- 개발자 도구
- ai에이전트
- AI 코딩
- 클로드 API
- Android Studio
- Android
- Today
- Total
홍드로이드의 야매코딩
Claude Code 아티팩트 공유 — 커넥터를 부르면 공개 링크가 막히고, 데이터는 보는 사람 계정으로 나갑니다 본문
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. 우리말 표현은 제가 옮긴 것입니다.
※ 요금제별 공유 범위와 관리자 설정은 조직 정책에 따라 다를 수 있고, 일부 기능은 특정 버전 이상에서만 동작합니다.
'AI & Vibe Coding' 카테고리의 다른 글
| Claude Code 딥링크 — 클릭해도 실행은 안 되고, 깃허브에서는 링크가 사라집니다 (0) | 2026.08.17 |
|---|---|
| Claude Code 백그라운드 세션 — 커밋과 푸시를 안 묻고 하고, main만은 건드리지 않습니다 (0) | 2026.08.17 |
| Claude Code 설정 파일 지도 — 커밋할 것과 아닌 것이 갈리고, 목록에 없는 파일도 있습니다 (0) | 2026.08.17 |
| Claude Code 워크트리 병렬 작업 — 기본은 main에서 갈라지고, 확인 못 하는 명령은 그냥 거부합니다 (0) | 2026.08.16 |
| Claude Code 설정이 안 먹힐 때 — 비슷한 파일이 두 개고, 하위 폴더는 읽을 때만 로드됩니다 (0) | 2026.08.16 |
