How to download and export a Claude project as a ZIP
Using the new Claude Projects at claude.ai/code/project? See how to keep a complete copy of a new-style project — threads, Library files and Cowork tasks included.
Single conversations are easy to think about — one chat, one file. A project is a different kind of thing, and it's the part of Claude people are most afraid of losing. By the time a project matters, it's carrying carefully tuned custom instructions, a dozen or more knowledge-base documents you uploaded, and dozens of conversations that build on each other. It is, in every practical sense, a small body of work.
If you need the project as a folder you can read and reuse, a project ZIP keeps the instructions and knowledge documents alongside the conversations. The Claude project download tool brings these pieces together in one local archive. Claude also has an official account-data export in Settings → Privacy, delivered through an email link. Choose the workflow that fits the copy you need.
What a project actually contains
To archive a project properly you have to capture all of it, not just the transcripts:
- Custom instructions — the system prompt that shapes every conversation in the project.
- The knowledge base — the documents you uploaded for the project to draw on, both text and binary files.
- Every conversation — in order, with artifacts, tool calls, and generated files intact.
- Attachments — files uploaded into individual chats and documents Claude generated, as real bytes.
Miss any one of these and you have a pile of transcripts, not a project you could actually pick back up or hand to someone else.
What project export produces
On any claude.ai/project/<id> page, Project Export bundles all of the above into one ZIP, laid out so a human can navigate it — not a raw graph dump:
<Project Name>/
README.md ← what's here, and what Claude doesn't expose
instructions.md ← the project's custom instructions
metadata.json
files/ ← knowledge-base docs + uploaded files
_INDEX.md
conversations/
<date>_<title>/
<title>.<ext>
attachments/ ← only when "Include attachments" is on
_INDEX.md ← every conversation: OK / skipped / failed
The top-level _INDEX.md lists conversations and their export status: exported, skipped or failed. Review it, along with any _INCOMPLETE.md or _SKIPPED.md reports, before relying on the backup. Automatic project Memory, scheduled-task definitions, repository clones and connector settings are outside the archive; unavailable sandbox files cannot be recovered.
Check your Claude project files after downloading
When you export Claude project files with AI Chat Archive Pro, the documents travel with the instructions and chats. Before you rely on that copy, check what actually downloaded.
- Open
files/inside the project folder. Classic text knowledge is saved as Markdown. Available uploaded documents sit alongside it. Beta Library files keep their folders and original bytes. - Open the documents you need most. An uploaded PDF stays a PDF even when you choose Markdown for chats. Some classic files may instead be saved as text, a preview or a thumbnail.
- Check
files/_INDEX.mdand anyfiles/_SKIPPED.mdreport. Review the root_INDEX.mdfor chat statuses and any_INCOMPLETE.mdreport for detected gaps. - Keep
instructions.mdandconversations/with the files if you want their context. If the export came as several ZIP parts, combine them using the instructions in the first part first.
When to choose a project download
A single-chat export saves one conversation. A project download also keeps the project instructions and knowledge files together with its history. Use the Claude project download page to see supported content, formats and a demo before choosing a Pro plan.
When you'd actually use it
- Handing a project off — give a colleague the instructions, knowledge base, and history as one folder.
- Archiving a finished project — freeze the whole thing before you move on or clean up your workspace.
- Backing up before a change — a plan downgrade, an account switch, or just peace of mind.
- Moving into a PKM tool — drop the Markdown bundle straight into Obsidian or Notion, knowledge base and all.
How to export a project
Before you start, review the Claude project export tool for setup instructions and supported project content.
- Open the project at
claude.ai/project/…and install AI Chat Archive. - Click the Export button (top-right) and choose Project Export.
- Pick a format — Markdown is the usual choice for archiving and PKM — optionally toggle Include attachments, and export. The ZIP builds in your browser and lands in your Downloads.
Project export covers Markdown, HTML, JSON and TXT (PDF is single-chat only). Full walkthrough in the docs: how to export a Claude project. For single conversations, see how to export and save your Claude chats; if your old export method recently broke, here's why and what still works.
When you don't need this
If you only ever want the occasional single conversation, you don't need project export at all — single-chat export is free, in every format. Project export is for when the thing you'd hate to lose isn't one chat, it's the whole project: the instructions, the knowledge base, and everything built on top of them.