将一个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 中准备工件
- 在 Claude Web 中,将你想发布的聊天或工件(文档、图表、流程图、图像)收集到一个 Project 或独立 Artifact 中。
- 清理与注释:编辑内容使其易读,添加说明文字,并补充缺失的署名。
步骤 2 —— 发布工件(单个输出)
- 在 Claude Web 打开该工件。
- 点击Publish按钮(此操作将工件切换为“公开”,并生成一个公开 URL)。
- 发布后,如果需要嵌入到站点或 CMS,点击Get embed code——复制生成的 HTML 代码片段。(嵌入在 free/Pro/Max 方案中均支持。)
注意与提示
- 你也可以在 UI 中下载某些工件类型(SVG、PNG、Mermaid 文本或其他导出格式)——使用下载的文件将工件包含到你的代码仓库或博文中。
- 为嵌入内容添加说明文字与替代文本,以提升可访问性。
步骤 3 —— 分享项目(更广的集合与权限控制)
- 在 Claude Web 打开 Project 列表。
- 在项目名称旁点击Share。
- 在 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 —— 导出对话
- 在 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/*
若为 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.md与SECURITY.md,说明如何报告问题或敏感数据泄露。 - 添加简短演示页(GitHub Pages),包含来自 Claude Web 的嵌入工件 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 guide获取详细说明。访问前,请确保已登录 CometAPI 并获取 API key。CometAPI提供远低于官方价格的方案,帮助你完成集成。
准备好了吗?→ Free trial of Claude opus 4.5!
