我該如何將 Claude 專案設為公開並發佈?

CometAPI
AnnaDec 2, 2025
我該如何將 Claude 專案設為公開並發佈?

讓一個「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 準備欲發布的產出

  1. 在 Claude Web 中,將欲發布的聊天或產出(文件、圖解、流程圖、影像)整理成一個 Project 或獨立的 Artifact。
  2. 清理並註記:編輯內容使其易讀,加入說明文字,並補上缺漏的出處標註。

步驟 2 — 發布 Artifact(單一輸出)

  1. 在 Claude Web 開啟該 Artifact。
  2. 點擊 Publish 按鈕(此動作會將 Artifact 切換為「公開」並產生公開 URL)。
  3. 發布後,若需要嵌入至網站或 CMS,點擊 Get embed code——複製產生的 HTML 程式碼片段。(嵌入功能支援 free/Pro/Max 方案。)

注意與提示

  • 部分 Artifact 類型也可在介面中下載(SVG、PNG、Mermaid 文本或其他匯出格式)——可將下載的檔案納入版本庫或部落格文章。
  • 為嵌入的內容加入說明文字與替代文字(alt text),提升無障礙性。

步驟 3 — 分享 Project(具有權限設定的較廣集合)

  1. 在 Claude Web 開啟 Project 清單。
  2. 在專案名稱旁點擊 Share
  3. 在分享對話框中可:
  • 透過 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 — 匯出對話

  1. 在 Claude Code REPL(互動式 CLI)中執行:/export myproject-conversation.jsonl 或僅輸入 /export,此指令會將當前對話複製到剪貼簿或寫入檔案(行為依版本與旗標而定)。/export 會把當前工作階段匯出到檔案或剪貼簿。
  2. 若想彙整整個專案的所有工作階段,可查看 ~/.claude/projects/ 目錄(Claude Code 會將對話以 JSONL 或 JSON 檔保存於此)。範例:ls -la ~/.claude/projects/
  3. 若匯出為 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-extractorclaude-code-exporter(社群專案可將工作階段解析並轉為 Markdown/MDX)。

步驟 3 — 建立可重現的版本庫

  1. 建立本機版本庫:mkdir my-claude-project cd my-claude-project git init
  2. 加入:
  • README.md —— 專案說明、來源溯源註記、使用指南。
  • CLAUDE.md —— 說明 Claude 的使用方式(提示詞、若相關則含溫度/參數、哪些內容經人工編修)。
  • LICENSE —— 授權條款。
  • artifacts/ —— 包含下載的產出(影像、SVG)與匯出的對話檔(.jsonl.md)。
  • src/ —— 生成的程式碼(若有)與支援腳本。
  1. 提交: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.tomlsetup.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.mdSECURITY.md,說明如何回報問題或敏感資料外洩。
  • 建立簡短示範頁(GitHub Pages),嵌入自 Claude Web 的 Artifact URL 或可下載資產。

如何把 Claude Code 匯出整合進 CI/CD 以自動化發佈?

範例:使用 GitHub Actions 進行匯出、轉換與發佈

  1. **目標:**當有分支推送時,匯出最新的 Claude 對話檔(若你已在機器/CI 產物或透過 MCP 伺服器保存),並建立釋出。
  2. 高階步驟:
  • 使用工作流程(.github/workflows/publish.yml):
  • 檢出版本庫。
  • 執行小型腳本將 JSONL → Markdown。
  • 使用 actions/create-release 建立釋出。
  • 上傳產出檔。
  1. **安全性注意事項:**不要在版本庫中保存私密 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 免費試用

若你想獲得更多關於 AI 的技巧、指南與新聞,請在 VKXDiscord 關注我們!

閱讀更多

一個 API 中超過 500 個模型

最高 20% 折扣