如何將 Claude 專案公開並發布

CometAPI
annaDec 3, 2025
如何將 Claude 專案公開並發布

製作 克勞德 項目公開可用通常意味著兩件事:(1)採取 內容 (1)在 Claude Web / Claude Projects 會話期間所建立的內容(聊天記錄、工件、文件、UI「專案」),以及匯出或分享這些內容;(2)取得 本文將介紹如何透過 Claude Code 產生或建立程式碼框架,並將其打包以便其他人(或生產系統)可以使用和運作。文章將以實用且循序漸進的方式,詳細介紹這兩種工作流程,並融入安全性、可追溯性和最佳實踐建議。

接下來是一個完整的操作流程示範:如何匯出和發佈在 Claude Web 中建立的項目,以及如何打包、審查和發布使用 Claude Code 產生的程式碼。

重點簡述:使用內建功能從 Claude Web 發布工件和項目 發布/分享 流程(您也可以嵌入工件或複製公共連結),以及匯出/儲存 Claude Code 對話(使用 /export 命令和以下文件 ~/.claude/projects/然後將它們打包到普通的程式碼倉庫或發布版本(GitHub、npm/PyPI/Docker 或託管的 Web 應用程式)中。

出版克勞德計畫需要考慮哪些因素?

在過去的兩年裡,Anthropic 不斷完善 Claude 產品線,為其添加對發布和分享至關重要的功能:

  • 克勞德項目 (Claude.ai 上的項目 UI)允許 Pro 和 Team 用戶將聊天組織成項目,並使選定的聊天/工件對團隊成員可見——這是在內部共享項目並準備將其公開的關鍵構建模組。
  • **人形影視公司發行了《克勞德·科德》**Claude Code 是一款以終端/IDE為中心的智慧編碼工具,並提供配套的CLI/IDE整合(例如VS Code、JetBrains),能夠產生程式碼工件並整合到開發者工具鏈中。此外,Claude Code 還提供了公開文件和最佳實踐指南,指導使用者如何在實際專案中使用 Claude Code。
  • Claude 的支援資料包括從 Web 使用者介面(設定 → 隱私 → 匯出)匯出使用者的明確資料匯出流程,這些流程與發布前備份或遷移項目資料相關。團隊計劃的主要所有者也有導出控制功能。

接下來是一個完整的操作流程示範:如何匯出和發佈在 Claude Web 中建立的項目,以及如何打包、審查和發布使用 Claude Code 產生的程式碼。

如何在Claude Web中發布/匯出項目

Claude Web 的哪些功能與匯出和發布相關?

Claude Web 支援「專案」(用於組織聊天記錄、上傳文件和工件的工作區),並允許透過「設定」→「隱私權」→「匯出資料」匯出使用者或組織資料;Claude 還可以建立檔案(PowerPoint、Excel、Word、PDF),這些輸出可以直接下載或儲存到 Google 雲端硬碟。但是,「專案」的內部知識庫和一些互動日誌目前可能沒有「匯出專案」按鈕——您應該依賴內建的匯出和工件下載功能,並在必要時輔以程式化擷取。

第一步-審核專案內容(安全與智慧財產權)

  1. 在 Claude Web UI (claude.ai/projects) 中開啟項目,並列出每個上傳的檔案、指令、提示和產生的工件。
  2. 從工件中移除或編輯任何秘密資訊、憑證或私人資料(搜尋) .env 內容、API金鑰、個人資料)。對模型輸出採取相同處理方式-如果無法證明已取得許可,則刪除受版權保護的部分。
  3. 對第三方資產(圖像、資料集)進行分類,並確認許可證允許重新分發。

步驟 2 — 使用 Web 使用者介面匯出官方文件

  1. 直接從聊天記錄下載產生的檔案(Claude 可以建立) .pptx, .xlsx, .docx, .pdf — 透過下載按鈕儲存這些檔案或儲存到 Google 雲端硬碟)。
  2. 對於帳戶或組織層級的匯出(聊天記錄、帳戶元資料):設定 → 隱私 → 匯出資料(個人和組織的主要擁有者擁有匯出流程)。這將透過電子郵件發送一個已存檔的匯出連結。

注意事項:

  • 已刪除的郵件/項目(或根據保留設定刪除的內容)在刪除後不會包含在匯出檔案中。
  • 匯出文件可能需要一些時間準備;下載連結會透過電子郵件發送,但會過期(如果過期,請重新申請)。

