如何将 Claude 项目设为公开并发布?

CometAPI
AnnaDec 2, 2025
如何将 Claude 项目设为公开并发布?

将一个Claude项目公开通常意味着同时做两件事:(1) 将在 Claude Web / Claude Projects 会话中创建的内容(聊天记录、工件、文档、UI“Projects”)导出或分享;以及 (2) 将由 Claude Code 生成或脚手架的代码进行打包,使其他人(或生产系统)能够获取并运行。本文将通过两个工作流的实操性分步详解,贯穿安全、来源与最佳实践建议。

以下是一个可操作的端到端演示:如何导出并发布在 Claude Web 中创建的 Projects,以及如何打包、审查并发布用 Claude Code 生成的代码。

关键简要结论:通过内置的Publish / Share流程在 Claude Web 发布工件和项目(也可以嵌入工件或复制公开链接);导出/保存 Claude Code 对话(使用/export命令以及~/.claude/projects/下的文件),然后将其打包为常规代码仓库或发行版(GitHub、npm/PyPI/Docker,或托管的 Web 应用)。

发布 Claude 项目需要关注什么

过去两年,Anthropic 持续完善 Claude 产品线,加入了与发布与分享相关的特性:

  • Claude Projects(Claude.ai 上的 Projects UI)让 Pro 和 Team 用户将聊天组织到 Projects 中,并使选定的聊天/工件对队友可见——这是项目内部共享并为公开曝光做准备的关键构件。()
  • Anthropic 发布了 Claude Code,这是一款以终端/IDE 为中心的、具备代理能力的编码工具,以及配套的 CLI/IDE 集成(VS Code、JetBrains),可产出代码工件并集成到开发者工具链中。还提供公开文档与最佳实践指南,帮助在真实项目中使用 Claude Code。()
  • Claude 的支持材料包含来自 Web UI 的明确用户数据导出流程(Settings → Privacy → Export),可用于在发布前备份或迁移项目数据。对于 Team 方案的 Primary Owners 也提供导出控制。

以下是一个可操作的端到端演示:如何导出并发布在 Claude Web 中创建的 Projects,以及如何打包、审查并发布用 Claude Code 生成的代码。

如何发布/导出在 Claude Web 中创建的项目(分步说明)?

Claude Web 提供两种互补的方式将输出公开:Publish Artifacts(单个输出:图表、文档、图形)与Share Projects(项目级可见性与团队访问)。下面的分步涵盖两种流程,以及如何嵌入或下载。

步骤 1 —— 在 Claude Web 中准备工件

  1. 在 Claude Web 中,将你想发布的聊天或工件(文档、图表、流程图、图像)收集到一个 Project 或独立 Artifact 中。
  2. 清理与注释:编辑内容使其易读,添加说明文字,并补充缺失的署名。

步骤 2 —— 发布工件(单个输出)

  1. 在 Claude Web 打开该工件。
  2. 点击Publish按钮(此操作将工件切换为“公开”,并生成一个公开 URL)。
  3. 发布后,如果需要嵌入到站点或 CMS,点击Get embed code——复制生成的 HTML 代码片段。(嵌入在 free/Pro/Max 方案中均支持。)

注意与提示

  • 你也可以在 UI 中下载某些工件类型(SVG、PNG、Mermaid 文本或其他导出格式)——使用下载的文件将工件包含到你的代码仓库或博文中。
  • 为嵌入内容添加说明文字与替代文本,以提升可访问性。

步骤 3 —— 分享项目(更广的集合与权限控制)

  1. 在 Claude Web 打开 Project 列表。
  2. 在项目名称旁点击Share
  3. 在 Share 对话框中你可以:
  • 通过邮箱/姓名添加成员或队友。
  • 设置权限级别(Can view / Can edit)。若面向公开发布,可选择Make project public(若可用),或仅将关键工件单独发布。

步骤 4 —— 在外部发布项目工件

  • **发布博文/发布说明。**包含公开 URL 或嵌入的工件,并简要说明哪些内容由 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/*

若为 Web 应用或演示:

  • 创建小型前端(如 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(打 tag v1.0.0),并上传已编译工件(ZIP、tarball)。
  • 添加CONTRIBUTING.mdSECURITY.md,说明如何报告问题或敏感数据泄露。
  • 添加简短演示页(GitHub Pages),包含来自 Claude Web 的嵌入工件 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 guide获取详细说明。访问前,请确保已登录 CometAPI 并获取 API key。CometAPI提供远低于官方价格的方案,帮助你完成集成。

准备好了吗?→ Free trial of Claude opus 4.5

若想了解更多 AI 的技巧、指南与新闻,欢迎关注我们的 VKXDiscord

阅读更多

一个 API 中超 500 个模型

最高 20% 折扣