CLAUDE LABJP
MEMORY — Claude Code closes a cluster of long-session memory leaks, including MCP stdio stderr piling up to 64 MB per server and LSP documents staying open indefinitelyTABLES — Very large markdown tables no longer stall rendering; tables over 200 rows now show the first 200 with a "… N more rows" noticeSPEED — Sessions carrying many deny/ask permission rules no longer lose seconds every turn: rule matchers are compiled once and cachedTOOLS — print/SDK sessions with many MCP tools get up to 7x faster tool rounds thanks to cached tool-pool assemblyARTIFACTS — Claude Code Artifacts turn session work into live, shareable web pages that update in place — useful for PR walkthroughs and dashboardsDEADLINE — Opus 4.7 fast mode is removed on July 24; speed: "fast" will error, so move to Opus 4.8 fast mode before thenMEMORY — Claude Code closes a cluster of long-session memory leaks, including MCP stdio stderr piling up to 64 MB per server and LSP documents staying open indefinitelyTABLES — Very large markdown tables no longer stall rendering; tables over 200 rows now show the first 200 with a "… N more rows" noticeSPEED — Sessions carrying many deny/ask permission rules no longer lose seconds every turn: rule matchers are compiled once and cachedTOOLS — print/SDK sessions with many MCP tools get up to 7x faster tool rounds thanks to cached tool-pool assemblyARTIFACTS — Claude Code Artifacts turn session work into live, shareable web pages that update in place — useful for PR walkthroughs and dashboardsDEADLINE — Opus 4.7 fast mode is removed on July 24; speed: "fast" will error, so move to Opus 4.8 fast mode before then
Articles/Claude.ai
Claude.ai/2026-04-25Intermediate

Claude Projects Not Working: A Practical Troubleshooting Guide

Files vanishing, knowledge ignored, search returning nothing — a hands-on guide to diagnosing and fixing the most common Claude Projects failures.

Claude Projects2Troubleshooting11File UploadKnowledge Base

"The PDF I uploaded yesterday isn't being referenced today." If you use Claude Projects daily, you've probably hit this exact wall. There's no error, no warning — Claude just calmly replies "I don't have information about that." That silence is what makes it so frustrating.

This guide walks through the failure modes I've personally hit while using Claude Projects in production work, organized by where the problem actually lives. Once you can tell whether the issue is the file, the index, or your custom instructions, recovery becomes a five-minute exercise instead of an afternoon-long debugging session.

Suspect the index, not the file, first

When you upload a file to a Claude Project, it isn't immediately searchable. The platform chunks the document, generates embeddings, and writes them to a searchable index. That pipeline takes time.

In my experience, a clean text-based PDF under 30 pages is searchable within a minute or so. A 100-page report packed with images can take five to ten minutes. A spreadsheet with hundreds of rows can take longer.

Symptom: I asked right after upload and got "no relevant information" Wait five minutes, then start a new conversation. The same conversation tends to inherit its earlier "I don't know" judgment, even after the index updates.

Symptom: Hours later, still no recognition Now you can suspect the file itself. Move to the next section.

Four checks on the file itself

1. Is it a scanned PDF?

This is the single most common cause. A PDF exported from Word has a real text layer. A PDF created by scanning paper is a stack of images. Claude Projects does not run OCR, so a scanned PDF is invisible to knowledge search.

The quickest test: open the PDF and try to select text with your cursor. If you can't, it's a scanned PDF. Run it through Acrobat OCR or Preview's text-recognition feature, then re-upload the new version.

2. Is the file too close to the size limit?

The per-file limit is 30 MB, but anything above 20 MB starts to fail more often. If you're near the ceiling, split the file by chapter or section before uploading.

3. Is it password-protected or restricted?

PDFs with "no copy" or "no print" restrictions sometimes block text extraction. Remove the password, save a fresh copy, and re-upload.

4. Are you fighting a character-encoding issue?

