讓一個「Claude」專案公開通常同時意味著兩件事:(1) 取出並分享在 Claude Web / Claude Projects 工作階段中產生的「內容」(聊天記錄、產出物、文件、UI「Projects」),以及 (2) 將 Claude Code 生成或搭建的「程式碼」打包,讓其他人(或正式系統)能夠取用並執行。本文以實務、逐步的方式走訪兩條流程,並融入安全性、來源溯源與最佳實務建議。
以下提供作業層面的端到端示範:如何匯出並發布在 Claude Web 建立的 Projects,以及如何封裝、審閱並發布以 Claude Code 生成的程式碼。
重點精簡摘要:使用 Claude Web 內建的「Publish / Share」流程發布產出與專案(也可嵌入產出或複製公開連結);匯出/儲存 Claude Code 對話(使用「/export」指令與「~/.claude/projects/」下的檔案),再打包成一般的程式碼版本庫或釋出(GitHub、npm/PyPI/Docker,或託管的網頁應用)。
與發布 Claude 專案相關的重要事項
過去兩年,Anthropic 在 Claude 產品線上持續成熟,加入多項有助於發布與分享的功能:
- Claude Projects(Claude.ai 上的 Projects 介面)讓 Pro 與 Team 用戶把聊天整理成專案,並可讓特定聊天/產出讓團隊成員檢視——這是於內部分享專案並準備對外公開的重要基礎。()
- Anthropic 推出 Claude Code,一個以終端機/IDE 為中心、具代理能力的程式開發工具,並提供 CLI/IDE 整合(VS Code、JetBrains),可產生程式碼產出並整合進開發者工具鏈。同時提供公開文件與在真實專案中使用 Claude Code 的最佳實務指引。()
- Claude 的支援資料包括 Web 介面的明確使用者資料匯出流程(Settings → Privacy → Export),在發布前備份或遷移專案資料時相當重要。對於 Team 方案的主要擁有者,也提供匯出控管。
以下提供作業層面的端到端示範:如何匯出並發布在 Claude Web 建立的 Projects,以及如何封裝、審閱並發布以 Claude Code 生成的程式碼。
如何發布/匯出在 Claude Web 建立的專案(步驟詳解)?
Claude Web 提供兩種互補方式讓輸出公開:Publish Artifacts(單一輸出:圖解、文件、圖表)與 Share Projects(專案層級的可見性、團隊存取)。以下步驟涵蓋兩種流程,以及如何嵌入或下載。
步驟 1 — 在 Claude Web 準備欲發布的產出
- 在 Claude Web 中,將欲發布的聊天或產出(文件、圖解、流程圖、影像)整理成一個 Project 或獨立的 Artifact。
- 清理並註記:編輯內容使其易讀,加入說明文字,並補上缺漏的出處標註。
步驟 2 — 發布 Artifact(單一輸出)
- 在 Claude Web 開啟該 Artifact。
- 點擊 Publish 按鈕(此動作會將 Artifact 切換為「公開」並產生公開 URL)。
- 發布後,若需要嵌入至網站或 CMS,點擊 Get embed code——複製產生的 HTML 程式碼片段。(嵌入功能支援 free/Pro/Max 方案。)
注意與提示
- 部分 Artifact 類型也可在介面中下載(SVG、PNG、Mermaid 文本或其他匯出格式)——可將下載的檔案納入版本庫或部落格文章。
- 為嵌入的內容加入說明文字與替代文字(alt text),提升無障礙性。
步驟 3 — 分享 Project(具有權限設定的較廣集合)
- 在 Claude Web 開啟 Project 清單。
- 在專案名稱旁點擊 Share。
- 在分享對話框中可:
- 透過 email/姓名新增成員或團隊夥伴。
- 設定權限層級(Can view / Can edit)。若對外發布,選擇 Make project public(若可用),或將關鍵 Artifact 個別發布。
步驟 4 — 將專案產出對外發布
- **發布部落格文章 / 版本訊息。**包含公開 URL 或嵌入的 Artifact,並簡短註明哪些是 Claude 生成、哪些是人工審閱。
- **建立可存取的封存。**加入 ZIP 檔或匯出包的連結(見下方封裝 Claude Code),以提升可重現性。
如何匯出並封裝 Claude Code 生成的對話記錄或程式碼?
Claude Code 具代理能力,主要由 CLI 驅動;它會在本機保存工作階段,並提供斜線指令(包括「/export」)來儲存與匯出對話。建議工作流程是:匯出對話與支援檔案、轉換/清理輸出成易讀格式、加入具中繼資料的程式碼版本庫,然後發布。以下是使用內建指令與常見封裝工具的實務、可重現步驟。
步驟 1 — 確認 Claude Code 安裝設定正確
- 安裝並設定 Claude Code(依官方安裝指南操作:透過 Claude Console 連線或視需要設定計費)。
- 確認能在終端機執行
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-extractor或claude-code-exporter(社群專案可將工作階段解析並轉為 Markdown/MDX)。
步驟 3 — 建立可重現的版本庫
- 建立本機版本庫:
mkdir my-claude-project cd my-claude-project git init - 加入:
README.md—— 專案說明、來源溯源註記、使用指南。CLAUDE.md—— 說明 Claude 的使用方式(提示詞、若相關則含溫度/參數、哪些內容經人工編修)。LICENSE—— 授權條款。artifacts/—— 包含下載的產出(影像、SVG)與匯出的對話檔(.jsonl或.md)。src/—— 生成的程式碼(若有)與支援腳本。
- 提交:
git add . git commit -m "Initial Claude project export and artifact bundle"
步驟 4 — 將程式碼封裝以供發佈
你選擇的封裝路徑取決於語言與目標受眾。
若為 JavaScript/Node 套件:
npm init→ 填寫中繼資料。- 加入
index.js、測試與examples/目錄。 - 發布到 npm:
npm publish --access public(若為要公開的 scoped 套件,使用--access public)。
若為 Python 套件:
- 加入
pyproject.toml或setup.py。 - 建置 wheel 與 sdist:
python -m build twine upload dist/*
若為網頁應用或展示:
- 建立小型前端(例如 Vite/Next/Vercel)。
- 部署到 Vercel/Netlify:
- 連結 GitHub 版本庫。
- 加入環境變數且避免敏感金鑰(公開示範通常不需要)。
- 部署。
若為容器化服務:
- 加入
Dockerfile。 - 建置與推送:
docker build -t dockerhubuser/my-claude-demo:1.0 . docker push dockerhubuser/my-claude-demo:1.0
步驟 5 — 建立版本發佈與文件
- 在 GitHub:開啟版本庫 → 建立 Release(標記 v1.0.0),並上傳編譯產出(ZIP、tarball)。
- 加入
CONTRIBUTING.md與SECURITY.md,說明如何回報問題或敏感資料外洩。 - 建立簡短示範頁(GitHub Pages),嵌入自 Claude Web 的 Artifact URL 或可下載資產。
如何把 Claude Code 匯出整合進 CI/CD 以自動化發佈?
範例:使用 GitHub Actions 進行匯出、轉換與發佈
- **目標:**當有分支推送時,匯出最新的 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 Code 的確切版本(例如
claude-code v1.0.44)與匯出指令。版本差異可能改變/export的行為,這有助讀者重現匯出。
分享對話與程式碼
- 發布 Claude 產出(公開 URL/嵌入),並連結至包含匯出對話與已封裝程式碼的 GitHub 釋出。
- 加入一鍵示範(Vercel / GitHub Pages),並提供「Try it」連結。
結語——審慎發布、快速迭代
將 Claude 專案公開是分享有用產出、加速研究與壯大生態系的好機會——但必須審慎為之。隨著近期進展(Claude Opus 4.5 與更豐富的開發者工具),生成的產出將更強大、也更實用;這股力量必須搭配清晰的來源溯源、密鑰掃描、安全測試與完善文件。
開發者可透過 CometAPI 存取 Claude Opus 4.5 API 等,最新模型版本 會與官方網站保持同步更新。起步時,可先在 Playground 探索模型能力,並參考 API 指南 取得詳細操作說明。使用前請先登入 CometAPI 並取得 API 金鑰。CometAPI 提供遠低於官方價格的方案,協助你完成整合。
準備好了嗎?→ Claude Opus 4.5 免費試用!
