Claude学院

Claude Projects 上传文件教程：支持格式与大小限制

Claude Projects 支持上传 PDF、Word（.docx）、Excel（.xlsx）、CSV、纯文本（.txt）、Markdown（.md）以及常见代码文件和图片等格式，可以把文档拖进项目，也可以粘贴文本或直接连接 Google Drive。单个文件和整个项目知识库都有容量上限，超过会上传失败——下面把支持的格式、具体限制和上传步骤一次讲清楚。

支持的文件格式

Claude Projects 的知识库（Project Knowledge）接受的文件类型相当广，按用途大致分为几类：

类别常见格式典型用途
文档.pdf、.docx、.txt、.md、.rtf需求文档、说明书、知识手册
表格.csv、.xlsx、.tsv数据清单、统计表
代码.py、.js、.ts、.java、.go、.html、.css、.json、.yaml 等项目源码、配置文件
图片.png、.jpg、.jpeg、.gif、.webp截图、图表、设计稿

图片走的是 Claude 的多模态视觉能力，模型能直接"看"图回答问题。如果你打算在 API 里做同样的事，可以参考 Claude API 图片输入怎么传？多模态调用教程。需要说明的是，Projects 不支持上传压缩包（.zip）、音频和视频，遇到这类文件需要先解压或转成文本/图片再上传。

文件大小与数量限制

限制分两个层面，理解这两点就不会再莫名其妙上传失败：

  • 单文件大小上限：每个文件有最大体积限制，超大的 PDF 或表格需要拆分后再传。
  • 知识库总容量：整个项目所有文件加起来占用的"容量百分比"，界面右侧会显示一个进度条，接近 100% 时就无法继续添加。这个容量本质上对应模型可调用的上下文规模。

具体的数值上限会随产品迭代和订阅方案（Pro / Team / Enterprise）调整，具体以 Anthropic 官网为准。一个实用经验是：知识库不是越满越好，塞入大量无关文件会稀释检索质量。关于上下文如何影响长文档处理，可以读 Claude 上下文窗口多大？长文档处理实用技巧。

上传文件的具体步骤

在 claude.ai 网页端操作，流程很短：

  1. 进入目标项目（还没建项目的话，先看 Claude Projects 怎么用？从创建到知识库搭建全流程）。
  2. 在右侧 Project knowledge 面板点击 Add content（或加号）。
  3. 选择上传方式：
    • Upload from device：从本地选文件，或直接把文件拖进面板。
    • Add text content：粘贴一段文本并起个标题，适合放规范、术语表。
    • Sync with Google Drive：连接云盘文档，源文件更新后可重新同步。
  4. 等待文件解析完成，进度条更新即表示已纳入知识库。

上传成功后，你在该项目下的任何对话都能让 Claude 引用这些资料，无需每次重新粘贴。想进一步规范模型行为，建议同时配置项目级的自定义指令，写法参考 Claude 系统提示词怎么设置？完整配置步骤图解。

上传失败的常见原因

遇到上传不成功，先按下面几条排查：

  • 格式不支持：检查是不是 zip、音视频或加密 PDF，加密文档需先去除密码。
  • 单文件超限：体积太大的文件先拆分，或把扫描版 PDF 做 OCR 转成文本后再传，体积会大幅缩小。
  • 知识库已满：容量进度条接近 100%，删掉过期或冗余文件腾出空间。
  • 文件内容为空或损坏：纯图片型 PDF 若无可提取文本，模型可能读不到内容，换成图片格式或先转文字。
  • 网络问题：大文件上传中断，刷新页面重试，或换用更稳定的网络。

用 API 处理文件的替代方案

Projects 是网页端的便捷功能。如果你要在程序里批量处理文档，应该走 Claude Messages API，把文件内容作为消息的一部分发给模型。下面是用官方 Python SDK 读取本地文本、交给 Claude 总结的最小示例：

from anthropic import Anthropic

client = Anthropic()  # 读取环境变量 ANTHROPIC_API_KEY

with open("report.md", "r", encoding="utf-8") as f:
    doc = f.read()

resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": f"请用三句话总结下面这份文档：\n\n{doc}",
        }
    ],
)
print(resp.content[0].text)

PDF 这类二进制文件可以用 document 类型的内容块以 base64 传入，处理大量长文档时还能结合提示缓存降本，省钱思路见 Claude API 怎么省钱？5 个降低 Token 成本的方法。环境配置和 SDK 安装可参考 Anthropic Python SDK 安装与配置完整教程。

常见问题

上传的文件 Claude 是怎么读取的？会一直占用上下文吗？

项目知识库的文件会在对话时按需检索并注入模型上下文，因此文件越精炼、越相关，回答质量越高。它不像普通附件那样仅对单条消息有效，而是对该项目下所有会话长期可用，直到你手动删除。

能上传压缩包或整个文件夹吗？

目前不支持直接上传 .zip 压缩包或文件夹。需要先解压，再把里面支持的文件逐个或批量拖入。如果是大型代码仓库，更推荐用 Claude Code 在本地直接读写文件，避免反复上传。

上传后修改了源文件，知识库会自动更新吗？

本地上传的文件是上传时刻的快照，源文件改动后不会自动同步，需要删掉旧版重新上传。通过 Google Drive 连接的文档则支持手动重新同步以拉取最新内容。具体同步能力以 Anthropic 官网说明为准。

← Projects 与 MCP