만들기 클로드 공개적으로 사용 가능한 프로젝트는 일반적으로 두 가지를 동시에 의미합니다. (1) 다음을 수행합니다. 함유량 Claude Web/Claude Projects 세션(채팅 기록, 아티팩트, 문서, UI "프로젝트") 중에 생성되고 이를 내보내거나 공유하고 (2) 가져오는 것 암호 클로드 코드(Claude Code)가 생성하거나 스캐폴딩하여 다른 사용자(또는 프로덕션 시스템)가 사용하고 실행할 수 있도록 패키징하는 방식입니다. 이 문서에서는 두 가지 워크플로를 실용적이고 단계별로 자세히 안내하며, 안전성, 출처 및 모범 사례 권장 사항도 함께 제공합니다.
다음은 Claude Web에서 만든 프로젝트를 내보내고 게시하는 방법과 Claude Code에서 생성한 코드를 패키징하고 검토하고 게시하는 방법에 대한 전체적인 운영 안내입니다.
주요 요약: 내장된 기능을 사용하여 Claude Web에서 아티팩트 및 프로젝트 게시 게시/공유 흐름(아티팩트를 내장하거나 공개 링크를 복사할 수도 있음) 및 Claude Code 대화를 내보내거나 저장할 수 있습니다(
/export명령 및 해당 파일~/.claude/projects/) 그런 다음 이를 일반 코드 저장소나 릴리스(GitHub, npm/PyPI/Docker 또는 호스팅된 웹 앱)로 패키징합니다.
클로드 프로젝트 출판에 관한 사항은 무엇입니까?
지난 2년 동안 Anthropic은 출판 및 공유에 중요한 기능을 추가하여 Claude 제품군을 더욱 발전시켜 왔습니다.
- 클로드 프로젝트 (Claude.ai의 프로젝트 UI)를 사용하면 Pro 및 Team 사용자가 채팅을 프로젝트로 구성하고 선택한 채팅/아티팩트를 팀원이 볼 수 있도록 할 수 있습니다. 이는 프로젝트를 내부적으로 공유하고 대중에 공개할 준비를 하는 데 중요한 구성 요소입니다.
- **Anthropic이 Claude Code를 출시했습니다.**는 터미널/IDE 중심의 에이전트 코딩 도구이자, 코드 아티팩트를 생성하고 개발자 툴체인에 통합할 수 있는 CLI/IDE 통합(VS Code, JetBrains) 도구입니다. 실제 프로젝트에서 Claude Code를 사용하기 위한 공개 문서와 모범 사례 가이드도 제공됩니다.
- Claude의 지원 자료에는 프로젝트 데이터를 게시하기 전에 백업하거나 마이그레이션하는 데 필요한 웹 UI(설정 → 개인정보 보호 → 내보내기)에서 사용자 데이터를 내보내는 명확한 절차가 포함되어 있습니다. 팀 플랜 기본 소유자에게는 내보내기 제어 기능도 제공됩니다.
다음은 Claude Web에서 만든 프로젝트를 내보내고 게시하는 방법과 Claude Code에서 생성한 코드를 패키징하고 검토하고 게시하는 방법에 대한 전체적인 운영 안내입니다.
Claude Web에서 만든 프로젝트를 어떻게 게시/내보내나요?
Claude Web의 어떤 기능이 내보내기 및 게시와 관련이 있나요?
Claude Web은 프로젝트(채팅, 업로드된 파일 및 아티팩트를 정리하는 작업 공간)를 지원하며, 설정 → 개인정보 보호 → 데이터 내보내기를 통해 사용자 또는 조직 데이터를 내보낼 수 있습니다. Claude는 파일(PowerPoint, Excel, Word, PDF)을 생성할 수 있으며, 생성된 파일은 Google Drive에 직접 다운로드하거나 저장할 수 있습니다. 하지만 현재 프로젝트의 내부 지식 기반 및 일부 상호작용 로그에는 "프로젝트 내보내기" 버튼이 없을 수 있습니다. 따라서 기본 제공되는 내보내기 + 아티팩트 다운로드 기능을 활용하고, 필요한 경우 프로그래밍 방식 추출 기능을 사용하는 것이 좋습니다.
1단계 - 프로젝트 내용(안전 및 IP) 감사
- Claude 웹 UI(claude.ai/projects)에서 프로젝트를 열고 업로드된 모든 파일, 지침, 프롬프트 및 생성된 아티팩트를 나열합니다.
- 아티팩트에서 비밀, 자격 증명 또는 개인 데이터를 제거하거나 삭제합니다(검색
.env콘텐츠, API 키, 개인 정보). 모델 출력도 동일하게 처리하세요. 라이선스를 증명할 수 없는 경우 저작권이 있는 부분을 제거하세요. - 타사 자산(이미지, 데이터 세트)을 분류하고 라이선스가 재배포를 허용하는지 확인합니다.
2단계 - 웹 UI를 사용하여 공식 아티팩트 내보내기
- 채팅에서 생성된 파일을 직접 다운로드합니다(Claude가 생성할 수 있음)
.pptx,.xlsx,.docx,.pdf— 다운로드 버튼을 눌러 저장하거나 Google Drive에 저장하세요. - 계정 또는 조직 수준 내보내기(채팅 로그, 계정 메타데이터): 설정 → 개인정보 보호 → 데이터 내보내기(개인 및 조직 기본 소유자에게는 내보내기 흐름이 있습니다). 이렇게 하면 이메일로 보관된 내보내기 링크가 전송됩니다.
참고사항 및 주의사항:
- 삭제된 메시지/프로젝트(또는 보존 설정에 의해 삭제된 항목)는 삭제 후 내보내기에 포함되지 않습니다.
- 내보내기를 준비하는 데 시간이 걸릴 수 있습니다. 다운로드 링크는 이메일로 전송되며 만료됩니다(만료된 경우 다시 요청하세요).
3단계 - 아티팩트 공개(단일 출력)
- 클로드 웹에서 유물을 엽니다.
- 클릭 게시이다. 버튼(이 동작은 아티팩트를 "공개"로 전환하고 공개 URL을 사용할 수 있게 합니다).
- 게시 후 클릭 임베드 코드 받기 아티팩트를 사이트나 CMS에 삽입하려면 생성된 HTML 스니펫을 복사하세요. (삽입 기능은 무료/Pro/Max 플랜에서 지원됩니다.)
참고사항 및 팁
- 당신은 또한 수 다운로드 UI에서 특정 아티팩트 유형(SVG, PNG, 인어 텍스트 또는 기타 내보내기 형식)을 다운로드합니다. 다운로드를 사용하여 해당 아티팩트를 리포지토리 또는 블로그 게시물에 포함합니다.
- 접근성을 위해 포함된 콘텐츠에 설명 캡션과 대체 텍스트를 추가하세요.
4단계 - 게시를 위해 내보낸 콘텐츠 패키징
- 로컬로 Git 저장소를 만듭니다.
git init출처, 제한 사항, 라이선스를 설명하는 명확한 README를 추가합니다. - 추가 할
LICENSE파일(목표에 따라 허용 또는 제한 라이선스를 선택하세요). 제한이 필요한 경우 "연구용으로만 사용" 또는 "군사/상업적 사용 금지" 조항을 고려하세요(참고: 적용이 복잡하므로 법률팀에 문의하세요). - 추가
CONTRIBUTING.md및CODE_OF_CONDUCT.md커뮤니티 기여를 수락하려는 경우. - 추가 할
MODEL_CARD.md/SYSTEM_CARD.md클로드가 작성한 내용, 수행한 안전 테스트, 그리고 공개하려는 데이터 세트/출처 정보를 요약해 주세요. 이러한 투명성은 필수적입니다.
5단계 - 공개 푸시 전 정신 건강 검사
- 비밀 스캐너를 실행합니다("비밀을 어떻게 제거할 것인가?" 섹션 참조).
- 개인 데이터나 허용되지 않는 콘텐츠가 남아 있지 않은지 확인합니다.
- 내보낸 문서의 바이러스/메타데이터가 치료되었는지 확인하세요(추적된 변경 사항, 숨겨진 메타데이터 제거).
6단계 - 게시
- 선택한 공개 호스트(GitHub/GitLab)에 코드/아티팩트를 푸시하세요. 릴리스 태그와 설명이 포함된 릴리스 노트를 사용하세요. 정적 사이트나 데모를 원한다면 GitHub Pages, Netlify 또는 레지스트리에 게시된 Docker 컨테이너를 고려해 보세요.
- 클로드가 만든 대화형 아티팩트(예: 데모 사이트)를 게시하는 경우 런타임 요청으로 인해 백엔드 API 키가 유출되지 않도록 해야 합니다. 서버 측 프록시와 속도 제한을 사용하세요.
실제 예제(정적 HTML 데모)
- 프로젝트에서 HTML 아티팩트를 복사합니다.
index.html, 추가README.md복제 지침 포함. - 커밋하고 푸시하세요:
git init
git add .
git commit -m "Initial publish: Claude Project export v1.0"
gh repo create my-claude-demo --public --source=. --push
- 저장소 설정에서 GitHub 페이지를 활성화합니다(브랜치: main / 폴더: /) 또는 GitHub Actions를 설정하여 Netlify/S3에 배포합니다.
Claude Code에서 생성된 전사본이나 코드를 어떻게 내보내고 패키징합니까?
Claude Code는 에이전트 기반이며 주로 CLI 기반입니다. 세션을 로컬로 저장하고 슬래시 명령(다음 포함)을 제공합니다. /export)를 사용하여 대화를 저장하고 내보냅니다. 권장되는 워크플로는 다음과 같습니다. 대화와 관련 파일을 내보내고, 출력을 사용자가 이해하기 쉬운 형식으로 변환/정리하고, 메타데이터가 포함된 코드 저장소를 추가한 후 게시합니다. 다음은 내장 명령과 일반적인 패키징 도구를 사용하는 실용적이고 재현 가능한 단계입니다.
1단계 - Claude Code가 올바르게 설정되었는지 확인하세요.
- Claude Code를 설치하고 구성합니다(다음을 따르세요) 설정 가이드: Cometapi 콘솔을 통해 연결한 다음 필요한 경우 청구를 설정하는 것이 좋습니다. 코메타피 더 저렴한 API 가격을 제공합니다.).
- 실행할 수 있는지 확인하세요
claude터미널에 작업 공간이 있는지 확인하세요.
2단계 - 대화 내보내기
- Claude Code REPL(대화형 CLI)에서 다음을 실행합니다.
/export myproject-conversation.jsonl또는 단순히/export대화를 클립보드에 복사하거나 파일에 씁니다(동작은 버전 및 플래그에 따라 다름)./export이 명령은 현재 세션을 파일이나 클립보드로 내보냅니다. - 모든 프로젝트 세션을 수집하려면 다음을 검사하세요.
~/.claude/projects/디렉토리(Claude Code는 대화를 JSONL 또는 JSON 파일로 저장합니다). 예:ls -la ~/.claude/projects/ - 내보내기가 JSONL인 경우 가독성을 위해 Markdown으로 변환하세요.
-
간단한 Python 스니펫:
import json out = [] with open('myproject-conversation.jsonl') as f: for line in f: out.append(json.loads(line)) # transform out -> markdown file -
또는 다음과 같은 커뮤니티 도구를 사용하세요.
claude-conversation-extractororclaude-code-exporter(세션을 구문 분석하고 Markdown/MDX로 변환하는 커뮤니티 프로젝트가 있습니다).
3단계 - 재현 가능한 저장소 만들기
- 로컬 저장소를 만듭니다.
mkdir my-claude-project cd my-claude-project git init - 추가 :
README.md— 프로젝트 설명, 출처 참고 사항, 사용 지침.CLAUDE.md— 클로드가 어떻게 사용되었는지(프롬프트, 해당되는 경우 온도/매개변수, 인간이 편집한 부분)LICENSE— 선택된 라이센스.artifacts/— 다운로드한 아티팩트(이미지, SVG)와 내보낸 대화 파일을 포함합니다..jsonlor.md).src/— 생성된 코드(있는 경우) 및 지원 스크립트.
- 범하다:
git add . git commit -m "Initial Claude project export and artifact bundle"
4단계 - 배포를 위한 코드 패키징
어떤 패키징 경로를 선택하는지는 코드 언어와 대상 고객에 따라 달라집니다.
JavaScript/Node 패키지인 경우(npm 계정 필요):
- 디렉토리를 만듭니다.
mkdir my-claude-project && cd my-claude-project - git 초기화:
git init - 패키지 메타데이터 초기화:
npm init→ 메타데이터를 채웁니다. - 추가
index.js, 테스트 및examples/폴더에 있습니다. echo "MIT" > LICENSE(또는 선택한 라이센스를 사용하세요).- npm 계정을 만들고 인증하세요.
npm login - npm에 게시:
npm publish --access public(사용하다--access public(범위가 지정된 패키지의 경우 공개해야 합니다.)
cpp
npm publish --access public
Python 패키지인 경우:
- 저장소 준비: 추가
pyproject.tomlorsetup.py. - 살균 및 테스트: 실행
pytest, 정적 타이핑(mypy), 및 종속성 검사를 수행합니다. 비밀과 자격 증명을 제거합니다. - 빌드 및 게시: 휠 및 sdist 빌드
nginx
#creates dist/
python -m build
# follow Twine prompts (use TestPyPI first if you want a dry run)
twine upload dist/*
웹 앱이나 데모인 경우:
- 작은 웹 프런트엔드(예: Vite/Next/Vercel)를 만듭니다.
- Vercel/Netlify에 배포:
- GitHub 저장소에 연결합니다.
- 민감하지 않은 키가 있는 환경 변수를 추가합니다(공개 데모에서는 없음).
- 배포합니다.
컨테이너화된 서비스인 경우:
- 추가
Dockerfile. - 빌드 및 푸시:
perl
# test locally
docker build -t dockerhubuser/my-claude-demo:1.0 .
# Push to registry (Docker Hub / GitHub Container Registry):
docker push dockerhubuser/my-claude-demo:1.0
5단계 - 릴리스 및 문서 작성
- GitHub에서: 저장소 열기 → 생성 해제 (태그 v1.0.0) 및 컴파일된 아티팩트(ZIP, tarball)를 업로드합니다.
- 추가 할
CONTRIBUTING.md및SECURITY.md문제나 민감한 데이터 유출을 보고하는 방법을 설명합니다. - Claude Web이나 다운로드 가능한 자산의 내장된 아티팩트 URL이 있는 짧은 데모 페이지(GitHub 페이지)를 추가합니다.
Claude Code 내보내기를 CI/CD에 통합하려면 어떻게 해야 하나요?
예: 내보내기, 변환 및 릴리스를 위한 GitHub 작업
1.목표 : 브랜치가 푸시되면 최신 Claude 대화 파일을 내보내고(머신/CI 아티팩트나 MCP 서버를 통해 보관한 경우) 릴리스를 생성합니다.
- 상위 단계:
워크플로우를 사용하세요(.github/workflows/publish.yml) 그 :
- 저장소를 확인하세요.
- JSONL을 Markdown으로 변환하는 작은 스크립트를 실행합니다.
- 사용
actions/create-release보도자료를 공개합니다. - 아티팩트를 업로드합니다.
- 보안 참고사항: 개인 API 키를 저장소에 저장하지 마세요. GitHub Secrets를 사용하고 토큰을 순환하세요.
(커뮤니티 도구 등) claude-code-exporter MCP 호환 서버를 사용하면 대화 내보내기를 서버 흐름에 통합하는 작업이 더 간편해집니다. 대화를 중앙 보관소로 스트리밍하는 MCP/CLI 통합을 찾아보세요.
협력적 공유와 재현성은 어떻습니까?
재현 가능한 환경을 만들어라
- 추가
environment.yml/requirements.txt/package.json정확한 버전을 나열합니다. - 추가 할
Makefile목표와 함께:make export make convert make build make release - 사용된 정확한 Claude 코드 버전을 문서화합니다(예:
claude-code v1.0.44) 및 export 명령. 이는 독자가 내보내기(버전 변경 동작)를 재현하는 데 도움이 됩니다./export).
대화 공유 + 코드
- Claude 아티팩트(공개 ULR/embed)를 게시하고 내보낸 대본과 패키지된 코드가 포함된 GitHub 릴리스에 연결합니다.
- 원클릭 데모(Vercel/GitHub Pages)를 추가하고 다음을 포함합니다.
Try it링크를 클릭하십시오.
특정 기술적 함정과 피해야 할 사항
함정: 비밀 또는 PII 유출
치료제: 게시하기 전에 자동 스캐닝(truffleHog, git-secrets)을 사용하세요. 실수로 푸시되는 것을 차단하기 위해 사전 커밋 후크를 추가하세요. .env 또는 API 키.
함정: 사용자 중심 아티팩트로 원시 JSONL 대화 파일에 의존
치료제: 마크다운으로 변환하고, 출처에 대한 메모를 추가하고, 정제되고 맥락화된 출력물만 주요 아티팩트로 표시합니다.
함정: 버전 불일치 및 향후 호환성 문제
치료제: 핀 버전(Claude Code와 모든 도우미 라이브러리 모두)에는 다음이 포함됩니다. claude-version.txt or claude-code-version 저장소에.
함정: 라이센스 부족
치료제: 더하다 LICENSE 조기. 관대한 재사용을 원한다면 MIT/Apache 2.0을 선택하고, 상업적 통제를 원한다면 더 제한적인 라이선스를 선택하세요.
클로드가 한 일과 사람이 한 일을 사용자에게 어떻게 알릴 수 있나요?
모범 사례: 명시적 귀속 및 출처 파일
클로드.md — 짧은 형식:
## Provenance
- Created with Claude Web (artifact: <public-URL>)
- Prompts used: (excerpted)
- Human edits: normalized content on 2025-12-03
- Exported from Claude Code: /export -> myproject-conversation.jsonl
추가 할 USAGE.md 및 LIMITATIONS.md 모델 환각 위험, 권장되는 보호책, 수정을 위한 연락처를 설명합니다.
결론 - 신중하게 게시하고 빠르게 반복하세요
클로드 프로젝트를 공개하는 것은 유용한 결과물을 공유하고, 연구를 가속화하며, 생태계를 성장시킬 수 있는 기회이지만, 이는 신중하게 이루어져야 합니다. 최근의 발전(클로드 오푸스 4.5 및 강화된 개발자 도구) 덕분에 생성된 결과물은 그 어느 때보다 강력하고 유용해질 것입니다. 이러한 강력한 기능은 강력한 출처 확인, 비밀 스캐닝, 안전 테스트, 그리고 명확한 문서화와 결합되어야 합니다.
개발자는 액세스할 수 있습니다 클로드 오푸스 4.5 API CometAPI를 통한 등 최신 모델 버전 공식 웹사이트에서 항상 업데이트됩니다. 시작하려면 모델의 기능을 살펴보세요. 운동장 그리고 상담하십시오 API 가이드 자세한 내용은 CometAPI를 참조하세요. 접속하기 전에 CometAPI에 로그인하고 API 키를 발급받았는지 확인하세요. 코멧API 공식 가격보다 훨씬 낮은 가격을 제공하여 통합을 돕습니다.
출발 준비 되셨나요?→ Claude Opus 4.5 무료 체험판 !
AI에 대한 더 많은 팁, 가이드 및 뉴스를 알고 싶다면 저희를 팔로우하세요. VK, X 및 디스코드!
자주 묻는 질문
1) 클로드에서 "프로젝트를 공개한다"는 것은 무슨 뜻인가요?
럭셔리 프로젝트 성공 사례Claude의 가시성 제어를 사용하면 프로젝트를 유지할 수 있습니다. 비공개 (초대받은 사람만) 또는 공유하세요 의 모든 사람공식 문서에서는 두 가지 옵션을 설명합니다. 프로젝트를 자동으로 인터넷에 공개하는 버튼은 없습니다.
2) 프로젝트를 공개하려면 어떻게 해야 하나요?(단계별)
- Claude에서 프로젝트를 엽니다.
- 클릭 공유 버튼(프로젝트 이름 오른쪽)
- $XNUMX Million 미만 일반 액세스 선택 의 모든 사람 귀하의 조직에 공개하세요.
언제든지 이를 변경할 수 있습니다.
3) 프로젝트를 전체 인터넷(링크가 있는 모든 사람)에 공개할 수 있나요?
직접적으로는 아닙니다. 프로젝트 가시성은 공식 UI에서 조직 단위로 제공됩니다. 인터넷 전체에서 접근해야 하는 경우 게시하세요. 개별 유물 (다음 항목 참조) 또는 외부 배포/임베딩 솔루션을 사용하세요.
4) "아티팩트"란 무엇이고, 게시와 프로젝트 공개의 차이점은 무엇입니까?
An 유물 = Claude 내부에서 생성된 단일 출력(다이어그램, 내보낸 문서, 차트 등). 아티팩트는 자체적으로 게시이다. 흐름: 아티팩트를 공개적으로 게시하고 웹사이트에 삽입할 수 있는 임베드 코드를 받을 수 있습니다. 이는 공개 웹에 단일 출력물을 표시하려는 경우 권장되는 방법입니다.
5) 공개 프로젝트나 게시되지 않은 아티팩트를 비공개/게시되지 않은 상태로 되돌릴 수 있나요?
네, 언제든지 프로젝트 공개 상태를 변경할 수 있습니다(공유 → "초대받은 사람만" 선택). 아티팩트의 경우, 아티팩트 제어에 따라 게시 취소 또는 임베드 링크 제거가 가능합니다.
