Pagecast, 보고서 파일을 링크로 공유하기
Claude Code가 만든 보고서를 파일 첨부로 돌리지 않고, 바로 열 수 있는 링크로 넘길 수 있습니다.
보고서를 만든 뒤에도 공유 방식은 따로 정해야 합니다. Markdown 파일을 그대로 보낼지, HTML 파일을 압축해 첨부할지, 노션에 다시 붙여 넣을지 선택해야 하고, 내 브라우저에서 열린 화면은 다른 사람에게 보이지 않습니다.
Pagecast는 이 마지막 단계를 맡습니다. Claude Code가 만든 보고서 파일에 공유 주소를 붙여줍니다. 보고서는 Claude Code가 만들고, Pagecast는 그 파일을 웹에서 열 수 있게 올립니다.
정적 보고서는 Cloudflare Pages 링크로 공유합니다
Pagecast는 파일 하나로 열리는 정적 결과물을 올릴 때 쓰기 좋습니다. HTML 리포트와 마크다운 문서, Playwright나 Lighthouse 결과 보고서가 여기에 들어갑니다. Claude Code가 만든 작은 정적 페이지도 같은 방식으로 공유할 수 있습니다.
반대로 서버를 계속 켜 둬야 하는 웹앱이나, 아직 남에게 보여주면 안 되는 개인 메모는 발행하지 않는 편이 좋습니다. Pagecast는 링크를 만드는 도구입니다. 공유하면 안 되는 자료를 안전하게 관리하는 문서 관리 시스템은 아니니까요.
발행 위치도 먼저 확인해야 합니다. Pagecast 전용 서버가 아니라, 내 Cloudflare 계정의 Cloudflare Pages로 올라갑니다. Pagecast 보안 문서에 따르면 콘텐츠나 데이터를 저장하는 Pagecast 호스팅 백엔드는 없습니다. 관리자 화면과 로컬 서버는 내 컴퓨터의 127.0.0.1에서 열리고, 발행된 페이지는 내 Cloudflare Pages 프로젝트에 올라갑니다.
결국 확인할 곳은 Pagecast가 아니라 내 Cloudflare 계정입니다. 발행 전에 어느 계정의 Pages 프로젝트를 쓰는지 확인해 두면, 링크가 어디에 올라가는지 헷갈리지 않습니다.
Pagecast는 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 설치 문제를 다룰 때처럼 한 단계씩 확인하면 됩니다.
