Claude Code가 사이트를 만들면 명령어 하나로 공개됩니다. "이걸 배포해 줘"라고 요청하면 npx -y lobsite --yes를 실행하여 빌드된 폴더를 찾아 업로드하고, 주소와 사이트를 유지할 링크가 담긴, Claude가 전달할 줄을 출력합니다. 계정도, 로그인 확인도, 먼저 작성할 구성 파일도 없습니다.
작동 방식
- Claude Code에게 빌드와 배포를 요청하세요. 빌드(
npm run build등)를 실행한 다음 프로젝트 폴더에서npx -y lobsite --yes를 실행합니다. - CLI는 Claude Code 아래에서 실행됨을 인식하므로(Claude Code가 설정하는
CLAUDECODE변수로) 질문하지 않고 색상이나 스피너 없는 일반 텍스트 줄을 출력합니다. - Claude가 마지막 줄을 전달합니다. 공개 URL, 임시 사이트 만료 시점, 가져오기 링크입니다. 링크를 열고 로그인하면 사이트를 유지하며 주소는 그대로입니다.
프로젝트의 배포 방식으로 만들기
프로젝트의 CLAUDE.md에 한 줄을 추가하면 모든 세션이 말하지 않아도 같은 방식으로 배포합니다.
Deploy with `npx -y lobsite --yes` and relay the "Tell the user:" line from the output.
첫 배포에서 사이트 이름과 폴더가 담긴 lobsite.toml이 작성됩니다. 이를 커밋하면 어떤 세션에서든 다음 배포가 새 사이트를 만들지 않고 같은 사이트를 업데이트합니다.
/deploy 명령어
커스텀 슬래시 명령어를 사용하면 한 번에 실행할 수 있습니다. 다음을 .claude/commands/deploy.md로 저장하세요.
Build the site, then deploy it with `npx -y lobsite --yes`.
If the build or the deploy fails, read the error's fix line and follow it.
When it succeeds, tell me the "Tell the user:" line word for word.
그런 다음 /deploy를 입력하세요. 매번 권한을 묻지 않고 실행하려면 .claude/settings.json에서 명령을 허용하세요.
{ "permissions": { "allow": ["Bash(npx -y lobsite:*)"] } }
또는 MCP 서버
MCP 서버는 Claude Code에 셸 명령 대신 도구를 제공합니다. deploy, list_sites, list_deploys, rollback, promote, whoami입니다.
claude mcp add lobsite -- npx -y lobsite@latest mcp
이를 사용하면 "사이트를 어제 배포로 롤백해 줘"도 작동합니다. Claude가 배포를 나열하고 말한 것을 승격합니다. 로그인과 사이트 삭제는 의도적으로 도구가 아닙니다. 전자는 사람이 브라우저에 있어야 하고, 후자는 되돌릴 수 없기 때문입니다. 자세한 내용은 MCP 페이지를 참고하세요.
에이전트에서 실행하면 질문하지 않으며, URL과 가져오기 링크가 담긴 Tell the user: 줄을 출력합니다.
코딩 에이전트에는 npx lobsite mcp, 채팅 어시스턴트에는 lobsite.com/api/mcp.
파일은 해시로 저장됩니다. 변경되지 않은 사이트를 다시 배포하면 0바이트가 업로드됩니다.
공개 전에 미리 보세요. 리디렉션까지 포함해 클릭 한 번으로 롤백합니다.
계정 없는 배포는 6시간 동안 공개됩니다. 가져오기 링크로 무료로 유지할 수 있습니다.
리디렉션, 헤더, 폼은 lobsite.toml에 있으며 각 배포와 함께 이동합니다.
Claude Code에서 배포: Lobsite와 GitHub Pages
| Lobsite | GitHub Pages | |
|---|---|---|
| 첫 배포 전 | 아무것도 없음: 가져올 때까지 사이트가 6시간 유지 | GitHub 계정, 저장소, Pages 활성화 |
| Claude가 실행하는 것 | 명령어 하나 | 커밋, 푸시, 빌드 단계를 위한 Pages 워크플로 |
| 과정 중 질문 | 에이전트 아래에서는 없음 | Git이 자격 증명을 요청할 수 있음 |
| 업로드 | 변경된 파일만 | 매번 빌드 전체 |
| 배포 미리보기 | --preview로 자체 URL |
기본 제공 안 됨 |
| 커스텀 도메인 | 예, 무료 | 예, 무료 |
| 비공개 소스 | 빌드된 파일만 업로드 | 비공개 저장소의 Pages는 유료 GitHub 플랜 필요 |
프로젝트가 이미 GitHub에 있고 커스텀 도메인이 있다면 GitHub Pages도 좋은 선택입니다. Lobsite는 지금 있는 세션에서 바로 링크가 필요할 때 적합합니다.
자주 묻는 질문
Claude Code로 배포하려면 계정이 필요한가요?
아니요. 계정 없이 사이트는 6시간 동안 유지되며 Claude가 사이트를 유지할 가져오기 링크를 줍니다. 내 계정으로 배포하려면 직접 npx lobsite login을 한 번 실행하세요. 브라우저가 열려 로그인하며, 에이전트가 대신할 수 없습니다.
어떤 폴더를 배포하나요?
dist/, build/, out/, _site/, public/ 중 처음 존재하는 폴더 또는 지정한 폴더(npx -y lobsite --yes site/)입니다. 선택은 lobsite.toml에 저장됩니다.
.env 파일이 업로드되나요?
아니요. 시크릿 파일(.env*, 개인 키, .npmrc 등)은 제거하거나 .lobsiteignore에 나열할 때까지 오류로 배포를 중단합니다. 에이전트에서 절대 --include-secrets를 전달하지 마세요.
Claude Code가 공개 사이트를 변경하지 않고 미리보기를 배포할 수 있나요?
네. npx -y lobsite --yes --preview는 배포에 자체 URL을 줍니다. 나중에 npx lobsite promote <id> 또는 MCP의 promote 도구로 승격하세요.
배포가 실패하면 Claude에게 무엇이 보이나요?
무슨 일이 일어났는지, 왜인지, 무엇을 해야 하는지 알려 주는 오류와 절대 바뀌지 않는 코드입니다. 기계가 읽을 수 있는 출력에는 --json을 추가하세요. 오류를 참고하세요.