步驟 3 — 公開工件(單一輸出)

  1. 在 Claude Web 中開啟該文物。
  2. 在操作欄點擊 發布 按鈕(此操作會將作品切換為“公開”,並產生一個公開 URL)。
  3. 發布後,點擊 取得嵌入程式碼 如果您想將該文件嵌入到網站或內容管理系統中,請複製生成的 HTML 程式碼片段。 (免費版/專業版/高級版皆支援嵌入功能。)

注意事項和提示

  • 你也可以 下載 從 UI 下載某些類型的工件(SVG、PNG、Mermaid 文字或其他匯出格式)—使用下載功能將工件包含在您的儲存庫或部落格文章中。
  • 為嵌入內容添加說明性標題和替代文本,以提高可訪問性。

步驟 4 — 將匯出的內容打包以進行發布

  1. 在本地建立 Git 倉庫: git init添加一個清晰的 README 文件,描述來源、限制和許可。
  2. 添加 LICENSE 文件(根據您的目標選擇寬鬆許可或限制性許可)。如果您需要限制,請考慮「僅限研究用途」或「禁止軍事/商業用途」條款(注意:執行起來很複雜—請諮詢法律部門)。
  3. 新增 CONTRIBUTING.md CODE_OF_CONDUCT.md 如果您打算接受社區捐款。
  4. 添加 MODEL_CARD.md/SYSTEM_CARD.md 總結一下克勞德的成果、你進行的安全測試,以及你願意公開的資料集/來源說明。這種透明度至關重要。

第五步-公開推廣前的合理性檢驗

  • 執行秘密掃描器(請參閱「我們將如何刪除秘密?」部分)。
  • 確認沒有個人資料或違禁內容殘留。
  • 確保匯出的文件已清除病毒/元資料(刪除追蹤變更、隱藏元資料)。

步驟六——發布

  • 將程式碼/製品推送到選定的公共主機(GitHub/GitLab)。使用發布標籤和詳細的發布說明。如果您需要靜態網站或演示,請考慮使用 GitHub Pages、Netlify 或發佈到映像倉庫的 Docker 容器。
  • 如果您要發布由 Claude 創建的互動式工件(例如,演示網站),請確保執行時間請求不會洩露後端 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 Pages(分支:main / 資料夾:/)或設定 GitHub Actions 以部署到 Netlify/S3。

如何匯出和打包 Claude Code 產生的轉錄文字或程式碼?

Claude Code 是一個代理程序,主要透過命令列介面 (CLI) 驅動;它會將會話保存在本地,並提供斜線命令(包括 /export用於儲存和匯出對話。建議的工作流程是:匯出對話及其支援文件,將輸出轉換為易於閱讀的格式,添加包含元資料的程式碼倉庫,然後發布。以下是使用內建指令和常用打包工具的實用且可複現的步驟。

步驟 1 — 確保 Claude Code 設定正確

  • 安裝 Claude Code 並進行設定(請依照下列步驟操作) 安裝指南建議透過 Cometapi 控制台連接,然後根據需要設定計費。 Cometapi 提供更實惠的 API 定價。 )
  • 確認您可以運行 claude 在你的終端機中,並且你有一個工作區。

步驟 2 — 匯出對話

  1. 在 Claude Code REPL(互動式命令列介面)中運行: /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-extractor or claude-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 or .md).
  • src/ — 產生的程式碼(如有)和支援腳本。
  1. 承諾: git add . git commit -m "Initial Claude project export and artifact bundle"

步驟 4 — 打包代碼以供分發

選擇哪種打包方式取決於程式碼語言和目標受眾。

如果是 JavaScript/Node 套件(需要 npm 帳戶):

  1. 建立目錄: mkdir my-claude-project && cd my-claude-project
  2. 初始化 Git: git init
  3. 初始化軟體包元資料: npm init → 填入元資料。
  4. 新增 index.js測試和 examples/ 文件夾中。
  5. echo "MIT" > LICENSE (或使用您選擇的許可證)。
  6. 建立 npm 帳戶並進行身份驗證: npm login
  7. 發佈到 npm: npm publish --access public (採用 --access public 對於作用域包,您希望它是公開的。 )
cpp
npm publish --access public

如果是 Python 套件:

  • 準備儲存庫:新增 pyproject.toml or setup.py.
  • 消毒和測試:運行 pytest靜態類型(mypy)以及依賴項檢查。移除密鑰和憑證。
  • 建置並發布:建立 wheel 和 sdist 包
