Pagecast, 보고서 파일을 링크로 공유하기
Claude Code가 만든 보고서를 파일 첨부로 돌리지 않고, 바로 열 수 있는 링크로 넘길 수 있습니다.
Claude Code로 보고서 만드는 것까지는 빨라졌습니다. 그런데 막상 공유하려는 순간 손이 멈춥니다. 마크다운 파일을 그대로 보낼지, HTML 파일을 압축해서 첨부할지, 노션에 다시 붙여넣을지 정해야 합니다. 내 브라우저에서 열린 화면은 나만 볼 수 있으니까요.
Pagecast는 이 마지막 단계를 맡습니다. Claude Code가 만든 보고서 파일에 공유 주소를 붙여줍니다. 보고서는 Claude Code가 만들고, Pagecast는 그 파일을 웹에서 열 수 있게 올립니다.
보고서는 Claude Code가 만들고, Pagecast는 그 파일을 웹에서 열 수 있게 올립니다.
보고서 파일을 웹 링크로
HTML 리포트, 마크다운 문서, Playwright나 Lighthouse 결과 보고서처럼 파일 하나로 끝나는 작업에 잘 맞습니다. Claude Code가 만든 작은 정적 페이지도 올릴 수 있습니다.
반대로 서버를 계속 켜둬야 하는 웹앱이나, 아직 남에게 보여주면 안 되는 개인 메모는 빼는 게 좋습니다. Pagecast는 공유를 쉽게 만드는 도구입니다. 공유하면 안 되는 자료까지 안전하게 감춰주는 문서 관리 시스템은 아닙니다.
올라가는 곳도 알아둘 필요가 있습니다. Pagecast 전용 서버가 아니라, 내 Cloudflare 계정의 Cloudflare Pages로 올라갑니다. Pagecast 보안 문서에는 콘텐츠나 데이터를 저장하는 Pagecast 호스팅 백엔드가 없다고 적혀 있습니다. 관리자 화면과 로컬 서버는 내 컴퓨터의 127.0.0.1에서 열리고, 발행된 페이지는 내 Cloudflare Pages 프로젝트에 올라갑니다.
그러니까 어디론가 모르는 서버에 맡기는 구조는 아닙니다. 내 Cloudflare 계정으로 나갑니다. 이 정도는 알고 시작하면 됩니다.
처음 켜보기
준비물은 Node.js 20 이상과 Cloudflare 계정입니다. 전역 설치 없이 바로 실행합니다.
npx pagecast
실행하면 로컬 앱이 열립니다. 관리자 화면은 http://127.0.0.1:4173, 로컬 미리보기는 http://127.0.0.1:4174를 씁니다. 처음에는 관리자 화면에서 Cloudflare를 연결합니다. Pagecast는 account:read, user:read, pages:write 범위의 Wrangler OAuth를 사용합니다.
터미널에서 먼저 설정하려면 아래 명령을 씁니다.
npx pagecast pages setup --project pagecast
Cloudflare 계정이 여러 개라면 --account <account-id>를 붙이라는 안내가 있습니다. 여기서 막히면 명령어를 계속 바꿔가며 시도하지 않아도 됩니다. Claude Code에게 현재 오류를 보여주고, 어디까지 연결됐는지 확인해달라고 하면 됩니다. 12강에서 MCP 설치 문제를 다룰 때처럼 한 단계씩 가면 됩니다.






