This one is sneaky. Japanese, Korean, or other non-ASCII docx files that have bounced between Mac and Windows can have encoding artifacts that confuse Claude's text extraction. Copy the content into a plain .txt file as UTF-8, then upload that. The symptom often disappears entirely.

When files seem to be "disappearing"

"I had eight files yesterday, now I see six" is another common report. The usual culprits:

Cause A: Project storage cap

Free and Pro plans have a per-project knowledge cap. Once you cross it, new uploads appear to succeed but older files quietly fall out of search relevance. The fix is to delete material you've already merged into other documents, freeing capacity for what matters.

Cause B: You're signed into a different account

People juggling work and personal accounts hit this constantly. Browser session expiry can silently swap you to a different workspace where the project doesn't exist. Check the account name in the corner before you panic.

Cause C: The project got auto-archived

Long-dormant projects can get pushed off the main list even without an explicit archive action. Check the "Archived" filter in your project list.

Knowledge is indexed, but Claude refuses to use it

Different problem, different fix. Files are present, search would find them — yet Claude answers from generic knowledge instead.

Each project has its own custom instructions (system prompt). If yours says something like "always answer concisely" or "prioritize your training knowledge," the model often deprioritizes knowledge lookup.

The workaround I keep in every production project is a single line at the top of custom instructions:

Before answering, always search the project knowledge first.
If anything in the knowledge applies, quote and prioritize it over general knowledge.

That one sentence has more impact than any other tuning I've done. Without an explicit nudge, Claude tends to be conservative about when to actually run a knowledge search.

When nothing works

If you've cleared every check above and the project still misbehaves, try these in order.

  1. Spin up a fresh project and copy only the knowledge over. Project state can corrupt in rare cases. A clean container often resolves it instantly.
  2. Start a brand new conversation. Long conversations crowd the context window and hurt knowledge recall.
  3. Test in a different browser. Some Chrome extensions (especially ad blockers) interfere with the upload API. Try an incognito window or a different browser.
  4. Document repro steps before contacting support. Note which file, which question, what time. Anthropic support can act much faster on a tight repro than a vague "it's broken."

What to try first

Run the four file-side checks before doing anything else. In my experience, nine times out of ten the answer is either "scanned PDF" or "encoding artifact." If knowledge is being ignored, add the explicit "search first" line to your custom instructions — it changes the project's behavior more than any other setting I know of.

Share

Thank You for Reading

Claude Lab is ad-free, supported entirely by members like you. We publish practical guides daily with implementation code, benchmarks, and production-ready patterns. If you've found it useful, we'd love to have you on board.

  • Copy-paste ready implementation code
  • New advanced guides published daily
  • $5/mo or $10 for lifetime access
View Membership →

If you found this article helpful, a small tip ($1.50) would mean a lot to us. Your support helps keep this site ad-free and covers server and hosting costs.

Related Articles

Claude.ai2026-07-09
Claude Card Declined: A Complete Troubleshooting Guide for Pro, Max, and API Users
When Claude tells you 'Your card was declined,' the cause is rarely obvious from the error text alone. This guide separates the three layers where a decline actually happens — your issuing bank, Stripe's fraud engine, and Anthropic's account state — and walks you through fixes plus fallback payment methods that almost always get the charge through.
Claude.ai2026-05-03
Writing Effective Custom Instructions for Claude Projects
A practical guide to writing Claude Projects custom instructions that actually shape Claude's behavior — covering role definition, output constraints, and project-specific context sharing.
Claude.ai2026-04-25
When Extended Thinking 'Does Not Work': 7 Causes That Hide Behind the Same Symptom
When you turn on Extended Thinking but the response feels identical to before, the cause is usually one of seven distinct problems. This guide walks through how to diagnose each from the API, the chat UI, the SDK, and the model layer.
📚RECOMMENDED BOOKS
Build a Large Language Model (From Scratch)
Sebastian Raschka
LLM Dev
Prompt Engineering for LLMs
Berryman & Ziegler
Prompting
AI Engineering
Chip Huyen
AI Eng
* Contains affiliate links
See all →