nginx
#creates dist/
python -m build

# follow Twine prompts (use TestPyPI first if you want a dry run)

twine upload dist/*

如果是網頁應用程式或示範:

  • 建立一個小型 Web 前端(例如 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 說明如何報告問題或敏感資料外洩。
  • 新增一個簡短的示範頁面(GitHub Pages),其中包含來自 Claude Web 的嵌入式工件 URL 或可下載資源。

如何將 Claude 程式碼匯出整合到 CI/CD 中

範例:使用 GitHub Actions 進行匯出、轉換和發布

1.目標: 當分支被推送時,匯出最新的 Claude 對話檔案(如果你在機器/CI 工件中或透過 MCP 伺服器有這些檔案),並建立一個版本。

  1. 進階步驟:

使用工作流程(.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 鏈接。

具體技術陷阱及規避方法

陷阱:洩漏秘密或個人識別訊息

補救措施: 發布前使用自動化掃描(truffleHog、git-secrets)。新增 pre-commit 鉤子以阻止意外推送。 .env 或 API 金鑰。

陷阱:依賴原始 JSONL 對話檔案作為使用者導向的工件。

補救措施: 轉換為 Markdown 格式,新增來源註釋,並將經過清理、情境相關的輸出作為主要成果呈現。

陷阱:版本不符和未來不相容

補救措施: 引腳版本(包括 Claude Code 和任何輔助庫)包括 claude-version.txt or claude-code-version 在倉庫中。

陷阱:缺乏許可證

補救措施: 添加 LICENSE 儘早。如果您希望程式碼被寬鬆地重複使用,請選擇 MIT/Apache 2.0 授權;為了實現商業控制,請選擇限制性更強的授權。


如何向使用者區分 Claude 的操作和人類的操作?

最佳實務:明確標註出處並建立來源文件

CLAUDE.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 描述模型幻覺風險、建議的防護措施以及糾正措施的聯繫方式。

結論—慎重發布,快速迭代

將 Claude 計畫公開是分享有用成果、加速研究和發展生態系統的良機——但這必須經過深思熟慮。近期的進展(Claude Opus 4.5 和增強的開發者工具)意味著產生的成果將比以往任何時候都更加強大和實用;這種強大功能必須與強大的溯源機制、秘密掃描、安全測試和清晰的文檔相結合。

開發人員可以訪問 克勞德作品 4.5 API 等等,透過 CometAPI, 最新型號版本 始終與官方網站同步更新。首先,探索該模型的功能 游乐场 並諮詢 API指南 以獲得詳細說明。造訪前請確保您已經登入CometAPI並取得API金鑰。 彗星API 提供遠低於官方價格的價格,幫助您整合。

準備出發了嗎? → Claude opus 4.5 免費試用 !

如果您想了解更多有關 AI 的提示、指南和新聞,請關注我們 VKX   不和!

常見問題

1) 在 Claude 中,「公開項目」是什麼意思?

對於 項目克勞德的可見性控制功能可讓您保留項目 私密(僅限受邀人員) 或與…分享 的每個人官方文件描述了這兩種選項——沒有內建按鈕可以自動將項目在網路上公開。


2)如何將項目公開(逐步指南)?

  1. 在 Claude 中開啟項目。
  2. 在操作欄點擊 分享到 按鈕(位於項目名稱右側)。
  3. 一般訪問 選擇 的每個人 將其開放給您的組織。
    您可以隨時變更此設定。

3) 我能否讓整個網路(任何擁有連結的人)都能看到我的項目?

不直接。在官方使用者介面中,項目可見性僅限於組織內部。如果您需要全網可見,請發佈。 單一文物 (請參閱下一項)或使用外部部署/嵌入解決方案。

4) 什麼是「成果」?發布與專案可見度有何不同?

An 神器 = 在 Claude 內部建立的單一輸出(圖表、匯出的文件、圖表等)。工件有其自身的 發布 流程:您可以公開發布作品,並獲取嵌入程式碼將其放置在網站上。如果您希望單一輸出內容在公共網路上可見,這是推薦的方法。


5) 我可以將公開專案或未發佈的工件恢復為私有/未發佈狀態嗎?

是的,您可以隨時變更專案可見度(共用 → 選擇「僅限受邀人員」)。對於項目,您可以根據項目控制設定取消發布或移除嵌入連結。

閱讀更多

一個 API 中超過 500 個模型

最高 20% 折扣