Claude Code로 웹사이트를 게시하는 방법1 min read
Reading Time: 6 minutes귀하의 사이트가 localhost에서 실행되고 클라이언트가 링크를 요청하면 Claude Code는 구현이 완료되었다고 말합니다. 누락된 단계는 배포입니다. Claude Code를 사용하여 웹 사이트를 게시하려면 먼저 재현 가능한 로컬 빌드를 설정하고 실제 출력을 테스트한 후 호스트 또는 아티팩트 게시 워크플로를 선택하세요. Claude Code는 코딩 에이전트일 뿐 로컬 파일이 이미 공개 웹에서 사용 가능하다는 것을 보장하지는 않습니다.
여러 사람이나 에이전트가 동일한 사이트를 출시하기 전에 검토해야 하는 경우 문서화된 Claude Code에서 AgentGrid.io 연결 경로를 읽어보세요.. 팀에 이미 Git 기반 배포가 있는 경우 대신 해당 경로를 유지하세요.
Claude Code 및 AgentGrid.io를 사용하여 웹사이트를 게시하는 방법
1. Claude Code를 코딩 에이전트로 연결
AgentGrid.io 작업 공간을 열고 Claude Code에게 실행하라고 지시하세요. npx @animaapp/cli@latest login. 확인 링크와 단축 코드를 받습니다. 링크를 열고 해당 이름, 작업 공간 범위 및 기능을 승인합니다. 개인 초안을 준비하려면 읽고 쓰는 것만으로도 충분합니다. 별도의 결정을 위해 게시를 예약하세요. 이 경로는 Claude Code의 터미널 가능 환경을 위한 것입니다. 일반 Claude 채팅 앱은 대신 Claude 디렉터리의 AgentGrid.io 커넥터를 사용하므로 해당 커넥터를 설치하는 것은 Claude Code의 자체 ID 및 액세스를 확인하는 것을 대체하지 않습니다.

2. 작업 중인 웹사이트를 앱 아티팩트로 공유
Claude Code가 사이트를 생성하면 프로젝트 소스와 필요한 자산을 승인된 AgentGrid.io 작업 공간에 앱으로 배치하도록 요청한 다음 아티팩트 URL을 반환합니다. 명시적으로 말하세요: “이것을 비공개 초안으로 보관하세요. 아직 게시하지 마세요.” 링크를 열고 글꼴, 이미지, 경로 및 상호 작용을 포함하여 로컬 프로젝트에 대해 렌더링된 결과를 확인합니다. 전송된 소스에서 비밀, 종속성 폴더 및 생성된 빌드 출력을 유지합니다. 연결하기 전에 Claude Code가 작동하고 클레임 링크를 반환한 경우 클레임되지 않은 미리 보기를 영구 팀 아티팩트로 처리하는 대신 해당 흐름을 통해 소유권을 가져옵니다.

3. 공유 버전에 대한 피드백 제공
데스크톱 및 모바일 너비에서 아티팩트를 검토하고 기본 클릭 유도 문구, 탐색, 링크 및 양식 동작을 테스트합니다. AgentGrid.io 검토에서 Claude Code가 실행 가능한 컨텍스트를 갖도록 관련 요소에 설명을 첨부합니다. 팀원이 비공개 URL을 열려면 먼저 작업 공간에 액세스할 수 있어야 합니다. 요청된 변경 사항이 포함된 정확한 URL을 Claude Code에 다시 붙여넣고 두 번째 초안을 작성하는 대신 동일한 아티팩트를 업데이트하도록 요청하세요. 새 기록 항목과 렌더링된 미리 보기를 검사합니다. Claude Code의 로컬 파일이 변경되더라도 아티팩트가 업데이트되었음을 자동으로 증명하지 않습니다.
4. 실제로 검토한 버전을 게시합니다.
팀이 로그오프하면 AgentGrid.io의 게시 제어를 사용하여 공개 사이트를 만들고 해당 URL을 열어 결과를 확인합니다. 게시는 작업공간 범위 아티팩트 링크를 공유하는 것과 다르며 누구나 로그인하지 않고도 공용 배포를 방문할 수 있습니다. 나중에 Claude Code에 아티팩트 수정을 요청하는 경우 업데이트를 게시하기 전에 새 초안을 확인하세요. 저장된 편집 내용은 공개 버전을 자동으로 대체하지 않습니다. 라이브 사이트를 중단해야 하는 경우 게시 취소는 추가 작업을 위해 아티팩트와 해당 버전 기록을 보존하면서 공개 액세스를 제거합니다.

1. 올바른 프로젝트 디렉토리에서 시작
기존 저장소에서 Claude Code를 열거나 소규모 웹사이트를 위한 새 폴더를 만듭니다. 어떤 프레임워크, 콘텐츠 소스, 제약 조건이 적용되는지 알려주세요. 프롬프트, 소스 파일, 스크린샷에 대한 비밀을 유지하세요.
이 저장소에서는 자전거 작업장인 North Pier Repair를 위한 반응형 웹사이트를 구축합니다. 페이지: 홈, 서비스, 도서. 기존 디자인 토큰과 로고를 활용하세요. 가격이나 고객 견적을 꾸며내지 마십시오. 예약 버튼이 README.md의 승인된 일정 URL을 가리키도록 만드세요. 액세스 가능한 탐색, 의미 있는 대체 텍스트, 페이지별로 고유한 제목 및 메타 설명, 모든 양식에 대한 명확한 비어 있음 또는 오류 상태를 추가합니다. 파일을 변경하기 전에 실행할 명령과 구현에 대한 개요를 작성하세요. 배포하지 마십시오.
Claude Code가 제안한 계획, 특히 종속성 및 빌드 구성에 대한 변경 사항을 검토하세요. 설정, 미리보기, 빌드 및 배포 지침이 포함된 README를 남겨달라고 요청하세요. 미래의 팀원은 채팅 기록의 세부 정보를 복구하지 않고도 프로젝트를 실행할 수 있어야 합니다.
2. 사이트를 실행하고 빌드된 출력을 테스트합니다.
프로젝트의 패키지 관리자를 사용하여 Claude Code 설치 종속성을 확보하고 테스트 및 빌드 명령을 실행합니다. 개발 서버를 시작하고 미리보기를 직접 엽니다. 합격 컴파일은 텍스트가 올바른지 또는 모바일 메뉴를 사용할 수 있는지 여부를 알려주지 않습니다.
기존 Lint, 테스트 및 프로덕션 빌드 명령을 실행합니다. 명령 실패 및 관련 오류를 보고하고, 이 웹사이트 작업으로 인해 발생한 문제만 수정한 다음, 로컬 미리보기 지침을 보여주세요. 좁은 폭과 넓은 폭으로 서비스 페이지를 확인해보세요. 배포 설정을 변경하거나 아무것도 게시하지 마세요.
개발 중에는 작동하지만 정적 빌드 후에는 실패하는 상대 이미지 경로, 환경 종속 콘텐츠, 양식 작업 및 경로에 주의하세요. 개인 데이터를 수집하는 경우 배포하기 전에 개인정보 보호 및 보안 검토를 담당하는 사람을 참여시키세요.
어떤 종류의 사이트를 게시하고 있나요?
정적 포트폴리오 또는 캠페인 페이지는 종종 파일에 내장되어 정적 사이트 서비스에 의해 호스팅될 수 있습니다. 서버 경로, 데이터베이스, 인증 또는 결제 워크플로가 있는 사이트에는 해당 서비스를 실행하고 해당 자격 증명을 보호하는 환경이 필요합니다. 브라우저에서 실행되는 부분과 서버가 필요한 부분을 설명하려면 Claude Code에 문의하세요. 빌드 출력 디렉터리만으로는 예약 양식이 실제로 제출물을 저장하는지 여부를 알 수 없습니다.
호스트를 선택하기 전에 Claude Code가 프로젝트의 빌드 명령, 출력 경로, 런타임 요구 사항 및 외부 서비스를 나열하도록 하세요. 해당 목록을 이미 사용하고 있는 호스트와 비교하세요. 사이트가 회사 도메인에 유지되어야 하는 경우 해당 도메인을 제어하는 사람과 DNS 및 인증서 소유권을 계획하세요. 목표가 단일 대화형 설명 페이지인 경우 Claude Code 아티팩트로 충분할 수 있습니다. 이는 다중 경로 생산 애플리케이션을 대체하지 않습니다.
3. 일반 호스팅 경로를 통해 배포
간단한 경로는 검토된 코드를 호스팅 서비스에 연결된 저장소에 커밋한 다음 해당 서비스의 지침에 따라 배포하는 것입니다. 올바른 빌드 명령, 출력 디렉터리, 필수 환경 변수 및 사이트에 서버 측 동작이 필요한지 여부를 식별하려면 Claude Code에 문의하세요. 프로덕션 자격 증명에 대한 포괄적인 액세스 권한을 부여하지 마세요. 승인을 위해 미리보기 또는 스테이징 배포를 사용한 다음 호스트 제어를 사용하여 승인된 개정을 승격하세요.
Claude Code 아티팩트: claude.ai에 로그인된 지원되는 계정에서 Claude Code는 자체 포함된 HTML 또는 Markdown 페이지를 아티팩트로 사용할 수 있도록 만들 수 있습니다. 아티팩트를 생성하고, 개인 URL을 검사하고, 공유에서 적절한 대상을 선택하도록 요청하세요. 이는 백엔드나 여러 경로가 없는 단일 대화형 페이지이며 전체 호스팅 프로젝트를 대체할 수 없습니다. Anthropic 문서 개인, 조직 및 공개 공유 옵션은 해당 조직 제어에 따라 달라집니다. 액세스 권한을 가정하기보다는 대상 뷰어의 실제 링크를 확인하십시오. 아티팩트를 사용할 수 없는 경우 계정, 인증, 조직 정책을 확인하세요.
Claude Code 아티팩트와 호스팅된 웹사이트 비교
Anthropic은 Claude Code 아티팩트를 설명합니다. claude.ai의 독립형 대화형 페이지로 제공됩니다. 세션 출력에서 하나를 만들고, 비공개 URL을 검토하고, 공유 대상을 선택할 수 있습니다. 클릭 가능한 프로토타입, 변경 사항 안내 또는 단일 페이지 데모에 유용합니다. Anthropic은 아티팩트에 백엔드가 없으며 여러 경로를 제공할 수 없다고 말합니다. 고유한 페이지, 제작 양식 또는 자체 도메인이 있는 마케팅 사이트는 대신 적절한 호스트를 거쳐야 합니다.
아티팩트가 결과물인 경우 시뮬레이션인지 또는 작동 중인 애플리케이션인지 확인하세요. 고정 버전을 공유할지 최신 버전을 공유할지 결정하고 수신자 액세스를 테스트하세요.
4. 선택 사항: 작업 현장을 AgentGrid.io에 전달합니다.
팀이 채팅에서 다른 ZIP이 아닌 공유 버전 아티팩트를 원하는 경우 AgentGrid.io는 CLI 및 사람 승인을 통해 Claude Code 연결을 문서화합니다. 제도에 필요한 작업공간과 읽기/쓰기 기능만 부여합니다. 별도로 승인된 게시 작업에 대해서만 게시 기능을 추가합니다. 정확한 작업공간이나 기존 아티팩트 URL에서 Claude Code를 가리키고 새 복사본을 생성하지 않고 해당 아티팩트를 업데이트하도록 요청하세요. 연결이 불가능할 경우 프로젝트 폴더나 ZIP을 수동으로 가져오세요.
연결을 승인한 후에만 AgentGrid.io를 사용하세요. 현재 North Pier Repair 웹사이트를 게시되지 않은 앱 아티팩트로 이름을 지정한 작업 공간에 넣습니다. 아티팩트 URL을 반환하고 미리보기를 확인하세요. 게시하거나, 다른 에이전트를 초대하거나, 소스 저장소를 변경하지 마세요. 액세스가 실패하면 중지하고 누락된 승인이 무엇인지 알려주십시오.
렌더링된 아티팩트와 해당 버전 기록을 검토합니다. 프로젝트가 백엔드 서비스 또는 비밀에 의존하는 경우 아티팩트 환경이 이를 지원하는지 확인하고 공개 소스 번들에 자격 증명을 노출하지 마십시오.
5. 공개 URL 게시 및 확인
AgentGrid.io의 경우 게시 권한이 있는 사람은 현재 앱 아티팩트를 게시하고 나중에 공개 배포를 업데이트할 수 있습니다. 출판 가이드 비공개 아티팩트 공유 링크를 공개 URL과 구별합니다. 저장소 호스팅 사이트의 경우 호스트의 릴리스 흐름을 사용합니다. 두 경우 모두 로그아웃한 상태에서 모바일에서 실제 URL을 검사한 다음 탐색, 양식, 메타데이터 및 HTTPS를 테스트하세요. 변경 사항을 추적할 수 있도록 배포된 개정을 저장소나 아티팩트에 다시 연결합니다.
Claude Code 자체가 웹사이트 호스트인가요?
아니요. 코드를 생성하고, 검사를 실행하고, 귀하가 승인한 배포 도구를 작동하는 데 도움을 줄 수 있습니다. 호스팅 및 공개 액세스는 배포 대상에 속합니다. 로컬 미리보기는 공개되지 않습니다. 코드 아티팩트에는 자체 공유 설정이 필요하고 호스팅된 프로젝트에는 배포 설정이 필요합니다.
관련 항목: 에이전트 생성 코드 공유, Claude 디자인 사이트 계속, 그리고 Claude 아티팩트 작업.
실행 URL을 보내기 전에
버전, 빌드 결과, 대상 및 제한 사항이 포함된 릴리스 노트를 보관하세요. 편집자 세션 없이 공개 페이지를 엽니다. 주요 액션과 모바일 내비게이션, 개발 데이터 유출 여부를 확인해보세요. 소스 프로젝트에서 끊어진 링크나 양식을 수정하고 승인된 경로를 통해 재배포합니다.
AgentGrid의 경우 작업공간 링크를 공용 배포 URL과 구별합니다. 는 출판 가이드 공개 배포가 업데이트될 때까지 이후 편집 내용은 게시되지 않은 상태로 유지됩니다. 이는 검토 중에 유용하지만 현재 작업 영역 미리 보기가 방문자가 보는 버전과 다를 수 있음을 의미하기도 합니다. 변경 사항을 발표하기 전에 두 가지를 모두 확인하세요.
자주 묻는 질문
Claude Code는 호스팅 계정 없이 게시할 수 있나요?
계획과 세션이 허용하는 경우 Claude 아티팩트를 생성할 수 있지만 기존 사이트에는 여전히 배포 대상과 해당 액세스 제어가 필요합니다. 요청이 단일 페이지 아티팩트, AgentGrid 발행물 또는 호스팅된 저장소 프로젝트인지 확인하십시오.
로컬 Claude Code 미리보기를 어떻게 공유하나요?
로컬호스트는 공개되지 않습니다. 공유하기 전에 호스트 미리보기 또는 승인된 아티팩트 및 테스트 수신자 액세스를 사용하세요.
코드와 출시 결정을 연결 상태로 유지
Claude Code에서 빌드하고 작업 사이트를 검토한 후 승인된 버전 하나를 게시하세요. AgentGrid.io를 사용해 보세요 다음 번 전달에 사람과 상담원이 함께 계속할 수 있는 검사 가능한 웹 사이트 아티팩트가 필요한 경우.

Figma
Adobe XD
Blog


